Skip to content

Conversation

smk0033
Copy link
Contributor

@smk0033 smk0033 commented Jul 15, 2025

The NASA IMPACT MAAP Team has updated the in development tutorial "CMR STAC in R". Updates include:

  • using the earthdatalogin package to list NASA STACs
  • using the rstac package instead of httr
  • combining some sections in the original notebook
  • changing from a Rmd file to qmd

I was not quite sure how to handle the author attributions at the end since we updated the original tutorial, so guidance there would especially be appreciated.

Thank you all for letting us collaborate and work on this! Please feel free to leave any feedback.

@jules32
Copy link
Contributor

jules32 commented Jul 15, 2025

Super @smk0033 et al, thank you and nice work! I'll mark @ateucher as a reviewer (thank you Andy) unless another Mentor gets to this before he is back from vacation.

@jules32 jules32 requested a review from ateucher July 15, 2025 21:49
@smk0033
Copy link
Contributor Author

smk0033 commented Jul 16, 2025

Thanks so much @jules32! Just to make sure, is NASA-Openscapes:main the correct place to point the PR to?

@smk0033 smk0033 marked this pull request as ready for review July 16, 2025 13:13
@jules32
Copy link
Contributor

jules32 commented Jul 16, 2025

Yes it is, thanks!

@smk0033
Copy link
Contributor Author

smk0033 commented Aug 18, 2025

Hi @ateucher! Any feedback or updates on this PR yet? 🙂

@ateucher
Copy link
Member

Hi @smk0033 - so sorry for the delay. I will be able to look at this early next week!

@smk0033
Copy link
Contributor Author

smk0033 commented Aug 21, 2025

No worries, just wanted to check in - thanks!

Copy link
Member

@ateucher ateucher left a comment

Choose a reason for hiding this comment

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

This is great @smk0033, thank you so much! I think it shows the workflow very well.

For context for the user, do you think it's worth explaining when/why a user would use STAC vs Earthdata Search?

From my understanding, since STAC is a standard protocol and there are many other STAC catalogues out there (e.g., ESA STAC), using it for NASA data would be the same as for other catalogues, so a user doesn't need to learn different search methods.

I've added some suggestions (mostly technical wrt R syntax), as well as a few content thoughts/suggestions.

@smk0033 smk0033 requested a review from ateucher September 5, 2025 16:19
@smk0033
Copy link
Contributor Author

smk0033 commented Sep 5, 2025

Thank you for the thorough review! I've made the requested changes

@ateucher
Copy link
Member

ateucher commented Sep 8, 2025

Thanks @smk0033 this is looking great now!

For the author information at the bottom, I think you could probably replace the contact info with yours (and/or whomever's is the most appropriate, and leave just the note about the original material being by Mahsa and Aaron (PL DAAC), without their contact info.

Copy link
Member

@ateucher ateucher left a comment

Choose a reason for hiding this comment

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

I think this is great @smk0033!

I think the next step is to move it to the appropriate place (Tutorials I think?), render it and add computation outputs to _freeze before merging. That part can be a bit tedious / lead to merge conflicts... I'm happy to do it if you'd like to leave it here? Or also happy to help you work through the process...

@jules32 do you think this best belongs in "Tutorials" vs "How do I...?". I don't think we currently have good guidance on those?

@ateucher
Copy link
Member

ateucher commented Sep 8, 2025

On second thought, maybe this is more of a how-to based on this description.

@smk0033
Copy link
Contributor Author

smk0033 commented Sep 8, 2025

Let me check with the MAAP Team on who/what to include in the contact section! I'll let you know as soon as that's updated, and then I'll pass merging along to you

@smk0033
Copy link
Contributor Author

smk0033 commented Sep 9, 2025

@ateucher I've updated the last section!

@smk0033 smk0033 requested a review from ateucher September 11, 2025 14:11
@ateucher
Copy link
Member

@smk0033 Can you please see if there is a tickbox on the right side of this page that says "Allow edits from maintainers", or something similar to that? That way I can push to this PR to finish things off before merging. Thanks!

@smk0033
Copy link
Contributor Author

smk0033 commented Sep 15, 2025

@ateucher that option seems to be missing ☹️ I sent an invite to add you as a contributor to the fork we created! If that doesn't work, then I can go ahead and try to make the updates

@ateucher
Copy link
Member

/deploy-preview

Copy link

@ateucher
Copy link
Member

/deploy-preview

Copy link

Copy link
Member

@ateucher ateucher left a comment

Choose a reason for hiding this comment

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

@smk0033 I think this is ready to merge now, but I made a few other changes so wanted to give you a chance to have a look:

  • I moved it to how-tos/find-data
  • I added a bit to the preamble, and also added a short "Why STAC" section.

You can see a rendered preview of the page here: https://deploy-preview--openscapes-org-preview.netlify.app/how-tos/find-data/cmr-stac-search.

Let me know what you think!

@smk0033
Copy link
Contributor Author

smk0033 commented Sep 24, 2025

Thanks @ateucher! I think the preview looks good!

@ateucher
Copy link
Member

Awesome, thanks for all your work on this! I'll merge, then you can remove me as a collaborator from your repo if you'd like.

@ateucher ateucher merged commit b17f8b6 into NASA-Openscapes:main Sep 24, 2025
3 checks passed
@smk0033 smk0033 deleted the cmr-stac-updates-maap branch September 24, 2025 18:44
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