Skip to content

D-FCV Co-location Mapping: an open‑source, globally applicable toolkit for rapid mapping and assessment of multi‑hazard and conflict exposure in FCV countries at subnational scales.

License

Notifications You must be signed in to change notification settings

GFDRR/disaster-fcv-colocation-mapping

Repository files navigation

Disaster-FCV Co-location Mapping

Mapping Multi-hazard and Conflict Co-location in Fragile, Conflict, and Violence (FCV)-affected Countries

About the Project

We've developed an open‑source, globally applicable toolkit for the rapid mapping and assessment of multi‑hazard and conflict exposure at subnational scales. This toolkit uses globally accessible hazard maps and conflict data to map the spatial distribution of co-occurring multi-hazard and conflict exposure. Our work is designed to guide high-level, evidence-based DRM decision-making in FCV contexts and enable them to efficiently identify priority areas for more strategic resource allocation at the Disaster–FCV nexus.

Table of Contents

  1. Installation
  2. Accessing ACLED
  3. Installing OGR/GDAL
  4. Getting Started
  5. Contributing
  6. License
  7. References
  8. Citation

Installation

pip install dfcv-colocation-mapping

Accessing ACLED

To access ACLED conflict data, you must register for an ACLED API Key. Please refer to the official ACLED Access Guide for instructions.

Installing OGR/GDAL

The simplest way to install OGR/GDAL is to execute the following command:

conda install gdal

Alternatively, if you're using Linux, run the command:

apt install gdal-bin

For more information on how to install OGR/GDAL, see this guide.

Getting Started

Demo Notebook

Open In Colab

Example Usage

At minimum, you will need to specify the country's ISO code and administrative level (e.g. ADM1, ADM2, etc.). If you have an ACLED API key, you may also specify it here.

from dfcv_colocation_mapping import data_download
from dfcv_colocation_mapping import map_utils

dm = data_download.DatasetManager(
    iso_code="RWA", 
    adm_level="ADM3",
    acled_key=ACLED_API_KEY,
    acled_email=ACLED_EMAIL,
)
geoplot = map_utils.GeoPlot(dm)

AHP Calculation [Optional]

For the calculation of the Multi-hazard Score (MHS), you can generate custom weights per hazard using Analytic Hierarchy Process (AHP), as implemented in AHPy.

dm.calculate_ahp()

Geoboundaries Map

geoplot.plot_geoboundaries(
    adm_level="ADM2", 
    group="ADM1",
)

geoboundaries

Hazard Raster Map

geoplot.plot_raster("earthquake")

raster

Choropleth Map

geoplot.plot_choropleth("earthquake_worldpop_exposure_relative")

choropleth

Choropleth Map Zoomed

geoplot.plot_choropleth(
    var=f"wbg_acled_worldpop_exposure_relative",
    zoom_to={"ADM1: "Lumbini"},
)

choropleth

Bi-variate Choropleth Map

geoplot.plot_bivariate_choropleth( 
    var1="wbg_acled_worldpop_exposure_relative",
    var2="mhs_worldpop_exposure_intensity_weighted_relative"
)

choropleth

Bi-variate Choropleth Map Zoomed

geoplot.plot_bivariate_choropleth( 
    var1="wbg_acled_worldpop_exposure_relative",
    var2="mhs_worldpop_exposure_intensity_weighted_relative",
    zoom_to={"ADM1: "Bagmati"},
)

choropleth

Data Sources

Administrative Boundaries

Asset Data

Conflict Data

Hazard Data

*RP = return period

Contributing

Interested in contributing? Check out the contribution guidelines at CONTRIBUTION.md.

License

Distributed under the Apache 2.0 License. See LICENSE.txt for more information.

References

  • GADM, https://gadm.org
  • WorldPop, www.worldpop.org
  • geoBoundaries, https://www.geoboundaries.org
  • Runfola, D. et al. (2020) geoBoundaries: A global database of political administrative boundaries. PLoS ONE 15(4): e0231866. https://doi.org/10.1371/journal.pone.0231866
  • ACLED, “Armed Conflict Location & Event Data (ACLED) Codebook,” 3 October 2024. www.acleddata.com.
  • Clionadh Raleigh, Roudabeh Kishi, and Andrew Linke, “Political instability patterns are obscured by conflict dataset scope conditions, sources, and coding choices,” Humanities and Social Sciences Communications, 25 February 2023. https://doi.org/10.1057/s41599-023-01559-4
  • Davies, S., Pettersson, T., Sollenberg, M., & Öberg, M. (2025). Organized violence 1989–2024, and the challenges of identifying civilian victims. Journal of Peace Research, 62(4). https://ucdp.uu.se/downloads
  • Sundberg, Ralph and Erik Melander (2013) Introducing the UCDP Georeferenced Event Dataset. Journal of Peace Research 50(4).
  • Bondarenko M., Kerr D., Sorichetta A., and Tatem, A.J. 2020. Census/projection-disaggregated gridded population datasets, adjusted to match the corresponding UNPD 2020 estimates, for 183 countries in 2020 using Built-Settlement Growth Model (BSGM) outputs. WorldPop, University of Southampton, UK. doi:10.5258/SOTON/WP00685
  • K. Johnson, M. Villani, K. Bayliss, C. Brooks, S. Chandrasekhar, T. Chartier, Y. Chen, J. Garcia-Pelaez, R. Gee, R. Styron, A. Rood, M. Simionato, M. Pagani (2023). Global Earthquake Model (GEM) Seismic Hazard Map (version 2023.1 - June 2023), DOI: https://doi.org/10.5281/zenodo.8409647
  • United Nations Office for Disaster Risk Reduction (UNDRR) (n.d.). Global model of cyclone wind 50, 100, 250, 500 and 1000 years return period. Humanitarian Data Exchange (HDX). https://data.humdata.org/dataset/cyclone-wind-100-years-return-period
  • The World Bank Group (n.d.). Global landslide hazard map. World Bank Data Catalog. Creative Commons Attribution-Non Commercial 4.0 license. https://datacatalog.worldbank.org/search/dataset/0037584
  • National Integrated Drought Information System (NIDIS) (n.d.). Drought.gov Data Download (GIS and Web-Ready) [web page]. U.S. Drought Portal. https://www.drought.gov/data-download
  • Zhiwei Yang, Jian Peng, & Yanxu Liu. (2023). GloUTCI-M: A Global Monthly 1 km Universal Thermal Climate Index Dataset from 2000 to 2022 [Data set]. Zenodo. https://doi.org/10.5281/zenodo.8310513
  • Yang, Z., Peng, J., Liu, Y., Jiang, S., Cheng, X., Liu, X., Dong, J., Hua, T., and Yu, X.: GloUTCI-M: A Global monthly 1 km Universal Thermal Climate Index dataset from 2000 to 2022, Earth Syst. Sci. Data, 16, 2407–2424, https://doi.org/10.5194/essd-16-2407-2024, 2024.

Citation

@misc{tingzon2025mapping,
  title={Mapping Multi-hazard and Conflict Co-location in Fragile, Conflict, and Violence (FCV)-affected Countries},
  author={Tingzon, Isabelle},
  year={2025},
  organization={The World Bank Group},
  type={Tutorial},
  howpublished={\url{https://github.com/GFDRR/disaster-fcv-colocation-mapping}}
}

About

D-FCV Co-location Mapping: an open‑source, globally applicable toolkit for rapid mapping and assessment of multi‑hazard and conflict exposure in FCV countries at subnational scales.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages