coco_pipe.descriptors.validation#

Runtime input validation helpers for descriptor extraction.

Functions#

validate_runtime_inputs(config, *, X[, ids, ...])

Validate explicit runtime inputs against the descriptor contract.

Module Contents#

coco_pipe.descriptors.validation.validate_runtime_inputs(config, *, X, ids=None, channel_names=None, sfreq=None)#

Validate explicit runtime inputs against the descriptor contract.

Parameters:

  • config (DescriptorConfig) – Parsed descriptor config defining the expected runtime contract.

  • X (Any) – Candidate signal array expected to coerce to shape (n_obs, n_channels, n_times).

  • ids (collections.abc.Sequence[Any] | numpy.ndarray | None) – Optional runtime inputs aligned with the observation or channel axes.

  • channel_names (collections.abc.Sequence[str] | numpy.ndarray | None) – Optional runtime inputs aligned with the observation or channel axes.

  • sfreq (float | None) – Optional runtime inputs aligned with the observation or channel axes.

Returns:

Normalized runtime inputs ready for pipeline and extractor dispatch.

Return type:

dict[str, Any]

Raises:

ValueError – If array dimensionality, identifier alignment, sampling frequency, or explicit channel-name requirements are violated.