imagery support data documentation

7/30/2019 Imagery Support Data Documentation

1/56

DigitalGlobeImagery Support Data (ISD)Documentation

Supplemental information for the Product Guide


2/56

Release Date: 11/1/2011 1 Imagery Support Data (ISD) Documentation

Table of Contents

1. Introduction .......................................................................................................................................... 31.1 Background ............................................................................................................................... 31.2 Scope ......................................................................................................................................... 3

2. Image Support Data .............................................................................................................................. 42.1 ISD File Description .................................................................................................................. 42.2 File Layout ................................................................................................................................ 6

3. General Format and Conventions ......................................................................................................... 73.1 General File Format ................................................................................................................... 7

3.1.1 PVL Format ................................................................................................................... 73.1.2 XML Format .................................................................................................................. 7

3.2 Delivery Level Support Data ..................................................................................................... 73.2.1 Delivery Index (README) Contents ............................................................................ 73.2.2 Delivery Layout File .................................................................................................... 103.2.3 Delivery Geographic Location Map Files .................................................................... 10

3.3 Product Component-Level Support Data ................................................................................ 133.3.1 Product Component Index (README) ....................................................................... 133.3.2 Image Metadata ............................................................................................................ 143.3.3 Product Browse file ...................................................................................................... 283.3.4 Tile Map ....................................................................................................................... 283.3.5 Attitude Data ................................................................................................................ 313.3.6 Ephemeris Data ............................................................................................................ 333.3.7 Rational Polynomial Coefficients ................................................................................ 353.3.8 Product Component XML File .................................................................................... 413.3.9 Manifest File ................................................................................................................ 423.3.10 Stereo File .................................................................................................................... 43

Appendix 1.0 Abbreviations, Acronyms, and Terms ......................................................................... 46Appendix 2.0 Example: PVL Format ................................................................................................. 49Appendix 3.0 Example: XML Format ................................................................................................ 52Appendix 4.0 Example: Tile Map File ............................................................................................... 55


3/56


List of Figures

Figure 1. File Layout diagram ..................................................................................................... 6

Figure 2. Sample Product Browse File ......................................................................................28

Figure 3. Stereo Geometry Angles ............................................................................................44

List of Tables

Table 1. Image Support Data (ISD) Files Delivered with Product Type. .................................... 4

Table 2. Top Level Delivery Index (README) Contents (ISDF.DEL.README) ........................ 8

Table 3. Delivery Shapefile Names and Attributes ...................................................................11

Table 4. Product Component Index (README) Contents ........................................................14

Table 5. Image Metadata Contents ..........................................................................................14

Table 6. Tile Map Contents ......................................................................................................29

Table 7. Attitude File Contents (.ATT) ......................................................................................32

Table 8. Ephemeris File Contents (.EPH) .................................................................................33

Table 9. RPC Terms .................................................................................................................36

Table 10. RPC00B Contents .....................................................................................................36

Table 11. Stereo Contents .......................................................................................................44


4/56


1. Introduction

1.1 Background

This document describes the Image Support Data (ISD) format for QuickBird and WorldView

Imagery products. These products are available in a variety of product types, and contain

different ISD depending on the type of the product. This document describes the ISD for the

following DigitalGlobe product types:

Basic Products Stereo Products

Standard Products

Orthorectified Products

Digital Elevation Model Products

The ISD that is delivered with all QuickBird and WorldView Imagery products, regardless of

product type, is described in the main body of the document.

1.2 Scope

This document specifies the format of ISD that DigitalGlobe delivers to customers with

WorldView and QuickBird imagery products. These data are delivered in numerous files. The

document describes the overall structure of these files and specifies the data content and formatof individual fields. It also presents some technical information to explain the significance of the

data.

The term "image" in this document often refers to a general two-dimensional image product,

including a Digital Elevation Model (DEM) or another form of height model, as well as an image

in the stricter sense. The context and the use of specific product type names should make it clearwhich meaning is intended.


5/56


2. Image Support Data

All Imagery Products are delivered with a set of metadata files called Image Support Data (ISD).This section describes Version 23.11 of the ISD specification. The number and types of filesdelivered varies depending on the product ordered. The Image Support Data files can beviewed as a collection point for all useful ancillary data. Table 1 lists the Image Support Datafiles that are delivered with each product type.

File Name Extension Basic ImageryStandard

Imagery

Orthorectified

Imagery

DELIVERY LEVEL ISD

Top Level Index (Readme) File .TXT XX XX XXTop Level Index (XML) File .XML XX XX XXLayout File .JPG XX XX XXShapefiles .shx, .shp, .dbf XX XX XX

Manifest File .MAN FTP only FTP only FTP onlyEnd of Transfer File .TXT FTP only FTP only FTP only

PRODUCT COMPONENT LEVEL ISD

Product Component Index

(Subdirectory Readme) File.TXT XX XX XX

License File .TXT XX XX XX

Image Metadata File .IMD XX XX XXProduct Browse File .JPG XX XX XX

Tile Map File .TIL XX XX XXAttitude File .ATT XX

Ephemeris File .EPH XX

Geometric Calibration File .GEO XX

RPC00B File .RPB XX XX

XML File .XML XX XX XX

Table 1. Image Support Data (ISD) Files Delivered with Product Type.

2.1 ISD File Description

Products include ISD at two levels: one set of Delivery ISD, and one set of Product ComponentISD for each product option ordered. The number of product components depends on thelayout of the order polygon with respect to scene or strip boundaries. If the order polygon isentirely contained within a single scene or strip, then only one product component will bedelivered. If an order polygon crosses strip or scene boundaries, then the imagery product willbe divided into multiple product components. Product options include panchromatic,multispectral, or pan-sharpened.

The Delivery ISD (one set per delivery) consists of:

Top Level Index (Readme) File This file contains a list of names of the product files and theISD files, along with copyright information for the entire product delivery.


6/56


Top Level Index XML File This file contains the same information as the Top Level Index(README) file but in XML format.

Layout File This file spatially illustrates how the delivery order is spread out across the mediaincluding product and order polygon extents. The map includes volume and product labels. Thefile is in the standard jpeg format. Media volume information is not included for electronicdeliveries.

Shapefiles These files spatially illustrate the product layout in a similar way to the layout fileexcept in shapefile format. The files represent the order polygon, strip boundaries, productboundaries, and tile boundaries.

Manifest File The manifest file is included with electronic (FTP) deliveries, only. The filecontains the directory listing of the files delivered with the product

End of Transfer File The end of transfer file is included with electronic (FTP) deliveries, only.The appearance of this file on the FTP site indicates that DigitalGlobe has completedtransferring all product files. It is a zero length file.

The Product Component ISD (one set per product component option) consists of:

Product Component Index (Subdirectory Readme) File The README file providescopyright information and the names of the ISD files for a single product within a delivery.

License File The license file contains the text of the selected license.

Image Metadata File The image metadata file describes key attributes about the image

product, including product level, corner coordinates, and projection information, and time ofacquisition.

Product Browse FileThe product browse file is a JPEG compressed browse image of thedelivered product.

Tile Map The tile map file assists the customer in determining what tile to ingest to look at aspecific part of the order polygon.

Attitude File The attitude includes the time of first data point, the number of points, and theinterval between the points and attitude information.

Ephemeris File The ephemeris file includes the time of first data point, the number of points,

and the interval between the points and ephemeris information.

Geometric Calibration File The geometric calibration file contains the standardphotogrammetric parameters of a virtual camera that models the corresponding camera andoptical system for Basic Imagery products.

RPC00B File The RPC00B file contains the RPC information, which can be used to rectify theimage. This is a mathematical mapping from object space coordinates to image spacecoordinates.


7/56


XML File This file contains the same information as the combined README, Licensing,Image Metadata, Tile Map and RPC00B files, in XML format. For Basic Imagery Products, the

attitude, ephemeris, and geometric calibration file are included as well.

2.2 File Layout

This section describes the structure by which the ISD files are organized for delivery. Figure 10diagrams the layout as it applies to delivery of imagery and ISD files for all media types.Product Level Directories are identified with the product id and a 3 character descriptor: PAN forPanchromatic, MUL for Multispectral, PSH for Pansharpened, and MOS for Mosaickedproducts.

_PAN

_MUL

-

-

GIS_FILES

(Geographic Location Map files)

-

_PSH

-

-

-

FTP only

_MOS

-

Figure 1. File Layout diagram


8/56


3. General Format and Conventions

3.1 General File Format

ISD files are provided in the Parameter Value Language (PVL). The information in PVLformat is provided in multiple files while the information in XML is provided in a singlefile. The information provided in PVL and XML are the same semantically but differ onlyin syntax.

3.1.1 PVL Format

Each tag consists of a variable length parameter name and a parameter value, in theform parameterName = value followed by a semi-colon. The value can be an integer(decimal, binary, octal, or hexadecimal), a floating-point number, a character string (one

or more characters), a UTC time, a set, or a list. The format for UTC time is YYYY-MM-DDThh:mm:ss.ddddddZ. Character strings values must be enclosed in doublequotation marks. Sets are delimited by { }, and lists are delimited by ( ). Nested setsand lists are allowed. Comments in the file begin with a slash-asterisk /* and end withan asterisk-slash */.Named groups begin with BEGIN_GROUP = GROUPNAME and end withEND_GROUP = GROUPNAME. Nested groups are allowed. The end of a PVL moduleis indicated by the keyword END, followed by a semi-colon.Only required fields need to be specified in the ISD files.To see an example of the PVL formatted file, please see Appendix 1.0

3.1.2 XML Format

All the information contained in the PVL ISD files is also provided in XML format. Tosee an example of the possible XML formatted file, please seeAppendix 2.0.

3.2 Delivery Level Support Data

3.2.1 Delivery Index (README) Contents

The Delivery Index contains a list of names of the product files and the ISD files, alongwith copyright information for the entire product delivery. The Delivery Index is found ina Top Level README file and a Top Level XML file delivered with each delivery, andeach describes all of the files for all of the products delivered within that delivery. TheREADME file and the XML file contain the same information. The Top Level READMEFile is named for the 12 digit DigitalGlobe Order Item number and the 2 digit deliveryincrement, for example: 000000077583_01_README.TXT and000000077583_01_README.XML.


9/56


Table 2. Top Level Delivery Index (README) Contents (ISDF.DEL.README)

Field Field Name/Description Format Range / Value

[DG Range / Value, if differentfrom Format Range / Value]

Conditions/

Comments

version Version of the ISD. 20.0 to 99.9

copyrightText Copyright and restricted usetext.

Use, duplication or disclosure bythe government is subject to therestrictions as set forth insubparagraph (c)(1)(ii) of the Rightsin Technical Data and ComputerSoftware Clause contained inD.F.A.R.S. 252.227-7013, andsubparagraphs (c)(1) and (2) of theCommercial Computer Software-Restricted Rights contained in 48C.F.R. 52.227-19.Contractor/manufacturer is

DigitalGlobe, Incorporated at 1601Dry Creek Drive, Suite 260,Longmont, CO 80503-6493.Copyright YYYY DigitalGlobeIncorporated, Longmont CO USA80503-6493 DigitalGlobe and theDigitalGlobe logo are trademarks ofDigitalGlobe, Incorporated. The useand/or dissemination of this dataand/or of any product in any wayderived there from are restricted.Unauthorized use and/ordissemination is prohibited.DigitalGlobe WWW Reference:http://www.digitalglobe.com

2nd paragraph

Copyright YYYYDigitalGlobe ...

Where yyyy is thecurrent year

mediaCreationD

ate

Time of media creation. YYYY-MM-DDThh:mm:ss.dddZ The time in this tag only

has precision to 3decimal places.

orderNumber 12 digit DigitalGlobe OrderItem number, underscore,and 2-digit deliveryincrement.

nnnnnnnnnnnn_mm

Example:

052265559010_01

fileList A list of all files in the deliveryincluding path directories.

Lists allfilenames included:

GIS files;

Metadata files;

Product files;

etc.

This field will varydepending on producttype.

areaDesc Customer supplieddescription of order. Null ifno information supplied by

the customer.

Example:

IS_05

dgOrderNo DigitalGlobe Order Number. Example:

052265559

dgOrderItemNo 12-digit DigitalGlobe OrderItem Number.

Example:

05226559010

custOrderNo Customer supplied ordernumber. Null if noinformation supplied by thecustomer.

Example:

IS_05


10/56




Conditions/Comments

custOrderItemNo

Customer supplied order itemnumber. Null if noinformation supplied by thecustomer.

40005

collectionStart Date of first imageacquisition.

YYYY-MM-DDThh:mm:ss.ddddddZ

collectionStop Date of final imageacquisition.


countryCode Two letter country code ofcenter point of order polygon.

Example:

Required for PMAAorders

productScale The NMAS mapping scale ofOrthorectified Products.

1:50,000 for Level 3A

1:25,000 for Level 3B

1:24,000 for Level 3C

1:12,000 for Level 3D1:10,000 for Level 3E

1:5,000 for Level 3F

1:4,800 for Level 3G

1:2,400 for Level 3H

Custom for Level 3X

Only applicable to Level3 products.

numberOfLooks Indicates whether this is asingle product, a stereo pairor a stereo triplet.

1 for single,

2 for stereo pair,

3 for stereo triplet

cloudCover Estimate of the max cloud-covered fraction of thedelivery. For mosaicproducts, this calculation isbased on the intersection ofthe polygons contained in theMOSAIC_CLOSEDPOLYGONS shapefile with the cloudpolygons associated with thatpart of the relevent inputimagery.

See Section 3.2.2.5 for moreinformation.

[See Exception 1]

0.000 to 1.000

-999.0 for Metadata-Only;

Precision:

3 decimal places

Not applicable forMetadata Only.

-999.0 if not assessed

nwLat Latitude of NW corner of theminimum bounding rectangle(MBR) of the order polygon.

Range:

90.00000000

Precision:

8 decimal places

nwLong Longitude of NW corner ofthe minimum boundingrectangle (MBR) of the orderpolygon.

Range:

180.00000000

Precision:

8 decimal places

seLat Latitude of SE corner of theminimum bounding rectangle(MBR) of the order polygon.

Range:

90.00000000

Precision:

8 decimal places

seLong Longitude of SE corner of the Range:


11/56




Conditions/Comments

minimum bounding rectangle(MBR) of the order polygon. 180.00000000Precision:

8 decimal places

3.2.2 Delivery Layout File

The Layout file illustrates the following: outline of the Product area (order polygon),

outline of the Product Component areas (product polygon);

the distribution of the above areas on the delivery media.

It is an image file in JPEG format, without any additional attributes. The information

contained in this file is not duplicated in the Top Level XML file.

3.2.3 Delivery Geographic Location Map Files

Geographic Location Map files are similar to the layout file (Section 3.2) but in Shapefileformat, projected to WGS84 Geographic (Lat/Lon). These product shapefiles aredelivered as read/writable ASCII text files.DigitalGlobe provides the following Geographic Location Map files with every delivery:

Strip or Substrip Area which shows the vertices and boundaries of the strips orsubstrips used to generate the product, as well as the catalog ID for each of theseareas.

An example of a Strip or Substrip Area filename is:

052265559010_01_STRIP_SHAPE.dbf

Product Area which shows the vertices and boundaries of the complete productas ordered by the customer.

An example of a Product Area filename is:

052265559010_01_ORDER_SHAPE.dbf

Product Component Areas which shows the vertices and boundaries of theproduct components that make up the delivery, and the allocation of the productcomponents to media.

An example of a Product Component Area filename is:

052265559010_01_PRODUCT_SHAPE.dbf Product Subcomponent Areas which shows the vertices, boundaries, name,

and filename of each tile or sub-strip in the product components, as well as theproduct component to which each belongs. A TILE shapefile will not be includedwith Level 0 nor Metadata-Only products.

An example of a Product Subcomponent Area filename is:

052265559010_01_TILE_SHAPE.dbf


12/56


Product Pixel Area which shows the vertices and boundaries of actualimagery pixels of the product components that make up the delivery (non-blackfill pixels.) In the Product Pixel area shapefile, the is pre-pended by an acquisition date-time of one of the contributing raw imagesalong with a mnemonic that describes the product level as in the followingexample:

08JUL30153254-P2AS-052265559010_01_P001_PIXEL_SHAPE.dbfFor ortho-mosaic products, DigitalGlobe delivers an additional Geographic LocationMap file for each product:

Mosaic seamlines which shows the vertices and boundaries of eachimage strip that contributed to the generation of the mosaic. Note: Thisshapefile contains all MDA Product Processor manual, auto-generated, andmanually edited seamlines. If the product is exported to another application

where changes are made to the seamlines, this shapfile will not reflectthose changes. The Mosaic seamline has the DG orderspart ID (eg P001) pre-pended as in the following example:

052270931010_01_P001_MOSAIC_CLOSEDPOLYGONS_SHAPE.dbf

Table 3. Delivery Shapefile Names and Attributes

ShapefileName

Field Field Name / Description Format Range / Value


Conditions /Comments

STRIP

stripDesc Catalog ID corresponding withassociated strip or substrip

10100100017C2400

sunAzimuth Azimuth angle of the sun measuredfrom north clockwise, in degrees, atthe time the strip or substrip wasacquired

Range:0.0 360.0

Note:Decimalprecision mayvary.

offNadir The spacecraft elevation anglemeasured from nadir to the imagecenter as seen from the spacecraftat the time the strip or substrip wasacquired

Range: 0.0

Note:

Decimalprecision mayvary.

acquisitio Populated with the strip acquisitiondate-time

Example:2002-12-29T15:58:08.626765Z

orderDesc Item number corresponding withassociated order polygon

Example:052265559010

This is theSOLI number:

custOrd Optional order number supplied bythe customer at time of orderplacement.

Example:

IS_46

Only ifcustomer has

supplied ordernumber.

custOrdItm Optional order item numbersupplied by the customer at time oforder placement.

Example:

40005

Only ifcustomer hassupplied orderitem.

datum The Datum in which the productwas ordered.

WE

NAR

NAS

TOYM

Blank forMetadata-Only,Level 0, andLevel 1products.


13/56


ShapefileName




Order

projection The projection in which the productwas ordered. NA for Basicproducts.

EpipolarUTM

State Plane Coordinates

Japan RCS Coordinates

Lambert Conformal Conic

Transverse Mercator

Geographic (Lat/Long)

Blank forMetadata-Only,Level 0, andLevel 1products.

createDate Start date of product creation. YYYY-MM-DDThh:mm:ss.ddddddZ

Tile

tileName Tile Name If R or C 9: RnCn

If R or C 99: RnnCnn

If R or C 999: RnnnCnnn

Examples:R1C1R19C3

olumns do nothave to be ofthe same orderof magnitude.

e:

osaic with 6columns and15 rows wouldbe displayedas:

e image file.

1236-M2AS_R1C1-000000092184_01_P001.NTF

prodDesc Unique product identifier Example:P001

volNum Volume number of the media onwhich the tile is located.

Example:Vol. 1

PRODUCT

prodDesc Unique product identifier Example:P001


Example:Vol. 1-2

bandInfo Defines type of spectral bands inproduct. (PanSharp, Multispectral,All Band, Panchromatic)

PanSharpMultispectralAll BandPanchromatic

PIXEL

prodDesc Unique product identifier Example:3AUG27021804-M2AS-005357007010_01_P001_PIXEL_SHAPE


Example:Vol. 1-2

MOSAIC_CLOSEDPOLYGONS

imageIdStr Imagery identifier Example:10100100012BEA00

acqDate Imagery acquisition date YYYY-MM-DDThh:mm:ss.ddddddZ

gsd Ground sample distance in meters Range:0.46000 10.00000

Precision:5 decimal places

horError Requested product accuracy fromthe order

Range:0.00000 15.44000


cloudCover Cloud cover percentage iscalculated by intersecting the

Range:0.00000 to 100.00000


14/56


ShapefileName




closed polygon with cloud polygonsfrom the underlying image strips.See Section 3.2.2.5 for moreinformation.


offNadir Angle from s/c to strip crosstractcenter.

Range:0.00000 30.00000


Can beexceeded withreduced imagequality.

scanAz Image scan azimuth. North-to-SouthEast-to-West

scanDir Image scan direction. ForwardReverse

collectAz The orientation angle of thegenerated collection strip relative totrue north.

Range:0.00000 360.00000


collectEl The collection elevation is the anglebetween the horizontal and the rayoriginating from the optical center tothe point of incidence.

Range:0.00000 90.00000


sunAz Sun azimuth. Range:0.00000 360.00000


sunEl Sun elevation. Range:0.00000 90.00000


satellite Satellite mnemonic QB02, WV01, WV02, WV03

prodDate Production generation date YYYYMMDD

currDate Production generation date YYYYMMDD

collDate Date of image collection YYYYMMDD

absAcc Product absolute accuracy. Range:0.00000 100.00000Precision:5 decimal places

absAccUnit Absolute accuracy units Meters

relAcc Product relative accuracy Range:0.00000 5.00000Precision:5 decimal places

relAccUnit Relative accuracy units Meters

3.3 Product Component-Level Support Data

3.3.1 Product Component Index (README)

The Product Component Index lists the names of the image, browse, and ISD files ineach product component subdirectory of a delivery. Other ISD files may or may not be


15/56


included in a delivery depending on the type of the products in the order. One ProductComponent Index is provided for each product component of each delivery within theproduct component subdirectory.

Table 4. Product Component Index (README) Contents

Field Field Name / Description Conditions / Comments

copyrightText Copyright and restricted use text

version Version of the ISD

intro Introduction. General textual information aboutthe product and file contents.

BEGIN_GROUP = PRODUCT_1

XMLFilename Product Component XML file

licenseTxtFilename

Licensing text file name Predicated on license order parameter.

IMFFilename Image metadata file name

NRDFilename Non-responsive detector file name Only for Metadata-Only, Level 0, and Level 1Aproducts.

radFilename Radiometric calibration file name Only for Metadata-Only, Level 0, and Level 1Aproducts.

ephemFilename Ephemeris file name Only for Metadata-Only, Level 0, Level 1A and Level1B products.

attFilename Attitude file name Only for Metadata-Only, Level 0, Level 1A and Level1B products.

tilFilename Tile map file name Not applicable to Level 0 files.

geoCalFilename Geometric calibration file name Only for Metadata-Only, Level 0, Level 1A and Level1B products.

stereoFilename Stereo file name Only valid for stereo products

RPC00BFilename

RPC00B file name Not applicable to Level 3 products.

END_GROUP = PRODUCT_1

END;

3.3.2 Image Metadata

3.3.2.1 Image Metadata Content

For ortho-mosaics, if an input image is not used as part of the final product, it will not berepresented in the Image Metadata Data (IMD). All other input images will be

represented in the IMD and will appear in order of their acquisition date-timestamp withthe oldest image appearing first. The date-timestamp of the oldest image will be used aspart of the product filenames.The Image Metadata specifies the basic characteristics of an image or a DEM asspecified in the following table.

Table 5. Image Metadata Contents


16/56



[DG Range / Value, if different

from Format Range / Value]

Conditions / Comments

version Version of the ISD 20.0 to 99.9

generationTime Time of file generation. YYYY-MM-DDThh:mm:ss.ddddddZ

productOrderId Order Item ID of product Example:

052270730010_01_P001

Optional if product does notoriginate from DG or co-producer

productCatalogID ID for the corresponding record inDGs catalog (In multi-set productsthis would be the group catalog id)

Examples:

903001004AA74B00

None

None if catalog not kept inDG archive.

childCatalogID ID for the corresponding record inDGs catalog (for multi-set productsthis would be the child or subsetcatalog id) In cases where children

products do not have separate IMDfiles, this field may be repeated.

Example:

210001004AA74C00

None

Used only with multi-setproducts

imageDescriptor This is a combination of product nameand product type

"Level0", "Metadata", "Basic1A","Basic1B", "Standard2A","ORStandard2A","OrthoRectified3", "Stereo1B",StereoOR2A,"DEM4

productScale This is the NMAS mapping scale ofthe Orthorectified Product

1:50,000 for 3A

1:25,000 for 3B

1:24,000 for 3C

1:12,000 for 3D

1:10,000 for 3E

1:5,000 for 3F

1:4,800 for 3G1:2,500 for 3H

1:2,400 for 3I

Custom for 3X

Only applicable to Level 3products.

productAccuracy Identifies the worst case CE90% inmeters for the associatedproductScale.

25.40 for 3A

12.70 for 3B

12.19 for 3C

10.16 for 3D

8.47 for 3E

4.23 for 3F

4.06 for 3G

2.03 for 3H

1.02 for 3I

unavailable

Only applicable to Level 3products.

RMSE2D The Two Dimensional Root MeanSquare Error

15.44 for Level 3A;

7.72 for Level 3B;

7.41 for Level 3C;

6.18 for Level 3D

5.15 for Level 3E

2.57 for Level 3F

2.47 for Level 3G

1.29 for Level 3H

Only applicable for Level 3products.

Level 3X uses customersupplied data, e.g. DEM(s),GCPs or both, so DG doesnot guarantee accuracy.


17/56






1.24 for Level 3I;

0.00 for Level 3X;

Precision:

2 decimal places

bandId Identifies the spectral band.

P = Panchromatic, Multi = all Multi-spectral bands (4 for QB and 8 forWV02), N = NearIR, R = Red, G= Green, B = Blue, "RGB" = Red +Green + Blue, "NRG" = Near-IR + Red+ Green, BGRN = Blue + Green +Red + Near-IR. RGB, NRG, andBGRN are pan-sharpened colorimages, stored at the panchromatic

spatial resolution. For a DEM, thisfield indicates the spectral band (Pan)used to create the product.

For WV02 there are also the followingbands, N2=NIR2, RE=Red Edge,Y=Yellow, C=Coastal

P

Multi

N

R

G

B

RGB

NRG

BGRN

N2

RE

Y

C

RGC

RYC

RYB

MS1

MS2

N2, RE, Y and C in any bandcombination are available forWV02 only

panSharpenAlgorithm

Identifies the algorithm used to createpan-sharpened products:HIS = Hue, Intensity, Saturation

PCA = Principal Component AnalysisDG = DigitalGlobe WaveletUNB = University of New Brunswick

HIS

WAV

PCAUNBDGNone

numRows Number of rows. 1 N

numColumns Number of columns. 1 N

productLevel Product level that indicates theradiometric and geometric correctionsfor backward compatibility with QBconventions in terms of Product Type.

Metadata, LV0, LV1A,LV1B, LV2A, LV3A, LV3B,LV3C, LV3D, LV3E, LV3F,LV3G, LV3X, LV4A, LV3H,LV3I, LV4,Stereo 1B, Stereo 2A, StereoOR2A

Refer toTable 14. ProductLevel to Product TypeRelationships for adefinition of Product Levels.

productType Product type Metadata, Raw, Cal/Val,Basic, Stereo, Standard,

Ortho, DEM

numberOfLooks Indicates whether this is a singleproduct, a stereo pair or a stereotriplet

1 for Non-Stereo,

2 for Stereo Pair,

3 for Stereo Triplet

radiometricLevel Options for radiometric correction. RawCorrected

Not applicable for a DEMproduct

Products 1B and above willall be Corrected.


18/56






radiometricEnhancement

Option for Color Correction andContrast Enhancement

DRA/ColorDRA/ContrastOff

Standard, Stereo EpipolarStereo OR2A,, andOrthorectified Products only

bitsPerPixel The number of bits per pixel in theproduct image files. If the product iscompressed, this value is the originalbits per pixel, before compression.This value will be either 8, 11, or 16,depending on the product. Note thatthis is the number of bits stored in theimage file for each pixel value asopposed to the number of significantbits that define the pixel brightnessvalue (i.e., for a product which isdelivered as 16 bits per pixel, only 11

bits define the brightness value ofeach pixel).

For Raw products, this indicates thenumber of bits per pixel beforecompression or after decompression.

8,

11,

16

This field will not be includedin Metadata products.

11 bits per pixel applies toLevel 0 products only.

restrictedAreaIntersect

Portions of the strip intersecting therestricted area have been modified tomeet the allowable GSD

Yes This field will only beincluded if the strip intersectsthe restricted area and hasbeen modified to meet theallowable GSD.

compressionType The type of compression, if any,applied to the product imagery.

None,

JPEG2000,

Downlink

MrSID

MG2

MG3

This field will not be includedin Metadata products.

Downlink compression

applies to Raw products only.MG2 and MG3compression applies toMrSID formatted products.

jpegProfileName Name of the DigitalGlobe JPEG2000profile applied.

See Error! Bookmark not defined.for comprehinsive range of values.

Included only when thecompression type isJPEG2000.

BEGIN_GROUP = BAND_b

ULLon Geodetic longitude of the upper leftpixel of the image.

Range:

180.00000000

Precision:

8 decimal places

ULLat Geodetic latitude of the upper left pixelof the image.

Range:

90.00000000Precision:

8 decimal places

ULHAE Height above the ellipse of the upperleft pixel of the image.

Precision:

2 decimal places

URLon Geodetic longitude of the upper rightpixel of the image.

Range:

180.00000000

Precision:

8 decimal places


19/56






URLat Geodetic latitude of the upper rightpixel of the image.

Range:

90.00000000

Precision:

8 decimal places

URHAE Height above the ellipse of the upperright pixel of the image.

Precision:

2 decimal places

LRLon Geodetic longitude of the lower rightpixel of the image.

Range:

180.00000000

Precision:

8 decimal places

LRLat Geodetic latitude of the lower rightpixel of the image.

Range:

90.00000000Precision:

8 decimal places

LRHAE Height above the ellipse of the lowerright pixel of the image.

Precision:

2 decimal places

LLLon Geodetic longitude of the lower leftpixel of the image.

Range:

180.00000000

Precision:

8 decimal places

LLLat Geodetic latitude of the lower left pixelof the image.

Range:

90.00000000

Precision:

8 decimal places

LLHAE Height above the ellipse of the lowerleft pixel of the image.

Precision:

2 decimal places

absCalFactor The conversion factor, KnTDI, thatconverts the relative radiance valuesin an image file into correspondingabsolute radiance, measured inwatts/sq m/ster. (This is calibrated

6000 K blackbody radiance,integrated over the appropriatespectral window)

Example:

6.447600e-02

-999 = None whenradiometricEnhancement =DRA.

effectiveBandwidth

The effective bandwidth is associatedwith the absCalFactor and it's value isrequired to calculate top-of-

atmosphere spectral radiance.

0.0000 to 1.0000 scientificnotation

TDILevel Level of the time-delayed integration,as commanded to the spacecraft.

Values:

PAN:

6, 10, 13, 16, 18, 24, 32, 48, 56,64

MS:

1, 3, 6, 10, 14, 18, 21, 24

1 only valid for QB02 MSimage.

See Error! Bookmark notdefined. for list of TDI Levelsfor each spacecraft andband.


20/56






END_GROUP = BAND_b

outputFormat External product format. GeoTIFF,TIFF, and NITF are image formats forBasic, Stereo, Standard andOrthorectified products, CIB is animage format for orthorectified1:24,000 and 1:12,000, while DTED,USGS DEM, and ASCII DTM aredigital elevation model formats forDEM products.

GeoTIFF

TIFF

NITF20

NITF21

NITF21NCDRD

CIB

DTED

USGS DEM

ASCII DTM

J2K

GeoJP2

GeoPDF

MrSID

RPF

KIP

Not applicable for Metadata-Only Products

BEGIN_GROUP = IMAGE_n

satId Satellite Id. QB02, WV01, WV02, WV03

mode Sensor Mode FullSwath, CenterSwath Only FullSwath forQuickBird

scanDirection Sensor scan direction Forward, Reverse Only Forward for QuickBird

CatId DigitalGlobe catalog Id for the rawdata used in this product.

For mosaics, only strips used in the

mosaic creation should be listed. Thecatalog ids are ordered from earliestaquisition to latest.

Example:

1020010007AF7100

For each sub-strip or areabased product

TLCTime Absolute time of the first time-taggedline count record, used in the productcomponent.


Only for Metadata, Level 0,Level1A, and Level 1Bproducts

numTLC Number of time-tagged line countrecords in the TLCList used in theproduct component.

Range:

1


TLCList List of time-tagged line count (TLC)records. Each TLC record consists of

lineNumber (Short)

timeOffset (Float)

lineNumber is the image line number

for a line in the product component.This number will be negative if theTLC record precedes the productcomponent.

timeOffset is the recorded time tag forthis line, in seconds after TLCTime.

The timeOffset will be negative if theimage is in the reverse scan direction.

Example:

(

(-256, 0.000000) ,

(768, 0.148404), ...

(N, N.nnnnnn)

)

Precision:

TLCTime will have 6 decimalplaces precision.


firstLineTime Exposure time for the first line in thestrip used for the product component.



21/56






avgLineRate Average number of image linesexposed per second

See Error! Bookmark not defined.for actual Line Rates. Value mayvary somewhat from these values.

Precision:

2 decimal places

For Pan Sharpened products,this will be equal to theaverage MS line rate.

exposureDuration Duration of the exposure interval foreach line.

Value:

1/avgLineRate

Precision:

8 decimal places

Precision may not run to 8 ifthere are trailing zeroes.

minCollectedRowGSD

Minimum original collected GSD of theproduct in the row direction.

Range:

0.460 5.490

Precision:

3 decimal places

The Pan GSD is used forPanchromatic and Pan-sharpened products; the MSGSD is used for MSproducts.

These value ranges arebased on 0 to 45 degrees off

nadir for all sensors.

maxCollectedRowGSD

Maximum original collected GSD ofthe product in the row direction.

Range:

0.460 5.490

Precision:

3 decimal places

meanCollectedRowGSD

Mean original collected GSD of theproduct in the row direction.

Range:

0.460 5.490

Precision:

3 decimal places

minCollectedColGSD

Minimum original collected GSD of theproduct in the column direction.

Range:

0.460 5.490

Precision:

3 decimal places

maxCollectedColGSD

Maximum original collected GSD ofthe product in the column direction.

Range:

0.460 5.490

Precision:

3 decimal places

meanCollectedColGSD

Mean original collected GSD of theproduct in the column direction.

Range:

0.460 5.490

Precision:

3 decimal places

meanCollectedGSD

Mean GSD of the original, collectedrow and column GSD.

Range:

0.460 5.490

Precision:

3 decimal placesmeanProductRowGSD

Mean GSD of the product in the rowdirection

Range:

0.460 10.000

Precision:

3 decimal places

Applicable to Level 1Bproducts only

meanProductColGSD

Mean GSD of the product in thecolumn direction

Range:

0.460 10.000

Precision:

3 decimal places



22/56






meanProductGSD

Mean GSD of the product row andcolumn GSD

Range:

0.460 10.000

Precision:

3 decimal places


rowUncertainty Mean position uncertainty in line andpixel directions. These are 3-sigma,one-dimensional values.

Precision:

2 decimal places

colUncertainty Mean position uncertainty in line andpixel directions These are 3-sigma,one-dimensional values.

Precision:

2 decimal places

minSunAz Minimum azimuth angle of the sunmeasured from north clockwise.

Range:

0.0 to 360.0

Precision:One decimal place

maxSunAz Maximum azimuth angle of the sunmeasured from north clockwise.

Range:

0.0 to 360.0

Precision:

One decimal place

meanSunAz Mean azimuth angle of the sunmeasured from north clockwise.

Range:

0.0 to 360.0

Precision:

One decimal place

minSunEl Minimum elevation angle of the sunfrom horizontal.

Range:

90.0

Precision:One decimal point

maxSunEl Maximum elevation angle of the sunfrom horizontal.

Range:

90.0

Precision:

One decimal point

meanSunEl Mean elevation angle of the sun fromhorizontal.

Range:

90.0

Precision:

One decimal point

minSatAz Minimum azimuth angle of the satellitewith respect to the center line, indegrees.

Range:

0.0 to 360.0


maxSatAz Maximum azimuth angle of thesatellite with respect to the center line.

Range:

0.0 to 360.0

Precision:

One decimal point

meanSatAz Mean azimuth angle of the satellitewith respect to the center line.

Range:

0.0 to 360.0

Precision:


23/56






One decimal point

minSatEl Minimum elevation angle of thesatellite with respect to the center line.

Range:

90.0

Precision:

One decimal point

maxSatEl Maximum elevation angle of thesatellite with respect to the center line.

Range:

90.0

Precision:

One decimal point

meanSatEl Mean elevation angle of the satellitewith respect to the center line.

Range:

90.0


minInTrackViewAngle

Minimum dihedral angle measured atthe spacecraft from the nominalspacecraft YZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraftY-axis. A positive angle indicates thesensor is looking forward.

Range:

90.0

Precision:

One decimal place

maxInTrackViewAngle

Maximum dihedral angle measured atthe spacecraft from the nominalspacecraft YZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraftY-axis. A positive angle indicates thesensor is looking forward.

Range:

90.0

Precision:

One decimal place

meanInTrackViewAngle

Mean dihedral angle measured at thespacecraft from the nominalspacecraft YZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraftY-axis. A positive angle indicates thesensor is looking forward.

Range:

90.0

Precision:

One decimal place

minCrossTrackViewAngle

Minimum dihedral angle measured atthe spacecraft from the nominalspacecraft XZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraftX-axis. A positive angle indicates thesensor is looking to the right.

Range:

90.0

Precision:

One decimal place

maxCrossTrackViewAngle

Maximum dihedral angle measured atthe spacecraft from the nominalspacecraft XZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraftX-axis. A positive angle indicates thesensor is looking to the right.

Range:

90.0

Precision:

One decimal place

meanCrossTrackViewAngle

Mean dihedral angle measured at thespacecraft from the nominalspacecraft XZ plane to the plane thatcontains the ground projection of theproduct center-line and the spacecraft

Range:

90.0

Precision:

One decimal place


24/56






X-axis. A positive angle indicates thesensor is looking to the right.

minOffNadirViewAngle

The minimum spacecraft elevationangle measured from nadir to theproduct center-line as seen from thespacecraft.

Range:

0.0 to 90.0

Precision:

One decimal place

maxOffNadirViewAngle

The maximum spacecraft elevationangle measured from nadir to theproduct center-line as seen from thespacecraft.

Range:

0.0 to 90.0

Precision:

One decimal place

meanOffNadirViewAngle

The mean spacecraft elevation anglemeasured from nadir to the product

center-line as seen from thespacecraft.

Range:

0.0 to 90.0

Precision:

One decimal place

PNIIRS Mean predicted image quality on theNational Imagery InterpretabilityRating Scale (NIIRS), as computed bythe General Image Quality Equation(GIQE).

0.0 to 9.0 Not applicable for Metadata-Only or Raw Products

cloudCover Estimate of the max cloud-coveredfraction of the product component. .For mosaic products, this calculationis based on the intersection of thepolygons contained in theMOSAIC_CLOSEDPOLYGONSshapefile with the cloud polygonsassociated with that part of the

relevent input imagery.See Section 3.2.2.5 for moreinformation.

[See Exception 1]

0.000 to 1.000

-999.000

Not applicable for Metadata-Only

-999.000 if not assessed

resamplingKernel Method used to resample the image.NULL=no resampling kernel,NN=nearest neighbor, BL=bilinear,CC=cubic convolution,DS8=8 point sinc,DS16=16 point sinc,K16=16 pointed Kaiser sinc,MTF=Modulation Transfer Function,PS=Pan sharpening.ENH=Enhanced (Boost) kernelUserDefined

NULL

NN

BL

CC

DS8

DS16

K16

MTF

PS

ENH

UserDefined

Only valid when doingradiometric correction.

"NN"; "Bilinear"; "CC";"8pointSinc";

"8point Sinc"; "16pointSinc";"16 point Sinc";

"Kaiser16pointSinc"; "Kaiser16 point Sinc";

"MTF";

"PS"; "ENH"

calParam1Time Absolute time associated with the firstrecord in the calParam1List.


Only for Metadata-Only,Level 0, and Level 1Aproducts

numCalParam1 Number of (value, time) records in thecalParam1List

Range:

1

Only for Metadata-Only,Level 0, and Level 1Aproducts

calParam1List List of time-tagged calibration Range: Only for Metadata-Only,


25/56






parameter records. Each recordconsists of:

value (Float)

timeOffset(Float)

The value field is used in radiometriccalibration. timeOffset is the timeassociated with this value, in seconds,relative to calParam1Time.

There will be numCalParam1elements in the list.

For timeOffset:

0.000000

Precision:

Six decimal places for bothentries.

Example:

(

(17.838462, 0.000000),

(17.838543, 1.001259),...

(N.nnnnnn, N.nnnnnn) )

Level 0, and Level 1Aproducts.

positionKnowledgeSrc

Source of knowledge of the satelliteposition. R = Refined

R

attitudeKnowledgeSrc

Source of knowledge of the satelliteattitude. R = Refined

R

revNumber Orbit revolution number at the time ofexposure.

Range:

1 to 99999

END_GROUP = IMAGE_n

BEGIN_GROUP = MAP_PROJECTED_PRODUCT

Only for map-projected(LV2A, LV3 and DEM) StereoEpipolar, and Stereo OR2Aproducts.

earliestAcqTime Acquisition time (UTC) of the first lineof the earliest image contained in theproduct component.


latestAcqTime Acquisition time (UTC) of the first line

of the latest image contained in theproduct component.

YYYY-MM-

DDThh:mm:ss.ddddddZ

For a single image product

this value will be the same asearliestAcqTime

datumName Name of the datum specified for themap projection when the product wasordered.

WE for WGS84

GRS80 for GRS 80

NAR for NAD83

NAS for NAD27

TOKYO Mean Solution forTokyo-Mean

NAD83 uses a GRS 80ellipsoid.

NAD27 uses a Clarke 1866ellipsoid.

Tokyo-Mean uses a Bessel1841 ellipsoid.

semiMajorAxis Length of semi-major axis of thedatum ellipsoid, in meters.

Value:

6378137.0000 for WGS84

6378137.0000 for NAD83 andGRS 80

6378206.4000 for NAD27

6377397.1550 for Tokyo-MPrecision:

4 decimal places

inverseFlattening Inverse flattening of the datumellipsoid, 1/f. Some usefulrelationships between flattening (f),semi-major axis (a), semi-minor axis(b), and eccentricity squared (e2) are:

f = (a - b) / a

e2

= (a2

- b2) / a

2

298.257223563 for WGS84

298.257222101 for NAD83

294.978698200 for NAD27

299.152812800 for Tokyo-M

Precision:


26/56






= 2f - f2

b = a (1 - f)

9 decimal places

datumOffset X, Y, Z offset of the center of thereference ellipsoid relative to theorigin of the WGS 84 system.

For WGS84 & NAD83:

( 0.000,

0.000,

0.000 );

For NAD27:

( -8.000,

160.000,

176.000 );

For Tokyo-Mean:

( -128.000,

481.000

664.000 )

Precision:

3 decimal places.

mapProjName Name of the map projection specifiedwhen the product was ordered.

Epipolar

UTM

State Plane Coordinates

Japan RCS Zone xx

Lambert Conformal Conic

Transverse Mercator

Geographic (Lat/Long)

Epipolar only available forStereo 2A products.

For Japan RCS Zone, validzone number range from 1 to19.

mapProjCode Integer code for the map projection

that was used. This is an index intothe table of generalized projections inReference 6.

1 for UTM

2 for State Plane Coordinates

4 for Lamber Conformal Conic

9 for Transverse Mercator

17 for Geographic (Lat/Long)

Not applicable to Epipolar

products.

mapZone Zone used for the map projection. For UTM:

1 to 60

For State Plane:

0101 5105

Only for UTM and StatePlane projections.

State Plane must have allfour digits present.

mapHemi Code indicating the hemisphere usedfor the map projection.

N;

S

Only for UTM projection

mapProjParam A list of 15 parameters that describe

the particular map projection. Themeaning of each parameter dependson the map projection selected inmapProjCode.

Precision:

9 decimal places

Not applicable to Epipolar

products.

productUnits Units of projected product DD = Decimal Degrees

M = Meters

F = Feet

USF = US Survey Feet

Always meters for Epipolar.

originX Easting of the center of the upper leftpixel of the image.

Precision:

8 decimal places

This is equal to ULX unlessan origin is specified by the


27/56






customer.

originY Northing of the center of the upper leftpixel of the image.

Precision:

8 decimal places

This is equal to ULY unlessan origin is specified by thecustomer.

orientationAngle Azimuth angle measured clockwisefrom map north to the up direction atthe center of the image. This is arotation between raster image and themap coordinate systems. Since map-projected products are always Map-North up, this is always zero.

0.0

colSpacing GSD of the image in the columndirection.

colSpacing = 2 decimal places fornon-geographic projectedproducts

colSpacing = scientific notation forgeographic projected products

Not applicable to DEMs

rowSpacing GSD of the image in the row direction. rowSpacing = 2 decimal places fornon-geographic projectedproducts

rowSpacing = scientific notationfor geographic projected products

Not applicable to DEMs

productGSD GSD of the product. Range:

0.46 2.44

Precision:

2 decimal places

Level 2A and higher productsonly.

The GSD of a MultiSpectralimage needs to equal 4x theGSD of the PAN image. e.g.If the productGSD of a PANimage is 0.50, then theproductGSD of the

MultiSpectral image will be2.00

edgeMatch Indication of the use of edge matchingfor orthomosaic products, i.e. bundleadjusted.

On

Off

Orthorectified products only

colorBalance Indication of the use of color balancefor ortho mosaic products.

On

Off

Orthorectified products only

postSpacing Post spacing on the DEM, in m. Precision:

2 decimal places

Only applicable to DEMs

ULX Easting of the upper left pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places

This value will be equal toorignX.

ULY Northing of the upper left pixel of theimage in the specified datum and mapprojection. Includes blackfill.


This value will be equal tooriginY.

ULH Height above the ellipsoid of the upperleft pixel of the image in the specifieddatum and map projection. Includesblackfill.

Precision:

2 decimal places

URX Easting of the upper right pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places


28/56






URY Northing of the upper right pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places

URH Height above the ellipsoid of the upperright pixel of the image in the specifieddatum and map projection. Includesblackfill.

Precision:

2 decimal places

LRX Easting of the lower right pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision;

8 decimal places

LRY Northing of the lower right pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places

LRH Height above the ellipsoid of the lowerright pixel of the image in the specifieddatum and map projection. Includesblackfill.

Precision:

2 decimal places

LLX Easting of the lower left pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places

LLY Northing of the lower left pixel of theimage in the specified datum and mapprojection. Includes blackfill.

Precision:

8 decimal places

LLH Height above the ellipsoid of the lowerleft pixel of the image in the specifieddatum and map projection. Includesblackfill.

Precision:

2 decimal places

horizontalAccurac

y

Accuracy in location position on

finished DEM product. (1.6 sigma,90% circular error)

0.0 to 200.0 DEM Products only

verticalAccuracy Accuracy of elevation determinationon finished DEM product. (1.6 sigma,90% linear error)

0.0 to 200.0 DEM Products only

DEMCorrection Level of the DEM used for the terraincorrection.

"none"

"Base Elevation"

"Coarse DEM"

"Fine DEM"

Customer Supplied DEM

DTED1 DTED2 DTED3DTED4 DTED5 DTED6

Not applicable to DEMs.

Stereo OR2A and StandardOR2A Products use onlyBase Elevation.

Standard and OrthorectifiedProducts use anything exceptnone.

All other products use none.

terrainHAE The constant value of the heightabove the ellipsoid that was used forthe terrain correction, in meters.

Range:

0

Only when DEMCorrection ="Base Elevation".

numGCP Number of ground control points usedto create this product.

Range:

0

END_GROUP = MAP_PROJECTED_PRODUCT

END;


29/56


3.3.3 Product Browse file

The product browse file is a compressed JPEG file of the delivered product. The productbrowse file will be consistent with the bands ordered for the final product, except formultispectral and 4-band pan-sharpened products for which natural color browse imagery will besupplied. Figure 12 is sample of a natural color-product browse file.

Figure 2. Sample Product Browse File

3.3.4 Tile Map

Large images are tiled into sub-images and distributed as a group of sub-image files,called tiles. Tiles are not uniform in size. If the image does not fill the whole tile, blackfillwill be added to the top and left of the imagery, but removed from the bottom and rightof the imagery in order to maintain a uniform upper left pixel and reduce tile sizes.

Blackfill will only be present in the upper left corner of a product if a tiling origin isspecified that does not correspond to the upper left corner of the Minimum BoundingRectangle of the order polygon. If no tiling origin is specified, the upper left corner ofthe order poly will be the tiling origin by default. This section describes the PVL-formattile map file and part of the XML file. It provides the row and column offset for the upperleft corner of each tile, relative to the upper left corner of the base image product. Formap-projected image products (Standard and Orthorectified), it also provides thelatitude and longitude of the upper left pixel in the tile.


30/56


Table 6. Tile Map Contents


[DG Range / Value, ifdifferent from Format Range

/ Value]

Conditions /

Comments


P = Panchromatic, Multi = all Multi-spectralbands (4 for QB and 8 for WV02), N = NearIR,R = Red, G = Green, B = Blue, "RGB" = Red +Green + Blue, "NRG" = Near-IR + Red + Green,BGRN = Blue + Green + Red + Near-IR. RGB,NRG, and BGRN are pan-sharpened color images,stored at the panchromatic spatial resolution. For aDEM, this field indicates the spectral band used tocreate the product.

For WV02 there are also the following bands,N2=NIR2, RE=Red Edge, Y=Yellow,

C=Coastal, RGC=Red+Green+Coastal,RYC=Red+Yellow+Coastal,RYB=Red+Yellow+Blue, MS1=First 4 bands(N,R,G,B), MS2=Second 4 bands (N2,RE,Y,C)

P

Multi

N

R

G

B

RGB

NRG

BGRN

N2RE

Y

C

RGC

RYC

RYB

MS1

MS2

N2, RE, Y and C in anyband combination areavailable for WV02 only

numTiles The number of tiles for this product. Range:

1

tileSizeX Size of the X component (columns) of each . Range:

1

tileSizeY Size of the Y component (lines) of each tile. Range:

1

tileUnits Units of tiles Pixels

Meters

Feet

Degrees

Degrees onlyapplicable for DOQQproducts.

tileOverlap Overlap of tiles. Range:

0

The following group is repeated for n = 1,,numTiles, i.e., once for each of the tiles.

BEGIN_GROUP = TILE_n

filename Filename of the tile. Example:

10JUL04165542-P2AS-052380211010_01_P001.NTF

ULColOffset Column offset of the upper left pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeX

ULRowOffset Row offset of the upper left pixel of this tile, relativeto the upper left pixel of the base image.

Range:

0 - tileSizeY

URColOffset Column offset of the upper right pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeX


31/56



[DG Range / Value, if

different from Format Range

/ Value]

Conditions /

Comments

URRowOffset Row offset of the upper right pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeY

LRColOffset Column offset of the lower right pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeX

LRRowOffset Row offset of the lower right pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeY

LLColOffset Column offset of the lower left pixel of this tile,relative to the upper left pixel of the base image.

Range:

0 - tileSizeX

LLRowOffset Row offset of the lower left pixel of this tile, relativeto the upper left pixel of the base image.

Range:

0 - tileSizeY

ULLon The geodetic longitude of the center of the upperleft pixel in the tile.

Range:180.00000000

Precision:

8 decimal places

ULLat The geodetic latitude of the center of the upper leftpixel in the tile.

Range:

90.00000000

Precision:

8 decimal places

URLon The geodetic longitude of the center of the upperright pixel in the tile.

Range:

180.00000000

Precision:

8 decimal places

URLat The geodetic latitude of the center of the upperright pixel in the tile.

Range:90.00000000

Precision:

8 decimal places

LRLon The geodetic longitude of the center of the lowerright pixel in the tile.

Range:

180.00000000

Precision:

8 decimal places

LRLat The geodetic latitude of the center of the lowerright pixel in the tile.

Range:

90.00000000

Precision:

8 decimal places

LLLon The geodetic longitude of the center of the lowerleft pixel in the tile.

Range:

180.00000000

Precision:

8 decimal places

LLLat The geodetic latitude of the center of the lower leftpixel in the tile, in degrees.

Range:

90.00000000

Precision:

8 decimal places


32/56




different from Format Range

/ Value]

Conditions /

Comments

ULX Easting of the center of the upper left pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

For Standard andOrthorectifiedproducts, only.

productUnits defined inTable 13. ImageMetadata Contents.

ULY Northing of the center of the upper left pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

URX Easting of the center of the upper right pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

URY Northing of the center of the upper right pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

LRX Easting of the center of the lower right pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

LRY Northing of the center of the lower right pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

LLX Easting of the center of the lower left pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

LLY Northing of the center of the lower left pixel of thetile in the specified map projection, datum, andunits of the product.

Value:

0

Precision:

8 decimal places

END_GROUP = TILE_n

END;

SeeAppendix 3.0for an example of a tile map file.

3.3.5 Attitude Data

The Attitude Data file that is delivered with Basic (1B) products providespacecraft attitude estimates necessary for production of orthorectified imageryproducts. Various GIS applications use these data to geometrically correct andgeolocate higher-level image products. This section defines the parameters,


33/56


data types/sizes, ranges, accuracy, and other information corresponding toeach parameter. The file contains attitude and uncertainty estimates at regularintervals of time, nominally 0.02 seconds. The time-span of the file will cover

the interval that spans the imaging event which generated the subject image.

Table 7. Attitude File Contents (.ATT)


[DG Range / Value, if different fromFormat Range / Value]


revNumber Orbit revolution number at startTime. The revolution numberis incremented at the ascending node crossing each orbit.

Range:

1 99999

stripId Unique 6 character catalog Id. Data is represented as anASCII-encoded hexadecimal integer.

Example:

047898

type Type of data .R = Refined attitude.

R

version Version of the data. A for first version, B for second, etc. A, B, C, etc.

generationTime Time of file generation. YYYY-MM-DDThh:mm:ss.ddddddZ

startTime Time of first data point. YYYY-MM-DDThh:mm:ss.ddddddZ

numPoints Number of points in the file. Range:

1

timeInterval Time interval between points. Values:

0.020;

Precision:

3 decimal places

attList List of attitude data. This is a time-sequential list of records

for point = 1,,numPoints. Each record is a list with 15 fieldsin the following order:

point (Short);

Following is the attitude quaternion for this point:

q1 (Double);

q2 (Double);

q3 (Double);

q4 (Double);

Following are the upper-right elements of the attitudequaternion covariance matrix for this point:

(1,1) element (Float)


(1,3) element (Float)(1,4) element (Float)







The quaternions describe the rotation of the spacecraft

Ranges:

Quaternions will range between1.00;

Covariances will range between

0 1 e -07

(this is not a theoretical range, butthe values observed have not fallenoutside of this range)

Precision:

16 decimal places for all floatingpoint and double precision values.


34/56




coordinate system relative to the ECF frame.

3.3.5.1 Example Attitude Data File

satId = "WV01";revNumber = 18858;stripId = "117BCE";type = "R";version = "A";generationTime = 2011-02-07T19:25:02.000000Z;startTime = 2011-02-07T18:07:31.360000Z;numPoints = 223;timeInterval = 0.020;attList = (( 1, -0.5663632931057035, 0.6761133037075275, 0.3557184219506136, 0.3091404616951993,0.0000000002130000, 0.0000000001730000, 0.0000000000270000, -0.0000000000201000,

0.0000000001760000, -0.0000000000225000, -0.0000000000406000, 0.0000000001400000, -0.0000000000630000, 0.0000000001250000),( 2, -0.5662157377758605, 0.6760040573446036, 0.3559177386019274, 0.3094201287845736,0.0000000002130000, 0.0000000001730000, 0.0000000000270000, -0.0000000000201000,0.0000000001760000, -0.0000000000225000, -0.0000000000406000, 0.0000000001410000, -0.0000000000631000, 0.0000000001250000),( 3, -0.5660681203995883, 0.6758947104771151, 0.3561170802513836, 0.3096996102186175,0.0000000002130000, 0.0000000001730000, 0.0000000000271000, -0.0000000000201000,0.0000000001760000, -0.0000000000225000, -0.0000000000406000, 0.0000000001410000, -0.0000000000632000, 0.0000000001250000),...( 223, -0.5318075220863849, 0.6495808525484328, 0.3984067215630276, 0.3694557614494473,0.0000000002030000, 0.0000000001560000, 0.0000000000364000, -0.0000000000213000,0.0000000001640000, -0.0000000000191000, -0.0000000000444000, 0.0000000001540000, -0.0000000000803000, 0.0000000001340000));END;

3.3.6 Ephemeris Data

The Ephemeris Data file that is delivered with Basic (1B) products containspacecraft ephemeris data. These data are a time history of refinedephemerides and their associated uncertainties. The DG Ground Systemderives these ephemerides from spacecraft telemetry and other supportingGPS data. Various GIS applications use these data to geometrically correct andgeolocate higher-level image products. This section defines the parameters,data types/sizes, ranges, accuracy, and other information corresponding to

each parameter. The file contains ECF position data and associateduncertainty estimates at regular intervals of time, nominally 0.2 seconds.(NOTE: For Basic (1B) products, the time intervals are 0.02 seconds.) Thetime-span of the file will cover the interval that spans the imaging event whichgenerated the subject image.

Table 8. Ephemeris File Contents (.EPH)


35/56





revNumber Orbit revolution number at startTime. The revolution number isincremented at the ascending node crossing each orbit.

Range:

1 to 99999

stripId Unique 6 character catalog Id. Example:

047898

type Type of data : R = Refined ephemeris. R

version Version of the data. A for first version, B for second, etc. A, B, C, etc.

generationTime Time of .EPH file generation. YYYY-MM-DDThh:mm:ss.ddddddZ

startTime Time of first data point. YYYY-MM-DDThh:mm:ss.ddddddZ

numPoints Number of points in the file. Range:

1

timeInterval Time interval between points. Values:

For Metadata-Only and LV1A:

0.200

For LV1B:

0.020

Precision:

3 decimal places

ephemList List of ephemeris data. This is a time-sequential list of records forpoint = 1,,numPoints. Each record is a list with 13 fields in thefollowing order (field type is in parenthesis):

point (Short);

Following is the spacecraft position and velocity for this point:

X position (Double);

Y position (Double);

Z position (Double);

X velocity (Double);

Y velocity (Double);

Z velocity (Double);

Folowing are the upper-right elements of the position covariancematrix for this point:

(1,1) element (Float);





(3,3) element (Float);All measurements are in the ECF coordinate system. Positionsare in meters and velocities in m/sec. Positon variances andcovariances are in m

2.

Ranges:

Position ranges will be within:

6910000.00

for QB02 and WV01;

7150000.00

for WV02.

Velocity ranges should be within:

7750.00 for QB02;

7608.00 for WV01;

7462.00 for WV02.

Covariance ranges should fallwithin:

0 0.01

Precision:

16 decimal places for floating point

and double floating point values.

3.3.6.1 Example Ephemeris Data File

satId = "WV01";revNumber = 18858;stripId = "117BCE";type = "R";


36/56


version = "A";generationTime = 2011-02-07T19:27:47.102466Z;startTime = 2011-02-07T18:07:31.200000Z;numPoints = 24;

timeInterval = 0.200;ephemList = (( 1, -1288858.0326000000000000, -5140532.7109000000000000, 4366935.1416000000000000, -2767.9697902000000000, -4240.1756961000000000, -5792.4066650000000000, 0.0016992631555000,0.0007594386873400, 0.0012291084037000, 0.0025600337587000, 0.0022366293743000, 0.0044390571288000),( 2, -1289411.6073000000000000, -5141380.6121000000000000, 4365776.5527000000000000, -2767.7779224000000000, -4238.8366283000000000, -5793.4830487000000000, 0.0016991825214000,0.0007590921721000, 0.0012292464961000, 0.0025591463270000, 0.0022363795857000, 0.0044403370330000),( 3, -1289965.1438000000000000, -5142228.2457000000000000, 4364617.7482000000000000, -2767.5858799000000000, -4237.4973573000000000, -5794.5591478000000000, 0.0016991018374000,0.0007587455934600, 0.0012293844185000, 0.0025582589889000, 0.0022361293180000, 0.0044416169450000),...( 24, -1301580.4776000000000000, -5159966.6058000000000000, 4340233.2382000000000000, -2763.5126222000000000, -4209.3259783000000000, -5817.0912978000000000, 0.0016973960248000,0.0007514527448800, 0.0012322417568000, 0.0025396466778000, 0.0022307632800000, 0.0044684980664000));

END;

3.3.7 Rational Polynomial Coefficients

This section describes the content of the PVL-format RPC00B file and thecorresponding part of the XML file. It contains the coefficients for Rapid PositioningCapability, also called Rational Polynomial Coefficients (RPC), in particular, thecoefficients used in the RPC NITF support data extension RPC00B in reference 3. Thisis a mathematical mapping from object space coordinates to image space coordinates.This mapping includes non-ideal imaging effects, such as lens distortion, lightaberration, and atmospheric refraction.RPC00Bs express the normalized column and row values in an image, (cn, rn), as a ratio

of polynomials of the normalized geodetic latitude, longitude, and height, (P, L, H).Normalized values are used instead of actual values in order to minimize numericalerrors in the calculation. The scales and offset of each parameter are selected so thatall normalized values fall in the range [-1, 1]. The normalization used is as follows:

P = (Latitude - LAT_OFF) / LAT_SCALE

L = (Longitude - LONG_OFF) / LONG_SCALE

H = (Height - HEIGHT_OFF) / HEIGHT_SCALE

rn = (ROW - LINE_OFF) / LINE_SCALE

cn = (Column - SAMP_OFF) / SAMP_SCALE

Each polynomial is up to third order in (P, L, H), having as many as 20 terms. The

rational functions are

=

=

=

=

=

=20

1

20

1

20

1

20

1

),,(__

),,(__

),,(__

),,(__

i

ii

i

ii

n

i

ii

i

ii

n

HLPpCOEFDENSAMP

HLPpCOEFNUMSAMP

cand

HLPpCOEFDENLINE

HLPpCOEFNUMLINE

r


37/56


LINE_NUM_COEF, LINE_DEN_COEF, SAMP_NUM_COEF, and SAMP_DEN_COEFare 20-term vectors of coefficients that are given in the RPC00B file. p(P,L,H) is a 20-term vector of with the following terms:

Table 9. RPC Terms

I pi (P,L,H) I pi (P,L,H)

1 1 11 PLH

2 L 12 L3

3 P 13 LP2

4 H 14 LH2

5 LP 15 L2P

6 LH 16 P3

7 PH 17 PH2

8 L2 18 L2H

9 P2 19 P2H

10 H2 20 H3

For example, for a generic set of polynomial coefficients Ci, the corresponding 20-termcubic polynomial has the form

f(P, L, H) = C1 + C2L + C3P + C4H + C5LP + C6LH + C7PH + C8L2+ C9P

2+ C10H2+

C11 PLH + C12L

3

+ C13LP

2

+ C14LH

2

+ C15L

2

P + C16P

3

+ C17PH

2

+ C18L

2

H + C19P

2

H +C20H3

The image coordinates are expressed in pixels. The ground coordinates are latitudeand longitude in decimal degrees, and geodetic elevations (height above the ellipsoid)in meters.

There is only one set of coefficients for Basic, Stereo, and Standard products since theirmulti-spectral bands are co-registered and the images are geometrically continuouswithin each band. The range of values for each numeric parameter is as specified inThe Compendium of Controlled Extensions (CE) for the National Imagery Transmission Format

(NITF). Out-of-range coefficients are set to zero.

Table 10. RPC00B Contents



different from Format

Range / Value]

Conditions /

Comments
http://www.gwg.nga.mil/ntb/baseline/docs/stdi0002/index.htmlhttp://www.gwg.nga.mil/ntb/baseline/docs/stdi0002/index.htmlhttp://www.gwg.nga.mil/ntb/baseline/docs/stdi0002/index.htmlhttp://www.gwg.nga.mil/ntb/baseline/docs/stdi0002/index.htmlhttp://www.gwg.nga.mil/ntb/baseline/docs/stdi0002/index.html


38/56





Range / Value]

Conditions /

Comments

satId Satellite Id. QB02, WV01,WV02, WV03


P = Panchromatic, Multi = all Multi-spectral bands (4 for QB and 8 for WV02),N = NearIR, R = Red, G = Green, B= Blue, "RGB" = Red + Green + Blue,"NRG" = Near-IR + Red + Green, BGRN =Blue + Green + Red + Near-IR. RGB, NRG,and BGRN are pan-sharpened color

images, stored at the panchromatic spatialresolution. For a DEM, this field indicatesthe spectral band used to create theproduct.

For WV02 there are also the followingbands, N2=NIR2, RE=Red Edge,Y=Yellow, C=Coastal

P

Multi

N

R

G

B

RGB

NRG

BGRN

N2

RE

Y

C

RGC

RYC

RYB

MS1

MS2

N2, RE, Y and Cin any bandcombination areavailable forWV02 only

SpecId Identification of the specification whichdefines the RPC implementation used forgenerating and/or interpreting thecoefficients

RPC00B

The following nested groups for BANDs and DETECTOR_ARRAYs are included only for Metadata andCal/Val products.

The following BAND group is repeated for each spectral band in the delivered image product. The index b inthe group name is one of (P,N,R,G,B,N2,RE,Y,C) to differentiate the band group names.

BEGIN_GROUP = BAND_b Only applicablefor Metadata-Only, Level 0,and Level 1Aproducts.

The following DETECTOR_ARRAY group is repeated for n = 1,,numDetArr, i.e., for each linear detectorarray in the spectral band.

BEGIN_GROUP = DETECTOR_ARRAY_n Only applicablefor Metadata-Only, Level 0,and Level 1Aproducts.

errBias Bias error. 68% non time-varying errorestimate for correlated images.

Range:

0.00 9999.99


39/56





Range / Value]

Conditions /

Comments

Precision:

2 decimal places

errRand Random error. 68% time-varying errorestimate for correlated images.

Range:

0.00 9999.99

Precision:

2 decimal places

lineOffset LINE_OFFSET. Range:

0 999999

sampOffset SAMP_OFFSET. Range:0 999999

latOffset LAT_OFFSET. Range:

90.0000

Precision:

4 decimal places

longOffset LONG_OFFSET. Range:

180.0000

Precision:

4 decimal places

heightOffset HEIGHT_OFFSET. Range:

9999

lineScale LINE_SCALE Range:

1 - 99999

sampScale SAMP_SCALE Range:

1 - 99999

latScale LAT_SCALE Range:

90.0000

Precision:

4 decimal places

longScale LONG_SCALE Range:

180.0000


heightScale HEIGHT_SCALE Range:

9999

lineNumCoef LINE_NUM_COEF. Twenty coefficients forthe polynomial in the numerator of the rnequation.

Range:

9.999999109

lineDenCoef LINE_DEN_COEF. Twenty coefficients for Range:

imagery support data documentation

Documents