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

Lesson 2.1: Add Layers to GeoSHAPE
1. Click the Data tab on the menu bar and Select the Upload Layer menu item 2. Browse to the folder on your local machine which has the data you wish to upload 3. 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 visible the prefered basemap by clicking the Toggle Visibility button.

Synchronization from a remote instance
Merge two repos