{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Quick Start - Raster Query\n", "\n", "In this section, we build upon the [Quickstart Point Query](quickstartpointquery.ipynb) guide and consider raster queries defined over areas. I.e., where that tutorial only dealt with point queries, we will now request data over extended areas.\n", "\n", "## Basic Raster Queries\n", "\n", "Once gain, we start with a minimal working example. Namely, we will request NDVI data from the Sentinel 2 l2a satellite. The *Normalized Difference Vegetation Index*, [NDVI](https://en.wikipedia.org/wiki/Normalized_difference_vegetation_index) for short, indicates the amount of vegetation present at the location and time in question. It is calculated from both the near infrared and red bands, takes values between 0 and 1 and has many uses across a wide range of remote-sensing applications. The Sentinel 2 l2a satellite produces a raster image of a particular location approximately once every 5 days.\n", "\n", "Since point queries are quick, it is generally a good idea to launch a point query first if working in an interactive environment such as Jupyter or R-studio. Note that we are requesting a single timestamp using ``snapshot``." ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "2023-08-15 09:42:14 - paw - INFO - The client authentication method is assumed to be OAuth2.\n", "2023-08-15 09:42:14 - paw - INFO - Legacy Environment is False\n", "2023-08-15 09:42:16 - paw - INFO - Authentication success.\n", "2023-08-15 09:42:16 - paw - INFO - HOST: https://api.ibm.com/geospatial/run/na/core/v3\n", "2023-08-15 09:42:16 - paw - INFO - TASK: submit STARTING.\n", "2023-08-15 09:42:47 - paw - INFO - TASK: submit COMPLETED.\n" ] }, { "data": { "text/html": [ "
\n", " | layer_id | \n", "layer_name | \n", "dataset | \n", "timestamp | \n", "longitude | \n", "latitude | \n", "value | \n", "datetime | \n", "
---|---|---|---|---|---|---|---|---|
0 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1606867200000 | \n", "-1.483759 | \n", "50.921633 | \n", "-0.0121 | \n", "2020-12-02 | \n", "
1 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1607126400000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.1069 | \n", "2020-12-05 | \n", "
2 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1607299200000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.013100000000000112 | \n", "2020-12-07 | \n", "
3 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1607558400000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.0038000000000000256 | \n", "2020-12-10 | \n", "
4 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1607731200000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.17470000000000008 | \n", "2020-12-12 | \n", "
... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "... | \n", "
58 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1619654400000 | \n", "-1.483759 | \n", "50.921633 | \n", "-0.0010999999999999899 | \n", "2021-04-29 | \n", "
59 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1619827200000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.18440000000000012 | \n", "2021-05-01 | \n", "
60 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1620086400000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.2752000000000001 | \n", "2021-05-04 | \n", "
61 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1620259200000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.11519999999999997 | \n", "2021-05-06 | \n", "
62 | \n", "49464 | \n", "Normalized difference vegetation index | \n", "High res imagery (ESA Sentinel 2) | \n", "1620518400000 | \n", "-1.483759 | \n", "50.921633 | \n", "0.12880000000000003 | \n", "2021-05-09 | \n", "
63 rows × 8 columns
\n", "