Skip to content

SAEONData/global-disasters

Repository files navigation

EM-VIEW: A Community Dashboard for EM-DAT Data

Preview

EM-VIEW is a Streamlit web application designed to visualize the EM-DAT International Disaster Database XLSX datasets.

The dashboard features multiple analytical views:

  • Metric view – key impact indicators by disaster type
  • Table view – full dataset exploration with column filtering
  • Map view – global and regional impact maps by country
  • Time view – yearly-aggregated impact timelines

You can download EM-DAT data by registering at the
EM-DAT Public Data Portal.


⚠️ Origin and Contributions

🧾 This repository is an adaptation of an original open-source EM-VIEW implementation
by the EM-DAT team. The initial version was developed under the EM-DAT project with support from USAID.
SAEON (South African Environmental Observation Network) contributed modifications to:

  • Adapt the interface for local/regional analysis
  • Introduce PostgreSQL as a backend source
  • Add Docker and Dev Container support for streamlined deployment

We do not claim authorship of the original codebase — only the enhancements made in this forked version.


🚀 Run the App via Dev Container (Recommended for VSCode)

This project is fully configured for use with Visual Studio Code + Dev Containers.

✅ Requirements

  • Docker (or Podman) installed
  • VSCode + Dev Containers extension

▶️ To start

  1. Open the folder in VSCode
  2. Reopen in Dev Container when prompted
  3. Once container is ready, run:
streamlit run app.py

Access the app at http://localhost:8501


🐳 Run with Docker Compose (Alternative)

docker compose up --build

You can customize database credentials via .env.


🔧 Manual Setup (non-container users)

If not using Docker or Dev Containers:

1. Install Dependencies

pip install -r requirements.txt

2. Run App

streamlit run app.py

📄 License

MIT — see LICENSE file.
Note: This license covers only the software in this repository.
The EM-DAT dataset itself is governed by separate EM-DAT Terms of Use.


🙏 Acknowledgement

Original EM-VIEW development was led by the EM-DAT team with support from USAID.
This adapted version includes contributions by SAEON for deployment and integration enhancements tailored to regional use cases in Southern Africa.

About

Adapted EM-VIEW Streamlit dashboard with SAEON regional enhancements

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •