GBDX

RADARSAT-2

Table of Contents

Section Description
Overview Overview of the MDA RADARSAT-2 extra-fine dataset
Accessing MDA RADARSAT-2 Data Location information for RADARSAT-2 data. This section describes how this works
RADARSAT-2 Acquisitions and Products This section describes acquisitions and products
Types This section describes the "types" used to identify RADARSAT-2 Acquisitions and Products
Search This section describes how to search for RADARSAT-2 Acquisitions and Products, and provides examples of a search and response
Product Properties This section defines the properties of a RADARSAT-2 product
Acquisition Properties This section defines the properties of a RADARSAT-2 Acquisition
Order RADARSAT-2 Products This section describes how to order RADARSAT-2 products that are not already available in the GBDX product catalog
Find the S3 bucket location for an MDA Product The S3 bucket location is only available to customers who purchase the MDA package.
Run an MDA Task This section identifies algorithms that can run with RADARSAT-2 data on GBDX

Overview

The MacDonald, Dettwiler and Associates Ltd. (MDA) RADARSAT-2 satellite provides high-resolution, operationally focused synthetic aperture radar (SAR) data regardless of cloud cover or light conditions. With unique feature classification capabilities, this dataset allows users to observe features and changes in the environment that would go undetected using other imaging techniques. RADARSAT-2 images the Earth at spatial resolutions ranging from 1 to 100 metres, providing coverage from 144 to 250,000 km2 in a single scene. Access to the global archive of Extra-Fine beam mode imagery is provided via GBDX. MDA has integrated a synthetic aperture radar (SAR) change detection tool into GBDX that will enable amplitude change detection to be performed on RADARSAT-2 imagery.

Uses
Users will be able to extract location intelligence at scale, and create reliably collected change detection value-added products on the platform. Unlocked capabilities include automated port monitoring, object detection, and broad area change monitoring.

Spectral Bands: Extra Fine Beam Mode
Date Range: March 2013 to present
Products available through GBDX: RADARSAT-2 Extra-fine beam mode dataset (SGF Format)
GBDX MDA Package: The GBDX MDA package can be added to an existing GBDX contract, or purchased as a stand-alone product. For more information on this offering, contact gbdx-support@digitalglobe.com .

Learn more about use cases for RADARSAT-2 content on GBDX.

Hong Kong in Extra Fine, XF0W2

Hong Kong in Extra Fine, XF0W2

Disclaimer: RADARSAT-2 Data and Products © MacDonald, Dettwiler and Associates Ltd. (2017). All Rights Reserved. RADARSAT is an official mark of the Canadian Space Agency.

Note: In the GBDX Catalog, the "types" field does not accept special characters. In this case, we use "RADARSAT2" In all other cases, "RADARSAT-2" is used.

Accessing MDA RADARSAT-2 Data

The MDA RADARSAT-2 dataset on GBDX can be searched without an MDA contract. To run analytics using RADARSAT-2 data as inputs, an MDA package is required as part of the user's contract. Once the MDA package contract has been signed, any searches for RADARSAT-2 data will return appropriate S3 paths. Additional users account users should contact their account administrator for access.

RADARSAT-2 Acquisitions and Products

It's important to understand the difference between an MDA Acquisition and an MDA Product.

A RADARSAT-2 Acquisition is a capture from MDA's RADARSAT-2 satellite. An acquisition is the raw data from the capture. It's not an image yet. GBDX catalogs the acquisition data.

A RADARSAT-2 Product is a product made from an acquisition. If a product is cataloged on GBDX, the image is available. Only products can be used as input data for a task on the GBDX platform.

Not every acquisition has a product in the catalog. However, products can be ordered for any acqusition cataloged on GBDX. See Order MDA Products for information on how to order products that are not currently available.

Types

Records are associated with one or more "types". Search by the most specific type that matches your criteria. For example, if you want all acquisitions and products available on GBDX from MDA's RADARSAT-2 platform , search by the type RADARSAT2. For products, search by the type "MDAProduct". For acquisitions, search by "MDAAcquisition".

Product Types

These are the "types" associated with a RADARSAT-2 product record.

Type Definition
GBDXCatalogRecord The parent type for all GBDX catalog records
RADARSAT2 This type indicates all records acquired from the RADARSAT-2 sensor platform
SGFProduct This type indicates the SAR Georeferenced Fine product (also known as Path Image)
MDAProduct This type indicates all product records from MDA data sources

Acquisition Types

These are the "types" associated with a RADARSAT-2 acquisition record.

Type Definition
GBDXCatalogRecord The parent type for all GBDX catalog records
Acquisition The parent type for all acquisitions
MDAAcquisition The type indicates all acquisition records from the RADARSAT-2 sensor platform
RADARSAT2 This type indicates all records acquired from the RADARSAT-2 sensor platform

Search

Using the GBDX Catalog API, search by "types" to find RADARSAT-2 products and acquisitions. To narrow the search results set, include area of interest, date range, or both. Search results can be further filtered by the properties of a a product or acquisition.

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

To use the Postman client to send a request directly to the API endpoint, see Postman Instructions & Collections . The search examples below can be used as body text in the request.

Search Example 1: RADARSAT-2 Acquisition Search

   {  
    "searchAreaWkt": "POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))",
     "startDate":"2015-03-01T00:00:00.000Z",
    "endDate":"2016-03-01T23:59:59.999Z",
    "types":["MDAAcquisition"]
  }

Example RADARSAT-2 Acquisition Response

    {
    "identifier": "252032_001",
    "type": [
        "GBDXCatalogRecord",
        "Acquisition",
        "MDAAcquisition",
        "RADARSAT2"
    ],
    "properties": {
        "beamMode": "Extra Fine",
        "imgRelOrNo_dbl": 35.622371326,
        "archiveFac": "PASS",
        "vendor": "MacDonald, Dettwiler and Associates Ltd.",
        "timestamp": "2013-04-05T13:57:08.997Z",
        "beams": "XF0W2",
        "polarizations": [
            "HH"
        ],
        "archiveId": "233751",
        "footprintWkt": "MULTIPOLYGON(((-132.73335 -39.86666, -131.44159 -40.18248, -131.89179 -41.24695, -133.20203 -40.92627, -132.73335 -39.86666)))",
        "imageId": "252032",
        "sceneNo": 1,
        "sensorPlatformName": "RADARSAT-2",
        "incidenceAngleNearRange": 31.87,
        "passDirection": "Descending",
        "lookDirection": "Right",
        "catalogID": "252032",
        "platformName": "RADARSAT-2",
        "imgCycle": 80
    }
}

See the Acquisition Properties table below for relevant acquisition fields and their descriptions.

Search Example 2: RADARSAT-2 Product Search

   {  
    "searchAreaWkt": "POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))",
     "startDate":"2015-03-01T00:00:00.000Z",
    "endDate":"2016-03-01T23:59:59.999Z",
    "types":["MDAProduct"]
  }

Example RADARSAT-2 Product Response

This example response shows the search statistics for the example search above, and the properties of a single product record.

{
           "identifier": "PDS_05850140",
           "type": [
               "GBDXCatalogRecord",
               "RADARSAT2",
               "SGFProduct",
               "MDAProduct"
           ],
           "properties": {
               "beamMode": "Extra Fine",
               "lutApplied": "Point Target",
               "processingTime": "2017-05-14T14:51:02.000000Z",
               "metadataFiles": [
                   "product.xml"
               ],
               "productID": "PDS_05850140",
               "timestamp": "2017-02-15T13:21:17.734Z",
               "catalogID": "539069",
               "imageFiles": [
                   "imagery_HH.tif"
               ],
               "passDirection": "Ascending",
               "platformName": "RADARSAT-2",
               "polarizations": [
                   "HH"
               ],
               "vendor": "MacDonald, Dettwiler and Associates Ltd.",
               "lutFiles": [
                   "lutBeta.xml",
                   "lutSigma.xml",
                   "lutGamma.xml"
               ],
               "beams": "XF0W2",
               "bucketPrefix": [the S3 bucket prefix will be displayed here]
               "incidenceAngleNearRange": 31.5030136,
               "bucketName": [the S3 bucket name will be displayed here],
               "productLevel": "SGF",
               "incidenceAngleFarRange": 38.7216492,
               "processingFacility": "GSS",
               "footprintWkt": "MULTIPOLYGON(((67.9792225001 37.8070966995, 69.3632456784 38.0121395386, 69.617397801 36.8982189674, 68.2546198468 36.6928904347, 67.9792225001 37.8070966995)))",
               "softwareVersion": "CAPPS SAR 1.3",
               "sensorPlatformName": "RADARSAT-2",
               "lookDirection": "Right"
           }
       },
      
  • The S3 location is a combination of "bucketName" and "bucketPrefix".

  • The values for this fields are only displayed for customers who have purchased an MDA package.

Search Example 3: search for RADARSAT-2 records (products and acquisitions)

This search returns RADARSAT-2 acquisitions and products.

  {  
    "searchAreaWkt": "POLYGON ((-122.41189956665039 37.59415685597818, -122.41189956665039 37.64460175855099, -122.34529495239259 37.64460175855099, -122.34529495239259 37.59415685597818, -122.41189956665039 37.59415685597818))",
     "startDate":"2015-03-01T00:00:00.000Z",
    "endDate":"2016-03-01T23:59:59.999Z",
    "types":["RADARSAT2"]
  }

Example statistics for a RADARSAT-2 search

These are the statistics for the search example above. Both MDA acquisitions and MDA products are returned in the result set. Each record will display the properties of its type.

{
    "stats": {
        "recordsReturned": 34,
        "totalRecords": 34,
        "typeCounts": {
            "MDAProduct": 25,
            "RADARSAT2": 34,
            "GBDXCatalogRecord": 34,
            "MDAAcquisition": 9,
            "SGFProduct": 25,
            "Acquisition": 9
        }
    }

Identifying Same Geometry Stacks

MDA change detection algorithms require the identification of same geometry stacks before processing. See Identifying Same Geometry Stacks for instructions.

Product Properties

These are the properties returned in a RADARSAT-2 Product search. Most of these properties can be used as filters to reduce search results. .

Property Description Values
beamMode Extra Fine (XF) beam mode data is available on GBDX Extra Fine
beams Beam Mnemonic describing beam mode and beam position. Extra Fine (XF) beam mode data is available on GBDX. Example: "XF0W3"
bucketName S3 bucket name. N/A
bucketPrefix S3 bucket prefix. N/A
catalogID This is the catalog ID assigned to the acquisition in the GBDX catalog. The imageID and catalogID are always the same for MDA data Ex: "424074"
footprintWKT The well known text (wkt) POLYGON is used for searchAreaWkt searches. Other geometry types are not supported. See example
ImageFiles The name of the image file or files for this product Example: imagery_HH.tif
incidenceAngleFarRange_dbl Incidence angle at far range at mid-azimuth position of the image. Example: 44.2646599 (units = deg)
incidenceAngleNearRange_dbl Angle [degrees] between the vertical at swath center and the line from that point to the satellite when the satellite is broadside to the point. Example: 38.3(units =deg)
lookDirection Spacecraft Orientation "left" or "right"
lutApplied Output scaling LUT applied string: for example, "point target"
processingTime Date/time at which processing was performed Example format: "2017-05-03T17:45:48.000000Z"
lutFiles the xml files the lut metadata is derived from "lutBeta.xml", "lutSigma.xml", "lutGamma.xml"
metadataFiles meta data file that contains product information product.xml
passDirection Direction of satellite pass defined at the start of the archive segment Ascending or Descending
platformName The name of the sensor platform that acquired the data RADARSAT-2
polarizations Polarizations used to produce this product. The first letter is transmit polarization and the second letter is receive polarization Polarization identifiers are “HH” “VV” “HV” “VH”
productID The ID for the MDA product record Example: PDS_05778000
productLevel The MDA product level for the record. GBDX catalogs productLevel SGF
processingFacility Name of the processing facility which generated the product GSS
softwareVersion Version of software used to process the data CAPPS SAR 1.3
sensorPlatformName The name of the sensor platform that acquired the data RADARSAT-2
timestamp Date/time stamp of first raw data line used during the processing Example: "2013-04-10T04:27:31.823Z"
vendor The vendor is the provider of the product data MacDonald, Dettwiler and Associates Ltd.

Acquisition Properties

Property Description Values
archiveFac Archive Facility "PASS", "GATN" or foreign archive
archiveID Identifier assigned by the archive facility string; example: Identifier
beamMode MDA's archive of Extra Fine beam mode data is available on GBDX Extra Fine
beams Beam Mnemonic describing beam mode and beam position. Extra Fine (XF) beam mode data is available on GBDX Example: "XF0W3"
catalogID This is the catalog ID assigned to the acquisition in the GBDX catalog. The imageID and catalogID are always the same for MDA data Example: 287688
footprintWKT The well known text (wkt) POLYGON is used for searchAreaWkt searches. Other geometry types are not supported. "MULTIPOLYGON(((-122.759388785 37.3960461199, -122.523402952 38.5092696551, -121.167566795 38.3247654766, -121.424551057 37.2106634407, -122.759388785 37.3960461199)))"
identifier This is the unique ID in the GBDX catalog for this record The naming convention is <catalogID>_<sceneNo>. Example: 409017_001.
imageID This is MDA's identifier for this acquisition. imageID and catalogID are always the same for MDA data Example: 287688
imgCycle Orbit cycle in which the image acquisition starts (343 orbits per 24-day cycle for RADARSAT-2) Integer; Example: 146
incidenceAngleNearRange Angle [degrees] between the vertical at swath center and the line from that point to the satellite when the satellite is broadside to the point. Example: 38.3 (units =deg)
lookDirection Satellite orientation "left" or "right"
passDirection Direction of satellite pass defined at the start of the archive segment Ascending or Descending
platformName The name of the sensor platform that acquired the data RADARSAT-2
polarizations Polarizations used to produce this product. The first letter in the value is the transmit polarization. The second letter is the receive polarization. Polarization identifiers are “HH” “VV” “HV” “VH”. See "Polarizations" below for polarization definitions.
sceneNo Scene number within segment, starting at 1 and incrementing by 1 for each scene. There can be multiple records with the same imageID, but each record will have a difference scene number. Example: 1
sensorPlatformName The name of the sensor platform that acquired the image data. This field is identical to "platformName". RADARSAT-2
timeStamp Framed product segment start date/time in UTC: “yyyy-mm-ddThh:mm:ss.uuu” Example: "2017-08-21T22:22:34.727Z"
vendor The vendor is the provider of the data MacDonald, Dettwiler and Associates Ltd.

Polarization Identifiers

Identifier Description
HH Horizontal polarization on transmit, Horizontal polarization on receive
HV Horizontal polarization on transmit, Vertical polarization on receive
VH Vertical polarization on transmit, Horizontal polarization on receive
VV Vertical polarization on transmit, Vertical polarization on receive

Acquisition Strip Example

This example shows the scenes that are part of an acquisition.

This example shows an acquisition with multiple scenes. The catalog ID is the same for each scene within the strip.

This example shows an acquisition with multiple scenes. The catalog ID is the same for each scene within the strip.

Order RADARSAT-2 Products

When identifying a set of RADARSAT-2 data to use, we recommend searching for products in your Area of Interest. If the product data set for your AOI is not acceptable, GBDX MDA subscribers can place an order for additional products.

To order products, search for MDA acquisitions in your Area of Interest. Once you have identified the catalog IDs you want to order, send the following information to gbdx-support@digitalglobe.com for each acquisition:

  • imageID
  • Date Range
  • The WKT for the Area of Interest

Example:

imageID
52957

Date Range
"startDate": "2014-06-01T12:00:00.000Z",
"endDate": "2014-06-06T12:00:00.000Z"

AOI
"MULTIPOLYGON(((-122.759388785 37.3960461199, -122.523402952 38.5092696551, -121.167566795 38.3247654766, -121.424551057 37.2106634407, -122.759388785 37.3960461199)))"

Find the S3 bucket location for a RADARSAT-2 Product

For RADARSAT-2 products, the AWS bucket name and bucket prefix are returned provided you have the appropriate account access.

Run an MDA Task

Only RADARSAT-2 data can be used as input data RADARSAT-2 task.

To learn more about MDA's SAR Amplitude Change Detection Task, see MDA® SAR Amplitude Change Detection End-to-End Workflow