Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Review - Round 1 #1

Merged
merged 6 commits into from
Jun 21, 2022
Merged

Review - Round 1 #1

merged 6 commits into from
Jun 21, 2022

Conversation

acocac
Copy link
Member

@acocac acocac commented Jun 14, 2022

PR to review the first draft of the notebook

Corresponding authors: @timo0thy

Reviewers: @NHomer-Edi

Editor: @acocac

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@acocac
Copy link
Member Author

acocac commented Jun 14, 2022

@timo0thy @NHomer-Edi I've set this PR to get first reviews of the notebook. Note, I only added Nick's full name, his affiliation and GH handle and corrected the tag of the theme. @NHomer-Edi feel free to add your comments here or in the ReviewNB above.

@acocac
Copy link
Member Author

acocac commented Jun 14, 2022

FYI, you can also display a preview of the notebook (render branch) in the PR#96. Go to deploy preview or click here. Once we merge the PR of the 1st round revision, the preview will be updated with the new changes.

@@ -8,11 +8,11 @@
"\n",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For accessibility purposes it is better to label links with descriptive text. So, rather than "obtained from this landing page" you could say "obtained from the NOAA Physical Sciences Laboratory", or similar.


Reply via ReviewNB

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks and I've revised based on your suggestion, please check latest version on GitHub (review_round1 branch).

@@ -8,11 +8,11 @@
"\n",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Line #2.    grid_area_weights = iris.analysis.cartography.area_weights(Borneo)

What is this line actually doing?

Maybe add one more comment to clarify what is happening here.


Reply via ReviewNB

Copy link
Collaborator

@timo0thy timo0thy Jun 17, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's an interesting question involving some concepts of the Earth's shape/grid. Thanks to your suggestion I've added some extra description (in the text cell above but not as a code comment), as follows:

Note that due to the spherical nature of the planet Earth, the area of every grid-box is not the same, therefore we need to perform the weighted mean based on the weights by area.

Then hopefully the readers will be able to understand/follow the one-line comment above Line #2, and the remainder of the cell.

Based on comments from reviewers
Some new packages required for latest revision
@acocac
Copy link
Member Author

acocac commented Jun 20, 2022

@NHomer-Edi please can you confirm if you have any additional suggestion to Tim's replies. If not, I'll merge the PR and add some suggested changes in the visuals but in a second round.

@NHomer-Edi
Copy link

@acocac I have no additional edits to suggest at this time.

The notebook runs well with various input dates/regions, is formatted correctly and is nicely explained. Great work @timo0thy

@acocac acocac merged commit c5bad4e into main Jun 21, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants