Adding support for Sentinel-1 SLCs

README.md

@@ -43,6 +43,13 @@ Level-1](https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/resolu
 product. It is used to create STAC Items from the SAFE manifest format of the
 data hosted on Microsoft Azure.
 
+## SLC
+
+The `stactools.sentinel1.slc` subpackage and `stac sentinel1 slc` commands deal
+with [Sentinel 1 Single Look Complex (SLC)
+Level-1](https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/resolutions/level-1-single-look-complex)
+product.
+
 ## Example Outputs
 
 ### RTC
@@ -56,6 +63,11 @@ data hosted on Microsoft Azure.
 - [Item (S1A_EW_GRDM_1SDH_20221130T014342_20221130T014446_046117_058549)](examples/grd/S1A_EW_GRDM_1SDH_20221130T014342_20221130T014446_046117_058549/S1A_EW_GRDM_1SDH_20221130T014342_20221130T014446_046117_058549.json)
 - [Item (S1A_IW_GRDH_1SDV_20210809T173953_20210809T174018_039156_049F13)](examples/grd/S1A_IW_GRDH_1SDV_20210809T173953_20210809T174018_039156_049F13/S1A_IW_GRDH_1SDV_20210809T173953_20210809T174018_039156_049F13.json)
 
+### SLC
+
+- [Collection](examples/slc/collection.json)
+- [Item (S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842)](examples/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842.json)
+
 ## How to use
 
 ### Install package
@@ -90,6 +102,16 @@ stac sentinel1 grd create-item source destination
 
 Use `stac sentinel1 grd --help` to see all subcommands and options.
 
+### SLC usage
+
+Description of the command line functions
+
+```bash
+stac sentinel1 slc create-item source destination
+```
+
+Use `stac sentinel1 slc --help` to see all subcommands and options.
+
 ## Development instructions
 
 ### Set up virtual environment

examples/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842.json

@@ -0,0 +1,274 @@
+{
+  "type": "Feature",
+  "stac_version": "1.0.0",
+  "id": "S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842",
+  "properties": {
+    "sar:frequency_band": "C",
+    "sar:center_frequency": 5.405,
+    "sar:observation_direction": "right",
+    "sar:instrument_mode": "IW",
+    "sar:polarizations": [
+      "HH"
+    ],
+    "sar:product_type": "SLC",
+    "sat:platform_international_designator": "0000-000A",
+    "sat:orbit_state": "descending",
+    "sat:absolute_orbit": 3072,
+    "sat:relative_orbit": 25,
+    "sat:anx_datetime": "2014-10-31T09:29:49.126914Z",
+    "processing:facility": "Sentinel-1 IPF",
+    "processing:level": "L1",
+    "processing:software": {
+      "Sentinel-1 IPF": "002.36"
+    },
+    "proj:epsg": 4326,
+    "proj:bbox": [
+      -53.661625,
+      69.582458,
+      -45.827332,
+      71.715393
+    ],
+    "proj:shape": [
+      21032,
+      14733
+    ],
+    "proj:transform": [
+      0.0005317513744654858,
+      0.0,
+      -53.661625,
+      0.0,
+      -0.00010141379802206178,
+      71.715393
+    ],
+    "proj:centroid": {
+      "lat": 70.65156,
+      "lon": -49.86285
+    },
+    "providers": [
+      {
+        "name": "ESA",
+        "roles": [
+          "producer",
+          "processor",
+          "licensor"
+        ],
+        "url": "https://earth.esa.int/eogateway"
+      }
+    ],
+    "platform": "sentinel-1a",
+    "constellation": "sentinel-1",
+    "start_datetime": "2014-10-31T09:59:31.293840Z",
+    "end_datetime": "2014-10-31T09:59:58.717016Z",
+    "s1:instrument_configuration_ID": "3",
+    "s1:datatake_id": "14402",
+    "s1:product_timeliness": "Fast-24h",
+    "s1:orbit_source": "RESORB",
+    "s1:slice_number": "2",
+    "s1:total_slices": "10",
+    "s1:swaths": [
+      "IW1",
+      "IW2",
+      "IW3"
+    ],
+    "s1:product_identifier": "S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC",
+    "s1:processing_datetime": "2014-10-31T20:34:21.000000Z",
+    "datetime": "2014-10-31T09:59:45.005428Z"
+  },
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -47.241409,
+          69.582458
+        ],
+        [
+          -53.661625,
+          70.092194
+        ],
+        [
+          -52.765385,
+          71.715393
+        ],
+        [
+          -45.827332,
+          71.176399
+        ],
+        [
+          -47.241409,
+          69.582458
+        ]
+      ]
+    ]
+  },
+  "links": [
+    {
+      "rel": "license",
+      "href": "https://scihub.copernicus.eu/twiki/do/view/SciHubWebPortal/TermsConditions",
+      "title": "Sentinel License"
+    },
+    {
+      "rel": "about",
+      "href": "https://sentinels.copernicus.eu/web/sentinel/technical-guides/sentinel-1-sar/products-algorithms/level-1-algorithms/single-look-complex",
+      "title": "Sentinel-1 Single Look Complex (SLC) Technical Guide"
+    },
+    {
+      "rel": "root",
+      "href": "../collection.json",
+      "type": "application/json",
+      "title": "Sentinel-1 SLC"
+    },
+    {
+      "rel": "collection",
+      "href": "../collection.json",
+      "type": "application/json",
+      "title": "Sentinel-1 SLC"
+    },
+    {
+      "rel": "parent",
+      "href": "../collection.json",
+      "type": "application/json",
+      "title": "Sentinel-1 SLC"
+    }
+  ],
+  "assets": {
+    "safe-manifest": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/manifest.safe",
+      "type": "application/xml",
+      "title": "Manifest File",
+      "description": "General product metadata in XML format. Contains a high-level textual description of the product and references to all of product's components, the product metadata, including the product identification and the resource references, and references to the physical location of each component file contained in the product.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-product-iw1-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/s1a-iw1-slc-hh-20141031t095931-20141031t095956-003072-003842-001.xml",
+      "type": "application/xml",
+      "title": "IW1 HH Product Schema",
+      "description": "Describes the main characteristics corresponding to the band: state of the platform during acquisition, image properties, Doppler information, geographic location, etc.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-product-iw2-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/s1a-iw2-slc-hh-20141031t095932-20141031t095957-003072-003842-002.xml",
+      "type": "application/xml",
+      "title": "IW2 HH Product Schema",
+      "description": "Describes the main characteristics corresponding to the band: state of the platform during acquisition, image properties, Doppler information, geographic location, etc.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-product-iw3-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/s1a-iw3-slc-hh-20141031t095933-20141031t095958-003072-003842-003.xml",
+      "type": "application/xml",
+      "title": "IW3 HH Product Schema",
+      "description": "Describes the main characteristics corresponding to the band: state of the platform during acquisition, image properties, Doppler information, geographic location, etc.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-calibration-iw1-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/calibration-s1a-iw1-slc-hh-20141031t095931-20141031t095956-003072-003842-001.xml",
+      "type": "application/xml",
+      "title": "IW1 HH Calibration Schema",
+      "description": "Calibration metadata including calibration information and the beta nought, sigma nought, gamma and digital number look-up tables that can be used for absolute product calibration.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-calibration-iw2-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/calibration-s1a-iw2-slc-hh-20141031t095932-20141031t095957-003072-003842-002.xml",
+      "type": "application/xml",
+      "title": "IW2 HH Calibration Schema",
+      "description": "Calibration metadata including calibration information and the beta nought, sigma nought, gamma and digital number look-up tables that can be used for absolute product calibration.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-calibration-iw3-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/calibration-s1a-iw3-slc-hh-20141031t095933-20141031t095958-003072-003842-003.xml",
+      "type": "application/xml",
+      "title": "IW3 HH Calibration Schema",
+      "description": "Calibration metadata including calibration information and the beta nought, sigma nought, gamma and digital number look-up tables that can be used for absolute product calibration.",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-noise-iw1-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/noise-s1a-iw1-slc-hh-20141031t095931-20141031t095956-003072-003842-001.xml",
+      "type": "application/xml",
+      "title": "IW1 HH Noise Schema",
+      "description": "Estimated thermal noise look-up tables",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-noise-iw2-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/noise-s1a-iw2-slc-hh-20141031t095932-20141031t095957-003072-003842-002.xml",
+      "type": "application/xml",
+      "title": "IW2 HH Noise Schema",
+      "description": "Estimated thermal noise look-up tables",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "schema-noise-iw3-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/annotation/calibration/noise-s1a-iw3-slc-hh-20141031t095933-20141031t095958-003072-003842-003.xml",
+      "type": "application/xml",
+      "title": "IW3 HH Noise Schema",
+      "description": "Estimated thermal noise look-up tables",
+      "roles": [
+        "metadata"
+      ]
+    },
+    "thumbnail": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/preview/quick-look.png",
+      "type": "image/png",
+      "title": "Preview Image",
+      "description": "An averaged, decimated preview image in PNG format. Single polarization products are represented with a grey scale image. Dual polarization products are represented by a single composite colour image in RGB with the red channel (R) representing the  co-polarization VV or HH), the green channel (G) represents the cross-polarization (VH or HV) and the blue channel (B) represents the ratio of the cross an co-polarizations.",
+      "roles": [
+        "thumbnail"
+      ]
+    },
+    "iw3-hh": {
+      "href": "../../../tests/data-files/slc/S1A_IW_SL1__1_SH_20141031T095929_20141031T100002_003072_003842_91FC.SAFE/measurement/s1a-iw3-slc-hh-20141031t095933-20141031t095958-003072-003842-003.tiff",
+      "type": "image/tiff; application=geotiff",
+      "title": "HH Data",
+      "description": "Actual SAR data that have been processed into an image",
+      "eo:bands": [
+        {
+          "name": "HH",
+          "description": "HH band: horizontal transmit and horizontal receive"
+        }
+      ],
+      "sar:polarizations": [
+        "HH"
+      ],
+      "sar:resolution_range": 3.5,
+      "sar:resolution_azimuth": 22.6,
+      "sar:pixel_spacing_range": 2.3,
+      "sar:pixel_spacing_azimuth": 14.1,
+      "sar:looks_range": 1,
+      "sar:looks_azimuth": 1,
+      "sar:looks_equivalent_number": 1,
+      "roles": [
+        "data"
+      ]
+    }
+  },
+  "bbox": [
+    -53.661625,
+    69.582458,
+    -45.827332,
+    71.715393
+  ],
+  "stac_extensions": [
+    "https://stac-extensions.github.io/sar/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/sat/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/processing/v1.1.0/schema.json",
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "collection": "sentinel1-slc"
+}