Downloading Imagery from the Library

You should download an image from your library if you need to use it offline or if you want to use it for an extended period of time. Otherwise, you will no longer have access to the image when it is automatically deleted from your library after two weeks.

Each saved image actually consists of several individual files, and you can choose to download either the entire image package (in ZIP or TAR format, depending on what you specified when you saved the image; see Adding Imagery to the Library) or individual files.

Downloading Individual Files from an Image Package

Library with Files Expanded

  1. On the header bar, select My Imagery > Library. The Library dialog opens.

  2. Select the View Files icon next to any image to expand a list of downloadable files.

    Your image package may contain the following files, where <filename> is the name of the image saved in your library: 

    <filename>_RxCx.<format>

    These files represent the tiled imagery you created. The number of files depends on size of the image and resolution selected. The RxCx indicates the Row and Column number, as described in <filename>TILE_SHAPE.zip.

    <filename>_TILE_SHAPE.zip

    This shapefile indicates the row and column number for each tile.

    <filename>_AOI_SHAPE.zip

    This shapefile indicates the detailed metadata for your area of interest (AOI).

    <filename>_SEAMLINES_SHAPE.zip

    This shapefile indicates the detailed metadata for your files. If multiple images were used to create your file, this shapefile describes the attributes by location.

    <filename>_BROWSE.tif

    Included for full resolution images. This is a low resolution (16m) overview image of all the tiles.

    NEXTVIEW.txt

    Contains the NextView Imagery End User License Agreement.

    <filename>_grid_annotations.png

    Included when you save annotations and grids as a separate file when creating a snapshot. See Taking a Snapshot.

    <filename>_RPM_SHAPE.zip

    Included when you create a shapshot while showing the RPM layer. See Working with the Refined Persistent Change Model (RPM).

    <filename>_RxCx.pptx

    Included when you select PowerPoint as a snapshot format. The RxCx indicates the Row and Column number, as described in <filename>TILE_SHAPE.zip.

    <filename>.mov

    <filename>.avi

    <filename>.mp4

    Included when you save a movie when comparing images. See Comparing Imagery.

    Do not use special characters in file names. Special characters can prevent you from downloading files from your library, or may cause errors when downloading imagery. Maxar replaces special characters with underscores.

    Depending on the type of image you saved, your image package may not contain all of the image files listed above.

  3. Select the Download icon next to the file you want to download.
  4. (Optional) Download additional files.

Downloading a Complete Image Package

  1. On the header bar, select My Imagery > Library. The Library dialog opens.
  2. Select the checkbox(es) next to the image(s) you want to download.
  3. Select Download. The Download dialog opens.

  4. Select the type of file transfer you want to use for the download. The corresponding dialog opens.

    HTTPS takes a little longer to download, and in some cases the download might time out depending on your network speed and the size of the files you are trying to download. HTTPS is the only option for downloading individual files. The limit for HTTPS downloads is 2GB. This option is available when downloading a single image.

    Files larger than 2GB will not download completely.

    • When you select HTTPS, a ZIP or TAR file downloads, depending on the options you selected when saving the file. See Adding Imagery to the Library.

    Turbo uses the Aspera Connect plugin to improve download time. This option is available when downloading one or more images.

    • When you select Turbo, you are prompted to install the plugin. The image downloads after you install the plugin.

    To use Turbo downloads, you must open the following ports in the client-side firewall:

    • TCP Outbound 33000 and 33001
    • UDP Outbound on 33001
    • UDP Inbound on 33001 – 33999

    You must also enable your broswer's Aspera plug-in.

    If you have a popup blocker installed, you must deactivate it to use the Aspera Connect plugin.

    FTP downloads larger files with your FTP client. This option is available when downloading a single image.

    FTP Access Dialog

    • In the FTP Access dialog, do one of the following:

      • For Larger Files Use the credentials provided in the FTP Access dialog with your preferred FTP client to connect to the Maxar FTP server and download your file.
      • For Smaller Files Select Download Using Browser. The file is downloaded to your computer.

    FTP Push pushes larger files to a remote FTP server. This option is available when downloading one or more images.

    FTP Push Settings Dialog

    • In the FTP Push Settings dialog:

      1. In the Protocol drop-down list, select FTP (Non-secure).
      2. In the Hostname field, enter the hostname of your FTP server.
      3. (Optional) In the Path field, enter the path to which you want to push the file.
      4. In the Username and Password fields, enter your FTP credentials.
      5. Select Push Item. The file is pushed to your FTP server. Depending on the size of the file, the transfer may take several hours or longer to complete.

    SFTP downloads larger files with your SFTP client. This option is available when downloading a single image.

    SFTP Access Dialog

    • In the SFTP Access dialog, use the credentials provided with your preferred SFTP client to connect to the Maxar SFTP server and download your file.

    SFTP Push pushes larger files to a remote SFTP server. This option is available when downloading one or more images.

    SFTP Push Settings Dialog

    • In the SFTP Push Settings dialog:

      1. In the Protocol drop-down list, select SFTP (Secure, server must support SSL2.
      2. In the Hostname field, enter the hostname of your SFTP server.
      3. (Optional) In the Path field, enter the path to which you want to push the file.
      4. In the Username and Password fields, enter your SFTP credentials.
      5. Select Push Item. The file is pushed to your SFTP server. Depending on the size of the file, the transfer may take several hours or longer to complete.

    JWICS is not available for NIPRNet. This option is available when downloading one or more images.

    JWICS Dialog

    • In the JWICS Push Settings dialog:

      1. In the JWICS Email field, enter your email address.

        The email address you enter must be a valid ic.gov email address.

      2. Select Push Item. The file is pushed from your library to a location available on JWICS.

        Depending on the size of the file, the transfer may take several hours or longer to complete. Geopackage format types are the only format that cannot be transferred.

    S3 pushes larger files to a remote AWS S3 bucket. This option is available when downloading one or more images.

    Amazon S3 Push Settings Dialog

    1. In the Amazon S3 Push Settings dialog:

      1. In the Bucket field, enter your bucket name.
      2. (Optional) In the Folder field, enter the folder path.
      3. In the Access Key and Secret Key fields, enter your credentials.
      4. Select Push Item. The file is pushed to your S3 bucket. Depending on the size of the file, the transfer may take several hours or longer to complete.
    2. Attach the following IAM policy to the IAM user:
    Copy
    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Sid": "GEGDPush",
                "Effect": "Allow",
                "Action": "s3:PutObject",
                "Resource": [
                    "arn:aws:s3:::<your bucket name goes here>/*"
                ]
            }
        ]
    }

Image Support Data

All Imagery Products are delivered with a set of metadata files called Image Support Data (ISD). The number and types of files delivered varies depending on the product ordered. The ISD files can be viewed as a collection point for all useful ancillary data. The table below lists the Image Support Data files that are delivered with each product type.

File Name

Extension

Top-Level Index (Readme) File

.txt

Top-Level Index (XML) File

.xml

Layout File

.jpg

Geographic Location Map Files

.shx, .shp, .dbf

Product Component Index (Subdirectory Readme) File

.txt

License File

.txt

Image Metadata File

.imd

Product Browse File

.jpg

Tile Map File

.til

Attitude File

.att

Ephemeris File

.eph

Geometric Calibration File

.geo

RPC00B File

.rpb

XML File

.xml

Image Support Data File Description

Products include Image Support Data (ISD) at two levels: one set of Delivery ISD, and one set of Product Component ISD for each product option ordered. The number of product components depends on the layout of the order polygon with respect to scene or strip boundaries. If the order polygon is entirely contained within a single scene or strip, then only one product component will be delivered. If an order polygon crosses strip or scene boundaries, then the imagery product will be 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 the ISD files, along with copyright information for the entire product delivery.

  • 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 media including product and order polygon extents. The map includes volume and product labels. The file is in the standard JPEG format. Media volume information is not included for electronic deliveries.

  • Geographic Location Map Files These files spatially illustrate the product layout in a similar way to the layout file except in shapefile format. The files represent the order polygon, strip boundaries, product boundaries, and tile boundaries.

  • Manifest File The manifest file is included with electronic (FTP) deliveries only. The file contains 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 all product files have been transferred. 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 provides copyright 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 of acquisition.

  • Product Browse File The product browse file is a JPEG compressed browse image of the delivered product.

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

  • 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.

  • 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 standard photogrammetric parameters of a virtual camera that models the corresponding camera and optical system for Basic Imagery products.

  • RPC00B File 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.

  • 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 also included.

File Layout

This section describes the structure by which the Image Support Data (ISD) files are organized for delivery. Figure below displays the layout as it applies to delivery of imagery and ISD files for all media types: PAN for Panchromatic, MUL for Multispectral, PSH for Pansharpened, and MOS for Mosaicked products.

File Structure Layout

More Information

  • All users can download via HTTPS, similar to how you download other files from the Internet. Depending on your account configuration, other download options may also be available
  • You can view your transfer history in the Transfer History dialog. See Viewing Transfer History.
  • To download SAR imagery (e.g., Capella, ICEYE), you will not use the Library download options. Instead, select the Image Menu , then select View Metadata. In the Metadata dialog, select the Click to Download link. See Downloading SAR Imagery.