This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
trainingtutorial:documenter_tour [2009/12/01 15:18] shona.weldon |
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 | ||
Line 37: | Line 37: | ||
{{:trainingtutorial:procedurebox.jpg|}} | {{:trainingtutorial:procedurebox.jpg|}} | ||
- | * **Links Internal to model but external to the current calculator** - 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: |
{{:trainingtutorial:internallink.jpg|}} | {{:trainingtutorial:internallink.jpg|}} | ||
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]] |