MATLAB utilities for Sentinel-1 Level 1 datasets
================================================
This repository contains several MATLAB functions to read and prepare/process Sentinel-1 Level 1 datasets.
These functions were developed primarily to work with single-look complex (SLC) images acquired in TOPS mode, i.e. Sentinel-1's Interferometric Wide Swath (IW) or Extra Wide Swath (EW) modes. Expected compatibility with the StripMap (SM) and Wave (WV) modes, and with ground-range detected (GRD) images, is indicated for each function.
## List of functions
__NOTE:__ These functions may not work with MATLAB versions older than R2016b.
The `USAGE` file provides indications on how to use some functions.
+ `parseSafeManifest`: Extract useful information from the `manifest.safe` file of a Sentinel-1 dataset. This function should work with any Sentinel-1 Level 1 dataset.
+ `readSent1Data`: Read data in a Sentinel-1 measurement TIFF file. This function should work with any Sentinel-1 Level 1 image.
+ `applySent1Lut`: Apply a calibration LUT to a Sentinel-1 SLC image. This function should be compatible with SLC images in all modes. It has not been tested with GRD images.
+ `private/getTIFFinfo`: Extract useful parameters from a TIFF file, e.g. information used to read it, and perform basic checks. This function should work with any Sentinel-1 measurement TIFF file, but also for RADARSAT-2 images in the BigTIFF format.
Additional functions in the `dev` branch (under development or not fully tested):
+ `mergeSent1TopsBursts`: Stitch (merge) bursts in a TOPS subswath. Applicable only to IW and EW SLC images.
+ `topsDeramping`: Deramp TOPS data in azimuth. Applicable only to IW and EW SLC images.
Some of these functions use the [`xmlExtract` utility](https://github.com/lprouss/xmlExtract), which provides an (arguably) easier way to extract data from XML files, like Sentinel-1's annotation files. This function, as well as its associated sub-functions, should thus be present in MATLAB's search path.
该存储库包含几个MATLAB函数,用于读取和准备/处理Sentinel-1 Level 1数据集。
开发这些功能主要是为了与以TOPS模式(即Sentinel-1的干涉宽幅(IW)或超宽幅(EW)模式)获取的单视复杂(SLC)图像一起使用。每个功能均指示与StripMap(SM)和Wave(WV)模式以及与地面检测(GRD)图像的预期兼容性。
##功能列表
__注意:__这些函数可能不适用于低于R2016b的MATLAB版本。
“使用”文件提供了有关如何使用某些功能的指示。
+`parseSafeManifest`:从Sentinel-1数据集的`manifest.safe`文件中提取有用的信息。此功能应与任何Sentinel-1 Level 1数据集一起使用。
+`readSent1Data`:读取Sentinel-1测量TIFF文件中的数据。此功能应适用于任何Sentinel-1 Level 1图像。
+`applySent1Lut`:将校准LUT应用于Sentinel-1 SLC图像。在所有模式下,此功能均应与SLC图像兼容。尚未使用GRD图像进行测试。
+`private / getTIFFinfo`:从TIFF文件中提取有用的参数,例如用于阅读和执行基本检查的信息。此功能应适用于任何Sentinel-1测量TIFF文件,但也适用于BigTIFF格式的RADARSAT-2图像。
`dev`分支中的其他功能(正在开发中或未经过全面测试):
+`mergeSent1TopsBursts`:缝合(合并)在TOPS分支中爆发。仅适用于IW和EW SLC图像。
+`topsDeramping`:以方位角表示Deramp TOPS数据。仅适用于IW和EW SLC图像。
其中一些功能使用[`xmlExtract`实用程序](https://github.com/lprouss/xmlExtract),它提供了一种从Sentinel-1注释文件中提取XML文件中的数据的方法(可以说是更简单)。因此,该函数及其关联的子函数应该出现在MATLAB的搜索路径中。