Training Material for UN Open GIS Spiral 1

Introduction
The OSGeo UN Committee promotes the development and use of open source software that meets UN needs and supports the aims of the UN. Following a meeting between OSGeo Board of Directors and the UN GIS team at FOSS4G in Seoul, Korea in September 2015, the Committee has mainly worked on the UN Open GIS Initiative, a project “...to identify and develop an Open Source GIS bundle that meets the requirements of UN operations, taking full advantage of the expertise of mission partners including partner nations, technology contributing countries, international organisations, academia, NGOs, private sector. The strategic approach shall be developed with best and shared principles, standards and ownership in a prioritized manner that addresses capability gaps and needs without duplicating efforts of other Member States or entities. The UN Open GIS Initiative strategy shall collaboratively and cooperatively develop, validate, assess, migrate and implement sound technical capabilities with all the appropriate documentation and training that in the end provides a united effort to improve the effectiveness and efficiency of utilizing Open Source GIS around the world.” (more details at [ https://wiki.osgeo.org/wiki/UnitedNations_Committee]).

Purpose of this document
This educational material is designed as a step-by-step software learning guide for the users of the UN GeoSHAPE platform for data collection. Geoshape is a free and open source geospatial platform created from various open source projects. You can visit www.geoshape.org for more information. This Quick Start provides a guide on how to 1. Create, edit and share critical data on an integrated dynamic map in near real time. 2. View map updates by users from anywhere in the world and 3. Use GeoSHAPE exchange in connected and disconnected environments.The training material is intended to provide all the materials needed to run a 5 day course on UN GeoSHAPE platform for data collection. The course is structured with content to suit novice, intermediate and advanced users.

Target Audience
The primary target audience is, therefore, professionals at local, regional, national or international agencies especially those in developing countries.

License
This educational material has been authored by Ketty Adoch under the framework of the UN OSGeo Challenge, with the mentorship of Christina Hupy from Boundless who sponsored the production of this material. The material is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.

Module 1: Core Concepts

 * Vector Data: It is the type of map data that is represented as points, lines, polygons on the map.
 * Raster Data: It is any sort of pixel data or digital image where each pixel corresponds to a continuous location or area on the earth’s surface.
 * Coordinate Reference Systems: CRS or SRS (Spatial Reference System) are used to describe real-world positional locations on a map.
 * Map projection: Map projection is the systematic transformation (mathematical computation) that can be used to project a point represented as latitude, longitude on the surface of a sphere into locations on a plane.
 * Rendering: Rendering to tiles refers to the process of drawing vector or raster data to a png or jpeg which can then be sent to a web or mobile client (web-browser, or mobile app).
 * Development: Developers build web applications on top of a web stack which is comprised of an operating system (usually in reference to the server’s operating system), programming language(s) for client and server side code, a database, and a server (such as Apache or IIS).
 * Web stack and Web Applications: The web-client application refers to the main portion of the web application that a user interfaces with from a browser. The client-side portion of the application talks to the server (requests and sends data), performs rendering and any client-side calculations.

Module 2: Components of GeoSHAPE Exchange for data collection
GeoSHAPE is the integration of a geospatial portal (GeoNode), a web mapping client (MapLoom), and a mobile application (UN AnyWhere)
 * Geonode: GeoNode is the main user facing web application and geospatial portal.
 * Maploom: Maploom is the web mapping client which has been embedded in Geonode. Maploom allows you to view, create and edit geospatial features. It also supports connecting to any other server that supports OGC standards: wms, wfs, wcs.
 * GeoServer: GeoServer sits behind GeoNode and serves all the vector and raster data. You can directly interact with Geoserver by going to the following endpoint and using the admin credentials used in GeoNode: https:///geoserver
 * GeoGig: Geoserver supports numerous datastores one of which is postgres/postgis. During upload, you can choose to upload your layer into a GeoGIG datastore instead of PostGIS. Geogig is a distributed version control system inspired by Git/Github which has been designed for Geospatial vector data.
 * UN AnyWhere: UN AnyWhere is an Android mobile application which is designed to work with GeoSHAPE. The GeoSHAPE server can work without being connected to the internet and each mobile device can also work without being connected to the GeoSHAPE server.
 * Tileset: This is a package that contains all tiles (images) for an Area of Interest. For example, if you want to use UN AnyWhere in Yumbe, Uganda, your Area of interest will be the boundaries of Yumbe. The tileset will need to contain every single image at every zoom level. There are typically 18 zoom levels.

Open the Geoshape web page by typing the domain name or ip address in the web browser and login. The Sample data that accompanies this resource is freely available and comes from the following sources:

(​http://www.openstreetmap.org/​) (​http://www.data.ug/​)
 * Water Point data from OpenStreetMap using the Overpass API
 * Administrative boundaries through downloading district boundary, from Data.ug
 * The combined sample data is in shapefile format and may be downloaded from here

Create New Map
1. Click the ‘Map’ tab on the menu bar and select ‘Create Map’ from the drop down menu



Add different layers for example from your server, other relevant servers or partners
2. Click the Add Layers (+) button in the Layer’s field.The Add Layers Window will open.You can then search for a layer of interest using the Title of the Layer as a Keyword.



3. Click from the listed records to select the layers of interest. In this example, two layers highlighted with the blue color, are selected.



4. Click ‘Add Layers’ to add the selected layers to the map. Information about the two layers is rendered on the new map.



Save the New Map with an appropriate name
5. Click the Save button in the Layers field and Enter an appropriate title and abstract for the New Map then click Save. The title makes your map discoverable when other users search for the map using the title.



Draw Geometry, Edit attributes of the new feature and Save
6. In this case, we want to add information to the Water point layer. Click the Zoom In (+) or Zoom Out (-) button on the right hand side of GeoShape Exchange page. We’ll add new water point data and edit attribute information, hence the need to Zoom In (+), such that the point is placed in the ‘right’ location. Click the Add feature button, Click the correct location on the map.



7. Click the Accept feature button and go on to Edit the attributes of the new feature. Or Click the Cancel feature button to remove the added feature.



8. Click the feature to view feature information embedded in a pop up window. Additional options include; Use the feature in a spatial filter, View Table, Show History, Edit Attributes, Edit Geometry and Delete Feature.



Show/Hide layers
9.Toggle Visibility function allows you to turn a layer’s display on and off without having to delete the layer from the map. Click the ‘Toggle Visibility’ button to Show or Hide layers.



Lesson 2.1: Add Layers to GeoSHAPE

 * Click the Data tab on the menu bar and Select Upload Layer menu item
 * Browse to the folder on your local machine which has the data you wish to upload
 * Select all files or select the zip file



3.Click the choose file(s) button and then select the dataset of interest. In this case, select the drinking_water file and then Click Open.



4. Click the drinking_water.shp file under Manage your data and then Click the Create Layer button at the bottom of the window which pops-up.



5. Manage your data by filling in an appropriate title, a category and description. Click Continue.



6. If your layer has an attribute for time configuration; either start and end time or both and you’d like to enable the playback feature, select Yes. Otherwise, select No.



7. Enabling version control allows you to see the history of changes for a layer and who made them. Select Yes to enable version control. Otherwise select No.



8. Click either the Everyone or Just Me button to determine who is able to view your layer.



9. Review the Configuration and Click the Start Import button to start uploading the layer.



10. If the Import is successful, you’ll see the screen below. You can then view the uploaded layer by clicking the View Layer button.



11. Once you click the View Layer link above, the Layer Information page opens. Here, you can:
 * Download the Layer
 * View Metadata detail
 * Edit Layer
 * See the list of maps using the layer
 * Create a Map
 * See the list of styles associated with this layer
 * Change layer permissions
 * See the Owner of the layer, the point of contact, the metadata author

12. Additionally, you can:
 * View the layer attributes
 * Layer Ratings
 * Layer Comments
 * Layer History in Geogig



Change basemap
1. The option to change basemap is accessed under the Layers list. Click the Layers list. You can make the prefered basemap visible by clicking the Toggle Visibility button.



2. Click the Toggle Visibility button on the MapBox Satellite layer to change the basemap from OpenStreetMap to MapBox Satellite. You’ll see a new basemap, as shown in the screenshot below.



Searching
1. By typing the name of a place of interest in the search bar, you are able to locate the  place on a map. For instance, search for a place in Uganda called ‘Yumbe’, by typing the place name in the search bar. Click the Search button in the search bar.



2. The search results will show three different places called Yumbe. Select your prefered place of interest by Clicking one of the places listed in the search results. You’ll notice two yellow points appear on the map.



3. Click one of the yellow points on the map to view more location information like the coordinates, the bounding box. You are also able to pin the the search result in the layer list.



View the history of a feature/layer


2.The notifications about a feature can also be viewed when you click the Notifications button.



Managing Conflicts
1. Conflicts may arise when the same data is edited by different users. To resolve a conflict, perform a refresh of data snapshot by clicking the refresh icon on the top left hand side of map such that the data in your server is up to date.

Lesson 2.1.2: Synchronizing with other repos and distributed servers
There are four ways to synchronize with new data sources;
 * Refresh layers after editing
 * Synchronizing to get data from a partner organisation
 * Synchronizing from a remote instance
 * Merge two repositories

Refresh layers after editing
1. To create new features, follow Lesson 1: Draw Geometry, Edit attributes of the new feature and Save 2. Click the Refresh button to update the layers



Synchronization from the server of a partner organisation
1. Open the Synchronization options by Clicking the Synchronization button found on the top left hand side of the map.



2. Click the Add Sync button, the window below will open. Under Name, you can type the link to a different server, or another GeoSHAPE instance of another organisation. Under Repo, specify the user repo, which defaults to the master repo. Under Remote, specify the remote repository, which defaults to the repository from the partner organisation.

3. Click Add, to include these settings in your GeoSHAPE instance.



Synchronization from a remote instance
1. A remote instance may be another of the GeoSHAPE instances you use to manage data and operations. Under synchronization, Click the Remote Options button.



2. The Remote Config window will open. In this window, specify the user/local Repo. Also specify the Remote option. Under Remote Name, type the name of the remote repo and under URL, type the url of the remote repo. Lastly, provide the Username and Password for authentication. Click Save to keep and effect the settings.



Merge two repos
1. For scenarios where it is recommended to create a single repo from two repositories, this synchronization option can be employed. Click the Merge button under the synchronization options. The Merge window will open. Specify the required settings and click MergeBold text to effect the buttons.