GroupObservation

experimental.network_dynamics.GroupObservation(
    readouts,
    *,
    params=None,
    channels,
    fill_value=0.0,
    allow_partial_coverage=False,
    monitor=None,
)

Project group variables of interest into common graph-order channels.

Each mapping value is a variable-of-interest name, a tuple of names, or a readout(voi, params) -> [Q, n_group_nodes] callable. Equal channel width only establishes shape compatibility; users remain responsible for making group-specific transformations scientifically commensurable.

monitor optionally applies a temporal monitor or JointObservation to the common channels within solver blocks. Readout parameters stay in config.observation and monitor parameters in config.monitor.

Partial coverage is allowed for ordinary projection. Before a temporal monitor it is rejected unless allow_partial_coverage=True. The opt-in makes fill_value a real monitor input; it does not make BOLD or later statistics fill-aware. The deprecated reduce= path applies the same coverage rule during its compatibility period.