Differences

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

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
lesson_21 [2019/08/27 16:39]
argemiro created
lesson_21 [2020/02/18 10:30]
argemiro
Line 1: Line 1:
-{{ :logo_guidebook1.jpg?400 |}}+{{ :logo_logo.png?400 |}}
 \\ \\
 =====LESSON 21: Dinamica EGO script language and console launcher=====  ​ =====LESSON 21: Dinamica EGO script language and console launcher=====  ​
Line 11: Line 11:
  
  
-As a model becomes more and more complex, you may find useful ​to save it in EGO format ​to keep developing ​ the model using [[:EGO Script|EGO programming language]] on a text editor, (e.g. [[http://​notepad-plus-plus.org/​|NotePad++]] or [[http://​www.contexteditor.org|Context]]). For example, the Amazon logging model [[http://​dx.doi.org/​10.1007/​s00267-009-9337-1|(Merry et al, 2009)]] developed in Dinamica EGO involves ​more than one thousand script lines. Both script formats ([[:XML Script|EGOML/​XML]],​ [[:EGO Script|EGO]]) are 100% compatible, so users can take back and forth a model from the graphical interface to the text editor without losing any information. Advanced modelers ​will greatly benefit from this well structured and tractable programming language. ​ +Alternatively, you may want to save the model in EGO format ​in [[:EGO Script|EGO programming language]]. You can open an edit EGO script language ​on a text editor, (e.g. [[http://​notepad-plus-plus.org/​|NotePad++]] or [[http://​www.contexteditor.org|Context]]). But still it is much easier to use the graphical interface. For example, the Amazon logging model [[http://​dx.doi.org/​10.1007/​s00267-009-9337-1|(Merry et al, 2009)]] developed in Dinamica EGO has more than one thousand script lines, even a skilled programmer would take longer writing the script than by using the graphical interface. Both script formats ([[:XML Script|EGOML/​XML]],​ [[:EGO Script|EGO]]) are 100% compatible, so users can take back and forth a model from the graphical interface to the text editor without losing any information. Advanced modelers ​may use this well structured and tractable programming language. ​
- +
-<note tip>​**TIP**:​ EGO format is also a good way to merge two models, since you can cut and paste parts of scripts.</​note>​+
  
 Open again the model “simulate_deforestation_from_1997_2000_30years_ahead.xml”. To make the model more intelligible on the text editor, you first need to name some key variables and then add comments to parts of the model. Let’s do this. Select the Edit Functor tool and click on the Categorical Map “23267_1997.ers”. Open again the model “simulate_deforestation_from_1997_2000_30years_ahead.xml”. To make the model more intelligible on the text editor, you first need to name some key variables and then add comments to parts of the model. Let’s do this. Select the Edit Functor tool and click on the Categorical Map “23267_1997.ers”.
Line 26: Line 24:
 {{ :​tutorial:​script_4.1.jpg |}} {{ :​tutorial:​script_4.1.jpg |}}
  
-Now that you have learned a bit about programming with EGO script language, another resource available in Dinamica EGO is the Console Launcher. Any model saved in Dinamica EGO, either EGOML/XML or EGO, can be run from the command prompt. Running the model from the command prompt increases model performance,​ as the model becomes free of the burden of the graphical interface+Now that you have learned a bit about programming with EGO script language, another resource available in Dinamica EGO is the Console Launcher. Any model saved in Dinamica EGO, either EGOML/XML or EGO, can be run from the command prompt. ​
  
-<note tip>​**TIP**: ​ Windows 32 bits only handles up to 3 gigabytes of memory for a single process. See the question [[:​faq#​performance|How much memory (RAM) is Dinamica EGO able to handle?]] in Dinamica EGO's FAQ for additional information about memory.</​note>​ +To facilitate running a model from the command prompt, we have developed a Console Launcher tool. Also, Console Launcher allows for queuing models and running them sequentiallyCall the Console Launcher from the tools subfolder in the Start/​Programs/​Dinamica EGO shortcut. It will open the following interface.
- +
-To facilitate running a model from the command prompt, we have developed a Console Launcher tool. Its use is strongly advised for complex models and others with large amount of data. Also, Console Launcher allows for queuing models and running them sequentially Call the Console Launcher from the tools subfolder in the Start/​Programs/​Dinamica EGO shortcut. It will open the following interface.+
  
 {{ :​tutorial:​script_9.jpg |}} {{ :​tutorial:​script_9.jpg |}}
Line 53: Line 49:
  
 <note tip>​**TIP**:​ another way to loosely couple other computer programs with Dinamica EGO is by means of functor [[:Run External Process]], available in the Control Tab.  By using this functor, you will be able to make a call to an external program from within Dinamica, pass to this program intermediate results and feed its output back again into the Dinamica EGO model. </​note> ​ <note tip>​**TIP**:​ another way to loosely couple other computer programs with Dinamica EGO is by means of functor [[:Run External Process]], available in the Control Tab.  By using this functor, you will be able to make a call to an external program from within Dinamica, pass to this program intermediate results and feed its output back again into the Dinamica EGO model. </​note> ​
 +\\
 +\\
 +===Congratulations,​ you have successfully completed this lesson!===
 +\\
 +☞[[python_coupling|Next Leesson]]
 +\\
 +☞[[:​guidebook_start| Back to Guidebook Start]]
 +