GBDX

WORLDVIEW-3

Overview

GBDX provides access to WorldView-3’s high-resolution, super-spectral 30 cm imagery that allows for fast and precise mapping of various features anywhere in the world. 31 cm panchromatic resolution, 1.24 m multispectral resolution, and 3.7 m short-wave infrared (SWIR) resolution are available for processing.

Uses
With industry-leading geolocation accuracy and superior haze penetration, Worldview-3 imagery is ideal for many new and enhanced applications, including mapping, land classifications, disaster preparedness and response, oil and gas, identification of man-made materials, and more.

Spectral Bands

  • Panchromatic band
  • Multispectral 4-band: 4 standard VNIR colors are blue, green, red, near-IR1
  • Multispectral 8-band: 4 additional VNIR colors are coastal, yellow, red edge, and near-IR2
  • Shortwave infrared resolution: 8 SWIR bands that penetrate haze, fog, smog, dust, and smoke

Date Range
August 13. 2014 – present

Products available through GBDX
DigitalGlobe Basic (Level 1B imagery)

See the Worldview-3 Data Sheet for more details.

Auckland, New Zealand port. Worldview-3, 30-cm resolution.

Auckland, New Zealand port. Worldview-3, 30-cm resolution.

SWIR imagery

Some 7.5-meter shortwave Infrared (SWIR) acquisitions available in the GBDX Catalog. Available SWIR acquistions can be ordered using the Ordering V2 API. Not all DG acquisitions have a corresponding SWIR acquisition. SWIR imagery is only acquired by the Worldview-3 sensor platform.

To learn more about SWIR imagery, see Revearling the Hidden World with Shortwave Infrared (SWIR) Imagery.

Types

VNIR and SWIR data are separate "types" in the GBDX catalog.

Type Description
WV03_VNIR Worldview-3, Visible Near Infrared (VNIR) imagery
WVO3_SWIR Worldview-3, Short-wave Infrared (SWIR) imagery

Search

Using the GBDX Catalog V2 API, search by "types" to find Worldview-3 VNIR or SWIR 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-3 record.

Catalog V2 API Request

Send a POST request to https://geobigdata.io/catalog/v2/search with a request body.

For gbdxtools, see Catalog Search Overview

Search Examples

Search Example 1: Search for Acquisitions by Type WV03_VNIR

This search will return Worldview-3 VNIR Acquisitions within the specified area and date range.

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

Search Example 1: Results for Search for Acquisitions by Type WV03_VNIR

{
    "stats": {
        "recordsReturned": 19,
        "totalRecords": 19,
        "typeCounts": {
            "DigitalGlobeAcquisition": 7,
            "IDAHOImage": 6,
            "DigitalGlobeProduct": 12,
            "GBDXCatalogRecord": 19,
            "1BProduct": 6,
            "WV03_VNIR": 19,
            "Acquisition": 7
        }
    },
    "results": [
        {
            "identifier": "104001001623D500",
            "type": [
                "GBDXCatalogRecord",
                "Acquisition",
                "DigitalGlobeAcquisition",
                "WV03_VNIR"
            ],
            "properties": {
                "offNadirAngle_min": 28.8779773712158,
                "offNadirAngle_start": 29.0964164733887,
                "targetAzimuth_min": 5.44967842102051,
                "multiResolution_min": 1.56522011756897,
                "cloudCover": 72,
                "sunAzimuth_max": 164.358459472656,
                "targetAzimuth": 5.81032228469849,
                "multiResolution": 1.56781625747681,
                "catalogID": "104001001623D500",
                "panResolution_max": 0.393054217100143,
                "timestamp": "2016-01-02T19:13:29.989Z",
                "sunAzimuth_min": 164.34391784668,
                "browseURL": "https://geobigdata.io/thumbnails/v1/browse/104001001623D500.large.png",
                "targetAzimuth_max": 6.03870010375977,
                "sunAzimuth": 164.349594116211,
                "sunElevation_min": 27.9576187133789,
                "offNadirAngle": 28.9622478485107,
                "stereoPair": null,
                "platformName": "WORLDVIEW03_VNIR",
                "multiResolution_start": 1.57141935825348,
                "sunElevation": 28.0554447174072,
                "vendor": "DigitalGlobe",
                "scanDirection": "Forward",
                "panResolution_end": 0.391499429941177,
                "panResolution_start": 0.393054217100143,
                "targetAzimuth_end": 6.03870010375977,
                "panResolution_min": 0.391499429941177,
                "offNadirAngle_max": 29.0964164733887,
                "multiResolution_end": 1.56522011756897,
                "multiResolution_max": 1.57141935825348,
                "sunElevation_max": 28.1174240112305,
                "offNadirAngle_end": 28.8779773712158,
                "panResolution": 0.392150461673737,
                "footprintWkt": "MULTIPOLYGON(((-122.4627461 37.67772986, -122.2890178 37.68344098, -122.2890779 37.64523801, -122.2891209 37.60708093, -122.289178 37.56897506, -122.2892319 37.5457562, -122.4624298 37.53874999, -122.4625686 37.56127355, -122.4625971 37.60024801, -122.4627078 37.63866493, -122.4627461 37.67772986)))",
                "targetAzimuth_start": 5.44967842102051,
                "imageBands": "PAN_MS1_MS2",
                "sensorPlatformName": "WORLDVIEW03_VNIR"
            }
        },
      
      [results truncated]

Search Example 2: Search for Acquisitions by Type WV03_SWIR

This search will return all Worldview-3 SWIR Acquisitions within the specified area and date range.

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

Search Example 2: Results for Search by Acquisitions by Type WV03_SWIR

See example 1. The names for the properties returned in this results set are identical, although the values may be different.

Search Example 3: Search for WV03_VNIR 1B Products

This search will return WV03_VNIR 1B products within the specified area and date range.

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

Search Example 3: Results for Search for WV03_VNIR 1B Products

{
    "stats": {
        "recordsReturned": 20,
        "totalRecords": 20,
        "typeCounts": {
            "GBDXCatalogRecord": 20,
            "DigitalGlobeProduct": 20,
            "1BProduct": 20,
            "WV03_VNIR": 20
        }
    },
    "results": [
        {
            "identifier": "1040010006129900_P001_MUL_056814719010",
            "type": [
                "GBDXCatalogRecord",
                "WV03_VNIR",
                "DigitalGlobeProduct",
                "1BProduct"
            ],
            "properties": {
                "rpbFile": "14DEC28180020-M1BS-056814719010_01_P001.RPB",
                "sunAzimuth": 164.7,
                "cloudCover": 0,
                "catalogID": "1040010006129900",
                "xmlFile": "14DEC28180020-M1BS-056814719010_01_P001.XML",
                "timestamp": "2014-12-28T18:00:20.000Z",
                "attFile": "14DEC28180020-M1BS-056814719010_01_P001.ATT",
                "browseJpgFile": "14DEC28180020-M1BS-056814719010_01_P001-BROWSE.JPG",
                "offNadirAngle": 25.5,
                "platformName": "WORLDVIEW03_VNIR",
                "sunElevation": 25.5,
                "vendor": "DigitalGlobe",
                "soli": "056814719",
                "bands": "Multi",
                "bucketPrefix": "056814719010_01_003/056814719010_01/056814719010_01_P001_MUL",
                "readmeTxtFile": "14DEC28180020-M1BS-056814719010_01_P001_README.TXT",
                "imageFile": "14DEC28180020-M1BS-056814719010_01_P001.TIF",
                "part": 1,
                "bucketName": "receiving-dgcs-tdgplatform-com",
                "resolution": 1.478,
                "footprintWkt": "MULTIPOLYGON(((-104.758169811 39.9311723572, -104.57590596 39.9137643293, -104.575885638 39.796801788, -104.758630276 39.8143432989, -104.758169811 39.9311723572)))",
                "geoFile": "14DEC28180020-M1BS-056814719010_01_P001.GEO",
                "tilFile": "14DEC28180020-M1BS-056814719010_01_P001.TIL",
                "sensorPlatformName": "WORLDVIEW03_VNIR",
                "productLevel": "LV1B",
                "imdFile": "14DEC28180020-M1BS-056814719010_01_P001.IMD",
                "ephFile": "14DEC28180020-M1BS-056814719010_01_P001.EPH",
                "bandsList": "BAND_C,BAND_B,BAND_G,BAND_Y,BAND_R,BAND_RE,BAND_N,BAND_N2"
            }
        },
      
      [Results truncated to show one record]

Search Example 4: Results for Search for WV03_SWIR 1B Products

This search returns all WV03_SWIR 1B products from within the specified date range.

{
    	"startDate": "2014-01-01T00:00:00.000Z",
    	"endDate": "2014-12-31T23:59:59.999Z",
    	"types": ["WV03_SWIR",
    		"DigitalGlobeProduct",
    		"1BProduct"	
    		]
    }

Worldview-3 1B Product Properties

The following identifying information, properties, and metadata files are associated with a Worldview-3 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. A negative sun elevation indicates a night time image.. ±90.0 Range:±90.0
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-3 Acquisition Identifying Information and Properties

These are the properties associated with a Worldview-3 VNIR or SWIR 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 below.
multiResolution multispectral resolution 2.41480398178101
multiResolution_end The multispectral resolution at the end of the collect 2.40671253204346
multiResolution_max The maximum multispectral resolution in the collect 2.42567181587219
multiResolution_min The minimum multispectral resolution in the collect 0.600724101066589
multiResolution_start The multispectral resolution of the start of of the collect 0.605704009532928
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. A negative sun elevation indicates a night time image Range: ±90.0
sunElevation_max Maximum elevation of the sun. A negative sun elevation indicates a night time image.. ±90.0 ±90.0
sunElevation_min Minimum elevation angle of the sun. A negative sun elevation indicates a night time image ±90.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.

The catalog IDs for VNIR and SWIR acquisitions are similar. A SWIR catalog ID has an “A” in the 4th position instead of an “0”.

Example VNIR Catalog ID: 1020010007AF7100
Example SWIR Catalog ID: 04A0100146AFB00

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-3 VNIR and SWIR Data

Most algorithms on the GBDX platform accept Worldview-3 VNIR imagery.

The Atmospheric Compensation algorithm on GBDX can process both VNIR and SWIR imagery. See AComp (Atmospheric Compensation) for detailed instructions for processing SWIR data.

The ENVI Task Engine supports SWIR, ENVI tasks on GBDX have not been verified with SWIR data. however, ENVI tasks have not been tested with SWIR on the GBDX platform. See ENVI® Task Engine for more information.