oggm / earthcube2021 Goto Github PK

Hi Team, here are the reviews I received per mail about our notebook:

Reviewer comments: This notebook is very ambitious in what it covers and it runs very nicely. The tools demonstrated are clearly useful and informative. However, there is too much content and it is hard to follow without more introductions or explanation in the text: this many figures are a real challenge for anyone to digest. I understand that the user is supposed to infer the answers to the questions from the output of the notebook, but more explanation of each result would be helpful. The section about correcting for "hydrological months" was not understandable to me: I suggest either cutting it or adding more explanation. Also the graphic from Huss &Hock isn't available.

Reviewer comments: this notebook provided an opportunity to learn glacier mass balance concepts and modeling to help understand glacier contribution to annual streamflow. The notebook is quite long and covers a lot of material that should probably ideally be separated into many smaller modules. Overall an incredible resource for introducing glacier modeling. A solid proofread for formatting consistency( () vs []), correct links (e.g. pandas), typos, and acronym definitions (Mt, CMIP) would be helpful. The figures currently have no alt text, which is an accessibility issue. I'm also wondering if it would be possible to more clearly highlight some of the locations that students should change parameters. Since some of the plots are created multiple times in different scenarios, it would reduce notebook length to provide a few helper plotting functions; I really liked the consistency in the plots throughout the notebook, because it made it easier to compare/contrast the various model outputs.

Reviewer comments: The notebook presents the Open Global Glacier Model (OGGM-Edu) as an education platform to demonstrate glacier behavior. It first demonstrates basic concepts of glacier dynamics with conceptual examples. Then it applies the model to real world data. The notebook is organized in a logical manner that help user build understanding of glaciers and the model from the basics to being able to apply the model to address scientific questions. With some minor changes and additional explanations, it is suitable for general audience. Missing data import and data processing and analysis portions of the template. While the format of the current notebook makes sense and flows well logically, subsections of “data import and data processing and analysis” can be added to the later examples that contain more detailed explanations of the data used and how the downloaded glacier and climate data are processed to produce model input.

Non-working link to 'mass-balance notebook' in the Glacier mass balance section. Please check other links as well.

Please add more dedicated explanations of figures and key graphs, such as with markdown alt texts.

The statement '1. When a glacier is in equilibrium, a glacier does not contribute to the annual runoff at all.' at the start of part 2 is confusing at first. If not runoff, where does the melted water from the glacier go? When making the point that total mass of the glacier is not changing, perhaps using ‘water balance’ or ‘storage’ is better than ‘runoff’. Make it immediately clear that input-output=0, not output=0.

Maussion-total: accept with minor revisions

I think that the reviews make sense, in particular that i may be too ambitious. I would rather not change too much at this stage, but maybe remove what is too hard to understand or add explanations, links to other resources, etc.

After modifications, the notebook will be accepted into some sort of proceedings, I'm not sure exactly how this will look like.

We need to address the reviews above by June 11th