# DEA Notebooks [](https://doi.org/10.26186/145234) [](https://opensource.org/licenses/Apache-2.0) [](https://pypi.org/project/dea-tools/) [](https://github.com/GeoscienceAustralia/dea-notebooks/actions/workflows/test_notebooks_entirerepo.yml) [](https://discord.com/invite/4hhBQVas5U)
This is the DEA Notebooks and DEA Tools repository of [Digital Earth Australia](https://www.dea.ga.gov.au/). These can be viewed on the [DEA Knowledge Hub](https://knowledge.dea.ga.gov.au/) or run on the [DEA Sandbox](https://knowledge.dea.ga.gov.au/guides/setup/Sandbox/sandbox/) or the [National Computational Infrastructure (NCI)](https://knowledge.dea.ga.gov.au/guides/setup/NCI/README/). **Contribute** — DEA Notebooks is open-source and we would love your contribution! Learn [how to contribute](#contribute) below. **License** — The code in this repository is licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). DEA data is licensed under the [Creative Commons by Attribution 4.0 license](https://creativecommons.org/licenses/by/4.0/). **Documentation** — See the [DEA Notebooks Wiki](https://github.com/GeoscienceAustralia/dea-notebooks/wiki). **Contact** — For assistance with any of these notebooks and tools, or to seek approval to merge a repository pull request, please ask a question on our [Open Data Cube Discord chat](https://discord.com/invite/4hhBQVas5U) or on the [GIS Stack Exchange](https://gis.stackexchange.com/questions/tagged/open-data-cube) using the `open-data-cube` tag. You can also [report an issue on this repository](https://github.com/GeoscienceAustralia/dea-notebooks/issues). **Citation** — If you use this repository in your work, please reference it with the following citation. > Krause, C., Dunn, B., Bishop-Taylor, R., Adams, C., Burton, C., Alger, > M., Chua, S., Phillips, C., Newey, V., Kouzoubov, K., Leith, A., > Ayers, D., Hicks, A., DEA Notebooks contributors 2021. Digital Earth > Australia notebooks and tools repository. Geoscience Australia, > Canberra. ## Introduction The Jupyter Notebooks and Python tools in this repository are for analysing DEA's satellite data products. The notebooks are designed to demonstrate how to use the DEA data and tools to conduct a broad range of geospatial analyses. They also demonstrate how to integrate with other open-source software such as [Open Data Cube](https://www.opendatacube.org/) and [xarray](http://xarray.pydata.org/en/stable/). You can see examples of use cases on the [USAGE](https://github.com/GeoscienceAustralia/dea-notebooks/blob/stable/USAGE.rst) page. ## View on the DEA Knowledge Hub The **DEA Knowledge Hub** is where you can easily view the notebooks and read DEA Tools documentation. You can browse the following sections. * **[Beginner’s guide](https://knowledge.dea.ga.gov.au/notebooks/Beginners_guide/)** — Introductory notebooks aimed at introducing Jupyter Notebooks and how to load, plot, and interact with DEA data. * **[DEA products](https://knowledge.dea.ga.gov.au/notebooks/DEA_products/)** — Notebooks introducing DEA's satellite datasets and derived products, including how to load each dataset and any special features of the data. * **[How-to guides](https://knowledge.dea.ga.gov.au/notebooks/How_to_guides/)** — A recipe book of simple code examples demonstrating how to perform common geospatial analysis tasks using DEA and open-source software. * **[Interactive apps](https://knowledge.dea.ga.gov.au/notebooks/Interactive_apps/)** — Interactive apps and widgets that require little or no coding to run. * **[Real-world examples](https://knowledge.dea.ga.gov.au/notebooks/Real_world_examples/)** — More complex case study workflows demonstrating how DEA can be used to address real-world problems. * **[DEA Tools Package](https://knowledge.dea.ga.gov.au/notebooks/Tools/)** — An open-source Python package containing functions and algorithms to assist in analysing DEA data. ## Run on the DEA Sandbox The **DEA Sandbox** is a free virtual environment for interacting with the notebooks and tools from your web browser. You can use the Sandbox to conduct geospatial analysis without installing anything on your computer. Learn how to [use the DEA Sandbox](https://knowledge.dea.ga.gov.au/guides/setup/Sandbox/sandbox/). ## Run on the NCI The **National Computational Infrastructure** is a supercomputer environment available to Australian researchers, academics, and other users by negotiation. The NCI can be used for high-performance geospatial analysis. Learn how to [use the NCI](https://knowledge.dea.ga.gov.au/guides/setup/NCI/README/). ## How to contribute To get started, see these articles in the wiki. * [Getting started with Git](https://github.com/GeoscienceAustralia/dea-notebooks/wiki/Getting-started-with-Git) * [Create a DEA Notebook](https://github.com/GeoscienceAustralia/dea-notebooks/wiki/Create-a-DEA-Notebook) * [Edit a DEA Notebook](https://github.com/GeoscienceAustralia/dea-notebooks/wiki/Edit-a-DEA-Notebook) * [Contributing and reviewing DEA Notebooks](https://github.com/GeoscienceAustralia/dea-notebooks/wiki/Contributing-and-reviewing-DEA-Notebooks) * [Edit the DEA Tools documentation](https://github.com/GeoscienceAustralia/dea-notebooks/wiki/Edit-the-DEA-Tools-documentation) We would also appreciate it if you could add your work as a citation to our [USAGE](https://github.com/GeoscienceAustralia/dea-notebooks/blob/stable/USAGE.rst) page.