GitHub

ALCF

Automatic Lidar and Ceilometer
Framework

Command line interface

alcf-model – Extract model data at a point or along a track.

Synopsis

alcf model <type> point: { <lon> <lat> } time: { <start> <end> } [options] [--] <input> <output>

alcf model <type> track: <track> [--] <input> <output>

Description

Arguments following -- are treated as literal strings. Use this delimiter if the input or output file names might otherwise be interpreted as non-strings, e.g. purely numerical file names.

Arguments

  • type: Input data type (see Types below).
  • input: Input directory.
  • output: Output directory.
  • lon: Point longitude.
  • lat: Point latitutde.
  • start: Start time (see Time format below).
  • end: End time (see Time format below).
  • track: Track NetCDF file (see Files below).
  • options: See Options below.

Options

  • njobs: <n>: Number of parallel jobs. Default: number of CPU cores.
  • -r: Process the input directory recursively.
  • --track_lon_180: Expect track longitude between -180 and 180 degrees.
  • track_override_year: <year>: Override year in track. Use if comparing observations with a model statistically. Default: none.

Types

  • amps: Antarctic Mesoscale Prediction System (AMPS).
  • era5: ERA5.
  • icon: ICON.
  • jra55: JRA-55.
  • merra2: Modern-Era Retrospective Analysis for Research and Applications, Version 2 (MERRA-2).
  • nzcsm: New Zealand Convection Scale Model (NZCSM).
  • nzesm: New Zealand Earth System Model (NZESM). [Experimental]
  • um: UK Met Office Unified Model (UM).

Time format

YYYY-MM-DD[THH:MM[:SS]], where YYYY is year, MM is month, DD is day, HH is hour, MM is minute, SS is second. Example: 2000-01-01T00:00:00.

Files

The track file is a NetCDF file containing 1D variables lon, lat, and time. time is time in format conforming with the CF Conventions (has a valid units attribute), lon is longitude between 0 and 360 degrees and lat is latitude between -90 and 90 degrees.

Examples

Extract MERRA-2 model data in M2I3NVASM.5.12.4 at 45 S, 170 E between 1 and 2 January 2020 and store the output in the directory alcf_merra2_model.

alcf model merra2 point: { -45.0 170.0 } time: { 2020-01-01 2020-01-02 } M2I3NVASM.5.12.4 alcf_merra2_model