=========================================
HydroMT-SFINCS: SFINCS plugin for HydroMT
|pypi| |conda_forge| |docs_latest| |docs_stable| |codecov| |license| |doi| |binder|
What is the HydroMT-SFINCS plugin?
HydroMT_ (Hydro Model Tools) is an open-source Python package that facilitates the process of
building and analyzing spatial geoscientific models with a focus on water system models.
It does so by automating the workflow to go from raw data to a complete model instance which
is ready to run and to analyse model results once the simulation has finished.
This plugin provides an implementation of the model API for the SFINCS_ model.
What is SFINCS?
SFINCS is Deltares' new open-source reduced-complexity model designed for super-fast modelling of compound flooding events in a dynamic way!
What HydroMT-SFINCS does provide is a powerful Python based set of tools to help you build and analyse the best possible SFINCS models!
This HydroMT-SFINCS plugin does not include the SFINCS model or executable itself, for that see the SFINCS download portal <https://download.deltares.nl/en/download/sfincs/>_
or the source code repository on Github <https://github.com/Deltares/SFINCS>.
For general documentation about the model, how to run it and what the input files are see the SFINCS documentation <https://sfincs.readthedocs.io/en/latest/>.
Why HydroMT-SFINCS?
Setting up hydrodynamic models typically requires many (manual) steps
to process input data and might therefore be time consuming and hard to reproduce.
Especially improving models based on global geospatial datasets, which are
rapidly becoming available at increasingly high resolutions, might be challenging.
HydroMT-SFINCS aims to make the model building process fast, modular and reproducible
and to facilitate the analysis of SFINCS model results
How to use HydroMT-SFINCS?
The HydroMT-SFINCS plugin can be used as a command line + configuration file application, which provides commands to build,
update the SFINCS model with a single line, or from python to exploit its rich interface.
You can learn more about how to use HydroMT-SFINCS in its online documentation. <https://deltares.github.io/hydromt_sfincs/latest/getting_started/intro>_
For a smooth installing experience we recommend installing HydroMT-SFINCS and its dependencies
from conda-forge in a clean environment, see installation guide. <https://deltares.github.io/hydromt_sfincs/latest/getting_started/installation>_
How to cite?
To reference the software please use the the DOI provided in the Zenodo badge that points to the latest release |doi|.
The following paper presents a real-world application of HydroMT-SFINCS:
Eilander, D., Couasnon, A., Leijnse, T., Ikeuchi, H., Yamazaki, D., Muis, S., Dullaart, J., Haag, A., Winsemius, H. C., and Ward, P. J.:
A globally applicable framework for compound flood hazard modeling, Nat. Hazards Earth Syst. Sci., 23, 823–846, https://doi.org/10.5194/nhess-23-823-2023, 2023.
Acknowledge our efforts when using SFINCS and HydroMT for your own work
When using SFINCS in your research or projects, please cite the relevant papers and the DOI of the release you used, and acknowledge Deltares, HydroMT-SFINCS, SFINCS and its open-source community.
SFINCS is brought to you by the collaborative efforts of the Deltares team and the wider SFINCS and HydroMT-SFINCS open-source, open-access community.
Developing excellent software takes significant time and effort, and funding, from Deltares and partners.
We greatly appreciate any acknowledgment and support from the community when using SFINCS in your work.
By doing research and projects together, involving us in papers and research proposals, getting help through SFINCS service contracts, following trainings, sharing bugfixes and improvements - we all benefit and contribute to the continued development and success of SFINCS.
We thank all contributors and users for their support and engagement with SFINCS, and we are very busy fulfilling our ambition:
Making the best, fit-for-purpose, fast open-source compound flood model – in the world!
How to contribute?
If you find any issues in the code or documentation feel free to leave an issue on the github issue tracker. <https://github.com/Deltares/hydromt_sfincs/issues>_
You can find information about how to contribute to the HydroMT project at our contributing page. <https://deltares.github.io/hydromt/latest/dev/contributing>_
HydroMT seeks active contribution from the (hydro) geoscientific community.
So far, it has been developed and tested with a range of Deltares <https://www.deltares.nl/en/>_ models, but
we believe it is applicable to a much wider set of geoscientific models and are
happy to discuss how it can be implemented for your model.
Acknowledgments
SFINCS is developed and maintained by Deltares, with contributions from the wider open-source community. We thank all contributors and users for their support and engagement with SFINCS.
In particular, we want to thank our special collaborators and user contributions by:
- Danish Coastal Authority
- USGS
- ONR
- CDR
- UCSC
- University of Cantabria
- IHE Cantabria
- Institute for Environmental Studies (IVM) of VU Amsterdam
- Rutgers University
- IHE Delft
- TU Delft
- IMDC
(We try to acknowledge all contributors, but apologize if anyone is missing - please let us know.)
Also, we want to thank our TKI Joint Industry project partners for their valuable contributions and collaboration:
- Svasek - HKV
- CDR
- Fathom
- IHE Delft
- UC Santa Cruz
- Guy Carpenter - Marsh RE
- IMDC
- Kystdirektoratet (Danish Coastal Authority)
- AON
- Covea
- Shelf Models
- CBCL
- The Water Institute
- Deltares
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
