1pspp-output(1) PSPP Manual pspp-output(1)
2
6 pspp-output - convert and operate on SPSS viewer (SPV) files
7
9 pspp-output detect file
10 pspp-output [options] dir file
11 pspp-output [options] convert source destination
12 pspp-output --help | -h
13 pspp-output --version | -v
14
16 pspp-output is a command-line utility accompanying PSPP. It supports
17 multiple operations on SPSS viewer or .spv files, here called SPV
18 files. SPSS 16 and later writes SPV files to represent the contents of
19 its output editor.
20 SPSS 15 and earlier versions instead use .spo files. pspp-output does
22 not support this format.
23 pspp-output has a number of subcommands, documented separately below.
25 pspp-output also has several undocumented command forms that developers
26 may find useful for debugging.
27 The detect command
29 When invoked as pspp-output detect file, pspp-output reads enough of
30 file to determine whether it is an SPV file. If so, it exits success‐
31 fully without outputting anything. When file is not an SPV file or if
32 some other error occurs, pspp-output prints an error message and exits
33 with a failure indication.
34 The dir command
36 When invoked as pspp-output dir file, pspp-output prints on stdout a
37 table of contents for SPV file file. By default, this table lists
38 every object in the file, except for hidden objects. See the Input
39 Selection Options section below for information on the options avail‐
40 able to select a subset of objects.
41 The following additional option for dir is intended mainly for use by
43 PSPP developers:
44 --member-names
46 Also show the names of the Zip members associated with each
47 object.
48 The convert command
50 When invoked as pspp-output convert source destination, pspp-output
51 reads the SPV file source and converts it to another format, writing
52 the output to destination.
53 By default, pspp-output infers the intended format for destination from
55 its extension. The known extensions are generally: csv html list odt
56 pdf ps spv svg txt. Use --help to see an accurate list, since a given
57 installation might be built without support for some formats.
58 See the Input Selection Options section below for information on the
60 options available to select a subset of objects to include in the out‐
61 put. The following additional options are accepted:
62 -O format=format
64 Overrides the format inferred from the output file's extension.
65 format must be one of the extensions listed above.
66 -O option=value
68 Sets an option for the output file format. Refer to the PSPP
69 manual for details of the available output options.
70 -F
72 --force
73 By default, if the source is corrupt or otherwise cannot be pro‐
74 cessed, the destination is not written. These option make
75 pspp-output write the output as best it can, even with errors.
76 Input Selection Options
78 The dir and convert commands, by default, operate on all of the objects
79 in the source SPV file, except for objects that are not visible in the
80 output viewer window. The user may specify these options to select a
81 subset of the input objects. When multiple options are used, only
82 objects that satisfy all of them are selected:
83 --select=[^]class...
85 Include only objects of the given class; with leading ^, include
86 only objects not in the class. Use commas to separate multiple
87 classes. The supported classes are:
88 charts headings logs models tables texts trees warnings
90 outlineheaders pagetitle notes unknown other
91 Use --select=help to print this list of classes.
93 --commands=[^]command...
95 --subtypes=[^]subtype...
96 --labels=[^]label...
97 Include only objects with the specified command, subtype, or
98 label. With a leading ^, include only the objects that do not
99 match. Multiple values may be specified separated by commas.
100 An asterisk at the end of a value acts as a wildcard.
101 The --command option matches command identifiers, case insensi‐
103 tively. All of the objects produced by a single command use the
104 same, unique command identifier. Command identifiers are always
105 in English regardless of the language used for output. They
106 often differ from the command name in PSPP syntax. Use the
107 pspp-output program's dir command to print command identifiers
108 in particular output.
109 The --subtypes option matches particular tables within a com‐
111 mand, case insensitively. Subtypes are not necessarily unique:
112 two commands that produce similar output tables may use the same
113 subtype. Subtypes are always in English and dir will print
114 them.
115 The --labels option matches the labels in table output (that is,
117 the table titles). Labels are affected by the output language,
118 variable names and labels, split file settings, and other fac‐
119 tors.
120 --instances=instance...
122 Include the specified instance of an object that matches the
123 other criteria within a single command. The instance may be a
124 number (1 for the first instance, 2 for the second, and so on)
125 or last for the last instance.
126 --show-hidden
128 Include hidden output objects in the output. By default, they
129 are excluded.
130 --or Separates two sets of selection options. Objects selected by
132 either set of options are included in the output.
133 The following additional input selection options are intended mainly
135 for use by PSPP developers:
136 --errors
138 Include only objects that cause an error when read. With the
139 convert command, this is most useful in conjunction with the
140 --force option.
141 --members=member...
143 Include only the objects that include a listed Zip file member.
144 More than one name may be included, comma-separated. The mem‐
145 bers in an SPV file may be listed with the dir command by adding
146 the --show-members option or with the zipinfo program included
147 with many operating systems. Error messages that pspp-output
148 prints when it reads SPV files also often include member names.
149 --member-names
151 Displays the name of the Zip member or members associated with
152 each object just above the object itself.
153
155 -h
156 --help Prints a usage message on stdout and exits.
157 -v
159 --version
160 Prints version information on stdout and exits.
161
163 Ben Pfaff.
164
166 pspp-convert(1), pspp(1), psppire(1).
167PSPP December 2019 pspp-output(1)