https://github.com/nasa/stitchee
NASA Harmony service that concatenates netCDF4 data files along an existing dimension
https://github.com/nasa/stitchee
asdc concatenation data-combination netcdf
Last synced: 5 months ago
JSON representation
NASA Harmony service that concatenates netCDF4 data files along an existing dimension
- Host: GitHub
- URL: https://github.com/nasa/stitchee
- Owner: nasa
- License: apache-2.0
- Created: 2023-08-18T20:22:29.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-05T21:39:38.000Z (5 months ago)
- Last Synced: 2026-01-10T19:03:01.577Z (5 months ago)
- Topics: asdc, concatenation, data-combination, netcdf
- Language: Python
- Homepage: https://stitchee.readthedocs.io/
- Size: 18.8 MB
- Stars: 8
- Watchers: 7
- Forks: 5
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[//]: # (Using deprecated `align="center"` for the logo image and badges above, because of https://stackoverflow.com/a/62383408)
# Overview
_____
_STITCHEE_ (STITCH by Extending a dimEnsion) is used for concatenating netCDF data *along an existing dimension*,
and it is designed as both a standalone utility and for use as a service in [Harmony](https://harmony.earthdata.nasa.gov/).
## Getting started, with poetry
1. Follow the instructions for installing `poetry` [here](https://python-poetry.org/docs/).
2. Install `stitchee`, with its dependencies, by running the following from the repository directory:
```shell
poetry install
```
## How to test `stitchee` locally
```shell
poetry run pytest tests/
```
## Usage
For example:
```shell
poetry run stitchee /path/to/files/directory -o output.nc --concat_method xarray-combine
```
Command line options:
```shell
$ poetry run stitchee --help
usage: stitchee [-h] -o PATH [--concat_method {xarray-concat,xarray-combine}] [--concat_dim DIM] [--sorting_variable VAR] [--xarray_arg_compat COMPAT]
[--xarray_arg_combine_attrs ATTRS] [--xarray_arg_join JOIN] [-O] [-v]
INPUT [INPUT ...]
Concatenate netCDF files along existing dimensions.
options:
-h, --help show this help message and exit
-O, --overwrite Overwrite output file if it exists
-v, --verbose Enable verbose output to stdout; useful for debugging
Required Arguments:
INPUT Input specification: multiple file paths, directory path, text file with file list, or single file to copy
-o PATH, --output_path PATH
Output file path for concatenated result
Concatenation Options:
--concat_method {xarray-concat,xarray-combine}
Concatenation method (default: xarray-concat)
--concat_dim DIM Dimension to concatenate along (required for xarray-concat)
--sorting_variable VAR
Name of a variable to use for sorting datasets before concatenation (e.g., 'time')
xarray Arguments:
--xarray_arg_compat COMPAT
'compat' argument passed to xarray concatenation function
--xarray_arg_combine_attrs ATTRS
'combine_attrs' argument passed to xarray concatenation function
--xarray_arg_join JOIN
'join' argument passed to xarray concatenation function
Examples:
stitchee file1.nc file2.nc -o output.nc --concat_dim time
stitchee /path/to/files/directory -o output.nc --concat_method xarray-combine
stitchee filelist.txt -o output.nc --concat_dim time --sorting_variable time
```
---
This package is NASA Software Release Authorization (SRA) # LAR-20433-1