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