1 @node Invoking pspp-convert
2 @chapter Invoking @command{pspp-convert}
4 @cindex @command{pspp-convert}
6 @command{pspp-convert} is a command-line utility accompanying
7 @pspp{}. It reads an SPSS system or portable file @var{input} and
8 writes a copy of it to another @var{output} in a different format.
12 @t{pspp-convert} [@var{options}] @var{input} @var{output}
14 @t{pspp-convert -@w{-}help}
16 @t{pspp-convert -@w{-}version}
19 The format of @var{input} is automatically detected, when possible.
20 The character encoding of old SPSS system files cannot always be
21 guessed correctly, and SPSS/PC+ system files do not include any
22 indication of their encoding. Use @code{-e @var{encoding}} to specify
23 the encoding in this case.
25 By default, the intended format for @var{output} is inferred based on its
31 Comma-separated value. Each value is formatted according to its
32 variable's print format. The first line in the file contains variable
43 Use @code{-O @var{extension}} to override the inferred format or to
44 specify the format for unrecognized extensions.
46 The following options are accepted:
50 @itemx --output-format=@var{format}
51 Specifies the desired output format. @var{format} must be one of the
52 extensions listed above, e.g. @code{-O csv} requests comma-separated
55 @item -c @var{maxcases}
56 @itemx --cases=@var{maxcases}
57 By default, all cases are copied from @var{input} to @var{output}.
58 Specifying this option to limit the number of cases written to
59 @var{output} to @var{maxcases}.
61 @item -e @var{charset}
62 @itemx --encoding=@var{charset}
63 Overrides the encoding in which character strings in @var{input} are
64 interpreted. This option is necessary because old SPSS system files,
65 and SPSS/PC+ system files, do not self-identify their encoding.
69 Prints a usage message on stdout and exits.
73 Prints version information on stdout and exits.