Home

Digital Earth Africa Notebooks wiki

Useful links

• To see what data is available, use:
  • DE Africa Explorer for browsing the data that is available within DE Africa's Sandbox environment
• Explore DE Africa products on DE Africa Maps
  • "Explore data" > "Analysis Ready Data > Surface Reflectance and Radar Backscatter"
  • "Explore data" > "Derived Data > Water and Vegetation"
  • "Explore data" > "Ancillary Data > Digital Elevation Models"
• 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 DE Africa, Open Data Cube, xarray and Python!

Getting started on the DE Africa Sandbox

1. Sign up to the DE Africa Sandbox JupyterLab environment using your email and log in. This may take ~5 minutes if this is the first time signing in to the Sandbox.
2. Once 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 DE Africa. Browse to find a notebook you want to run (e.g. beginners_guide/01_Jupyter_notebooks.ipynb and double-click to launch it.
3. Please note that ready-made notebooks are regularly overwritten. To make and keep changes to an existing notebook, save a copy of that notebook with the following steps: right-click the notebook and select "duplicate" (this will make a copy), then right-click the copy and select "rename", providing a new name for the copied notebook. Then work with the copied notebook, which will prevent changes from being overwritten.
4. To start writing your own notebooks or contribute back to the repository using git, follow one of the options in Advanced: contributing back.

Advanced: contributing back

1. The previous steps allow you to load and run existing notebooks. To be able to write your own analyses and contribute back to the deafrica-sandbox-notebooks repository, follow this guide to get started with git:

   • DE Africa notebooks using git: Git is a version-control software designed to help track changes to files and collaborate with multiple users on a project. Using git is the recommended workflow for working with deafrica-sandbox-notebooks as it makes it easy to stay up to date with the latest versions of functions and code, and makes it impossible to lose your work.

2. When writing notebooks for your own analyses, copy and rename the DE Africa 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.

3. When you're happy with the notebook, push it to Github and create a pull request.