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)
-
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.
-
Find existing or create new Indicator(s) ➡️ e.g. Number of armed conflict events, level of malnutrition, number of children etc
-
Import data for Indicator(s) ➡️ e.g. import one-time from Excel file, or add scheduled data harvesters (from SharePoint or API)
-
Find existing or add new Context Layer(s) ➡️ e.g. Armed conflict events, location of schools / hospitals / UNICEF offices, areas of control etc
-
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.
-
Click on your user icon (either upper right corner or, if you are in the admin panel - bottom left)
-
Click ➡️ Django admin
-
In Django, go to ➡️ Home ➡️ Core ➡️ Color palettes
-
Click ➡️ Add new color palette
-
Use the following sample configuration or use your own: Name: Red-Yellow-Green Diverging Colors: #d73027,#fc8d59,#fee08b,#ffffbf,#d9ef8b,#91cf60,#1a9850
-
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
-
Go to ➡️ Reference Datasets ➡️ Create New Reference Dataset
-
Provide name of your dataset (e.g. "Somalia Districts")
-
Click ➡️ Add new level
-
Change admin level name as needed (e.g. "District")
-
Click ➡️ Submit
-
Click ➡️ Import data (upper right corner)
-
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)
-
Select the column with name and unique code (Ucode)
-
Click ➡️ Submit
Create New Basemap¶
- Go to ➡️ Basemaps ➡️ Create New Basemap
- Use the following sample settings:
- Name: Open Street Map
- Url: https://a.tile.openstreetmap.org/{z}/{x}/{y}.png?noWrap=true
- Type: XYZ tile
- Category: create new Category (e.g. "Road Maps")
- click ➡️ Save
Create New Indicator¶
- Go to ➡️ Indicators ➡️ Create New Indicator
-
Use the following sample settings or create your own:
-
Name: Sample Indicator A
- Shortcode: SAMPLE_IND_A
- Category: Type in "TEST" and click Create "TEST"
-
You can leave other settings as default
-
Click ➡️ Save
Import Indicator Data¶
- Go to ➡️ Indicators ➡️ Find "Sample Indicator A" ➡️ Click Import data
- Use the following settings:
- Import type: Indicator Value
- Input format: Excel Long Format
- Go to ➡️ Attributes tab and use the following settings:
- Click ➡️ Choose file and select a file with indicator data: Sample Indicator A - sample data for Somalia
- Go to ➡️ Reference Layer & Time tab
- Click on ➡️ Reference Layer dropdown and select "Somalia Districts"
- For "Date Time Setting" use "Data-Driven Date" option and make sure that the "Date" field is selected with a proper Date Time format
- Click ➡️ Submit
- Preview data
- Once you see the "Success" message, click ➡️ See the data
- Save data
- Click ➡️ "Select all 148 data"
- Click ➡️ Save
Your data has been now imported to GeoSight.
Create new Dashboard¶
- Go to ➡️ Projects ➡️ Create New "Project"
- Use the following settings:
- View: "Somalia Districts"
- Name: "First Project"
- Go to Indicators:
- Click ➡️ Add Indicator
- Select "Sample Indicator A" and click ➡️ "Update Selection"
- Go to Indicator Layers:
- Click ➡️ Add Indicator Layer
- Choose "Single Indicator Layer"
- Select "Sample Indicator A" and click ➡️ "Apply Selection"
- Go to Basemaps:
- Click ➡️ Add Basemap
- Choose "Open Street Map" and click ➡️ "Apply Selection"
- Save the dashboard:
-
Click ➡️ Save
-
Preview your first GeoSight Dashboard:
- Click ➡️ Preview
- 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