Overview | Why the Name? | Key Features | Getting Started | Contact Us | Disclaimer

Overview

DOMINO-SEE (Detection Of Multi-layer INterconnected Occurrences for Spatial Extreme Events) is a data-driven statistical framework for detecting spatially co-occurrences of hydroclimatic extreme events across locations, inspired by complex network science, powered by xarray architecture. It's developed by Hui-Min Wang and Xiaogang He from the PREP-NexT Lab at the National University of Singapore.

Why the Name?

The name DOMINO-SEE represents our approach to detecting and analyzing interconnected occurrences of hydroclimatic extreme events across spatial locations, inspired by the cascade effect of DOMINOes falling in a chain reaction. The SEE highlights the framework's ability to capture the spatial synchronization and propagation of extreme events, emphasizing the interconnectedness inherent in complex environmental systems.

Key Features

• Complex Network Generation: Fast and memory-efficient functions to build spatial networks from event series among spatial locations and multiple types (layers) of climate extreme events
• Multi-dimensional Support: Native support for xarray DataArrays to handle multi-dimensional gridded climate data
• Parallel Processing: dask integration for efficient processing of large-scale climate datasets
• Grid Generation: Equidistant Fekete grid generation for alternative spatial embedding.

Getting Started

This section includes a brief tutorial on running your first DOMINO-SEE model.

1. Clone the repo

   git clone https://github.com/PREP-NexT/DOMINO-SEE.git

2. Install the dependencies through conda

   cd DOMINO-SEE
   conda env create -f environment.yml
   conda activate dominosee

3. Install the package from source

   pip install -e .

Citing DOMINO-SEE

If you use DOMINO-SEE in a scientific publication, we kindly ask that you cite our article published in Nature Water:

Wang, H.-M., & He, X. (2025). Spatially synchronized structures of global hydroclimatic extremes. Nature Water. https://doi.org/10.1038/s44221-025-00520-w

You may also use the following BibTeX entry:

@article{wang_2025,
	title = {Spatially synchronized structures of global hydroclimatic extremes},
	issn = {2731-6084},
	url = {https://www.nature.com/articles/s44221-025-00520-w},
	doi = {10.1038/s44221-025-00520-w},
	urldate = {2025-10-29},
	journal = {Nature Water},
	author = {Wang, Hui-Min and He, Xiaogang},
	month = oct,
	year = {2025},
}

Contact Us

DOMINO-SEE is still under active development by Hui-Min Wang from the PREP-NexT Lab.

• If you're interested in suggesting new features or reporting bugs, please leave us a message on the issue tracker.

• If you have any questions, comments, or suggestions that aren't suitable for public discussion in Issues, please feel free to contact Hui-Min Wang.

Disclaimer

This project is licensed under the GNU General Public License 3.0. The DOMINO-SEE model is an academic project and is not intended to be used as a precise prediction tool for risk assessment and management. The developers will not be held liable for any decisions made based on the use of this model. We recommend applying it in conjunction with expert judgment and other modeling tools in a decision-making context.