coco_pipe.viz.topo
==================

.. py:module:: coco_pipe.viz.topo

.. autoapi-nested-parse::

   Montage-based topographic helpers.

   Channel-name-driven scalp topomaps that need only a list of channel names and
   values (no recording ``Info``): a single static map, an interactive selector
   across several maps, and a predicate that gates topomaps to genuine sensor
   axes. Positions are resolved from a standard MNE montage via
   :func:`coco_pipe.viz.info_from_montage`.



Attributes
----------

.. autoapisummary::

   coco_pipe.viz.topo.LOGGER


Functions
---------

.. autoapisummary::

   coco_pipe.viz.topo.standard_montage_channels
   coco_pipe.viz.topo.feature_names_are_channels
   coco_pipe.viz.topo.plot_topomap_from_channel_values
   coco_pipe.viz.topo.plot_topomap_selector


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

.. py:data:: LOGGER

.. py:function:: standard_montage_channels(montage = 'colin27_1020')

   Return the lower-cased channel names of a standard MNE *montage*.


.. py:function:: feature_names_are_channels(feature_names, channels = None, *, montage = 'colin27_1020')

   Return ``True`` when every feature name is a known montage channel.

   Used to gate scalp topomaps of component loadings: a topomap is only
   meaningful when the feature axis *is* the sensor montage (e.g. raw
   sensor-space input), not when features are ``band-by-channel`` descriptors
   flattened into composite names. When *channels* is ``None`` the vocabulary
   defaults to the full standard *montage* (which carries both legacy and
   modern 10-20 names); callers pass their own list to restrict the gate to a
   specific subset or to accept non-standard channel names.


.. py:function:: plot_topomap_from_channel_values(channel_names, values, title, cmap = 'viridis', unit = None, bad_channels = None, *, montage = 'colin27_1020')

   Topomap plotting without a raw object (uses standard montage).

   :param channel_names: List of channel names.
   :param values: Values to plot (one per channel).
   :param title: Figure title.
   :param cmap: Colormap name.
   :param unit: Optional unit for colorbar label.
   :param bad_channels: Optional list of channels to mark with an 'X'.
   :param montage: Standard MNE montage used to resolve electrode positions.


.. py:function:: plot_topomap_selector(value_maps, title, unit = None)

   Interactive selector over MNE-rendered topomaps.