Create a DEA Notebook - GeoscienceAustralia/dea-notebooks GitHub Wiki

This guide will show you how to create a new DEA Notebook and contribute it to the dea-notebooks repository. The DEA Notebooks Template will be the basis of your page. You don't need to install anything to your computer; however, you must have a basic understanding of git and Github.

Create a Notebook

  1. Log in or sign up to the DEA Sandbox.

    The sandbox will contain the Notebooks from the stable branch of the dea-notebooks repository. Learn more about the DEA Sandbox.

    :warning: Warning
    Don't create your Notebook in any of these folders because your changes will not be saved!

    The Launcher application in the Sandbox. The notebooks are listed in the sidebar.

  2. Click the blue "+" (New Launcher) button in the top-left corner to open the Launcher then click to open the Terminal. This is a Linux terminal for your Sandbox environment.

  3. Navigate to the home directory then clone the 'dea-notebooks' repository's develop branch into a new folder called dev. Then, enter the new dev folder.

    cd ~

git clone --depth 1 --branch develop https://github.com/GeoscienceAustralia/dea-notebooks.git dev

cd dev

  4. Create a new git branch with a name of your choice.

    git checkout -b your-branch  # Change this to a relevant branch name

  5. Enter the folder where you want to put your new Notebook, then copy the DEA Notebooks Template into this folder with a filename of your choice. (The filename will display in the URL of the page, so make sure it is relevant and not too long.)

    cd How_to_guides  # Enter one of the folders

cp ../DEA_notebooks_template.ipynb Your_page.ipynb  # Change 'Your_page' to a relevant filename

  6. In the sidebar, double-click the new page to open it in a new tab.

  7. You can now edit the page in the interactive editor. The template will guide you on how to write each section of the content. You must regularly commit your changes and eventually make a pull request. Learn how to do this in the Edit a DEA Notebook guide.

  • Supplementary_data: Supplementary files required for the analyses above (e.g. images, rasters, shapefiles, training data)