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
Next revision Both sides next revision
lesson_9 [2019/08/30 23:41]
argemiro
lesson_9 [2019/09/22 20:26]
britaldo
Line 1: Line 1:
 {{ :​logo_logo.png?​400 |}} {{ :​logo_logo.png?​400 |}}
 \\ \\
-=====LESSON 9: Working with maps and tables iteratively=====  ​ 
 \\ \\
-==The aim of this lesson is to introduce the user to calculate the area of each source feature on Dinamica EGO. For this, we will calculate the area of each category of Legal Amazon Protected Areas map in the year 2000 and, next, to calculate biomass and Carbon Dioxide content in Biomass in high priority conservation areas within protected areas. .==+====LESSON 9: Working with maps and tables iteratively====
 \\ \\
-**Which Functors will you use in this lesson?**\\ \\ +The aim of this lesson ​is introducing the calculation of area of each source feature on Dinamica EGO to the user. For this, we will calculate the area of each category of Legal Amazon Protected Areas map in the year 2000 and calculate biomass and Carbon Dioxide content in Biomass within high priority conservation areas.
-• Functors:​ Calc areas and Calculate ​map+
 \\ \\
 +In this lesson we will use the following files:
 \\ \\
-**We will use:​** ​ 
 \\ \\
-The protected areas map in the year 2000 (Guidebook Dinamica_4/​Database/​Protected_areas/​protected_areas_2000.tif)+  * The protected areas map in the year 2000 (''​Guidebook Dinamica_4/​Database/​Protected_areas/​protected_areas_2000.tif''​)
 \\ \\
 +  * The Legal Amazon conservation priority map (''​Guidebook Dinamica_4/​Database/​Priority_areas/​priority_areas.tif''​) ​
 \\ \\
-The Legal Amazon ​Conservation Priority ​map (Guidebook Dinamica_4/​Database/​Priority_areas/priority_areas.tif) +  * The Legal Amazon ​biomass ​map (''​Guidebook Dinamica_4/​Database/​biomass/biomass.tif''​)
 \\ \\
 \\ \\
-- The Legal Amazon Biomass map (Guidebook Dinamica_4/​Database/​biomass/​biomass.tif)+**Let'​s go!**
 \\ \\
 \\ \\
-**Let's go!** Initially, ​From the library window grab and place on the sketch the Load Categorical Map Functor, which are located in the Input/​Output tab. Double clickand open the protected_areas_2000.tif file. +  ​* From the library window grab and place on the sketch the **Load Categorical Map**, which is located in the Input/​Output tab. Double click it and open the ''​protected_areas_2000.tif'' ​file. 
 \\ \\
 \\ \\
Line 26: Line 25:
 \\ \\
 \\ \\
-Click on the Map Algebra tab from the library window, ​grab a Calc areas functor, place it on the sketch and connect ​the Load Categorical Map to them. The expression ​result ​is calculated as a real value and converted to the data cell type of the output map.+  * Click on the Map Algebra tab from the library window, ​select **Calc Areas**, place it on the sketch and connect ​**Load Categorical Map** to it. The expression is calculated as a real value and converted to the same data cell type as of the output map.
 \\ \\
 \\ \\
-Now you need to save the result to a file. For thisGrab and place on the sketch ​the Save Table functor ​and connect the functor Calc areas to them. Open Save Map, select a folder and write a name file to save (suggestion: ​ Areas of Legal amazon protected areas.csv).+  * To save the result to a file, grab and place on the sketch ​**Save Table** and connect the functor ​**Calc Areas** ​to it. Open **Save Table**, select a folder and write a suitable file name (e.g. areas_of_legal_amazon_protected_areas.csv).
 \\ \\
 \\ \\
-{{ :​imagem68.png?​700 |}}+{{ :​imagem68.png?​700 |}} 
 \\ \\
 \\ \\
-Mark the eye button ​at the top of Save Table” to viewer ​the results hereafter+  * Save and run your model. Click on the eye button of **Save Table** to see the result.
 \\ \\
 \\ \\
-Save your model (Disk button on the main tool bar) and then run it by clicking on the run button (blue arrow on the main tool bar).+{{ :imagem69.png?500 |}}
 \\ \\
 \\ \\
-Now, click on eye button of “Save Table” to see the result. This functor output ​is table that looks like this:+<​note>​ 
 +**What ​is your model doing?​** ​
 \\ \\
 +It is loading “protected_areas_2000.tif” file and then calculating the area of each category of the Legal Amazon protected areas.
 +</​note>​
 \\ \\
-{{ :​imagem69.png?​500 |}} 
 \\ \\
 +===For the second part of this lesson we calculate the biomass and Carbon Dioxide content within it in high priority conservation areas.===
 \\ \\
-**What is your model doing?** It is loading “protected_areas_2000.tif” file and then calculating the area of each category of Legal Amazon Protected Areas. 
 \\ \\
-\\ +  ​* Initially, we must open all the files that will be used. On the Input/Output ​tab from the library windowgrab two **Load Categorical Map** and place them on the sketch. Double click each **Load Categorical Map** and load the Legal Amazon Conservation Priority ​(''​Guidebook Dinamica_4/​Database/​Priority_areas/​priority_areas.tif''​) ​and Protected Areas maps (''​Guidebook Dinamica_4/​Database/​Protected_areas/​protected_areas_2000.tif''​). Place **Load Map** and open the Legal Amazon Biomass map (''​Guidebook Dinamica_4/​Database/​biomass/​biomass.tif''​).
-**Go ahead!** Now, The intent is to calculate biomass and Carbon Dioxide content in Biomass in high priority conservation areas within protected areas. +
-\\ +
-\\ +
-Initially, we must open all the files that will be used. Click on the Input/output ​tab from the library window ​and grab two Load Categorical Map functors ​and place it on the sketch. Double click each Load Categorical Map Functor ​and open the Legal Amazon Conservation Priority ​and protected areas map filesAlso grab and place a Load Map and open the Legal Amazon Biomass map. You should have something like this:+
 \\ \\
 \\ \\
Line 59: Line 56:
 \\ \\
 \\ \\
-Now, grab a Calculate Map and place it on the sketch. Click in the hook tool to create three hook functors ​with Number Map inside the Calculate Map. Now assign ​a number to each Number Map (Suggestion: ​“1”, “2” and “3”, respectively). This is a number identifier for each map and will be represented within the equation box as i1, i2 and i3.  +  * Place **Calculate Map** on the sketch. Click on the hook tool to create three **Number Map** hook functors ​within **Calculate Map**Assign ​a number to each **Number Map** (e.g. “1”, “2” and “3”, respectively). This is a number identifier for each map and will be represented within the equation box as i1, i2 and i3. Connect ​**Load Map** and **Load Categorical Map**  ​to each **Number Map**.
-Now you need to connect the functors to establish a model. Connect ​the Load Map and Load Categorical Map functors ​to each Number Map. You should have something like this:+
 \\ \\
 \\ \\
Line 66: Line 62:
 \\ \\
 \\ \\
-Now, write the following equation ​inside to Calculate Map to calculate biomass ​in each high priority conservation areas within protected areaOn Dinamica EGO interface you should have something like this:+  * Write the following equation ​in Calculate Map to calculate ​the biomass ​of each high priority conservation areas category.
 \\ \\
 \\ \\
Line 72: Line 68:
 \\ \\
 \\ \\
-Now, you need save the result of biomass to a file. Grab a Save Table, place it on the sketch and connect ​the Calculate ​map to them. Open Save Map, browse to the folder ​preferred ​and write the name file (We suggest: biomass_high priority conservation_protected areas_map.tif).\\ \\ +  * Now, you need save the result of biomass to a file. Place **Save Map** on the sketch and connect ​**Calculate ​Map** to it. Open **Save Map**, browse to a suitable ​folder and write the file name (e.g. biomass_high_priority_conservation_protected_areas_map.tif).
-Mark the eye button at the top of “Save Table” to viewer the results hereafter. ​ \\ \\ +
-At this step you should have something like this: +
 \\ \\
 \\ \\
Line 80: Line 74:
 \\ \\
 \\ \\
- +  * Now, we will extract the attributes and calculate ​basic statistics from Biomass in high priority conservation protected ​areas. Grab and place on the sketch ​an **Extract ​Map Attributes** ​(this functor produces as output a table with map attributes) and connect ​**Calculate Map** to it.
-Now, we will extract the attributes and calculates ​basic statistics from Biomass in high priority conservation protected ​areaFor this, Grab and place on the sketch ​Extract ​map attributes functor ​(this functor produces as output a table with map attributes) and connect ​the Calculate Map to them.+
 \\ \\
 \\ \\
-Grab and place on the sketch a Calculate ​value functor. Click in the hook tool to create three hook functors inside ​the Calculate ​Map: one Number ​table and two Number ​value functors. Assign a number to each Number Value and Number Table. ​+  * Grab and place on the sketch a **Calculate ​Value**. Click in the hook tool to create three hook functors inside ​**Calculate ​Value**: one **Number ​Table** ​and two **Number ​Value**. Assign a number to each **Number Value** and **Number Table**
 \\ \\
 \\ \\
-In some cases, is very useful to add a constant value to the operations in Dinamica. In this step, we will demonstrate how to do this. For this, grab and place on the sketch two Real value functors located on the Map Algebra suppl. tab to insert two double precision real constants: One is a CO2 conversion factor (3.666) and other a Carbon Content in Biomass (0.47). Connect the Extract map attributes Map to Number Table and the two Real Value functors to Number Value Functors inside the Calculate Value. At this step you should have something like this:+<note important>​ 
 +In some cases, is very useful to add a constant value to the operations in Dinamica. In the next step, we will demonstrate how to do this.  
 +</​note>​
 \\ \\
 +  * Grab and place on the sketch two **Real Value** located on the ''​Map Algebra (Suppl.)''​ tab to insert two double precision real constants:
 \\ \\
-{{ :imagem74.png?800 |}}+     - A CO2 conversion factor (3.666)  
 +     - Carbon Content in Biomass (0.47)
 \\ \\
 +  * Connect **Extract Map Attributes** to **Number Table** and the two **Real Value** functors to the **Number Value** functors inside the **Calculate Value**. At this step you should have something like this:
 \\ \\
-Now, write the following equation inside to Calculate Value to estimate CO2 content of high priority conservation areas within protected areas using the Map statistics calculate by Extract Map attributes functor ("​cellSum"​ and "​cellArea"​) and the two constant values added (v1 and v2): 
 \\ \\
 +{{ :​imagem74.png?​800 |}}
 \\ \\
-//​t1["​cellSum"​] * t1["​cellArea"​] * v1 * v2// 
 \\ \\
-\\ +  * Write the following equation in **Calculate Value** to estimate CO2 content of high priority conservation areas using the map statistics calculated by **Extract Map Attributes** ("​cellSum"​ and "​cellArea"​) and the two constant values added (v1 and v2)''​t1["​cellSum"​] * t1["​cellArea"​] * v1 * v2''​
-On Dinamica EGO interface you should have something like this:+
 \\ \\
 \\ \\
Line 105: Line 101:
 \\ \\
 \\ \\
-Now, grab a Set Lookup Table Value Functor ​and place on the sketch to insert the calculate ​values into a lookup table. It is important to pay attention to add correctly ​the key to the line where the value will be inserted:+    * Grab **Set Lookup Table Value** functor ​and place it on the sketch to insert the calculated ​values into a lookup table. It is important to pay attention to add the correct ​key to the line where the value will be inserted:
 \\ \\
 \\ \\
Line 111: Line 107:
 \\ \\
 \\ \\
-<note important>​**IMPORTANT:​** ​If the table is already filled in, it replaces the old values with new values.</​note>​ +<note important>​ 
-Now you need to save the result to a file. For this, Grab and place on the sketch ​the Save Lookup Table functor ​and connect ​the functor ​Set Lookup Table to them. Open Save Lookup Table, select a folder and write a name file to save (We Suggest: ​high priority cons_prot areas_CO2.csv).+If the table is already filled in, it replaces the old values with new values. 
 +</​note>​ 
 +  ​* ​Now you need to save the result to a file. Grab and place on the sketch ​a **Save Lookup Table** and connect ​**Set Lookup Table** to it. Open **Save Lookup Table**, select a folder and write a suitable ​file name (e.g. high priority_cons_prot_areas_CO2.csv).
 \\ \\
 \\ \\
-The final model will look like this: +  * The final model will look like this: 
 \\ \\
 \\ \\
Line 121: Line 119:
 \\ \\
 \\ \\
-Mark the eye button ​at the top of “Save Lookup Table” to viewer ​the result ​hereafter+  * Save and run your model, click on eye button of “Save Lookup Table” to see the result. ​This functor output is a table that looks like this:
 \\ \\
 \\ \\
-Save your model (Disk button on the main tool bar) and then run it by clicking on the run button (blue arrow on the main tool bar)+{{ :imagem78.png?600 |}}
 \\ \\
 \\ \\
-Nowclick on eye button of “Save Lookup Table” to see the result. This functor output is table that looks like this:+===Congratulationsyou have successfully completed ​this lesson!===
 \\ \\
 \\ \\
-{{ :imagem78.png?​600 ​|}}+☞[[:lesson_10 ​Next Lesson]]
 \\ \\
-\\ +[[:​guidebook_startBack to Guidebook Start]] 
-Congratulations,​ you have successfully completed this lesson! Now let’s move to the **next lesson:​** ​[[lesson_10|LESSON 10: What are, what types and where are the submodels in Dinamica EGO?]]+