Home

Digital Earth Australia Notebooks wiki

Useful links

• The Digital Earth Australia User Guide
• The Digital Earth Australia Glossary
• Join the Open Data Cube slack. This is a friendly and active community of Open Data Cube users who are always happy to help answer any questions about DEA, Open Data Cube, xarray and Python!
• The DEA NCI and Sandbox environments both contain slightly different datasets. To see what data is available, use:
  • DEA Explorer for browsing the data that is available within DEA's NCI environment
  • DEA Sandbox Explorer for browsing the data that is available within DEA's Sandbox environment
• Explore DEA products in National Map
  • "Explore data" > "Satellite Images"
  • "Explore data" > "Marine and Oceans > Coastal"
  • "Explore data" > "Water > Water Observations from Space"
  • "Explore data" > "Vegetation > Fractional Cover/Mangroves"

Getting started on the DEA Sandbox

1. Sign up to the DEA Sandbox JupyterLab environment using your email and log in using the guide here. This may take ~5 minutes if this is the first time signing in to the Sandbox.
2. One you are logged in to the Sandbox, you will be presented with a selection of ready-made Jupyter notebooks in the Sandbox's built-in file browser which will walk you through getting started with DEA. Browse to find a notebook you want to run (e.g. Beginners_guide/Jupyter_notebooks.ipynb) and double-click to launch it.
3. Follow the instructions in Using git with DEA Notebooks to start writing your own notebooks or contribute back to the repository using git or Github.

Getting started on the NCI/Virtual Desktop Infrastructure

1. Register for an account on the NCI using the guide here
   • Pay particular attention to the NCI Data Access Groups step of the guide. Joining these NCI projects allows you to have access to DEA's satellite datasets and derived products.
   • At minimum, we recommend joining:
     • wd8 (to use the Virtual Desktop Intrastructure)
     • if87 (to use the latest Sentinel-2 data)
     • xu18 (to use the latest Landsat data)
     • rs0 (to use legacy Landsat data)
     • fk4 (to use derived DEA products, e.g. WOfS, Fractional Cover, NIDEM)
2. Follow instructions here to set up the Virtual Desktop Infrastructure/VDI and install DEA
   • If you run into problems with the VDI, check the latest FAQ
3. Follow the instructions in Using git with DEA Notebooks to start writing your own notebooks or contribute back to the repository using git or Github.

DEA Notebooks template notebook

When writing notebooks for your own analyses, copy and rename the DEA Notebooks template notebook. This template has been developed to make it easier to create new notebooks that meet all pull request checklist requirements. The template notebook contains a simple structure and useful general advice on writing and formatting Jupyter notebooks.