Skip to content

Quick Start

Quickstart

This section describes the key steps for preparing your first GeoSight dashboard and uploading sample data.

🗂️ Here are a few sample datasets that you can start with: - Sample admin boundary dataset - Somalia Districts (SHP) - Sample indicator data for Somalia districts (XLSX)

Quick Steps

  1. Find existing or create a new reference boundary dataset (e.g. world country boundaries or subnational boundaries for your country / region of interest). You can use either local dataset (uploaded to GeoSight) or connect to a dedicated app called GeoRepo.

  2. Find existing or create new Indicator(s) ➡️ e.g. Number of armed conflict events, level of malnutrition, number of children etc

  3. Import data for Indicator(s) ➡️ e.g. import one-time from Excel file, or add scheduled data harvesters (from SharePoint or API)

  4. Find existing or add new Context Layer(s) ➡️ e.g. Armed conflict events, location of schools / hospitals / UNICEF offices, areas of control etc

  5. Create a new Project ➡️ Add Indicators ➡️ Create Indicator Layers ➡️ Add Context Layers ➡️ Define Filters ➡️ Define Widgets ➡️ Share your Project

Basic Configurations (for Admins)

Before you start using GeoSight, you will need to configure some default GeoSight settings, e.g. color palettes.

  1. Click on your user icon (either upper right corner or, if you are in the admin panel - bottom left)

  2. Click ➡️ Django admin

  3. In Django, go to ➡️ Home ➡️ Core ➡️ Color palettes

  4. Click ➡️ Add new color palette

  5. Use the following sample configuration or use your own: Name: Red-Yellow-Green Diverging Colors: #d73027,#fc8d59,#fee08b,#ffffbf,#d9ef8b,#91cf60,#1a9850

  6. Click Save and go back to GeoSight admin panel

Create New Reference Dataset

Reference datasets are boundaries that will be used to visualize your indicator data. You can use either a local dataset (uploaded to GeoSight) or connect to a dedicated app called GeoRepo. In this section we will guide you how to upload a new Reference Dataset to GeoSight

  1. Go to ➡️ Reference Datasets ➡️ Create New Reference Dataset

  2. Provide name of your dataset (e.g. "Somalia Districts")

  3. Click ➡️ Add new level

  4. Change admin level name as needed (e.g. "District")

  5. Click ➡️ Submit

  6. Click ➡️ Import data (upper right corner)

  7. Drag and drop or click to browse for a file in one of these formats: .json, .geojson, .gpkg or a zip file containing a shapefile with administrative boundaries.

District Boundaries for Somalia (SHP)

  1. Select the column with name and unique code (Ucode)

  2. Click ➡️ Submit

Create New Basemap

  1. Go to ➡️ Basemaps ➡️ Create New Basemap

alt text

  1. Use the following sample settings:
  2. Name: Open Street Map
  3. Url: https://a.tile.openstreetmap.org/{z}/{x}/{y}.png?noWrap=true
  4. Type: XYZ tile
  5. Category: create new Category (e.g. "Road Maps")
  6. click ➡️ Save

alt text

Create New Indicator

  1. Go to ➡️ Indicators ➡️ Create New Indicator

alt text

  1. Use the following sample settings or create your own:

  2. Name: Sample Indicator A

  3. Shortcode: SAMPLE_IND_A
  4. Category: Type in "TEST" and click Create "TEST"

alt text

  1. You can leave other settings as default

  2. Click ➡️ Save

Import Indicator Data

  1. Go to ➡️ Indicators ➡️ Find "Sample Indicator A" ➡️ Click Import data

alt text

  1. Use the following settings:
  2. Import type: Indicator Value
  3. Input format: Excel Long Format

alt text

  1. Go to ➡️ Attributes tab and use the following settings:
  2. Click ➡️ Choose file and select a file with indicator data: Sample Indicator A - sample data for Somalia

alt text

  1. Go to ➡️ Reference Layer & Time tab
  2. Click on ➡️ Reference Layer dropdown and select "Somalia Districts"
  3. For "Date Time Setting" use "Data-Driven Date" option and make sure that the "Date" field is selected with a proper Date Time format
  4. Click ➡️ Submit

alt text

  1. Preview data
  2. Once you see the "Success" message, click ➡️ See the data

alt text

  1. Save data
  2. Click ➡️ "Select all 148 data"
  3. Click ➡️ Save

alt text

Your data has been now imported to GeoSight.

Create new Dashboard

  1. Go to ➡️ Projects ➡️ Create New "Project"

alt text

  1. Use the following settings:
  2. View: "Somalia Districts"
  3. Name: "First Project"

alt text

  1. Go to Indicators:
  2. Click ➡️ Add Indicator
  3. Select "Sample Indicator A" and click ➡️ "Update Selection"

alt text

  1. Go to Indicator Layers:
  2. Click ➡️ Add Indicator Layer
  3. Choose "Single Indicator Layer"
  4. Select "Sample Indicator A" and click ➡️ "Apply Selection"

alt text

  1. Go to Basemaps:
  2. Click ➡️ Add Basemap
  3. Choose "Open Street Map" and click ➡️ "Apply Selection"

alt text

  1. Save the dashboard:
  2. Click ➡️ Save

  3. Preview your first GeoSight Dashboard:

  4. Click ➡️ Preview

alt text

  1. Your final dashboard:

alt text

How to prepare data for GeoSight?

In GeoSight users can import data from multiple sources:

  • APIs (JSON)
  • Excel files
  • SharePoint Excel
  • SDMX Data Warehouse (coming soon)

The easiest way is to import data using standalone Excel file.Excel import supports two formats:

  • LONG and
  • WIDE

Excel Long and Wide formats

Excel LONG format

  • Can be used to import multiple indicators, geographies (e.g. districts) and dates in one go
  • Required columns:
  • GeographyCode – contains unique code for identifying a geographic entity (e.g. district). NOTE: currently geographic entities must be from a single admin level
  • IndicatorCode – should match the Indicator’s shortcode as defined in GeoSight
  • DateTime – valid date, e.g. 01-01-2022
  • Value – observation value

Excel WIDE format

  • Can be used to import multiple indicators, geographies (e.g. districts) for a single date only
  • Required columns:
  • GeographyCode – Contains unique code for identifying a geographic entity (e.g. district). NOTE: currently geographic entities must be from a single admin level
  • Indicator columns – name of each column should match the Indicator’s shortcode as defined in GeoSight
  • Value – observation value