Analysis EVRIGUI Object

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.

Loading and Retrieving Data and Models

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

Models can be set (loaded) or retrieved using the following two methods:

.setModel(model)

.getModel

Similarly, predictions can be loaded or retrieved using these methods:

.setPrediction(prediction)

.getPrediction

The "drop" method is a simplified loading method. Any valid data, model or prediction 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 model
.clearXblock	Clears Calibration X-block
.clearXblockVal	Clears Validation X-block
.clearYblock	Clears Calibration Y-block
.clearYblockVal	Clears Validation Y-block

Generic GUI Methods

These methods provide simple access to simple GUI actions such as controlling the visibility of the GUI and closing or creating the GUI

.getVisibility	Returns 1 (one) if the GUI is currently visible (not hidden) and 0 (zero) otherwise
.setVisibility(vis)	When input is 1 (one), the GUI is made visible. When input is 0 (zero), the GUI is hidden from view and from the task bar (when relevent). Note that some methods may make a hidden GUI visible again even if this value has been set to zero.
.close	Forces the GUI to close
.create	Used to create a new Analysis GUI - NOTE: This method is called automatically by the main EVRIGUI object and should not be called directly by the user (an error will always be thrown in that situation)

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. Changes to the object are automatically acted on by the GUI (e.g. clearing of models and updating of plots when Data changes.) However, the use of Shared Data objects is for advanced users only and describing their use is beyond the scope of this document. See the Shared Data object documentation 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	Returns Shared Data object to Model
.getPredictionId	Returns Shared Data object to Predictions

Generic Object Access

The generic .getObject method returns the object specified using a keyword string from Analysis GUI. This is the actual DataSet, model, or other object itself (not the shared data object) Valid keywords are internal and may be subject to chage. As a result this function is not recommended for most uses. Instead, the user is directed to the general .get____ commands described earlier in this document. This method does, however, provide access to objects which may not be accessible through the other .get____ methods.

        .getObject('object_keyword')  -returns specified object from GUI 

        .apply            
        .calibrate        

        .setMethod        

        .getComponents    
        .setComponents    

        .getButtons       
        .pressButton      

        .getXPreprocessing
        .getYPreprocessing
        .setXPreprocessing
        .setYPreprocessing

        .getOptions       
        .setOptions       

        .validmethods