tvb.WilsonCowan

experimental.network_dynamics.dynamics.tvb.WilsonCowan(**kwargs)

Wilson-Cowan neural mass model with excitatory and inhibitory populations.

Two-population model representing the mean firing rates of excitatory (E) and inhibitory (I) neural populations with sigmoid activation functions and mutual interactions.

Notes

State equations:

\[ \begin{aligned} \frac{dE}{dt} &= \frac{-E + (k_e - r_e E) S_e}{\tau_e} \\ \frac{dI}{dt} &= \frac{-I + (k_i - r_i I) S_i}{\tau_i} \end{aligned} \]

Sigmoid activation functions:

\[ \begin{aligned} x_e &= \alpha_e (c_{ee} E - c_{ei} I + P - \theta_e + c_{\text{delayed}} + \text{lc}_e + \text{lc}_i) \\ x_i &= \alpha_i (c_{ie} E - c_{ii} I + Q - \theta_i + \text{lc}_e + \text{lc}_i) \end{aligned} \]

If shift_sigmoid=True (baseline-corrected):

\[S_e = c_e \left(\frac{1}{1+\exp(-a_e(x_e-b_e))} - \frac{1}{1+\exp(a_e b_e)}\right)\]

Otherwise (standard sigmoid):

\[S_e = \frac{c_e}{1 + \exp(-a_e(x_e - b_e))}\]

Attributes

Name Type Description
STATE_NAMES tuple of str State variables: ('E', 'I')
INITIAL_STATE tuple of float Default initial conditions: (0.1, 0.05)
AUXILIARY_NAMES tuple of str Auxiliary variables: ('S_e', 'S_i') (sigmoid outputs)
COUPLING_INPUTS dict Coupling specification: {'instant': 2, 'delayed': 1} Instant coupling has 2 components [E, I] feeding into both populations; delayed coupling feeds only into E population
DEFAULT_PARAMS Bunch Standard Wilson-Cowan parameters

References

Wilson & Cowan (1972). Excitatory and inhibitory interactions in localized populations of model neurons. Biophysical Journal, 12, 1-24.

Methods

Name Description
dynamics Compute Wilson-Cowan dynamics.

dynamics

experimental.network_dynamics.dynamics.tvb.WilsonCowan.dynamics(
    t,
    state,
    params,
    coupling,
    external,
)

Compute Wilson-Cowan dynamics.

Parameters

Name Type Description Default
t float Current time (ms) required
state jnp.ndarray Current state with shape [2, n_nodes] containing (E, I) required
params Bunch Model parameters required
coupling Bunch Coupling inputs with attributes: - .instant[0]: local E coupling - .instant[1]: local I coupling - .delayed[0]: long-range coupling required
external Bunch External inputs (currently unused) required

Returns

Name Type Description
derivatives jnp.ndarray State derivatives with shape [2, n_nodes]
auxiliaries jnp.ndarray Auxiliary variables with shape [2, n_nodes] containing (S_e, S_i) sigmoid outputs