Modeloptimizergui

From Eigenvector Research Documentation Wiki
Revision as of 12:58, 28 June 2013 by imported>Scott
Jump to navigation Jump to search

Introduction

Optimizing modeling conditions and settings requires building and comparing multiple models. The Model Optimizer allows you to both automate building of models and visualize a comparison of models. See the modeloptimizer and comparemodels functions for more additional command line information.

The interface is based around the idea of a "Snapshot" of the Analysis model building interface. Each snapshot contains all the settings for building the model. Once a set of snapshots has been created, the Model Optimizer can assemble all combinations of the settings into a collection of models to calculate. This collection can then be run at a convenient time or saved and run on new data.

After all models have been calculated the results are displayed in a comparison table. By default the table shows only columns that differ between the models but it can be customized. Each column can be sorted to investigate results.


Unsupported Model Types

  • CLUSTER
  • PURITY
  • Batch Maturity

Model Optimizer Interface

Getting Started

Snapshots can be take from the Analysis toolbar or the Model Optimizer toolbar by clicking the snapshot button (camera icon). Each time a snapshot is taken the settings are added to the snapshot list as well as the model list. The combinations are updated after each snapshot. A Model Optimizer window will open if it's not already.

Once you've added the desired snapshots you can either calculate the list of models immediately or click the Add Combinations button to add all unique combinations of the model settings to the models list then calculate.

After the models are calculated the model comparison table will be updated showing the columns that differ between models. Sort the columns to find models with the desired value. For additional information on each model, expand it's leaf in the tree.

Taking Snapshots

A snapshot can be taken before or after a model is calculated.

  • If the snapshot is taken before calculation it will be added to both the Snapshot List and Model List but no results will be available until it's calculated. Any additional combinations resulting from the Snapshot will not be added to the Model List, you must add those by by clicking Add Combinations button.
  • If the snapshot is taken after calculation, the model will be added same as above but results will immediately display.

Model Optimizer Window

The main Optimizer Window has 4 sections:

  1. Model comparison table.
  2. Model list.
  3. Snapshot list.
  4. Combinations list.

GUI Window

Managing Snapshots and Models

Clicking the snapshot button adds it to the snapshot list, updates the combinations list, and adds the snapshot to the model list. A snapshot or model can be removed by clicking the Remove node in the list tree or by using the right-click menu.

The list right-click menu allows you to:

  • Collapse all leafs in the tree.
  • Run all models.
  • Add a single snapshot to the model list.
  • Add all snapshots to model list.
  • Clear a single snapshot or model from the list.
  • Clear all snapshots or models from the list.
  • Clear everything.

Expanding each node will "drill down" into the snapshot/model settings. Expand a node to get more information about the item.

Adding Models from Cache or Workspace

Models can be added to the Optimizer from the cache or workspace by dragging and dropping them onto the window. If a model is added from the workspace the associated data is not added.

A model can be added from the cache using the right-click menu "Compare" item.

Working with the Comparison Table

Once models have been added and calculated the Comparison Table will be updated. By default, only the columns with differing values will be displayed (columns with the same value for all models will be hidden). Investigate the results by sorting columns.

The display of columns and table behavior can be modified via the Edit menu Include/Exclude Columns and the Options editor. Excluded columns do not appear in the include list so remove excluded columns from the exclude list before attempting to include them.

Right-click on the column header to display a context menu for sorting. Clicking on a particular row will expand the models corresponding node in the model tree. Double clicking the row number will open the model in analysis.

Optimizer Table

Click the plot button to generate a plot of the table data.

Optimizer Plot

Saving an Optimizer Model

Optimizer models can be save from the File menu. These models are also "cached" in the model cache each time the Calculate button is pushed.

Applying New Data

New data can be applied to an Optimizer model by dragging and dropping new data onto a model in the Workspace Browser.

  • Locate the Model Optimizer model in the model cache and double-click it to load it into the workspace.
  • Load the data you want to apply.
  • Drag and drop new data onto your model.
  • Once the model is calculated you'll be prompted to save the model to the workspace.
  • Double-click the new model to open it in the Model Optimizer window.