This notebook serves as a template for creating your own Earth Engine Community Tutorial using Python and Colab. Before proceeding, please be sure you've read Writing your own tutorial, as well as the Earth Engine Community Tutorials Style Guide.
To get started, replace
Tutorial title and
github-username above with your own. Then, replace the text in this cell with a few sentences describing what the user is going to learn in this tutorial. Be sure to include concise background information; only include what's helpful and relevant. When in doubt, leave it out!
IMPORTANT: Be sure not to modify the copyright header at the beginning of this tutorial.
Run me first
Run the following cell to initialize the API. The output will contain instructions on how to grant this notebook access to Earth Engine using your account.
import ee # Trigger the authentication flow. ee.Authenticate() # Initialize the library. ee.Initialize()
Break up your tutorial into sections, one section per task, using text cells to describe each code block. Code should be split into small chunks that can be executed together and that can be easily understood by the reader.
You can find useful examples of how to render images, charts, and interactive maps in the Earth Engine Python API Colab Setup notebook.
Before starting work on your tutorial:
If you haven't already, Join GitHub.
File a Tutorial proposal to discuss your idea with the maintainers.
Once your proposal is approved, fork the Earth Engine Community repository to your personal account.
In Colab, click "File > Save a copy in GitHub", granting Colab permission to write to your personal repo as necessary.
In the "Copy to GitHub" dialog that appears, select the
masterbranch of the fork created above.
Enter the "File path" as follows:
your-tutorial-namewith a short filename, using only lowercase letters, numbers, and "-", preserving the ".ipynb" extension.
Write your tutorial directly in the notebook, leaving the copyright cell intact, and updating the title cell.
Images should be uploaded to your fork in GitHub under the
tutorials/your-tutorial-name folder created above. Images must be directly under that directory; nested subdirectories are not allowed (e.g., "
To refer to images uploaded in your tutorial, use Markdown's image syntax, referring to the filename of the image, without specifying its absolute path or full URL. For example:
Submitting tutorial for review
Once your tutorial is ready for review:
Follow GitHub's instructions on creating a pull request to request a review.
Reviewer(s) will be assigned to review your notebook. Work with them to finalize its content. Once ready, the Earth Engine Community maintainers will approve, merge, and publish your tutorial in the Earth Engine developers documentation.