The following options can be specified in the PROC MODEL statement. All of the nonassignment options (the options that do
not accept a value after an equal sign) can have NO prefixed to the option name in the RESET statement to turn the option
off. The default case is not explicitly indicated in the discussion that follows. Thus, for example, the option DETAILS is
documented in the following, but NODETAILS is not documented since it is the default. Also, the NOSTORE option is documented
because STORE is the default.
-
DATA=SAS-data-set
-
names the input data set. Variables in the model program are looked up in the DATA= data set and, if found, their attributes
(type, length, label, format) are set to be the same as those in the input data set (if not previously defined otherwise).
The values for the variables in the program are read from the input data set when the model is estimated or simulated by FIT
and SOLVE statements.
-
OUTPARMS=SAS-data-set
-
writes the parameter estimates to a SAS data set. See the section Output Data Sets for details.
-
PARMSDATA=SAS-data-set
-
names the SAS data set that contains the parameter estimates. In PROC MODEL, you have several options to specify starting
values for the parameters to be estimated. When more than one option is specified, the options are implemented in the following
order of precedence (from highest to lowest): the START= option, the PARMS statement initialization value, the ESTDATA= option,
and the PARMSDATA= option. If no options are specified for the starting value, the default value of 0.0001 is used. See the
section Input Data Sets for details.
-
PLOTS<(global-plot-options)> <=(plot-request …)>
-
selects plots that the MODEL procedure produces via the Output Delivery System. For general information about ODS Graphics, see Chapter 21: Statistical Graphics Using ODS in SAS/STAT 12.1 User's Guide. The global-plot-options apply to all relevant plots generated by the MODEL procedure. The global-plot-options and specific plot-request options supported by the MODEL procedure follow.
- ONLY
-
suppresses the default plots. Only the plots specifically requested are produced.
- UNPACKPANEL
-
displays each graph separately. (By default, some graphs can appear together in a single panel.)
- ALL
-
requests that all plots appropriate for the particular analysis be produced.
- ACF
-
produces the autocorrelation function plot.
- DEPENDENCY<(OUTLINE=ON | OFF)>
-
produces the dependency analysis plots. Specifying the OUTLINE= option displays, or suppresses outlines around the dependency
cells.
- IACF
-
produces the inverse autocorrelation function plot of residuals.
- PACF
-
produces the partial autocorrelation function plot of residuals.
- FITPLOT
-
plots the predicted and actual values.
- COOKSD
-
produces the Cook’s D plot.
- QQ
-
produces a QQ plot of residuals.
- RESIDUAL | RES
-
plots the residuals.
- STUDENTRESIDUAL
-
plots the studentized residuals.
- RESIDUALHISTOGRAM | RESIDHISTOGRAM
-
plots the histogram of residuals.
- NONE
-
suppresses all plots.
Options to Read and Write Model Files
-
MODEL=model-name
MODEL=(model-list)
-
reads the model from one or more input model files created by previous PROC MODEL executions. Model files are written by the OUTMODEL= option.
-
NOSTORE
-
suppresses the default output of the model file. This option is applicable only when FIT or SOLVE statements are not used,
the MODEL= option is not used, and when a model is specified.
-
OUTCAT=(outcat-name MODNAME=model-key <outcat-options>)
SLIST=(outcat-name MODNAME=model-key <outcat-options>)
-
specifies the name and model-key for writing fitted model files. The model-key is a SAS name. Files written using the OUTCAT= option are used by SAS Risk Dimensions. The OUTCAT= option only applies to
FIT statements. You can specify the following outcat-options:
- DIM=n
-
specifies the dimensionality of the model.
- GROUP|MODGROUP=group
-
specifies a SAS name which is the group for the model.
- INTERVAL=interval
-
specifies the time interval between observations.
- MODLABEL=label
-
specifies a label for the model.
- STARTDATE=date
-
specifies the starting date of the model.
-
OUTMODEL=model-name
-
specifies the name of an output model file to which the model is to be written. Starting with SAS 9.2, model files are being
stored as XML-based SAS data sets instead of being stored as members of a SAS catalog as in earlier releases. This makes MODEL
files more readily extendable in the future and enables Java-based applications to read the MODEL files directly. To change
this behavior, use the SAS global-CMPMODEL-options. You can choose the format in which the output model file is stored and read by using the CMPMODEL=global-CMPMODEL-options in an OPTIONS statement as follows.
-
OPTIONS CMPMODEL=global-CMPMODEL-options;
-
You can specify the following global-CMPMODEL-options:
- CATALOG
-
specifies that model files be written and read from SAS catalogs only.
- XML
-
specifies that model files be written and read from XML data sets only.
- BOTH
-
specifies that model files be written to both XML and CATALOG formats. When BOTH is specified, model files are read from the
data set first and read from the SAS catalog only if the data set is not found. This is the default.
Options to List or Analyze the Structure of the Model
These options produce reports on the structure of the model or list the programming statements that define the models. These
options are automatically reset (turned off) after the reports are printed. To turn these options back on after a RUN statement
has been entered, use the RESET statement or specify the options in a FIT or SOLVE statement.
-
ANALYZEDEP=(dependency-plot1 <dependency-plot2 …>)
-
plots analyses of the dependencies among equations and solve variables. Each dependency-plot is one of the following:
- BLOCK
-
specifies a block dependency matrix of the entire system.
- BLOCK(eq-list,var-list)
-
specifies a block dependency matrix for a subset of equations and solve variables.
- DETAILS
-
specifies a dependency matrix of all equations and solve variables.
- DETAILS(eq-list,var-list)
-
specifies a dependency matrix for a subset of equations and solve variables.
- NOLISTBLOCK
-
suppresses the listing of dependency blocks.
You can specify which equations and solve variables are included in the dependency analysis by qualifying both the BLOCK and
DETAILS dependency-plot options with a pair of lists. The first list in the pair is the eq-list. It specifies which equations to include in the dependency analysis. You can specify a mix of equation names and equation
group labels in the eq-list. The MODEL procedure replaces each equation group label in the eq-list with the list of equations that are specified in the corresponding EQGROUP statement. The second list in the pair is the
var-list. It specifies which solve variables to include in the dependency analysis. You can specify a mix of variable names and variable
group labels in the var-list. The MODEL procedure replaces each variable group label in the var-list with the list of variables that are specified in the corresponding VARGROUP statement. By default, when you specify a BLOCK
option, a listing of the equations and solve variables that form each dependency block is generated. The NOLISTBLOCK option
suppresses this listing. The ANALYZEDEP= option applies only to SOLVE steps. For more information about the analyses that
are performed by the ANALYZEDEP= option, see the section Diagnostics and Debugging.
-
BLOCK
-
prints an analysis of the structure of the model given by the assignments to model variables that appear in the model program.
This analysis includes a classification of model variables into endogenous (dependent) and exogenous (independent) groups
based on the presence of the variable on the left side of an assignment statement. The endogenous variables are grouped into
simultaneously determined blocks. The dependency structure of the simultaneous blocks and exogenous variables is also printed.
The BLOCK option cannot analyze dependencies implied by general form equations.
-
GRAPH
-
prints the graph of the dependency structure of the model. The GRAPH option also invokes the BLOCK option and produces a graphical display of the information listed by the BLOCK option.
-
LIST
-
prints the model program and variable lists, including the statements added by PROC MODEL and macros.
-
LISTALL
-
selects the LIST, LISTDEP, LISTDER, and LISTCODE options.
-
LISTCODE
-
prints the derivative tables and compiled model program code. LISTCODE is a debugging feature and is not normally needed.
-
LISTDEP
-
prints a report that lists for each variable in the model program the variables that depend on it and that it depends on.
These lists are given separately for current-period values and for lagged values of the variables.
The information displayed is the same as that used to construct the BLOCK report but differs in that the information is listed
for all variables (including parameters, control variables, and program variables), not just for the model variables. Classification
into endogenous and exogenous groups and analysis of simultaneous structure is not done by the LISTDEP report.
-
LISTDER
-
prints a table of derivatives for FIT and SOLVE tasks. (The LISTDER option is applicable only for the default NEWTON method
for SOLVE tasks.) The derivatives table shows each nonzero derivative computed for the problem. The derivative listed can
be a constant, a variable in the model program, or a special derivative variable created to hold the result of the derivative
expression. This option is turned on by the LISTCODE and PRINTALL options.
-
XREF
-
prints a cross-reference of the variables in the model program that shows where each variable was referenced or given a value.
The XREF option is normally used in conjunction with the LIST option. A more detailed description is given in the section
Diagnostics and Debugging.
General Printing Control Options
-
DETAILS
-
specifies the detailed printout. Parts of the printed output are expanded when the DETAILS option is specified. The following
additional graphs of the residuals are produced when graphics output is enabled: ACF, PACF, IACF, white noise, and QQ plot
versus the normal.
-
FLOW
-
prints a message for each statement in the model program as it is executed. This debugging option is needed very rarely and
produces voluminous output.
-
MAXERRORS=n
-
specifies the maximum number of execution errors that can be printed. The default is MAXERRORS=50.
-
MEMORYUSE
-
prints a report of the memory required for the various parts of the analysis.
-
NDEC=n
-
specifies the precision of the format that PROC MODEL uses when printing various numbers. The default is NDEC=3, which means
that PROC MODEL attempts to print values by using the D format but ensures that at least three significant digits are shown.
If the NDEC= value is greater than nine, the BEST. format is used. The smallest value allowed is NDEC=2.
The NDEC= option affects the format of most, but not all, of the floating point numbers that PROC MODEL can print. For some
values (such as parameter estimates), a precision limit one or two digits greater than the NDEC= value is used. This option
does not apply to the precision of the variables in the output data set.
-
NOPRINT
-
suppresses the normal printed output but does not suppress error listings. Using any other print option turns the NOPRINT
option off. The PRINT option can be used with the RESET statement to turn off NOPRINT.
-
PRINTALL
-
turns on all the printing-control options. The options set by PRINTALL are DETAILS; the model information options LIST, LISTDEP,
LISTDER, XREF, BLOCK, and GRAPH; the FIT task printing options FSRSQ, COVB, CORRB, COVS, CORRS, DW, and COLLIN; and the SOLVE
task printing options STATS, THEIL, SOLVEPRINT, and ITPRINT.
-
REPORTMISSINGS
-
prints tables that summarize missing values that are encountered during a SOLVE or FIT task. The missing values that are summarized
in these tabular reports can be produced by missing values in the DATA= data set or by calculations in the model program that
generate missing values. The number of missing values that are reported can be limited by using the MAXERRORS= option.
-
TRACE
-
prints the result of each operation in each statement in the model program as it is executed, in addition to the information
printed by the FLOW option. This debugging option is needed very rarely and produces voluminous output.
The following options are used in the FIT statement (parameter estimation) and can also be used in the PROC MODEL statement:
COLLIN, CONVERGE=, CORR, CORRB, CORRS, COVB, COVBEST=, COVS, DW, FIML, FSRSQ, GMM, HESSIAN=, I, INTGPRINT, ITALL, ITDETAILS,
ITGMM, ITPRINT, ITOLS, ITSUR, IT2SLS, IT3SLS, KERNEL=, LTEBOUND=, MAXITER=, MAXSUBITER=, METHOD=, MINTIMESTEP=, NESTIT, N2SLS,
N3SLS, OLS, OUTPREDICT, OUTRESID, OUTACTUAL, OUTLAGS, OUTALL, OUTCOV, SINGULAR=, STARTITER=, SUR, TIME=, VARDEF, and XPX.
See the section FIT Statement for a description of these options.
When used in the PROC MODEL or RESET statement, these are default options for subsequent FIT statements. For example, the
statement
proc model n2sls ... ;
makes two-stage least squares the default parameter estimation method for FIT statements that do not specify an estimation
method.
The following options for the SOLVE statement can also be used in the PROC MODEL statement: CONVERGE=, DYNAMIC, FORECAST,
INTGPRINT, ITPRINT, JACOBI, LTEBOUND=, MAXITER=, MAXSUBITER=, MINTIMESTEP=, NAHEAD=, NEWTON, OUTPREDICT, OUTRESID, OUTACTUAL,
OUTLAGS, OUTERRORS, OUTALL, SEED=, SEIDEL, SIMULATE, SINGLE, SINGULAR=, SOLVEPRINT, START=, STATIC, STATS, THEIL, TIME=, and
TYPE=. For more information about these options, see section SOLVE Statement.
When used in the PROC MODEL or RESET statement, these options provide default values for subsequent SOLVE statements.