1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
|
@node Invoking pspp-convert
@chapter Invoking @command{pspp-convert}
@cindex Invocation
@cindex @command{pspp-convert}
@command{pspp-convert} is a command-line utility accompanying
@pspp{}. It reads an SPSS system or portable file @var{input} and
writes a copy of it to another @var{output} in a different format.
Synopsis:
@display
@t{pspp-convert} [@var{options}] @var{input} @var{output}
@t{pspp-convert -@w{-}help}
@t{pspp-convert -@w{-}version}
@end display
The format of @var{Iinput} is automatically detected, except that the
character encoding of old system files cannot always be guessed
correctly. Use @code{-e @var{encoding}} to specify the encoding in this
case.
By default, the intended format for @var{output} is inferred based on its
extension:
@table @code
@item csv
@itemx txt
Comma-separated value. Each value is formatted according to its
variable's print format. The first line in the file contains variable
names.
@item sav
@item sys
SPSS system file.
@item por
SPSS portable file.
@end table
Use @code{-O @var{extension}} to override the inferred format or to
specify the format for unrecognized extensions.
The following options are accepted:
@table @code
@item -O @var{format}
@itemx --output-format=@var{format}
Specifies the desired output format. @var{format} must be one of the
extensions listed above, e.g. @code{-O csv} requests comma-separated
value output.
@item -c @var{maxcases}
@itemx --cases=@var{maxcases}
By default, all cases are copied from @var{input} to @var{output}.
Specifying this option to limit the number of cases written to
@var{output} to @var{maxcases}.
@item -e @var{charset}
@itemx --encoding=@var{charset}
Overrides the encoding in which character strings in @var{input} are
interpreted. This option is necessary because old SPSS system files
do not self-identify their encoding.
@item -h
@itemx --help
Prints a usage message on stdout and exits.
@item -v
@itemx --version
Prints version information on stdout and exits.
@end table
|