Individual burst access for Sentinel-1 SLCs

Date: Oct 05, 2021

On Descartes Lab's platform:

  1. Every individual TOPS burst has a unique ID
  2. Different polarization combinations corresponding to a given burst can be individually accessed
  3. Metadata associated with an individual burst can be queried independent of imagery
  4. Imagery can be accessed from different sources - e.g, DL buckets or ASF

Shown below are code snippets to access metadata and imagery for a single burst within the DL platform.

# Public DL API for searching imagery on platform
from descarteslabs.catalog import Image

# S1 specific internal DL tool
from s1geocoder.s1parser.dl import bursts
from s1geocoder.s1parser.asf import bursts as asfbursts

# Burst to fetch - searchable using public Descartes Labs API
imgid = "sentinel-1:burstslc:v0:2020-08-26-S1B-137-0612-IW2-VV-RA-B52F"

# Public method - Get image metadata
img = Image.get(imgid)

# Internal method - Query metadata and orbit
# orbit_types specifies precedence
burst, orbit, lookup = bursts.get_burst_metadata(
    img, orbit_types=["precise", "restituted"]
)

# Internal method - Get imagery as int16 numpy stream from DL bucket
dl_stream = bursts.get_burst(img, burst, lookup)

# Internal method - Get imagery as int16 numpy stream from ASF
asf_stream = asfbursts.get_burst(img, burst, lookup, token=earthdata_token)