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)

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

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

Create New Indicator¶

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

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"

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

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

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

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

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

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

Your data has been now imported to GeoSight.

Create new Dashboard¶

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

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

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

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

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

1. Save the dashboard:

2. Click ➡️ Save

3. Preview your first GeoSight Dashboard:

4. Click ➡️ Preview

1. Your final dashboard:

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 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