CLI Reference

CLI Reference#

Command-line interface documentation.

Commands#

The varunayan command provides three subcommands:

geojson#

Process climate data for regions defined by GeoJSON files.

varunayan geojson [OPTIONS]

Options:

  • --request-id TEXT - Unique identifier for the request [required]

  • --variables TEXT - Comma-separated list of variables [required]

  • --start-date TEXT - Start date (YYYY-MM-DD) [required]

  • --end-date TEXT - End date (YYYY-MM-DD) [required]

  • --json-file PATH - Path to GeoJSON file [required]

  • --dataset-type [single|pressure] - Dataset type [default: single]

  • --pressure-levels TEXT - Comma-separated pressure levels

  • --frequency [hourly|daily|weekly|monthly|yearly] - Data frequency [default: hourly]

  • --resolution FLOAT - Grid resolution in degrees [default: 0.25]

bbox#

Process climate data for rectangular regions.

varunayan bbox [OPTIONS]

Options:

  • --request-id TEXT - Unique identifier for the request [required]

  • --variables TEXT - Comma-separated list of variables [required]

  • --start-date TEXT - Start date (YYYY-MM-DD) [required]

  • --end-date TEXT - End date (YYYY-MM-DD) [required]

  • --north FLOAT - Northern boundary [required]

  • --south FLOAT - Southern boundary [required]

  • --east FLOAT - Eastern boundary [required]

  • --west FLOAT - Western boundary [required]

  • --dataset-type [single|pressure] - Dataset type [default: single]

  • --pressure-levels TEXT - Comma-separated pressure levels

  • --frequency [hourly|daily|weekly|monthly|yearly] - Data frequency [default: hourly]

  • --resolution FLOAT - Grid resolution in degrees [default: 0.25]

point#

Process climate data for specific points.

varunayan point [OPTIONS]

Options:

  • --request-id TEXT - Unique identifier for the request [required]

  • --variables TEXT - Comma-separated list of variables [required]

  • --start-date TEXT - Start date (YYYY-MM-DD) [required]

  • --end-date TEXT - End date (YYYY-MM-DD) [required]

  • --latitude FLOAT - Latitude coordinate [required]

  • --longitude FLOAT - Longitude coordinate [required]

  • --dataset-type [single|pressure] - Dataset type [default: single]

  • --pressure-levels TEXT - Comma-separated pressure levels

  • --frequency [hourly|daily|weekly|monthly|yearly] - Data frequency [default: hourly]

Examples#

Download temperature and precipitation data for India:

varunayan geojson \
    --request-id "india_weather" \
    --variables "2m_temperature,total_precipitation" \
    --start-date "2023-01-01" \
    --end-date "2023-01-31" \
    --json-file "india.geojson" \
    --frequency "daily"

Download pressure-level data for a bounding box:

varunayan bbox \
    --request-id "pressure_data" \
    --variables "temperature,relative_humidity" \
    --start-date "2023-01-01" \
    --end-date "2023-01-31" \
    --north 30.0 --south 20.0 --east 80.0 --west 70.0 \
    --dataset-type "pressure" \
    --pressure-levels "1000,850,500" \
    --frequency "daily"