{"_id":"5a3454ecb36f25001c57bd46","project":"55faeacad0e22017005b8265","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":36,"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"],"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-12-15T23:04:12.979Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":8,"body":"# Overview\nWorldView-1 has collected high resolution, panchromatic imagery since its launch in September 2007. The satellite is equipped with state-of-the-art geolocation accuracy and can cover one million sq. km per day of half-meter imagery.\n\n**Uses**\nWorldView-1’s highly detailed, panchromatic imagery is useful for in-depth image analysis, change detection, and precise map creation. It can geolocate features to less than 5 m to create maps in remote areas.\n\n**Spectral Bands**\n\nPanchromatic band only\n\n\n**Date Range**\nSeptember 2007 – present\n\n**Products available through GBDX**\nDigitalGlobe Basic (Level 1B imagery)\n\nSee the [Worldview-1 Data Sheet](https://dg-cms-uploads-production.s3.amazonaws.com/uploads/document/file/99/WorldView1-DS-WV1_V02.pdf) for more details.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/dfef7ea-wv1-data-post.jpeg\",\n        \"wv1-data-post.jpeg\",\n        879,\n        485,\n        \"#353535\"\n      ],\n      \"caption\": \"Worldview-1 panchromatic image\"\n    }\n  ]\n}\n[/block]\n# Types\n\nType | Description\n--- | ---\nWV01 | Worldview-1, panchromatic imagery\n\n# Search \n\nUsing the GBDX Catalog V2 API, search by \"types\" to find Worldview-1 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a Worldview-1 record. \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 Examples\n\n### Search Example 1: Search for WV01 Acquisitions \n\nThis search will return Worldview-1 Acquisitions within the specified area and date range.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"  {\\n    \\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\\\",\\n    \\t\\\"startDate\\\": \\\"2014-01-01T00:00:00.000Z\\\",\\n    \\t\\\"endDate\\\": \\\"2014-12-31T23:59:59.999Z\\\",\\n    \\t\\\"types\\\": [\\\"WV01\\\",\\n    \\t\\t\\t   \\\"DigitalGlobeAcquisition\\\"]\\n  }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Search Example 1: Results for Search for Worldview-1 Acquisitions \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"stats\\\": {\\n        \\\"recordsReturned\\\": 74,\\n        \\\"totalRecords\\\": 74,\\n        \\\"typeCounts\\\": {\\n            \\\"GBDXCatalogRecord\\\": 74,\\n            \\\"DigitalGlobeAcquisition\\\": 74,\\n            \\\"WV01\\\": 74,\\n            \\\"Acquisition\\\": 74\\n        }\\n    },\\n    \\\"results\\\": [\\n        {\\n            \\\"identifier\\\": \\\"102001002C90CA00\\\",\\n            \\\"type\\\": [\\n                \\\"GBDXCatalogRecord\\\",\\n                \\\"Acquisition\\\",\\n                \\\"DigitalGlobeAcquisition\\\",\\n                \\\"WV01\\\"\\n            ],\\n            \\\"properties\\\": {\\n                \\\"offNadirAngle_min\\\": 34.0340270996094,\\n                \\\"offNadirAngle_start\\\": 34.0340270996094,\\n                \\\"targetAzimuth_min\\\": 100.364738464355,\\n                \\\"multiResolution_min\\\": null,\\n                \\\"cloudCover\\\": 71,\\n                \\\"sunAzimuth_max\\\": 154.423583984375,\\n                \\\"targetAzimuth\\\": 101.401344299316,\\n                \\\"multiResolution\\\": null,\\n                \\\"catalogID\\\": \\\"102001002C90CA00\\\",\\n                \\\"panResolution_max\\\": 0.703037858009338,\\n                \\\"timestamp\\\": \\\"2014-04-04T18:03:56.225Z\\\",\\n                \\\"sunAzimuth_min\\\": 154.300903320312,\\n                \\\"browseURL\\\": \\\"https://geobigdata.io/thumbnails/v1/browse/102001002C90CA00.large.png\\\",\\n                \\\"targetAzimuth_max\\\": 102.358558654785,\\n                \\\"sunAzimuth\\\": 154.360046386719,\\n                \\\"sunElevation_min\\\": 53.7097778320312,\\n                \\\"offNadirAngle\\\": 34.2682800292969,\\n                \\\"stereoPair\\\": null,\\n                \\\"platformName\\\": \\\"WORLDVIEW01\\\",\\n                \\\"multiResolution_start\\\": null,\\n                \\\"sunElevation\\\": 53.8141632080078,\\n                \\\"vendor\\\": \\\"DigitalGlobe\\\",\\n                \\\"scanDirection\\\": \\\"Forward\\\",\\n                \\\"panResolution_end\\\": 0.703037858009338,\\n                \\\"panResolution_start\\\": 0.695971190929413,\\n                \\\"targetAzimuth_end\\\": 102.358558654785,\\n                \\\"panResolution_min\\\": 0.695971190929413,\\n                \\\"offNadirAngle_max\\\": 34.4900856018066,\\n                \\\"multiResolution_end\\\": null,\\n                \\\"multiResolution_max\\\": null,\\n                \\\"sunElevation_max\\\": 53.911190032959,\\n                \\\"offNadirAngle_end\\\": 34.4900856018066,\\n                \\\"panResolution\\\": 0.699512958526611,\\n                \\\"footprintWkt\\\": \\\"MULTIPOLYGON(((-105.2962337 39.78509511, -104.976098 39.76439814, -104.9763366 39.70838518, -104.9764659 39.6522475, -104.9767401 39.5960113, -104.9771385 39.54218685, -105.2999071 39.56629622, -105.2985721 39.61922254, -105.2965056 39.67437784, -105.2966604 39.72984386, -105.2962337 39.78509511)))\\\",\\n                \\\"targetAzimuth_start\\\": 100.364738464355,\\n                \\\"imageBands\\\": \\\"PAN\\\",\\n                \\\"sensorPlatformName\\\": \\\"WORLDVIEW01\\\"\\n            }\\n        },\\n      \\n      [results truncated]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n### Search Example 2: Search for WV01 1B Products\n\nThis search will return WV01 1B products within the specified area and date range. \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"     {\\n    \\t\\\"searchAreaWkt\\\": \\\"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\\\",\\n    \\t\\\"startDate\\\": \\\"2014-01-01T00:00:00.000Z\\\",\\n    \\t\\\"endDate\\\": \\\"2014-12-31T23:59:59.999Z\\\",\\n    \\t\\\"types\\\": [\\\"WV01\\\",\\n    \\t\\t\\\"DigitalGlobeProduct\\\",\\n    \\t\\t\\\"1BProduct\\\"]\\n    }\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Search Example 2: Results for Search for WV01 1B Products\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"stats\\\": {\\n        \\\"recordsReturned\\\": 38,\\n        \\\"totalRecords\\\": 38,\\n        \\\"typeCounts\\\": {\\n            \\\"GBDXCatalogRecord\\\": 38,\\n            \\\"1BProduct\\\": 38,\\n            \\\"WV01\\\": 38,\\n            \\\"DigitalGlobeProduct\\\": 38\\n        }\\n    },\\n    \\\"results\\\": [\\n        {\\n            \\\"identifier\\\": \\\"102001003605A600_P008_PAN_055955712010\\\",\\n            \\\"type\\\": [\\n                \\\"GBDXCatalogRecord\\\",\\n                \\\"WV01\\\",\\n                \\\"DigitalGlobeProduct\\\",\\n                \\\"1BProduct\\\"\\n            ],\\n            \\\"properties\\\": {\\n                \\\"rpbFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.RPB\\\",\\n                \\\"sunAzimuth\\\": 176.1,\\n                \\\"cloudCover\\\": 1,\\n                \\\"catalogID\\\": \\\"102001003605A600\\\",\\n                \\\"xmlFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.XML\\\",\\n                \\\"timestamp\\\": \\\"2014-11-19T18:31:00.000Z\\\",\\n                \\\"attFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.ATT\\\",\\n                \\\"browseJpgFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008-BROWSE.JPG\\\",\\n                \\\"offNadirAngle\\\": 21.2,\\n                \\\"platformName\\\": \\\"WORLDVIEW01\\\",\\n                \\\"sunElevation\\\": 30.7,\\n                \\\"vendor\\\": \\\"DigitalGlobe\\\",\\n                \\\"soli\\\": \\\"055955712\\\",\\n                \\\"bands\\\": \\\"P\\\",\\n                \\\"bucketPrefix\\\": \\\"055955712010_01_003/055955712010_01/055955712010_01_P008_PAN\\\",\\n                \\\"readmeTxtFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008_README.TXT\\\",\\n                \\\"imageFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.TIF\\\",\\n                \\\"part\\\": 8,\\n                \\\"bucketName\\\": \\\"receiving-dgcs-tdgplatform-com\\\",\\n                \\\"resolution\\\": 0.565,\\n                \\\"footprintWkt\\\": \\\"MULTIPOLYGON(((-105.036978274 39.8544898502, -104.800320467 39.870360396, -104.802562181 39.7211479845, -105.035048044 39.708882023, -105.036978274 39.8544898502)))\\\",\\n                \\\"geoFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.GEO\\\",\\n                \\\"tilFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.TIL\\\",\\n                \\\"sensorPlatformName\\\": \\\"WORLDVIEW01\\\",\\n                \\\"productLevel\\\": \\\"LV1B\\\",\\n                \\\"imdFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.IMD\\\",\\n                \\\"ephFile\\\": \\\"14NOV19183100-P1BS-055955712010_01_P008.EPH\\\",\\n                \\\"bandsList\\\": \\\"BAND_P\\\"\\n            }\\n        },\\n      \\n      [Results truncated to show one record]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n\n# Worldview-1 Product Properties\n\nThe following identifying information, properties, and metadata files are associated with a Worldview-1 1B product in the GBDX catalog. \n\nProperty | Description | Values\n--- | --- | ---\nbands | Indicates panchromatic image or multispectral image | \"Pan\" or \"Multi\"\nbandsList | The specific bands that are part of this product. | Example: BAND_B,BAND_G,BAND_R,BAND_N\nbucketName | name of the AWS receiving bucket the product is stored in. | n/a\nbucketPrefix | The customer's AWS Prefix. This is typically the Account ID. | n/a\ncatalogID | The catalog ID for the acquisition this product is derived from. | Example catalog ID: 1020010007AF7100\ncloudCover | Estimate of the max cloud-covered fraction of the product component. | 0.000 to 1.000, -999.000 if not assessed.\nfootprintWkt | The spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the Location | MULTIPOLYGON \nidentifier | The identifier for the product, also referred to as \"product ID\". | 1040010006129900_P001_MUL_056814719010\nimageFile | The product image. The file extension is .tiff. | n/a\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.| : ≥ 0.0, decimal points may vary.\npart |The part ID for an order.  | For this property, the value is a single digit. For example, part: 5. The part ID is indicated in the Product ID and the metadata file names as \"00x\", or in this example, \"005\".\nplatformName | See \"sensorPlatformName\". This field exists for backwards compatibility purposes only. | n/a\nproductLevel | At this time, Catalog V2 only catalogs Level 1B  products. A 1B product is a \"basic\" DigitalGlobe product. | 1B\nresolution | The resampled image pixel size derived from Ground Sample Distance (GSD).|Example: 0.588 \nsensorPlatformName | The name of the DigitalGlobe satellite that captured the acquisition this product is derived from. | See all DG satellites.\nsoli | Sales Order Line Item | Example: 055734390\nsunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north. | Range: 0.00000 – 360.00000\nsunElevation |The angle of the sun above the horizon.| Range: 0.00000 – 90.00000\ntimestamp | The timestamp on the acquisition the product is derived from. | Example: 2014-07-12T17:40:46.000Z\nVendor | For products, the vendor is DigitalGlobe. | N/A\n\n\n### Image Support Data (DigitalGlobe Products)\nDigitalGlobe products have a set of metadata files called Image Support Data (ISD).  The files included with a DigitalGlobe product on GBDX are: \n\nFile | Details\n--- | ---\nattFile | Attitude File, File extension is Attitude File. The attitude file includes the time of first data point, the number of points, and the interval between the points and attitude information.\nbrowseJpgFile | Product Browse File, File extension is .JPG. The product browse file is a JPEG compressed browse image of the delivered product.\nephFile  | Ephemeris File, File extension is .EPH. The ephemeris file includes the time of first data point, the number of points, and the interval between the points and ephemeris information.\ngeoFile | Geometric Calibration File, File extension is .GEO. The geometric calibration file contains the standard photogrammetric parameters of a virtualcamera that models the corresponding camera and optical system for Basic Imagery products\nimdFile | Image Metadata Fle, File extension is .IMD. The image metadata file describes key attributes about the image product, including product level, corner coordinates, and projection information, and time of acquisition.\nreadmeTxtFile | Product Component Index File, File extension is .TXT.he README file provides copyright information and the names of the ISD files for a single product within a delivery.\nrpbFile | RPC00B File, File extension is .RPB. The RPC00B file contains the RPC information, which can be used to rectify the image. This is a mathematical mapping from object space coordinates to image space coordinates.\ntilFile | Tile Map File, File extension is .RPB. The tile map file assists the customer in determining what tile to ingest to look at a specific part of the order polygon.\nxmlFile | XML File, File extension is .XML. This file contains the same information as the combined README, Licensing, Image Metadata, Tile Map and RPC00Bfiles, in XML format. For Basic Imagery Products, the attitude, ephemeris, and geometric calibration file are included as well.\n\nThese files cannot be viewed in the GBDX Receiving Bucket, but they can be passed into a task. \n\n## Worldview-1 Acquisition Properties\n\nThese are the properties associated with a Worldview-1 Acquisition:\n\nProperty | Description | Values\n--- | --- | ---\nbrowseURL | This is the  browse url from the GBDX thumbnail service | ex. https://geobigdata.io/thumbnails/v1/browse/103001003778D300.large.png\ncatalogID |DigitalGlobe CatalogID for the raw data (acquisition). This is sometimes referred to as the \"acquisition ID\" |Ex.: 1020010007AF7100\ncloudCover |Estimate of the max cloud-covered fraction of the product component. | 0.000 to 1.000, -999.000 if not assessed.\nfootprintWkt | The spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the Location | MULTIPOLYGON \nidentifier | The \"identifier\" for a DigitalGlobe acquisition is the catalog ID | 1020010007AF7100\nimageBands |the image ands available for the image | See [Image Bands](#section-sensor-platforms-and-image-bands) below.\nmultiResolution | multispectral resolution  |Null for Worldview-1 Acquisitions (panchromatic only)\nmultiResolution_end |The multispectral resolution at the end of the collect |Null for Worldview-1 Acquisitions (panchromatic only)\nmultiResolution_max |The maximum multispectral resolution in the collect |Null for Worldview-1 Acquisitions (panchromatic only)\nmultiResolution_min |The minimum multispectral resolution in the collect |Null for Worldview-1 Acquisitions (panchromatic only)\nmultiResolution_start | The multispectral resolution of the start of of the collect|Null for Worldview-1 Acquisitions (panchromatic only)\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.| : ≥ 0.0, decimal points may vary.\noffNadirAngle_max |The maximum spacecraft elevation angle measured from nadir to the product center-line as seen from thespacecraft. | 0.0 to 90.0\noffNadirAngle_end |The end of 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. | Example: 33.7915306091309\noffNadirAngle_min | The maximum spacecraft elevation angle measured from nadir to the product center-line as seen from the spacecraft. | 0.0 to 90.0, Example: 30.0960826873779\nOffNadirAngle_start | The start of 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.| Example: 30.0960826873779\npanResolution |Panchromatic resolution | 0.602808654308319\npanResolution_end |The panchromatic resolution at the end of the collect |0.600724101066589\npanResolution_max |The maximum panchromatic resolution in the collect |0.605704009532928\npanResolution_min |The minimum panchromatic resolution in the collect |0.600724101066589\npanResolution_start |he panchromatic resolution at the start of the collect |0.605704009532928\nplatformName | The name of the sensor platform that acquired the data. platformName is in longhand, for example: WORLDVIEW02. This property is identical to \"sensorPlatformName\" below.| N/A\nscanDirection | The scan direction of the sensor when the acquisition was captured.|Values are \"Forward\" or \"Reverse\". The sensor platform Quickbird uses \"forward\" only. \nsensorPlatformName | The name of the sensor platform that acquired the data. sensorPlatformName is in longhand, for example: WORLDVIEW02. This property is identical to \"platformName\" above.| N/A\nstereoPair | Stereo pair data is not available on GBDX at this time. | N/A\nsunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north. | Range: 0.00000 – 360.00000\nsunAzimuth_max |Maximum azimuth angle of the sun measured from north clockwise. | 0.0 to 360.0\nsunAzimuth_min |Minimum azimuth angle of the sunmeasured from north clockwise. |0.0 to 360.0\nsunElevation |The angle of the sun above the horizon.| Range: 0.00000 – 90.00000\nsunElevation_max |Maximum azimuth angle of the sun measured from north clockwise. |0.0 to 360.0\nsunElevation_min |Minimum azimuth angle of the sun measured from north clockwise. |0.0 to 360.0\ntargetAzimuth |The azimuth of the target as seen by an observer sitting on the spacecraft measured in a clockwise direction from north. |49.6538887023926\ntargetAzimuth_end |This is the maximum target azimuth in the collect |50.8807907104492\ntargetAzimuth_max |This is the end of the target Azimuth for this collect | 50.8807907104492\ntargetAzimuth_min | This is the minimum target azimuth in the collect  |48.0979080200195\ntargetAzimuth_start | This is the start of the target Azimuth for this collect | 48.0979080200195\ntimestamp | The timestamp shows the date and time the acquisition data was collected | Ex. 2014-09-07T18:01:40.000Z\nvendor |The data provider|Ex. DigitalGlobe\n\n## Sensor Platforms and Image Bands\n \nSensorPlatformName |ImageBands |Description\n--- | ---\nGEOEYE01 | Pan_MS1 | Multispectral, 4-band\nQUICKBIRD02| Pan_MS1 |Multispectral, 4-band\nWORLDVIEW01 |Pan |Black & White (Panchromatic)\nWORLDVIEW02 |Pan_MS1_MS2 | Multispectral, 8-band\nWORLDVIEW03 | Pan_MS1_MS2, SWIR | Multispectral, 8-band; Shortwave infrared, 8-band,\n\n\n# Identifiers\n\n## Catalog ID\nThe Catalog ID is the  vendor's identifying information for the acquisition data collected by the satellite. This is sometimes referred to as the \"acquisition ID.\" The catalog ID for the acquisition is also displayed in the properties for products derived from that acquisition. The catalog ID is used to place an order for a product.\n\nExample Acquisition Catalog ID: `1020010007AF7100`\n\n## Product ID\n\nFor a DigitalGlobe product, the \"identifier\" field is the product ID. \n\nThe format of the product ID is:\n\n`<catid>_<part>_<band comb (MSI, PAN, SWR)>_<soli>`\n            \n  Example: 10300100301DCE00_P002_MUL_055825267010.\n\nIn this example:\n\nComponent | Value\n--- | ---\ncatid |10300100301DCE00\npart |002\nband combination | (MSI, PAN, SWR)\nsoli (sales order line item)|  055825267010\n\n# S3 location\n`s3://bucketName/bucketPrefix/File name`\n\nThe bucketName, bucketPrefix, and file name can all be found in the response body for a DigitalGlobeProduct.\n\n# Processing Worldview-1 Data\n\nMost algorithms that accept panchromatic imagery will accept Worldview-1 imagery.","excerpt":"","slug":"worldview-1","type":"basic","title":"WORLDVIEW-1"}
# Overview WorldView-1 has collected high resolution, panchromatic imagery since its launch in September 2007. The satellite is equipped with state-of-the-art geolocation accuracy and can cover one million sq. km per day of half-meter imagery. **Uses** WorldView-1’s highly detailed, panchromatic imagery is useful for in-depth image analysis, change detection, and precise map creation. It can geolocate features to less than 5 m to create maps in remote areas. **Spectral Bands** Panchromatic band only **Date Range** September 2007 – present **Products available through GBDX** DigitalGlobe Basic (Level 1B imagery) See the [Worldview-1 Data Sheet](https://dg-cms-uploads-production.s3.amazonaws.com/uploads/document/file/99/WorldView1-DS-WV1_V02.pdf) for more details. [block:image] { "images": [ { "image": [ "https://files.readme.io/dfef7ea-wv1-data-post.jpeg", "wv1-data-post.jpeg", 879, 485, "#353535" ], "caption": "Worldview-1 panchromatic image" } ] } [/block] # Types Type | Description --- | --- WV01 | Worldview-1, panchromatic imagery # Search Using the GBDX Catalog V2 API, search by "types" to find Worldview-1 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a Worldview-1 record. ## 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 Examples ### Search Example 1: Search for WV01 Acquisitions This search will return Worldview-1 Acquisitions within the specified area and date range. [block:code] { "codes": [ { "code": " {\n \t\"searchAreaWkt\": \"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\",\n \t\"startDate\": \"2014-01-01T00:00:00.000Z\",\n \t\"endDate\": \"2014-12-31T23:59:59.999Z\",\n \t\"types\": [\"WV01\",\n \t\t\t \"DigitalGlobeAcquisition\"]\n }", "language": "json" } ] } [/block] ### Search Example 1: Results for Search for Worldview-1 Acquisitions [block:code] { "codes": [ { "code": "{\n \"stats\": {\n \"recordsReturned\": 74,\n \"totalRecords\": 74,\n \"typeCounts\": {\n \"GBDXCatalogRecord\": 74,\n \"DigitalGlobeAcquisition\": 74,\n \"WV01\": 74,\n \"Acquisition\": 74\n }\n },\n \"results\": [\n {\n \"identifier\": \"102001002C90CA00\",\n \"type\": [\n \"GBDXCatalogRecord\",\n \"Acquisition\",\n \"DigitalGlobeAcquisition\",\n \"WV01\"\n ],\n \"properties\": {\n \"offNadirAngle_min\": 34.0340270996094,\n \"offNadirAngle_start\": 34.0340270996094,\n \"targetAzimuth_min\": 100.364738464355,\n \"multiResolution_min\": null,\n \"cloudCover\": 71,\n \"sunAzimuth_max\": 154.423583984375,\n \"targetAzimuth\": 101.401344299316,\n \"multiResolution\": null,\n \"catalogID\": \"102001002C90CA00\",\n \"panResolution_max\": 0.703037858009338,\n \"timestamp\": \"2014-04-04T18:03:56.225Z\",\n \"sunAzimuth_min\": 154.300903320312,\n \"browseURL\": \"https://geobigdata.io/thumbnails/v1/browse/102001002C90CA00.large.png\",\n \"targetAzimuth_max\": 102.358558654785,\n \"sunAzimuth\": 154.360046386719,\n \"sunElevation_min\": 53.7097778320312,\n \"offNadirAngle\": 34.2682800292969,\n \"stereoPair\": null,\n \"platformName\": \"WORLDVIEW01\",\n \"multiResolution_start\": null,\n \"sunElevation\": 53.8141632080078,\n \"vendor\": \"DigitalGlobe\",\n \"scanDirection\": \"Forward\",\n \"panResolution_end\": 0.703037858009338,\n \"panResolution_start\": 0.695971190929413,\n \"targetAzimuth_end\": 102.358558654785,\n \"panResolution_min\": 0.695971190929413,\n \"offNadirAngle_max\": 34.4900856018066,\n \"multiResolution_end\": null,\n \"multiResolution_max\": null,\n \"sunElevation_max\": 53.911190032959,\n \"offNadirAngle_end\": 34.4900856018066,\n \"panResolution\": 0.699512958526611,\n \"footprintWkt\": \"MULTIPOLYGON(((-105.2962337 39.78509511, -104.976098 39.76439814, -104.9763366 39.70838518, -104.9764659 39.6522475, -104.9767401 39.5960113, -104.9771385 39.54218685, -105.2999071 39.56629622, -105.2985721 39.61922254, -105.2965056 39.67437784, -105.2966604 39.72984386, -105.2962337 39.78509511)))\",\n \"targetAzimuth_start\": 100.364738464355,\n \"imageBands\": \"PAN\",\n \"sensorPlatformName\": \"WORLDVIEW01\"\n }\n },\n \n [results truncated]", "language": "json" } ] } [/block] ### Search Example 2: Search for WV01 1B Products This search will return WV01 1B products within the specified area and date range. [block:code] { "codes": [ { "code": " {\n \t\"searchAreaWkt\": \"POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))\",\n \t\"startDate\": \"2014-01-01T00:00:00.000Z\",\n \t\"endDate\": \"2014-12-31T23:59:59.999Z\",\n \t\"types\": [\"WV01\",\n \t\t\"DigitalGlobeProduct\",\n \t\t\"1BProduct\"]\n }", "language": "json" } ] } [/block] ### Search Example 2: Results for Search for WV01 1B Products [block:code] { "codes": [ { "code": "{\n \"stats\": {\n \"recordsReturned\": 38,\n \"totalRecords\": 38,\n \"typeCounts\": {\n \"GBDXCatalogRecord\": 38,\n \"1BProduct\": 38,\n \"WV01\": 38,\n \"DigitalGlobeProduct\": 38\n }\n },\n \"results\": [\n {\n \"identifier\": \"102001003605A600_P008_PAN_055955712010\",\n \"type\": [\n \"GBDXCatalogRecord\",\n \"WV01\",\n \"DigitalGlobeProduct\",\n \"1BProduct\"\n ],\n \"properties\": {\n \"rpbFile\": \"14NOV19183100-P1BS-055955712010_01_P008.RPB\",\n \"sunAzimuth\": 176.1,\n \"cloudCover\": 1,\n \"catalogID\": \"102001003605A600\",\n \"xmlFile\": \"14NOV19183100-P1BS-055955712010_01_P008.XML\",\n \"timestamp\": \"2014-11-19T18:31:00.000Z\",\n \"attFile\": \"14NOV19183100-P1BS-055955712010_01_P008.ATT\",\n \"browseJpgFile\": \"14NOV19183100-P1BS-055955712010_01_P008-BROWSE.JPG\",\n \"offNadirAngle\": 21.2,\n \"platformName\": \"WORLDVIEW01\",\n \"sunElevation\": 30.7,\n \"vendor\": \"DigitalGlobe\",\n \"soli\": \"055955712\",\n \"bands\": \"P\",\n \"bucketPrefix\": \"055955712010_01_003/055955712010_01/055955712010_01_P008_PAN\",\n \"readmeTxtFile\": \"14NOV19183100-P1BS-055955712010_01_P008_README.TXT\",\n \"imageFile\": \"14NOV19183100-P1BS-055955712010_01_P008.TIF\",\n \"part\": 8,\n \"bucketName\": \"receiving-dgcs-tdgplatform-com\",\n \"resolution\": 0.565,\n \"footprintWkt\": \"MULTIPOLYGON(((-105.036978274 39.8544898502, -104.800320467 39.870360396, -104.802562181 39.7211479845, -105.035048044 39.708882023, -105.036978274 39.8544898502)))\",\n \"geoFile\": \"14NOV19183100-P1BS-055955712010_01_P008.GEO\",\n \"tilFile\": \"14NOV19183100-P1BS-055955712010_01_P008.TIL\",\n \"sensorPlatformName\": \"WORLDVIEW01\",\n \"productLevel\": \"LV1B\",\n \"imdFile\": \"14NOV19183100-P1BS-055955712010_01_P008.IMD\",\n \"ephFile\": \"14NOV19183100-P1BS-055955712010_01_P008.EPH\",\n \"bandsList\": \"BAND_P\"\n }\n },\n \n [Results truncated to show one record]", "language": "json" } ] } [/block] # Worldview-1 Product Properties The following identifying information, properties, and metadata files are associated with a Worldview-1 1B product in the GBDX catalog. Property | Description | Values --- | --- | --- bands | Indicates panchromatic image or multispectral image | "Pan" or "Multi" bandsList | The specific bands that are part of this product. | Example: BAND_B,BAND_G,BAND_R,BAND_N bucketName | name of the AWS receiving bucket the product is stored in. | n/a bucketPrefix | The customer's AWS Prefix. This is typically the Account ID. | n/a catalogID | The catalog ID for the acquisition this product is derived from. | Example catalog ID: 1020010007AF7100 cloudCover | Estimate of the max cloud-covered fraction of the product component. | 0.000 to 1.000, -999.000 if not assessed. footprintWkt | The spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the Location | MULTIPOLYGON identifier | The identifier for the product, also referred to as "product ID". | 1040010006129900_P001_MUL_056814719010 imageFile | The product image. The file extension is .tiff. | n/a 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.| : ≥ 0.0, decimal points may vary. part |The part ID for an order. | For this property, the value is a single digit. For example, part: 5. The part ID is indicated in the Product ID and the metadata file names as "00x", or in this example, "005". platformName | See "sensorPlatformName". This field exists for backwards compatibility purposes only. | n/a productLevel | At this time, Catalog V2 only catalogs Level 1B products. A 1B product is a "basic" DigitalGlobe product. | 1B resolution | The resampled image pixel size derived from Ground Sample Distance (GSD).|Example: 0.588 sensorPlatformName | The name of the DigitalGlobe satellite that captured the acquisition this product is derived from. | See all DG satellites. soli | Sales Order Line Item | Example: 055734390 sunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north. | Range: 0.00000 – 360.00000 sunElevation |The angle of the sun above the horizon.| Range: 0.00000 – 90.00000 timestamp | The timestamp on the acquisition the product is derived from. | Example: 2014-07-12T17:40:46.000Z Vendor | For products, the vendor is DigitalGlobe. | N/A ### Image Support Data (DigitalGlobe Products) DigitalGlobe products have a set of metadata files called Image Support Data (ISD). The files included with a DigitalGlobe product on GBDX are: File | Details --- | --- attFile | Attitude File, File extension is Attitude File. The attitude file includes the time of first data point, the number of points, and the interval between the points and attitude information. browseJpgFile | Product Browse File, File extension is .JPG. The product browse file is a JPEG compressed browse image of the delivered product. ephFile | Ephemeris File, File extension is .EPH. The ephemeris file includes the time of first data point, the number of points, and the interval between the points and ephemeris information. geoFile | Geometric Calibration File, File extension is .GEO. The geometric calibration file contains the standard photogrammetric parameters of a virtualcamera that models the corresponding camera and optical system for Basic Imagery products imdFile | Image Metadata Fle, File extension is .IMD. The image metadata file describes key attributes about the image product, including product level, corner coordinates, and projection information, and time of acquisition. readmeTxtFile | Product Component Index File, File extension is .TXT.he README file provides copyright information and the names of the ISD files for a single product within a delivery. rpbFile | RPC00B File, File extension is .RPB. The RPC00B file contains the RPC information, which can be used to rectify the image. This is a mathematical mapping from object space coordinates to image space coordinates. tilFile | Tile Map File, File extension is .RPB. The tile map file assists the customer in determining what tile to ingest to look at a specific part of the order polygon. xmlFile | XML File, File extension is .XML. This file contains the same information as the combined README, Licensing, Image Metadata, Tile Map and RPC00Bfiles, in XML format. For Basic Imagery Products, the attitude, ephemeris, and geometric calibration file are included as well. These files cannot be viewed in the GBDX Receiving Bucket, but they can be passed into a task. ## Worldview-1 Acquisition Properties These are the properties associated with a Worldview-1 Acquisition: Property | Description | Values --- | --- | --- browseURL | This is the browse url from the GBDX thumbnail service | ex. https://geobigdata.io/thumbnails/v1/browse/103001003778D300.large.png catalogID |DigitalGlobe CatalogID for the raw data (acquisition). This is sometimes referred to as the "acquisition ID" |Ex.: 1020010007AF7100 cloudCover |Estimate of the max cloud-covered fraction of the product component. | 0.000 to 1.000, -999.000 if not assessed. footprintWkt | The spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the Location | MULTIPOLYGON identifier | The "identifier" for a DigitalGlobe acquisition is the catalog ID | 1020010007AF7100 imageBands |the image ands available for the image | See [Image Bands](#section-sensor-platforms-and-image-bands) below. multiResolution | multispectral resolution |Null for Worldview-1 Acquisitions (panchromatic only) multiResolution_end |The multispectral resolution at the end of the collect |Null for Worldview-1 Acquisitions (panchromatic only) multiResolution_max |The maximum multispectral resolution in the collect |Null for Worldview-1 Acquisitions (panchromatic only) multiResolution_min |The minimum multispectral resolution in the collect |Null for Worldview-1 Acquisitions (panchromatic only) multiResolution_start | The multispectral resolution of the start of of the collect|Null for Worldview-1 Acquisitions (panchromatic only) 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.| : ≥ 0.0, decimal points may vary. offNadirAngle_max |The maximum spacecraft elevation angle measured from nadir to the product center-line as seen from thespacecraft. | 0.0 to 90.0 offNadirAngle_end |The end of 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. | Example: 33.7915306091309 offNadirAngle_min | The maximum spacecraft elevation angle measured from nadir to the product center-line as seen from the spacecraft. | 0.0 to 90.0, Example: 30.0960826873779 OffNadirAngle_start | The start of 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.| Example: 30.0960826873779 panResolution |Panchromatic resolution | 0.602808654308319 panResolution_end |The panchromatic resolution at the end of the collect |0.600724101066589 panResolution_max |The maximum panchromatic resolution in the collect |0.605704009532928 panResolution_min |The minimum panchromatic resolution in the collect |0.600724101066589 panResolution_start |he panchromatic resolution at the start of the collect |0.605704009532928 platformName | The name of the sensor platform that acquired the data. platformName is in longhand, for example: WORLDVIEW02. This property is identical to "sensorPlatformName" below.| N/A scanDirection | The scan direction of the sensor when the acquisition was captured.|Values are "Forward" or "Reverse". The sensor platform Quickbird uses "forward" only. sensorPlatformName | The name of the sensor platform that acquired the data. sensorPlatformName is in longhand, for example: WORLDVIEW02. This property is identical to "platformName" above.| N/A stereoPair | Stereo pair data is not available on GBDX at this time. | N/A sunAzimuth | The azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north. | Range: 0.00000 – 360.00000 sunAzimuth_max |Maximum azimuth angle of the sun measured from north clockwise. | 0.0 to 360.0 sunAzimuth_min |Minimum azimuth angle of the sunmeasured from north clockwise. |0.0 to 360.0 sunElevation |The angle of the sun above the horizon.| Range: 0.00000 – 90.00000 sunElevation_max |Maximum azimuth angle of the sun measured from north clockwise. |0.0 to 360.0 sunElevation_min |Minimum azimuth angle of the sun measured from north clockwise. |0.0 to 360.0 targetAzimuth |The azimuth of the target as seen by an observer sitting on the spacecraft measured in a clockwise direction from north. |49.6538887023926 targetAzimuth_end |This is the maximum target azimuth in the collect |50.8807907104492 targetAzimuth_max |This is the end of the target Azimuth for this collect | 50.8807907104492 targetAzimuth_min | This is the minimum target azimuth in the collect |48.0979080200195 targetAzimuth_start | This is the start of the target Azimuth for this collect | 48.0979080200195 timestamp | The timestamp shows the date and time the acquisition data was collected | Ex. 2014-09-07T18:01:40.000Z vendor |The data provider|Ex. DigitalGlobe ## Sensor Platforms and Image Bands SensorPlatformName |ImageBands |Description --- | --- GEOEYE01 | Pan_MS1 | Multispectral, 4-band QUICKBIRD02| Pan_MS1 |Multispectral, 4-band WORLDVIEW01 |Pan |Black & White (Panchromatic) WORLDVIEW02 |Pan_MS1_MS2 | Multispectral, 8-band WORLDVIEW03 | Pan_MS1_MS2, SWIR | Multispectral, 8-band; Shortwave infrared, 8-band, # Identifiers ## Catalog ID The Catalog ID is the vendor's identifying information for the acquisition data collected by the satellite. This is sometimes referred to as the "acquisition ID." The catalog ID for the acquisition is also displayed in the properties for products derived from that acquisition. The catalog ID is used to place an order for a product. Example Acquisition Catalog ID: `1020010007AF7100` ## Product ID For a DigitalGlobe product, the "identifier" field is the product ID. The format of the product ID is: `<catid>_<part>_<band comb (MSI, PAN, SWR)>_<soli>` Example: 10300100301DCE00_P002_MUL_055825267010. In this example: Component | Value --- | --- catid |10300100301DCE00 part |002 band combination | (MSI, PAN, SWR) soli (sales order line item)| 055825267010 # S3 location `s3://bucketName/bucketPrefix/File name` The bucketName, bucketPrefix, and file name can all be found in the response body for a DigitalGlobeProduct. # Processing Worldview-1 Data Most algorithms that accept panchromatic imagery will accept Worldview-1 imagery.