File: pspp-convert.texi

package info (click to toggle)
pspp 0.8.4-1
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 35,692 kB
  • ctags: 20,600
  • sloc: ansic: 218,288; sh: 12,890; xml: 11,342; perl: 715; lisp: 597; makefile: 157
file content (73 lines) | stat: -rw-r--r-- 2,007 bytes parent folder | download
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