Differences

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

--- lesson_3 [2019/07/29 13:44]
hermann [Saving your work]
+++ lesson_3 [2019/08/30 16:59]
argemiro
@@ Line 1: / Line 1: @@
+{{ :logo_logo.png?400 |}}
+\\
 =====LESSON 3: Exploring the Map Viewer=====
 \\
@@ Line 20: / Line 22: @@
 \\
 {{:map_viewer:toolbar_num.png |}}
-) Load map erasing the current stack, load maps using the current stack, replace maps and load saved viewer state.\\
+) Load new maps discarding the previous ones, load new maps at the top of the current map list, load new map replacing a selected one, load saved viewer state.\\
 \\
 ) Save viewer state (save transformations, map stack settings, background color and movie maker settings.\\
@@ Line 64: / Line 66: @@
 {{:map_viewer:palette_color.png?nolink&|}} The color corresponding to each individual value can be changed by clicking on the corresponding color rectangle. You can also check color index value by hovering your cursor over the color rectangle. {{:map_viewer:palette_color_hover.png?nolink&|}}
-<note important>Values changed by [[histogram|histogram transformation]] may not correspond to palette colors as expected, specially when the user is trying to edit the colors for specific cells/categories. To avoid this issue, remove the histogram transformation before editing the colors for specific cell values.</note>
+<note important>Values changed by [[histogram|histogram transformation]] may not correspond to palette colors as expected, specially when the user is trying to edit the colors for specific cells/categories. To avoid this issue, remove the histogram transformation (set them to None) before editing the colors for specific cell values.</note>
 ===== Generated palette =====
@@ Line 74: / Line 76: @@
 ===== Saving your work =====
-Keep in mind that palettes are not saved until the user chooses to do so. If you made any mistake, you can just hit "cancel" and try again. If you hit Ok, the palette will be changed locally, but will reset if you restart the application.
+Keep in mind that palettes are not saved until the user chooses to do so. If you made any mistake, you can just click "cancel" and try again. If you click Ok, the palette will be changed locally, but will reset if you restart the application.
 Saved palettes are stored on the disk in the user palette folder ''Dinamica EGO/Dmps'', so every time you reopen the map viewer, you will still have them. Changes made by the users in predefined palettes only affect their own instance of the application. To reset the predefined palettes to their default state, remove the user palette folder and restart the application.
-<note tip>Tip: Usually, but not always, the user palette folder is ''C:\Users\<User Name>\Documents\Dinamica EGO\Dmps'', on Windows</note>
+<note tip>Tip: Usually, but not always, the user palette folder is ''C:\Users\<User Name>\Documents\Dinamica EGO\Dmps'' on Windows</note>
 ====== Histogram Editor ======
@@ Line 86: / Line 88: @@
 ===== Transformations =====
-  * **None**: The default transformation doesn't map any values, leaving cell values "as is".
+  * **None**: This option does not apply any transformation, leaving cell values "as is".
-  * **Linear**: This transformation will map linearly any values between the "from" and "to" ranges.
+  * **Linear**: Linearly maps values between the "from" and "to" ranges.
+  * **Equalize**: Constructs an appropriate curve based on [[wp>Equalization]].
-  * **Equalize**: This transformation will construct a curve based on [[wp>Equalization]].
 ====== Load a map ======
-Using map viewer, there are actually four ways you can load a map (or a group of maps, by using the CTRL key on file selection dialog):
+There are actually four options for loading maps (or a group of maps, if you hold the CTRL key while selecting the filenames on the file chooser):
-{{ :imagem67.png?200 |}}
+{{ :imagem67.png?700 |}}
-^ Load map (cleaning map list)  | Will erase the current map stack (label "Maps" on main dialog).  |
+^ Load map (cleaning map list)  | Erase the current map list (label "Maps" on main dialog).  |
-^ Load map (keeping map list)  | Will **NOT** change current map stack, the new loaded map will be on top of the stack and *visible*. Every incompatible map (different number of lines or columns) will be turned off (invisible). Keep in mind that if you open a incompatible map, the current transformation will be erased and the  default transformation (which renders to full screen) restored  |
+^ Load map (keeping map list)  | Load the new map at the top of the current map list. Every incompatible map (different number of lines or columns) will be turned off (made non-visible). Keep in mind that if you open a incompatible map, the current transformation will be erased and the  default transformation restored.  |
-^ Load map on selection  | Will load the new map replacing the selected map. This option is only available if there is a map loaded. All transformations (histogram, palette, pan, zoom) will be untouched. The new map will try to match the active map layer selection  |
+^ Load map on selection  | Load the new map replacing the selected map. This option is only available if there is a map selected. All transformations (histogram, palette, pan, zoom) will be left untouched. The new map will try to match the active map layer selection  |
-^ Load viewer state  | Will load a entirely new viewer state, replacing the map stack, the background color, loaded palettes, histogram transformations and everything else.  |
+^ Load viewer state  | Load an stored viewer state from a file, replacing the map stack, the background color, current palettes, histogram transformations and everything else.  |
 ===== Map loaded, so what? =====
-After your map is loaded, you can see it on the "Maps" stack on the right.
+After your map is loaded, its name will displayed on the "Maps" list on the right side of the map viewer interface.
 \\
 \\
-Initially, your map will be loaded **Collapsed**. We do this because the functionality of **each** map is contained inside its "row" in the map stack. To expand, just click on the expand arrow.
+Initially, the settings corresponding to a loaded map are **Collapsed**. To expand the settings panel, just click on its corresponding "expand arrow".
 \\
 \\
-After expanding, your map will look like this on the map stack. For maps with category information bundled, it will look like this:
+After expanding the settings panel, your map will look like this on the map stack. For maps also providing category information, it will look like this:
 \\
 \\
@@ Line 116: / Line 119: @@
 \\
 \\
-You can see a new button, this is just a toggle between "normal" mode and "category" mode. Inside the category mode, the map transformation is ignored and the category colors are used instead. Also, when showing legends in category mode, category colors and names are shown instead of the legend range.
+As you can see, this button is just a toggle between "normal" mode and "category" mode. Enabling the category mode ignores the map transformation and uses the category colors instead. Also, when showing legends in category mode, category colors and names are displayed instead of the legend range.
 \\
 \\
@@ Line 138: / Line 141: @@
 ) Change map layer. If your map has many layers, you can select the active layer to be shown. Only one layer can be use at time.\\
 ) Change map [[color_palette|palette]].\\
-) Opacity (by default, viewer show opaque maps, but you can set a transparency threshold and adjust stack to combine maps).\\
+) Opacity (by default, viewer show opaque maps, but you can set a transparency threshold for better visualization).\\
 ) [[Viewer Image Expression|Image Expression]] (calculate expression - just like calculate map on Dinamica EGO - for map values).\\
 ) [[histogram|Histogram]] transformation.\\
@@ Line 230: / Line 233: @@
   "C:\Program Files\Dinamica EGO\DinamicaMapViewer" "c:\Maps\maps.egov" "c:\Outputs\result.png" 800 600
+\\
+\\
+Congratulations, you have successfully completed this Module! Now let’s move to the **next module and to the next lesson:** [[lesson_4|LESSON 4: Opening and Saving maps on Dinamica EGO]]