EVRIModel Objects: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Jeremy
imported>Jeremy
Line 11: Line 11:
==Working with Model Objects in Matlab==
==Working with Model Objects in Matlab==


EVRIModels are standard Matlab objects which are manipulated using the dot notation to access properties and methods. For example, to retrieve the "model type" (modeltype) property from a model, you give the object (a.k.a. variable) name followed by .modeltype. In the examples on this page, all examples will assume that the model is stored in a variable named "model".
EVRIModels are standard Matlab objects which are manipulated using the dot notation to access properties and methods. For example, to retrieve the "model type" (modeltype) property from a model, you give the object (a.k.a. variable) name followed by .modeltype. All examples here will assume that the model is stored in a variable named "model".


<pre>model.modeltype</pre>
<pre>model.modeltype</pre>
Line 25: Line 25:
<tt>  PCA Model Object (Desc. ON/<font color="#000099"><u>[off]</u></font>  Contents ON/<font color="#000099"><u>[off]
<tt>  PCA Model Object (Desc. ON/<font color="#000099"><u>[off]</u></font>  Contents ON/<font color="#000099"><u>[off]
</u></font>)</tt>
</u></font>)</tt>


==General Model Properties==
==General Model Properties==

Revision as of 16:07, 2 August 2012

Introduction

EVRIModel Objects provide access to the Standard Model Structure content of all models and provide some easy-to-use methods and properties for building, manipulating, and reviewing models from Matlab's command line, scripts, and functions. In addition, these properties and methods are available from Solo Scripting when using Solo_Predictor and Solo_Server. This page describes the various modes, methods, and properties of EVRIModel objects, here shortened to just "model objects".

Model objects have three distinct states:

  1. 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.
  2. 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.
  3. 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.

Working with Model Objects in Matlab

EVRIModels are standard Matlab objects which are manipulated using the dot notation to access properties and methods. For example, to retrieve the "model type" (modeltype) property from a model, you give the object (a.k.a. variable) name followed by .modeltype. All examples here will assume that the model is stored in a variable named "model".

model.modeltype

Displaying Contents

At the Matlab command line, you can view the contents of a model object by simply typing its name or by using the .disp method. When viewing content, there are several ways to view the model:

  1. By Description (Desc.) : this view shows you a text description of the type of model, how it was built, and a summary of its results.
  2. By Contents : this view contains the raw field information from the model. Users of previous versions of PLS_Toolbox will recognize this as the previous standard display.

At the Matlab command window, you can turn either one of these sections on or off by clicking the [on] or [off] hyperlinks in the top display line (shown in blue below)

PCA Model Object (Desc. ON/[off] Contents ON/[off] )

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

disp 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