{"_id":"5997286999900500197dff28","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":37,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe","5a96f89c89442e002041144b","5b3f9b7267cbc90003d283a5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"category":{"_id":"595412446ed4d9001b3e7b37","project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-06-28T20:32:04.415Z","from_sync":false,"order":3,"slug":"gbdx-data-sets-in-progress","title":"Data Sets on GBDX"},"user":"55fae9d4825d5f19001fa379","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-18T17:48:25.754Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"# Overview\nThe IKONOS dataset includes more than 12 years of panchromatic and multispectral satellite imagery.  The IKONOS satelite launched in 1999 and collected imagery with .80-meter resolution and multispectral imagery with 3.2-meter resolution until early 2015.\n\n**Uses**: Useful for image analysis, map creation, and change detection.\n\n**Spectral Bands**: Panchromatic band, Multispectral 4-band\n**Date Range**: 2000-2014\n\n**Products available through GBDX**: IKONOS Ortho-ready 2A\n\nSee the [IKONOS Data Sheet](https://dg-cms-uploads-production.s3.amazonaws.com/uploads/document/file/96/DG_IKONOS_DS.pdf) for more details.\n\n\nIKONOS Ortho-ready 2A products are cataloged on GBDX. They do not need to be ordered. See the [S3 Location](#section-s3-location) section to learn how to find the location of an IKONOS acquisition. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f22ffe5-ikonos-data-post.jpeg\",\n        \"ikonos-data-post.jpeg\",\n        875,\n        485,\n        \"#36373d\"\n      ],\n      \"caption\": \"IKONOS Multispectral Image\"\n    }\n  ]\n}\n[/block]\n# Search \n\nUsing the GBDX Catalog API, search by \"types\" to find IKONOS data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of an\n\n\n## Catalog V2 API Request\n\nSend a ```POST``` request to ```https://geobigdata.io/catalog/v2/search``` with a request body. \n\nFor gbdxtools, see  <a href=\"http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview\">Catalog Search Overview</a>\n\n## Search Example 1: Search by Types\n\nSearch by the type \"IKONOS\". \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"    {\\n    \\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\\\",\\n    \\t\\\"startDate\\\": \\\"2013-06-01T12:00:00.000Z\\\",\\n    \\t\\\"endDate\\\": \\\"2014-06-06T12:00:00.000Z\\\",\\n    \\t\\\"types\\\": [\\\"IKONOS\\\"]\\n    }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n\n## Search Result Example \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" {\\n    \\\"stats\\\": {\\n        \\\"recordsReturned\\\": 4,\\n        \\\"totalRecords\\\": 4,\\n        \\\"typeCounts\\\": {\\n            \\\"GBDXCatalogRecord\\\": 4,\\n            \\\"IKONOSAcquisition\\\": 4,\\n            \\\"Acquisition\\\": 4,\\n            \\\"IKONOS\\\": 4\\n        }\\n    },\\n    \\\"results\\\": [\\n        {\\n            \\\"identifier\\\": \\\"2014051819045100000011602271\\\",\\n            \\\"type\\\": [\\n                \\\"GBDXCatalogRecord\\\",\\n                \\\"Acquisition\\\",\\n                \\\"IKONOS\\\",\\n                \\\"IKONOSAcquisition\\\"\\n            ],\\n            \\\"properties\\\": {\\n                \\\"sunAzimuth\\\": 138.05568,\\n                \\\"cloudCover\\\": 14,\\n                \\\"targetAzimuth\\\": 5.8030877,\\n                \\\"multiResolution\\\": 3.363062,\\n                \\\"zone\\\": \\\"10N\\\",\\n                \\\"catalogID\\\": \\\"2014051819045100000011602271\\\",\\n                \\\"offNadirAngle\\\": 8.466732771390973,\\n                \\\"platformName\\\": \\\"IKONOS\\\",\\n                \\\"sunElevation\\\": 67.75093,\\n                \\\"vendor\\\": \\\"DigitalGlobe\\\",\\n                \\\"timestamp\\\": \\\"2014-05-18T19:04:51.000Z\\\",\\n                \\\"bucketPrefix\\\": \\\"po_1589873\\\",\\n                \\\"bucketName\\\": \\\"ikonos-product\\\",\\n                \\\"panResolution\\\": 0.8407655,\\n                \\\"footprintWkt\\\": \\\"MULTIPOLYGON(((-122.447100942 38.009674487, -122.405065387 38.0099824057, -122.360801534 38.0104292797, -122.360888189 37.9366972827, -122.360915202 37.8629486558, -122.360995306 37.7893586117, -122.361062053 37.7158250194, -122.361085278 37.6423306511, -122.361179125 37.5690723099, -122.361178606 37.4959540291, -122.361273151 37.4229310949, -122.361323759 37.3493866053, -122.36138463 37.27629299, -122.36146581 37.2032024157, -122.361508363 37.130061414, -122.361554153 37.0571233329, -122.361606515 36.9842365938, -122.404941998 36.9841393043, -122.446074055 36.984146552, -122.489463558 36.9842658, -122.489578501 37.0570998457, -122.489705039 37.1299801272, -122.489829829 37.2029128581, -122.489934273 37.2758806469, -122.490068076 37.3489377906, -122.490225408 37.4220740983, -122.490333326 37.4952226093, -122.490409701 37.5690203212, -122.490602637 37.6419039354, -122.490799032 37.7152885378, -122.490949706 37.7887401763, -122.49109447 37.8622395224, -122.491322445 37.9358165729, -122.491436876 38.0095536189, -122.447100942 38.009674487)))\\\",\\n                \\\"components\\\": 2,\\n                \\\"imageBands\\\": \\\"PAN_MS1\\\",\\n                \\\"sensorPlatformName\\\": \\\"IKONOS\\\"\\n            }\\n        }\\n      \\n      truncated to show a single IKONOS acquisition\",\n      \"language\": \"json\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\n# Types\n\nThere are four \"types\" associated with IKONOS records. \n\nType | Definition\n--- | ---\nGBDXCatalogRecord | The parent type for all GBDX catalog records\nAcquisition | The parent type for all Acquistions\nIKONOS | All IKONOS records. \nIKONOSAcquisition | All IKONOS Acqusitions\n\n***Note: All IKONOS records are IKONOS acquisitions. A search for types \"IKONOS\" or \"IKONOSAcquisitions\" will return the same results set.***\n\n\n# Properties\n\nThe following properties  and metadata files are associated with an IKONOS record in the GBDX catalog. \n\nProperty | Description | Values\n--- | --- | ---\nbucketName | 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\nbucketPrefix | 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\"\ncatalogID | The record ID provided by the vendor | 2014051819045100000011602271\ncloudCover| Estimate of the max cloud-covered fraction of the product component | 0.000 to 1.000, -999.000 if not assessed\ncomponents | 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\"\nfootprintWkt| The geometry that defines the location of the record| MULTIPOLYGON \nimageBands | The type of image band of the image. For all IKONOS imagery imageBands = PAN_MS1 | PAN_MS1\nmultiResolution | The multispectral resolution for IKONOS imagery is 3.2 - 4m | ex: 3.363062\noffNadirAngle | 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\npanResolution |The panchromatic resolution for IKONOS imagery is .80 - 1 m | ex: 0.8407655\nplatformName |The name of the sensor platform that acquired the data. The properties \"platformName\" and \"sensorPlatformName\" have the same value | IKONOS\nsensorPlatformName | The name of the satellite that acquired the image | IKONOS\nsunAzimuth |The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north | 138.05568\nsunElevation |The angle of the sun above the horizon | 67.75093\ntargetAzimuth|The azimuth of the target as seen by an observer sitting on the spacecraft measured in a clockwise direction from north | 5.8030877\ntimestamp | The timestamp indicates the date and time data was acquired by the satellite | 2014-05-18T19:04:51.000Z\nvendor | The name of the data provider. | DigitalGlobe\nzone |All IKONOS data is project into UTM. The zone attribute is the UTM zone | 10N\n\n# Catalog ID\nThe Catalog ID is the product ID assigned by the vendor. \n\nThe IKONOS catalog ID is prepended by the date and time of collection. For example:\n\n```200702021935150000001162644```\n\n# Directory Structure and Contents\nIKONOS 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).  \n\nWithin 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.\n\nIn 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.\nmeta\npo_1642618_0000000\npo_1642618_0000001\npo_1642618_0000002\n\nEach component directory contains two files in tif format. One contains the multispectral image and the other contains the pancromatic image.\npo_1642618_bgrn_0000000.tif\npo_1642618_pan_0000000.tif\nThere is also one RPC file per image file. The RPCs define the camera model and needed to orthorectify the image.\npo_1642618_bgrn_0000000_rpc.txt\npo_1642618_pan_0000000_rpc.txt\n\nIn 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 metdata related to the scan.\npo_1642618_aoi.shp\npo_1642618_component.shp\npo_1642618_image.shp\n\n\n# S3 location\nThe S3 path to the files for an IKONOS scan is constructed from the following fields: \nbucket\nbucketPrefix\ncomponents\n\nThese 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:\n\n<bucket>/<bucketPrefix>_<component>/<filePrefix>_bgrn_<component>.tif\ns3://ikonos-product/po_1642618/po_1642618_0000003/po_1642618_bgrn_0000003.tif\n\n\n# Processing IKONOS Data\n\nTo ortho-rectify an IKONOS image, use [ENVI® RPC Orthorectification](doc:envi-rpc-orthorectification).\n\nTo pan-sharpen an IKONOS image, use [ENVI® NNDiffuse PanSharpening](doc:envi-nndiffuse-pansharpening).","excerpt":"","slug":"ikonos","type":"basic","title":"IKONOS"}
# Overview The IKONOS dataset includes more than 12 years of panchromatic and multispectral satellite imagery. The IKONOS satelite launched in 1999 and collected imagery with .80-meter resolution and multispectral imagery with 3.2-meter resolution until early 2015. **Uses**: Useful for image analysis, map creation, and change detection. **Spectral Bands**: Panchromatic band, Multispectral 4-band **Date Range**: 2000-2014 **Products available through GBDX**: IKONOS Ortho-ready 2A See the [IKONOS Data Sheet](https://dg-cms-uploads-production.s3.amazonaws.com/uploads/document/file/96/DG_IKONOS_DS.pdf) for more details. IKONOS Ortho-ready 2A products are cataloged on GBDX. They do not need to be ordered. See the [S3 Location](#section-s3-location) section to learn how to find the location of an IKONOS acquisition. [block:image] { "images": [ { "image": [ "https://files.readme.io/f22ffe5-ikonos-data-post.jpeg", "ikonos-data-post.jpeg", 875, 485, "#36373d" ], "caption": "IKONOS Multispectral Image" } ] } [/block] # Search Using the GBDX Catalog API, search by "types" to find IKONOS data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of an ## Catalog V2 API Request Send a ```POST``` request to ```https://geobigdata.io/catalog/v2/search``` with a request body. For gbdxtools, see <a href="http://gbdxtools.readthedocs.io/en/latest/catalog_search.html#catalog-search-overview">Catalog Search Overview</a> ## Search Example 1: Search by Types Search by the type "IKONOS". [block:code] { "codes": [ { "code": " {\n \t\"searchAreaWkt\": \"POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))\",\n \t\"startDate\": \"2013-06-01T12:00:00.000Z\",\n \t\"endDate\": \"2014-06-06T12:00:00.000Z\",\n \t\"types\": [\"IKONOS\"]\n }", "language": "json" } ] } [/block] ## Search Result Example [block:code] { "codes": [ { "code": " {\n \"stats\": {\n \"recordsReturned\": 4,\n \"totalRecords\": 4,\n \"typeCounts\": {\n \"GBDXCatalogRecord\": 4,\n \"IKONOSAcquisition\": 4,\n \"Acquisition\": 4,\n \"IKONOS\": 4\n }\n },\n \"results\": [\n {\n \"identifier\": \"2014051819045100000011602271\",\n \"type\": [\n \"GBDXCatalogRecord\",\n \"Acquisition\",\n \"IKONOS\",\n \"IKONOSAcquisition\"\n ],\n \"properties\": {\n \"sunAzimuth\": 138.05568,\n \"cloudCover\": 14,\n \"targetAzimuth\": 5.8030877,\n \"multiResolution\": 3.363062,\n \"zone\": \"10N\",\n \"catalogID\": \"2014051819045100000011602271\",\n \"offNadirAngle\": 8.466732771390973,\n \"platformName\": \"IKONOS\",\n \"sunElevation\": 67.75093,\n \"vendor\": \"DigitalGlobe\",\n \"timestamp\": \"2014-05-18T19:04:51.000Z\",\n \"bucketPrefix\": \"po_1589873\",\n \"bucketName\": \"ikonos-product\",\n \"panResolution\": 0.8407655,\n \"footprintWkt\": \"MULTIPOLYGON(((-122.447100942 38.009674487, -122.405065387 38.0099824057, -122.360801534 38.0104292797, -122.360888189 37.9366972827, -122.360915202 37.8629486558, -122.360995306 37.7893586117, -122.361062053 37.7158250194, -122.361085278 37.6423306511, -122.361179125 37.5690723099, -122.361178606 37.4959540291, -122.361273151 37.4229310949, -122.361323759 37.3493866053, -122.36138463 37.27629299, -122.36146581 37.2032024157, -122.361508363 37.130061414, -122.361554153 37.0571233329, -122.361606515 36.9842365938, -122.404941998 36.9841393043, -122.446074055 36.984146552, -122.489463558 36.9842658, -122.489578501 37.0570998457, -122.489705039 37.1299801272, -122.489829829 37.2029128581, -122.489934273 37.2758806469, -122.490068076 37.3489377906, -122.490225408 37.4220740983, -122.490333326 37.4952226093, -122.490409701 37.5690203212, -122.490602637 37.6419039354, -122.490799032 37.7152885378, -122.490949706 37.7887401763, -122.49109447 37.8622395224, -122.491322445 37.9358165729, -122.491436876 38.0095536189, -122.447100942 38.009674487)))\",\n \"components\": 2,\n \"imageBands\": \"PAN_MS1\",\n \"sensorPlatformName\": \"IKONOS\"\n }\n }\n \n truncated to show a single IKONOS acquisition", "language": "json", "name": null } ] } [/block] # Types There are four "types" associated with IKONOS records. Type | Definition --- | --- GBDXCatalogRecord | The parent type for all GBDX catalog records Acquisition | The parent type for all Acquistions IKONOS | All IKONOS records. IKONOSAcquisition | All IKONOS Acqusitions ***Note: All IKONOS records are IKONOS acquisitions. A search for types "IKONOS" or "IKONOSAcquisitions" will return the same results set.*** # Properties The following properties and metadata files are associated with an IKONOS record 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 | 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 pancromatic 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 metdata 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 s3://ikonos-product/po_1642618/po_1642618_0000003/po_1642618_bgrn_0000003.tif # Processing IKONOS Data To ortho-rectify an IKONOS image, use [ENVI® RPC Orthorectification](doc:envi-rpc-orthorectification). To pan-sharpen an IKONOS image, use [ENVI® NNDiffuse PanSharpening](doc:envi-nndiffuse-pansharpening).