From: Jason Stover <jhs@math.gcsu.edu>
Date: Fri, 28 Apr 2006 20:07:04 +0000 (+0000)
Subject: added regression node to doc build
X-Git-Tag: sav-api~1934
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=571f85fc18f4b8cafea2d7b8ea6cf2c4cb2b02c8;p=pspp
added regression node to doc build
---
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 34d1a890fa..901cf10275 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,10 @@
+2006-04-28 Jason Stover <jhs@math.gcsu.edu>
+
+ * regression.texi: Added description of the RESID and PRED
+ keywords to the SAVE subcommand.
+
+ * statistics.texi: Added REGRESSION node.
+
2006-04-21 Jason Stover <jhs@math.gcsu.edu>
* regression.texi: Initial description of the SAVE subcommand.
diff --git a/doc/automake.mk b/doc/automake.mk
index 0ca4fe2dde..4eb3b30016 100644
--- a/doc/automake.mk
+++ b/doc/automake.mk
@@ -24,6 +24,7 @@ doc_pspp_TEXINFOS = doc/version.texi \
doc/q2c.texi \
doc/statistics.texi \
doc/transformation.texi \
+ doc/regression.texi \
doc/utilities.texi \
doc/variables.texi \
doc/fdl.texi
diff --git a/doc/regression.texi b/doc/regression.texi
index 22b9f58ff6..74816307a0 100644
--- a/doc/regression.texi
+++ b/doc/regression.texi
@@ -1,4 +1,5 @@
-@node REGRESSION, , ONEWAY, Statistics
+@node REGRESSION, ,ONEWAY, Statistics
+@comment node-name, next, previous, up
@section REGRESSION
The REGRESSION procedure fits linear models to data via least-squares
@@ -45,7 +46,7 @@ REGRESSION
/DEPENDENT=var_list
/STATISTICS=@{ALL, DEFAULTS, R, COEFF, ANOVA, BCOV@}
/EXPORT ('file-name')
- /SAVE
+ /SAVE=@{PRED, RESID@}
@end display
The @cmd{REGRESSION} procedure reads the active file and outputs
@@ -54,7 +55,7 @@ statistics relevant to the linear model specified by the user.
The VARIABLES subcommand, which is required, specifies the list of
variables to be analyzed. Keyword VARIABLES is required. The
DEPENDENT subcommand specifies the dependent variable of the linear
-model. The DEPENDENT subcommond is required. All variables listed in
+model. The DEPENDENT subcommand is required. All variables listed in
the VARIABLES subcommand, but not listed in the DEPENDENT subcommand,
are treated as explanatory variables in the linear model.
@@ -76,10 +77,13 @@ Analysis of variance table for the model.
The covariance matrix for the estimated model coefficients.
@end table
-The SAVE subcommand causes PSPP to save the residuals from the fitted
+The SAVE subcommand causes PSPP to save the residuals or predicted
+values from the fitted
model to the active file. PSPP will store the residuals in a variable
called RES1 if no such variable exists, RES2 if RES1 already exists,
-RES3 if RES1 and RES2 already exist, etc.
+RES3 if RES1 and RES2 already exist, etc. It will choose the name of
+the variable for the predicted values similarly, but with PRED as a
+prefix.
The EXPORT subcommand causes PSPP to write a C program containing
functions related to the model. One such function accepts values of
@@ -95,7 +99,8 @@ PSPP extension.
@node Examples, , Syntax, REGRESSION
@subsection Examples
-The following PSPP code will generate the default output, and save the
+The following PSPP syntax will generate the default output, save the
+predicted values and residuals to the active file, and save the
linear model in a program called ``model.c.''
@example
@@ -114,7 +119,8 @@ a 8.838262 -29.25689
b 6.200189 -18.58219
end data.
list.
-regression /variables=v0 v1 v2 /statistics defaults /dependent=v2 /export (model.c) /method=enter.
+regression /variables=v0 v1 v2 /statistics defaults /dependent=v2
+ /export (model.c) /save pred resid /method=enter.
@end example
The file pspp_model_reg.h contains these declarations:
diff --git a/doc/statistics.texi b/doc/statistics.texi
index 26266e4e86..2cb79d23e4 100644
--- a/doc/statistics.texi
+++ b/doc/statistics.texi
@@ -14,6 +14,7 @@ far.
* CROSSTABS:: Crosstabulation tables.
* T-TEST:: Test hypotheses about means.
* ONEWAY:: One way analysis of variance.
+* REGRESSION:: Linear regression.
@end menu
@node DESCRIPTIVES, FREQUENCIES, Statistics, Statistics
@@ -599,7 +600,7 @@ of variable preceding @code{WITH} against variable following
@code{WITH} are generated.
-@node ONEWAY, , T-TEST, Statistics
+@node ONEWAY, REGRESSION, T-TEST, Statistics
@comment node-name, next, previous, up
@section ONEWAY
@@ -648,3 +649,5 @@ display a warning, but will proceed with the analysis.
The @code{CONTRASTS} subcommand may be given up to 10 times in order
to specify different contrast tests.
@setfilename ignored
+
+@include regression.texi