pintos-os.org Git - pspp/blob - doc/pspp-convert.texi

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