![\"Open](\"https://colab.research.google.com/assets/colab-badge.svg\"){kind=icon}
"]},{"cell_type":"markdown","metadata":{"id":"8leRDXsMoEU-"},"source":["\n","# Getting Started: Open Data Cube on Google Colab\n","\n","1. [Open Data Cube Framework](#ODC-Framework)\n","2. [Google Colab and Jupyter Notebooks](#what-is)\n","3. [Products and Measurements](#products-measurements)\n","4. [How to Load Data](#How-to-Load-Data)\n","5. [Explore More Applications](#explore-applications)\n","6. [Reference Links](#reference-links)\n","\n","*The article below provides an overview of ODC on Google Colab. If you wish to run the notebooks, you'll need to setup a Google Earth Engine account. This is free, and you can read more about how to do that [here](https://www.openearthalliance.org/sandbox).*"]},{"cell_type":"markdown","metadata":{"id":"7zfNDGZysxQH"},"source":["\n","# 1. Open Data Cube Framework\n","\n","The Open Data Cube (ODC, [opendatacube.org](https://www.opendatacube.org/)) is a software framework with the objective of:\n","\n","> ... increasing the impact of satellite data by providing an open and freely accessible exploitation tool, and to foster a community to develop, sustain, and grow the breadth and depth of applications.\n","\n","An ODC instance is made up of data, a mechanism to index that data (e.g. database), and an open source Python code base making use of a wide variety of Python libraries. A more detailed introduction and some history of the ODC can be found [here](https://medium.com/opendatacube/what-is-open-data-cube-805af60820d7).\n","\n","\n","\n","\n","\n"]},{"cell_type":"markdown","metadata":{"id":"nKGC41A00eEn"},"source":[""]},{"cell_type":"markdown","metadata":{"id":"HbliNERXMUJc"},"source":["The ODC framework can run on a wide variety of infrastructure from a simple Docker instance running on a laptop computer scaling up to continential coverage (e.g. [Digital Earth Afica](https://www.digitalearthafrica.org/)). This notebook is intended to give you an introduction to the ODC running on the Google Colab plaform, and utalising data from the [Google Earth Engine Catalog](https://developers.google.com/earth-engine/datasets).\n","\n","The notebook provides:\n","\n","* A quick introduction to Jupyter notebooks and the Colab environment (with links to read more)\n","* A worked example of how to configure an ODC connection from Google Colab\n","* An example listing of the products and measurements available\n","* How to load some sample data\n","* Links to worked examples demonstrating several Earth observation applications\n","\n","This is intended as a familarisation and training resource, and we hope it will help start your journey with ODC!\n","\n","[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"bu4ksWosrsbq"},"source":["\n","# 2. Google Colab and Jupyter Notebooks\n","\n","Google Colaboratory (or Google Colab, [colab.research.google.com](https://colab.research.google.com)) is an environment that allows anybody to write and execute arbitrary Python code through the browser, and is especially well suited to machine learning, data analysis and education. Colab is a hosted Jupyter Notebook service, where 'Notebooks' (like this one) containing live code, equations, visualizations and narrative text can be shared. You can read more about these environments in the [reference links below](#reference-links).\n","\n","While Jupyter notebooks are relatively intuitive, if you don't understand what the code and cells below are, then a quick read of the [features overview](https://colab.research.google.com/notebooks/basic_features_overview.ipynb) should help get you strated.\n","\n","Loading the satellite datasets used by this notebook requires a [Google Earth Engine](https://earthengine.google.com/) account. These accounts are free to setup, and the steps required are described [here](https://www.openearthalliance.org/sandbox).\n","\n","***Finally, one important note. This is a sandbox environment. Feel free to experiment! From time to time, you might see errors. That's OK - you can't break anything in here. And you can always start anew by reloading the Notebook. If you have questions, [try the Open Earth Alliance Forum](https://www.openearthalliance.org/forum).***\n","\n","Now, onto the code...! First, a quick test: try running this cell. (If you're not sure how, [try this](https://colab.research.google.com/notebooks/basic_features_overview.ipynb).)"]},{"cell_type":"code","metadata":{"colab":{"base_uri":"https://localhost:8080/"},"id":"zOvygfe4t_pW","executionInfo":{"status":"ok","timestamp":1623847645047,"user_tz":240,"elapsed":128,"user":{"displayName":"Andrew Lubawy","photoUrl":"","userId":"06414467155467699973"}},"outputId":"7f9f0d71-5767-44ab-d919-52d9c75cf559"},"source":["print('Push [shift] + [enter] to run this cell - now you are ready to Go!')"],"execution_count":1,"outputs":[{"output_type":"stream","text":["Push [shift] + [enter] to run this cell - now you are ready to Go!\n"],"name":"stdout"}]},{"cell_type":"markdown","metadata":{"id":"12SuxRjIuFX4"},"source":["Having run the cell above, you will have initialised your Google Colab environment, and are now ready to setup your ODC instance.\n","\n","The next code block provides Colab with access to your Google Drive to store content and results. *It will ask you to click on an authentication link, and then paste an authentication code back into the notebook cell.* The steps for the process are shown below:\n","\n","![](\"https://ceos.org/document_management/SEO/ODC%20Colab%20Images/Google%20Drive%20Auth%20Info.png\")
\n"]},{"cell_type":"code","metadata":{"id":"MKHyVmWZcwzA"},"source":["from google.colab import drive\n","drive.mount('/content/drive') "],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"HX3_ZIT-uvNX"},"source":["Now that you've setup the link to Google Drive, the next cell will grab the Python libraries necessary to run ODC on Google Colab. This is based on the [ODC-Colab](https://github.com/ceos-seo/odc-colab) repository build by the CEOS Systems Engineering Office."]},{"cell_type":"code","metadata":{"id":"Oon11EUY4h8e"},"source":["!wget -nc https://raw.githubusercontent.com/ceos-seo/odc-colab/master/odc_colab.py\n","from odc_colab import odc_colab_init\n","odc_colab_init(install_odc_gee=True)"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"Qkbspdn2vRXG"},"source":["The next code block will populate the ODC data index allowing ODC to access data from the [Google Earth Engine Catalog](https://developers.google.com/earth-engine/datasets)."]},{"cell_type":"code","metadata":{"id":"eSkt3mPC4h8f"},"source":["from odc_colab import populate_db\n","populate_db()"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"mHjsVmU2wMvT"},"source":["This next code block will establish the connection to the Google Earth Engine datasets. *As above, it will ask you to click on an authentication link, and then paste an authentication code back into the notebook cell.* The steps for the process are shown below:\n","\n","![](\"https://ceos.org/document_management/SEO/ODC%20Colab%20Images/GEE%20Auth%20Info.png\")
\n","\n","Following that, the block loads a couple of key Python librarires used later in the Notebook."]},{"cell_type":"code","metadata":{"id":"8sRzE8L34h8g"},"source":["# Suppress Warning Messages\n","import warnings\n","warnings.filterwarnings('ignore')\n","\n","# Load Data Cube Configuration\n","from odc_gee import earthengine\n","dc = earthengine.Datacube(app='Getting_Started_loading_data')\n","\n","# Import Data Cube API\n","import utils.data_cube_utilities.data_access_api as dc_api \n","api = dc_api.DataAccessApi()\n","\n","# Import Utilities\n","import xarray as xr"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"wLWJYWdHyUdv"},"source":["Now we have an ODC instance established with a connection to data!"]},{"cell_type":"markdown","metadata":{"id":"u7s_vPN5jiK-"},"source":["[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"tJe3cbUbs75t"},"source":["\n","# 3. Products and Measurements"]},{"cell_type":"markdown","metadata":{"id":"2lwWuhJyxyfl"},"source":["Within this ODC instance, 'products' refer to satellites (platform), and their instruments. To see what products are available, you can run the following command."]},{"cell_type":"code","metadata":{"id":"-QPZQYwnbi68","colab":{"base_uri":"https://localhost:8080/","height":235},"executionInfo":{"status":"ok","timestamp":1623847911081,"user_tz":240,"elapsed":169,"user":{"displayName":"Andrew Lubawy","photoUrl":"","userId":"06414467155467699973"}},"outputId":"fd363c7f-a83b-49f0-8211-612c56462fea"},"source":["products = dc.list_products()\n","\n","display_columns = [\"name\",\n"," \"description\",\n"," \"platform\",\n"," \"instrument\",\n"," \"crs\",\n"," \"resolution\"]\n","\n","products[display_columns].sort_index()"],"execution_count":6,"outputs":[{"output_type":"execute_result","data":{"text/html":["| \n"," | name | \n","description | \n","platform | \n","instrument | \n","crs | \n","resolution | \n","
|---|---|---|---|---|---|---|
| id | \n","\n"," | \n"," | \n"," | \n"," | \n"," | \n"," |
| 1 | \n","ls8_google | \n","<p>This dataset is the atmospherically correct... | \n","LANDSAT_8 | \n","OLI/TIRS | \n","EPSG:4326 | \n","(-0.000269493352, 0.000269493352) | \n","
| 2 | \n","s1_google | \n","<p>The Sentinel-1 mission provides data from a... | \n","Sentinel-1A | \n","C-SAR | \n","EPSG:4326 | \n","(-8.98311175e-05, 8.98311175e-05) | \n","
| 3 | \n","s2_google | \n","<p>Sentinel-2 is a wide-swath, high-resolution... | \n","Sentinel-2A | \n","MSI | \n","EPSG:4326 | \n","(-8.98311175e-05, 8.98311175e-05) | \n","
| 4 | \n","ls7_google | \n","<p>This dataset is the atmospherically\\ncorrec... | \n","LANDSAT_7 | \n","ETM | \n","EPSG:4326 | \n","(-0.000269493352, 0.000269493352) | \n","
| 5 | \n","viirs_google | \n","<p>Monthly average radiance composite images u... | \n","VIIRS | \n","DNB | \n","EPSG:4326 | \n","(-0.00416666667, 0.00416666667) | \n","
| \n"," | name | \n","dtype | \n","units | \n","nodata | \n","aliases | \n","flags_definition | \n","
|---|---|---|---|---|---|---|
| measurement | \n","\n"," | \n"," | \n"," | \n"," | \n"," | \n"," |
| B1 | \n","B1 | \n","int16 | \n","\n"," | -9999.0 | \n","[ultra_blue, band_1, b1] | \n","NaN | \n","
| B2 | \n","B2 | \n","int16 | \n","\n"," | -9999.0 | \n","[blue, band_2, b2] | \n","NaN | \n","
| B3 | \n","B3 | \n","int16 | \n","\n"," | -9999.0 | \n","[green, band_3, b3] | \n","NaN | \n","
| B4 | \n","B4 | \n","int16 | \n","\n"," | -9999.0 | \n","[red, band_4, b4] | \n","NaN | \n","
| B5 | \n","B5 | \n","int16 | \n","\n"," | -9999.0 | \n","[nir, band_5, b5] | \n","NaN | \n","
| B6 | \n","B6 | \n","int16 | \n","\n"," | -9999.0 | \n","[swir1, band_6, b6] | \n","NaN | \n","
| B7 | \n","B7 | \n","int16 | \n","\n"," | -9999.0 | \n","[swir2, band_7, b7] | \n","NaN | \n","
| B10 | \n","B10 | \n","int16 | \n","Kelvin | \n","-9999.0 | \n","[tirs1, band_10_brightness_temperature, b10] | \n","NaN | \n","
| B11 | \n","B11 | \n","int16 | \n","Kelvin | \n","-9999.0 | \n","[tirs2, band_11_brightness_temperature, b11] | \n","NaN | \n","
| sr_aerosol | \n","sr_aerosol | \n","uint8 | \n","\n"," | 0.0 | \n","[aerosol_attributes, sr_aerosol] | \n","{'fill': {'bits': [0], 'values': {}, 'desctipt... | \n","
| pixel_qa | \n","pixel_qa | \n","uint16 | \n","\n"," | 0.0 | \n","[pixel_quality_attributes_generated_from_the_c... | \n","{'fill': {'bits': [0], 'values': {}, 'desctipt... | \n","
| radsat_qa | \n","radsat_qa | \n","uint16 | \n","\n"," | 0.0 | \n","[radiometric_saturation_qa, radsat_qa] | \n","{'unused': {'bits': [8], 'values': {}, 'descti... | \n","
\n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Cloud_Statistics_L8.ipynb)\n","- **Median mosaic (Landsat 8)** *Create a custom Landsat cloud-filtered median mosaic for any time period and location.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Median_Mosaic_L8.ipynb)\n","- **Vegetation change (Landsat 8)** *Use changes in the Normalized Difference Vegetation Index (NDVI) to identify vegetation change.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Vegetation_Change_L8.ipynb)\n","- **Water WOFS (Landsat 8)** *Demonstration of the Australian Water Observations from Space (WOFS) algorithm.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Water_WOFS_L8.ipynb)\n","- **Spectral Products (Landsat-8)** *Compute different spectral products created using mathematical combinations of specific spectral bands.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Spectral_Products_L8.ipynb)\n","- **Cloud statistics (Sentinel 2)** *Calculate cloud statistics for specific regions Sentinel-2 data.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Cloud_Statistics_S2.ipynb)\n","- **Vegetation Phenology (Landsat 8)** *Calculate vegetation phenology changes using Landsat 8 and Normalized Difference Vegetation Index (NDVI).*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Vegetation_Phenology_L8.ipynb)\n","- **Mission coincidences** *Find concident acquisition regions for three missions: Landsat-8, Sentinel-2 and Sentinel-1.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Mission_Coincidences.ipynb)\n","- **Sentinel 1 data viewer** *View Sentinel-1 data over a specified region, including several different data products for single and multi-data analyses.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_S1_Data_Viewer.ipynb)\n","- **VIIRS night lights** *Use nightlight radiance measurements from VIIRS to study urban growth and loss of power from storms.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_VIIRS_Night_Lights.ipynb)\n","\n","[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"X3FNgAQZoR2V"},"source":["\n","# 6. Reference Links\n","\n","*Google Colab and Jupyter Notebooks*\n","\n","* [What is Google Colab](https://colab.research.google.com/notebooks/intro.ipynb)\n","* [Introduction to the Jupyter Notebook Environment on Google Colab](https://colab.research.google.com/notebooks/basic_features_overview.ipynb)\n","* [Description of Jupyter Notebooks from the Jupyter Project](https://jupyter-notebook.readthedocs.io/en/stable/notebook.html)\n","* [ODC-Colab Repository from the CEOS Systems Engineering Office](https://github.com/ceos-seo/odc-colab)\n","* [How to index new products on the ODC-Colab](https://github.com/ceos-seo/odc-gee#local-index)\n","\n","*Open Data Cube*\n","\n","* ODC Medium Article\n","* ODC Website\n","* ODC Code on GitHub\n","* Open Earth Alliance\n","* OEA User Forum\n","\n","*Open Data Cube Instances*\n","\n","* DE Australia\n","* DE Africa\n","* Swiss Cube\n","\n","\n","[Back to the top](#top)"]}]}
+{"nbformat":4,"nbformat_minor":0,"metadata":{"colab":{"name":"Getting_Started_ODC_and_Colab-new.ipynb","provenance":[],"collapsed_sections":[]},"kernelspec":{"display_name":"Python 3","language":"python","name":"python3"},"language_info":{"codemirror_mode":{"name":"ipython","version":3},"file_extension":".py","mimetype":"text/x-python","name":"python","nbconvert_exporter":"python","pygments_lexer":"ipython3","version":"3.6.8"}},"cells":[{"cell_type":"markdown","metadata":{"id":"wUjM0D_z4h8X"},"source":[""]},{"cell_type":"markdown","metadata":{"id":"8leRDXsMoEU-"},"source":["\n","# Getting Started: Open Data Cube on Google Colab\n","\n","1. [Open Data Cube Framework](#ODC-Framework)\n","2. [Google Colab and Jupyter Notebooks](#what-is)\n","3. [Products and Measurements](#products-measurements)\n","4. [How to Load Data](#How-to-Load-Data)\n","5. [Explore More Applications](#explore-applications)\n","6. [Reference Links](#reference-links)\n","\n","*The article below provides an overview of ODC on Google Colab. If you wish to run the notebooks, you'll need to setup a Google Earth Engine account. This is free, and you can read more about how to do that [here](https://www.openearthalliance.org/sandbox).*"]},{"cell_type":"markdown","metadata":{"id":"7zfNDGZysxQH"},"source":["\n","# 1. Open Data Cube Framework\n","\n","The Open Data Cube (ODC, [opendatacube.org](https://www.opendatacube.org/)) is a software framework with the objective of:\n","\n","> ... increasing the impact of satellite data by providing an open and freely accessible exploitation tool, and to foster a community to develop, sustain, and grow the breadth and depth of applications.\n","\n","An ODC instance is made up of data, a mechanism to index that data (e.g. database), and an open source Python code base making use of a wide variety of Python libraries. A more detailed introduction and some history of the ODC can be found [here](https://medium.com/opendatacube/what-is-open-data-cube-805af60820d7).\n","\n","\n","\n","\n","\n"]},{"cell_type":"markdown","metadata":{"id":"nKGC41A00eEn"},"source":[""]},{"cell_type":"markdown","metadata":{"id":"HbliNERXMUJc"},"source":["The ODC framework can run on a wide variety of infrastructure from a simple Docker instance running on a laptop computer scaling up to continential coverage (e.g. [Digital Earth Afica](https://www.digitalearthafrica.org/)). This notebook is intended to give you an introduction to the ODC running on the Google Colab plaform, and utalising data from the [Google Earth Engine Catalog](https://developers.google.com/earth-engine/datasets).\n","\n","The notebook provides:\n","\n","* A quick introduction to Jupyter notebooks and the Colab environment (with links to read more)\n","* A worked example of how to configure an ODC connection from Google Colab\n","* An example listing of the products and measurements available\n","* How to load some sample data\n","* Links to worked examples demonstrating several Earth observation applications\n","\n","This is intended as a familarisation and training resource, and we hope it will help start your journey with ODC!\n","\n","[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"bu4ksWosrsbq"},"source":["\n","# 2. Google Colab and Jupyter Notebooks\n","\n","Google Colaboratory (or Google Colab, [colab.research.google.com](https://colab.research.google.com)) is an environment that allows anybody to write and execute arbitrary Python code through the browser, and is especially well suited to machine learning, data analysis and education. Colab is a hosted Jupyter Notebook service, where 'Notebooks' (like this one) containing live code, equations, visualizations and narrative text can be shared. You can read more about these environments in the [reference links below](#reference-links).\n","\n","While Jupyter notebooks are relatively intuitive, if you don't understand what the code and cells below are, then a quick read of the [features overview](https://colab.research.google.com/notebooks/basic_features_overview.ipynb) should help get you strated.\n","\n","Loading the satellite datasets used by this notebook requires a [Google Earth Engine](https://earthengine.google.com/) account. These accounts are free to setup, and the steps required are described [here](https://www.openearthalliance.org/sandbox).\n","\n","***Finally, one important note. This is a sandbox environment. Feel free to experiment! From time to time, you might see errors. That's OK - you can't break anything in here. And you can always start anew by [reloading the Notebook](https://colab.research.google.com/github/ceos-seo/odc-colab/blob/master/notebooks/Getting_Started_ODC_and_Colab.ipynb). If you have questions, [try the Open Earth Alliance Forum](https://www.openearthalliance.org/forum).***\n","\n","Now, onto the code...! First, a quick test: try running this cell. (If you're not sure how, [try this](https://colab.research.google.com/notebooks/basic_features_overview.ipynb).)"]},{"cell_type":"code","metadata":{"colab":{"base_uri":"https://localhost:8080/"},"id":"zOvygfe4t_pW","executionInfo":{"status":"ok","timestamp":1623888339581,"user_tz":240,"elapsed":249,"user":{"displayName":"Andrew Lubawy","photoUrl":"","userId":"06414467155467699973"}},"outputId":"769b9eb0-7769-4e6e-a3e7-35ff75cdef4e"},"source":["print('Push [shift] + [enter] to run this cell - now you are ready to Go!')"],"execution_count":1,"outputs":[{"output_type":"stream","text":["Push [shift] + [enter] to run this cell - now you are ready to Go!\n"],"name":"stdout"}]},{"cell_type":"markdown","metadata":{"id":"12SuxRjIuFX4"},"source":["Having run the cell above, you will have initialised your Google Colab environment, and are now ready to setup your ODC instance.\n","\n","The next code block provides Colab with access to your Google Drive to store content and results. *It will ask you to click on an authentication link, and then paste an authentication code back into the notebook cell.* The steps for the process are shown below:\n","\n","\n"]},{"cell_type":"code","metadata":{"id":"MKHyVmWZcwzA"},"source":["from google.colab import drive\n","drive.mount('/content/drive') "],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"HX3_ZIT-uvNX"},"source":["Now that you've setup the link to Google Drive, the next cell will grab the Python libraries necessary to run ODC on Google Colab. This is based on the [ODC-Colab](https://github.com/ceos-seo/odc-colab) repository build by the CEOS Systems Engineering Office."]},{"cell_type":"code","metadata":{"id":"Oon11EUY4h8e"},"source":["!wget -nc https://raw.githubusercontent.com/ceos-seo/odc-colab/master/odc_colab.py\n","from odc_colab import odc_colab_init\n","odc_colab_init(install_odc_gee=True)"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"Qkbspdn2vRXG"},"source":["The next code block will populate the ODC data index allowing ODC to access data from the [Google Earth Engine Catalog](https://developers.google.com/earth-engine/datasets)."]},{"cell_type":"code","metadata":{"id":"eSkt3mPC4h8f"},"source":["from odc_colab import populate_db\n","populate_db()"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"mHjsVmU2wMvT"},"source":["This next code block will establish the connection to the Google Earth Engine datasets. *As above, it will ask you to click on an authentication link, and then paste an authentication code back into the notebook cell.* The steps for the process are shown below:\n","\n","\n","\n","Following that, the block loads a couple of key Python librarires used later in the Notebook."]},{"cell_type":"code","metadata":{"id":"8sRzE8L34h8g"},"source":["# Suppress Warning Messages\n","import warnings\n","warnings.filterwarnings('ignore')\n","\n","# Load Data Cube Configuration\n","from odc_gee import earthengine\n","dc = earthengine.Datacube(app='Getting_Started_loading_data')\n","\n","# Import Data Cube API\n","import utils.data_cube_utilities.data_access_api as dc_api \n","api = dc_api.DataAccessApi()\n","\n","# Import Utilities\n","import xarray as xr"],"execution_count":null,"outputs":[]},{"cell_type":"markdown","metadata":{"id":"wLWJYWdHyUdv"},"source":["Now we have an ODC instance established with a connection to data!"]},{"cell_type":"markdown","metadata":{"id":"u7s_vPN5jiK-"},"source":["[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"tJe3cbUbs75t"},"source":["\n","# 3. Products and Measurements"]},{"cell_type":"markdown","metadata":{"id":"2lwWuhJyxyfl"},"source":["Within this ODC instance, 'products' refer to satellites (platform), and their instruments. To see what products are available, you can run the following command."]},{"cell_type":"code","metadata":{"id":"-QPZQYwnbi68","colab":{"base_uri":"https://localhost:8080/","height":235},"executionInfo":{"status":"ok","timestamp":1623888423400,"user_tz":240,"elapsed":213,"user":{"displayName":"Andrew Lubawy","photoUrl":"","userId":"06414467155467699973"}},"outputId":"b07a89fd-99cb-4f53-f06e-e848bdba5e35"},"source":["products = dc.list_products()\n","\n","display_columns = [\"name\",\n"," \"description\",\n"," \"platform\",\n"," \"instrument\",\n"," \"crs\",\n"," \"resolution\"]\n","\n","products[display_columns].sort_index()"],"execution_count":6,"outputs":[{"output_type":"execute_result","data":{"text/html":["| \n"," | name | \n","description | \n","platform | \n","instrument | \n","crs | \n","resolution | \n","
|---|---|---|---|---|---|---|
| id | \n","\n"," | \n"," | \n"," | \n"," | \n"," | \n"," |
| 1 | \n","ls8_google | \n","<p>This dataset is the atmospherically correct... | \n","LANDSAT_8 | \n","OLI/TIRS | \n","EPSG:4326 | \n","(-0.000269493352, 0.000269493352) | \n","
| 2 | \n","s1_google | \n","<p>The Sentinel-1 mission provides data from a... | \n","Sentinel-1A | \n","C-SAR | \n","EPSG:4326 | \n","(-8.98311175e-05, 8.98311175e-05) | \n","
| 3 | \n","s2_google | \n","<p>Sentinel-2 is a wide-swath, high-resolution... | \n","Sentinel-2A | \n","MSI | \n","EPSG:4326 | \n","(-8.98311175e-05, 8.98311175e-05) | \n","
| 4 | \n","ls7_google | \n","<p>This dataset is the atmospherically\\ncorrec... | \n","LANDSAT_7 | \n","ETM | \n","EPSG:4326 | \n","(-0.000269493352, 0.000269493352) | \n","
| 5 | \n","viirs_google | \n","<p>Monthly average radiance composite images u... | \n","VIIRS | \n","DNB | \n","EPSG:4326 | \n","(-0.00416666667, 0.00416666667) | \n","
| \n"," | name | \n","dtype | \n","units | \n","nodata | \n","aliases | \n","flags_definition | \n","
|---|---|---|---|---|---|---|
| measurement | \n","\n"," | \n"," | \n"," | \n"," | \n"," | \n"," |
| B1 | \n","B1 | \n","int16 | \n","\n"," | -9999.0 | \n","[ultra_blue, band_1, b1] | \n","NaN | \n","
| B2 | \n","B2 | \n","int16 | \n","\n"," | -9999.0 | \n","[blue, band_2, b2] | \n","NaN | \n","
| B3 | \n","B3 | \n","int16 | \n","\n"," | -9999.0 | \n","[green, band_3, b3] | \n","NaN | \n","
| B4 | \n","B4 | \n","int16 | \n","\n"," | -9999.0 | \n","[red, band_4, b4] | \n","NaN | \n","
| B5 | \n","B5 | \n","int16 | \n","\n"," | -9999.0 | \n","[nir, band_5, b5] | \n","NaN | \n","
| B6 | \n","B6 | \n","int16 | \n","\n"," | -9999.0 | \n","[swir1, band_6, b6] | \n","NaN | \n","
| B7 | \n","B7 | \n","int16 | \n","\n"," | -9999.0 | \n","[swir2, band_7, b7] | \n","NaN | \n","
| B10 | \n","B10 | \n","int16 | \n","Kelvin | \n","-9999.0 | \n","[tirs1, band_10_brightness_temperature, b10] | \n","NaN | \n","
| B11 | \n","B11 | \n","int16 | \n","Kelvin | \n","-9999.0 | \n","[tirs2, band_11_brightness_temperature, b11] | \n","NaN | \n","
| sr_aerosol | \n","sr_aerosol | \n","uint8 | \n","\n"," | 0.0 | \n","[aerosol_attributes, sr_aerosol] | \n","{'fill': {'bits': [0], 'values': {}, 'desctipt... | \n","
| pixel_qa | \n","pixel_qa | \n","uint16 | \n","\n"," | 0.0 | \n","[pixel_quality_attributes_generated_from_the_c... | \n","{'fill': {'bits': [0], 'values': {}, 'desctipt... | \n","
| radsat_qa | \n","radsat_qa | \n","uint16 | \n","\n"," | 0.0 | \n","[radiometric_saturation_qa, radsat_qa] | \n","{'unused': {'bits': [8], 'values': {}, 'descti... | \n","
\n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Cloud_Statistics_L8.ipynb)\n","- **Median mosaic (Landsat 8)** *Create a custom Landsat cloud-filtered median mosaic for any time period and location.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Median_Mosaic_L8.ipynb)\n","- **Vegetation change (Landsat 8)** *Use changes in the Normalized Difference Vegetation Index (NDVI) to identify vegetation change.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Vegetation_Change_L8.ipynb)\n","- **Water WOFS (Landsat 8)** *Demonstration of the Australian Water Observations from Space (WOFS) algorithm.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Water_WOFS_L8.ipynb)\n","- **Spectral Products (Landsat-8)** *Compute different spectral products created using mathematical combinations of specific spectral bands.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Spectral_Products_L8.ipynb)\n","- **Cloud statistics (Sentinel 2)** *Calculate cloud statistics for specific regions Sentinel-2 data.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Cloud_Statistics_S2.ipynb)\n","- **Vegetation Phenology (Landsat 8)** *Calculate vegetation phenology changes using Landsat 8 and Normalized Difference Vegetation Index (NDVI).*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Vegetation_Phenology_L8.ipynb)\n","- **Mission coincidences** *Find concident acquisition regions for three missions: Landsat-8, Sentinel-2 and Sentinel-1.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_Mission_Coincidences.ipynb)\n","- **Sentinel 1 data viewer** *View Sentinel-1 data over a specified region, including several different data products for single and multi-data analyses.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_S1_Data_Viewer.ipynb)\n","- **VIIRS night lights** *Use nightlight radiance measurements from VIIRS to study urban growth and loss of power from storms.*\n"," - \n"," -[View on GitHub](https://github.com/ceos-seo/odc-colab/blob/master/notebooks/Colab_VIIRS_Night_Lights.ipynb)\n","\n","[Back to the top](#top)"]},{"cell_type":"markdown","metadata":{"id":"X3FNgAQZoR2V"},"source":["\n","# 6. Reference Links\n","\n","*Google Colab and Jupyter Notebooks*\n","\n","* [What is Google Colab](https://colab.research.google.com/notebooks/intro.ipynb)\n","* [Introduction to the Jupyter Notebook Environment on Google Colab](https://colab.research.google.com/notebooks/basic_features_overview.ipynb)\n","* [Description of Jupyter Notebooks from the Jupyter Project](https://jupyter-notebook.readthedocs.io/en/stable/notebook.html)\n","* [ODC-Colab Repository from the CEOS Systems Engineering Office](https://github.com/ceos-seo/odc-colab)\n","* [How to index new products on the ODC-Colab](https://github.com/ceos-seo/odc-gee#local-index)\n","\n","*Open Data Cube*\n","\n","* [What is the Open Data Cube?](https://medium.com/opendatacube/what-is-open-data-cube-805af60820d7)\n","* [opendatacube.org/](https://www.opendatacube.org)\n","* [github.com/opendatacube](https://github.com/opendatacube)\n","* [Open Earth Alliance](https://www.openearthalliance.org/)\n","* [User Forum](https://www.openearthalliance.org/forum)\n","\n","*Open Data Cube Instances*\n","\n","* [Digital Earth Australia](https://www.ga.gov.au/dea)\n","* [Digital Earth Africa](https://www.digitalearthafrica.org/)\n","* [Swiss Data Cube](https://www.swissdatacube.org/)\n","\n","[Back to the top](#top)"]}]}
\ No newline at end of file