You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* update field names
* update scale and offset examples and fix KaTeX formulas
* updated CHANGELOG
* update items using bands instead of raster:bands
* update CHANGELOG
* updaed schema to use STAC 1.1 bands
* Revert "update scale and offset examples and fix KaTeX formulas"
This reverts commit 24c3e48.
* Fix examples and schema
* Simplify examples
* Update README and Changelog
* Update version number of eo extension
---------
Co-authored-by: Matthias Mohr <[email protected]>
| raster:bands|\[[Raster band Object](#raster-band-object)]| An array of available bands where each object is a \[[Band Object](#raster-band-object)]. If given, requires at least one band. |
26
+
The fields in the table below can be used in these parts of STAC documents:
29
27
30
-
## Raster Band Object
28
+
-[ ] Catalogs
29
+
-[ ] Collections
30
+
-[x] Item Properties (incl. Summaries in Collections)
31
+
-[x] Assets (for both Collections and Items, incl. Item Asset Definitions in Collections)
32
+
-[x] Bands
33
+
-[ ] Links
31
34
32
-
When specifying a raster band object at asset level, it is recommended to use
35
+
When using the raster extension, it is recommended to use
33
36
the [projection](https://github.com/radiantearth/stac-spec/tree/master/extensions/projection) extension
34
37
to specify information about the raster projection, especially `proj:shape` to specify the height and width of the raster.
| nodata | number\|string | Pixel values used to identify pixels that are nodata in the band either by the pixel value as a number or `nan`, `inf` or `-inf` (all strings). |
39
-
| sampling | string | One of `area` or `point`. Indicates whether a pixel value should be assumed to represent a sampling over the region of the pixel or a point sample at the center of the pixel. |
40
-
| data_type | string | The data type of the pixels in the band. One of the [data types as described below](#data-types). |
41
-
| bits_per_sample | number | The actual number of bits used for this band. Normally only present when the number of bits is non-standard for the `datatype`, such as when a 1 bit TIFF is represented as byte. |
42
-
| spatial_resolution | number | Average spatial resolution (in meters) of the pixels in the band. |
43
-
| statistics |[Statistics Object](#statistics-object)| Statistics of all the pixels in the band. |
44
-
| unit | string | Unit denomination of the pixel value. |
45
-
| scale | number | Multiplicator factor of the pixel value to transform into the value (i.e. translate digital number to reflectance). |
46
-
| offset | number | Number to be added to the pixel value (after scaling) to transform into the value (i.e. translate digital number to reflectance). |
47
-
| histogram |[Histogram Object](#histogram-object)| Histogram distribution information of the pixels values in the band. |
48
-
49
-
`scale` and `offset` define parameters to compute another value. The following paragraphs describe some use cases.
50
-
51
-
### Data Types
52
-
53
-
The data type gives information about the values in the file.
54
-
This can be used to indicate the (maximum) range of numerical values expected.
55
-
For example `uint8` indicates that the numbers are in a range between 0 and 255,
56
-
they can never be smaller or larger. This can help to pick the optimal numerical
57
-
data type when reading the files to keep memory consumption low.
58
-
Nevertheless, it doesn't necessarily mean that the expected values fill the whole range.
59
-
For example, there can be use cases for `uint8` that just use the numbers 0 to 10 for example.
60
-
Through other extensions it might be possible to specify an exact value range so
61
-
that visualizations can be optimized.
62
-
The allowed values for `data_type` are:
63
-
64
-
-`int8`: 8-bit integer
65
-
-`int16`: 16-bit integer
66
-
-`int32`: 32-bit integer
67
-
-`int64`: 64-bit integer
68
-
-`uint8`: unsigned 8-bit integer (common for 8-bit RGB PNG's)
69
-
-`uint16`: unsigned 16-bit integer
70
-
-`uint32`: unsigned 32-bit integer
71
-
-`uint64`: unsigned 64-bit integer
72
-
-`float16`: 16-bit float
73
-
-`float32`: 32-bit float
74
-
-`float64`: 64-big float
75
-
-`cint16`: 16-bit complex integer
76
-
-`cint32`: 32-bit complex integer
77
-
-`cfloat32`: 32-bit complex float
78
-
-`cfloat64`: 64-bit complex float
79
-
-`other`: Other data type than the ones listed above (e.g. boolean, string, higher precision numbers)
| mean | number | mean value of all the pixels in the band |
86
-
| minimum | number | minimum value of the pixels in the band |
87
-
| maximum | number | maximum value of the pixels in the band |
88
-
| stddev | number | standard deviation value of the pixels in the band |
89
-
| valid_percent | number | percentage of valid (not `nodata`) pixel |
41
+
| raster:sampling| string | One of `area` or `point`. Indicates whether a pixel value should be assumed to represent a sampling over the region of the pixel or a point sample at the center of the pixel. |
42
+
| raster:bits_per_sample| number | The actual number of bits used for this band. Normally only present when the number of bits is non-standard for the `datatype`, such as when a 1 bit TIFF is represented as byte. |
43
+
| raster:spatial_resolution| number | Average spatial resolution (in meters) of the pixels in the band. |
44
+
| raster:scale| number | Multiplicator factor of the pixel value to transform into the value (i.e. translate digital number to reflectance). |
45
+
| raster:offset| number | Number to be added to the pixel value (after scaling) to transform into the value (i.e. translate digital number to reflectance). |
46
+
| raster:histogram|[Histogram Object](#histogram-object)| Histogram distribution information of the pixels values in the band. |
47
+
48
+
`raster:scale` and `raster:offset` define parameters to compute another value. The following paragraphs describe some use cases.
90
49
91
50
### Scale and Offset Uses and Examples
92
51
@@ -133,11 +92,11 @@ For example, the above value conversion is described in the values dictionary as
133
92
"assets": {
134
93
"B4": {
135
94
"title": "TOA radiance band 4",
136
-
"raster:bands": [{
95
+
"bands": [{
137
96
"nodata": 0,
138
97
"unit": "W⋅sr−1⋅m−2",
139
-
"scale": 0.0145,
140
-
"offset": 3.48
98
+
"raster:scale": 0.0145,
99
+
"raster:offset": 3.48
141
100
}]
142
101
}
143
102
}
@@ -172,9 +131,9 @@ In the following value definition example, 185 meters must be substracted from t
0 commit comments