coco_pipe.descriptors.validation
================================

.. py:module:: coco_pipe.descriptors.validation

.. autoapi-nested-parse::

   Runtime input validation helpers for descriptor extraction.



Functions
---------

.. autoapisummary::

   coco_pipe.descriptors.validation.validate_runtime_inputs


Module Contents
---------------

.. py:function:: validate_runtime_inputs(config: coco_pipe.descriptors.configs.DescriptorConfig, *, X: Any, ids: collections.abc.Sequence[Any] | numpy.ndarray | None = None, channel_names: collections.abc.Sequence[str] | numpy.ndarray | None = None, sfreq: float | None = None) -> dict[str, Any]

   Validate explicit runtime inputs against the descriptor contract.

   :param config: Parsed descriptor config defining the expected runtime contract.
   :type config: DescriptorConfig
   :param X: Candidate signal array expected to coerce to shape
             ``(n_obs, n_channels, n_times)``.
   :type X: Any
   :param ids: Optional runtime inputs aligned with the observation or channel axes.
   :param channel_names: Optional runtime inputs aligned with the observation or channel axes.
   :param sfreq: Optional runtime inputs aligned with the observation or channel axes.

   :returns: Normalized runtime inputs ready for pipeline and extractor dispatch.
   :rtype: dict[str, Any]

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