Application Programming Interface (API) Reference

Full program as executed from CLI

main()

Perform end-to-end co-location of model data onto observations.

Core functions

Data input and compliance

get_files_to_individually_colocate(path[, ...])

Return list of files to read with cf.read from a path name/pattern.

read_obs_input_data(obs_data_path)

Read in all observational input data.

read_model_input_data(model_data_path)

Read in all model input data.

get_input_fields_of_interest(fl, chosen_field)

Return the field(s) of interest from the input dataset.

vertical_parametric_computation(model_field, ...)

Return a model field with arbitrary computed vertical coordinates.

vertical_parametric_computation_ahhc(...)

Return a model field with computed vertical coordinate of altitude.

vertical_parametric_computation_ahspc(...)

Return a model field with computed 'air_pressure' vertical coordinate.

ensure_cf_compliance(fieldlist, plugin[, ...])

Ensure the chosen field is CF compliant with the correct format.

check_time_coverage(obs_times, model_times)

Ensure observational data datetime range lies inside that of the model.

ensure_unit_calendar_consistency(obs_field, ...)

Ensure the chosen fields have consistent units and calendars.

set_start_datetime(obs_times, ...)

Replace observational time data with those starting from a new value.

get_time_coords(obs_field, model_field[, ...])

Return the relevant time coordinates from the fields.

Co-location and bounding

colocate(model_field, obs_field, halo_size, ...)

Co-locate a model field's data onto an observational field's domain.

colocate_single_file(file_to_colocate, ...)

Perform model-to-observational colocation using a single file source.

bounding_box_query(model_field, model_id, ...)

Apply a custom query to get the bounding box.

subspace_to_spatiotemporal_bounding_box(...)

Extract only relevant data in the model field via a 4D subspace.

spatial_interpolation(obs_field, ...[, ...])

Interpolate the flight path spatially (3D for X-Y and vertical Z).

time_subspace_per_segment(index, ...)

Return the calculation-appropriate weighting for a given time segment.

time_interpolation(obs_times, model_times, ...)

Interpolate the flight path temporally (in time T).

Data output

create_contiguous_ragged_array_output(...)

Create a compressed contiguous ragged array DSG output.

write_output_data(final_result_field, ...)

Write out the 4D (X-Y-Z-T) colocated result as output data.

Helper

logger

Instances of the Logger class represent a single logging channel.

timeit(func)

A decorator to measure and report function execution time.

get_env_and_diagnostics_report()

Provide an optional report of environment and diagnostics.

Performance

persist_all_metadata(field)

Persist all of the metadata for a field.

Custom exceptions

CFComplianceIssue

Raised for cases of errors caused by lack of CF Compliance.

IncompatibleDataInputsIssue

Raised for cases of incompatibility between the Model and Obs inputs.

DataReadingIssue

Raised for cases of failure to read appropriate data input file(s).

ConfigurationIssue

Raised for cases of configuration values being invalid or unsuitable.

InternalsIssue

Raised for cases of the toolkit behaviour emerging wrong.

Plotting

plotting.preview_plots(obs_field, plot_mode, ...)

Generate plots of the flight track for a pre-colocation preview.

plotting.output_plots(output, ...)

Generate a post-colocation result plot of the track(s) or swath(s).

make_preview_plots(obs_field, plot_mode, ...)

Generate plots of the flight track for a pre-colocation preview.

make_output_plots(output, ...[, ...])

Generate a post-colocation result plot of the track(s) or swath(s).

Command-line parsing

cli.setup_logging(verbosity)

Configure the package log level assuming CLI counted -v flag input.

cli.process_cli_arguments(parser)

Parse and process all command-line arguments.

cli.process_config()

Process all configuration, from CLI, file or a default if neither set.

cli.validate_config(final_config_namespace)

Perform validations on the configuration input by the user.

cli.process_config_file(config_file)

Process a configuration file.

Default values

constants.CONFIG_DEFAULTS

Configuration default values, applied if the user does not set otherwise.

Plugins

For Satellite observational data

satellite_plugin(fieldlist, chosen_field[, ...])

Pre-processing of a field from a satellite swath.

plugins.satellite_compliance_converter.satellite_compliance_plugin(...)

The converter.

For WRF Data

plugins.wrf_data_compliance_fixes.wrf_extra_compliance_fixes(...)

Extra CF compliance fixes for WRF data.

plugins.wrf_data_compliance_fixes.wrf_further_compliance_fixes(...)

More CF compliance fixes for WRF data.