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
lesson_5 [2020/02/11 17:26]
hermann [LESSON 5: Implementing simple map algebra on Dinamica EGO]
lesson_5 [2020/02/19 16:36] (current)
argemiro
Line 4: Line 4:
 ====LESSON 5: Implementing simple map algebra on Dinamica EGO==== ====LESSON 5: Implementing simple map algebra on Dinamica EGO====
 \\ \\
-In this lesson we would like to demonstrate how to use Dinamica EGO to convert the values of Belo Horizonte temperature map from Celsius into Fahrenheit scale.+In this lesson we demonstrate how to use Dinamica EGO to convert the values of Belo Horizonte temperature map from Celsius into the Fahrenheit scale.
 \\ \\
 \\ \\
-**Which Functors will you use in this lesson?** Load Map, Calculate Map and Save Map+**Which Functors will you use in this lesson?​** ​[[Load Map]][[Calculate Map]] and [[Save Map]]
 \\ \\
 \\ \\
-The Calculate Map functor is used for map algebra: to combine and process maps, tables and constants. Inside Calculate Map it is possible to write expressions that can include ​arithmetic, logical and conditional elements. ​+The [[Calculate Map]] functor is for map algebra: to combine and process maps, tables and constants. Inside ​[[Calculate Map]] it is possible to write expressions that including ​arithmetic, logical and conditional elements. ​
 \\ \\
 \\ \\
Line 16: Line 16:
 \\ \\
 \\ \\
-Click on the Input/output ​tab, grab and place on the sketch ​a Load Map and open the air_temperature.tif file used in the previous lesson. Next, click on the Map Algebra tab, grab and place on the sketch one Calculate Map and one Save Map functor. In the Save Map functor browse to ''​Guidebook_Dinamica_5\Models\Set_1\basics\1_load_save''​ and write the file name ''​temperature_fahrenheit.tif''​.+Click on the Input/Output ​tab, drag [[Load Map]] to the sketch ​and open the ''​air_temperature.tif'' ​file used in the previous lesson. Next, click on the Map Algebra tab, grab and place on the sketch one [[Calculate Map]] and one [[Save Map]] functor. In the [[Save Map]] functor browse to ''​Guidebook_Dinamica_5\Models\simple_map_algebra''​ and write the file name ''​temperature_fahrenheit.tif''​.
 \\ \\
 \\ \\
-Click on the hook tool to create a hook functor with Number Map inside the Calculate Map if there isn't one already. The container will resize to accommodate the Number Map. Double click on the Number Map and enter “1” (do not write the quotation marks) as the Map Number. This is a number identifier for a map and will be represented within the equation box as ''​i1''​ (input 1).+Select the [[Calculate Map]] and click on the hook tool on action bar to create a [[Number Map]] inside the [[Calculate Map]] if there isn't one already. The container will resize to accommodate the [[Number Map]]. Double click on the Number Map and enter “1” (do not write the quotation marks) as the Map Number. This is a number identifier for a map and will be represented within the equation box as ''​i1''​ (input 1).
 \\ \\
 \\ \\
Line 26: Line 26:
 \\ \\
 <note tip> <note tip>
-Each map processed by this container will be represented by the Number Map functor. You can enter other maps by adding more Number Map functors, each one having an unique number identifier.+Each map processed by this container will be represented by the [[Number Map]] functor. You can enter other maps by adding more [[Number Map]] functors, each one having an unique number identifier. This is a common usage pattern in Dinamica EGO models allowing an unlimited number of inputs to be used by a given container.
 </​note>​ </​note>​
 \\ \\
 \\ \\
-Now you can connect the functor Load Map to the Number Map. Use the connect tool (the lightning icon) to establish the connections. Note that the connection must be established between the Load Map functor and the Number Map inside of Calculate Map and not to Calculate Map itself.+Now you can connect the functor ​[[Load Map]] to the [[Number Map]]. Use the connect tool (the lightning icon) to establish the connections. Note that the connection must be established between the [[Load Map]] functor and the [[Number Map]] inside of [[Calculate Map]] and not to [[Calculate Map]] itself.
 \\ \\
 \\ \\
Line 36: Line 36:
 \\ \\
 \\ \\
-Open Calculate Map by double clicking on it. Note that map #1 is represented by ''​i1''​. The Calculate Map enables the formulation of various algebraic and logic equations containing maps, tables and constants.+Open [[Calculate Map]] by double clicking on it. Note that map #1 is represented by ''​i1''​. The [[Calculate Map]] enables the formulation of various algebraic and logic equations containing maps, tables and constants.
 \\ \\
 Besides writing the equation, there are two parameters that must be set: The Cell Type and the Null Value. You will always find these parameters in functors that produce maps as output. The default is set to “Signed 32 Bit Integer”, but you can use “IEEE 754 32 Bit Real” to represent fractional numbers. ​ Besides writing the equation, there are two parameters that must be set: The Cell Type and the Null Value. You will always find these parameters in functors that produce maps as output. The default is set to “Signed 32 Bit Integer”, but you can use “IEEE 754 32 Bit Real” to represent fractional numbers. ​
Line 56: Line 56:
 \\ \\
 \\ \\
-Despite the fact that the expression is presented using the alias of the functor from where the corresponding map is coming, you have to specify the map just typing the identifier i1. That identifier will be automatically replaced by the corresponding map alias. Another easy option to enter the map identifier is to click on the corresponding map name on the list above the image expression.+Despite the fact that the expression is presented using the alias of the functor from where the corresponding map is coming, you specify the map in the expression ​just typing the identifier i1. Momentarily,​ that identifier will be automatically replaced by the corresponding map alias. Another easy option to enter the map identifier is to click on the corresponding map name on the list above the image expression.
 \\ \\
 \\ \\
 <​note>​ <​note>​
-Although you won’t need it in this lesson, you might set the null value by first turning on the Null Value option on the Load Map and then setting its value to “0”.+Although you won’t need it in this lesson, you might set the null value by first turning on the Null Value option on the Load Map and then setting its value to a value outside the range of values represented in the map.
 </​note>​ </​note>​
 \\ \\
Line 77: Line 77:
 \\ \\
 \\ \\
-Save and run the model by clicking on the run model script button on the main toolbar. After adjusting limits and choosing a suitable transformation,​ as shown in the previous lesson, the map will look like this:+Save and run the model by clicking on the run model script button on the main toolbar. After adjusting limits and choosing a suitable transformation,​ as in the previous lesson, the map will look like this:
 \\  \\ 
 \\ \\