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 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 SPSS system or portable file
  21 \fIinput\fR and writes it to \fIoutput\fR, performing format
  22 conversion as necessary.
  23 .PP
  24 The format of \fIinput\fR is automatically detected, except that the
  25 character encoding of old system files cannot always be guessed
  26 correctly.  Use \fB\-e \fIencoding\fR to specify the encoding in this
  27 case.
  28 .PP
  29 By default, the intended format for \fIoutput\fR is inferred from its
  30 extension:
  31 .
  32 .IP \fBcsv\fR
  33 .IQ \fBtxt\fR
  34 Comma-separated value.  Each value is formatted according to its
  35 variable's print format.  The first line in the file contains variable
  36 names.
  37 .
  38 .IP \fBsav\fR
  39 .IQ \fBsys\fR
  40 SPSS system file.
  41 .
  42 .IP \fBpor\fR
  43 SPSS portable file.
  44 .
  45 .PP
  46 Use \fB\-O \fIextension\fR to override the inferred format or to
  47 specify the format for unrecognized extensions.
  48 .
  49 .SH "OPTIONS"
  50 .
  51 .IP "\fB\-O format\fR"
  52 .IQ "\fB\-\-output\-format=\fIformat\fR"
  53 Specifies the desired output format.  \fIformat\fR must be one of the
  54 extensions listed above, e.g. \fB\-O csv\fR requests comma-separated
  55 value output.
  56 .
  57 .IP "\fB\-c \fImaxcases\fR"
  58 .IQ "\fB\-\-cases=\fImaxcases\fR"
  59 By default, all cases are copied from \fIinput\fR to \fIoutput\fR.
  60 Specifying this option to limit the number of cases written to
  61 \fIoutput\fR to \fImaxcases\fR.
  62 .
  63 .IP "\fB\-e \fIcharset\fR"
  64 .IQ "\fB\-\-encoding=\fIcharset\fR"
  65 Overrides the encoding in which character strings in \fIinput\fR are
  66 interpreted.  This option is necessary because old SPSS system files
  67 do not self-identify their encoding.
  68 .
  69 .IP "\fB\-h\fR"
  70 .IQ "\fB\-\-help\fR"
  71 Prints a usage message on stdout and exits.
  72 .
  73 .IP "\fB\-v\fR"
  74 .IQ "\fB\-\-version\fR"
  75 Prints version information on stdout and exits.
  76 .
  77 .SH "AUTHORS"
  78 Ben Pfaff.
  79 .
  80 .SH "SEE ALSO"
  81 .
  82 .BR pspp (1),
  83 .BR psppire (1).