====== SAMM Concepts and Mechanics ======

This page introduces the concepts and mechanics required to navigate and use a model in the SAMM (Scenario and Model Management) software, a component of the [[http://www.whatiftechnologies.com/index.php/software-technology|whatIf? Modelling Environment]].

Instructional YouTube videos are embedded throughout the tutorial. The videos are also compiled in a single [[https://www.youtube.com/playlist?list=PLYoZnBNOPjYNREpRN5t0c9kzdiBa38Ddh|YouTube playlist]] (alternative [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AADHAY7EIMXMZFJh31ZEXqNTa?lst|Dropbox folder]]).

===== Connecting to a Server =====

  - From //All Programs | whatIf//, start //SAMM// (Scenario and Model Manager).
  - The Connect dialogue box will appear. Enter the Server, Port and account credentials  information as provided by your administrator and click //Connect//. The Connect dialogue is shown below - note that you may be required to use a different port number. {{ :trainingtutorial:serverconnect.png }}
  - If a connection is successfully established the Model Families window will appear, listing all items available to you.


===== Entering a Model and the SAMM Interface =====

{{youtube>aWICdFS8VZ8}}

Video 1.1 alternative links:[[https://www.dropbox.com/s/hmjnub9gbyf5df5/1.1%20Entering%20a%20Model%20and%20the%20SAMM%20Interface.wmv|streaming SD]]
[[https://www.dropbox.com/s/hmjnub9gbyf5df5/1.1%20Entering%20a%20Model%20and%20the%20SAMM%20Interface.wmv?dl=1|download HD]]
\\
  - Double click the model family you wish to enter. A check mark will appear beside it on the list.
  - Double click the framework you wish to enter (generally //sim//). A check mark will appear beside it on the list.
  - Double click the desired history (generally there will only be one). A check mark will appear beside it on the list.
  - The default layout of windows in SAMM is shown below. If your display does not appear as shown select //Windows | Default Positions// from the menu.
  - To switch on object long description, uncheck //Options | Show Modelbase Name//.

{{:trainingtutorial:samm_windows.png}}


===== Understanding Model Diagrams =====

==== Treeview and Diagram Objects ====
{{youtube>qFF_o69p0x8}}
Video 2.1 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACl1TJJwpzIUxdzffZkz8i3a/2.1%20Model%20Diagrams%20-%20Treeview%20and%20Diagram%20Objects.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACl1TJJwpzIUxdzffZkz8i3a/2.1%20Model%20Diagrams%20-%20Treeview%20and%20Diagram%20Objects.wmv?dl=1|download HD]]

\\

Elements of a calculator diagram include:
  * **Stock** Variables - These are variables containing counts of some item usually.  For example:

{{:trainingtutorial:stockvar.jpg|}}
  * **Flow** Variables - These are variables containing counts of something that happen per time period or other flow situations.  For example:

{{:trainingtutorial:flowvar.jpg|}}
  * **Parameter** Variables - These are all other variables, rates, shares, constants etc.  For example:

{{:trainingtutorial:paramvar.jpg|}}
  * **Procedure boxes** - These boxes contain all the TOOL code to do the math with the variables.  Double click on one to see the code.  For example:

{{:trainingtutorial:procedurebox.jpg|}}

==== Variable Shape: Dimensions and Units of Measure ====
{{youtube>4iBDI80KfBs}}
Video 2.2 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AAD5CpD8YxrFCexejTYAEyWha/2.2%20Model%20Diagrams%20-%20Dimensions%20Units%20of%20Measure.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AAD5CpD8YxrFCexejTYAEyWha/2.2%20Model%20Diagrams%20-%20Dimensions%20Units%20of%20Measure.wmv?dl=1|download HD]]

\\

==== Links and Connectivity ====
{{youtube>IRO5ZW0ZF-8}}
Video 2.3 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACauDgUoeyR4AvS6oPnppXGa/2.3%20Model%20Diagrams%20-%20Links%20and%20Connectivity.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACauDgUoeyR4AvS6oPnppXGa/2.3%20Model%20Diagrams%20-%20Links%20and%20Connectivity.wmv?dl=1|download HD]]

\\

  * **Links Internal to model but external to the current calculator** - references variables calculated in other calculators - Yellow box with solid border, for example:

{{:trainingtutorial:internallink.jpg|}}

  * **Links to shared inputs** to the model - references to variables that will be filled from sources external to the model and are referenced by multiple calculators.  For example:

{{:trainingtutorial:sharedinput.jpg|}}

  * **Links Internal to a calculator** - references variables that exist multiple times within the same calculator appear as above but with white boxes instead of yellow.  For example:

{{:trainingtutorial:sharedinputdottedwhite.png|}}

\\
===== Variables, Instances and Scenarios =====

{{youtube>CzQrmlquliU}}
Video 3.1 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AABJPqrlZtuwQrgG9PDRuJyqa/3.1%20variables%20instances%20scenarios.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AABJPqrlZtuwQrgG9PDRuJyqa/3.1%20variables%20instances%20scenarios.wmv?dl=1|download HD]]

\\

{{youtube>fJdDyGKg2P0}}
Video 3.2 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AABzoZfYNQf0dv4WlgqvHYesa/3.2%20variables%20instances%20scenarios.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AABzoZfYNQf0dv4WlgqvHYesa/3.2%20variables%20instances%20scenarios.wmv?dl=1|download HD]]

\\

An input (or control) variable can be assigned a specific value, or instance. Variables may have multiple instances. The concept of multiple variables each having multiple instances is shown here:

{{trainingtutorial:variables_instances.png?200}}

A scenario is a set of instances for all the input variables in a model framework, along with the associated values for the output variables. The concept of multiple scenarios and how they relate to variables and instances is shown here:

{{trainingtutorial:scenarios.png?200}}
 
===== Displaying and Exporting Data =====

{{youtube>4E_oztr3MXE}}
Video 4.1 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACnGd0Eg5NQUzPbpRY4Z5TJa/4.1%20Displaying%20and%20Exporting%20Data%20-%20Intro.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACnGd0Eg5NQUzPbpRY4Z5TJa/4.1%20Displaying%20and%20Exporting%20Data%20-%20Intro.wmv?dl=1|download HD]]

\\

{{youtube>rGtbvXWK-8w}}
Video 4.2 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACJVy938SS5MuHULCKsWPE_a/4.2%20Displaying%20and%20Exporting%20Data%20-%20Graph.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AACJVy938SS5MuHULCKsWPE_a/4.2%20Displaying%20and%20Exporting%20Data%20-%20Graph.wmv?dl=1|download HD]]

\\

{{youtube>v_uNL93I3vQ}}
Video 4.3 alternative links:[[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AAAQ1YSAn3PppHIRAX8XOGO-a/4.3%20Displaying%20and%20Exporting%20Data%20-%20Table.wmv|streaming SD]] [[https://www.dropbox.com/sh/44u3uepd5zj4mo1/AAAQ1YSAn3PppHIRAX8XOGO-a/4.3%20Displaying%20and%20Exporting%20Data%20-%20Table.wmv?dl=1|download HD]]

\\

==== Configuration Notes ====

To switch graph background from black to white:
  * In the //SAMM// application, go to //File | Preferences...//. Go to the //Graph// tab and uncheck //black background//.
  * In the //SAMM// application, go to //Edit | Edit Colours...// and press the //White Background// button (the displayed colours will change) and //OK//. 
===== Creating New Instances and Scenarios =====

{{youtube>6GFAO92N_dk}}
Video 5.1 alternative links:[[https://www.dropbox.com/s/wm4pmkf62dj0d4w/5.1%20Mixing%20and%20matching%20instances%20to%20create%20new%20scenarios.wmv|streaming SD]] [[https://www.dropbox.com/s/wm4pmkf62dj0d4w/5.1%20Mixing%20and%20matching%20instances%20to%20create%20new%20scenarios.wmv?dl=1|download HD]]

\\

{{youtube>cVij4wzCqFc}}
Video 5.2 alternative links:[[https://www.dropbox.com/s/du5rkqluhvdeim1/5.2%20Creating%20new%20instances%20with%20graph.wmv|streaming SD]] [[https://www.dropbox.com/s/du5rkqluhvdeim1/5.2%20Creating%20new%20instances%20with%20graph.wmv?dl=1|download HD]]

\\

{{youtube>7ZqoMW8uGvE}}
Video 5.3 alternative links:[[https://www.dropbox.com/s/mg9z0lseybxbv2h/5.3%20Creating%20new%20instances%20with%20table.wmv|streaming SD]] [[https://www.dropbox.com/s/mg9z0lseybxbv2h/5.3%20Creating%20new%20instances%20with%20table.wmv?dl=1|download HD]]

\\

{{youtube>2IX3SdxMqqY}}
Video 5.4 alternative links:[[https://www.dropbox.com/s/bmbg57of0zoaipg/5.4%20Creating%20new%20instances%20with%20Excel.wmv|streaming SD]] [[https://www.dropbox.com/s/bmbg57of0zoaipg/5.4%20Creating%20new%20instances%20with%20Excel.wmv?dl=1|download HD]]

\\
===== Views - Model Reports and Scripts =====

Content under development - come back soon!
===== Troubleshooting =====

Content under development - come back soon!