egttools.numerical.numerical_.calculate_expected_state_indicator¶

calculate_expected_state_indicator()¶

Calculate E[f] = sum_s sd(s) * f(s) for a single state-level indicator.

Unlike calculate_expected_indicator, no group sampling is performed. The callable indicator receives the full population state vector (integer counts, sums to pop_size) and returns a scalar.

Parameters:

pop_size (int) – Total number of individuals in the population.
nb_strategies (int) – Number of strategies available in the population.
stationary_distribution (scipy.sparse.csr_matrix) – Sparse stationary distribution over population states.
indicator (callable) – Function mapping a population state (list[int]) to a float.

Returns:

Expected value of the indicator.

Return type:

float