Command line interface#

emsarray provides a command line interface allowing users to use some of the more common operations directly from their shell.

When emsarray is installed, the command line interface will be available as emsarray. Run that command to get the full help pages:

$ emsarray --help

Available commands#

Print the installed version of emsarray.

Clip a dataset to a given GeoJSON geometry:

$ emsarray clip "./input-file.nc" "./clip.geojson" "./output-file.nc"

Or clip a dataset to some geographic bounds:

$ emsarray clip "./input-file.nc" "147.08,-43.67,147.30,-43.45" "./output-file.nc"

See emsarray clip --help for a full list of options.

Exports the geometry of a dataset to various formats.

$ emsarray export-geometry gbr4.nc gbr.shp

The output format is guessed based on the extension of the output file, or specified manually using the --format flag.

Extract the data at some points given in a CSV file:

$ emsarray extract-points gbr4.nc gbr4-points.csv gbr4-points.nc

See emsarray extract-points --help for a full list of options.