Nonlinear Models Action Set: Syntax
Provides actions for fitting nonlinear models
nlmod Action
Fits nonlinear regression models using either nonlinear least squares or maximum likelihood.
CASL Syntax
Summary: Input and Output Tables
If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
— |
specifies the data table that provides parameter starting values. | |
|
required parametertable |
— |
specifies the input data table. |
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
names |
lists the names of results tables to save as CAS tables on the server. | |
|
— |
specifies the output data table. |
Parameter Descriptions
attributes={{casinvardesc-1} <, {casinvardesc-2}, ...>}
changes the attributes of variables used in this action. Currently, attributes specified on the inputs and nominals parameter are ignored.
For more information about specifying the attributes parameter, see the common casinvardesc parameter (Appendix A: Common Parameters).
| Alias | attribute |
|---|
bounds={{bounds_Statement-1} <, {bounds_Statement-2}, ...>}
lists the bounds for the parameters in the model.
The bounds_Statement value can be one or more of the following:
lb=double
specifies an exclusive lower bound value for the named parameter (that is, the parameter must be greater than this value).
leb=double
specifies an inclusive lower bound value with an equality sign for the named parameter (that is, the parameter is greater than or equal to this value).
* name="string" | {"string-1" <, "string-2", ...>}
specifies the name of the parameter that needs to be restricted by a bound.
ub=double
specifies an exclusive upper bound value for the named parameter (that is, the parameter must be less than this value).
ueb=double
specifies an inclusive upper bound value with an equality sign for the named parameter (that is, the parameter is less than or equal to this value).
display={displayTables}
specifies a list of results tables to send to the client for display.
For more information about specifying the display parameter, see the common displayTables parameter (Appendix A: Common Parameters).
estimate={{estimate_Statement-1} <, {estimate_Statement-2}, ...>}
lists the additional expressions that need to be estimated after the model is fitted.
The estimate_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional estimates.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for additional estimates.
* expression="string"
specifies the expression to be estimated.
* label="string"
specifies the label for the estimated expression.
id={"variable-name-1" <, "variable-name-2", ...>}
lists the variables that need to be stored in an output data table.
model={model_Statement}
specifies the dependent variable, its distribution, and its distribution parameters.
The model_Statement value can be one or more of the following:
* depvar="string"
specifies the dependent variable.
* distparms={"string-1" <, "string-2", ...>}
specifies the dependent variable distribution parameters.
* distribution="BERNOULLI" | "BINOMIAL" | "GAM" | "GAUSS" | "GENERAL" | "LS" | "NB" | "POISSON" | "T"
specifies the type of distribution for the dependent variable.
nlmodCode="string"
specifies the nonlinear programming statements in a quoted string.
nlmodOptions={nlmod_options}
lists options that uses in NLMOD action.
The nlmod_options value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional parameter estimates.
| Default | 0.05 |
|---|---|
| Range | 0–1 |
corr=TRUE | FALSE
when set to True, displays the approximate correlation matrix for the parameter estimates.
| Default | FALSE |
|---|
cov=TRUE | FALSE
when set to True, displays the approximate covariance matrix for the parameter estimates.
| Default | FALSE |
|---|
df=double
specifies the degrees of freedom to use in calculating p-values for additional parameter estimates.
| Minimum value | 0 |
|---|
eCorr=TRUE | FALSE
when set to True, displays the approximate correlation matrix for all expressions that are specified in the estimate parameter.
| Default | FALSE |
|---|
eCov=TRUE | FALSE
when set to True, displays the approximate covariance matrix for all expressions that are specified in the estimate parameter.
| Default | FALSE |
|---|
noItPrint=TRUE | FALSE
when set to True, suppresses the display of the Iteration History table.
| Default | FALSE |
|---|
noPrint=TRUE | FALSE
when set to True, suppresses output
| Default | FALSE |
|---|
optimizeOpts={opti_options}
specifies optimization-related options.
The opti_options value can be one or more of the following:
absconv=double
specifies the absolute function convergence criterion.
| Alias | abstol |
|---|
absfconv=double
specifies the absolute difference function convergence criterion.
| Alias | absftol |
|---|---|
| Minimum value | 0 |
absfconvN=64-bit-integer
specifies the number of additional iterations for which the absolute difference function convergence criterion must be satisfied before the process terminates.
| Alias | absftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
absgconv=double
specifies the absolute gradient convergence criterion.
| Alias | absgtol |
|---|---|
| Minimum value | 0 |
absgconvN=64-bit-integer
specifies the number of additional iterations for which the absolute gradient convergence criterion must be satisfied before the process terminates.
| Alias | absgtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
fconv=double
specifies the relative function convergence criterion.
| Alias | ftol |
|---|---|
| Minimum value | 0 |
fconvN=64-bit-integer
specifies the number of additional iterations for which the difference function convergence criterion must be satisfied before the process terminates.
| Alias | ftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
gconv=double
specifies the relative gradient convergence criterion.
| Alias | gtol |
|---|---|
| Minimum value | 0 |
gconvN=64-bit-integer
specifies the number of additional iterations for which the gradient convergence criterion must be satisfied before the process terminates.
| Alias | gtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
maxfunc=64-bit-integer
specifies the maximum number of function evaluations in any optimization.
| Alias | maxfu |
|---|---|
| Minimum value | 0 |
maxiter=64-bit-integer
specifies the maximum number of iterations in any optimization.
| Alias | maxit |
|---|---|
| Minimum value | 1 |
maxtime=double
specifies the upper limit (in seconds) of CPU time for any optimization.
| Minimum value | 0 |
|---|
miniter=64-bit-integer
specifies the minimum number of iterations in any optimization.
| Default | -1 |
|---|---|
| Minimum value | 0 |
technique="CG" | "DBLDOG" | "DQN" | "LEVMAR" | "NEWRAP" | "NMS" | "NONE" | "NRR" | "QN" | "TR"
specifies the optimization technique.
outputTables={outputTables}
lists the names of results tables to save as CAS tables on the server.
For more information about specifying the outputTables parameter, see the common outputTables parameter (Appendix A: Common Parameters).
| Alias | displayOut |
|---|
parameters={{parms_Statement-1} <, {parms_Statement-2}, ...>}
lists the parameters of the model and their initial values.
| Alias | parms |
|---|
The parms_Statement value can be one or more of the following:
* name="string" | {"string-1" <, "string-2", ...>}
specifies the parameter name.
vals=double | {double-1 <, double-2, ...>} | {parmvalftb}
specifies the initial values for the parameter.
The parmvalftb value can be one or more of the following:
by=double
specifies the BY value in a FROM BY TO format of an initial values specification.
| Default | 1 |
|---|
* from=double
specifies the FROM value in a FROM BY TO format of an initial values specification.
* to=double
specifies the TO value in a FROM BY TO format of an initial values specification.
parmData={castable}
specifies the data table that provides parameter starting values.
For more information about specifying the parmData parameter, see the common castable parameter (Appendix A: Common Parameters).
parmOptions={parm_options}
specifies the options for the initial parameter specifications.
The parm_options value can be one or more of the following:
best=64-bit-integer
specifies the maximum number of initial values to display.
| Minimum value | 1 |
|---|
start=double
specifies a default initial value for all the parameters in the model.
| Alias | defstart |
|---|
predict={{predict_Statement-1} <, {predict_Statement-2}, ...>}
lists the expressions that need to be predicted after the model is fitted.
The predict_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for an individual prediction.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for an individual prediction.
* expression="string"
specifies the expression to be predicted.
* label="string"
specifies the label for predicted expression.
lower="string"
names the lower bound of a confidence interval for an individual prediction.
pred="string"
names the predicted value for an individual prediction.
probt="string"
names the p-value for an individual prediction.
stderr="string"
names the standard error for an individual prediction.
tvalue="string"
names the t value for an individual prediction.
upper="string"
names the upper bound of a confidence interval for an individual prediction.
predOut={casouttable}
specifies the output data table.
For more information about specifying the predOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).
restrict={"string-1" <, "string-2", ...>}
specifies the linear restriction for the model.
* table={castable}
specifies the input data table.
For more information about specifying the table parameter, see the common castable parameter (Appendix A: Common Parameters).
tolerenceOpts={toln_options}
specifies tolerance-related options.
singular=double
specifies the general singularity criterion.
| Range | 0–1 |
|---|
nlmod Action
Fits nonlinear regression models using either nonlinear least squares or maximum likelihood.
Lua Syntax
Summary: Input and Output Tables
If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
— |
specifies the data table that provides parameter starting values. | |
|
required parametertable |
— |
specifies the input data table. |
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
names |
lists the names of results tables to save as CAS tables on the server. | |
|
— |
specifies the output data table. |
Parameter Descriptions
attributes={{casinvardesc-1} <, {casinvardesc-2}, ...>}
changes the attributes of variables used in this action. Currently, attributes specified on the inputs and nominals parameter are ignored.
For more information about specifying the attributes parameter, see the common casinvardesc parameter (Appendix A: Common Parameters).
| Alias | attribute |
|---|
bounds={{bounds_Statement-1} <, {bounds_Statement-2}, ...>}
lists the bounds for the parameters in the model.
The bounds_Statement value can be one or more of the following:
lb=double
specifies an exclusive lower bound value for the named parameter (that is, the parameter must be greater than this value).
leb=double
specifies an inclusive lower bound value with an equality sign for the named parameter (that is, the parameter is greater than or equal to this value).
* name="string" | {"string-1" <, "string-2", ...>}
specifies the name of the parameter that needs to be restricted by a bound.
ub=double
specifies an exclusive upper bound value for the named parameter (that is, the parameter must be less than this value).
ueb=double
specifies an inclusive upper bound value with an equality sign for the named parameter (that is, the parameter is less than or equal to this value).
display={displayTables}
specifies a list of results tables to send to the client for display.
For more information about specifying the display parameter, see the common displayTables parameter (Appendix A: Common Parameters).
estimate={{estimate_Statement-1} <, {estimate_Statement-2}, ...>}
lists the additional expressions that need to be estimated after the model is fitted.
The estimate_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional estimates.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for additional estimates.
* expression="string"
specifies the expression to be estimated.
* label="string"
specifies the label for the estimated expression.
id={"variable-name-1" <, "variable-name-2", ...>}
lists the variables that need to be stored in an output data table.
model={model_Statement}
specifies the dependent variable, its distribution, and its distribution parameters.
The model_Statement value can be one or more of the following:
* depvar="string"
specifies the dependent variable.
* distparms={"string-1" <, "string-2", ...>}
specifies the dependent variable distribution parameters.
* distribution="BERNOULLI" | "BINOMIAL" | "GAM" | "GAUSS" | "GENERAL" | "LS" | "NB" | "POISSON" | "T"
specifies the type of distribution for the dependent variable.
nlmodCode="string"
specifies the nonlinear programming statements in a quoted string.
nlmodOptions={nlmod_options}
lists options that uses in NLMOD action.
The nlmod_options value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional parameter estimates.
| Default | 0.05 |
|---|---|
| Range | 0–1 |
corr=true | false
when set to True, displays the approximate correlation matrix for the parameter estimates.
| Default | false |
|---|
cov=true | false
when set to True, displays the approximate covariance matrix for the parameter estimates.
| Default | false |
|---|
df=double
specifies the degrees of freedom to use in calculating p-values for additional parameter estimates.
| Minimum value | 0 |
|---|
eCorr=true | false
when set to True, displays the approximate correlation matrix for all expressions that are specified in the estimate parameter.
| Default | false |
|---|
eCov=true | false
when set to True, displays the approximate covariance matrix for all expressions that are specified in the estimate parameter.
| Default | false |
|---|
noItPrint=true | false
when set to True, suppresses the display of the Iteration History table.
| Default | false |
|---|
noPrint=true | false
when set to True, suppresses output
| Default | false |
|---|
optimizeOpts={opti_options}
specifies optimization-related options.
The opti_options value can be one or more of the following:
absconv=double
specifies the absolute function convergence criterion.
| Alias | abstol |
|---|
absfconv=double
specifies the absolute difference function convergence criterion.
| Alias | absftol |
|---|---|
| Minimum value | 0 |
absfconvN=64-bit-integer
specifies the number of additional iterations for which the absolute difference function convergence criterion must be satisfied before the process terminates.
| Alias | absftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
absgconv=double
specifies the absolute gradient convergence criterion.
| Alias | absgtol |
|---|---|
| Minimum value | 0 |
absgconvN=64-bit-integer
specifies the number of additional iterations for which the absolute gradient convergence criterion must be satisfied before the process terminates.
| Alias | absgtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
fconv=double
specifies the relative function convergence criterion.
| Alias | ftol |
|---|---|
| Minimum value | 0 |
fconvN=64-bit-integer
specifies the number of additional iterations for which the difference function convergence criterion must be satisfied before the process terminates.
| Alias | ftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
gconv=double
specifies the relative gradient convergence criterion.
| Alias | gtol |
|---|---|
| Minimum value | 0 |
gconvN=64-bit-integer
specifies the number of additional iterations for which the gradient convergence criterion must be satisfied before the process terminates.
| Alias | gtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
maxfunc=64-bit-integer
specifies the maximum number of function evaluations in any optimization.
| Alias | maxfu |
|---|---|
| Minimum value | 0 |
maxiter=64-bit-integer
specifies the maximum number of iterations in any optimization.
| Alias | maxit |
|---|---|
| Minimum value | 1 |
maxtime=double
specifies the upper limit (in seconds) of CPU time for any optimization.
| Minimum value | 0 |
|---|
miniter=64-bit-integer
specifies the minimum number of iterations in any optimization.
| Default | -1 |
|---|---|
| Minimum value | 0 |
technique="CG" | "DBLDOG" | "DQN" | "LEVMAR" | "NEWRAP" | "NMS" | "NONE" | "NRR" | "QN" | "TR"
specifies the optimization technique.
outputTables={outputTables}
lists the names of results tables to save as CAS tables on the server.
For more information about specifying the outputTables parameter, see the common outputTables parameter (Appendix A: Common Parameters).
| Alias | displayOut |
|---|
parameters={{parms_Statement-1} <, {parms_Statement-2}, ...>}
lists the parameters of the model and their initial values.
| Alias | parms |
|---|
The parms_Statement value can be one or more of the following:
* name="string" | {"string-1" <, "string-2", ...>}
specifies the parameter name.
vals=double | {double-1 <, double-2, ...>} | {parmvalftb}
specifies the initial values for the parameter.
The parmvalftb value can be one or more of the following:
by=double
specifies the BY value in a FROM BY TO format of an initial values specification.
| Default | 1 |
|---|
* from=double
specifies the FROM value in a FROM BY TO format of an initial values specification.
* to=double
specifies the TO value in a FROM BY TO format of an initial values specification.
parmData={castable}
specifies the data table that provides parameter starting values.
For more information about specifying the parmData parameter, see the common castable parameter (Appendix A: Common Parameters).
parmOptions={parm_options}
specifies the options for the initial parameter specifications.
The parm_options value can be one or more of the following:
best=64-bit-integer
specifies the maximum number of initial values to display.
| Minimum value | 1 |
|---|
start=double
specifies a default initial value for all the parameters in the model.
| Alias | defstart |
|---|
predict={{predict_Statement-1} <, {predict_Statement-2}, ...>}
lists the expressions that need to be predicted after the model is fitted.
The predict_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for an individual prediction.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for an individual prediction.
* expression="string"
specifies the expression to be predicted.
* label="string"
specifies the label for predicted expression.
lower="string"
names the lower bound of a confidence interval for an individual prediction.
pred="string"
names the predicted value for an individual prediction.
probt="string"
names the p-value for an individual prediction.
stderr="string"
names the standard error for an individual prediction.
tvalue="string"
names the t value for an individual prediction.
upper="string"
names the upper bound of a confidence interval for an individual prediction.
predOut={casouttable}
specifies the output data table.
For more information about specifying the predOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).
restrict={"string-1" <, "string-2", ...>}
specifies the linear restriction for the model.
* table={castable}
specifies the input data table.
For more information about specifying the table parameter, see the common castable parameter (Appendix A: Common Parameters).
tolerenceOpts={toln_options}
specifies tolerance-related options.
singular=double
specifies the general singularity criterion.
| Range | 0–1 |
|---|
nlmod Action
Fits nonlinear regression models using either nonlinear least squares or maximum likelihood.
Python Syntax
Summary: Input and Output Tables
If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
— |
specifies the data table that provides parameter starting values. | |
|
required parametertable |
— |
specifies the input data table. |
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
names |
lists the names of results tables to save as CAS tables on the server. | |
|
— |
specifies the output data table. |
Parameter Descriptions
attributes=[{casinvardesc-1} <, {casinvardesc-2}, ...>]
changes the attributes of variables used in this action. Currently, attributes specified on the inputs and nominals parameter are ignored.
For more information about specifying the attributes parameter, see the common casinvardesc parameter (Appendix A: Common Parameters).
| Alias | attribute |
|---|
bounds=[{bounds_Statement-1} <, {bounds_Statement-2}, ...>]
lists the bounds for the parameters in the model.
The bounds_Statement value can be one or more of the following:
"lb":double
specifies an exclusive lower bound value for the named parameter (that is, the parameter must be greater than this value).
"leb":double
specifies an inclusive lower bound value with an equality sign for the named parameter (that is, the parameter is greater than or equal to this value).
* "name":"string" | ["string-1" <, "string-2", ...>]
specifies the name of the parameter that needs to be restricted by a bound.
"ub":double
specifies an exclusive upper bound value for the named parameter (that is, the parameter must be less than this value).
"ueb":double
specifies an inclusive upper bound value with an equality sign for the named parameter (that is, the parameter is less than or equal to this value).
display={displayTables}
specifies a list of results tables to send to the client for display.
For more information about specifying the display parameter, see the common displayTables parameter (Appendix A: Common Parameters).
estimate=[{estimate_Statement-1} <, {estimate_Statement-2}, ...>]
lists the additional expressions that need to be estimated after the model is fitted.
The estimate_Statement value can be one or more of the following:
"alpha":double
specifies the alpha value to use in constructing confidence intervals for additional estimates.
| Range | 0–1 |
|---|
"df":double
specifies the degrees of freedom to use in finding p-values for additional estimates.
* "expression":"string"
specifies the expression to be estimated.
* "label":"string"
specifies the label for the estimated expression.
id=["variable-name-1" <, "variable-name-2", ...>]
lists the variables that need to be stored in an output data table.
model={model_Statement}
specifies the dependent variable, its distribution, and its distribution parameters.
The model_Statement value can be one or more of the following:
* "depvar":"string"
specifies the dependent variable.
* "distparms":["string-1" <, "string-2", ...>]
specifies the dependent variable distribution parameters.
* "distribution":"BERNOULLI" | "BINOMIAL" | "GAM" | "GAUSS" | "GENERAL" | "LS" | "NB" | "POISSON" | "T"
specifies the type of distribution for the dependent variable.
nlmodCode="string"
specifies the nonlinear programming statements in a quoted string.
nlmodOptions={nlmod_options}
lists options that uses in NLMOD action.
The nlmod_options value can be one or more of the following:
"alpha":double
specifies the alpha value to use in constructing confidence intervals for additional parameter estimates.
| Default | 0.05 |
|---|---|
| Range | 0–1 |
"corr":True | False
when set to True, displays the approximate correlation matrix for the parameter estimates.
| Default | False |
|---|
"cov":True | False
when set to True, displays the approximate covariance matrix for the parameter estimates.
| Default | False |
|---|
"df":double
specifies the degrees of freedom to use in calculating p-values for additional parameter estimates.
| Minimum value | 0 |
|---|
"eCorr":True | False
when set to True, displays the approximate correlation matrix for all expressions that are specified in the estimate parameter.
| Default | False |
|---|
"eCov":True | False
when set to True, displays the approximate covariance matrix for all expressions that are specified in the estimate parameter.
| Default | False |
|---|
"noItPrint":True | False
when set to True, suppresses the display of the Iteration History table.
| Default | False |
|---|
"noPrint":True | False
when set to True, suppresses output
| Default | False |
|---|
optimizeOpts={opti_options}
specifies optimization-related options.
The opti_options value can be one or more of the following:
"absconv":double
specifies the absolute function convergence criterion.
| Alias | abstol |
|---|
"absfconv":double
specifies the absolute difference function convergence criterion.
| Alias | absftol |
|---|---|
| Minimum value | 0 |
"absfconvN":64-bit-integer
specifies the number of additional iterations for which the absolute difference function convergence criterion must be satisfied before the process terminates.
| Alias | absftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
"absgconv":double
specifies the absolute gradient convergence criterion.
| Alias | absgtol |
|---|---|
| Minimum value | 0 |
"absgconvN":64-bit-integer
specifies the number of additional iterations for which the absolute gradient convergence criterion must be satisfied before the process terminates.
| Alias | absgtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
"fconv":double
specifies the relative function convergence criterion.
| Alias | ftol |
|---|---|
| Minimum value | 0 |
"fconvN":64-bit-integer
specifies the number of additional iterations for which the difference function convergence criterion must be satisfied before the process terminates.
| Alias | ftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
"gconv":double
specifies the relative gradient convergence criterion.
| Alias | gtol |
|---|---|
| Minimum value | 0 |
"gconvN":64-bit-integer
specifies the number of additional iterations for which the gradient convergence criterion must be satisfied before the process terminates.
| Alias | gtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
"maxfunc":64-bit-integer
specifies the maximum number of function evaluations in any optimization.
| Alias | maxfu |
|---|---|
| Minimum value | 0 |
"maxiter":64-bit-integer
specifies the maximum number of iterations in any optimization.
| Alias | maxit |
|---|---|
| Minimum value | 1 |
"maxtime":double
specifies the upper limit (in seconds) of CPU time for any optimization.
| Minimum value | 0 |
|---|
"miniter":64-bit-integer
specifies the minimum number of iterations in any optimization.
| Default | -1 |
|---|---|
| Minimum value | 0 |
"technique":"CG" | "DBLDOG" | "DQN" | "LEVMAR" | "NEWRAP" | "NMS" | "NONE" | "NRR" | "QN" | "TR"
specifies the optimization technique.
outputTables={outputTables}
lists the names of results tables to save as CAS tables on the server.
For more information about specifying the outputTables parameter, see the common outputTables parameter (Appendix A: Common Parameters).
| Alias | displayOut |
|---|
parameters=[{parms_Statement-1} <, {parms_Statement-2}, ...>]
lists the parameters of the model and their initial values.
| Alias | parms |
|---|
The parms_Statement value can be one or more of the following:
* "name":"string" | ["string-1" <, "string-2", ...>]
specifies the parameter name.
"vals":double | [double-1 <, double-2, ...>] | {parmvalftb}
specifies the initial values for the parameter.
The parmvalftb value can be one or more of the following:
"by":double
specifies the BY value in a FROM BY TO format of an initial values specification.
| Default | 1 |
|---|
* "from_":double
specifies the FROM value in a FROM BY TO format of an initial values specification.
* "to":double
specifies the TO value in a FROM BY TO format of an initial values specification.
parmData={castable}
specifies the data table that provides parameter starting values.
For more information about specifying the parmData parameter, see the common castable parameter (Appendix A: Common Parameters).
parmOptions={parm_options}
specifies the options for the initial parameter specifications.
The parm_options value can be one or more of the following:
"best":64-bit-integer
specifies the maximum number of initial values to display.
| Minimum value | 1 |
|---|
"start":double
specifies a default initial value for all the parameters in the model.
| Alias | defstart |
|---|
predict=[{predict_Statement-1} <, {predict_Statement-2}, ...>]
lists the expressions that need to be predicted after the model is fitted.
The predict_Statement value can be one or more of the following:
"alpha":double
specifies the alpha value to use in constructing confidence intervals for an individual prediction.
| Range | 0–1 |
|---|
"df":double
specifies the degrees of freedom to use in finding p-values for an individual prediction.
* "expression":"string"
specifies the expression to be predicted.
* "label":"string"
specifies the label for predicted expression.
"lower":"string"
names the lower bound of a confidence interval for an individual prediction.
"pred":"string"
names the predicted value for an individual prediction.
"probt":"string"
names the p-value for an individual prediction.
"stderr":"string"
names the standard error for an individual prediction.
"tvalue":"string"
names the t value for an individual prediction.
"upper":"string"
names the upper bound of a confidence interval for an individual prediction.
predOut={casouttable}
specifies the output data table.
For more information about specifying the predOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).
restrict=["string-1" <, "string-2", ...>]
specifies the linear restriction for the model.
* table={castable}
specifies the input data table.
For more information about specifying the table parameter, see the common castable parameter (Appendix A: Common Parameters).
tolerenceOpts={toln_options}
specifies tolerance-related options.
"singular":double
specifies the general singularity criterion.
| Range | 0–1 |
|---|
nlmod Action
Fits nonlinear regression models using either nonlinear least squares or maximum likelihood.
R Syntax
Summary: Input and Output Tables
If a row includes a subparameter, you can specify the name, caslib, and so on in the subparameter. Otherwise, you can specify the name, caslib, and so on in the parameter.
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
— |
specifies the data table that provides parameter starting values. | |
|
required parametertable |
— |
specifies the input data table. |
|
Parameter |
Subparameter |
Description |
|---|---|---|
|
names |
lists the names of results tables to save as CAS tables on the server. | |
|
— |
specifies the output data table. |
Parameter Descriptions
attributes=list( list(casinvardesc-1) <, list(casinvardesc-2), ...>)
changes the attributes of variables used in this action. Currently, attributes specified on the inputs and nominals parameter are ignored.
For more information about specifying the attributes parameter, see the common casinvardesc parameter (Appendix A: Common Parameters).
| Alias | attribute |
|---|
bounds=list( list(bounds_Statement-1) <, list(bounds_Statement-2), ...>)
lists the bounds for the parameters in the model.
The bounds_Statement value can be one or more of the following:
lb=double
specifies an exclusive lower bound value for the named parameter (that is, the parameter must be greater than this value).
leb=double
specifies an inclusive lower bound value with an equality sign for the named parameter (that is, the parameter is greater than or equal to this value).
* name="string" | list("string-1" <, "string-2", ...>)
specifies the name of the parameter that needs to be restricted by a bound.
ub=double
specifies an exclusive upper bound value for the named parameter (that is, the parameter must be less than this value).
ueb=double
specifies an inclusive upper bound value with an equality sign for the named parameter (that is, the parameter is less than or equal to this value).
display=list(displayTables)
specifies a list of results tables to send to the client for display.
For more information about specifying the display parameter, see the common displayTables parameter (Appendix A: Common Parameters).
estimate=list( list(estimate_Statement-1) <, list(estimate_Statement-2), ...>)
lists the additional expressions that need to be estimated after the model is fitted.
The estimate_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional estimates.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for additional estimates.
* expression="string"
specifies the expression to be estimated.
* label="string"
specifies the label for the estimated expression.
id=list("variable-name-1" <, "variable-name-2", ...>)
lists the variables that need to be stored in an output data table.
model=list(model_Statement)
specifies the dependent variable, its distribution, and its distribution parameters.
The model_Statement value can be one or more of the following:
* depvar="string"
specifies the dependent variable.
* distparms=list("string-1" <, "string-2", ...>)
specifies the dependent variable distribution parameters.
* distribution="BERNOULLI" | "BINOMIAL" | "GAM" | "GAUSS" | "GENERAL" | "LS" | "NB" | "POISSON" | "T"
specifies the type of distribution for the dependent variable.
nlmodCode="string"
specifies the nonlinear programming statements in a quoted string.
nlmodOptions=list(nlmod_options)
lists options that uses in NLMOD action.
The nlmod_options value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for additional parameter estimates.
| Default | 0.05 |
|---|---|
| Range | 0–1 |
corr=TRUE | FALSE
when set to True, displays the approximate correlation matrix for the parameter estimates.
| Default | FALSE |
|---|
cov=TRUE | FALSE
when set to True, displays the approximate covariance matrix for the parameter estimates.
| Default | FALSE |
|---|
df=double
specifies the degrees of freedom to use in calculating p-values for additional parameter estimates.
| Minimum value | 0 |
|---|
eCorr=TRUE | FALSE
when set to True, displays the approximate correlation matrix for all expressions that are specified in the estimate parameter.
| Default | FALSE |
|---|
eCov=TRUE | FALSE
when set to True, displays the approximate covariance matrix for all expressions that are specified in the estimate parameter.
| Default | FALSE |
|---|
noItPrint=TRUE | FALSE
when set to True, suppresses the display of the Iteration History table.
| Default | FALSE |
|---|
noPrint=TRUE | FALSE
when set to True, suppresses output
| Default | FALSE |
|---|
optimizeOpts=list(opti_options)
specifies optimization-related options.
The opti_options value can be one or more of the following:
absconv=double
specifies the absolute function convergence criterion.
| Alias | abstol |
|---|
absfconv=double
specifies the absolute difference function convergence criterion.
| Alias | absftol |
|---|---|
| Minimum value | 0 |
absfconvN=64-bit-integer
specifies the number of additional iterations for which the absolute difference function convergence criterion must be satisfied before the process terminates.
| Alias | absftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
absgconv=double
specifies the absolute gradient convergence criterion.
| Alias | absgtol |
|---|---|
| Minimum value | 0 |
absgconvN=64-bit-integer
specifies the number of additional iterations for which the absolute gradient convergence criterion must be satisfied before the process terminates.
| Alias | absgtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
fconv=double
specifies the relative function convergence criterion.
| Alias | ftol |
|---|---|
| Minimum value | 0 |
fconvN=64-bit-integer
specifies the number of additional iterations for which the difference function convergence criterion must be satisfied before the process terminates.
| Alias | ftolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
gconv=double
specifies the relative gradient convergence criterion.
| Alias | gtol |
|---|---|
| Minimum value | 0 |
gconvN=64-bit-integer
specifies the number of additional iterations for which the gradient convergence criterion must be satisfied before the process terminates.
| Alias | gtolN |
|---|---|
| Default | 0 |
| Minimum value | 0 |
maxfunc=64-bit-integer
specifies the maximum number of function evaluations in any optimization.
| Alias | maxfu |
|---|---|
| Minimum value | 0 |
maxiter=64-bit-integer
specifies the maximum number of iterations in any optimization.
| Alias | maxit |
|---|---|
| Minimum value | 1 |
maxtime=double
specifies the upper limit (in seconds) of CPU time for any optimization.
| Minimum value | 0 |
|---|
miniter=64-bit-integer
specifies the minimum number of iterations in any optimization.
| Default | -1 |
|---|---|
| Minimum value | 0 |
technique="CG" | "DBLDOG" | "DQN" | "LEVMAR" | "NEWRAP" | "NMS" | "NONE" | "NRR" | "QN" | "TR"
specifies the optimization technique.
outputTables=list(outputTables)
lists the names of results tables to save as CAS tables on the server.
For more information about specifying the outputTables parameter, see the common outputTables parameter (Appendix A: Common Parameters).
| Alias | displayOut |
|---|
parameters=list( list(parms_Statement-1) <, list(parms_Statement-2), ...>)
lists the parameters of the model and their initial values.
| Alias | parms |
|---|
The parms_Statement value can be one or more of the following:
* name="string" | list("string-1" <, "string-2", ...>)
specifies the parameter name.
vals=double | list(double-1 <, double-2, ...>) | {parmvalftb}
specifies the initial values for the parameter.
The parmvalftb value can be one or more of the following:
by=double
specifies the BY value in a FROM BY TO format of an initial values specification.
| Default | 1 |
|---|
* from=double
specifies the FROM value in a FROM BY TO format of an initial values specification.
* to=double
specifies the TO value in a FROM BY TO format of an initial values specification.
parmData=list(castable)
specifies the data table that provides parameter starting values.
For more information about specifying the parmData parameter, see the common castable parameter (Appendix A: Common Parameters).
parmOptions=list(parm_options)
specifies the options for the initial parameter specifications.
The parm_options value can be one or more of the following:
best=64-bit-integer
specifies the maximum number of initial values to display.
| Minimum value | 1 |
|---|
start=double
specifies a default initial value for all the parameters in the model.
| Alias | defstart |
|---|
predict=list( list(predict_Statement-1) <, list(predict_Statement-2), ...>)
lists the expressions that need to be predicted after the model is fitted.
The predict_Statement value can be one or more of the following:
alpha=double
specifies the alpha value to use in constructing confidence intervals for an individual prediction.
| Range | 0–1 |
|---|
df=double
specifies the degrees of freedom to use in finding p-values for an individual prediction.
* expression="string"
specifies the expression to be predicted.
* label="string"
specifies the label for predicted expression.
lower="string"
names the lower bound of a confidence interval for an individual prediction.
pred="string"
names the predicted value for an individual prediction.
probt="string"
names the p-value for an individual prediction.
stderr="string"
names the standard error for an individual prediction.
tvalue="string"
names the t value for an individual prediction.
upper="string"
names the upper bound of a confidence interval for an individual prediction.
predOut=list(casouttable)
specifies the output data table.
For more information about specifying the predOut parameter, see the common casouttable parameter (Appendix A: Common Parameters).
restrict=list("string-1" <, "string-2", ...>)
specifies the linear restriction for the model.
* table=list(castable)
specifies the input data table.
For more information about specifying the table parameter, see the common castable parameter (Appendix A: Common Parameters).
tolerenceOpts=list(toln_options)
specifies tolerance-related options.
singular=double
specifies the general singularity criterion.
| Range | 0–1 |
|---|