Skip to content

voiage.methods.dominance.calculate_icers

calculate_icers([positional or keyword] costs: np.ndarray | list[float] = None, [positional or keyword] effects: np.ndarray | list[float] = None, [positional or keyword] frontier_indices: list[int] | None = None) -> tuple[np.ndarray, np.ndarray, np.ndarray]

Calculate incremental costs, effects, and ICERs along the frontier.

costs : numpy.ndarray or list[float] Strategy costs. effects : numpy.ndarray or list[float] Strategy effects. frontier_indices : list[int], optional Precomputed frontier ordering.

tuple of numpy.ndarray Incremental costs, incremental effects, and ICERs.

For adjacent frontier strategies :math:i-1 and :math:i, the ICER is

.. math::

\mathrm{ICER}i = \frac{C_i - C{i-1}}{E_i - E_{i-1}}.

>>> import numpy as np >>> from voiage.methods.dominance import calculate_icers >>> inc_costs, inc_effects, icers = calculate_icers( … np.array([10.0, 12.0, 13.0]), … np.array([1.0, 1.1, 1.3]), … ) >>> inc_costs.tolist() [2.0, 1.0]

Parameters:

  • costs np.ndarray | list[float]
  • effects np.ndarray | list[float]
  • frontier_indices list[int] | None (default: None)

Returns: tuple[np.ndarray, np.ndarray, np.ndarray]