Pattern 12
Application Package Pattern 12¶
This patterns publishes all products generated by all steps
Inputs¶
| Id | Type | Label | Doc |
|---|---|---|---|
aoi |
https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#BBox |
area of interest | area of interest as a bounding box |
bands |
string[] |
bands used for the NDWI | bands used for the NDWI |
item |
Directory |
Landsat-8/9 acquisition reference | Landsat-8/9 acquisition reference |
cropped-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
cropped reflectances STAC Collection | STAC Collection URL for the cropped reflectances |
ndwi-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
NDWI STAC Collection | STAC Collection URL for the NDWI |
water-bodies-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
Water bodies STAC Collection | STAC Collection URL for the water bodies |
Steps¶
| Id | Runs | Label | Doc |
|---|---|---|---|
node_crop |
#crop |
Crop reflectances | Crop the reflectances from the Landsat-8/9 acquisition based on the area of interest and input bands |
node_normalized_difference |
#norm_diff |
Compute NDWI | Compute NDWI from the cropped reflectances |
node_otsu |
#otsu |
Detect water bodies | Detect water bodies based on the otsu threshold from the NDWI |
Outputs¶
| Id | Type | Label | Doc |
|---|---|---|---|
cropped |
Directory[] |
Cropped reflectances | Cropped reflectances |
ndwi |
Directory |
Normalized Difference Water Index | Normalized Difference Water Index calculated from the input bands |
water_bodies |
Directory |
Water bodies detected | Water bodies detected based on the NDWI and otsu threshold |
Data flow management¶
Workflow sequence diagram¶
Inputs¶
| Id | Type | Label | Doc |
|---|---|---|---|
aoi |
https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#BBox |
area of interest - pattern-12/aoi | area of interest as a bounding box - This parameter is derived from pattern-12/aoi |
bands |
string[] |
bands used for the NDWI - pattern-12/bands | bands used for the NDWI - This parameter is derived from pattern-12/bands |
another_input |
string |
Another Input - my-asthonishing-stage-in-directory/another_input | An additional input for demonstration purposes - This parameter is derived from my-asthonishing-stage-in-directory/another_input |
item |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
Landsat-8/9 acquisition reference - pattern-12/item | Landsat-8/9 acquisition reference - This parameter is derived from pattern-12/item |
cropped-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
cropped reflectances STAC Collection - pattern-12/cropped-collection | STAC Collection URL for the cropped reflectances - This parameter is derived from pattern-12/cropped-collection |
ndwi-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
NDWI STAC Collection - pattern-12/ndwi-collection | STAC Collection URL for the NDWI - This parameter is derived from pattern-12/ndwi-collection |
water-bodies-collection |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
Water bodies STAC Collection - pattern-12/water-bodies-collection | STAC Collection URL for the water bodies - This parameter is derived from pattern-12/water-bodies-collection |
s3_bucket |
string |
S3 Bucket name - my-super-stage-out/s3_bucket | The name of the S3 bucket to stage out to - This parameter is derived from my-super-stage-out/s3_bucket |
sub_path |
string |
Sub-path in S3 bucket - my-super-stage-out/sub_path | The sub-path within the S3 bucket to stage out to - This parameter is derived from my-super-stage-out/sub_path |
aws_access_key_id |
string |
AWS Access Key ID - my-super-stage-out/aws_access_key_id | The AWS Access Key ID - This parameter is derived from my-super-stage-out/aws_access_key_id |
aws_secret_access_key |
string |
AWS Secret Access Key - my-super-stage-out/aws_secret_access_key | The AWS Secret Access Key - This parameter is derived from my-super-stage-out/aws_secret_access_key |
region_name |
string |
AWS Region Name - my-super-stage-out/region_name | The AWS Region Name - This parameter is derived from my-super-stage-out/region_name |
endpoint_url |
string |
AWS Endpoint URL - my-super-stage-out/endpoint_url | The AWS Endpoint URL - This parameter is derived from my-super-stage-out/endpoint_url |
Steps¶
| Id | Runs | Label | Doc |
|---|---|---|---|
directory_stage_in_0 |
#my-asthonishing-stage-in-directory |
None | None |
app |
#pattern-12 |
None | None |
stage_out_2 |
#my-super-stage-out |
None | None |
stage_out_0 |
#my-super-stage-out |
None | None |
stage_out_1 |
#my-super-stage-out |
None | None |
Outputs¶
| Id | Type | Label | Doc |
|---|---|---|---|
cropped |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI[] |
Cropped reflectances | Cropped reflectances |
ndwi |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
Normalized Difference Water Index | Normalized Difference Water Index calculated from the input bands |
water_bodies |
https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI |
Water bodies detected | Water bodies detected based on the NDWI and otsu threshold |
Execution¶
Inputs¶
{
"aoi": {
"class": "https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#BBox",
"bbox": [
-118.985,
38.432,
-118.183,
38.938
],
"crs": "CRS84"
},
"item": {
"class": "https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#URI",
"value": "https://planetarycomputer.microsoft.com/api/stac/v1/collections/landsat-c2-l2/items/LC08_L2SP_042033_20231007_02_T1"
},
"bands": [
"green",
"nir08"
],
"cropped-collection": {
"class": "https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#URI",
"value": "https://github.com/eoap/application-package-patterns/raw/refs/heads/develop/collections/cropped_collection.json"
},
"ndwi-collection": {
"class": "https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#URI",
"value": "https://github.com/eoap/application-package-patterns/raw/refs/heads/develop/collections/ndi_collection.json"
},
"water-bodies-collection": {
"class": "https://raw.githubusercontent.com/eoap/schemas/main/ogc.yaml#URI",
"value": "https://github.com/eoap/application-package-patterns/raw/refs/heads/develop/collections/water_bodies_collection.json"
},
"another_input": "some_value",
"s3_bucket": "my-bucket",
"sub_path": "my/sub/path",
"aws_access_key_id": "test",
"aws_secret_access_key": "test",
"region_name": "us-west-1",
"endpoint_url": "https://s3.us-west-1.amazonaws.com"
}
Outputs¶
{
"cropped": [
{
"value": "s3://my-bucket/my/sub/path-i9jnm4/catalog.json",
"type": "https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI"
},
{
"value": "s3://my-bucket/my/sub/path-c3p4uz/catalog.json",
"type": "https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI"
}
],
"ndwi": {
"value": "s3://my-bucket/my/sub/path-edvzic/catalog.json",
"type": "https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI"
},
"water_bodies": {
"value": "s3://my-bucket/my/sub/path-1duem2/catalog.json",
"type": "https://raw.githubusercontent.com/eoap/schemas/main/string_format.yaml#URI"
}
}