User Tools

Site Tools


model_page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
model_page [2023/03/10 12:05]
daria [Model Page]
model_page [2023/03/10 12:37] (current)
daria
Line 5: Line 5:
 As in Ecolego, the model is visualized using an interaction matrix. Components are displayed on the diagonal and their relations on the off-diagonal elements. Once you select an item in the interaction matrix, information about the selected item is displayed in the [[#information|text box]] to the right. As in Ecolego, the model is visualized using an interaction matrix. Components are displayed on the diagonal and their relations on the off-diagonal elements. Once you select an item in the interaction matrix, information about the selected item is displayed in the [[#information|text box]] to the right.
  
-ecolego_player_model_win.png+{{:ecolego_player_model_win.png?600}}  
 ===== Menu ===== ===== Menu =====
  
 The menu for the model page has buttons for display options and for managing the library. The menu for the model page has buttons for display options and for managing the library.
  
-|{{:New24.png}}          |Manage library...|Opens a window that lets you import components to your local library. See [[#setuplibrary|setting up the library]]                                        | +* **[[library|Manage library]]** - lets user specify folder which contains Ecolego projects (with sub-systems) and navigate the library hierarchy, create, rename or delete foldersIt also lets you import or export the library files *.eclOnce a module is selected, information about it will be displayed in the fields to the rightWith Manage library window user can change project or module information, change names, descriptions and images.
-|{{:AutoZoom24.png}}     |Auto-zoom        |When selected, the size of the interaction matrix will adjust to always fill the window. While this button is selected, the other zoom buttons are disabled.| +
-|{{:ZoomSelection24.png}}|Zoom selected    |Zoom the selected cells of the matrix. When no cells are selected, the whole matrix will be displayed.                                                      | +
-|{{:ZoomIn24.png}}       |Zoom In          |Increase the zoom factor.                                                                                                                                   | +
-|{{:ZoomOut24.png}}      |Zoom Out         |Decrease the zoom factor                                                                                                                                  | +
-|{{:Help24.png}}         |Help             |Displays this help page.                                                                                                                                    |+
  
-===== The interaction matrix =====+* ** Synchronize with library** - provides user with option to replace changed sub-systems in the model with the original model from Library. 
  
-The interaction matrix is used to visualize the model. Important model components are displayed in the diagonal of the matrix, and connections between the components are displayed in the off diagonal elements in a clockwise fashion. This means that a connection from A to B is displayed in the cell on the same row as A and in the same column as B.+* **Help Contents** -  contains link to this page
  
-Large models are often divided boxes called sub-systems. A sub-system component has a thicker border, and when you move the mouse cursor over it a small plus (+) sign is displayed. When you click on the plus sign, the sub-system is expanded so you can see the components therein.+===== Matrix view ===== 
 + 
 +The [[matrix_window|matrix view]] is used to visualize the model ase [[interaction_matrix|interaction matrix]]
  
 When you select items in the matrix, information about the selected items is displayed in the [[#information|information text box]]. When you select items in the matrix, information about the selected items is displayed in the [[#information|information text box]].
  
 +===== Graph view =====
  
-==== Inserting empty cells ==== +The [[graph_window|graph view]] is used to visualize the model as well as matrix viewModel is represented as [[box_diagram|box diagram]]
- +
-  - Select one or more diagonal cells in the matrix. To select more than one cell, first select the top-most cell. While keeping the SHIFT-key pressed on you keyboard, select the last cell. +
-  - Right-click the selected area and choose either **Insert above** or **Insert below**. +
- +
-==== Deleting cells ==== +
- +
-  - Select one or more cells in the matrix. +
-  - Either press the DELETE-key on your keyboard, or right-click the selected area and choose **Delete** +
- +
-==== Renaming objects ==== +
- +
-  - Double-click on the object, or right click and select **Edit** from the menu that appears. +
-  - A window appears which has two pages: +
-  - **Properties** - Let you give a new name to the object. +
-  - **Matrix** - Allows you to change the image, color and font for the object. +
- +
-==== Moving components ==== +
- +
-  - Select the component(s) you wish to move. +
-  - While keeping the mouse button pressed, move the mouse cursor to the new location. +
-  - When the mouse button is relesed the objects are moved. +
  
 +When you select items in the graph, information about the selected items is displayed in the [[#information|information text box]].
 ===== Information ===== ===== Information =====
  
Line 61: Line 39:
  
 A model component is a sub-system with defined potential inputs and/or outputs. An output for one component can be connected to inputs of other components. When an input is connected to another model component, you do not need to supply values for this input. A model component is a sub-system with defined potential inputs and/or outputs. An output for one component can be connected to inputs of other components. When an input is connected to another model component, you do not need to supply values for this input.
- 
-Consider the following example: 
- 
-The library contains a set of components for creating a model of a landscape. 
- 
-One component - //Soil// - can be used to model the turnover of contaminants in agricultural soil. 
- 
-Another component - //Plant// - models the uptake of contaminants in a plant. 
- 
-An assessor needs to investigate impact of release of contamination from a site on plants growing in the region. Thus, he starts by adding a //Plant// model to the interaction matrix. 
- 
-The //Plant// model has a time dependent input for the concentration of contaminants in the soil. The assessor, however, lacks measurements for the soil concentration - he only has measurements of the release rates from the site. 
- 
-Thus, he adds a //Soil// component. The //Soil// component has a time dependent output giving the concentration in soil as well as inputs for the contamination rate of the soil. This way the assessor can, by connecting this output to the corresponding input of //Plant//, model the concentration in soil and just enter the release rate. 
- 
- 
 ==== Setting up the library ==== ==== Setting up the library ====
  
Line 93: Line 55:
   - If you are asked to auto-connect inputs with outputs, read more [[#autoconnect|below]].   - If you are asked to auto-connect inputs with outputs, read more [[#autoconnect|below]].
  
-==== Connecting components ====+Consider the following example:
  
-A component can consist of many objects - parameters, time dependent lookup tables, expressions and compartments. The model creator can define some of these to be (potential) inputs, and some to be (potential) outputs. This means that if you lack the data for a specific input, you can use another component to calculate it for you.+The library contains a set of components for creating model of a landscape.
  
-To connect two components, where the first has defined outputs and the other has defined inputs:+One component - //Soil// - can be used to model the turnover of contaminants in agricultural soil.
  
-<HTML><ol></HTML> +Another component - //Plant// - models the uptake of contaminants in a plant.
-<HTML><li></HTML><HTML><p></HTML>Make sure that both components are “closed” or “collapsed”.<HTML></p></HTML><HTML></li></HTML> +
-<HTML><li></HTML><HTML><p></HTML>Right-click the matrix cell which is on the same row as the first component and in the same column as the second component.<HTML></p></HTML><HTML></li></HTML> +
-<HTML><li></HTML><HTML><p></HTML>From the menu, select “Connector”. An arrow pointing from the first component towards the second appears in the matrix.<HTML></p></HTML><HTML></li></HTML> +
-<HTML><li></HTML><HTML><p></HTML>Double-click the arrow.<HTML></p></HTML><HTML></li></HTML> +
-<HTML><li></HTML><HTML><p></HTML>The window that appears has three pages:<HTML></p></HTML> +
-<HTML><ol></HTML> +
-<HTML><li></HTML>**Properties** allows you to enter new name for the connection.<HTML></li></HTML> +
-<HTML><li></HTML>**Matrix** allows you to change the image, color and font for the connection.<HTML></li></HTML> +
-<HTML><li></HTML>**Values** lets you connect outputs of the first component with inputs of the second component.<HTML></li></HTML><HTML></ol></HTML>+
  
-<HTML><ul></HTML> +An assessor needs to investigate impact of release of contamination from a site on plants growing in the region. Thushe starts by adding a //Plant// model to the interaction matrix.
-<HTML><li></HTML>On the left hand side of the table, in the **From** columneach defined output of the first component is listed.<HTML></li></HTML> +
-<HTML><li></HTML>On the right hand side, in the **To** column, you select which input of the second component to connect the corresponding output to.<HTML></li></HTML><HTML></ul></HTML> +
-<HTML></li></HTML><HTML></ol></HTML>+
  
 +The //Plant// model has a time dependent input for the concentration of contaminants in the soil. The assessor, however, lacks measurements for the soil concentration - he only has measurements of the release rates from the site.
  
-==== Automatic connection ====+Thus, he adds a //Soil// component. The //Soil// component has a time dependent output giving the concentration in soil as well as inputs for the contamination rate of the soil. This way the assessor can, by connecting this output to the corresponding input of //Plant//, model the concentration in soil and just enter the release rate. 
 + 
 + 
 + 
 +==== Connecting components ==== 
 + 
 +A component can consist of many objects - parameters, time dependent lookup tables, expressions and compartments. The model creator can define some of these to be (potential) inputs, and some to be (potential) outputs. This means that if you lack the data for a specific input, you can use another component to calculate it for you. 
 +For connecting of components are used [[Connector|connectors]]. 
  
-If you add a new component to the matrix, and there are already components in the matrix, you might be asked if you want to automatically connect the inputs of the new component to outputs of existing components. This happens when: 
  
-  - There are outputs with the same name as the inputs in the new component. +===== Relationships =====
-  - The model creator has allowed automatic connection for the inputs/outputs.+
  
-Note that automatic connection will only connect the inputs/outputs where the above requirements are fulfilled - the remaining connections you must do yourself.+Shows [[relationships_window|relationship window]]. Is used for better understandig of model and interaction between model components
  
 ===== References ===== ===== References =====
model_page.1678446358.txt.gz · Last modified: 2023/03/10 12:05 by daria