oggm-standard-projection documentation added #1627
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
anoukvlug
reviewed
Aug 25, 2023
| @@ -1,4 +1,49 @@ | |||
| OGGM standard projections | |||
| ========================= | |||
|
|
|||
| TODO | |||
| Since OGGM v1.6.1, we provide what we like to call "standard projections" of OGGM. A detailed description of the experimental-setup, information on the data structure, analysis of the data and a `brief comparison to Rounce et al. (2023) together with the corresponding jupyter notebooks are in the `OGGM/oggm-standard-projections-csv-files repository <https://github.com/OGGM/oggm-standard-projections-csv-files/tree/main>`_. | |||
| These projections use `elevation-band flowlines <https://docs.oggm.org/en/stable/flowlines.html#elevation-bands-flowlines>`_, include the `dynamical spinup <https://docs.oggm.org/en/latest/dynamic-spinup.html>`_, the `new informed 3-step per-glacier geodetic calibration method <https://docs.oggm.org/en/latest/mass-balance-monthly.html>`_, and use the W5E5v2.0 climate dataset `(Lange and others, 2021) <https://doi.org/10.48364/ISIMIP.342217>`_ for calibration and a border of 160. | |||
There was a problem hiding this comment.
Thanks @lilianschuster! This looks already good and I'm excited that the standard projections are going to be a part of OGGM. I will add a few minor comments.
- I think it is nice include a link to Rounce et al. (2023)
- I think we might need a slightly longer introduction on what we mean by standard projections, before diving into detail. I don't mind quickly adding that once this PR has been merged.
| Since OGGM v1.6.1, we provide what we like to call "standard projections" of OGGM. A detailed description of the experimental-setup, information on the data structure, analysis of the data and a `brief comparison to Rounce et al. (2023) together with the corresponding jupyter notebooks are in the `OGGM/oggm-standard-projections-csv-files repository <https://github.com/OGGM/oggm-standard-projections-csv-files/tree/main>`_. | ||
| These projections use `elevation-band flowlines <https://docs.oggm.org/en/stable/flowlines.html#elevation-bands-flowlines>`_, include the `dynamical spinup <https://docs.oggm.org/en/latest/dynamic-spinup.html>`_, the `new informed 3-step per-glacier geodetic calibration method <https://docs.oggm.org/en/latest/mass-balance-monthly.html>`_, and use the W5E5v2.0 climate dataset `(Lange and others, 2021) <https://doi.org/10.48364/ISIMIP.342217>`_ for calibration and a border of 160. | ||
|
|
||
| We computed all GCMs and scenarios that are currently available at the OGGM cluster until 2100 and where available in a different run again until 2300. We have three different options available, using CMIP6, CMIP6 GCMs from the `bias-corrected CMIP6 ISIMIP3b GCMs <https://www.isimip.org/gettingstarted/isimip3b-bias-adjustment/>`_, and CMIP5 GCMs. An overview of the amount of GCMs per scenario and the resulting global volume changes is given in the figures below. However, you have to choose those scenarios that are suitable and representative for your study. We removed failing glaciers for the aggregation, a summary table is given `here <https://github.com/OGGM/oggm-standard-projections-csv-files/blob/main/notebooks/missing_glacier_area_stats.png>`_. |
There was a problem hiding this comment.
To make the text a little more gentle to those not familiar with OGGM, I would suggest changing this text too something in the following direction:
We have driven OGGM with a range of climate projections from different GCMs until 2100 and where available in a different run again until 2300. All the climate projections that are available on our cluster have been used. There are three categories projections available: CMIP6, CMIP6 GCMs from the bias-corrected CMIP6 ISIMIP3b GCMs <https://www.isimip.org/gettingstarted/isimip3b-bias-adjustment/>_, and CMIP5 GCMs. An overview of the amount of GCMs per scenario and the resulting global volume changes is given in the figures below. Feel free make selection that suites your purpose when using the data.
|
|
||
| Currently we make these future CMIP forced global glacier simulations available in two different formats, raw and aggregated data. | ||
| - Aggregated data is provided for both glacier volume and area evolution in csv-files, aggregated globally and for every RGI region separately. | ||
| - `README <https://github.com/OGGM/oggm-standard-projections-csv-files/blob/main/README.md>`_. |
There was a problem hiding this comment.
I think the information, about the failing glaciers, fits better here. I suggest changing to something like:
- Failing glaciers have been removed for the aggregation, a summary table is given
here <https://github.com/OGGM/oggm-standard-projections-csv-files/blob/main/notebooks/missing_glacier_area_stats.png>_ - A further explanation on the failing glaciers and aggregation in general can be found in the
README <https://github.com/OGGM/oggm-standard-projections-csv-files/blob/main/README.md>_ file.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Here is a first draft for the oggm-standard-projection documentation.
@anoukvlug, can you have a look? Maybe you can add some more links, if necessary.
the link to the Zenodo repository is still missing
Fully documented