utilities/pspp-convert.1

   1 .\" -*- nroff -*-
   2 .de IQ
   3 .  br
   4 .  ns
   5 .  IP "\\$1"
   6 ..
   7 .TH pspp\-convert 1 "October 2013" "PSPP" "PSPP Manual"
   8 .
   9 .SH NAME
  10 pspp\-convert \- convert SPSS system and portable files to other formats
  11 .
  12 .SH SYNOPSIS
  13 \fBpspp\-convert\fR [\fIoptions\fR] \fIinput\fR \fIoutput\fR
  14 .br
  15 \fBpspp\-convert \-\-help\fR | \fB\-h\fR
  16 .br
  17 \fBpspp\-convert \-\-version\fR | \fB\-v\fR
  18 .
  19 .SH DESCRIPTION
  20 The \fBpspp\-convert\fR program reads \fIinput\fR, which may be an
  21 SPSS system file, an SPSS/PC+ system file, or an SPSS portable file,
  22 and writes it to \fIoutput\fR, performing format conversion as
  23 necessary.
  24 .PP
  25 The format of \fIinput\fR is automatically detected, when possible.
  26 The character encoding of old SPSS system files cannot always be
  27 guessed correctly, and SPSS/PC+ system files do not include any
  28 indication of their encoding.  Use \fB\-e \fIencoding\fR to specify
  29 the encoding in this case.
  30 .PP
  31 By default, the intended format for \fIoutput\fR is inferred from its
  32 extension:
  33 .
  34 .IP \fBcsv\fR
  35 .IQ \fBtxt\fR
  36 Comma-separated value.  Each value is formatted according to its
  37 variable's print format.  The first line in the file contains variable
  38 names.
  39 .
  40 .IP \fBsav\fR
  41 .IQ \fBsys\fR
  42 SPSS system file.
  43 .
  44 .IP \fBpor\fR
  45 SPSS portable file.
  46 .
  47 .PP
  48 Use \fB\-O \fIextension\fR to override the inferred format or to
  49 specify the format for unrecognized extensions.
  50 .
  51 .PP
  52 \fBpspp\-convert\fR can convert most input formats to most output
  53 formats, with one exception: if the input file is an encrypted system
  54 file, then the output file must also be an (unencrypted) system file.
  55 .
  56 .SH "OPTIONS"
  57 .
  58 .IP "\fB\-O format\fR"
  59 .IQ "\fB\-\-output\-format=\fIformat\fR"
  60 Specifies the desired output format.  \fIformat\fR must be one of the
  61 extensions listed above, e.g. \fB\-O csv\fR requests comma-separated
  62 value output.
  63 .
  64 .IP "\fB\-c \fImaxcases\fR"
  65 .IQ "\fB\-\-cases=\fImaxcases\fR"
  66 By default, all cases are copied from \fIinput\fR to \fIoutput\fR.
  67 Specifying this option to limit the number of cases written to
  68 \fIoutput\fR to \fImaxcases\fR.
  69 .
  70 .IP "\fB\-e \fIcharset\fR"
  71 .IQ "\fB\-\-encoding=\fIcharset\fR"
  72 Overrides the encoding in which character strings in \fIinput\fR are
  73 interpreted.  This option is necessary because old SPSS system files
  74 do not self-identify their encoding.
  75 .
  76 .IP "\fB\-p \fIpassword\fR"
  77 .IQ "\fB\-\-password=\fIpassword\fR"
  78 Specifies the password to use to decrypt an encrypted SPSS system file
  79 \fIinput\fR.  If this option is not specified, \fBpspp\-convert\fR
  80 prompts for the password.
  81 .
  82 .IP
  83 On multiuser systems, this option may not be safe because other users
  84 may be able to see the password in process listings.
  85 .
  86 .IP "\fB\-h\fR"
  87 .IQ "\fB\-\-help\fR"
  88 Prints a usage message on stdout and exits.
  89 .
  90 .IP "\fB\-v\fR"
  91 .IQ "\fB\-\-version\fR"
  92 Prints version information on stdout and exits.
  93 .
  94 .SH "AUTHORS"
  95 Ben Pfaff.
  96 .
  97 .SH "SEE ALSO"
  98 .
  99 .BR pspp (1),
 100 .BR psppire (1).