01_Exploring_Products.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "04668356",
   "metadata": {},
   "outputs": [],
   "source": [
    "import datacube\n",
    "import pandas as pd\n",
    "from odc.ui import DcViewer\n",
    "\n",
    "# Set some configurations for displaying tables nicely\n",
    "pd.set_option('display.max_colwidth', 200)\n",
    "pd.set_option('display.max_rows', None)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "58e852c2",
   "metadata": {},
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "Application name is too long: Truncating to 26 chars\n",
      "NOTICE:  identifier \"-Products-and-measurements agdc-1.8.19.dev13+g8b46c228.d20240621\" will be truncated to \"-Products-and-measurements agdc-1.8.19.dev13+g8b46c228.d2024062\"\n"
     ]
    }
   ],
   "source": [
    "dc = datacube.Datacube(app=\"01_Existing_Products_and_measurements\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "6702ddbf",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Index(['name', 'description', 'license', 'default_crs', 'default_resolution'], dtype='object')"
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "dc.list_products().columns"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "db316b2b",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>name</th>\n",
       "      <th>description</th>\n",
       "      <th>default_crs</th>\n",
       "      <th>default_resolution</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>name</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>s2_cogs</th>\n",
       "      <td>s2_cogs</td>\n",
       "      <td>Sentinel-2a and Sentinel-2b imagery, processed to Level 2A (Surface Reflectance) and converted to Cloud Optimized GeoTIFFs</td>\n",
       "      <td>EPSG:3857</td>\n",
       "      <td>(-10.0, 10.0)</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            name  \\\n",
       "name               \n",
       "s2_cogs  s2_cogs   \n",
       "\n",
       "                                                                                                                        description  \\\n",
       "name                                                                                                                                  \n",
       "s2_cogs  Sentinel-2a and Sentinel-2b imagery, processed to Level 2A (Surface Reflectance) and converted to Cloud Optimized GeoTIFFs   \n",
       "\n",
       "        default_crs default_resolution  \n",
       "name                                    \n",
       "s2_cogs   EPSG:3857      (-10.0, 10.0)  "
      ]
     },
     "execution_count": 4,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "products = dc.list_products()\n",
    "\n",
    "display_columns = [\"name\",\n",
    "                   \"description\",\n",
    "                   \"default_crs\",\n",
    "                   \"default_resolution\"]\n",
    "\n",
    "products[display_columns].sort_index()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "fd31a34a",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>name</th>\n",
       "      <th>dtype</th>\n",
       "      <th>units</th>\n",
       "      <th>nodata</th>\n",
       "      <th>aliases</th>\n",
       "      <th>flags_definition</th>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>measurement</th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "      <th></th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>B01</th>\n",
       "      <td>B01</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_01, B01, coastal_aerosol]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B02</th>\n",
       "      <td>B02</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_02, B02, blue]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B03</th>\n",
       "      <td>B03</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_03, B03, green]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B04</th>\n",
       "      <td>B04</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_04, B04, red]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B05</th>\n",
       "      <td>B05</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_05, B05, red_edge_1]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B06</th>\n",
       "      <td>B06</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_06, B06, red_edge_2]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B07</th>\n",
       "      <td>B07</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_07, B07, red_edge_3]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B08</th>\n",
       "      <td>B08</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_08, B08, nir, nir_1]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B8A</th>\n",
       "      <td>B8A</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_8a, B8A, nir_narrow, nir_2]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B09</th>\n",
       "      <td>B09</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_09, B09, water_vapour]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B11</th>\n",
       "      <td>B11</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_11, B11, swir_1, swir_16]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>B12</th>\n",
       "      <td>B12</td>\n",
       "      <td>uint16</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[band_12, B12, swir_2, swir_22]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>SCL</th>\n",
       "      <td>SCL</td>\n",
       "      <td>uint8</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[mask, SCL, qa]</td>\n",
       "      <td>{'qa': {'bits': [0, 1, 2, 3, 4, 5, 6, 7], 'values': {'0': 'no data', '1': 'saturated or defective', '2': 'dark area pixels', '3': 'cloud shadows', '4': 'vegetation', '5': 'bare soils', '6': 'water...</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>tci</th>\n",
       "      <td>tci</td>\n",
       "      <td>uint8</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>[TCI, true_color_image]</td>\n",
       "      <td>NaN</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "            name   dtype units  nodata                            aliases  \\\n",
       "measurement                                                                 \n",
       "B01          B01  uint16     1       0    [band_01, B01, coastal_aerosol]   \n",
       "B02          B02  uint16     1       0               [band_02, B02, blue]   \n",
       "B03          B03  uint16     1       0              [band_03, B03, green]   \n",
       "B04          B04  uint16     1       0                [band_04, B04, red]   \n",
       "B05          B05  uint16     1       0         [band_05, B05, red_edge_1]   \n",
       "B06          B06  uint16     1       0         [band_06, B06, red_edge_2]   \n",
       "B07          B07  uint16     1       0         [band_07, B07, red_edge_3]   \n",
       "B08          B08  uint16     1       0         [band_08, B08, nir, nir_1]   \n",
       "B8A          B8A  uint16     1       0  [band_8a, B8A, nir_narrow, nir_2]   \n",
       "B09          B09  uint16     1       0       [band_09, B09, water_vapour]   \n",
       "B11          B11  uint16     1       0    [band_11, B11, swir_1, swir_16]   \n",
       "B12          B12  uint16     1       0    [band_12, B12, swir_2, swir_22]   \n",
       "SCL          SCL   uint8     1       0                    [mask, SCL, qa]   \n",
       "tci          tci   uint8     1       0            [TCI, true_color_image]   \n",
       "\n",
       "                                                                                                                                                                                                    flags_definition  \n",
       "measurement                                                                                                                                                                                                           \n",
       "B01                                                                                                                                                                                                              NaN  \n",
       "B02                                                                                                                                                                                                              NaN  \n",
       "B03                                                                                                                                                                                                              NaN  \n",
       "B04                                                                                                                                                                                                              NaN  \n",
       "B05                                                                                                                                                                                                              NaN  \n",
       "B06                                                                                                                                                                                                              NaN  \n",
       "B07                                                                                                                                                                                                              NaN  \n",
       "B08                                                                                                                                                                                                              NaN  \n",
       "B8A                                                                                                                                                                                                              NaN  \n",
       "B09                                                                                                                                                                                                              NaN  \n",
       "B11                                                                                                                                                                                                              NaN  \n",
       "B12                                                                                                                                                                                                              NaN  \n",
       "SCL          {'qa': {'bits': [0, 1, 2, 3, 4, 5, 6, 7], 'values': {'0': 'no data', '1': 'saturated or defective', '2': 'dark area pixels', '3': 'cloud shadows', '4': 'vegetation', '5': 'bare soils', '6': 'water...  \n",
       "tci                                                                                                                                                                                                              NaN  "
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "product = \"s2_cogs\"\n",
    "measurements = dc.list_measurements()\n",
    "measurements.loc[product]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "fca51d57",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Traceback (most recent call last):\r\n",
      "  File \"/usr/bin/jupyter-nbextension\", line 33, in <module>\r\n",
      "    sys.exit(load_entry_point('notebook==6.4.12', 'console_scripts', 'jupyter-nbextension')())\r\n",
      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\r\n",
      "  File \"/usr/lib/python3/dist-packages/jupyter_core/application.py\", line 282, in launch_instance\r\n",
      "    super().launch_instance(argv=argv, **kwargs)\r\n",
      "  File \"/usr/lib/python3/dist-packages/traitlets/config/application.py\", line 982, in launch_instance\r\n",
      "    app.start()\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 972, in start\r\n",
      "    super().start()\r\n",
      "  File \"/usr/lib/python3/dist-packages/jupyter_core/application.py\", line 271, in start\r\n",
      "    self.subapp.start()\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 882, in start\r\n",
      "    self.toggle_nbextension_python(self.extra_args[0])\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 855, in toggle_nbextension_python\r\n",
      "    return toggle(module,\r\n",
      "           ^^^^^^^^^^^^^^\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 470, in enable_nbextension_python\r\n",
      "    return _set_nbextension_state_python(True, module, user, sys_prefix,\r\n",
      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 368, in _set_nbextension_state_python\r\n",
      "    m, nbexts = _get_nbextension_metadata(module)\r\n",
      "                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\r\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 1107, in _get_nbextension_metadata\r\n",
      "    m = import_item(module)\r\n",
      "        ^^^^^^^^^^^^^^^^^^^\r\n",
      "  File \"/usr/lib/python3/dist-packages/traitlets/utils/importstring.py\", line 38, in import_item\r\n",
      "    return __import__(parts[0])\r\n",
      "           ^^^^^^^^^^^^^^^^^^^^\r\n",
      "ModuleNotFoundError: No module named 'ipyleaflet'\r\n"
     ]
    }
   ],
   "source": [
    "!jupyter nbextension enable --py --sys-prefix ipyleaflet"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "8b6198a9",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "application/vnd.jupyter.widget-view+json": {
       "model_id": "666da47bc21248e389be6cf2ab0a628d",
       "version_major": 2,
       "version_minor": 0
      },
      "text/plain": [
       "VBox(children=(HBox(children=(Dropdown(layout=Layout(flex='0 1 auto', width='10em'), options=('s2_cogs',), val…"
      ]
     },
     "execution_count": 6,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "DcViewer(dc=dc, \n",
    "         time='2024',\n",
    "         center=(0.565, 38.007),\n",
    "         zoom=6)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "id": "0db6e56f",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Enabling notebook extension jupyter-js-widgets/extension...\n",
      "      - Validating: problems found:\n",
      "        - require? \u001b[31m X\u001b[0m jupyter-js-widgets/extension\n",
      "Traceback (most recent call last):\n",
      "  File \"/usr/bin/jupyter-nbextension\", line 33, in <module>\n",
      "    sys.exit(load_entry_point('notebook==6.4.12', 'console_scripts', 'jupyter-nbextension')())\n",
      "             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
      "  File \"/usr/lib/python3/dist-packages/jupyter_core/application.py\", line 282, in launch_instance\n",
      "    super().launch_instance(argv=argv, **kwargs)\n",
      "  File \"/usr/lib/python3/dist-packages/traitlets/config/application.py\", line 982, in launch_instance\n",
      "    app.start()\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 972, in start\n",
      "    super().start()\n",
      "  File \"/usr/lib/python3/dist-packages/jupyter_core/application.py\", line 271, in start\n",
      "    self.subapp.start()\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 882, in start\n",
      "    self.toggle_nbextension_python(self.extra_args[0])\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 855, in toggle_nbextension_python\n",
      "    return toggle(module,\n",
      "           ^^^^^^^^^^^^^^\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 470, in enable_nbextension_python\n",
      "    return _set_nbextension_state_python(True, module, user, sys_prefix,\n",
      "           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 368, in _set_nbextension_state_python\n",
      "    m, nbexts = _get_nbextension_metadata(module)\n",
      "                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n",
      "  File \"/usr/lib/python3/dist-packages/notebook/nbextensions.py\", line 1107, in _get_nbextension_metadata\n",
      "    m = import_item(module)\n",
      "        ^^^^^^^^^^^^^^^^^^^\n",
      "  File \"/usr/lib/python3/dist-packages/traitlets/utils/importstring.py\", line 38, in import_item\n",
      "    return __import__(parts[0])\n",
      "           ^^^^^^^^^^^^^^^^^^^^\n",
      "ModuleNotFoundError: No module named 'ipyleaflet'\n"
     ]
    }
   ],
   "source": []
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "ced16f7a",
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3 (ipykernel)",
   "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.12.4"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}