Analysis EVRIGUI Object

From Eigenvector Research Documentation Wiki
Revision as of 14:50, 17 March 2009 by imported>Jeremy
Jump to navigation Jump to search

These are the methods defined for Analysis GUI when accessed through an EVRIGUI object. The following methods are called by referring to the given EVRIGUI object, followed by the method to be accessed. For example, given an EVRIGUI object in the workspace called "obj", the following call sets the Calibration X-block data to a given DataSet object called "data":

  obj.setXblock(data);

And this would retrieve the curently loaded Calibration X-block data:

  data = obj.getXblock;

The specific methods available are described in the sections below.

Data Assignment and Retrieval Methods

These methods can be used to retrieve the specified data as a DataSet object:

        .getXblock       -returns Calibration X-block
        .getXblockVal    -returns Validation X-block
        .getYblock       -returns Calibration Y-block
        .getYblockVal    -returns Validation Y-block

These methods can be used to set (i.e. "load") the specified data. Note that all take a single parameter as input and this parameter must be a DataSet object. If the object is not a valid DataSet object, an error will be thrown.

        .setXblock(dataset)       -sets the Calibration X-block
        .setXblockVal(dataset)    -sets the Validation X-block
        .setYblock(dataset)       -sets the Calibration Y-block
        .setYblockVal(dataset)    -sets the Validation Y-block

The "drop" method is a simplified data loading method. Any valid data or model can be "dropped" on a valid Analysis EVRIGUI object and the GUI will attempt to load the given data into the most logical location based on the GUI's current status. Since this may be ambiguious to the script or program accessing the EVRIGUI object where the data will be loaded, it is often recommended that an explict .set____ command (see above) be used in most cases.

        .drop(dataset)
        .drop(model)

Clearing of data, models, and predictions can be achieved using these methods. In all cases, if the given data or model is already cleared, no error occurrs.

        .clearAll         -clears all data, models, and predictions (return to initial startup state)
        .clearBothCal     -clears both X and Y Calibration Data
        .clearBothVal     -clears both X and Y Validation Data
        .clearModel       -clears current
        .clearXblock      
        .clearXblockVal   
        .clearYblock      
        .clearYblockVal   


Advanced Methods

Shared Data Object Access

Within Matlab, these methods can be used to access a Shared Data object which gives direct, dynamic access to the data and model being used in the GUI. This allows an advanced user to view and/or modify the used data directly. The use of Shared Data objects is for advanced users only and is beyond the scope of this document. See the Shared Data object for more information on using Shared Data:

        .getXblockId     -returns Shared Data object to Calibration X-block
        .getXblockValId  -returns Shared Data object to Validation X-block 
        .getYblockId     -returns Shared Data object to Calibration Y-block
        .getYblockValId  -returns Shared Data object to Validation Y-block 
        .getModelId       


        .apply            
        .calibrate        
        .close            
        .create           
        .getButtons       
        .getComponents    
        .getModel         
        .getObject        
        .getOptions       
        .getPrediction    
        .getPredictionId  
        .getVisibility    
        .getXPreprocessing
        .getYPreprocessing
        .pressButton      
        .setComponents    
        .setMethod        
        .setModel         
        .setOptions       
        .setPrediction    
        .setVisibility    
        .setXPreprocessing
        .setYPreprocessing
        .validmethods