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

[Tutorial proposal] Detecting Changes in Sentinel-1 Imagery #210

Closed
mortcanty opened this issue Aug 15, 2020 · 11 comments · Fixed by #245
Closed

[Tutorial proposal] Detecting Changes in Sentinel-1 Imagery #210

mortcanty opened this issue Aug 15, 2020 · 11 comments · Fixed by #245
Assignees
Labels
accepted tutorial proposal Proposal for new Earth Engine community tutorial

Comments

@mortcanty
Copy link
Contributor

What is the objective of the proposed tutorial?
The Sentinel-1 missions of the ESA provide a fantastic source of free, weather-independent Earth observation data with revisit times of the order of 6-12 days. The Google Earth Engine team monitor and ingest the imagery data as fast as they are produced, thus removing the burden from the user of searching, pre-processing and georeferencing. In this tutorial we will analyze Sentinel-1 imagery archived on the GEE in order to detect statistically significant changes over time. As the adverb "statistically" hints, we will need a basic understanding of the statistical properties of SAR imagery in order to proceed, and the adjective "significant" implies that we learn the fundamentals of hypothesis testing.

What is the scope of the proposed tutorial?
Specifically, we will be analyzing the dual polarimetric intensity images in the GEE archive and developing, step-by-step, methods to detect changes, both in bitemporal as well as multitemporal imagery. The JavaScript and Python API's to the GEE can be easily programmed to analyze time series of Sentinel-1 acquisitions virtually anywhere on the globe. Detected changes, both short- and long-term can be related to landscape dynamics and human activity, and examples will be given.

Please provide an outline of the structure of the proposed tutorial?
I would suggest dividing the tutorial into three parts, each submitted as a separate pull request :

  • Single and multi-look image statistics
  • Hypothesis testing for change detection
  • Applications

In what format will you be submitting the tutorial?
Colab

This request will be reviewed by the Earth Engine community maintainers, who will reply on this issue tracker with any questions or suggestions. Once approved, this issue will be assigned to you and you can begin work on the tutorial following instructions in Writing a tutorial. When ready, enter “Closes #issueno” in the description of your Pull Request to link the tutorial to this issue.

Issue labels:
proposal, tutorial

@mortcanty mortcanty added the tutorial proposal Proposal for new Earth Engine community tutorial label Aug 15, 2020
@jdbcode
Copy link
Member

jdbcode commented Aug 17, 2020

Hi @mortcanty, we're pleased to accept your tutorial proposal. We're particularly excited about the topic, as we have very few SAR examples.

Please see this Colab notebook template for instructions on setting up the notebook to comply with our publishing flow (license, author, GitHub repo directory and file naming conventions).

Note that it is best if tutorials rely on datasets/assets from the Earth Engine Catalog or those that can be computed (i.e. avoid using shared private assets whenever possible).

Comment on this issue if you have any questions.

We look forward to seeing the tutorial!

@jdbcode jdbcode assigned mortcanty and unassigned tylere and gino-m Aug 17, 2020
@mortcanty
Copy link
Contributor Author

Thanks for the acceptance. It is apparently not possible to use ipyleaflet in colab, although it runs fine in Jupyter notebooks. Is this likely to be a permanent disadvantage of colab?

@tylere
Copy link
Contributor

tylere commented Aug 19, 2020

Colab has a different security model for cell outputs, so Jupyter widgets don't work without significant modifications. Many of the basic widgets have been ported, but not advanced widgets like ipyleaflet. Relevant issues:
googlecolab/colabtools#60
jupyter-widgets/ipyleaflet#195

@mortcanty
Copy link
Contributor Author

mortcanty commented Aug 19, 2020 via email

@mortcanty
Copy link
Contributor Author

Sorry, I see that I can import and use folium. Great!

@tylere
Copy link
Contributor

tylere commented Aug 20, 2020

Yes, examples of using folium to display Earth Engine results are shown in the example Colab notebooks on the Python Install page and the Time Series Visualization with Altair tutorial.

@mortcanty
Copy link
Contributor Author

I'm splitting the tutorial into four parts, Part 1 is ready for review. Not sure best way to proceed as I have limited git/GitHub experience. In my local clone of the fork I have a subdirectory ../tutorials/detecting-changes-in-sentinel-1-imagery containing the colab notebook tutorial-pt-1. As I understand, I should commit that, push it to the fork and then do a PR. When I add the next part, can I proceed in the same way or do I need a new fork? Thanks.

@mortcanty
Copy link
Contributor Author

@googlebot I signed it!

@mortcanty
Copy link
Contributor Author

@clausmichele
Copy link

Thanks a lot for the first two parts of this tutorial, I really look forward to read the 3rd part about multitemporal filtering!

@jdbcode
Copy link
Member

jdbcode commented Dec 2, 2020

@clausmichele - Thanks for your interest in @mortcanty's tutorials! They are certainly a great benefit to the GEE and SAR community!

Mort's third tutorial is in review (#245) and will probably be published within a week or two. I'll post the page here when it is ready.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
accepted tutorial proposal Proposal for new Earth Engine community tutorial
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants