Run-info overrides

You can supply Delft-FEWS run information so Coldcast uses FEWS reference times, output directories, and logging settings instead of only the defaults from YAML. Paths may be set on the CLI (see Command-line interface) or in your settings file under keys such as run_info_file and run_info_netcdf.

Many download jobs do not require run info; use these options when you operate inside a FEWS workflow or need a netCDF time0 (or equivalent) to anchor model cycles.

XML run info (--run-info-file)

When run_info_file is set (via settings or CLI), coldcast.run_info.apply_run_info() parses the XML and may set:

  • start_time, end_time

  • work_dir

  • output_dir from destinationDir when present

The namespace defaults to http://www.wldelft.nl/fews/PI; override with fews_name_space in YAML.

NetCDF run info (--run-info-netcdf)

For a FEWS-style runinfo.nc, coldcast.run_info.read_netcdf_reference_time() determines the reference time:

  1. Prefer variable ``time0`` (CF time units).

  2. Else a variable named time, TIME, or Time.

  3. Else the first variable with a datetime64 dtype.

The resulting time feeds coldcast.time_utils reference-time logic used when building download jobs. xarray is required for this path.