User Documentation - xmichael/igibs GitHub Wiki


This is the user documentation for the IGIBS WMS factory tool and the IGIBS mapping application. More information about igibs are available here.

There is a screencast available showcasing the steps involved in using the IGIS WMS Factory tool and the IGIBS mapping application from a browser.

Step 1 – File Upload ~~~~~~~~

Initially, the user has to prepare a compressed zip file with the data one wants to instantiate. The data can be any number of heterogeneous shape and/or geotiff files at different projections in any number of subdirectories. Most of the time, zipping one’s whole data product is enough to get started.

Once the user prepares the zip file, he can upload it in the IGIBS demo start-up screen. The application will attempt to ensure that the zip file and the data are not corrupted.

Once the file is uploaded it is analyzed for its properties and the browser is redirected to the page in step 2.

Step 2 – Probe Response

Once the user uploads the file, it is stored, unzipped and scanned for supported geospatial files. These files are aggressively probed to gather as much information about contained dataset as possible. Finally, a summary of the probe results are shown to the user in a dynamic interface to allow editing service metadata, layer styles (symbology) and target projection. Once the data are editted (s. screencast) the user can proceed to generate a WMS to serve these data.

The user to allowed to opt for a Shibboleth/SAML2 protected WMS. The resulting WMS will be part of an EDINA hosted Service Provider (SP), Identity Provider (IdP) and Federation.

The metadata editor can potential be configured to ask for information in the AGMAP 2.1 and GEMINI schemas which already provide a superset of the metadata fields that will ever be required by IGIBS. The application attempts to fill in initial values from the probing-step to direct the user as to how to fill in the metadata fields.

Finally the user can push the button as shown in the video to generate the URL of the his newly-created INSPIRE compliant WMS, reusable by any WMS 1.1.1/1.3.0 compliant WMS client.

Step 3 – Mapping Application

This step is optional. If the user does not have a desktop client available then he can use the IGIBS Mapping Application which is a web-based WMS client with Shibboleth support.

The demo has some additional functionality as it allows people to combine uploaded data with secure datasets available from the Welsh Assembly Government.

⚠️ ** Fallback** ⚠️