=== modified file 'src/docbkx/en/dhis2_user_man_creating_gis.xml'
--- src/docbkx/en/dhis2_user_man_creating_gis.xml 2012-04-10 17:02:54 +0000
+++ src/docbkx/en/dhis2_user_man_creating_gis.xml 2012-11-13 13:16:30 +0000
@@ -4,7 +4,7 @@
Setting up GIS
Context
- Setting up the GIS simply means storing coordinates for the organisation units you want to show on the map in the database. Coordinates are often distributed in proprietary formats and will need to be converted to a format which DHIS2 uses. ESRI shapefiles are the most common geospatial vector data format for desktop applications. You might find shapefiles for your country here or in many other geospatial data repositories on the web. Some amount of work needs to be done in order to use these coordinates in DHIS 2 GIS, namely transforming the data into a suitable format and ensuring the name which are contained in the geospatial data match exactly with the names of the organization units which they should be matched to.
+ Setting up the GIS simply means storing coordinates for the organisation units you want to show on the map in the database. Coordinates are often distributed in proprietary formats and will need to be converted to a format which DHIS2 understands. ESRI shapefiles are the most common geospatial vector data format for desktop applications. You might find shapefiles for your country here or in many other geospatial data repositories on the web. Some amount of work needs to be done in order to use these coordinates in DHIS 2 GIS, namely transforming the data into a suitable format and ensuring the name which are contained in the geospatial data match exactly with the names of the organization units which they should be matched to.
If you go to the organisation unit module and edit one of the units, you can see a text field called Coordinates. Here you may fill in its coordinates directly (geojson format) which is useful if you just want to update a couple of units.
An example point/facility coordinate:
[29.341,-11.154]
@@ -48,50 +48,4 @@
- The "shortname" column in the organisationunit table in your database has a too small varchar definition. Increase it to 100.
- Special name characters in the GML file. Be sure to convert these to appropirate XML equivalents or escape sequences.
-
- Administering the GIS module
-
- Register overlays
- Overlays are geographical layers that do not have any direct linkage
- to data in the database. Examples include roads, rivers, airports, ports,
- and other geographical information that you may want to display on your
- map, but that is not necessarily linked to data contained in the DHIS
- database. The Register Overlay panel will allow you to
- add new layers and determine how they will be represented visually on the
- map.
-
-
- Display name: Represents your overlay in
- the layer tree in the upper right corner.
-
-
- Map source file: The GeoJSON file
- name.
-
-
- Fill color: Decides the fill color if the
- layer is a polygon layer.
-
-
- Fill opacity: Select an opacity level
- between 0 (invisible) and 1 (solid).
-
-
- Stroke color: The stroke color over lines
- and polygon borders.
-
-
- Stroke width: Select a stroke width between
- 0 and 4.
-
-
-
- Copying files to the DHIS application
- Currently, your GeoJSON files should be placed in the
- DHIS2_HOME/geojson of your DHIS application to be accessible to the GIS
- module. If the GeoJSON directory does not exist, you will need to create
- it manually and copy your GeoJSON files there.
-
-
-
=== modified file 'src/docbkx/en/dhis2_user_man_using_gis.xml'
--- src/docbkx/en/dhis2_user_man_using_gis.xml 2011-09-13 05:24:36 +0000
+++ src/docbkx/en/dhis2_user_man_using_gis.xml 2012-11-13 13:16:30 +0000
@@ -13,24 +13,35 @@
- On the right hand side there is a panel called "Map layers". There are three available "base layers", which means background map, including OpenStreetMap and Google Maps. You may click the text to open a context menu that lets you adjust the opacity/transparency of the background. "Overlays" are described later in this chapter. The final four layers are the vector layers which the user has at his disposal for thematic mapping. You may use this layer tree to show/hide layers by checking/uncheking their checkbox. The next panel called "Cursor position" tells you at what longitude and latitude your mouse cursor is positioned. The "Feature data" panel provides you with quick information on the organisation units you mouse hover in your thematic maps. Finally there is a legend panel for all the thematic layers.
- The picture below shows the map toolbar:
-
- Map toolbar
-
-
-
-
-
-
- The "Map" buttons from the left: "Zoom in", "Zoom out", "Zoom to visible extent" (all thematic map data fits inside the viewport).
- The "Layers" buttons from the left: "Thematic layer 1", "Thematic layer 2", "Facility layer", "Symbol layer".
- The "Tools" buttons from the left: "Favorite map views", "Predefines legend sets", "Export map to PNG", "Measure distances on map".
- The two final buttons are "Administrator settings" and "Help".
+ In the top right corner there is a panel called "Layer overview". If you are online you will see Google Streets and Google Hybrid which can be used as background maps/layers. Switch between the two of them by checking the checkbox. By unchecking the box you can hide the background completely. If you want to see the background, but with reduced opacity, you can set the visibility to something lower than 100% in the numberbox to the right. The final four layers are the vector layers which the user has at his disposal for thematic mapping (explained in the next section). The panels below hold the map legends when you create a thematic map. A legend explains the link between values and colors on your map.
+
+ Lets take a look at the map toolbar. The four icons from the left represent the mentioned vector layers and this is the starting point of the GIS application. Further to the right we have "Favorites": Save your maps to easily restore them later. Saving a map as a favorite also gives you the opportunity of sharing it with other users as an interpretation or put it on the dashboard. "Legend": Create you own legend sets to ensure meaningful maps. "Download": Export the maps as a PNG image. "Share": Share your favorites as map interpretations with other users.
+
+ In the top right corner of the map viewport you find four buttons: "Zoom in", "zoom out", "zoom to visible extent" (automatically adjusts the zoom level and map center position to focus on your map) and "measure distances".
+
+ The current longitude/latitude position of the mouse cursor is displayed in the bottom right corner of the map viewport.
+
Thematic mapping
- This section describes the four vector layers which the user has at his disposal for thematic mapping: "Thematic layer 1", "Thematic layer 2", "Facility layer" and "Symbol layer".
+ This section describes the four vector layers which the user has at his disposal for thematic mapping: "Boundary layer", "Thematic layer 1", "Thematic layer 2" and "Facility layer".
+
+ Boundary layer
+
+ Boundary layer
+
+
+
+
+
+
+ The purpose of the boundary layer is to display the boundaries/coordinates in the system. No data will be shown. This layer is useful if you are offline and thus have no background map. Click the boundary/globe icon on the toolbar and select "Edit layer". You can select the organisation units you want to show on the map by selecting a level and a parent. That means "show all organisations units at this level that are children of this parent". When there are visible organisation units on the map, you can easily navigate up and down in the hierarchy without using the level/parent user interface. By clicking one of the organisation units a context menu will open, then select "drill down" or "float up". The drill down option will be disabled if you are already on the lowest level or if there are no coordinates available on the level below. Vice verca goes for floating up.
+
+ The layer menu also offers to put on labels and to locate an organisation unit in the map.
+
+ The final option in the layer menu is "Close". This completely resets the layer content, the edit layer form and the legend panel.
+
+
Thematic layer 1 and 2
@@ -41,55 +52,16 @@
- The two thematic layer panels let you use your data for thematic mapping. All you need to do is selecting your desired indicator/dataelement-period-map combination, then the organisation unit level and finally the parent to define the boundary. If your database has coordinates for these organisation units they will appear on the map.
- You may choose between legend types: automatic and predefined. Automatic means that the application will create a legend set for you based on your what method, number of classes, low color and high color you select. Method alludes to the size of the legend classes. Set to Equal intervals they will be “highest map value – lowest map value / number of classes”. Set to Equal group count the legend creator will try to distribute the organisation units evenly. Choose Fixed bounds and you may define your own class break values, type e.g. “20,40,60” using a comma to separate each of them. The legend will appear as an even gradation from the start color to the end color. Predefined legend sets are described in .
+ The two thematic layer panels let you use your data for thematic mapping. All you need to do is selecting your desired combination of indicator/dataelement, period and map combination. Then the organisation unit level and parent to define the boundaries. If your database has coordinates and aggregated data values for these organisation units they will appear on the map. Note that the DHIS2 data mart must be run in order to have aggregated values available.
+
+ You may choose between legend types: automatic and predefined. Automatic means that the application will create a legend set for you based on your what method, number of classes, low color and high color you select. Method alludes to the size of the legend classes. Set to Equal intervals they will be “highest map value – lowest map value / number of classes”. Set to Equal group count the legend creator will try to distribute the organisation units evenly. The legend will appear as an even gradation from the start color to the end color. Predefined legend sets are described in .
+
Low radius and high radius only have effect on points (facilities) and decides the the circle radius for points with the lowest and highest value.
- The map view combo box lists all map views (favorites) saved by the user. The settings that are stored in the map view is automatically applied to the thematic map panel. Favorite map views are described in .
- All available layer options are now grouped together in the thematic layer menu, see picture below.
-
- Thematic layer options
-
-
-
-
-
-
- Edit layer: Opens up the layer configuration window, see the thematic mapping screenshot.
- Refresh: Refreshes the map boundaries, data and legend. Usually not necessary.
- Clear: Clears the entire layer, i.e. the configuration window, the map and the legend panel.
- Filter: Opens up the filter window and lets you filter out organisation units from the map by value. See the picture below.
-
- Filter
-
-
-
-
-
-
- Search: Opens up the search window and lets you search for and locate organisation units on the map. See picture below.
-
- Search
-
-
-
-
-
-
- Labels: Opens up the label window and lets you add labels to the organisation units on the map. See picture below.
-
- Labels
-
-
-
-
-
-
- Opacity: Set the layer opacity/transparency to 10, 20, 30, 40, 50, 60, 70, 80, 90 or 100%. Higher values of opacity make the layer more transparent, so that the underlying layer is more visible. An opacity level of zero will provide a fully opaque layer.
- History: Provides you with a list of your 10 previous maps/selections. They are temporary and thus gone when the application is restarted.
+
+ Thematic layer 1 and 2 menu have a "Filter" option in addition to the boundary layer menu options. It lets you apply value filters to the organisation units on the map. The filter is removed when you close the filter window.
Facility layer
- This layer displays icons that represent facilities based on the facility type. Currently, "Type" is the only supported group set. Polygons will not show up on the map, so make sure to select a facility level. Click an icon on the map to open the context menu with two options. "Show information sheet" provides you with data for several data elements for this organisation unit. The data element group and period type are "system settings" called "Infrastructural data elements" and "Infrastructural period type". The second option in the context menu is "Relocate" and lets you graphically move the organisation unit to a different location. The new coordinate will be stored permanently.
Facility layer
@@ -98,38 +70,48 @@
-
-
- Symbol layer
- This layer displays icons that represent areas/polygons like provinces, districts etc instead of facilities/points. Thus, in this layer you are not supposed to select a facility level, but instead a level of provinces, districts etc. In order to render this layer you need to create a predefined legend set of images, described in .
-
- Symbol layer
-
-
-
-
-
-
+ This layer displays icons that represent facilities based on the facility type. Polygons will not show up on the map, so make sure to select an organisation unit level that has facilities. Click an icon on the map to open the context menu with two options. "Show information sheet" provides you with data for several data elements for this organisation unit. The data element group and period type are "system settings" called "Infrastructural data elements" and "Infrastructural period type". The second option in the context menu is "Relocate" and lets you graphically move the organisation unit to a different location. The new coordinate will be stored permanently. Browser cache must be deleted to see the change if you reload the page.
+
+ In the "Edit layer" window will find "sourrounding areas" in addition to group set, level and parent. This lets you draw a circle around each facility with a desired radius in kilometers.
Tools
- This section describes the available GIS tools, which are available on the "Tools" section of the map toolbar.
+ This section describes the available GIS tools.
- Register favorite map views
- Click the "Favorite map views" button (star icon) on the toolbar to get the context menu. The first option is "Manage favorites" which opens up a window where you are supposed to type the name of the favorite and select the layer you want to save. If you are an administrator you can check the "System" checkbox to make the favorite available to all users. From the bottom combobox you may delete a favorite or add it to the DHIS 2 dashboard.
+ Favorite maps
+
+ Favorite maps
+
+
+
+
+
+
+ Click the "Favorites" button on the toolbar to open the "Manage favorites" window. To add a new favorite, click the "Add new" button. A new window opens. Enter a name and click the "Create" button. You will find your new favorite in the list.
+
+ All favorites have four action buttons on the right hand side. Grey: Edit favorite name. Green: Save current map to this favorite (overwrite). Yellow: Add this favorite to dashboard. Red: Delete this favorite.
+
+ You can search for favorites in the textfield above the favorites. The list will be filtered on every character that is entered. Click the "next" and "prev" buttons in the bottom right corner to navigate between pages.
+
- Register legend sets
- Example usage (vaccination coverage): Firstly, create the legends that are going to constitute the legend set. The first one could be "Low bad" (display name), 0 (start value), 30 (end value), red (color). Then create "Medium" / 30 / 70 / yellow and finally "High good" / 70 / 100 / green. Now, open the "legend set" panel, type e.g. "High is good" as display name and select the desired legends below. Multi-select your three legends by pressing and holding the Ctrl/Shift button when selecting. Then click the register button to store the legend set. Assign indicators/data elements to your legend set in one of the two last panels. Select the legend set in the combo box and multi-select items in the list below. Click the assign button to update the legend set. Please see the referred window in section 1.1.
+ Create predefined legend sets
+ Click the "Legend" button on the map toolbar. To create a new set click the "Add new" button. Example usage (vaccination coverage): Firstly, give the legend set a name. Then create the legends you want in your legend set. The first one could be "Low bad" (name), 0 (start value), 50 (end value), red (color). Click "Add legend" and appears in the list below. Then create "Medium" / 50 / 80 / yellow, "High good" / 80 / 100 / green and finally "Too high" / 100 / 10000 / grey. Now, click the "Create" button in the bottom right corner. If your legend set has overlapping legends (e.g. 0-50 and 40-80) you will not be allowed to proceed. If your legend set has a gap between the legends (e.g. 0-50 and 60-80) you will get a warning, but are allowed to proceed.
+
+ NOTE! Continous legends are supposed to end and start on the same value, e.g. 0-50 and 50-80. This will automatically be taken care of by the application. Do not try to do this yourself by setting legends to e.g. 0-50 and 51-80. This will cause a usually unwanted gap in your legend set.
+
+ You can assign a legend set to an indicator or a data element in the Indicator/Data element module. This legend set will then be automatically selected when such an indicator/data element is selected in the GIS.
+
- Exporting/saving map images
- Click the image icon on the map toolbar and the print window will open. Title: Image title, will appear as a headline in the image. Layers: Choose whether polygons, points or both will be printed. Width/Height: The pixel resolution of the image. Choose among the predefined "small" (800x600), "medium" (1190x880), "large" (1920x1200) or type the exact number of pixels yourself (type the number only, avoid text like "px"). If you want to exclude the legend from the image, untick the legend checkbox. Finally click the export button to print the image (PNG). Please see the referred window in section 1.1.
+ Download map as image
+ Click the "Download" button on the map toolbar. Enter a name in the textfield and click "Download". The browser will download a PNG image. If the toolbar "Download" button is disabled you need to create a map first.
-
- Measure distance
- Click the two-way arrow icon on the map toolbar to enter measuring mode. Now, click your desired start location on the map and a dotted line will follow the cursor toward your destination. Single click to create a line point, double click to finish the line. To exit measuring mode, click the toolbar icon again or close the window.
+
+
+ Share map interpretation
+ Open a favorite or save a new map as a favorite. Then click the "Share" button on the map toolbar. Type in your interpretation and click "Share".
=== added file 'src/docbkx/en/resources/images/gis/gis_boundary_layer.png'
Binary files src/docbkx/en/resources/images/gis/gis_boundary_layer.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/gis/gis_boundary_layer.png 2012-11-13 13:16:30 +0000 differ
=== modified file 'src/docbkx/en/resources/images/gis/gis_facility_layer.png'
Binary files src/docbkx/en/resources/images/gis/gis_facility_layer.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_facility_layer.png 2012-11-13 13:16:30 +0000 differ
=== added file 'src/docbkx/en/resources/images/gis/gis_favorites.png'
Binary files src/docbkx/en/resources/images/gis/gis_favorites.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/gis/gis_favorites.png 2012-11-13 13:16:30 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_filter.png'
Binary files src/docbkx/en/resources/images/gis/gis_filter.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_filter.png 1970-01-01 00:00:00 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_labels.png'
Binary files src/docbkx/en/resources/images/gis/gis_labels.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_labels.png 1970-01-01 00:00:00 +0000 differ
=== modified file 'src/docbkx/en/resources/images/gis/gis_main.png'
Binary files src/docbkx/en/resources/images/gis/gis_main.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_main.png 2012-11-13 13:16:30 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_search.png'
Binary files src/docbkx/en/resources/images/gis/gis_search.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_search.png 1970-01-01 00:00:00 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_symbol_layer.png'
Binary files src/docbkx/en/resources/images/gis/gis_symbol_layer.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_symbol_layer.png 1970-01-01 00:00:00 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_thematic_layer_options.png'
Binary files src/docbkx/en/resources/images/gis/gis_thematic_layer_options.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_thematic_layer_options.png 1970-01-01 00:00:00 +0000 differ
=== modified file 'src/docbkx/en/resources/images/gis/gis_thematic_mapping.png'
Binary files src/docbkx/en/resources/images/gis/gis_thematic_mapping.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_thematic_mapping.png 2012-11-13 13:16:30 +0000 differ
=== removed file 'src/docbkx/en/resources/images/gis/gis_toolbar.png'
Binary files src/docbkx/en/resources/images/gis/gis_toolbar.png 2011-09-09 13:53:45 +0000 and src/docbkx/en/resources/images/gis/gis_toolbar.png 1970-01-01 00:00:00 +0000 differ