calc_ofat_ranges

obsidian.campaign.analysis.calc_ofat_ranges(optimizer: Optimizer, threshold: float, X_ref: DataFrame | Series | None = None, PI_range: float = 0.95, steps: int = 100, response_id: int = 0, calc_interacts: bool = True)

Calculates an OFAT design space using confidence bounds around the optimizer prediction. Also includes a matrix of interaction scores.

Parameters:

• optimizer (Optimizer) – The optimizer object which contains a surrogate that has been fit to data and can be used to make predictions.

• X_ref (pd.DataFrame) – The reference data point from which the OFAT variations are calculated.

• threshold (float) – The response value threshold (minimum value) which would be considered passing for OFAT variations.

• PI_range (float, optional) – The prediction interval coverage (fraction of density)

• steps (int, optional) – The number of steps to use in the search for the OFAT boundaries. The default value is 100.

• response_id (int, optional) – The index of the relevant response within the fitted optimizer object. The default value is 0.

• calc_interacts (bool, optional) – Whether or not to return the interaction matrix; default is True.

Returns:

A dataframe describing the min/max OFAT values using each LB, UB, and average prediction.

Values are scaled in the (0,1) space based on optimizer.X_space.

cor (np.array): A matrix of interaction values between every combination of two parameters.

Each value is the fractional reduction in size for the acceptable range envelope created by a 2-factor variation, in comparison to the corresponding two independent 1-factor variations. As such, diagonal elements are 0.

Return type:

ofat_ranges (pd.DataFrame)