Ghana Hub

This is a Data Hub instance for Ghana. It demonstrates the features of the Data Hub framework.

The Data Hub is a geographic information system (GIS) featuring a data fusion engine designed for data harmonization, alongside an interactive dashboard for effective data exploration and collaboration. Its key objective is to merge data of multiple formats and sources across temporal and spatial axes, allowing users to combine, analyze, and interpret the data.

Installation

• Clone the repository $ git clone git@github.com:datasnack/dh-ghana.git
• Copy the .env.example to .env: $ cp .env.example .env
• Open the .env file and make sure the following variables are set SECRET_KEY, DATAHUB_NAME (instructions are inside the .env file)
• Run $ docker compose up -d
• Wait/check until http://localhost:8000/ shows the Data Hub interface

After this you can start/stop the system with:

$ docker compose start
$ docker compose stop

If you change the .env file run the following command to apply the changes:

$ docker compose up -d

Now either import an existing data dump, or create a new instance.

For a setup with more focus to development and working with the source code of the datahub framework directly (instead of it beeing bundled in the Docker image), see the development information in the documention.

Import

We provide ready-to-use database export of the Ghana Hub that you can use to directly see and use the system without the need to download and process the raw data on your local machine.

Go to the releases page and download the latest *.dump file and place it in the ./data/ folder.

Run the following command from the root of the repository:

$ docker compose exec datahub python manage.py restore ./data/<downloaded *.dump file>

Finally, run the following command to create a new user with which you can log in into the backend (http://localhost:8000/admin):

$ docker compose exec datahub python manage.py createsuperuser

Create new

• Create admin user with $ docker compose exec datahub python manage.py createsuperuser
• Import prepared shape file with: $ docker compose exec datahub python manage.py loadshapes ./data/shapes/ghana.gpkg
• Import Data Layer specifications: $ docker compose exec datahub python manage.py import ./data/datalayerspec/datalayer.csv
• Import Data Layer data with:
  • $ docker compose exec datahub python manage.py datalayer <layer_key> download
  • $ docker compose exec datahub python manage.py datalayer <layer_key> process

Create dump

In case you need to export the data use: $ docker compose exec datahub python manage.py dump. An export file will be created in the ./data/ directory.

Customization

Create custom app to add new functionality and/or overload templates (i.e., start page).

mkdir ./src/<name>
docker compose exec datahub python manage.py startapp <name> ./src/<name>

Then add it in the .env to the key INSTALLED_USER_APPS (comma separated list) like src.<name>.

Finally, inside the created app in src/<name>/apps.py change name = <name> to name = src.<name>.

After that you need to rebuild/start the container with docker compose up -d.