Skip to content

CIRN Digital Earth Australia Coastal Earth Observation Workshop

Robbi Bishop-Taylor edited this page Oct 18, 2024 · 29 revisions

DEA Sandbox

We will be using the Digital Earth Australia Sandbox analysis environment for this workshop. The DEA Sandbox is an interactive Python-based coding environment with access to petabytes of satellite data across Australia and pre-installed scientific Python packages for EO analysis.

  1. Please follow the guide here to register for the DEA Sandbox before the Tuesday morning workshop: https://knowledge.dea.ga.gov.au/guides/setup/Sandbox/sandbox/#register

Important

Once you have registered, email Robbi.BishopTaylor@ga.gov.au if you would like to be granted access to larger 120 gb RAM, 16 CPUs resources during the workshop!

  • Additional Sandbox resources are provided for the purposes of this workshop for a period of six weeks
  • After six weeks (30th November 2024), access will revert to the default provisions
  • When you have finished using the DEA Sandbox, please shut down your server by clicking the File menu, then Hub control panel then Stop my server.

Getting started with eo-tides

  1. Log into the DEA Sandbox (https://app.sandbox.dea.ga.gov.au/):

image

  1. Start up a server - select "4XL environment for coastal modelling workshop" if you emailed about extra access; otherwise "Default Environment":


  1. Press "Start" and wait for your server to launch. This may take several minutes.


  1. After a few minutes, your Sandbox will launch and you should see the screen below. On the left is a file browser that you can use to navigate the Sandbox. On the right is a window where we will run interactive "Jupyter Notebook" code examples (for more information, see here).

image

  1. On the top-left, you will see a blue "New launcher" button. Click this, and then click "Start a new terminal session"

image image

  1. The eo-tides code and examples live on Github here (https://github.com/GeoscienceAustralia/eo-tides). Our first step is to get a copy of eo-tides inside the DEA Sandbox so we can run it interactively. The commands below will create a "clone" of the eo-tides repository, and then install eo-tides as a Python package so we can use it. First, run this command in the terminal to create a new folder:
mkdir dev

Then navigate inside it:

cd dev

Then clone eo-tides:

git clone https://github.com/GeoscienceAustralia/eo-tides.git

And finally, install eo-tides:

pip install eo-tides

We are now ready to get started!

  1. Using the file browser menu on the left, navigate to "dev/eo-tides/docs/notebooks/". You will see a list of "Jupyter Notebook" files:

image