compass.landice.tests.ismip7_calibration.objective.build_toolbox_terms

compass.landice.tests.ismip7_calibration.objective.build_toolbox_terms(units, targets, param_values, t3_models=None, t4_regions=None, t4_years=None)[source]

Assemble the arguments calculate_objective_function expects.

Parameters:

  • units (dict) – Unit-parameter aggregates t1, t2, t3 and t4, as produced by compass.landice.tests.ismip7_calibration.terms

  • targets (dict) – Observational targets, from compass.landice.tests.ismip7_calibration.datasets.load_targets()

  • param_values (numpy.ndarray) – The parameter grid

  • t3_models (sequence of str, optional) – Ocean models to give non-zero weight in J3. None weights every model the ensemble provides.

  • t4_regions (sequence of str, optional) –

    Ice shelves to give non-zero weight in J4, from 'pig' and 'dotson'. None weights both.

    The published weighting uses PIG alone, which is 2 of the 18 available observations. As weighted that way, J4 constrains a single amplitude that either melt form can match by rescaling its parameter, so it cannot discriminate between forms; including Dotson makes it a relative constraint between two shelves, which it can.

  • t4_years (sequence of int, optional) – Observation years to give non-zero weight in J4. None weights every year the ensemble provides.

Returns:

terms (dict) – Keyword arguments for toolbox.calculate_objective_function