Skip to content

Conversation

acblackford
Copy link
Contributor

Description

This notebook shows datasets used in the 2024 tornadoes data story.

What type of example is this?

Data Story

Checklist

The following checklist ensures that our notebooks are internally consistent (read more)

  • The first cell contains the rendering information with author and data
  • The notebook has a Run this Notebook section (with filename in link)
  • The notebook has an Approach section
  • All the packages that are imported in the notebooks are used within the notebook
  • Any complex geometries are accessed from remote storage
  • Each code cell comes after a markdown cell containing explantory text
  • All cells in the notebook book have been run in order with a fresh kernel (cell numbers should be 1, 2, 3, 4, ...)
  • If the example type is Dataset the filename is <collection_id>.ipynb

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@acblackford
Copy link
Contributor Author

Yet to do:

  1. Update tornado tracks/polygons to custom colormaps. We have predefined the NWS EF Scale colormap in STAC
  2. Turn DOW Reflectivity-Velocity into Folium slider (if possible)
  3. Incorporate CSDA commercial data visualizations if that is allowed (data is already in the STAC catalog)

@github-actions
Copy link

github-actions bot commented Aug 13, 2025

PR Preview Action v1.6.2

🚀 View preview at
https://NASA-IMPACT.github.io/veda-docs/pr-preview/pr-245/

Built to branch gh-pages at 2025-08-22 13:58 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@acblackford acblackford marked this pull request as ready for review August 18, 2025 14:38
@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Line #2.    #!pip install -q earthaccess pandas xarray fsspec requests branca pystac_client matplotlib

Would consider separating this line out into it's own code cell above, and having a comment above stating to install the following libraries if running outside of the Hub


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

I'd consider linking to the data story somewhere - maybe in this section?


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

In the first sentence, would modify "and visualize." to "and visualizes them."


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Would change the first point to "Choose collection ID from STAC catalog and date for analysis"


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Line #1.    # TODO: Change collection_ID and date

Saw this in a few cells, is this an internal comment? If so, would modify to something like "define collection_ID and date" for the end user. Also adjust for other cells that have this


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Line #2.    #colormap_name = "tornado_ef_scale"

Would remove


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Similar to other visualizations in the rest of the notebook, consider adding the location to the title here


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Can we add color bars here?


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Just my $0.02 so feel free to ignore this, but I think this would be nice to also pair with another radar product and do a slider comparison (maybe velocity since that was used in the data story and has already been used in this notebook?). I also think (whether a slider is added or not) it could be useful to add a brief explanation that debris is likely being seen here. Once again just my opinion! :)


Reply via ReviewNB

@@ -0,0 +1,12173 @@
{
Copy link
Collaborator

@smk0033 smk0033 Aug 19, 2025

Choose a reason for hiding this comment

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

Update the print statement here to reflect this product (seems to be copied from the correlation coefficient cell)


Reply via ReviewNB

@wildintellect
Copy link
Collaborator

Apologies we missed a failed build in #244 , attempting a quick fix in #248

@jsignell jsignell self-assigned this Aug 27, 2025
@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

I know I am late to review all this, so feel free to ignore, but this represents a ton of work and I feel like having it all in one notebook makes it hard to make sense of. It seems to me that it would make more sense to have it be kind of chapters where you have the setup and then each dataset or "Example" is its own notebook. That way you could use the individual notebooks as examples of how to access a particular dataset as well.


Reply via ReviewNB

@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

Why are these headers called: "Example:..."? Or maybe a better question is: can you explain what you are setting out to show in the various sections of this notebook. Maybe just a sentence like: This notebook uses several different data sources to inspect the paths and short-term impacts of tornadoes.


Reply via ReviewNB

@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

This is kind of a meta comment on notebook style, but in general the point of a notebook is really to interleave explanation with code. So if you find yourself writing inline comments in code cells - consider splitting the cell and writing the comment in a markdown cell right above the line of code that you are explaining.


Reply via ReviewNB

@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

You don't need the .rstrip('/') in there. Also it would be good to use a markdown cell above this code to explain what you are doing.


Reply via ReviewNB

@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

Line #2.    # Colors have been predifined in veda-backend https://github.com/NASA-IMPACT/veda-backend/tree/develop/raster_api/runtime/src/cmap_data#tornadoes-colormap

This implies that the colors should be accessible via the RASTER_API is that not the case and if not - should they be?


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.

https://openveda.cloud/api/raster/colorMaps/tornado_ef_scale

Copy link
Collaborator

Choose a reason for hiding this comment

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

It does list six colors but the labels would need to be applied.

@@ -0,0 +1,10770 @@
{
Copy link
Collaborator

@jsignell jsignell Sep 5, 2025

Choose a reason for hiding this comment

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

This cell in particular should definitely get split up. It is doing so many different things!


Reply via ReviewNB

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.

5 participants