Online User Help

The GSDM web interface is the primary method of interacting with GSDM as a user. From this interface, view existing soil maps, carry out sampling design, local map adaptation, and download outputs.

For more information about sampling design and local map adaptation methods see this document.

  1. Navigate to the GSDM home page (online website available here):

    ../_images/home.png

    Home page

    This page shows description information about the GSDM application including the features provided. The satellite basemap is centered on sub-Saharan Africa.

  2. Open navigation menu.

    ../_images/menu.png

    The drop-down menu on the top-left corner provides links to open the different panels on the application.

  3. Open the Tools panel.

    ../_images/tools.png

    The Tools panel is accessed by clicking on the Tools link from the navigation menu. The Tools panel is organized into separate tabs to enable users to carry out different tasks. By default the Area of Interest tab is active.

  4. Draw Area of Interest

    ../_images/polygon.png

    Draw Polygon tool

    ../_images/rectangle.png

    Draw Rectangle tool

    An area of interest can be drawn by selecting either the polygon or rectangle button and drawing on top of the raster layer. A drawn feature can be deleted by clicking the delete button. The draw buttons are active when the draw on the map option is selected.

  5. Upload a zipped shapefile

    ../_images/uploader.png

    Uploader

    The Upload menu is activated when the Upload a zipped shapefile option as selected. A zip file containing all the shapefile extensions of the Area of Interest can be selected by clicking on the Choose File button. All user submitted data must be in EPSG:4326 projection with lat/long coordinates.

    ../_images/open_file.png

    The Open File window enables the selection of a file.

    ../_images/file_select.png

    File selected

    ../_images/upload_complete.png

    After selecting the file, click on the Upload button to upload. An Upload Complete message will alert a user when the upload operation is successful.

  6. View uploaded Area of Interest

    ../_images/view_aoi.png
  7. Select Administrative boundaries

    ../_images/countries.png

    The global administrative boundaries drop-down lists are enabled when the Administrative boundaries option is selected.

    ../_images/loading_country.png

    Boundary loading alert

    ../_images/algeria.png

    Once an administrative boundary is selected, it will be loaded on the map and lower levels enabled for selection.

  8. Select Soil Raster Layer.

    ../_images/select_layer.png

    The drop-down list contains the soil maps available in the application, a user can select one to view and use as a background map.

  9. View Soil Raster Layer.

    ../_images/layer.png

    The selected layer will be loaded on top of the base map for visualization.

  10. Sampling Design

    ../_images/sampling.png

    Sampling Design options are activated after selecting the Soil Raster Layer and Area of Interest. For Stratified Directed and Random Stratified, the user is required to define grid size or no. of samples.

    ../_images/running_sampling.png

    Process Running

    ../_images/complete_sampling.png

    Process complete

    ../_images/sampling_outputs.png

    Sampling design results

    ../_images/sampling_download.png

    Results in download link

    Results will be sent to the registered user email address once the analysis is complete.

  11. Local Map Adaptation

    ../_images/adaptation.png

    Local Map Adaptation options

    ../_images/adaptation_file.png

    Select sample data

    All user submitted data must be in EPSG:4326 projection with lat/long coordinates. For .txt files, latitude and longitude column field names should start with LAT* and LON* respectively.

    ../_images/adaptation_upload.png

    Upload complete

    ../_images/adaptation_samples.png

    View uploaded data

    ../_images/adaptation_running.png

    Process running

    ../_images/adaptation_complete.png

    Process complete

    ../_images/adaptation_feedback.png

    Feedback

    ../_images/adaptation_evaluation.png

    Evaluation

    ../_images/adaptation_download.png

    Results in download link

    Results will be sent to the registered user email address once the analysis is complete.

    NB: For every new analyis, please refresh the browser.

    How to cite GSDM-SSA

    Piikki K., Söderström M., Mutua J. (2019). Global Soil Data Manager – Sub-Saharan Africa (GSDM – SSA) [Web-application]. Swedish University of Agricultural Sciences (SLU), Skara, Sweden and International Center for Tropical Agriculture (CIAT), Nairobi, Kenya. Available at https://gsdm.online