Fits the same regression model to several response variates, and collates the output (P. Brain, R.W. Payne & D.B. Baird).
Options
PRINT = string tokens |
Controls printed output (model, summary); default * i.e. none |
|---|---|
TERMS = formula |
Defines the regression model to fit on each variate |
WEIGHTS = variate or symmetric matrix |
Weights for the regression; default 1 |
OFFSET = variate |
Offset; default * i.e. none |
CONSTANT = string token |
How to treat the constant (estimate, omit); default esti |
FACTORIAL = scalar |
Limit for expansion of model terms; default 3 |
FULL = string token |
Whether to assign all possible parameters to factors and interactions (yes, no); default no |
POOL = string token |
Whether to pool the information on each term in the analysis of variance (yes, no); default no |
RMETHOD = string token |
Type of residuals to form (deviance, Pearson, simple); default devi |
SPREADSHEET = string tokens |
What results to save in a book of spreadsheets (aov, residuals, fittedvalues, estimates, se, testimates, prestimates); default * i.e. none |
Parameters
Y = variates or pointers |
Y-values for each set of analyses |
|---|---|
RESIDUALS = matrices |
Saves residuals from each set of analyses |
FITTEDVALUES = matrices |
Saves fitted values from each set of analyses |
ESTIMATES = matrices |
Saves estimates from each set of analyses |
SE = matrices |
Saves s.e.’s of estimates |
TESTIMATES = matrices |
Saves t-statistics of estimates |
PRESTIMATES = matrices |
Saves t-probabilities of estimates |
DF = pointers |
Saves degrees of freedom for the model terms or variates in each analysis of variance |
SS = pointers or variates |
Saves sums of squares for the model terms in each analysis of variance |
MS = pointers or variates |
Saves mean squares for the model terms in each analysis of variance |
RDF = variates |
Saves degrees of freedom from the “residual” lines in each analysis of variance |
RSS = variates |
Saves sums of squares from the “residual” lines |
RMS = variates |
Saves mean squares from the “residual” lines |
TDF = variates |
Saves degrees of freedom from the “total” lines in each analysis of variance |
TSS = variates |
Saves sums of squares from the “total” lines |
TMS = variates |
Saves mean squares from the “total” lines |
VR = pointers or variates |
Saves variance ratios for the model terms in each analysis of variance |
PRVR = pointers or variates |
Saves probabilities of the variance ratios |
OUTFILENAME = texts |
Name of Genstat workbook file (.gwb) or Excel (.xls or .xlsx) file to create |
Description
The RYPARALLEL procedure fits the same regression model (in “parallel”) to several response variates, combining and summarizing the information from all the analyses. The response variates are supplied in pointer, using the Y parameter of RYPARALLEL. The model for the regressions is specified by the TERMS, WEIGHTS, OFFSET, CONSTANT, FACTORIAL and FULL options, which operate exactly as in ordinary regression (see the MODEL, TERMS and FIT directives).
The RESIDUALS and FITTEDVALUES parameters allow you to save the residuals and fitted values from the regressions. These are defined as matrices, with a row for each y-variate, and a column for each unit. The RMETHOD option indicates what sort of residual to form, as in the other Genstat regression commands. By default, standardized residuals are formed, but you can set RMETHOD=simple to form simple residuals instead.
The ESTIMATES, SE, TESTESTIMATES and PRESTIMATES parameters save the estimates, standard errors, t-statistics and t-probabilities for the parameters in the regression model. These are defined as matrices, with a row for each y-variate, and a column for each parameter.
The DF, SS, MS, RDF, RSS, RMS, TDF, TSS, TMS, VR and PRVR parameters store information from the analysis of variance table. (DF, SS, MS, VR and PRVR are from the “regression” line, RDF, RSS and RMS are from the “residual” line, and TDF, TSS and TMS are from the “total” line.) With the default setting no of the POOL option each of these is a pointer containing a variate for each term in the TERMS formula. The variates each have a unit for every y-variate. Alternatively, if you set POOL=yes, the parameters each have a single variate, with the values pooled over the terms.
Printed output is controlled by the PRINT option, with settings:
model |
for a description of the regression model, and |
|---|---|
summary |
for a summary of the significance levels found over the analyses for each parameter in the model. |
The SPREADSHEET option lets you save the various output components in spreadsheets. You can save these in either a Genstat workbook (.gwb) or an Excel spreadsheet (.xls or .xlsx), by setting the OUTFILENAME option to the name of the file to create. If the name is specified without a suffix, '.gwb' is added (so that a Genstat workbook is saved). If OUTFILENAME is not specified, they are put into a spreadsheet opened inside Genstat.
Options: PRINT, TERMS, WEIGHTS, OFFSET, CONSTANT, FACTORIAL, FULL, POOL, RMETHOD, SPREADSHEET.
Parameters: Y, RESIDUALS, FITTEDVALUES, ESTIMATES, SE, TESTIMATES, PRESTIMATES, DF, SS, MS, RDF, RSS, RMS, TDF, TSS, TMS, VR, PRVR, OUTFILENAME.
Method
The analyses are performed by the FIT directive and by matrix calculations.
Action with RESTRICT
Any restrictions on the y-variates will be removed.
See also
Procedures: AYPARALLEL, MAREGRESSION.
Commands for: Regression analysis.
Example
CAPTION 'RYPARALLEL example'
SPLOAD FILE='%gendir%/data/Water.gsh'
POINTER [VALUES=Product,Water] yvars
RYPARALLEL [PRINT=model,summary; TERMS=Employ,Opdays,Temp] yvars;\
ESTIMATES=estimates; TESTIMATES=tstatistic; PRESTIMATES=tprob;\
SE=se; DF=dfp; SS=ssp; MS=msp; RDF=rdf; RSS=rss; RMS=rms;\
TDF=tdf; TSS=tss; TMS=tms; VR=vrp; PRVR=prvrp
PRINT [SERIAL=yes] estimates,se,tstatistic,tprob
PRINT dfp[],ssp[],msp[],vrp[],prvrp[]
& rdf,rss,rms,tdf,tss,tms
MODEL Product,Water
FIT [PRINT=summary,estimates,accumulated; FPROB=yes; TPROB=yes]\
Employ,Opdays,Temp