Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objective

The SAR Availability Tool allows users to ascertain multi-sensor SAR acquisitions availability for areas of interests. It allows users to determine for a given area the available SAR acquisitions that have already been acquired/archived, planned, and predicted future-potential.

https://sar-avail.jpl.nasa.gov/

User Manual (End-User documentationDocumentation): https://docs.google.com/document/d/1-fM5HlbPDCUfgD0Pl0ws9lWq35sp6Zeg6h0rE0wt1Nc/edit

Feedback Form: https://docs.google.com/forms/d/e/1FAIpQLSeY7Ts3fBY-nDMnnnSW9DfQ74qh2Z2uZEM5ZuBK75ydFZleIA/viewform?usp=sf_link

Stand-alone BOS SARcat Scraper CLI tool

Instructions for installation can be found in the public repo: https://github.com/aria-jpl/bos_sarcat_scraper

  • This queries BOS and outputs the result set in JSON format

  • Inputs

    • Temporal Extent:

      • start / end time

      • OR

      • Since last ingest time on BOS

    • Spatial Extent

    • Sorting - Sort By and Sorting order

  • Usage:

    Code Block
    languagebash
    bos_sarcat_scraper -h
    usage: bos_sarcat_scrapper [-h] [-from FROMTIME]
                               [--fromBosIngestTime FROMBOSINGESTTIME]
                               [-to TOTIME] [--spatialExtent SPATIALEXTENT]
                               [--sortBy SORTBY] [--sort SORT]
    
    Query BOS SarCat for acquisitions.
    
    optional arguments:
      -h, --help            show this help message and exit
      -from FROMTIME, --fromTime FROMTIME
                            specify the temporal start point in format , to get
                            acquisitions starting after the given timestamp in the
                            format yyyy-mm-ddThh:mm:ss.sss
      --fromBosIngestTime FROMBOSINGESTTIME
                            provide date and time in format , to get acquisitions
                            acquired by BOS after the given timestamp in the
                            format yyyy-mm-ddThh:mm:ss.sss
      -to TOTIME, --toTime TOTIME
                            specify the temporal end point in format , to get
                            acquisitions ending before the given timestamp in the
                            format yyyy-mm-ddThh:mm:ss.sss
      --spatialExtent SPATIALEXTENT
                            specify the area of interest in GeoJSON format
      --sortBy SORTBY       type "start_time" , "stop_time" or "bos_ingest" to
                            sort results by field
      --sort SORT           type "asc" or "des" to get results in ascending or
                            descending order of time respectively. If sortBy is
                            specified but sort is not, then defaults to ascending

Platforms

Data from the following platforms are available:

...

We collect acquisition metadata across these platforms by scraping BOS SARcat.

Acquisition Statuses

  • Archived

    • Implies it is archived into storage

    • We do not get archived from BOS, as it only tells us acquisitions, not SLC data files

  • Acquired

    • Only states that the SLC has been acquired. We don’t know where it is archived if it is archived yet

  • Predicted

    • Based on repeat orbit of prior acquisitions

    • Predicted acquisitions is generated on our end based on an acquired acquisitions and BOS returning next cycle repeat dates.

  • Planned

    • Some agencies published their planned acquisitions

    • ESA publishes planned 2-weeks ahead time

Acquisition Naming Convention

acquisition-[spacecraft name]_[start timestamp]_[track number]_[beam mode]-bos_sarcat

...

acquisition-ALOS-2_20190713T235342.095Z_206_SM3-bos_sarcat-predicted

Export formats

After filtering to the acquisitions you are interested in, there are options to export the data in the following formats:

...