Skip to content

ARD Order Delivery Directory Structure

Last updated: June 15, 2022


Maxar ARD products are divided along a global discrete grid of 5km x 5km squares, organized by quadkeys and split into UTM zones. This also serves as a structure to organize the files. For more information about the Maxar grid system, see About ARD: The Maxar Data Grid.

All files from an order are delivered to a single bucket and prefix location that is specified in the order request. If no prefix is specified in the order, the files are delivered to the root bucket location.

Directory structure

The directory structure follows this format:

📁 {bucket or container}
└── 📁 {prefix}
    └── 📁 acquisition_collections
        └─╴📄 {acquisition ID}_collection.json
    └─╴ 📁 order_collections
        └─╴📄 {orderID}_root_collection.json
    └── 📁 {UTM-zone}
        └── 📁 {quadkey}
            └── 📁 {acquisition-date}
                └─╴📄 {acquisition ID}[-{data descriptor}].{file type}
    └── 📄 {orderID}-request.json               

An example showing one tile from an order looks like:

📁 maxar-ard-samples
└── 📁 sample-002
    └── 📁 acquisition_collections
        └─╴📄 10300100B3841C000_collection.json
    └── 📁 order_collections
        └─╴📄 5633324896324598239_root_collection.json
    └── 📁 13
        └── 📁 031133231113
            └── 📁 2021-01-16
                └─╴📄 10300100B3841C00-cloud-mask.gpkg
                └─╴📄 10300100B3841C00-cloud-shadow-mask.gpkg
                └─╴📄 10300100B3841C00-clouds.tif
                └─╴📄 10300100B3841C000-data-mask.gpkg
                └─╴📄 10300100B3841C00-healthy-vegetation.tif
                └─╴📄 10300100B3841C00-healthy-vegetation-mask.gpkg
                └─╴📄 10300100B3841C00-ms-saturation-mask.gpkg
                └─╴📄 10300100B3841C00-ms-saturation.tif
                └─╴📄 10300100B3841C00-ms.tif
                └─╴📄 10300100B3841C000-pan.tif
                └─╴📄 10300100B3841C00-pan-flare.tif
                └─╴📄 10300100B3841C00-pan-flare-mask.gpkg
                └─╴📄 10300100B3841C00-terrain-shadow-mask.gpkg
                └─╴📄 10300100B3841C00-terrain-shadows.tif
                └─╴📄 10300100B3841C000-visual.tif
                └─╴📄 10300100B3841C00-water-mask.gpkg
                └─╴📄 10300100B3841C00-water.tif
                └─╴📄 10300100B3841C00.json
    └── 📄 5633324896324598239-request.json                 

Additional report file for non-intersecting tiles partial delivery

In the event that an order is placed where some tiles do not intersect the AOI, the tiles that intersect will be delivered, and a report showing the non-intersecting tiles will be included in the delivery. If there are no non-intersecting tiles, this report is not generated.

This report is named {orderID}_non_intersecting_tiles_report.json.

It is located in the order_collections subdirectory.

📁 {bucket or container}
└── 📁 {prefix}
    └── 📁 acquisition_collections
        └─╴📄 {acquisition ID}_collection.json
    └─╴ 📁 order_collections
        └─╴📄 {orderID}_root_collection.json
        └─╴📄 {orderID}_non_intersecting_tiles_report.json

Delivery directory structure

This is the directory structure of an ARD order delivery. There can be multiple prefixes in the path.

bucket or container/prefix/UTM_zone/quadkey/acquisition_date/

Directory levels

Location Description Example
bucket or container The cloud storage bucket or container. This is the root of the directory tree. Many prefixes can be be associated with one bucket or container. For example: /{bucket1}/{prefix1} and /{bucket1}/{prefix2}/ maxar-ard-samples
prefix The prefix or subdirectory where the output files are delivered. There can be more than one prefix in a path. sample-002/new-mexico/albuquerque
acquisition_collections Contains the STAC collection files for each acquisition in the order. acquisition_collections
order_collections Contains the STAC collection files for each order delivered to the prefix location. order_collections
UTM-zone The UTM Zone where the acquisitions in this path are located. There are 60 UTM (Universal Transverse Mercator) zones. The sample-002 data is located in Albuquerque, which is in UTM zone 13.There can be many UTM zone subdirectories in one order. 13
quadkey Quadkeys are unique identifiers of ARD Data Grid tiles. Each quadkey represents the boundary of a grid cell. There can be many quadkeys within a UTM zone subdirectory. 031133231113
acquisition-date The date the imagery in the directory path was acquired by the satellite.The files associated with an ARD tile are stored in the acquisition-date subdirectory. 2021-01-16

An "acquisition" is a full image strip acquired by the satellite. A tile is part of an acquisition, identified by the quadkey address. As a result, the same acquisition ID may appear in different directory paths within a UTM zone.

Sample data

Browse ARD sample datasets to see examples of an order delivery.

Back to top