Ë
    Ï—¬j?  ã                   óÌ  — U d Z ddlmZ ddlZddlZddlZddlZddlm	Z	m
Z
mZmZmZ ddlZ ej                  d«      ZdZddiZe
eef   ed	<   d
dœdededefd„Z ed
d
d
d
d
d
d
d
d
d
d
d
dœ«      Zded<   dee   de
eef   fd„Z ed
d
d
d
d
d
d
d
d
d
d
d
d
dœ«      Zded<   dee   de
eef   fd„Zd
dœdee   dede
eeeef   f   fd„Zd
d
dœdedededee   fd„Z	 d(d
dœdededefd„Z	 d(d
dœdededefd „Zd!ee   d"e
eeeef   f   defd#„Z e!d$k(  rNd%Z"ejF                  jI                  ejF                  jK                  e&«      d&«      Z' ee"e'd'¬«        ee"e'd'¬«       yy))u  
EEG channel summary, 2D grid mapping, and naming convention normalization.

Reads a pickled metadata dict (produced by `get_dataset_info`) and:
  1. Extracts unique EEG channel names (filtering out EOG/EXG/ECG channels).
  2. Maps channels to a 2D grid layout (row = anterior-posterior band,
     column = left-right position).
  3. Handles naming convention variants such as A1/A2 â†” M1/M2,
     FP1 â†’ Fp1, and non-standard prefixes (CB, M, etc.).
  4. Detects duplicate grid positions and warns about ambiguous layout.
é    )ÚOrderedDictN)ÚAnyÚDictÚListÚOptionalÚTuplez!([ACFIMNOPT][BCFOpPT]?)([\dz]\d?))ÚEXÚEOÚECÚFPÚFpÚ_PREFIX_ALIASESF©Úswap_amÚnamer   Úreturnc                ó¢   — t         j                  «       D ])  \  }}| j                  |«      sŒ|| t        |«      d z   }  n |r| dv rd| dd z   } | S )u'  Normalise a channel name to its canonical form.

    Parameters
    ----------
    name : str
        Raw channel name (e.g. ``"FP1"``, ``"M1"``, ``"A2"``).
    swap_am : bool
        If *True*, treat A1/A2 and M1/M2 as the same position.
        The modern standard (M1/M2) is preferred, so A1 â†’ M1, A2 â†’ M2.
        The 10-20 system originally called the mastoid reference A1/A2;
        the 10-10 system renamed it M1/M2.  Many datasets use the two
        interchangeably.

    Returns
    -------
    str
        Normalised channel name.
    N)ÚA1ÚA2ÚMé   )r   ÚitemsÚ
startswithÚlen)r   r   ÚoldÚnews       úl/root/disk_3tb/EEG-sAAD-Grand-Challenge-Training-Dataset/SuperHugeAAD/superhuge/utils/get_channel_summary.pyÚnormalize_channel_namer   6   sb   € ô( $×)Ñ)Ö+‰ˆˆSØ�?‰?˜3ÕØ˜œc #›h˜jÐ)Ñ)ˆDÙð ,ñ
 à�<ÑØ˜˜a˜b˜‘>ˆDð €Kó    )ÚNr   ÚAFÚF)ÚFCÚFT)ÚCÚTÚA)ÚCPÚTPr   ÚPÚPOÚOÚCBÚIz(OrderedDict[str | Tuple[str, ...], bool]Ú_ROW_TEMPLATEÚchannelsc                 ó|  — t        d„ t        D «       «      }| D ]Z  }t        j                  |«      }|sŒ|j	                  d«      }|D ]*  }t        |t        «      r||v sŒd||<    ŒM||k(  sŒ%d||<    ŒZ Œ\ i }d}|j                  «       D ]/  \  }}|sŒ	t        |t        «      r|D ]  }	|||	<   Œ	 n|||<   |dz  }Œ1 |S )uš  Build a prefix â†’ row-index dictionary from the channels present.

    Only rows that appear in *channels* are assigned an index; unused rows
    are omitted so the grid does not have empty rows.

    Parameters
    ----------
    channels : list of str
        Normalised channel names (e.g. ``["Fp1", "Cz", "O2"]``).

    Returns
    -------
    dict[str, int]
        Mapping ``prefix â†’ row_index``.
    c              3   ó$   K  — | ]  }|d f–— Œ
 y­w©FN© ©Ú.0Úks     r   Ú	<genexpr>z-create_channel_row_mapping.<locals>.<genexpr>„   s   è ø€ ð =Ù)�qˆˆEŒ
™Mùó   ‚r   Tr   )r   r/   ÚPREFIX_REGEXÚmatchÚgroupÚ
isinstanceÚtupler   )
r0   ÚpresentÚchr;   ÚregionÚkeyÚnew_mappingÚidxÚ
is_presentÚprefixs
             r   Úcreate_channel_row_mappingrG   t   sâ   € ô  2=ñ =Ý)ó=ó 2€Gó ˆÜ×"Ñ" 2Ó&ˆÙØØ—‘˜Q“ˆãˆCÜ˜#œuÔ%Ø˜S’=Ø#'�G˜C‘LÙØ˜3“Ø#�˜‘Ùñ ð ð  #%€KØ
€CØ"Ÿ=™=ž?‰ˆˆZÚÜ˜#œuÔ%Û!�FØ*-�K Ò'ñ "ð $'�˜CÑ Ø�1‰H‰Cð +ð Ðr   )Ú11Ú9Ú7Ú5Ú3Ú1ÚzÚ2Ú4Ú6Ú8Ú10Ú12zOrderedDict[str, bool]Ú_COL_TEMPLATEc                 óP  — t        d„ t        D «       «      }| D ]a  }t        j                  |«      }|sŒ|j	                  d«      }|j	                  d«      }|dv rt        dt        |«      z   «      }||v sŒ]d||<   Œc i }d}|j                  «       D ]  \  }}|sŒ	|||<   |dz  }Œ |S )uò   Build a lateral-number â†’ column-index dictionary.

    Parameters
    ----------
    channels : list of str
        Normalised channel names.

    Returns
    -------
    dict[str, int]
        Mapping ``number_or_z â†’ column_index``.
    c              3   ó$   K  — | ]  }|d f–— Œ
 y­wr3   r4   r5   s     r   r8   z-create_channel_col_mapping.<locals>.<genexpr>Í   s   è ø€ Ð*M¹}¸!¨A¨u¬:¹}ùr9   r   é   ©r'   r   é
   Tr   )r   rU   r:   r;   r<   ÚstrÚintr   )	r0   r?   r@   r;   rA   ÚnumberrC   rD   rE   s	            r   Úcreate_channel_col_mappingr^   À   s»   € ô  +Ñ*M½}Ó*MÓM€GãˆÜ×"Ñ" 2Ó&ˆÙØØ—‘˜Q“ˆØ—‘˜Q“ˆð �ZÑÜ˜œc &›kÑ)Ó*ˆFà�WÒØ"ˆG�FŠOð# ð( #%€KØ
€CØ%Ÿm™mžoÑˆ�
ÚØ"%ˆK˜ÑØ�1‰H‰Cð .ð
 Ðr   c                ó  — | D �cg c]  }t        ||¬«      ‘Œ }}t        |«      }t        |«      }i }| D ]Ð  }t        ||¬«      }t        j	                  |«      }|st        j                  d|› d�«       ŒA|j                  d«      }	|j                  d«      }
|	dv rt        dt        |
«      z   «      }
|	|vrt        j                  d|	› d	|› d
�«       ŒŸ|
|vrt        j                  d|
› d	|› d
�«       ŒÀ||	   }||
   }||f||<   ŒÒ |S c c}w )u®  Compute (row, column) grid positions for every channel.

    Parameters
    ----------
    channels : list of str
        Raw channel names from metadata (may contain naming variants).
    swap_am : bool
        If *True*, treat A1/A2 â†” M1/M2 as the same position (see
        :func:`normalize_channel_name` for rationale).

    Returns
    -------
    dict[str, tuple[int, int]]
        ``channel_name â†’ (row, column)``.
    r   zUnrecognised channel name 'u   ' â€” skipping grid mapping.r   rX   rY   rZ   zUnknown region 'z' for channel 'u   ' â€” skipping.zUnknown column number ')
r   rG   r^   r:   r;   ÚwarningsÚwarnr<   r[   r\   )r0   r   r@   Únorm_channelsÚrow_mappingÚcol_mappingÚchannel_to_positionÚnchr;   rA   r]   ÚrowÚcols                r   Úinfer_channel_positionsri   ò   s>  € ñ* LTÓTÉ8ÀRÔ+¨B¸Ö@È8€MÐTä,¨]Ó;€KÜ,¨]Ó;€Kà68ÐÛˆä$ R°Ô9ˆä×"Ñ" 3Ó'ˆÙÜ�M‰MÐ7¸°tÐ;WÐXÔYØà—‘˜Q“ˆØ—‘˜Q“ˆð
 �ZÑÜ˜œc &›kÑ)Ó*ˆFà˜Ñ$Ü�M‰MÐ,¨V¨H°OÀBÀ4ÀÐWÔXØØ˜Ñ$Ü�M‰MØ)¨&¨°ÀÀÀOÐTôð à˜&Ñ!ˆØ˜&Ñ!ˆð $'¨ *Ð˜BÒðA ðD ÐùòQ Us   …D
)r   ÚverboseÚmetadata_pathrj   c                ó°  ‡— t        | d«      5 }t        j                  |«      }ddd«       t        «       }j	                  «       D ]\  \  }}|d   j	                  «       D ]A  \  }}	|	d   Št        ˆfd„t        D «       «      rŒ$t        ‰|¬«      Š|j                  ‰«       ŒC Œ^ t        |«      }
|rt        dt        |
«      › d�«       |
S # 1 sw Y   Œ©xY w)	u~  Extract unique EEG channel names from a pickled metadata dict.

    Parameters
    ----------
    metadata_path : str
        Path to ``metadata.pkl``.
    swap_am : bool
        Normalise A1/A2 â†” M1/M2 (see :func:`normalize_channel_name`).
    verbose : bool
        Log number of channels found.

    Returns
    -------
    list of str
        Sorted unique channel names.
    ÚrbNÚchannel_infosr   c              3   ó&   •K  — | ]  }|‰v –— Œ
 y ­w)Nr4   )r6   ÚexÚ	chan_names     €r   r8   z&get_channel_summary.<locals>.<genexpr>U  s   øè ø€ Ð:©\ r�2˜”?©\ùs   ƒr   z[get_channel_summary] Found z unique EEG channels.)ÚopenÚpickleÚloadÚsetr   ÚanyÚEXG_PATTERNSr   ÚaddÚsortedÚprintr   )rk   r   rj   ÚfÚmetadataÚchannel_namesÚentryÚmetaÚ_kÚvÚresultrq   s              @r   Úget_channel_summaryrƒ   7  sÅ   ø€ ô, 
ˆm˜TÔ	" aÜ#)§;¡;¨q£>ˆ÷ 
#ô ›€MØ—~‘~Ö'‰ˆˆtØ˜/Ñ*×0Ñ0Ö2‰EˆB�Ø˜v™YˆIäÓ:­\Ó:Ô:ØÜ.¨yÀ'ÔJˆIØ×Ñ˜iÕ(ñ 3ð (ô �MÓ"€FÙÜÐ,¬S°«[¨MÐ9NÐOÔPØ€M÷! 
#Ð	"ús   ŽCÃCÚoutput_pathc          
      ó  — t        | |¬«      }t        ||¬«      }|st        d«       yt        d„ |j	                  «       D «       «      dz   }t        d„ |j	                  «       D «       «      dz   }t        j                  ||ft        ¬«      }|j                  d«       |j                  «       D ]  \  }\  }	}
|||	|
f<   Œ t        d«       t        d	«       t        d
«       t        d«       |D ]0  }t        dj                  |D �cg c]
  }|r|d›nd‘Œ c}«      «       Œ2 t        d«       t        d«       |j                  «       D ]  \  }}t        d|› d|› d�«       Œ t        «        t        dt        |«      › �«       i }|j                  «       D ]&  \  }}|j                  |g «      j                  |«       Œ( |j                  «       D ��ci c]  \  }}t        |«      dkD  sŒ||“Œ }}}|rmt        d«       t        d«       t        d«       t        |j                  «       «      D ]%  \  }}t        d|› ddj                  |«      › �«       Œ' t        «        nt        d«       |rt        |||«       yyc c}w c c}}w )uN  Read metadata, infer 2D grid layout, and print / write the result.

    Parameters
    ----------
    metadata_path : str
        Path to ``metadata.pkl``.
    output_path : str, optional
        If provided, write the result to a Python enum file.
    swap_am : bool
        Treat A1/A2 â†” M1/M2 as the same electrode position.
    r   z7No valid channel positions could be inferred. Aborting.Nc              3   ó&   K  — | ]	  }|d    –— Œ y­w)r   Nr4   ©r6   Úps     r   r8   z'map_channels_to_grid.<locals>.<genexpr>}  ó   è ø€ Ð3Ñ 2˜1�!�A•$Ñ 2ùó   ‚r   c              3   ó&   K  — | ]	  }|d    –— Œ y­w)r   Nr4   r‡   s     r   r8   z'map_channels_to_grid.<locals>.<genexpr>~  r‰   rŠ   )Údtypeú=
============================================================z!  2D GRID MAPPING OF EEG CHANNELSu3     (anterior â†’ posterior â†“,  left â†’ right â†’)ú=============================================================
Ú z>5z  ---z=
------------------------------------------------------------zCHANNEL2D_ENUM mapping:
ú    "ú": Ú,úNUM_ELECTRODES = z=
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!z2  DUPLICATE GRID POSITIONS (check & fix manually):z<!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!z    Position z: z, z'
No duplicate grid positions detected.
)rƒ   ri   rz   ÚmaxÚvaluesÚnpÚemptyÚobjectÚfillr   Újoinr   Ú
setdefaultÚappendry   Úwrite_channel_results_to_file)rk   r„   r   r0   Ú	positionsÚmax_rowÚmax_colÚgridr@   ÚrÚcrg   r7   r�   ÚdupÚposrˆ   ÚchsÚ
collisionss                      r   Úmap_channels_to_gridr¨   e  sE  € ô" # =¸'ÔB€HÜ'¨¸'ÔB€IáÜÐGÔHØäÑ3 	× 0Ñ 0Ô 2Ó3Ó3°aÑ7€GÜÑ3 	× 0Ñ 0Ô 2Ó3Ó3°aÑ7€Gä�8‰8�W˜gÐ&¬fÔ5€DØ‡I�Iˆd„Oà—o‘oÖ'‰
ˆ‰FˆQ�ØˆˆQ�ˆTŠ
ð (ô 
ˆ/ÔÜ	Ð
-Ô.Ü	Ð
?Ô@Ü	ˆ/ÔãˆÜˆc�h‰hÁÓDÁ¸"¡b˜2˜b™'¨gÑ5ÀÑDÓEÕFð ô 
ˆ/ÔÜ	Ð
%Ô&Ø—‘Ö!‰ˆˆ1Ü��a�S˜˜A˜3˜aÐ Õ!ð "ä	„GÜ	Ðœc )›nÐ-Ð
.Ô/ð -/€CØ—?‘?Ö$‰ˆˆCØ�‰�s˜BÓ×&Ñ& rÕ*ð %ð (+§y¡y¤{ÔC¡{™V˜Q ´c¸#³hÀ³l�!�S‘& {€JÑCÙÜˆoÔÜÐBÔCÜˆhŒÜ˜z×/Ñ/Ó1Ö2‰HˆC�Ü�M #  b¨¯©°3«Ð(8Ð9Õ:ð 3ä�äÐ9Ô:áÜ% h°	¸;ÕGð ùò3 Eùó Ds   ÄI9ÇI>Ç&I>c                ó&  — t        | |¬«      }t        d«       t        d«       t        d«       t        d«       t        |«      D ]  \  }}t        d|› d|› d�«       Œ t        d	«       t        d
t        |«      › d�«       |rt	        |i |«       yy)uI  Extract channel names as a flat sorted list (1D enumeration).

    Parameters
    ----------
    metadata_path : str
        Path to ``metadata.pkl``.
    output_path : str, optional
        If provided, write the result to a Python enum file.
    swap_am : bool
        Treat A1/A2 â†” M1/M2 as the same electrode position.
    r   r�   z  1D CHANNEL ENUMERATIONrŽ   zCHANNEL1D_ENUM = {r�   r‘   r’   Ú}z
num_electrodes = Ú
N)rƒ   rz   Ú	enumerater   r�   )rk   r„   r   Úchannel_vectorÚir@   s         r   Úmap_channel_to_vectorr¯   ©  s�   € ô" )¨ÀÔH€Nä	ˆ/ÔÜ	Ð
$Ô%Ü	ˆ/Ôä	Ð
ÔÜ˜>Ö*‰ˆˆ2Ü��b�T˜˜Q˜C˜qÐ!Õ"ð +ä	ˆ#„JÜ	Ð¤ NÓ 3Ð4°BÐ
7Ô8áÜ% n°b¸+ÕFð r   r­   Úgrid_positionsc           	      ó�  — t        |d«      5 }|j                  d«       |j                  d«       t        | «      D ]?  \  }}|j                  dd«      j                  dd«      }|j                  d|› d|› d	�«       ŒA |j                  d	«       |j                  d
t	        | «      › d	�«       |rt|j                  d	«       |j                  d«       |j                  «       D ]?  \  }}|j                  dd«      j                  dd«      }|j                  d|› d|› d	�«       ŒA |j                  d	«       ddd«       y# 1 sw Y   yxY w)uE  Write channel vector and grid positions as Python Enum definitions.

    Parameters
    ----------
    channel_vector : list of str
        Sorted channel names.
    grid_positions : dict
        Channel â†’ (row, column) mapping (may be empty for 1D-only output).
    output_path : str
        Destination ``.py`` file.
    Úwzfrom enum import Enum

zclass CHANNEL1D_ENUM(Enum):
Ú-Ú_Ú.z    z = r«   r“   zclass CHANNEL2D_ENUM(Enum):
N)rr   Úwriter¬   Úreplacer   r   )r­   r°   r„   r{   r®   r@   Úmemberr¥   s           r   r�   r�   Ï  s!  € ô  
ˆk˜3Ô	 1Ø	�‰Ð+Ô,Ø	�‰Ð/Ô0Ü˜~Ö.‰EˆAˆrà—Z‘Z  SÓ)×1Ñ1°#°sÓ;ˆFØ�G‰G�d˜6˜( # a S¨Ð+Õ,ð /ð 	
�‰�ŒØ	�‰Ð#¤C¨Ó$7Ð#8¸Ð;Ô<áØ�G‰G�DŒMØ�G‰GÐ3Ô4Ø)×/Ñ/Ö1‘��CØŸ™ C¨Ó-×5Ñ5°c¸3Ó?�Ø—‘˜$˜v˜h c¨#¨¨bÐ1Õ2ð 2ð 	
�‰�Œ÷! 
 ×	Ñ	ús   �D&D<Ä<EÚ__main__z7E:\derivatives\SuperHuge\preprocessed\meta\metadata.pklzchannel_enum.pyT)Ú )(Ú__doc__Úcollectionsr   Úosrs   r`   Únumpyr–   Útypingr   r   r   r   r   ÚreÚcompiler:   rw   r   r[   Ú__annotations__Úboolr   r/   r\   rG   rU   r^   ri   rƒ   r¨   r¯   r�   Ú__name__rk   Úpathrš   ÚdirnameÚ__file__r„   r4   r   r   Ú<module>rÈ      sŸ  ðò
õ $Û 	Û Û ã ß 3Õ 3Û 	ð" ˆr�z‰zÐ>Ó?€ð "€ð 	ˆ$ð#€��c˜3�h‘ó ð
 :?ò  ð °$ð À3ó ñX =HàØØØØØØ ØØØØØñó=€Ð9ó ð$/¨¨c©ð /°t¸CÀ¸H±~ó /ñr +6àØØØØØØØØØØØØñó+€Ð'ó ð&*¨¨c©ð *°t¸CÀ¸H±~ó *ðj ò=Ø�3‰ið=ð ð=ð 
ˆ#ˆu�S˜#�X‰Ð
Ñó	=ðP Øò	&Øð&ð ð&ð ð	&ð
 
ˆ#�Yó&ð` ðAHð ò	AHØðAHàðAHð ó	AHðL ðGð ò	GØðGàðGð ó	GðL Ø˜‘Ið à˜˜e C¨ H™oÐ-Ñ.ð ð ó ðN ˆzÒØN€MØ—'‘'—,‘,˜rŸw™wŸ™¨xÓ8Ð:KÓL€Ká˜-¨¸dÕCÙ˜¨¸TÖBð r   