diff --git a/.github/workflows/build-pipeline.yml b/.github/workflows/build-pipeline.yml index 8db776f..32218e0 100644 --- a/.github/workflows/build-pipeline.yml +++ b/.github/workflows/build-pipeline.yml @@ -5,7 +5,7 @@ name: Build on: # Triggers the workflow on push events push: - branches: [ develop, release/**, main, feature/**, issue/**, issues/** ] + branches: [ develop, release/**, main, feature/**, issue/**, issues/** , docs/**] # Allows you to run this workflow manually from the Actions tab workflow_dispatch: @@ -51,7 +51,8 @@ jobs: if: | ${{ startsWith(github.ref, 'refs/heads/issue') }} || ${{ startsWith(github.ref, 'refs/heads/dependabot/') }} || - ${{ startsWith(github.ref, 'refs/heads/feature/') }} + ${{ startsWith(github.ref, 'refs/heads/feature/') }} || + ${{ startsWith(github.ref, 'refs/heads/docs/') }} run: | new_ver="${{ steps.get-version.outputs.current_version }}+$(git rev-parse --short ${GITHUB_SHA})" poetry version $new_ver diff --git a/CHANGELOG.md b/CHANGELOG.md index 826a866..976e0da 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - [Issue #185](https://github.com/nasa/stitchee/issues/185): Added arguments for temporary file copies and overwriting output file in main stitchee function - [Issue #181](https://github.com/nasa/stitchee/issues/181): Add a group delimiter argument - [Issue #134](https://github.com/nasa/stitchee/issues/134): Add an integration test that runs stitchee on files first subsetted by the operational Harmony subsetter +- [Issue #194](https://github.com/nasa/stitchee/issues/194): Add page about the SAMBAH service chain to the Readthedocs documentation ### Changed ### Deprecated ### Removed diff --git a/docs/sambah_readme.md b/docs/sambah_readme.md new file mode 100644 index 0000000..267983b --- /dev/null +++ b/docs/sambah_readme.md @@ -0,0 +1,27 @@ +# SAMBAH + +The Subsetter And Multi-dimensional Batched Aggregation in Harmony (SAMBAH) chain +executes several services: + +1. **CMR Query**: Retrieves information from the Common Metadata Repository (CMR) ([source](https://github.com/nasa/harmony/tree/main/services/query-cmr)) +2. **PODAAC L2-Subsetter** (optional): Performs subsetting on level-2 data granules ([source](https://github.com/podaac/l2ss-py)) +3. **Batchee** (optional): Groups together filenames so that further operations (such as concatenation) can be performed separately on each group of files ([source](https://github.com/nasa/batchee)) +4. **Stitchee** (optional): Concatenates netCDF data along an existing dimension ([source](https://github.com/nasa/stitchee)) +5. **PODAAC CONCISE** (optional): Concatenates netCDF data along a newly created dimension ([source](https://github.com/podaac/concise)) + +## Known Limitations + +- Panoply is unable to plot results when coordinate arrays contain null values on the edges. +- Polygons and other Shapefile formats are not supported for subsetting. Support for this is in development. +- A request for a single granule proceeds through the entire chain. Thus, the following modifications are made even though the data are not concatenated: (i) the filename is changed to the granule's collection ID + "_merged" and (ii) a history attribute is added. + +## Missions supported + +The SAMBAH service chain is currently configured to work only with data collections +from the Tropospheric Emissions: Monitoring of Pollution (TEMPO) mission. + +## References + +- Service (UMM-S) record ID in CMR: [S2940253910-LARC_CLOUD](https://cmr.earthdata.nasa.gov/search/services.umm_json?concept_id=S2940253910-LARC_CLOUD) +- Service versions in Harmony Production: +- Harmony API - Service Capabilities: diff --git a/mkdocs.yml b/mkdocs.yml index 8e65e07..4af2998 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -22,6 +22,8 @@ theme: nav: - OVERVIEW: - "Readme": "index.md" + - SAMBAH Service Chain: + - "Description and known limitations": "sambah_readme.md" - EXAMPLES: - "Usage of STITCHEE via Harmony": "tutorial_examples.ipynb"