voiage.methods.capacity_budget_constrained.value_of_capacity_budget_constrained

value_of_capacity_budget_constrained

value_of_capacity_budget_constrained([positional or keyword] scenario_values: np.ndarray | list[list[float]] = None, [keyword-only] strategy_costs: list[float] | np.ndarray = None, [keyword-only] strategy_capacity: list[float] | np.ndarray = None, [keyword-only] budget: float = None, [keyword-only] capacity: float = None, [keyword-only] strategy_names: list[str] | None = None, [keyword-only] information_cost: float = 0.0) -> CapacityBudgetConstrainedResult

Estimate VOI when information changes the best feasible strategy.

scenario_values is a scenario-by-strategy matrix. The baseline uses mean scenario value; perfect information chooses the best feasible strategy separately in each scenario. Inputs are deterministic and the result is explicitly fixture-backed pending external data and parity.

Parameters:

• scenario_values np.ndarray | list[list[float]]
• strategy_costs list[float] | np.ndarray
• strategy_capacity list[float] | np.ndarray
• budget float
• capacity float
• strategy_names list[str] | None (default: None)
• information_cost float (default: 0.0)

Returns: CapacityBudgetConstrainedResult