X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fstatistics.texi;h=c46189bd0709394fe2552ee9783915126c9442a3;hb=e4955eebfee4b79846bbb5ba27daaa39a02ef05c;hp=e18c6109dba73f69aed403bcd4c677980ab48690;hpb=d0ac5f484f29fa3a9775e981a67866b7df2b61a5;p=pspp diff --git a/doc/statistics.texi b/doc/statistics.texi index e18c6109db..c46189bd07 100644 --- a/doc/statistics.texi +++ b/doc/statistics.texi @@ -1,3 +1,12 @@ +@c PSPP - a program for statistical analysis. +@c Copyright (C) 2017 Free Software Foundation, Inc. +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.3 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". +@c @node Statistics @chapter Statistics @@ -785,7 +794,10 @@ Fixes for any of these deficiencies would be welcomed. @cindex data reduction @display -FACTOR VARIABLES=@var{var_list} +FACTOR @{ + VARIABLES=@var{var_list}, + MATRIX IN (@{CORR,COV@}=@{*,@var{file_spec}@}) + @} [ /METHOD = @{CORRELATION, COVARIANCE@} ] @@ -795,7 +807,7 @@ FACTOR VARIABLES=@var{var_list} [ /ROTATION=@{VARIMAX, EQUAMAX, QUARTIMAX, PROMAX[(@var{k})], NOROTATE@}] - [ /PRINT=[INITIAL] [EXTRACTION] [ROTATION] [UNIVARIATE] [CORRELATION] [COVARIANCE] [DET] [KMO] [SIG] [ALL] [DEFAULT] ] + [ /PRINT=[INITIAL] [EXTRACTION] [ROTATION] [UNIVARIATE] [CORRELATION] [COVARIANCE] [DET] [KMO] [AIC] [SIG] [ALL] [DEFAULT] ] [ /PLOT=[EIGEN] ] @@ -809,10 +821,21 @@ FACTOR VARIABLES=@var{var_list} The @cmd{FACTOR} command performs Factor Analysis or Principal Axis Factoring on a dataset. It may be used to find common factors in the data or for data reduction purposes. -The @subcmd{VARIABLES} subcommand is required. It lists the variables -which are to partake in the analysis. (The @subcmd{ANALYSIS} +The @subcmd{VARIABLES} subcommand is required (unless the @subcmd{MATRIX IN} +subcommand is used). +It lists the variables which are to partake in the analysis. (The @subcmd{ANALYSIS} subcommand may optionally further limit the variables that -participate; it is not useful and implemented only for compatibility.) +participate; it is useful primarily in conjunction with @subcmd{MATRIX IN}.) + +If @subcmd{MATRIX IN} instead of @subcmd{VARIABLES} is specified, then the analysis +is performed on a pre-prepared correlation or covariance matrix file instead of on +individual data cases. Typically the matrix file will have been generated by +@cmd{MATRIX DATA} (@pxref{MATRIX DATA}) or provided by a third party. +If specified, @subcmd{MATRIX IN} must be followed by @samp{COV} or @samp{CORR}, +then by @samp{=} and @var{file_spec} all in parentheses. +@var{file_spec} may either be an asterisk, which indicates the currently loaded +dataset, or it may be a filename to be loaded. @xref{MATRIX DATA}, for the expected +format of the file. The @subcmd{/EXTRACTION} subcommand is used to specify the way in which factors (components) are extracted from the data. If @subcmd{PC} is specified, then Principal Components Analysis is used. @@ -848,6 +871,8 @@ The @subcmd{/PRINT} subcommand may be used to select which features of the analy The covariance matrix is printed. @item @subcmd{DET} The determinant of the correlation or covariance matrix is printed. +@item @subcmd{AIC} + The anti-image covariance and anti-image correlation matrices are printed. @item @subcmd{KMO} The Kaiser-Meyer-Olkin measure of sampling adequacy and the Bartlett test of sphericity is printed. @item @subcmd{SIG}