voiage.methods.structural.structural_evppi

structural_evppi

structural_evppi([positional or keyword] model_structure_evaluators: list[ModelStructureEvaluator] = None, [positional or keyword] structure_probabilities: np.ndarray | list[float] = None, [positional or keyword] psa_samples_per_structure: list[PSASample] = None, [positional or keyword] structures_of_interest: list[int] = None, [positional or keyword] population: float | None = None, [positional or keyword] discount_rate: float | None = None, [positional or keyword] time_horizon: float | None = None) -> float

Calculate structural EVPPI for a subset of model structures.

Parameters

model_structure_evaluators : list[callable] One evaluator per candidate structure. structure_probabilities : numpy.ndarray or list[float] Prior probabilities for each structure. psa_samples_per_structure : list[ParameterSet] PSA samples relevant to each candidate structure. structures_of_interest : list[int] Indices of the structures whose uncertainty is being resolved. population : float, optional Population size for population scaling. discount_rate : float, optional Annual discount rate used for population scaling. time_horizon : float, optional Time horizon in years for population scaling.

Returns

float Structural EVPPI on a per-decision basis unless population scaling is requested.

Parameters:

• model_structure_evaluators list[ModelStructureEvaluator]
• structure_probabilities np.ndarray | list[float]
• psa_samples_per_structure list[PSASample]
• structures_of_interest list[int]
• population float | None (default: None)
• discount_rate float | None (default: None)
• time_horizon float | None (default: None)

Returns: float