Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

noise_equivalent_intensity & minor adjustments #19

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

noise_equivalent_intensity & minor adjustments #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f5fd5e8
[SAR] `card4l:noise_equivalent_intensity` clarify description and adj…
maawoo Jan 28, 2022
86c688f
[SAR] minor adjustments
maawoo Jan 28, 2022
e28f161
Merge branch 'stac-extensions:main' into main
maawoo Jan 28, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions sar/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -126,7 +126,7 @@ only additional requirements and mappings to fulfill the CARD4L requirements are
| card4l:incidence_angle_far_range | ✓ 1.6.7 | ✗ | `IncAngleFarRange` | number | **REQUIRED.** In degrees. |
| card4l:resolution_azimuth | ✓ 1.6.7 | ✗ | `AzimuthResolution` | Map\<string, number> | **REQUIRED.** The azimuth resolution per beam, in meters (m). The beam ID is the object key and the value is the resolution. See also `sar:resolution_azimuth`. |
| card4l:resolution_range | ✓ 1.6.7 | ✗ | `RangeResolution` | Map\<string, number> | **REQUIRED.** The range resolution per beam, in meters (m). The beam ID is the object key and the value is the resolution. See also `sar:resolution_range`. |
| card4l:noise_equivalent_intensity | ✓ 1.6.9 | ✗ | `Estimates` in `NoiseEquivalentIntensity` | [Statistics Object](#statistics-object) | **REQUIRED.** Fill the object with statistics that are available for the source data, e.g. min, max and mean. Convert each to decibel, if required. |
| card4l:noise_equivalent_intensity | ✓ 1.6.9 | ✗ | `Estimates` in `NoiseEquivalentIntensity` | [Statistics Object](#statistics-object) | **REQUIRED.** Fill the object with statistics on data intensity noise level (noise equivalent sigma and/or beta and/or gamma naught) of the source data, e.g. min, max and mean. Provide for each polarization channel if available and convert to decibel, if required. |
| card4l:noise_equivalent_intensity_type | ✓ 1.6.9 | ✗ | `NoiseEquivalentIntensity`, attribute `type` | string | **REQUIRED.** One of `beta0`, `sigma0`, or `gamma0`. |
| card4l:peak_sidelobe_ratio | ✓ 1.6.9 | ✗ | `PeakSideLobeRatio` | number | Peak sidelobe ratio (PSLR) in decibel. |
| card4l:integrated_sidelobe_ratio | ✓ 1.6.9 | ✗ | `IntegratedSideLobeRatio` | number | Integrated sidelobe ratio (ISLR) in decibel. |
Expand Down Expand Up @@ -238,7 +238,7 @@ None of the fields is required.
| proj:epsg | (✓) | ✓ 1.7.9 | `CoordinateReferenceSystem` | **REQUIRED for *Prod*.** EPSG code as integer or `null` if there is no suitable EPSG code. |
| proj:wkt2 / proj:projjson | (✓) | ✓ 1.7.9 | `CoordinateReferenceSystem` | **REQUIRED for *Prod*.** Either WKT2 or PROJJSON needs to be given in addition to the EPSG code. It is also allowed to give both. |
| proj:bbox | (✓) | ✓ 1.7.5 | `ProductBoundingBox` | **REQUIRED for *Prod* if the native CRS is not WGS84.** This is the bounding box in the native CRS of the product. Can be omitted if the native CRS is WGS84. |
| proj:shape | ✗ | ✓ 1.7.7 | `NumberLines`, `NumberPixelsPerLine` | **REQUIRED for *Prod*.** Number of pixels in Y and X directions for the default grid. See comment below**. |
| proj:shape | ✗ | ✓ 1.7.7 | `NumberLines`, `NumberPixelsPerLine` | **REQUIRED for *Prod*.** Number of pixels in Y and X directions for the default grid. See comment below \[2]. |
| proj:transform | ✗ | (✓) | *n/a* | Recommended to include the affine transformation coefficients for the default grid. See comment below \[2]. |

\[2] Values are assumed to apply to all Assets of an Item. If this is not the case, these fields should be specified at the [Item Asset level](#stac-item-assets) instead.
Expand Down Expand Up @@ -349,7 +349,7 @@ For those details please refer to the ["Additional properties" column in the tab
| card4l:ellipsoidal_height | ✗ | ✓ | `EllipsoidalHeight` | number | Indicate which ellipsoidal (mean) height was used, in meters. |
| card4l:border_pixels | ✗ | ✓ 1.7.7 | `NumBorderPixels` | integer | Number of border pixels (**required** only if applicable). |
| proj:shape | ✗ | ✓ 1.7.7 | `NumberLines`, `NumberPixelsPerLine` | \[integer] | The shape of the asset. See comment below \[3]. |
| proj:transform | ✗ | (✓) | *n/a* | \[number] | The affine transformation coefficients for the default grid. See comment below*. |
| proj:transform | ✗ | (✓) | *n/a* | \[number] | The affine transformation coefficients for the default grid. See comment below \[3]. |

\[3] `proj:shape` and `proj:transform` only need to be specified at the Item Asset level if the values vary between
Assets. Specify in Item properties otherwise. See also comment in [Projection](#Projection).
Expand Down
12 changes: 9 additions & 3 deletions sar/examples/S1A_IW_GRDH_1SDV_20210108T021904_20210108T021929_036040_04392F_3709.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -142,8 +142,14 @@
"card4l:incidence_angle_near_range": 30.3152831649154,
"card4l:incidence_angle_far_range": 45.97317397183082,
"card4l:noise_equivalent_intensity": {
"minimum": -30,
"maximum": -22
"VH": {
"minimum": -30,
"maximum": -22
},
"VV": {
"minimum": -30,
"maximum": -22
}
},
"card4l:noise_equivalent_intensity_type": "sigma0",
"datetime": "2021-01-08T02:19:04.286944Z",
Expand Down Expand Up @@ -192,7 +198,7 @@
},
{
"href": "s3://sentinel-s1-l1c/GRD/2021/1/8/IW/DV/S1A_OPER_AUX_RESORB_OPOD_20210108T062130_V20210108T012450_20210108T044220.EOF",
"rel": "orbit-data-file",
"rel": "state-vectors",
"title": "Orbit Data File with state vectors"
},
{
Expand Down
12 changes: 9 additions & 3 deletions sar/examples/S1A_IW_GRDH_1SDV_20210108T021929_20210108T021954_036040_04392F_EF8A.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -142,8 +142,14 @@
"card4l:incidence_angle_near_range": 30.22052269653568,
"card4l:incidence_angle_far_range": 45.9873797960658,
"card4l:noise_equivalent_intensity": {
"minimum": -30,
"maximum": -22
"VH": {
"minimum": -30,
"maximum": -22
},
"VV": {
"minimum": -30,
"maximum": -22
}
},
"card4l:noise_equivalent_intensity_type": "sigma0",
"datetime": "2021-01-08T02:19:29.286300Z",
Expand Down Expand Up @@ -192,7 +198,7 @@
},
{
"href": "s3://sentinel-s1-l1c/GRD/2021/1/8/IW/DV/S1A_OPER_AUX_RESORB_OPOD_20210108T062130_V20210108T012450_20210108T044220.EOF",
"rel": "orbit-data-file",
"rel": "state-vectors",
"title": "Orbit Data File with state vectors"
},
{
Expand Down