GBDX

MODIS (Retired from GBDX)

DEC 14, 2020 This dataset has been removed from GBDX and is no longer available.

IMPORTANT: This imagery dataset has been deprecated from GBDX and will be removed from our platform on December 14, 2020. Read the deprecation announcement.

Table of Contents

Overview

For information on the MODIS dataset on AWS, see MODIS on AWS.

MODIS imagery, Sri Lanka, 2017

Quickstart Examples

In these examples, "MODISProduct" is the value for "item_type" and "types."

GBDX Notebooks

This Notebook demonstrates the search and visualization of MODIS data.
You must be logged in to GBDX Notebooks to see it.

GBDX Notebooks MODIS data example

gbdxtools

This example shows how to search for MODIS data using gbdxtools:

Python

from gbdxtools import Interface
gbdx = Interface()

aoi = "POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))"
query = 'item_type:MODISProduct'
images = gbdx.vectors.query(aoi, query)      

print('Images: {}'.format(len(images)))
print("Show first return!")
images[0]

See gbdxtools Response example

VectorService API

Using the GBDX VectorService API, search by "item_type" to find MODISProduct data. To narrow down the search results set, include area, date range, or both. Search results can be further filtered by data attributes, can be sorted by properties, and the number of results returned can be set.

Vector Services Index Query Reference Overview

API Headers:

Authorization: Bearer [[token]]
Content-type: application/json

To retrieve a subset of results, send a POST request to

//vector.geobigdata.io/insight-vector/api/index/query/vector-gbdx-alpha-catalog-v2*/items?q=item_type:MODISProduct&count=10

with a request body. This is an example:

JSON

{
    "coordinates": [[[-105.35202026367188, 39.48113956424843], [-105.35202026367188, 40.044848254075546], [-104.65988159179688, 40.044848254075546], [-104.65988159179688, 39.48113956424843], [-105.35202026367188, 39.48113956424843]]],
    "type": "Polygon"
}

See Vector Services Response example

To retrieve all results, use a paging request instead. Send a POST request to //vector.geobigdata.io/insight-vector/api/index/query/vector-gbdx-alpha-catalog-v2*/paging?q=item_type:MODISProduct1&ttl=5m&sort=item_date:asc

JSON

{
    "coordinates": [[[-105.35202026367188, 39.48113956424843], [-105.35202026367188, 40.044848254075546], [-104.65988159179688, 40.044848254075546], [-104.65988159179688, 39.48113956424843], [-105.35202026367188, 39.48113956424843]]],
    "type": "Polygon"
}

Catalog API

Using the GBDX Catalog API, search by "types." To narrow the search results set, include area, date range, or both. Search results can be further filtered by properties.

API Headers:

Authorization: Bearer [[token]]
Content-type: application/json

Send a POST request to

//geobigdata.io/catalog/v2/search

with a request body. This is an example:

     {
    "searchAreaWkt": "POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))",
    "startDate": "2017-01-01T00:00:00.000Z",
    "endDate": "2017-12-31T23:59:59.999Z",
    "types": ["MODISProduct"]
     }

See Catalog API Response Example

Back to top

Types

There are eight "types" associated with MODIS data. See the search example below to learn how to search the GBDX catalog by type.

TypeDefinition
AquaAqua Reflectance satellite
GBDXCatalogRecordThe parent type for all GBDX catalog records
MOD09GATerra Reflectance dataset
MOD09GQTerra Reflectance dataset
MODISProductAll MODIS products in the GBDX catalog
MYD09GAAqua Reflectance dataset
MYD09GQAqua Reflectance dataset
TerraTerra Reflectance satellite

Back to top

Properties

The following properties and metadata files are associated with this dataset in the GBDX catalog:

PropertyValues
begin_dateThe date the collection of this image began
bucketNameThe name of the AWS s3 bucket for the image
bucketPrefixThe name of the AWS s3 prefix for the image
catalogIDThe vendor-supplied unique identifier for the image
datasetThe MODIS dataset that includes this product
datasetVersionThe version number of the dataset
dayNightFlagThis flag indicates whether the image was captured during the day or at night
end_dateThe date the collection of this image completed
footprintWktThe geometry that defines the location of the record
identifierThe vendor-supplied unique identifier for this image. This is also the "catalogID."
platformNameThe name of the instrument that collected the image. For this dataset, the platformName is "MODIS."
s3RegionThe AWS region the data is stored in. For MODIS, this is us-west-2
sensorPlatformNameThe name of the sensor platform or satellite that acquired the data; "Terra" or "Aqua"
timestampThe time stamp for the collection of this image
vendorThe vendor that supplies the data. For MODIS, the vendor is NASA.

Catalog ID

The Catalog ID is the product ID assigned by the vendor.

This is what a MODIS catalog ID looks like:

MYD09GA.A2017121.h14v04.006.2017123025647

S3 Location

The s3 location is the bucketName and bucketPrefix. These can be found in the search response.

s3://bucketName/bucketPrefix

The bucketName, bucketPrefix, and file name can all be found in the response body.

Back to top

Response Examples

Gbdxtools Response Example

PYTHON

Images: 100
Show first return!

{'type': 'Feature',
 'geometry': {'type': 'MultiPolygon',
  'coordinates': [[[[-104.52019611598, 39.7556817203217],
     [-91.1909609510465, 39.8554224326714],
     [-109.002143160265, 50.1046853303771],
     [-124.885362059179, 49.967693939585],
     [-104.52019611598, 39.7556817203217]]]]},
 'properties': {'ingest_source': 'GBDX_INGEST_ALPHA',
  'item_date': '2017-05-02T00:00:00.000Z',
  'original_crs': 'EPSG:4326',
  'item_type': ['GBDXCatalogRecord', 'MODISProduct', 'MYD09GQ', 'Aqua'],
  'name': None,
  'format': None,
  'ingest_date': '2019-02-01T16:14:01.106Z',
  'attributes': {'end_date': '2017-05-02T00:00:00.000Z',
   'bucketName': 'modis-pds',
   'datasetVersion': '6',
   'sensorPlatformName': 'Aqua',
   's3Region': 'us-west-2',
   'begin_date': '2017-05-02T00:00:00.000Z',
   'footprintWkt': 'POLYGON ((-104.52019611598 39.7556817203217, -124.885362059179 49.967693939585, -109.002143160265 50.1046853303771, -91.19096095104651 39.8554224326714, -104.52019611598 39.7556817203217))',
   'catalogID': 'MYD09GQ.A2017122.h10v04.006.2017124030021',
   'vendor': 'NASA',
   'bucketPrefix': 'MYD09GQ.006/10/04/2017122',
   'platformName': 'MODIS',
   'dataset': 'MYD09GQ',
   'dayNightFlag': 'Day',
   'timestamp': '2017-05-02'},
  'ingest_attributes': {'_rest_user': '',
   '_rest_url': '[full url path
  'id': 'MYD09GQ.A2017122.h10v04.006.2017124030021',
  'source': None,
  'text': ''}}

Vector Response Example

JSON

{
        "geometry": {
            "coordinates": [
                [
                    [
                        [
                            -104.52019611598,
                            39.7556817203217
                        ],
                        [
                            -91.1909609510465,
                            39.8554224326714
                        ],
                        [
                            -109.002143160265,
                            50.1046853303771
                        ],
                        [
                            -124.885362059179,
                            49.967693939585
                        ],
                        [
                            -104.52019611598,
                            39.7556817203217
                        ]
                    ]
                ]
            ],
            "type": "MultiPolygon"
        },
        "type": "Feature",
        "properties": {
            "ingest_source": "GBDX_INGEST_ALPHA",
            "item_date": "2017-05-02T00:00:00.000Z",
            "original_crs": "EPSG:4326",
            "item_type": [
                "GBDXCatalogRecord",
                "MODISProduct",
                "MYD09GQ",
                "Aqua"
            ],
            "name": null,
            "format": null,
            "ingest_date": "2019-02-01T16:14:01.106Z",
            "attributes": {
                "end_date": "2017-05-02T00:00:00.000Z",
                "bucketName": "modis-pds",
                "datasetVersion": "6",
                "sensorPlatformName": "Aqua",
                "s3Region": "us-west-2",
                "begin_date": "2017-05-02T00:00:00.000Z",
                "footprintWkt": "POLYGON ((-104.52019611598 39.7556817203217, -124.885362059179 49.967693939585, -109.002143160265 50.1046853303771, -91.19096095104651 39.8554224326714, -104.52019611598 39.7556817203217))",
                "catalogID": "MYD09GQ.A2017122.h10v04.006.2017124030021",
                "vendor": "NASA",
                "bucketPrefix": "MYD09GQ.006/10/04/2017122",
                "platformName": "MODIS",
                "dataset": "MYD09GQ",
                "dayNightFlag": "Day",
                "timestamp": "2017-05-02"
            },
            "ingest_attributes": {
                "_rest_user": "",
                "_rest_url": [full url path]
            },
            "id": "MYD09GQ.A2017122.h10v04.006.2017124030021",
            "source": null,
            "text": ""
        }
    }

Catalog API Response Example

JSON

 {
            "identifier": "MYD09GQ.A2017122.h09v04.005.2017124031315",
            "type": [
                "GBDXCatalogRecord",
                "MODISProduct",
                "MYD09GQ",
                "Aqua"
            ],
            "properties": {
                "begin_date": "2017-05-02T00:00:00.000Z",
                "end_date": "2017-05-02T00:00:00.000Z",
                "s3Region": "us-west-2",
                "timestamp": "2017-05-02T00:00:00.000Z",
                "bucketPrefix": "MYD09GQ.006/09/04/2017122",
                "footprintWkt": "MULTIPOLYGON(((-117.746445975 39.7342308151, -104.235445822 39.8623890159, -124.615349244 50.115917828, -140.795234672 49.9394188, -117.746445975 39.7342308151)))",
                "catalogID": "MYD09GQ.A2017122.h09v04.006.2017124031315",
                "datasetVersion": "6",
                "bucketName": "modis-pds",
                "sensorPlatformName": "Aqua",
                "vendor": "NASA",
                "dataset": "MYD09GQ",
                "platformName": "MODIS",
                "dayNightFlag": "Day"
            }
        }
[results truncated]

Back to top

Contact

If you have any questions or issues with this task, please contact [email protected].

Updated about a month ago

MODIS (Retired from GBDX)


DEC 14, 2020 This dataset has been removed from GBDX and is no longer available.

IMPORTANT: This imagery dataset has been deprecated from GBDX and will be removed from our platform on December 14, 2020. Read the deprecation announcement.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.