EVRIModel Objects: Difference between revisions
imported>Jeremy |
imported>Jeremy |
||
Line 26: | Line 26: | ||
<tt>cancalibrate</tt> | <tt>cancalibrate</tt> | ||
| Returns (1) if the model contains a modeling building definition (see Empty Model description, below), or (0) if the model does not contain a definition and must be calibrated using the function defined in the modeltype property. | | Returns (1) if the model contains a modeling building definition (see Empty Model description, below), or (0) if the model does not contain a definition and must be calibrated using the function defined in the modeltype property. | ||
|- | |||
|valign="top" | | |||
<tt>property</tt> | |||
| Description | |||
|- | |||
|valign="top" | | |||
<tt>property</tt> | |||
| Description | |||
|} | |} | ||
content downgradeinfo evrimodelversion / modelversion | |||
modeltype validmodeltypes | help info modeltype validmodeltypes | ||
display settings uniqueid | isclassification plots display settings uniqueid | ||
| | ||
Revision as of 14:48, 1 August 2012
Introduction
EVRIModel Objects provide access to the Standard Model Structure content of all models as well as some easy-to-use methods and properties for building, manipulating, and reviewing models from Matlab's command-line, scripts, and functions. This page describes the various modes, methods, and properties of EVRIModel objects.
This documentation describes the use of EVRIModel objects, here shortened to just "model objects". Model objects have three distinct states:
- Empty Models - Empty models can be populated with data to analyze, "meta parameters" (model building settings), and other modeling options, then models can be calibrated or built from those settings.
- Calibrated Models - Calibrated models contain all the model results and parameters necessary to apply that model to new data. Plots and other information can be obtained from calibrated models.
- Applied Models - When a calibrated model is applied to new data, the result is a prediction or "applied model". This object contains all the results from applying the model to the new data. Plots and other information can be obtained from applied models.
General Model Properties
The following properties are always available in a model independent of the model state:
iscalibrated |
Returns (1) if the model has been calibrated or applied and (0) if the model is in the "empty" state and has not been calibrated. |
isprediction |
Returns (1) if the model contains a prediction from applying a calibrated model to new data and (0) if the model is just "calibrated" or "empty". |
cancalibrate |
Returns (1) if the model contains a modeling building definition (see Empty Model description, below), or (0) if the model does not contain a definition and must be calibrated using the function defined in the modeltype property. |
property |
Description |
property |
Description |
content downgradeinfo evrimodelversion / modelversion help info modeltype validmodeltypes isclassification plots display settings uniqueid
Building Model from Empty Model Object
When an EVRIModel object has been initially created, it contains no data and no results. Most model objects can then be populated with data, meta-parameters, and other settings (options) which can then be used to calibrate a model from.
- NOTE: Some model types do NOT support calibration in this manner. In these cases, the model will clearly show the state in its display at the command line with a statement to "See _____ function to calibrate." In these cases, the only way to create a calibrated model is to access the named function directly. A model can be interrogated with the .cancalibrate property to determine if it allows calibration directly or if it requires a call to modeltype function.
Working With Calibrated Models
Describe how to use them
Methods
blabla |
Start up the... |
Properties
General Properties | |
blalba |
blabla |
Alphabetical List of Object Properties and Methods
apply author calibrate cancalibrate content crossvalidate datasource date detail display downgradeinfo evrimodelversion help info iscalibrated isclassification isprediction loadings modeltype ncomp parent ploteigen plotloads plots plotscores prediction q scores settings t2 time uniqueid validmodeltypes x xhat y yhat