STAC Collection¶

CWL example¶

# Copyright 2025 Terradue

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#     http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

cwlVersion: v1.2

class: CommandLineTool

label: "Echo STAC Collection"

baseCommand: echo

requirements:

  - class: InlineJavascriptRequirement

  - class: SchemaDefRequirement

    types:

      - $import: https://raw.githubusercontent.com/eoap/schemas/main/stac.yaml

inputs:

  stac_collection:

    type: https://raw.githubusercontent.com/eoap/schemas/main/stac.yaml#Collection

    label: "STAC Collection"

    doc: "STAC Collection defined in STAC format"

    inputBinding:

      valueFrom: |

${

          // Validate if type is 'Collection'

          if ('Collection' !== inputs.stac_collection.type) {

            throw "Invalid STAC type: expected 'Collection', got '" + inputs.stac_collection.type + "'";

          // get the STAC Collection description

          return "STAC Collection ID: " + inputs.stac_collection.id;

outputs:

  echo_output:

    type: stdout

stdout: echo_output.txt

# Copyright 2025 Terradue

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#     http://www.apache.org/licenses/LICENSE-2.0

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

stac_collection:

  stac_version: "1.0.0"

  type: "Collection"

  id: collection-id

  description: a collection description

  license: 'Creative Commons Attribution-ShareAlike 4.0 International'

  links:

    - rel: "self"

      href: "./item.json"

      type: "application/json"

      title: "This collection"

Run the example with:

cwltool examples/stac/collection.cwl examples/stac/collection.yaml

This produces the output:

INFO /opt/hostedtoolcache/Python/3.12.12/x64/bin/cwltool 3.1.20251031082601

INFO Resolved '../../examples/stac/collection.cwl' to 'file:///home/runner/work/schemas/schemas/examples/stac/collection.cwl'

INFO [job collection.cwl] /tmp/9zhdl3_m$ echo \

    'STAC Collection ID: collection-id' > /tmp/9zhdl3_m/echo_output.txt

INFO [job collection.cwl] completed success

INFO Final process status is success

The content of the echo_output.txt file is:

STAC Collection ID: collection-id