This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
trainingtutorial:documenter_tour [2009/12/01 15:02] shona.weldon created |
trainingtutorial:documenter_tour [2010/06/10 18:12] (current) deryn.crockett |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Documentor Tour ====== | + | ====== Documenter Tour ====== |
- | A brief description of the main windows in Documentor are given here. For more details please see the product documentation in the "Documentor Reference" section available from the first overview page. | + | A brief description of the main windows in Documenter are given here. For more details please see the product documentation in the "Documentor Reference" section available from the first overview page. |
===== Hierarchy Diagram and Left Hand Panel ===== | ===== Hierarchy Diagram and Left Hand Panel ===== | ||
- | Open Documentor and you will see the hierarchy view of the model something like the following image. | + | Open Documenter and you will see the hierarchy view of the model something like the following image. |
* The **hierarchy diagram** on the right includes a root node (grey circle with text: Tutorial 1) and calculator nodes (yellow boxes, for example: Population). The idea is to organize the model here in terms of the logical components and groupings. | * The **hierarchy diagram** on the right includes a root node (grey circle with text: Tutorial 1) and calculator nodes (yellow boxes, for example: Population). The idea is to organize the model here in terms of the logical components and groupings. | ||
* * Double click on any yellow calculator box to move to it's calculator diagram described in the next major section below. | * * Double click on any yellow calculator box to move to it's calculator diagram described in the next major section below. | ||
* On the left is a panel with several tabs at the bottom. | * On the left is a panel with several tabs at the bottom. | ||
- | * * The default one is "**Hierarchy**" and is a tree view of the diagram hierarchy diagram. | + | * * The default one is "**Hierarchy**" and is a tree view of the hierarchy diagram. |
* * The next tab is the "**Informants**" tab. It lists all the informants defined for the model and is where new informants can be added | * * The next tab is the "**Informants**" tab. It lists all the informants defined for the model and is where new informants can be added | ||
* * The next tab is the "**Measures**" tab. It lists all the entities and scientific units defined for the model and is where new measures can be added | * * The next tab is the "**Measures**" tab. It lists all the entities and scientific units defined for the model and is where new measures can be added | ||
* * The last tab is the "**Variables**" tab. It lists all the variables in the model and is a good way to find where a variable is used. Right click on it and choose "Calculators" to find which calculators use this variable. | * * The last tab is the "**Variables**" tab. It lists all the variables in the model and is a good way to find where a variable is used. Right click on it and choose "Calculators" to find which calculators use this variable. | ||
- | {{:documentorhierarcy.jpg|}} | + | {{:trainingtutorial:documentorhierarcy.jpg|}} |
===== Calculator Diagram ===== | ===== Calculator Diagram ===== | ||
Line 21: | Line 21: | ||
Double clicking on any yellow box in the Hierarchy Diagram opens the associated calculator diagram something like the following image. More details follow. | Double clicking on any yellow box in the Hierarchy Diagram opens the associated calculator diagram something like the following image. More details follow. | ||
- | {{:documentorcalcdiagram.jpg|}} | + | {{:trainingtutorial:documentorcalcdiagram.jpg|}} |
Elements of a calculator diagram include: | Elements of a calculator diagram include: | ||
* **Stock** Variables - These are variables containing counts of some item usually. For example: | * **Stock** Variables - These are variables containing counts of some item usually. For example: | ||
- | {{:stockvar.jpg|}} | + | {{:trainingtutorial:stockvar.jpg|}} |
* **Flow** Variables - These are variables containing counts of something that happen per time period or other flow situations. For example: | * **Flow** Variables - These are variables containing counts of something that happen per time period or other flow situations. For example: | ||
- | {{:flowvar.jpg|}} | + | {{:trainingtutorial:flowvar.jpg|}} |
* **Parameter** Variables - These are all other variables, rates, shares, constants etc. For example: | * **Parameter** Variables - These are all other variables, rates, shares, constants etc. For example: | ||
- | {{:paramvar.jpg|}} | + | {{: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: | * **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: | ||
- | {{:procedurebox.jpg|}} | + | {{:trainingtutorial:procedurebox.jpg|}} |
- | * **Links Internal to model** - references variables calculated in other calculators - Yellow box with solid boarder, for example: | + | * **Links Internal to model but external to the current calculator** - references variables calculated in other calculators - Yellow box with solid border, for example: |
- | {{:internallink.jpg|}} | + | {{: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: | * **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: | ||
- | {{:sharedinput.jpg|}} | + | {{: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 | * **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 | ||
Line 51: | Line 51: | ||
Double clicking on a procedure box within a calculator diagram will open the procedure editor dialogue. | Double clicking on a procedure box within a calculator diagram will open the procedure editor dialogue. | ||
- | {{trainingtutorial:procedureeditor.jpg}} | + | {{:trainingtutorial:procedureeditor.jpg}} |
==== Parts of the window ==== | ==== Parts of the window ==== | ||
Line 57: | Line 57: | ||
* **Description** - reflected out in the diagram inside the box | * **Description** - reflected out in the diagram inside the box | ||
* **Code Window** - is the large window on the right part of the page | * **Code Window** - is the large window on the right part of the page | ||
- | * * Tool names appear in green in this window | + | * Tool names appear in green in this window |
- | * * Keywords (e.g. local, if, endif) appear in blue. | + | * Keywords (e.g. local, if, endif) appear in blue. |
- | * * Comment lines beginning with "!" are red | + | * Comment lines beginning with "!" are red |
* **Left hand panels** - on opening the Procedure Editor dialogue, the variable information windows will be populated as follows: | * **Left hand panels** - on opening the Procedure Editor dialogue, the variable information windows will be populated as follows: | ||
- | * * Inputs Window - all input objects connected to this procedure\\ | + | * Inputs Window - all input objects connected to this procedure\\ |
- | * * Outputs Window - all output objects connected to this procedure\\ | + | * Outputs Window - all output objects connected to this procedure\\ |
- | * * Informants Window - the index and names of all informants used by all objects in the procedure\\ | + | * Informants Window - the index and names of all informants used by all objects in the procedure\\ |
- | * * Local Window - all objects declared as local objects in the existing code\\ | + | * Local Window - all objects declared as local objects in the existing code\\ |
- | * * TOOL Variables Window - all TOOL variables declared in the current code of this procedure\\ | + | * TOOL Variables Window - all TOOL variables declared in the current code of this procedure\\ |
==== Features: ==== | ==== Features: ==== | ||
Line 72: | Line 72: | ||
* Right click on an entry in the informants left hand panel brings up a popup menus and if you choose "Copy Elements" the elements of the informant are put in the clip buffer and can be pasted wherever. | * Right click on an entry in the informants left hand panel brings up a popup menus and if you choose "Copy Elements" the elements of the informant are put in the clip buffer and can be pasted wherever. | ||
+ | ==== Writing Code Info: ==== | ||
+ | For more details on writing code see: [[trainingtutorial:create_code|Create code]] |