pintos-os.org Git - pspp/blob - 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 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, an SPSS portable file,
  22 or an encrypted SPSS syntax file,
  23 and writes it to \fIoutput\fR, performing format conversion as
  24 necessary.
  25 .PP
  26 The format of \fIinput\fR is automatically detected, when possible.
  27 The character encoding of old SPSS system files cannot always be
  28 guessed correctly, and SPSS/PC+ system files do not include any
  29 indication of their encoding.  Use \fB\-e \fIencoding\fR to specify
  30 the encoding in this case.
  31 .PP
  32 By default, the intended format for \fIoutput\fR is inferred from its
  33 extension:
  34 .
  35 .IP \fBcsv\fR
  36 .IQ \fBtxt\fR
  37 Comma-separated value.  Each value is formatted according to its
  38 variable's print format.  The first line in the file contains variable
  39 names.
  40 .
  41 .IP \fBsav\fR
  42 .IQ \fBsys\fR
  43 SPSS system file.
  44 .
  45 .IP \fBpor\fR
  46 SPSS portable file.
  47 .
  48 .IP \fBsps\fR
  49 SPSS syntax file.  (Only encrypted syntax files may be converted to
  50 this format.)
  51 .
  52 .PP
  53 Use \fB\-O \fIextension\fR to override the inferred format or to
  54 specify the format for unrecognized extensions.
  55 .
  56 .PP
  57 \fBpspp\-convert\fR can convert most input formats to most output
  58 formats.  Encrypted system file and syntax files are exceptions: if
  59 the input file is in an encrypted format, then the output file must
  60 be the same format (decrypted).
  61 .
  62 .SH "OPTIONS"
  63 .
  64 .IP "\fB\-O format\fR"
  65 .IQ "\fB\-\-output\-format=\fIformat\fR"
  66 Specifies the desired output format.  \fIformat\fR must be one of the
  67 extensions listed above, e.g. \fB\-O csv\fR requests comma-separated
  68 value output.
  69 .
  70 .IP "\fB\-c \fImaxcases\fR"
  71 .IQ "\fB\-\-cases=\fImaxcases\fR"
  72 By default, all cases are copied from \fIinput\fR to \fIoutput\fR.
  73 Specifying this option to limit the number of cases written to
  74 \fIoutput\fR to \fImaxcases\fR.
  75 .
  76 .IP "\fB\-e \fIcharset\fR"
  77 .IQ "\fB\-\-encoding=\fIcharset\fR"
  78 Overrides the encoding in which character strings in \fIinput\fR are
  79 interpreted.  This option is necessary because old SPSS system files
  80 do not self-identify their encoding.
  81 .
  82 .IP "\fB\-p \fIpassword\fR"
  83 .IQ "\fB\-\-password=\fIpassword\fR"
  84 Specifies the password to use to decrypt encrypted SPSS system file
  85 or syntax file
  86 \fIinput\fR.  If this option is not specified, \fBpspp\-convert\fR
  87 prompts for the password.
  88 .
  89 .IP
  90 On multiuser systems, this option may not be safe because other users
  91 may be able to see the password in process listings.
  92 .
  93 .IP "\fB\-h\fR"
  94 .IQ "\fB\-\-help\fR"
  95 Prints a usage message on stdout and exits.
  96 .
  97 .IP "\fB\-v\fR"
  98 .IQ "\fB\-\-version\fR"
  99 Prints version information on stdout and exits.
 100 .
 101 .SH "AUTHORS"
 102 Ben Pfaff.
 103 .
 104 .SH "SEE ALSO"
 105 .
 106 .BR pspp (1),
 107 .BR psppire (1).