Skip to main content
Ctrl+K
 - Home  - Home
  • Welcome to GEEST
  • About GEEST
  • User Guide
    • Installing GEEST
    • Navigation
      • Contextual
      • Accessibility
      • Place Characterization
      • Insights
    • Data Collection
  • Project Background
  • Acknowledgements
  • Training
  • Media

Additional Resources

  • Data Gap Analysis
  • Methodology Report
  • QGIS
  • Open Route Service

License & Citation

  • License
  • Citation
  • Repository
  • Suggest edit
  • Open issue
  • .md

Navigation

Contents

  • Accessing the Plugin
  • Project Setup
    • GEEST Project Selection
      • Additional Steps After Creating the Folder
  • Pre-Processing
    • 1. Verify the Project Folder Path
    • 2. Click the Right Arrow Button
    • 3. Overview of Next Steps
  • Processing Data Interface

Navigation#

The GEEST plugin interface is intuitive and easy to navigate. In this section, the streamlined workflow ensures an efficient transition from setup to core spatial analysis. For detailed instructions on each step, refer to the sections below.

Accessing the Plugin#


After installing the plugin, its interface should automatically appear:

Plugin Interface

  1. Locate the Toolbar Icon Toolbar Icon
    Find the plugin’s icon in the QGIS toolbar.

  2. Open the Plugin
    Click on the plugin’s toolbar icon to open its main window.

Project Setup#


Once the plugin window is open, press the right arrow buttons highlighted in red to navigate through the pages:

First Page Next Second Page Next

  • Welcome to GEEST Page: This is the introductory page of the plugin, providing an overview of its purpose and functionality. It serves as the starting point to familiarize users with the plugin’s capabilities and its relevance to geospatial analysis.

  • About Page: This page offers detailed information about the plugin, including its contributors, development background, and licensing. It highlights the open-source nature of the tool and acknowledges the organizations or individuals involved in its creation.

GEEST Project Selection#

In this step, you need to select a project folder to begin your work. The plugin provides you with two options:

Geest Project

Option 1: Open an Existing Project:
Select this option if you already have a project folder created previously. Choosing this will load the project along with all its associated files. Once loaded, press the right arrow button to proceed to the data input and processing interface for further analysis.

Open Geest Project

Option 2: Create a New Project:
Choose this option to start a new project. The plugin will guide you through creating a new folder that will store the GEEST project files and working analysis results for spatial processing.

New Geest Project

How to Create a New Folder

  • Click on Create or select a project directory (highlighted in red).

  • Navigate to the desired location on your system where you want to store the project.

  • Create a new folder and ensure it is empty.

  • Select the newly created folder and confirm your choice.


Important Considerations

  • ⚠️ Warning: Ensure the folder is empty. Using a folder with other files may lead to errors or accidental overwrites.

  • 💡 Tip: Use a descriptive name for the folder, incorporating details such as the name of the country or region you want to analyze and a timestamp. The timestamp could reflect either the time of the analysis process or the date of the input datasets. This will help you easily identify the folder for future reference and maintain better organization.

  • 🔒 Reminder: Ensure the folder is stored in a location with adequate storage space for analysis outputs. The contents of the selected folder will be managed by the plugin, ensuring proper organization of project-related files.


Additional Steps After Creating the Folder#

  • Select a Layer:

    • Click on the three dots button to choose a layer containing your Admin0 areas (country or region boundaries). The input layer must be in either SHP or GPKG format. Once selected, use the dropdown menu to specify the column that contains the names of the areas. Ensure the column is correctly populated to avoid errors during analysis.

  • Set the Analysis Cell Size:

    • Enter a value between 100m and 1000m:

      • Smaller values (e.g., 100m) will provide more detailed results but require longer processing times.

      • Larger values (e.g., 1000m) will reduce processing time but result in coarser outputs.

      • Note: The tool processes the study area by iterating through each polygon and generating a grid cell raster based on the selected cell size (ranging from 100m to 1000m). For each polygon, the following steps are performed:

        • The tool uses the raster bounding box associated with the polygon to generate the grid.

        • Areas marked as marine (C) pixels are excluded by assigning them a “NoData” value.

        • Land cells are assigned appropriate values to create a complete raster mask for the study area.

        • The resulting raster layers are stored in a dedicated directory, with files named according to the polygon’s name and part number (for multipart polygons).

      • ⚠️ Warning: Considering these operations, processing time may vary significantly, ranging from a few minutes to several tens of minutes, depending on the selected cell size and the size of the region being analyzed. To enhance the user experience, a progress bar displays the estimated remaining time until completion.

  • Download or select the road network: To conduct the analysis for the Accessibility dimension, a road network is required. The process uses geospatial area analysis based on road network data to evaluate accessibility. You can provide this data in two ways: either upload an existing road network or download it directly from OpenStreetMap (OSM) by clicking the Download from Open Street Map button. Once the download is complete, proceed by clicking the arrow in the bottom-right corner to continue.

New Geest Project


  • 💡 Tip: For larger regions or countries, it is recommended to start with a larger cell size for initial testing to ensure faster processing times. Once the initial results are satisfactory, refine the analysis by reducing the cell size to achieve greater detail. This approach will help you unlock the full potential of the tool and ensure accurate and detailed outputs.


  • Coordinate System Configuration:

    • If your boundary layer uses a valid projected CRS (e.g., UTM or EPSG:3857), select the checkbox Use Coordinate System of your boundary layer. This ensures that spatial calculations, such as distances and areas, are accurate and aligned with your layer’s CRS.


  • ⚠️ Note: This option is automatically disabled if the map units of your boundary layer are in degrees (e.g., EPSG:4326). Spatial analysis requires projected coordinate systems with units in meters for precision.

  • 💡 Tip: If your data uses geographic coordinates (latitude/longitude in degrees), reproject it to a projected CRS before proceeding with the analysis.


Pre-Processing#


Once you have completed all required inputs on the GEEST Project Creation screen, follow these steps to proceed:


1. Verify the Project Folder Path#

  • Ensure that the folder path displayed at the bottom of the interface is correct. This path indicates where the GEEST plugin will store analysis outputs and working files.

  • Example Path:
    C:/Work/GEEST/Analysis/Country/01152025


Important Notes:

  • The folder must be empty, containing no other files unrelated to the analysis.

  • Choose a descriptive name for the folder, as it will store critical project data.


2. Click the Right Arrow Button#

  • Locate the right arrow button at the bottom-right corner of the interface (highlighted in red in the image).

  • Clicking this button confirms all selected settings and initiates the first step of the processing workflow — splitting the study area into grids. After the area is successfully split into grids, the interface transitions to the Processing Data Interface, where you can initiate the main analysis.

Geest Project final

  • Now the process of splitting the area into grids has started, and a progress bar is displayed in the interface. Once completed, a report titled Study Area Report will open automatically. This report, along with all grid-splitting outputs, is saved in the project directory under the /study_area folder. This report summarizes the processing time and provides an explanation of each generated output, including: study area bounding boxes, polygons, grid cells and processing chunks.

Geest Project final


Key Considerations

  • ⚠️ Warning: Double-check your settings and input data before clicking the arrow. Any incorrect configuration could lead to errors during the processing stage.

  • 💡 Tip: Ensure that the analysis cell size and boundary layer are correctly configured to avoid unexpected results.


3. Overview of Next Steps#

After pressing the right arrow, the plugin will begin processing the input boundary layer by dividing it into a grid based on the specified cell size. During this step, the project folder will automatically populate with the generated outputs, including the study area split into grids, polygons, gridded areas, bounding boxes and other relevant data.

Once this pre-processing step is completed, you will seamlessly transition to the Processing Data Interface, where you can proceed with the core analysis workflows:

  1. The tool will generate outputs based on the inputs and configuration you’ve provided.

  2. View progress bars for analysis steps.

  3. Results will be saved in the selected project folder for further use.

Geest data processing

This marks the completion of the project setup and transition to the core analysis workflow.

Processing Data Interface#


The data processing interface serves as the central hub for managing, configuring, and processing inputs across multiple dimensions and factors within the project. This interface is designed to streamline workflows and provide users with a clear overview of the processing status. Below is a guide to understanding the key components of this interface:

Geest data processing

🖥️ Key Elements of the Interface

1. The Three Dimensions The interface organizes the analysis into three primary dimensions: Contextual, Accessibility, and Place Characterization.
2. Fifteen Factors Each dimension consists of factors representing the main themes of analysis.
3. Fourteen Subfactors Certain factors include subfactors for additional granularity.
4. Processing Status Widgets - 4a Configured, not run: Inputs are set up but processing has not started.
- 4b Required and not configured: Essential inputs are missing and need configuration.
- 4c Completed successfully: Processing finished without errors.
- 4d Workflow failed: The process encountered an error and requires troubleshooting.
- 4e Not configured (optional): Inputs are optional and not configured.
- 4f Excluded from analysis: Intentionally excluded factors or subfactors.
5. Run All/Run Incomplete - Run All: Executes all workflows, regardless of configuration or status.
- Run Incomplete: Focuses only on workflows that are incomplete.
6. Project Setup Pages The Project button opens setup pages to configure the project folder and analysis parameters.
7. Help Clicking the Help button redirects to the tool’s GitHub page for detailed documentation and support resources.

🗂️ Key Considerations

Consideration

Details

📁 Organize Your Folder

Ensure your project folder is empty before starting to avoid accidental overwrites.

🕒 Start with Large Cells

Begin with larger cell sizes for initial testing and refine later for greater detail.

🖥️ Monitor Progress

Use status widgets to track progress and troubleshoot errors promptly.

📖 Use Help Resources

Refer to the Help section or GitHub documentation for additional support.

By keeping these considerations in mind, you can ensure a smooth and efficient workflow while minimizing errors and maximizing the utility of the GEEST plugin.

previous

Installing GEEST

next

Contextual

Contents
  • Accessing the Plugin
  • Project Setup
    • GEEST Project Selection
      • Additional Steps After Creating the Folder
  • Pre-Processing
    • 1. Verify the Project Folder Path
    • 2. Click the Right Arrow Button
    • 3. Overview of Next Steps
  • Processing Data Interface

By Development Data Group

Last updated on Aug 11, 2025.

Country borders or names do not necessarily reflect the World Bank Group’s official position. All maps are for illustrative purposes and do not imply the expression of any opinion on the part of the World Bank, concerning the legal status of any country or territory or concerning the delimitation of frontiers or boundaries
All content (unless otherwise specified) is subject to the MIT License.