dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 382
committer: Jan Henrik Overland <janhenrik.overland@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Fri 2011-09-09 16:17:32 +0200
message:
  GIS docs update.
modified:
  src/docbkx/en/dhis2_user_man_creating_gis.xml
  src/docbkx/en/dhis2_user_man_using_gis.xml


--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs

Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription

=== modified file 'src/docbkx/en/dhis2_user_man_creating_gis.xml'
--- src/docbkx/en/dhis2_user_man_creating_gis.xml	2011-07-24 12:44:30 +0000
+++ src/docbkx/en/dhis2_user_man_creating_gis.xml	2011-09-09 14:17:32 +0000
@@ -7,8 +7,12 @@
     <para>
       Setting up the GIS simply means storing coordinates for the organisation units you want to show on the map in the database. Coordinates are distributed in shapefiles, which is the most common geospatial vector data format for desktop applications (you might find shapefiles for your country at http://www.diva-gis.org/gdata). The work that needs to be done in order to use these coordinates in DHIS 2 GIS is transfering them and storing them with the corresponding organisation units in the database.
     </para>
-    <para>If you go to the organisation unit module and edit one of the units, you can see a textfield called Coordinates. Here you may fill in its coordinates directly (geojson format) which is quite neat if you just want to update a couple of units. However, if you are going to e.g. add coordinates for all units at a certain level you don&apos;t want to do that manually. This is where the automatic GML import comes into play and the following section explains the preferred way of using it.
-    </para>
+    <para>If you go to the organisation unit module and edit one of the units, you can see a textfield called Coordinates. Here you may fill in its coordinates directly (geojson format) which is quite neat if you just want to update a couple of units.</para>
+    <para>An example point/facility coordinate:</para>
+    <para><programlisting><userinput>[29.341,-11.154]</userinput></programlisting></para>
+    <para>An example polygon/area coordinates string:</para>
+    <para><programlisting><userinput>[[[[29.343,-11.154],[28.329,-11.342],[28.481,-10.239],[29.833,-10.412]]]]</userinput></programlisting></para>
+    <para>However, if you are going to e.g. add coordinates for all units at a certain level you don&apos;t want to do that manually. This is where the automatic GML import comes into play and the following section explains the preferred way of using it.</para>
   </section>
   <section id="gisSetup">
     <title>Importing coordinates</title>

=== modified file 'src/docbkx/en/dhis2_user_man_using_gis.xml'
--- src/docbkx/en/dhis2_user_man_using_gis.xml	2011-09-09 13:53:45 +0000
+++ src/docbkx/en/dhis2_user_man_using_gis.xml	2011-09-09 14:17:32 +0000
@@ -15,18 +15,18 @@
     </screenshot>
     <para>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.</para>
     <para>The picture below shows the map toolbar:</para>
-    <para>The "Map" buttons from the left: "Zoom in", "Zoom out", "Zoom to visible extent" (all thematic map data fit inside the viewport).</para>
+	<screenshot>
+        <screeninfo>Map toolbar</screeninfo>
+        <mediaobject>
+          <imageobject>
+            <imagedata width="50%" fileref="resources/images/gis/gis_toolbar.png" format="PNG"/>
+          </imageobject>
+        </mediaobject>
+	</screenshot>
+    <para>The "Map" buttons from the left: "Zoom in", "Zoom out", "Zoom to visible extent" (all thematic map data fits inside the viewport).</para>
 	<para>The "Layers" buttons from the left: "Thematic layer 1", "Thematic layer 2", "Facility layer", "Symbol layer".</para>
 	<para>The "Tools" buttons from the left: "Favorite map views", "Predefines legend sets", "Export map to PNG", "Measure distances on map".</para>
 	<para>The two final buttons are "Administrator settings" and "Help".</para>
-	<screenshot>
-        <screeninfo>Map toolbar</screeninfo>
-        <mediaobject>
-          <imageobject>
-            <imagedata width="50%" fileref="resources/images/gis/gis_toolbar.png" format="PNG"/>
-          </imageobject>
-        </mediaobject>
-	</screenshot>
   </section>
   <section>
     <title>Thematic mapping</title>
@@ -45,7 +45,7 @@
       <para>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.</para>
       <para>You may choose between legend types: <guimenuitem>automatic</guimenuitem> and <guimenuitem>predefined</guimenuitem>. 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 <guimenuitem>Equal intervals</guimenuitem> they will be “highest map value – lowest map value / number of classes”. Set to <guimenuitem>Equal group count</guimenuitem> the legend creator will try to distribute the organisation units evenly. Choose <guimenuitem>Fixed bounds </guimenuitem>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 section 1.5.</para>
       <para>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.</para>
-      <para>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 section 1.4.</para>
+      <para>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 section 3.1.</para>
       
       <para>All available layer options are now grouped together in the thematic layer menu, see picture below.</para>
       <screenshot>