CLI Cheatsheet

Quick commands for common tasks. Many subcommands support - for stdin/stdout to enable piping.

Import

• HTTP → file: zyra acquire http https://example.com/data.bin -o data.bin

• S3 list: zyra acquire s3 --url s3://bucket/prefix/ --list --pattern "\\.grib2$"

• FTP sync: zyra acquire ftp ftp://host/path --sync-dir ./frames --pattern "image_(\\d{8})\\.png" --since 2024-08-01 --date-format %Y%m%d

Search

• SOS profile: zyra search --query "tsunami" --profile sos

• OGC WMS: zyra search --query "Temperature" --ogc-wms "https://...GetCapabilities"

• Include local + enrich: zyra search --query "sst" --ogc-wms <url> --include-local --enrich shallow

Process

• GRIB2 → NetCDF: zyra process convert-format file.grib2 netcdf --stdout > out.nc

• Decode GRIB2 subset: zyra process decode-grib2 s3://bucket/file.grib2 --pattern ":TMP:surface:" --raw > subset.grib2

• Extract variable: zyra process extract-variable demo.nc T2M --stdout | zyra process convert-format - netcdf --stdout > t2m.nc

Visualize

• Heatmap: zyra visualize heatmap --input out.nc --var T2M --output heatmap.png

• Contour: zyra visualize contour --input out.nc --var T2M --levels 5,10,15 --filled --output contour.png

• Animate frames: zyra visualize animate --frames ./frames --output frames

• Compose MP4: zyra visualize compose-video --frames ./frames --output movie.mp4

Export

• Local (stdin → file): cat out.nc | zyra export local - -o saved.nc

• S3 (stdin → object): cat out.nc | zyra export s3 --url s3://bucket/out.nc -i -

• HTTP POST JSON: echo '{\"ok\":true}' | zyra export post - https://example.com/ingest --content-type application/json

Piping Patterns

• List → fetch → convert → save:

  • zyra acquire s3 --url s3://bucket/prefix/ --list ... (pick one)

  • zyra acquire s3 --url s3://bucket/file.grib2 -o - | zyra process convert-format - netcdf --stdout > out.nc

Tips

• Use - for stdin/stdout and --stdout to force stdout where supported.

• Prefer primary stage names (import/process/visualize/export); legacy decimate remains as alias for export.

• Install extras as needed (see Install-Extras.md).