GBDX

IKONOS

Vendor: DigitalGlobe
Imaging Type: Earth Observation Imagery
Archive Date Range: 2000-2014
Products: IKONOS Ortho-ready 2A
Spectral Bands: Panchromatic band, Multispectral 4-band

Last Updated: September 3, 2019

Table of Contents

Overview

For information on the IKONOS dataset on AWS, see IKONOS Datasheet.

IKONOS image

IKONOS image

Quickstart Examples

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

GBDXtools

This example shows how to search for IKONOS 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:IKONOS'
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 IKONOS data. To narrow down the search results set, include area, date range, or both. Search results can be further filtered by data attributes, they 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

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

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

https://vector.geobigdata.io/insight-vector/api/index/query/vector-gbdx-alpha-catalog-v2*/paging?q=item_type:IKONOS&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

https://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": "2012-01-01T00:00:00.000Z",
     "endDate": "2012-12-31T23:59:59.999Z",
     "types": ["IKONOS"]
     }

See Catalog API Response Example

Back to top

Types

Type Definition
Acquisition Acquisition records from all data sources
GBDXcatalogrecord The parent type for all records
IKONOS All IKONOS records
IKONOSAcquisition All IKONOS Acquisitions

Note: All IKONOS records are acquisitions. There are no "product" records in the IKONOS dataset.

Back to top

Properties

The following properties and metadata files are associated with IKONOS data in the GBDX catalog:

Property Description Values
bucketName The AWS bucket name where IKONOS data is stored. Bucket name + bucket location make up the S3 location for IKONOS data. This url may be used as input to some processing tasks. ikonos-product
bucketPrefix The AWS prefix for the location where IKONOS data is stored. Bucket name + bucket location make up the S3 location for IKONOS data. This url may be used as input to some processing tasks. po_1549873
catalogID The record ID provided by the vendor ex.: 2014051819045100000011602271
cloudCover Estimate of the max cloud-covered fraction of the product component 0.000 to 1.000, -999.000 if not assessed
components IKONOS scans are broken into components. A directory will typically include multiple components 2 (as part of the directory name, this component would be shown as a 7 digit number; "0000002"
footprintWkt The geometry that defines the location of the record MULTIPOLYGON
imageBands The type of image band of the image. For all IKONOS imagery imageBands = PAN_MS1. PAN_MS1
multiResolution The multispectral resolution for IKONOS imagery is 3.2 - 4m ex: 3.363062
offNadirAngle The spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired 8.466732771390973
panResolution The panchromatic resolution for IKONOS imagery is .80 - 1 m. ex: 0.8407655
platformName The name of the sensor platform that acquired the data. The properties "platformName" and "sensorPlatformName" have the same value IKONOS
sensorPlatformName The name of the satellite that acquired the image IKONOS
sunAzimuth The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north 138.05568
sunElevation The angle of the sun above the horizon 67.75093
targetAzimuth The azimuth of the target as seen by an observer sitting on the spacecraft measured in a clockwise direction from north 5.8030877
timestamp The timestamp indicates the date and time data was acquired by the satellite 2014-05-18T19:04:51.000Z
vendor The name of the data provider DigitalGlobe
zone All IKONOS data is project into UTM. The zone attribute is the UTM zone. 10N

Catalog ID

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

The IKONOS catalog ID is prepended by the date and time of collection. For example:

200702021935150000001162644

Directory Structure and Contents

IKONOS imagery is located in the bucket s3://ikonos-product. Each scan has its own prefix. These prefixes are named by an internal production order identifier( i.e. po_1642618).

Within each prefix there is a directory named "meta" containing a cloud mask as well as the original metadata properties file. This properties file is a human readable text file containing pertinent collection information.

In addition to the metadata directory, one or more product directories will exist. The IKONOS scans are broken into components. Each directory is named by the prefix name followed by a 7 digit component number. The following example shows a scan directory containing 3 components.
meta

po_1642618_0000000
po_1642618_0000001
po_1642618_0000002

Each component directory contains two files in tif format. One contains the multispectral image and the other contains the panchromatic image.

po_1642618_bgrn_0000000.tif
po_1642618_pan_0000000.tif

There is also one RPC file per image file. The RPCs define the camera model and needed to orthorectify the image.

po_1642618_bgrn_0000000_rpc.txt
po_1642618_pan_0000000_rpc.txt

In addition several shapefiles are included for each component. The aoi shapefile is the AOI of the original order to produce the strip. It's footprint is the same and the footprint of the image. The image shapefile contains the footprint of the scan as well as metadata related to the scan.

po_1642618_aoi.shp
po_1642618_component.shp
po_1642618_image.shp

S3 location

The S3 path to the files for an IKONOS scan is constructed from the following fields:

  • bucket
  • bucketPrefix
  • components

These three fields can be used to construct the paths to all of the files for a scan. For example the path to the multispectral tif file is:

<bucket>/<bucketPrefix>_<component>/<filePrefix>_bgrn_<component>.tif

Example:

s3://ikonos-product/po_1642618/po_1642618_0000003/po_1642618_bgrn_0000003.tif

Response Examples

GBDXtools Response Example

PYTHON

Images: 100
Show first return!
{'type': 'Feature',
 'geometry': {'type': 'MultiPolygon',
  'coordinates': [[[[-105.1877614129672, 39.80128971871709],
     [-105.1368989822058, 39.80406633867624],
     [-105.083207916071, 39.80706296791698],
     [-105.0833686394715, 39.77198408732038],
     [-105.0833921294003, 39.73690241291102],
     [-105.0834856943853, 39.70176395276986],
     [-105.137658386968, 39.69857951111467],
     [-105.188937534869, 39.69563441409097],
     [-105.2434492608446, 39.69241647024786],
     [-105.243253533071, 39.72761485811134],
     [-105.2414732981492, 39.76332967628968],
     [-105.2414696137895, 39.79837982093813],
     [-105.1877614129672, 39.80128971871709]]]]},
 'properties': {'ingest_source': 'GBDX_INGEST_ALPHA',
  'item_date': '2014-08-26T18:08:48.000Z',
  'original_crs': 'EPSG:4326',
  'item_type': ['GBDXCatalogRecord',
   'Acquisition',
   'IKONOS',
   'IKONOSAcquisition'],
  'name': None,
  'format': None,
  'ingest_date': '2017-03-09T18:45:19.494Z',
  'attributes': {'bucketName': 'ikonos-product',
   'sunAzimuth_dbl': 153.82251,
   'sensorPlatformName': 'IKONOS',
   'offNadirAngle_dbl': 22.809731111379513,
   'cloudCover_int': 10,
   'catalogID': '2014082618084840000010123666',
   'zone': '13N',
   'panResolution_dbl': 0.9127369,
   'vendor': 'DigitalGlobe',
   'bucketPrefix': 'po_1597512',
   'components_int': 1,
   'sunElevation_dbl': 58.187542,
   'imageBands': 'PAN_MS1',
   'platformName': 'IKONOS',
   'multiResolution_dbl': 3.6509476,
   'targetAzimuth_dbl': 246.69995},
  'ingest_attributes': {'_rest_user': '',
   '_rest_url': 'https://vector.geobigdata.io/insight-vector/api/vectors/gbdx-alpha-catalog-v2-%257Bitem_date%253Ayyyy%257D'},
  'id': '2014082618084840000010123666',
  'source': None,
  'text': ''}}

Vector Response Example

JSON

[
    {
        "geometry": {
            "coordinates": [
                [
                    [
                        [
                            -105.1877614129672,
                            39.80128971871709
                        ],
                        [
                            -105.1368989822058,
                            39.80406633867624
                        ],
                        [
                            -105.083207916071,
                            39.80706296791698
                        ],
                        [
                            -105.0833686394715,
                            39.77198408732038
                        ],
                        [
                            -105.0833921294003,
                            39.73690241291102
                        ],
                        [
                            -105.0834856943853,
                            39.70176395276986
                        ],
                        [
                            -105.137658386968,
                            39.69857951111467
                        ],
                        [
                            -105.188937534869,
                            39.69563441409097
                        ],
                        [
                            -105.2434492608446,
                            39.69241647024786
                        ],
                        [
                            -105.243253533071,
                            39.72761485811134
                        ],
                        [
                            -105.2414732981492,
                            39.76332967628968
                        ],
                        [
                            -105.2414696137895,
                            39.79837982093813
                        ],
                        [
                            -105.1877614129672,
                            39.80128971871709
                        ]
                    ]
                ]
            ],
            "type": "MultiPolygon"
        },
        "type": "Feature",
        "properties": {
            "ingest_source": "GBDX_INGEST_ALPHA",
            "item_date": "2014-08-26T18:08:48.000Z",
            "original_crs": "EPSG:4326",
            "item_type": [
                "GBDXCatalogRecord",
                "Acquisition",
                "IKONOS",
                "IKONOSAcquisition"
            ],
            "name": null,
            "format": null,
            "ingest_date": "2017-03-09T18:45:19.494Z",
            "attributes": {
                "bucketName": "ikonos-product",
                "sunAzimuth_dbl": 153.82251,
                "sensorPlatformName": "IKONOS",
                "offNadirAngle_dbl": 22.809731111379513,
                "cloudCover_int": 10,
                "catalogID": "2014082618084840000010123666",
                "zone": "13N",
                "panResolution_dbl": 0.9127369,
                "vendor": "DigitalGlobe",
                "bucketPrefix": "po_1597512",
                "components_int": 1,
                "sunElevation_dbl": 58.187542,
                "imageBands": "PAN_MS1",
                "platformName": "IKONOS",
                "multiResolution_dbl": 3.6509476,
                "targetAzimuth_dbl": 246.69995
            },
            "ingest_attributes": {
                "_rest_user": "",
                "_rest_url": "https://vector.geobigdata.io/insight-vector/api/vectors/gbdx-alpha-catalog-v2-%257Bitem_date%253Ayyyy%257D"
            },
            "id": "2014082618084840000010123666",
            "source": null,
            "text": ""
        }
    }
]

Catalog API Response Example

JSON


    "stats": {
        "recordsReturned": 4,
        "totalRecords": 4,
        "typeCounts": {
            "GBDXCatalogRecord": 4,
            "IKONOSAcquisition": 4,
            "Acquisition": 4,
            "IKONOS": 4
        }
    },
    "results": [
        {
            "identifier": "2014042318544060000011628805",
            "type": [
                "GBDXCatalogRecord",
                "Acquisition",
                "IKONOS",
                "IKONOSAcquisition"
            ],
            "properties": {
                "sunAzimuth": 141.2685,
                "cloudCover": 0,
                "targetAzimuth": 101.17916,
                "multiResolution": 3.44752456,
                "zone": "10N",
                "catalogID": "2014042318544060000011628805",
                "offNadirAngle": 16.59204141994331,
                "platformName": "IKONOS",
                "sunElevation": 60.4156,
                "vendor": "DigitalGlobe",
                "timestamp": "2014-04-23T18:54:40.000Z",
                "bucketPrefix": "po_1587367",
                "bucketName": "ikonos-product",
                "panResolution": 0.86188114,
                "footprintWkt": "MULTIPOLYGON(((-122.33206504 38.0137833713, -122.285735938 38.0132949075, -122.236983515 38.0128752217, -122.23679066 37.9384405757, -122.236572799 37.8640664855, -122.237404097 37.7898528391, -122.23755411 37.7156219682, -122.237588618 37.6414046097, -122.237627551 37.5672315144, -122.237574725 37.493115057, -122.237191424 37.4189550494, -122.235837569 37.3446498804, -122.237048578 37.2708740932, -122.23645173 37.1967773664, -122.236574436 37.1228552607, -122.237776869 37.049216413, -122.237918963 36.9753767286, -122.284593701 36.9760966251, -122.329056633 36.9768884986, -122.376131675 36.9778440084, -122.376444864 37.0516469856, -122.376764576 37.1254791177, -122.37669776 37.1992656558, -122.37706676 37.2731679049, -122.377232192 37.3470666465, -122.377164052 37.4209693735, -122.377576438 37.4950013806, -122.378391321 37.5691093175, -122.379212976 37.6432805589, -122.379583953 37.7174237742, -122.379941414 37.7915922736, -122.380324396 37.8658314007, -122.380689295 37.9400862159, -122.381075966 38.014408923, -122.33206504 38.0137833713)))",
                "components": 2,
                "imageBands": "PAN_MS1",
                "sensorPlatformName": "IKONOS"
            }
        },
        {
            "identifier": "2014051518555360000011630384",
            "type": [
                "GBDXCatalogRecord",
                "Acquisition",
                "IKONOS",
                "IKONOSAcquisition"
            ],
            "properties": {
                "sunAzimuth": 134.71371,
                "cloudCover": 27,
                "targetAzimuth": 83.85764,
                "multiResolution": 3.4249382,
                "zone": "10N",
                "catalogID": "2014051518555360000011630384",
                "offNadirAngle": 15.812952069764535,
                "platformName": "IKONOS",
                "sunElevation": 65.98571,
                "vendor": "DigitalGlobe",
                "timestamp": "2014-05-15T18:55:53.000Z",
                "bucketPrefix": "po_1589756",
                "bucketName": "ikonos-product",
                "panResolution": 0.85623455,
                "footprintWkt": "MULTIPOLYGON(((-122.451838151 38.0124624059, -122.405958609 38.0130963809, -122.357783798 38.0138729371, -122.357829494 37.9393723433, -122.357959248 37.8649525491, -122.358029448 37.7906212385, -122.358097471 37.7163734747, -122.358188237 37.6422035352, -122.358035894 37.5681236795, -122.357531589 37.4941518635, -122.35711995 37.4202477854, -122.35804243 37.3463247979, -122.35807933 37.2725219265, -122.35825498 37.1987855267, -122.35868443 37.1250946469, -122.358758567 37.0515159069, -122.358832777 36.9779779623, -122.405048162 36.977694237, -122.449068806 36.9775271033, -122.495663766 36.9774642551, -122.495968864 37.0509095701, -122.496285465 37.1243938165, -122.496595197 37.1979711456, -122.496924119 37.2716007735, -122.497253906 37.3453030079, -122.497590547 37.4190605005, -122.497923084 37.4928913099, -122.497132935 37.566894447, -122.498510986 37.6408040633, -122.498762295 37.7148742255, -122.499147242 37.7890112739, -122.499394776 37.8632447897, -122.500051758 37.9375154853, -122.500192364 38.0119316736, -122.451838151 38.0124624059)))",
                "components": 2,
                "imageBands": "PAN_MS1",
                "sensorPlatformName": "IKONOS"
            }
        }
[results truncated to show a single record]

Back to top

Contact

If you have any questions or issues with this task, please contact gbdx-support@digitalglobe.com.

Updated 2 months ago

IKONOS


Vendor: DigitalGlobe
Imaging Type: Earth Observation Imagery
Archive Date Range: 2000-2014
Products: IKONOS Ortho-ready 2A
Spectral Bands: Panchromatic band, Multispectral 4-band

Last Updated: September 3, 2019

Suggested Edits are limited on API Reference Pages

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