- Title: InSAR
- Identifier: https://stac-extensions.github.io/insar/v1.0.0/schema.json
- Field Name Prefix: insar
- Scope: Item
- Extension Maturity Classification: Proposal
- Owner: @fabricebrito, @emmanuelmathot
This document explains the InSAR Extension to the SpatioTemporal Asset Catalog (STAC) specification.
Interferometric synthetic aperture radar, abbreviated InSAR (or deprecated IfSAR), is a radar technique used in geodesy and remote sensing. This geodetic method uses two or more synthetic aperture radar (SAR) images to generate maps of surface deformation or digital elevation, using differences in the phase of the waves returning to the satellite or aircraft. The technique can potentially measure millimetre-scale changes in deformation over spans of days to years. It has applications for geophysical monitoring of natural hazards, for example earthquakes, volcanoes and landslides, and in structural engineering, in particular monitoring of subsidence and structural stability.
The extension is primarly intented to describe products of InSAR processing, typically interferograms and related products.
- Examples:
- Item example: Shows the basic usage of the extension in a STAC Item
- JSON Schema
- Changelog
Field Name | Type | Description |
---|---|---|
insar:perpendicular_baseline | number | The distance between two acquisition spots perpendicular to the satellite viewing direction |
insar:temporal_baseline | number | The time period between the reference and secondary acquisitions |
insar:height_of_ambiguity | number | This height of ambiguity is the 2 ฯ interferometric phase cycle scaled with the perpendicular baseline between both satellites. The smaller the height of ambiguity is, the lower is the influence of errors caused by the instrument or the different decorrelation effects. |
insar:reference_datetime | string | Date of reference acquisition, in UTC. It is formatted according to RFC 3339, section 5.6. |
insar:secondary_datetime | string | Date of secondary acquisition, in UTC. It is formatted according to RFC 3339, section 5.6. |
insar:processsing_dem | string | String representing the Digital Elevation Model used for processing the input data. A list is proposed in the DEMs section |
insar:processsing_dem | string | String representing the Digital Elevation Model used for geocoding the product. A list is proposed in the DEMs section |
It is higly recommended to use the following fields to describe the InSAR product:
Field name | InSAR usage |
---|---|
date_time | Center Time of the product, in UTC. (Here the date is not significant) |
sar:polarizations | Any combination of polarizations of the input products. |
processing:level | L3 level is recommended since InSAR is a composite product. |
processing:lineage | Describe InSAR specific technique. For instance, Geocoded Unwrapped Interferogram TOPSAR |
processing:software | Software used for InSAR processing. For instance {"ESA SNAP Toolbox": "8.0"}, {"SNAPHU": "1.4.2"} |
sat:orbit_state | ascending or descending |
sat:relative_orbit | relative orbit (track) of the input datasets |
view:azimuth | The azimuth angle of the center of the product. |
view:incidence_angle | The incidence angle of the center of the product. |
One of the emerging best practices is to use Asset Roles to provide clients with more information about the assets in an item. The following list includes a shared vocabulary for InSAR assets. This list should not be considered definitive, and implementors are welcome to use other asset roles. If consensus and tooling consolidates around these role names then they will be specified in the future as more standard than just 'best practices'.
Role Name | Description |
---|---|
coherence | 2D Coherence [0-1] from filtered interferogram |
phase | 2D Filtered wrapped interferogram geocoded in radians |
unwrapped_phase | 2D Filtered unwrapped interferogram geocoded in radians |
amplitude | 2D Amplitude of interferogram in Watt |
The DEM are named to commonly used datasets. The table below shows the common DEM dataset name based. This list should not be considered definitive, and implementors are welcome to use other DEM names.
DEM Name | Description | Spatial Resolution |
---|---|---|
SRTM1 | Shuttle Radar Topography Mission | 1 arcseconds (~30m) |
SRTM3 | Shuttle Radar Topography Mission | 3 arcseconds (~90m) |
SRTM30 | Shuttle Radar Topography Mission | 30 arcseconds (~1km) |
COP-DEM_EEA-10 | Copernicus DEM - European states (EEA39) including all islands of those countries plus French Overseas | 10m |
COP-DEM_GLO30 | Copernicus DEM - Global Coverage | 30m |
COP-DEM_GLO90 | Copernicus DEM - Global Coverage | 90m |
GTOPO30 | USGS Global Terrain Elevation Data (30m) | 30m |
The following types should be used as applicable rel
types in the
Link Object.
Type | Description |
---|---|
reference | This link points to the reference input product STAC Item |
secondary | This link points to the secondary input product STAC Item |
All contributions are subject to the STAC Specification Code of Conduct. For contributions, please follow the STAC specification contributing guide Instructions for running tests are copied here for convenience.
The same checks that run as checks on PR's are part of the repository and can be run locally to verify that changes are valid.
To run tests locally, you'll need npm
, which is a standard part of any node.js installation.
First you'll need to install everything with npm once. Just navigate to the root of this repository and on your command line run:
npm install
Then to check markdown formatting and test the examples against the JSON schema, you can run:
npm test
This will spit out the same texts that you see online, and you can then go and fix your markdown or examples.
If the tests reveal formatting problems with the examples, you can fix them with:
npm run format-examples