From ca55d1892bd94f4eca0435fc7d92909be7a0c201 Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Wed, 1 Jun 2022 16:23:58 -0700 Subject: [PATCH] work on docs --- doc/automake.mk | 5 +++ doc/pspp-figures/ctables13.sps | 2 + doc/pspp-figures/ctables14.sps | 2 + doc/pspp-figures/ctables15.sps | 2 + doc/pspp-figures/ctables16.sps | 2 + doc/pspp-figures/ctables17.sps | 4 ++ doc/statistics.texi | 80 ++++++++++++++++++++++++++++++++++ 7 files changed, 97 insertions(+) create mode 100644 doc/pspp-figures/ctables13.sps create mode 100644 doc/pspp-figures/ctables14.sps create mode 100644 doc/pspp-figures/ctables15.sps create mode 100644 doc/pspp-figures/ctables16.sps create mode 100644 doc/pspp-figures/ctables17.sps diff --git a/doc/automake.mk b/doc/automake.mk index b90dbaa18d..7cc5595d2c 100644 --- a/doc/automake.mk +++ b/doc/automake.mk @@ -129,6 +129,11 @@ FIGURE_SYNTAX = \ doc/pspp-figures/ctables10.sps \ doc/pspp-figures/ctables11.sps \ doc/pspp-figures/ctables12.sps \ + doc/pspp-figures/ctables13.sps \ + doc/pspp-figures/ctables14.sps \ + doc/pspp-figures/ctables15.sps \ + doc/pspp-figures/ctables16.sps \ + doc/pspp-figures/ctables17.sps \ doc/pspp-figures/crosstabs.sps \ doc/pspp-figures/descriptives.sps \ doc/pspp-figures/flip.sps \ diff --git a/doc/pspp-figures/ctables13.sps b/doc/pspp-figures/ctables13.sps new file mode 100644 index 0000000000..723dbeda31 --- /dev/null +++ b/doc/pspp-figures/ctables13.sps @@ -0,0 +1,2 @@ +GET FILE='nhtsa.sav'. +CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a. diff --git a/doc/pspp-figures/ctables14.sps b/doc/pspp-figures/ctables14.sps new file mode 100644 index 0000000000..168d237f17 --- /dev/null +++ b/doc/pspp-figures/ctables14.sps @@ -0,0 +1,2 @@ +GET FILE='nhtsa.sav'. +CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a /SLABELS POSITION=ROW. diff --git a/doc/pspp-figures/ctables15.sps b/doc/pspp-figures/ctables15.sps new file mode 100644 index 0000000000..c8b86f7162 --- /dev/null +++ b/doc/pspp-figures/ctables15.sps @@ -0,0 +1,2 @@ +GET FILE='nhtsa.sav'. +CTABLES /TABLE=AgeGroup [TABLEPCT] /SLABELS VISIBLE=NO. diff --git a/doc/pspp-figures/ctables16.sps b/doc/pspp-figures/ctables16.sps new file mode 100644 index 0000000000..5812acef97 --- /dev/null +++ b/doc/pspp-figures/ctables16.sps @@ -0,0 +1,2 @@ +GET FILE='nhtsa.sav'. +CTABLES /TABLE AgeGroup BY qns3a. diff --git a/doc/pspp-figures/ctables17.sps b/doc/pspp-figures/ctables17.sps new file mode 100644 index 0000000000..590e600ff5 --- /dev/null +++ b/doc/pspp-figures/ctables17.sps @@ -0,0 +1,4 @@ +GET FILE='nhtsa.sav'. +*CTABLES /TABLE AgeGroup BY qns3a /CLABELS ROWLABELS=OPPOSITE. +CTABLES /TABLE AgeGroup BY qns3a /CLABELS COLLABELS=OPPOSITE. + diff --git a/doc/statistics.texi b/doc/statistics.texi index dfc3aad875..be57f1a735 100644 --- a/doc/statistics.texi +++ b/doc/statistics.texi @@ -1371,6 +1371,86 @@ counts: @code{UVARIANCE} (``Unweighted Variance'') @end itemize +@node CTABLES Statistics Positions and Labels +@subsection Statistics Positions and Labels + +@display +@t{/SLABELS} + [@t{POSITION=}@{@t{COLUMN} @math{|} @t{ROW} @math{|} @t{LAYER}@}] + [@t{VISIBLE=}@{@t{YES} @math{|} @t{NO}@}] +@end display + +The @code{SLABELS} subcommand controls the position and visibility of +summary statistics for the @code{TABLE} subcommand that it follows. + +@code{POSITION} sets the axis on which summary statistics appear. +With @t{POSITION=COLUMN}, which is the default, each summary statistic +appears in a column. For example: + +@example +CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a. +@end example +@psppoutput {ctables13} + +@noindent +With @t{POSITION=ROW}, each summary statistic appears in a row, as +shown below: + +@example +CTABLES /TABLE=qnd1 [MEAN, MEDIAN] BY qns3a /SLABELS POSITION=ROW. +@end example +@psppoutput {ctables14} + +@noindent +@t{POSITION=LAYER} is also available to place each summary statistic in +a separate layer. + +Labels for summary statistics are shown by default. Use +@t{VISIBLE=NO} to suppress them. Because unlabeled data can cause +confusion, it should only be considered if the meaning of the data is +evident, as in a simple case like this: + +@example +CTABLES /TABLE=AgeGroup [TABLEPCT] /SLABELS VISIBLE=NO. +@end example +@psppoutput {ctables15} + +@node CTABLES Category Label Positions +@subsection Category Label Positions + +@display +@t{/CLABELS} @{@t{AUTO} @math{|} @{@t{ROWLABELS}@math{|}@t{COLLABELS}@}@t{=}@{@t{OPPOSITE}@math{|}@t{LAYER}@}@} +@end display + +The @code{CLABELS} subcommand controls the position of category +labels. By default, category labels for a given variable nest inside +the variable's label on the same axis. For example, the command below +results in age categories nesting within the age group variable on the +rows axis and gender categories within the gender variable on the +columns axis: + +@example +CTABLES /TABLE AgeGroup BY qns3a. +@end example +@psppoutput {ctables16} + +With @t{ROWLABELS=OPPOSITE} or @t{COLLABELS=OPPOSITE}, row or column +variable labels, respectively, move to the opposite axis. Only one +axis's labels may be moved, and the setting affects only the innermost +variable on the given axis. For example: + +@example +CTABLES /TABLE AgeGroup BY qns3a /CLABELS ROWLABELS=OPPOSITE. +CTABLES /TABLE AgeGroup BY qns3a /CLABELS COLLABELS=OPPOSITE. +@end example +@psppoutput {ctables17} + +@node CTABLES Per-Variable Category Options +@subsection Per-Variable Category Options + +@node CTABLES Titles +@subsection Titles + @node FACTOR @section FACTOR -- 2.30.2