Hydrological drought connectedness (HDC)

'HDC' is a GitHub repository containing instructions to reproduce results from the "Spatially Compounding Drought Events in Brazil" published in the Water Resources Research Journal - Gesualdo et al., (2024).

Publication reference

Gesualdo, G. C., Benso, M. R., Mendiondo, E. M., & Brunner, M. I. (2024). Spatially compounding drought events in Brazil. Water Resources Research, 60, e2023WR036629.https://doi.org/10.1029/2023WR036629

Code reference

Gesualdo, G., Benso, M., Kobayashi, A., & Zamboni, P. (2024). gabichiquito/Hydrological-drought-connectedness: v1.0. Zenodo. https://doi.org/10.5072/zenodo.78438

Data references

Input data

| Dataset | Repository Link | DOI | |:-------------------:|:--------------------------------------------:|:--------------------------------:| | Original dataset - CABra | Link | | | Modify input data | Link | |

Output data

The output from hydrological drought extraction and connectedness are stored in the data repository linked below.

| Dataset | Repository Link | DOI | |:-------------------:|:-----------------------------------------------------------------------------:|:---------------------------------------:| |Hydrological drought extraction | Link|| |Hydrological drought connectedness | Link||

Reproduce our experiment

Clone this repository to get access to the notebooks used for Hydrological Drought Extraction and Connectedness. You'll also need to download the input files in link. Once you have the input dataset downloaded you can use the following notebooks to reproduce the analysis. For the Hydrological Drought Extraction, you should adjust the function variables movingwindow in number of days, threshvalue in flow percentile and min_dur, the drought minimal duration in days.

| Script Name | Description | |:------------------------------------------:|:--------------------------------------------------------------------------:| |Hydrologicaldroughtextraction.ipynb | Runs the hydrological drought extraction for each catchment | |Hydrologicaldroughtconnectedness.ipynb | Compute the hydrological drought connectedness |

Reproduce our figures

To reproduce the figures from our publication, use the following notebooks. Download the necessary input files from link

| Figure Name | Script Name | Description | |:--------------:|:------------------------------------------:|:------------------------------------------------------------------------------:| | Heatmap of Spearman's correlation |PLOTdroughtspearmansheatmap.ipynb | Reproduce the Heatmap of Spearman's correlation between drought characteristics and different catchment attributes| | Spatial distribution of drought characteristics |PLOTHydrologicaldroughtcharacteristics.ipynb | Reproduce the maps for spatial distribution for each drought characteristics| | Drought co-occurrence network | PLOTHydrologicaldroughtco-occurrenceNetwork.ipynb | Reproduce the map of the co-occurrence network. The lines represent drought connectedness between catchments, and the catchment nodes are colored according to the mean number of connected events a catchment experiences per year| | Drought similarity clusters | PLOTHydrologicaldroughtcluster.ipynb | Reproduce the map of drought similarity cluster, based on the hierarchical clustering| | Catchment attribute variability |PLOTHydrologicaldroughtcluster_attributes.ipynb | Reproduce the boxplot of drought and catchment attribute variability across drought similarity clusters|