Skip to content

Commit d48da82

Browse files
committed
Updated Changelog to match version
1 parent 7652936 commit d48da82

File tree

2 files changed

+31
-29
lines changed

2 files changed

+31
-29
lines changed

ChangeLog.md

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,21 @@ SPDX-FileContributor: Carsten Lemmen <carsten.lemmen@hereon.de>
99
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
1010
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
1111

12-
# Release notes for version 0.9.2 - ongoing
12+
# Release notes for version 1.0.1 (ongoing)
1313

14-
- cleaned git history
15-
- completed metadata
16-
- homogenized documentation
14+
- Cleanup of git history
15+
- Simulation results available as artifacts
16+
17+
# Release notes for version 1.0.0
18+
19+
- More omplete metadata
20+
- Homogenized documentation
21+
- Submission to the Journal of Open Source Software (JOSS)
22+
- Docker available at https://registry.hzdr.de/dam-elbextreme/oxypom/fabm:latest
1723

1824
# Release notes for version 0.9.1
1925

20-
- Feature-complete version of the OxyPOM, DiaMO, and light FABM models,
21-
- Test case for the Elbe estuary,
22-
- Implementation of Good Modeling Practices,
23-
- Rich software metadata.
26+
- Feature-complete version of the OxyPOM, DiaMO, and light FABM models,
27+
- Test case for the Elbe estuary,
28+
- Implementation of Good Modeling Practices,
29+
- Rich software metadata.

ReadMe.md

Lines changed: 17 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,34 +27,30 @@ Both are implemented in the `Fortran`-based Framework for Aquatic Biogeochemical
2727

2828
## Description
2929

30-
- `OxyPOM` simulates oxygen consumption and production in aquatic ecosystems [(Holzwarth and Wirtz, 2018)](https://doi.org/10.1016/j.ecss.2018.01.020) and resolves key biogeochemical processes as photosynthesis, respiration, mineralization, and nitrification.
30+
- `OxyPOM` simulates oxygen consumption and production in aquatic ecosystems [(Holzwarth and Wirtz, 2018)](https://doi.org/10.1016/j.ecss.2018.01.020) and resolves key biogeochemical processes as photosynthesis, respiration, mineralization, and nitrification.
3131

32-
- `DiaMO` is a simplification of `OxyPOM` useful when a complete representation of bio-geochemical dynamics is not needed,
32+
- `DiaMO` is a simplification of `OxyPOM` useful when a complete representation of bio-geochemical dynamics is not needed,
3333

3434
The code of these models is located in the directory `./src` (e.g., `./src/oxypom` and `./src/diamo`), and future code developed as part of this model should be here included.
3535

3636
Together with `OxyPOM` and `DiaMO`, this repository includes the model `oxypom/light`: a second order correction for the calculation of photosynthetically active radiation depth profiles.
3737

3838
## Requirements
3939

40-
- This model requires:
40+
- This model requires:
4141

42-
- `FABM` (v1 or above) available in [fabm github](https://github.com/fabm-model/fabm/).
43-
It can be cloned using `git clone https://github.com/fabm-model/fabm.git fabm`.
42+
- `FABM` (v1 or above) available in [fabm github](https://github.com/fabm-model/fabm/).
43+
It can be cloned using `git clone https://github.com/fabm-model/fabm.git fabm`.
4444

45-
- The physical driver:
46-
- `GOTM` (v6.0 latest stable release) available in [gotm github](https://github.com/orgs/gotm-model/repositories).
47-
It can be cloned using via `git clone --recursive https://github.com/gotm-model/code.git -b v6.0 gotm6`.
45+
- The physical driver:
46+
- `GOTM` (v6.0 latest stable release) available in [gotm github](https://github.com/orgs/gotm-model/repositories).
47+
It can be cloned using via `git clone --recursive https://github.com/gotm-model/code.git -b v6.0 gotm6`.
4848

4949
The following is not required to build and run the model but it is for running the test case:
5050

51-
- The script for downloading forcing and validation data requires the following shell commands:
51+
- The script for downloading forcing and validation data requires the shell commands `wget`, `unzip`, and `sed`.
5252

53-
- `wget`
54-
- `unzip`
55-
- `sed`
56-
57-
- The scripts for generating forcing files setup and plotting routines for model validation require: -`R` (v4.3 or above) available in [r home](https://www.r-project.org/) with the library [`ncdf4`](https://cran.r-project.org/web/packages/ncdf4/index.html) installed.
53+
- The scripts for generating forcing files setup and plotting routines for model validation require `R` (v4.3 or above) available in [r home](https://www.r-project.org/) with the library [`ncdf4`](https://cran.r-project.org/web/packages/ncdf4/index.html) installed.
5854

5955
## Testcases
6056

@@ -66,7 +62,7 @@ Currently, we include the testcase "Estuary".
6662

6763
This setup uses the physical driver `GOTM` to simulate the water column dynamics in the Elbe estuary in 2005-2024.
6864

69-
1. To run the testcase go to the directory `.\testcases`.
65+
1. To run the testcase go to the directory `./testcases`.
7066

7167
The model is build with the script `gotm-installation.sh`, in where these variables must be defined: - `GOTM_DIR` base directory of GOTM source code - `FABM_DIR` base directory of FABM source code - `OXYPOM_DIR` base directory of OxyPOM source code
7268

@@ -78,10 +74,10 @@ By default they are:
7874
export OXYPOM_DIR=$HOME/tools/oxypom/src
7975
```
8076

81-
2. The script `gotm-installation.sh` creates the directory `.\build` with the building files, and a copy of `gotm` executable in the `.\estuary` directory.
82-
Now move to the directory `.\estuary`.
77+
2. The script `gotm-installation.sh` creates the directory `./build` with the building files, and a copy of `gotm` executable in the `./estuary` directory.
78+
Now move to the directory `./estuary`.
8379

84-
3. The script `get_data.sh` download and unzip the forcing and validation data from [kuestendaten.de](https://www.kuestendaten.de) in a newly created directory `.\data`.
80+
3. The script `get_data.sh` download and unzip the forcing and validation data from [kuestendaten.de](https://www.kuestendaten.de) in a newly created directory `./data`.
8581
The downloaded files are used under license [DL-DE->Zero-2.0](https://www.govdata.de/dl-de/zero-2-0).
8682

8783
4. The script `setup_data.R` formatted the data to be read by `GOTM`. It generates the file `meteofile.csv`.
@@ -101,9 +97,9 @@ This setup uses the physical driver `GOTM` to simulate the water column dynamics
10197

10298
Follow steps 1-2 of the estuary testcase.
10399

104-
Now move to the directory `.\light`.
100+
Now move to the directory `./light`.
105101

106-
- The script `model_comparison.R` analyses the model output.
102+
- The script `model_comparison.R` analyses the model output.
107103

108104
If everything is correct, the figure `light_validation.png` should be produced.
109105
It displays a comparison of simulations using the default light implementation with the provided by `oxypom/light`.
@@ -124,7 +120,7 @@ We recommend to use latest git commit an branch main version of the model.
124120
We appreciate your feedback, bug reports and improvement suggestions on our GitLab [issue tracker](https://codebase.helmholtz.cloud/dam-elbextreme/oxypom/-/issues).
125121
We also welcome your contributions, subject to our Contributor Covenant [code of conduct](https://codebase.helmholtz.cloud/dam-elbextreme/oxypom/-/blob/main/doc/contributing/code_of_conduct.md) and our [Contributor License Agreement](https://codebase.helmholtz.cloud/dam-elbextreme/oxypom/-/blob/main/doc/contributing/contributing-license.md).
126122

127-
The best way to contribute is by (1) creating a fork off our repository, (2) committing your changes on your fork and then (3) creating a pull request ("PR") to push your changes back to us.
123+
The **best way to contribute** is by (1) creating a fork off our repository, (2) committing your changes on your fork and then (3) creating a pull request ("PR") to push your changes back to us.
128124

129125
To file an issue or to contribute, you are asked to (1) authenticate with an existing identity and (2) to register on the HIFIS GitLab instance and sign in.
130126
When asked, click "Sign in with Helmholtz AAI".

0 commit comments

Comments
 (0)