Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DrylandEcology/SOILWAT2
An ecosystem water balance simulation model
https://github.com/DrylandEcology/SOILWAT2
Last synced: 3 months ago
JSON representation
An ecosystem water balance simulation model
- Host: GitHub
- URL: https://github.com/DrylandEcology/SOILWAT2
- Owner: DrylandEcology
- License: gpl-3.0
- Created: 2013-04-19T18:11:54.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2024-03-14T16:41:26.000Z (8 months ago)
- Last Synced: 2024-04-15T08:49:24.205Z (7 months ago)
- Language: C
- Homepage:
- Size: 7.82 MB
- Stars: 5
- Watchers: 4
- Forks: 2
- Open Issues: 59
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- open-sustainable-technology - SOILWAT2 - An ecosystem water balance simulation model. (Hydrosphere / Freshwater and Hydrology)
README
[![gh nix build status][1]][2]
[![gh win build status][3]][2]
[![github release][5]][6]
[![DOI][7]][8]
[![license][9]][10]
[![codecov status][11]][12]
[![doc status][4]][2][1]: https://github.com/DrylandEcology/SOILWAT2/actions/workflows/main_nix.yml/badge.svg?branch=master
[2]: https://github.com/DrylandEcology/SOILWAT2/actions/workflows
[3]: https://github.com/DrylandEcology/SOILWAT2/actions/workflows/main_win.yml/badge.svg?branch=master
[4]: https://github.com/DrylandEcology/SOILWAT2/actions/workflows/check_doc.yml/badge.svg?branch=master[5]: https://img.shields.io/github/release/DrylandEcology/SOILWAT2.svg
[6]: https://github.com/DrylandEcology/SOILWAT2/releases
[7]: https://zenodo.org/badge/9551524.svg
[8]: https://zenodo.org/badge/latestdoi/9551524
[9]: https://img.shields.io/github/license/DrylandEcology/SOILWAT2.svg
[10]: https://www.gnu.org/licenses/gpl.html
[11]: https://codecov.io/gh/DrylandEcology/SOILWAT2/branch/master/graph/badge.svg
[12]: https://codecov.io/gh/DrylandEcology/SOILWAT2[SOILWAT2]: https://github.com/DrylandEcology/SOILWAT2
[rSOILWAT2]: https://github.com/DrylandEcology/rSOILWAT2
[STEPWAT2]: https://github.com/DrylandEcology/STEPWAT2
[issues]: https://github.com/DrylandEcology/SOILWAT2/issues
[pull request]: https://github.com/DrylandEcology/SOILWAT2/pulls
[doxygen]: https://github.com/doxygen/doxygen
[netCDF]: https://downloads.unidata.ucar.edu/netcdf/
[udunits2]: https://downloads.unidata.ucar.edu/udunits/
# SOILWAT2
SOILWAT2 is an ecosystem water balance simulation model.
This repository of `SOILWAT2` contains the same code that is
used by [rSOILWAT2][] and [STEPWAT2][].If you utilize this model, please cite appropriate references, and we would
like to hear about your particular study (especially a copy of any published
paper).Some references
* Bradford, J. B., D. R. Schlaepfer, and W. K. Lauenroth. 2014. Ecohydrology of
adjacent sagebrush and lodgepole pine ecosystems: The consequences of climate
change and disturbance. Ecosystems 17:590-605.
* Palmquist, K.A., Schlaepfer, D.R., Bradford, J.B., and Lauenroth, W.K. 2016.
Mid-latitude shrub steppe plant communities: climate change consequences for
soil water resources. Ecology 97:2342–2354.
* Schlaepfer, D. R., W. K. Lauenroth, and J. B. Bradford. 2012. Ecohydrological
niche of sagebrush ecosystems. Ecohydrology 5:453-466.
## Table of contents
1. [How to get started](#get_started)
1. [Compilation](#compile)
2. [Documentation](#get_documentation)
2. [How to contribute](#contribute)
SOILWAT2 comes with a
[detailed manual](doc/additional_pages/A_SOILWAT2_user_guide.md)
and short overviews of
[inputs](doc/additional_pages/SOILWAT2_Inputs.md)
and [outputs](doc/additional_pages/SOILWAT2_Outputs.md).
A full code documentation may be built, see [here](#get_documentation).
### Compilation
* Requirements:
- the `gcc` or `clang/llvm` toolchains compliant with `C99`
- for unit tests (using `googletest`)
- toolchains compliant with `C++14`
- `POSIX API`
- GNU-compliant `make`
- On Windows OS: an installation of `cygwin`
- the `netCDF-C` library (if compiled with [netCDF][] support)
- the `udunits2` library (if compiled with [udunits2][] support)* Clone the repository
(details can be found in the
[manual](doc/additional_pages/A_SOILWAT2_user_guide.md)), for instance,
```{.sh}
git clone --recursive https://github.com/DrylandEcology/SOILWAT2.git SOILWAT2
```* Build with `make` (see `make help` to print information about all
available targets). For instance,
```{.sh}
make # text-based mode
CPPFLAGS='-DSWNETCDF -DUDUNITS2' make # netCDF-based mode with units
```
### Documentation
* Use [doxygen][] to generate help pages (locally) on the command-line with
`make doc` (which basically runs `doxygen doc/Doxyfile`)* View documentation in your browser with `make doc_open`
## How to contribute
You can help us in different ways1. Reporting [issues][]
2. Contributing code and sending a [pull request][]Thank you!
Please follow our code development and contribution guidelines
[here](doc/additional_pages/code_contribution_guidelines.md)