624bd72bd4eac34a93d308e7c4afc9614bab58d3
[pspp-builds.git] / doc / pspp.info-8
1 This is pspp.info, produced by makeinfo version 4.0 from pspp.texi.
2
3 START-INFO-DIR-ENTRY
4 * PSPP: (pspp).             Statistical analysis package.
5 END-INFO-DIR-ENTRY
6
7    PSPP, for statistical analysis of sampled data, by Ben Pfaff.
8
9    This file documents PSPP, a statistical package for analysis of
10 sampled data that uses a command language compatible with SPSS.
11
12    Copyright (C) 1996-9, 2000 Free Software Foundation, Inc.
13
14    This version of the PSPP documentation is consistent with version 2
15 of "texinfo.tex".
16
17    Permission is granted to make and distribute verbatim copies of this
18 manual provided the copyright notice and this permission notice are
19 preserved on all copies.
20
21    Permission is granted to copy and distribute modified versions of
22 this manual under the conditions for verbatim copying, provided that the
23 entire resulting derived work is distributed under the terms of a
24 permission notice identical to this one.
25
26    Permission is granted to copy and distribute translations of this
27 manual into another language, under the above condition for modified
28 versions, except that this permission notice may be stated in a
29 translation approved by the Free Software Foundation.
30
31 \1f
32 File: pspp.info,  Node: Concept Index,  Next: Command Index,  Prev: Function Index,  Up: Top
33
34 Concept Index
35 *************
36
37 * Menu:
38
39 * ":                                     Tokens.
40 * "is defined as":                       BNF.
41 * $CASENUM:                              System Variables.
42 * $DATE:                                 System Variables.
43 * $JDATE:                                System Variables.
44 * $LENGTH:                               System Variables.
45 * $SYSMIS:                               System Variables.
46 * $TIME:                                 System Variables.
47 * $WIDTH:                                System Variables.
48 * &:                                     Logical Operators.
49 * ':                                     Tokens.
50 * (:                                     Functions.
51 * (  ):                                  Grouping Operators.
52 * ):                                     Functions.
53 * *:                                     Arithmetic Operators.
54 * **:                                    Arithmetic Operators.
55 * +:                                     Arithmetic Operators.
56 * -:                                     Arithmetic Operators.
57 * . <1>:                                 BNF.
58 * .:                                     Tokens.
59 * /:                                     Arithmetic Operators.
60 * /pub/algorithms/c/julcal10:            Credits.
61 * /usr/local/bin/:                       UNIX installation.
62 * /usr/local/info/:                      UNIX installation.
63 * /usr/local/share/pspp/:                UNIX installation.
64 * 0:                                     Tokens.
65 * ::=:                                   BNF.
66 * <:                                     Relational Operators.
67 * <=:                                    Relational Operators.
68 * <>:                                    Relational Operators.
69 * =:                                     Relational Operators.
70 * >:                                     Relational Operators.
71 * >=:                                    Relational Operators.
72 * [  ]:                                  Commands.
73 * `Cat's Cradle':                        Credits.
74 * absolute value:                        Miscellaneous Mathematics.
75 * active file:                           Files.
76 * addition:                              Arithmetic Operators.
77 * AND:                                   Logical Operators.
78 * arccosine:                             Trigonometry.
79 * arcsine:                               Trigonometry.
80 * arctangent:                            Trigonometry.
81 * arguments, invalid <1>:                Date Construction.
82 * arguments, invalid:                    Time & Date.
83 * arguments, minimum valid:              Statistical Functions.
84 * arguments, of date construction functions: Date Construction.
85 * arguments, of date extraction functions: Date Extraction.
86 * arithmetic operators:                  Arithmetic Operators.
87 * attributes of variables:               Attributes.
88 * authors:                               Credits.
89 * Backus-Naur Form:                      BNF.
90 * BNF:                                   BNF.
91 * Boolean <1>:                           Logical Operators.
92 * Boolean:                               Booleans.
93 * case conversion:                       String Functions.
94 * case-sensitivity:                      Tokens.
95 * characters, reserved:                  Tokens.
96 * coefficient of variation:              Statistical Functions.
97 * command file:                          Files.
98 * command line, options:                 Invocation.
99 * command syntax, description of:        BNF.
100 * commands, names:                       Commands.
101 * commands, ordering:                    Order of Commands.
102 * commands, structure:                   Commands.
103 * compiler, gcc:                         Installation.
104 * compiler, recommended:                 Installation.
105 * compiling:                             UNIX installation.
106 * concatenation:                         String Functions.
107 * conditionals:                          Conditionals and Looping.
108 * config.h:                              UNIX installation.
109 * configuration:                         Configuration.
110 * configure, GNU:                        UNIX installation.
111 * constructing dates:                    Date Construction.
112 * constructing times:                    Time Construction.
113 * control flow:                          Conditionals and Looping.
114 * convention, TO:                        Sets of Variables.
115 * cosine:                                Trigonometry.
116 * Covington, Michael A.:                 Credits.
117 * credits:                               Credits.
118 * cross-case function:                   Miscellaneous Functions.
119 * data:                                  Data Input and Output.
120 * data file:                             Files.
121 * data, embedding in syntax files:       DATA LIST.
122 * Data, embedding in syntax files:       BEGIN DATA.
123 * data, fixed-format, reading:           DATA LIST FIXED.
124 * data, reading from a file:             DATA LIST.
125 * date examination:                      Date Extraction.
126 * date, Julian:                          Miscellaneous Functions.
127 * dates:                                 Time & Date.
128 * dates, concepts:                       Time & Date Concepts.
129 * dates, constructing:                   Date Construction.
130 * dates, day of the month:               Date Extraction.
131 * dates, day of the week:                Date Extraction.
132 * dates, day of the year:                Date Extraction.
133 * dates, day-month-year:                 Date Construction.
134 * dates, in days:                        Date Extraction.
135 * dates, in hours:                       Date Extraction.
136 * dates, in minutes:                     Date Extraction.
137 * dates, in months:                      Date Extraction.
138 * dates, in quarters:                    Date Extraction.
139 * dates, in seconds:                     Date Extraction.
140 * dates, in weekdays:                    Date Extraction.
141 * dates, in weeks:                       Date Extraction.
142 * dates, in years:                       Date Extraction.
143 * dates, legal range of:                 Time & Date.
144 * dates, mathematical properties of:     Time & Date Concepts.
145 * dates, month-year:                     Date Construction.
146 * dates, quarter-year:                   Date Construction.
147 * dates, time of day:                    Date Extraction.
148 * dates, week-year:                      Date Construction.
149 * dates, year-day:                       Date Construction.
150 * day of the month:                      Date Extraction.
151 * day of the week:                       Date Extraction.
152 * day of the year:                       Date Extraction.
153 * day-month-year:                        Date Construction.
154 * days <1>:                              Date Extraction.
155 * days <2>:                              Time Extraction.
156 * days:                                  Time Construction.
157 * delimiters:                            Tokens.
158 * description of command syntax:         BNF.
159 * deviation, standard:                   Statistical Functions.
160 * distribution:                          License.
161 * division:                              Arithmetic Operators.
162 * documentation, installing:             UNIX installation.
163 * dot, terminal <1>:                     BNF.
164 * dot, terminal <2>:                     Commands.
165 * dot, terminal:                         Tokens.
166 * dot, terminal, changing:               Tokens.
167 * embedding data in syntax files:        DATA LIST.
168 * Embedding data in syntax files:        BEGIN DATA.
169 * embedding fixed-format data:           DATA LIST FIXED.
170 * EQ:                                    Relational Operators.
171 * equality, testing:                     Relational Operators.
172 * examination, of times:                 Time Extraction.
173 * exponentiation:                        Arithmetic Operators.
174 * expression:                            BNF.
175 * expressions, mathematical:             Expressions.
176 * extraction, of dates:                  Date Extraction.
177 * extraction, of time:                   Time Extraction.
178 * false:                                 Logical Operators.
179 * features, not implemented:             Functions Not Implemented.
180 * file, active:                          Files.
181 * file, command:                         Files.
182 * file, data:                            Files.
183 * file, output:                          Files.
184 * file, syntax file:                     Files.
185 * files, PSPP:                           Introduction.
186 * fixed-format data, reading:            DATA LIST FIXED.
187 * flow of control:                       Conditionals and Looping.
188 * Free Software Foundation <1>:          License.
189 * Free Software Foundation:              Introduction.
190 * ftp.cdrom.com:                         Credits.
191 * function, cross-case:                  Miscellaneous Functions.
192 * functions:                             Functions.
193 * functions, miscellaneous:              Miscellaneous Functions.
194 * functions, missing-value:              Missing Value Functions.
195 * functions, not implemented:            Functions Not Implemented.
196 * functions, statistical:                Statistical Functions.
197 * functions, string:                     String Functions.
198 * functions, time & date:                Time & Date.
199 * gcc:                                   Installation.
200 * GE:                                    Relational Operators.
201 * General Public License:                License.
202 * Ghostscript:                           Introduction.
203 * GNU C compiler:                        Installation.
204 * GNU configure:                         UNIX installation.
205 * GNU General Public License:            License.
206 * GPL:                                   License.
207 * graphics:                              Introduction.
208 * greater than:                          Relational Operators.
209 * greater than or equal to:              Relational Operators.
210 * grouping operators:                    Grouping Operators.
211 * GT:                                    Relational Operators.
212 * hexstrings:                            Tokens.
213 * hours <1>:                             Date Extraction.
214 * hours:                                 Time Extraction.
215 * hours-minutes-seconds:                 Time Construction.
216 * identifiers:                           Tokens.
217 * inequality, testing:                   Relational Operators.
218 * input:                                 Data Input and Output.
219 * installation <1>:                      UNIX installation.
220 * installation:                          Installation.
221 * installation, under UNIX:              UNIX installation.
222 * integer:                               BNF.
223 * integers:                              Tokens.
224 * intersection, logical:                 Logical Operators.
225 * introduction:                          Introduction.
226 * invalid arguments:                     Time & Date.
227 * inverse cosine:                        Trigonometry.
228 * inverse sine:                          Trigonometry.
229 * inverse tangent:                       Trigonometry.
230 * inversion, logical:                    Logical Operators.
231 * invocation:                            Invocation.
232 * julcal.c:                              Credits.
233 * julcal.h:                              Credits.
234 * Julian date:                           Miscellaneous Functions.
235 * keywords <1>:                          BNF.
236 * keywords:                              Tokens.
237 * keywords, reserved:                    Tokens.
238 * Knuth:                                 Pseudo-Random Numbers.
239 * labels, value:                         Attributes.
240 * labels, variable:                      Attributes.
241 * language, command structure:           Commands.
242 * language, lexical analysis:            Tokens.
243 * language, PSPP <1>:                    Language.
244 * language, PSPP:                        Introduction.
245 * language, tokens:                      Tokens.
246 * LE:                                    Relational Operators.
247 * less than:                             Relational Operators.
248 * less than or equal to:                 Relational Operators.
249 * lexemes:                               Tokens.
250 * lexical analysis:                      Tokens.
251 * license:                               License.
252 * logarithms:                            Advanced Mathematics.
253 * logical intersection:                  Logical Operators.
254 * logical inversion:                     Logical Operators.
255 * logical operators:                     Logical Operators.
256 * logical union:                         Logical Operators.
257 * loops:                                 Conditionals and Looping.
258 * LT:                                    Relational Operators.
259 * makefile:                              UNIX installation.
260 * Makefile:                              UNIX installation.
261 * mathematical expressions:              Expressions.
262 * mathematics:                           Functions.
263 * mathematics, advanced:                 Advanced Mathematics.
264 * mathematics, applied to times & dates: Time & Date Concepts.
265 * mathematics, miscellaneous:            Miscellaneous Mathematics.
266 * maximum:                               Statistical Functions.
267 * mean:                                  Statistical Functions.
268 * membership, of set:                    Set Membership.
269 * minimum:                               Statistical Functions.
270 * minimum valid number of arguments:     Statistical Functions.
271 * Minton, Claire:                        Credits.
272 * minutes <1>:                           Date Extraction.
273 * minutes:                               Time Extraction.
274 * missing values <1>:                    Missing Value Functions.
275 * missing values <2>:                    Attributes.
276 * missing values:                        Missing Observations.
277 * modulus:                               Miscellaneous Mathematics.
278 * modulus, by 10:                        Miscellaneous Mathematics.
279 * month-year:                            Date Construction.
280 * months:                                Date Extraction.
281 * multiplication:                        Arithmetic Operators.
282 * names, of functions:                   Functions.
283 * names, variable:                       Tokens.
284 * NE:                                    Relational Operators.
285 * negation:                              Arithmetic Operators.
286 * nonterminals:                          BNF.
287 * NOT:                                   Logical Operators.
288 * not implemented:                       Functions Not Implemented.
289 * number:                                BNF.
290 * numbers:                               Tokens.
291 * numbers, converting from strings:      String Functions.
292 * numbers, converting to strings:        String Functions.
293 * obligations, your:                     License.
294 * operations, order of:                  Order of Operations.
295 * operator precedence:                   Order of Operations.
296 * operators <1>:                         Functions.
297 * operators <2>:                         BNF.
298 * operators:                             Tokens.
299 * operators, arithmetic:                 Arithmetic Operators.
300 * operators, grouping:                   Grouping Operators.
301 * operators, logical:                    Logical Operators.
302 * options, command-line:                 Invocation.
303 * OR:                                    Logical Operators.
304 * order of commands:                     Order of Commands.
305 * order of operations:                   Order of Operations.
306 * output:                                Data Input and Output.
307 * output file:                           Files.
308 * output, PSPP:                          Introduction.
309 * padding strings:                       String Functions.
310 * parentheses <1>:                       Functions.
311 * parentheses:                           Grouping Operators.
312 * period:                                Tokens.
313 * Pfaff, Ben:                            Credits.
314 * portability:                           Tokens.
315 * PostScript:                            Introduction.
316 * precedence, operator:                  Order of Operations.
317 * pref.h:                                UNIX installation.
318 * print format:                          Attributes.
319 * productions:                           BNF.
320 * pseudo-random numbers (see random numbers): Pseudo-Random Numbers.
321 * PSPP language:                         Introduction.
322 * PSPP, command structure:               Commands.
323 * PSPP, configuring:                     Configuration.
324 * PSPP, installing <1>:                  UNIX installation.
325 * PSPP, installing:                      Installation.
326 * PSPP, invoking:                        Invocation.
327 * PSPP, language:                        Language.
328 * punctuation:                           Tokens.
329 * punctuators:                           BNF.
330 * quarter-year:                          Date Construction.
331 * quarters:                              Date Extraction.
332 * quotations:                            Credits.
333 * random numbers:                        Pseudo-Random Numbers.
334 * random numbers, normally-distributed:  Pseudo-Random Numbers.
335 * random numbers, uniformly-distributed: Pseudo-Random Numbers.
336 * reading data from a file:              DATA LIST.
337 * reading fixed-format data:             DATA LIST FIXED.
338 * reals:                                 Tokens.
339 * redistribution:                        License.
340 * reserved keywords:                     Tokens.
341 * rights, your:                          License.
342 * rounding:                              Miscellaneous Mathematics.
343 * searching strings:                     String Functions.
344 * seconds <1>:                           Date Extraction.
345 * seconds:                               Time Extraction.
346 * self-tests, running:                   UNIX installation.
347 * set membership:                        Set Membership.
348 * sine:                                  Trigonometry.
349 * square roots:                          Advanced Mathematics.
350 * standard deviation:                    Statistical Functions.
351 * start symbol:                          BNF.
352 * statistics:                            Statistical Functions.
353 * string:                                BNF.
354 * string functions:                      String Functions.
355 * strings:                               Tokens.
356 * strings, case of:                      String Functions.
357 * strings, concatenation of:             String Functions.
358 * strings, converting from numbers:      String Functions.
359 * strings, converting to numbers:        String Functions.
360 * strings, finding length of:            String Functions.
361 * strings, padding:                      String Functions.
362 * strings, searching backwards:          String Functions.
363 * strings, taking substrings of:         String Functions.
364 * strings, trimming:                     String Functions.
365 * subcommands:                           Commands.
366 * substrings:                            String Functions.
367 * subtraction:                           Arithmetic Operators.
368 * sum:                                   Statistical Functions.
369 * symbol, start:                         BNF.
370 * syntax file:                           Files.
371 * system variables:                      System Variables.
372 * system-missing:                        Logical Operators.
373 * tangent:                               Trigonometry.
374 * terminal dot <1>:                      BNF.
375 * terminal dot <2>:                      Commands.
376 * terminal dot:                          Tokens.
377 * terminal dot, changing:                Tokens.
378 * terminals:                             BNF.
379 * terminals and nonterminals, differences: BNF.
380 * testing for equality:                  Relational Operators.
381 * testing for inequality:                Relational Operators.
382 * time:                                  Date Extraction.
383 * time examination:                      Time Extraction.
384 * time, concepts:                        Time & Date Concepts.
385 * time, in days <1>:                     Date Extraction.
386 * time, in days <2>:                     Time Extraction.
387 * time, in days:                         Time Construction.
388 * time, in hours <1>:                    Date Extraction.
389 * time, in hours:                        Time Extraction.
390 * time, in hours-minutes-seconds:        Time Construction.
391 * time, in minutes <1>:                  Date Extraction.
392 * time, in minutes:                      Time Extraction.
393 * time, in seconds <1>:                  Date Extraction.
394 * time, in seconds:                      Time Extraction.
395 * time, instants of:                     Time & Date Concepts.
396 * time, intervals:                       Time & Date Concepts.
397 * time, lengths of:                      Time Extraction.
398 * time, mathematical properties of:      Time & Date Concepts.
399 * times:                                 Time & Date.
400 * times, constructing:                   Time Construction.
401 * times, in days:                        Date Extraction.
402 * TO:                                    Sets of Variables.
403 * TO convention:                         Sets of Variables.
404 * tokens:                                Tokens.
405 * trigonometry:                          Trigonometry.
406 * true:                                  Logical Operators.
407 * truncation:                            Miscellaneous Mathematics.
408 * type of variables:                     Attributes.
409 * union, logical:                        Logical Operators.
410 * UNIX, installing PSPP under:           UNIX installation.
411 * value labels:                          Attributes.
412 * values, Boolean:                       Booleans.
413 * values, missing <1>:                   Missing Value Functions.
414 * values, missing <2>:                   Attributes.
415 * values, missing:                       Missing Observations.
416 * values, system-missing:                Logical Operators.
417 * Van Zandt, James:                      Credits.
418 * var-list:                              BNF.
419 * var-name:                              BNF.
420 * variable labels:                       Attributes.
421 * variable names:                        Tokens.
422 * variable names, ending with period:    Tokens.
423 * variables:                             Variables.
424 * variables, attributes of:              Attributes.
425 * variables, system:                     System Variables.
426 * variables, type:                       Attributes.
427 * variables, width:                      Attributes.
428 * variance:                              Statistical Functions.
429 * variation, coefficient of:             Statistical Functions.
430 * Vonnegut, Kurt, Jr.:                   Credits.
431 * week:                                  Date Extraction.
432 * week-year:                             Date Construction.
433 * weekday:                               Date Extraction.
434 * whitespace:                            Tokens.
435 * whitespace, trimming:                  String Functions.
436 * width of variables:                    Attributes.
437 * write format:                          Attributes.
438 * X':                                    Tokens.
439 * year-day:                              Date Construction.
440 * years:                                 Date Extraction.
441 * your rights and obligations:           License.
442 * |:                                     Logical Operators.
443 * ~:                                     Logical Operators.
444 * ~=:                                    Relational Operators.
445
446 \1f
447 File: pspp.info,  Node: Command Index,  Prev: Concept Index,  Up: Top
448
449 Command Index
450 *************
451
452 * Menu:
453
454 * *:                                     COMMENT.
455 * @:                                     INCLUDE.
456 * ADD VALUE LABELS:                      ADD VALUE LABELS.
457 * AGGREGATE:                             AGGREGATE.
458 * APPLY DICTIONARY:                      APPLY DICTIONARY.
459 * AUTORECODE:                            AUTORECODE.
460 * BEGIN DATA:                            BEGIN DATA.
461 * BREAK:                                 BREAK.
462 * CLEAR TRANSFORMATIONS:                 CLEAR TRANSFORMATIONS.
463 * COMMENT:                               COMMENT.
464 * DATA LIST:                             DATA LIST.
465 * DATA LIST FIXED:                       DATA LIST FIXED.
466 * DATA LIST FREE:                        DATA LIST FREE.
467 * DATA LIST LIST:                        DATA LIST LIST.
468 * DISPLAY:                               DISPLAY.
469 * DISPLAY DOCUMENTS:                     DISPLAY DOCUMENTS.
470 * DISPLAY FILE LABEL:                    DISPLAY FILE LABEL.
471 * DISPLAY VECTORS:                       DISPLAY VECTORS.
472 * DO IF:                                 DO IF.
473 * DO REPEAT:                             DO REPEAT.
474 * DOCUMENT:                              DOCUMENT.
475 * DROP DOCUMENTS:                        DROP DOCUMENTS.
476 * END CASE:                              END CASE.
477 * END DATA:                              BEGIN DATA.
478 * END FILE:                              END FILE.
479 * EXECUTE:                               EXECUTE.
480 * EXPORT:                                EXPORT.
481 * FILE HANDLE:                           FILE HANDLE.
482 * FILE LABEL:                            FILE LABEL.
483 * FILTER:                                FILTER.
484 * FLIP:                                  FLIP.
485 * FORMATS:                               FORMATS.
486 * GET:                                   GET.
487 * IMPORT:                                IMPORT.
488 * INCLUDE:                               INCLUDE.
489 * INPUT PROGRAM:                         INPUT PROGRAM.
490 * LEAVE:                                 LEAVE.
491 * LIST:                                  LIST.
492 * LOOP:                                  LOOP.
493 * MATCH FILES:                           MATCH FILES.
494 * MATRIX DATA:                           MATRIX DATA.
495 * MISSING VALUES:                        MISSING VALUES.
496 * MODIFY VARS:                           MODIFY VARS.
497 * N OF CASES:                            N OF CASES.
498 * NEW FILE:                              NEW FILE.
499 * NUMERIC:                               NUMERIC.
500 * PRINT:                                 PRINT.
501 * PRINT EJECT:                           PRINT EJECT.
502 * PRINT FORMATS:                         PRINT FORMATS.
503 * PRINT SPACE:                           PRINT SPACE.
504 * PROCESS IF:                            PROCESS IF.
505 * QUIT:                                  QUIT.
506 * RENAME VARIABLES:                      RENAME VARIABLES.
507 * REPEATING DATA:                        REPEATING DATA.
508 * REREAD:                                REREAD.
509 * SAMPLE:                                SAMPLE.
510 * SAVE:                                  SAVE.
511 * SELECT IF:                             SELECT IF.
512 * SET:                                   SET.
513 * SORT CASES:                            SORT CASES.
514 * SPLIT FILE:                            SPLIT FILE.
515 * STRING:                                STRING.
516 * SUBTITLE:                              SUBTITLE.
517 * SYSFILE INFO:                          SYSFILE INFO.
518 * TEMPORARY:                             TEMPORARY.
519 * TITLE:                                 TITLE.
520 * VALUE LABELS:                          VALUE LABELS.
521 * VARIABLE LABELS:                       VARIABLE LABELS.
522 * VECTOR:                                VECTOR.
523 * WEIGHT:                                WEIGHT.
524 * WRITE:                                 WRITE.
525 * WRITE FORMATS:                         WRITE FORMATS.
526 * XSAVE:                                 XSAVE.
527
528