From f14ad7d1cee6228053fbadadfee9c86eb80da765 Mon Sep 17 00:00:00 2001 From: Ben Pfaff Date: Thu, 25 Aug 2022 07:00:33 -0700 Subject: [PATCH] work on docs --- doc/statistics.texi | 102 +++++++++++++++++++++++--------------------- 1 file changed, 54 insertions(+), 48 deletions(-) diff --git a/doc/statistics.texi b/doc/statistics.texi index 602f0ad574..b1e040283d 100644 --- a/doc/statistics.texi +++ b/doc/statistics.texi @@ -1448,54 +1448,6 @@ counts: @code{UVARIANCE} (``Unweighted Variance'', F40.0) @end itemize -@node CTABLES Summarizing Missing Values -@subsubsection Summarizing Missing Values - -CTABLES treats missing values in categorical and scale variables -differently. For categorical variables, in most cases values that are -valid and in included categories are analyzed, and values that are -missing or in excluded categories are not analyzed. (@xref{CTABLES -Per-Variable Category Options}), for information on included and -excluded categories.) The following chart, in which cells that -contain ``yes'' indicate that a value is analyzed, and the notes below -it give the exact rules: - -@multitable {@headitemfont{System-Missing}} {Included Category} {Excluded Category} -@headitem @tab Included Category @tab Excluded Category -@item @headitemfont{Valid} @tab yes @tab --- -@item @headitemfont{User-Missing} @tab yes [*] @tab --- [+] -@item @headitemfont{System-Missing} @tab n/a [#] @tab --- [+] -@end multitable - -@table @asis -@item [*] -Exceptions: The ``@t{VALIDN}'' summary functions (@code{VALIDN}, -@code{EVALIDN}, @code{UVALIDN}, @code{@i{area}PCT.VALIDN}, and -@code{U@i{area}PCT.VALIDN}), which only count valid values in included -categories. - -@item [+] -Exceptions: The ``@t{TOTALN}'' summary functions (@code{TOTALN}, -@code{ETOTALN}, @code{UTOTALN}, @code{@i{area}PCT.TOTALN}), and -@code{U@i{area}PCT.TOTALN}, which count all values (valid and missing) -in included categories and missing (but not valid) values in excluded -categories. - -@item [#] -System-missing values are never in included categories. -@end table - -@noindent -The following table provides another view of the same information: - -@multitable {Missing values in excluded categories} {@code{VALIDN}} {other} {@code{TOTALN}} -@headitem @tab @code{VALIDN} @tab other @tab @code{TOTALN} -@item Valid values in included categories @tab yes @tab yes @tab yes -@item Missing values in included categories @tab --- @tab yes @tab yes -@item Missing values in excluded categories @tab --- @tab --- @tab yes -@item Valid values in excluded categories @tab --- @tab --- @tab --- -@end multitable - @node CTABLES Statistics Positions and Labels @subsection Statistics Positions and Labels @@ -1871,6 +1823,60 @@ Show nothing. @node CTABLES Missing Value Treatment @subsection Missing Value Treatment + + +The sections below describe how @code{CTABLES} treats missing values +in categorical and scale variables. + +@node CTABLES Categorical Missing Values +@subsubsection Categorical Missing Values + +For categorical variables, in most cases, values that are valid and in +included categories are analyzed, and values that are missing or in +excluded categories are not analyzed. (@xref{CTABLES Per-Variable +Category Options}), for information on included and excluded +categories.) The exact rules are shown in the following chart, in +which cells that contain ``yes'' indicate that a value is analyzed: + +@multitable {@headitemfont{System-Missing}} {Included Category} {Excluded Category} +@headitem @tab Included Category @tab Excluded Category +@item @headitemfont{Valid} @tab yes @tab --- +@item @headitemfont{User-Missing} @tab yes [*] @tab --- [+] +@item @headitemfont{System-Missing} @tab n/a [#] @tab --- [+] +@end multitable + +@table @asis +@item [*] +Exceptions: The ``@t{VALIDN}'' summary functions (@code{VALIDN}, +@code{EVALIDN}, @code{UVALIDN}, @code{@i{area}PCT.VALIDN}, and +@code{U@i{area}PCT.VALIDN}), which only count valid values in included +categories. + +@item [+] +Exceptions: The ``@t{TOTALN}'' summary functions (@code{TOTALN}, +@code{ETOTALN}, @code{UTOTALN}, @code{@i{area}PCT.TOTALN}), and +@code{U@i{area}PCT.TOTALN}, which count all values (valid and missing) +in included categories and missing (but not valid) values in excluded +categories. + +@item [#] +System-missing values are never in included categories. +@end table + +@noindent +The following table provides another view of the same information: + +@multitable {Missing values in excluded categories} {@code{VALIDN}} {other} {@code{TOTALN}} +@headitem @tab @code{VALIDN} @tab other @tab @code{TOTALN} +@item Valid values in included categories @tab yes @tab yes @tab yes +@item Missing values in included categories @tab --- @tab yes @tab yes +@item Missing values in excluded categories @tab --- @tab --- @tab yes +@item Valid values in excluded categories @tab --- @tab --- @tab --- +@end multitable + +@node CTABLES Scale Missing Values +@subsubsection Scale Missing Values + @display @t{/SMISSING} @{@t{VARIABLE} @math{|} @t{LISTWISE}@} @end display -- 2.30.2