PSPP Users’ Guide

GNU PSPP Statistical Analysis Software

Release 1.4.1
This manual is for GNU PSPP version 1.4.1, software for statistical analysis.
Copyright c 1997, 1998, 2004, 2005, 2009, 2012, 2013, 2014, 2016, 2019 Free Software
Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the
terms of the GNU Free Documentation License, Version 1.3 or any later version
published by the Free Software Foundation; with no Invariant Sections, no
Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included
in the section entitled "GNU Free Documentation License".
 1

The authors wish to thank Network Theory Ltd http://www.network-theory.co.

uk for their financial support in the production of this manual.
 i

Table of Contents

1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2 Your rights and obligations . . . . . . . . . . . . . . . . . . . . . 3

3 Invoking pspp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1 Main Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.2 PDF, PostScript, and SVG Output Options . . . . . . . . . . . . . . . . . . . . . 7
3.3 Plain Text Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.4 HTML Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.5 OpenDocument Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.6 Comma-Separated Value Output Options . . . . . . . . . . . . . . . . . . . . . . . 9

4 Invoking psppire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.1 The graphic user interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5 Using pspp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5.1 Preparation of Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
5.1.1 Defining Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
5.1.2 Listing the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.1.3 Reading data from a text file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
5.1.4 Reading data from a pre-prepared pspp file . . . . . . . . . . . . . . . 14
5.1.5 Saving data to a pspp file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.1.6 Reading data from other sources . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.1.7 Exiting PSPP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.2 Data Screening and Transformation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.2.1 Identifying incorrect data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.2.2 Dealing with suspicious data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5.2.3 Inverting negatively coded variables . . . . . . . . . . . . . . . . . . . . . . . 18
5.2.4 Testing data consistency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
5.2.5 Testing for normality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.3 Hypothesis Testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.3.1 Testing for differences of means . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.3.2 Linear Regression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

6 The pspp language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

6.1 Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2 Forming commands of tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6.3 Syntax Variants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.4 Types of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.5 Order of Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.6 Handling missing observations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
 ii

6.7 Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.7.1 Attributes of Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.7.2 Variables Automatically Defined by pspp . . . . . . . . . . . . . . . . . 32
6.7.3 Lists of variable names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.7.4 Input and Output Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.7.4.1 Basic Numeric Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.7.4.2 Custom Currency Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
6.7.4.3 Legacy Numeric Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
6.7.4.4 Binary and Hexadecimal Numeric Formats . . . . . . . . . . . 37
6.7.4.5 Time and Date Formats. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
6.7.4.6 Date Component Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.7.4.7 String Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.7.5 Scratch Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6.8 Files Used by pspp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.9 File Handles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.10 Backus-Naur Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

7 Mathematical Expressions . . . . . . . . . . . . . . . . . . . . . 44
7.1 Boolean Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.2 Missing Values in Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.3 Grouping Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.4 Arithmetic Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.5 Logical Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
7.6 Relational Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
7.7 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
7.7.1 Mathematical Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
7.7.2 Miscellaneous Mathematical Functions . . . . . . . . . . . . . . . . . . . . 46
7.7.3 Trigonometric Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.7.4 Missing-Value Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
7.7.5 Set-Membership Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
7.7.6 Statistical Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
7.7.7 String Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7.7.8 Time & Date Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
7.7.8.1 How times & dates are defined and represented . . . . . . . 51
7.7.8.2 Functions that Produce Times . . . . . . . . . . . . . . . . . . . . . . . 52
7.7.8.3 Functions that Examine Times . . . . . . . . . . . . . . . . . . . . . . . 52
7.7.8.4 Functions that Produce Dates . . . . . . . . . . . . . . . . . . . . . . . . 52
7.7.8.5 Functions that Examine Dates . . . . . . . . . . . . . . . . . . . . . . . 53
7.7.8.6 Time and Date Arithmetic . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
7.7.9 Miscellaneous Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
7.7.10 Statistical Distribution Functions . . . . . . . . . . . . . . . . . . . . . . . . 56
7.7.10.1 Continuous Distributions . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
7.7.10.2 Discrete Distributions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
7.8 Operator Precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
 iii

8 Data Input and Output . . . . . . . . . . . . . . . . . . . . . . . . 62

8.1 BEGIN DATA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.2 CLOSE FILE HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.3 DATAFILE ATTRIBUTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
8.4 DATASET commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
8.5 DATA LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
8.5.1 DATA LIST FIXED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8.5.2 DATA LIST FREE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
8.5.3 DATA LIST LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
8.6 END CASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
8.7 END FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
8.8 FILE HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
8.9 INPUT PROGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
8.10 LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
8.11 NEW FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
8.12 MATRIX DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
8.13 PRINT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
8.14 PRINT EJECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
8.15 PRINT SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
8.16 REREAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
8.17 REPEATING DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
8.18 WRITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

9 System and Portable File I/O . . . . . . . . . . . . . . . . . 82

9.1 APPLY DICTIONARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
9.2 EXPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
9.3 GET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
9.4 GET DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
9.4.1 Spreadsheet Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
9.4.2 Postgres Database Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
9.4.3 Textual Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
9.4.3.1 Reading Delimited Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
9.4.3.2 Reading Fixed Columnar Data . . . . . . . . . . . . . . . . . . . . . . . 89
9.5 IMPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
9.6 SAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
9.7 SAVE DATA COLLECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
9.8 SAVE TRANSLATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
9.8.1 Writing Comma- and Tab-Separated Data Files . . . . . . . . . . . 93
9.9 SYSFILE INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
9.10 XEXPORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
9.11 XSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

10 Combining Data Files . . . . . . . . . . . . . . . . . . . . . . . . 96

10.1 Common Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
10.2 ADD FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
10.3 MATCH FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
10.4 UPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
 iv

11 Manipulating variables . . . . . . . . . . . . . . . . . . . . . . 101

11.1 ADD VALUE LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
11.2 DELETE VARIABLES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
11.3 DISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
11.4 FORMATS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
11.5 LEAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
11.6 MISSING VALUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
11.7 MODIFY VARS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
11.8 MRSETS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
11.9 NUMERIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
11.10 PRINT FORMATS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
11.11 RENAME VARIABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
11.12 SORT VARIABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
11.13 VALUE LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
11.14 STRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
11.15 VARIABLE ATTRIBUTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
11.16 VARIABLE LABELS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
11.17 VARIABLE ALIGNMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
11.18 VARIABLE WIDTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
11.19 VARIABLE LEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
11.20 VARIABLE ROLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
11.21 VECTOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
11.22 WRITE FORMATS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

12 Data transformations . . . . . . . . . . . . . . . . . . . . . . . . 112

12.1 AGGREGATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
12.2 AUTORECODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
12.3 COMPUTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
12.4 COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
12.5 FLIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
12.6 IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
12.7 RECODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
12.8 SORT CASES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

13 Selecting data for analysis . . . . . . . . . . . . . . . . . . 122

13.1 FILTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
13.2 N OF CASES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
13.3 SAMPLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
13.4 SELECT IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
13.5 SPLIT FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
13.6 TEMPORARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
13.7 WEIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
 v

14 Conditional and Looping Constructs . . . . . . . 126

14.1 BREAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
14.2 DO IF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
14.3 DO REPEAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
14.4 LOOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

15 Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
15.1 DESCRIPTIVES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
15.2 FREQUENCIES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
15.3 EXAMINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
15.4 GRAPH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
15.4.1 Scatterplot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
15.4.2 Histogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
15.4.3 Bar Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
15.5 CORRELATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
15.6 CROSSTABS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
15.7 FACTOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
15.8 GLM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
15.9 LOGISTIC REGRESSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
15.10 MEANS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
15.11 NPAR TESTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
15.11.1 Binomial test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
15.11.2 Chisquare Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
15.11.3 Cochran Q Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
15.11.4 Friedman Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
15.11.5 Kendall’s W Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
15.11.6 Kolmogorov-Smirnov Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
15.11.7 Kruskal-Wallis Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
15.11.8 Mann-Whitney U Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
15.11.9 McNemar Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
15.11.10 Median Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
15.11.11 Runs Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
15.11.12 Sign Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
15.11.13 Wilcoxon Matched Pairs Signed Ranks Test . . . . . . . . . . 149
15.12 T-TEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
15.12.1 One Sample Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
15.12.2 Independent Samples Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
15.12.3 Paired Samples Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
15.13 ONEWAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
15.14 QUICK CLUSTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
15.15 RANK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
15.16 REGRESSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
15.16.1 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
15.16.2 Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
15.17 RELIABILITY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
15.18 ROC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
 vi

16 Utilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
16.1 ADD DOCUMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
16.2 CACHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
16.3 CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
16.4 COMMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
16.5 DOCUMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.6 DISPLAY DOCUMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.7 DISPLAY FILE LABEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.8 DROP DOCUMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.9 ECHO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.10 ERASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
16.11 EXECUTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
16.12 FILE LABEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
16.13 FINISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
16.14 HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
16.15 INCLUDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
16.16 INSERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
16.17 OUTPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
16.18 PERMISSIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
16.19 PRESERVE and RESTORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
16.20 SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
16.21 SHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
16.22 SUBTITLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
16.23 TITLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

17 Invoking pspp-convert . . . . . . . . . . . . . . . . . . . . . . . 172

18 Invoking pspp-output . . . . . . . . . . . . . . . . . . . . . . . . 175

18.1 The detect Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
18.2 The dir Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
18.3 The convert Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
18.4 Input Selection Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

19 Invoking pspp-dump-sav . . . . . . . . . . . . . . . . . . . . . . 178

20 Not Implemented . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

21 Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
21.1 How to report bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

22 Function Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

23 Command Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

 vii

24 Concept Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Appendix A GNU Free Documentation License . . 197

 2

1 Introduction
pspp is a tool for statistical analysis of sampled data. It reads the data, analyzes the data
according to commands provided, and writes the results to a listing file, to the standard
output or to a window of the graphical display.
The language accepted by pspp is similar to those accepted by SPSS statistical products.
The details of pspp’s language are given later in this manual.
pspp produces tables and charts as output, which it can produce in several formats;
currently, ASCII, PostScript, PDF, HTML, and DocBook are supported.
The current version of pspp, 1.4.1, is incomplete in terms of its statistical procedure
support. pspp is a work in progress. The authors hope to fully support all features in
the products that pspp replaces, eventually. The authors welcome questions, comments,
donations, and code submissions. See Chapter 21 [Submitting Bug Reports], page 184, for
instructions on contacting the authors.