Learn R Programming

PEAXAI (version 0.1.0)

find_beta_maxmin: Search Range for Directional Efficiency Parameter (\(\beta\))

Description

Estimates, for each observation, the minimum and maximum feasible values of the directional distance parameter \(\beta\) used in projection-based efficiency analysis. This function is an internal step of PEAXAI_targets, providing the initial search bounds for the iterative determination of efficiency targets.

Usage

find_beta_maxmin(
  data,
  x,
  y,
  final_model,
  efficiency_thresholds,
  n_expand,
  vector_gx,
  vector_gy,
  max_y,
  min_x
)

Value

A data.frame with two numeric columns:

min

Minimum feasible value of \(\beta\) for each observation.

max

Maximum feasible value of \(\beta\) for each observation.

Arguments

data

A data.frame or matrix containing input and output variables.

x

A numeric vector with the column indexes of input variables in data.

y

A numeric vector with the column indexes of output variables in data.

final_model

A fitted caret model of class "train" that supports predict(type = "prob") and returns a probability column for the efficient class.

efficiency_thresholds

A numeric vector of probability levels in (0,1). Its minimum and maximum values delimit the target interval used to bracket \(\beta\).

n_expand

Integer. Increment step size applied to \(\beta\) at each iteration.

vector_gx

A numeric vector or data.frame with directional changes for inputs (typically negative direction), usually built inside PEAXAI_targets.

vector_gy

A numeric vector or data.frame with directional changes for outputs (positive direction).

max_y

Numeric. Upper-limit multiplier for output expansion relative to observed maxima.

min_x

Numeric. Lower-limit multiplier for input contraction relative to observed minima.

Details

For each DMU, the function expands outputs and contracts inputs along the specified direction until the predicted probability of efficiency (from final_model) reaches the maximum in efficiency_thresholds or feasible domain limits. The resulting interval \([\beta_{\min}, \beta_{\max}]\) is then used by PEAXAI_targets to refine projections via grid search.

See Also

PEAXAI_targets (efficiency projections based on \(\beta\)); train (model training with class probabilities).