whatIf? Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== How to Load a Model from Documenter into SAMM ======

===== Prepare for loading from inside Documenter =====
  -Ensure the calibrator and simulator diagrams are synchronized
  -Open the calibrator diagram & simulator diagrams in Documenter
  -In the simulator diagram, run one calculator forward
  -In the calibrator diagram, touch the informants and measures to trigger the model to output the informants
    -Go into any one informant under the informants tab and click OK
    -Go into any measure under the measures tab and click OK
    -Note: The calibrator versions of the informants and measures are the authority versions and the simulator ones may get out of sync
  -In the calibrator diagram, run all calculators forward
  -In the simulator diagram, run all calculators forward
  -In the simulator diagram, run all calculators backward
  -In the simulator diagram, create the loading files for SAMM 
    -Choose menu item SAMM > Loading files > Framework...
    -Click "simulator with calibrator" button
    -Make sure the "informants" check box is OFF!!
    -Click OK
  -In the calibrator diagram, create the loading files for SAMM
    -Choose menu item SAMM > Loading files > Framework...
    -Click "calibrator" button
    -Make sure the "informants" check box is ON!!
    -Click OK

===== Load model inside SAMM =====

  -Open SAMM and login under model account
  -Create a new model family 
    -Choose menu item MF Actions > Create OR right click in Model Families window and choose Create
    -"MB name" should be a string with no spaces or strange characters.  It is Often related to the ModelBase name in the root of the model but it does not have to be.
    -Fill in an English description.
    -Click OK
  -Enter the Model Family by double clicking on it.  A check mark appears in the Model Families window.
  -Setup the default file path
    -Choose menu item File > Set File Path...
    -This is a unix style path so use forward slashes and direct it to the location of the simulator files (e.g. /models/tcteem/V5/sim)
  -Load the simulator and calibrator frameworks
    -Choose menu item FW Actions > Load OR right click and select Load (note the location is what you set in step 4)
    -MB name: MUST be the model base name from the root of the simulation diagram, give it the description “sim”
    -Adjust your default file path to the cal location (e.g. /models/tcteem/V5/cal)
    -Repeat loading framework for cal BUT choose the check button to say it is a calibration framework, use the MB name from the calibration diagram, and enter "cal" as the description
  -Load informants
    -Choose menu item Windows > Informants
    -Right click and select Load (path should be correct because of 5c)
    -Adjust the file location if it is incorrect (should be something like /models/tcteem/V5/cal/informs.samm)

===== Run Calibration to Produce a History =====
This part of the process depends on your individual model.  By convention we keep a loading recipe in the notes for the root node in the diagram.  In Documentor right click on the root node and go to Properties, then choose the notes button.  Here's a template of how to run the recipe and produce a hisotry:
  -Load the views in the views window
    -Setup the default file path to the views directory (e.g. /models/tcteem/V5/cal/views)
    -Choose menu item View Actions > Load OR right click and select Load
  -Follow the recipe which will likely involve loading a source history, running some feedback views and saving scenarios as you go and the final one will be your tracking history.
  -Evaluate history ins for your tracking history - this prepares all the calibrator inputs and data needed for the simulator to be run over historic time
    -Right click on the tracking history scenario in the scenarios window and choose "Evaluate history inputs"
  -Evaluate history outputs for your tracking history - this runs the simulator frame work over historic time and produces the history scenario
    -Right click on the tracking history scenario in the scenarios window and choose "Evaluate history outputs"
    -Name your historic scenario, we usually just use the name "history" - this will show up in the simulation frame work
whatIf? Wiki

User Tools

Site Tools

Page Tools
