ó
    Ï—¬j?  ã                   óà  • % S r SSKJr  SSKrSSKrSSKrSSKrSSKJ	r	J
r
JrJrJr  SSKr\R                  " S5      rSrSS0r\
\\4   \S	'   S
S.S\S\S\4S jjr\" S
S
S
S
S
S
S
S
S
S
S
S
S.5      rS\S'   S\\   S\
\\4   4S jr\" S
S
S
S
S
S
S
S
S
S
S
S
S
S.5      rS\S'   S\\   S\
\\4   4S jrS
S.S\\   S\S\
\\\\4   4   4S jjrS
S
S.S\S\S\S\\   4S jjr S(S
S.S\S\S\4S jjjr S(S
S.S\S\S\4S  jjjrS!\\   S"\
\\\\4   4   S\4S# jr \!S$:X  aH  S%r"\RF                  RI                  \RF                  RK                  \&5      S&5      r'\" \"\'S'S9  \" \"\'S'S9  gg))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                óº   • [         R                  5        H-  u  p#U R                  U5      (       d  M  X0[        U5      S -   n   O   U(       a  U S;   a  SU SS -   n U $ )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       Ú}/root/disk_3tb/EEG-sAAD-Grand-Challenge-Training-Dataset/baselines/python/SuperHugeAAD/superhuge/utils/get_channel_summary.pyÚnormalize_channel_namer   6   sa   € ô( $×)Ñ)Ö+‰ˆØ�?‰?˜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                 ó¶  • [        S [         5       5      nU  Hj  n[        R                  U5      nU(       d  M!  UR	                  S5      nU H2  n[        U[        5      (       a  XE;   a  SX'     MX  M&  XE:X  d  M-  SX'     Mh     Ml     0 nSnUR                  5        H:  u  pXU(       d  M  [        U[        5      (       a  U H  n	XvU	'   M	     OXvU'   US-  nM<     U$ )un  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   ó(   #   • U  H  oS 4v •  M
     g7f©FN© ©Ú.0Úks     r   Ú	<genexpr>Ú-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_mappingrH   t   sã   € ô  2=ñ =Ý)ó=ó 2€Gó ˆÜ×"Ñ" 2Ó&ˆÞÙØ—‘˜Q“ˆãˆCÜ˜#œu×%Ñ%Ø“=Ø#'�G‘LÚñ !ð •Ø#�‘Úó ñ ð  #%€KØ
€CØ"Ÿ=™=ž?‰ˆßˆ:Ü˜#œu×%Ñ%Û!�FØ*- Ó'ò "ð $'˜CÑ Ø�1‰HŠCñ +ð Ðr   )Ú11Ú9Ú7Ú5Ú3Ú1ÚzÚ2Ú4Ú6Ú8Ú10Ú12zOrderedDict[str, bool]Ú_COL_TEMPLATEc                 ór  • [        S [         5       5      nU  Hk  n[        R                  U5      nU(       d  M!  UR	                  S5      nUR	                  S5      nUS;   a  [        S[        U5      -   5      nXQ;   d  Mg  SX'   Mm     0 nSnUR                  5        H  u  pXU(       d  M  XvU'   US-  nM     U$ )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   ó(   #   • U  H  oS 4v •  M
     g7fr3   r4   r5   s     r   r8   Ú-create_channel_col_mapping.<locals>.<genexpr>Í   s   é € Ð*Mº}¸!¨u­:º}ùr:   r   é   ©r'   r   é
   Tr   )r   rV   r;   r<   r=   ÚstrÚintr   )	r0   r@   rA   r<   rB   ÚnumberrD   rE   rF   s	            r   Úcreate_channel_col_mappingr`   À   sµ   € ô  +Ñ*M½}Ó*MÓM€GãˆÜ×"Ñ" 2Ó&ˆÞÙØ—‘˜Q“ˆØ—‘˜Q“ˆð �ZÓÜ˜œc &›kÑ)Ó*ˆFàÕØ"ˆG‹Oñ# ð( #%€KØ
€CØ%Ÿm™mžoÑˆßˆ:Ø"%˜ÑØ�1‰HŠCñ .ð
 Ðr   c                ó.  • U  Vs/ s H  n[        X!S9PM     nn[        U5      n[        U5      n0 nU  HØ  n[        X!S9n[        R	                  U5      nU(       d  [
        R                  " SU S35        MD  UR                  S5      n	UR                  S5      n
U	S;   a  [        S[        U
5      -   5      n
X”;  a  [
        R                  " SU	 S	U S
35        M§  X¥;  a  [
        R                  " SU
 S	U S
35        MË  XI   nXZ   nX¼4Xb'   MÚ     U$ s  snf )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   rZ   r[   r\   zUnknown region 'z' for channel 'u   ' â€” skipping.zUnknown column number ')
r   rH   r`   r;   r<   ÚwarningsÚwarnr=   r]   r^   )r0   r   rA   Únorm_channelsÚrow_mappingÚcol_mappingÚchannel_to_positionÚnchr<   rB   r_   ÚrowÚcols                r   Úinfer_channel_positionsrk   ò   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ôñ àÑ!ˆØÑ!ˆð $' *ÐÓñA ðD ÐùòQ Us   …D)r   ÚverboseÚmetadata_pathrl   c                óÒ  ^• [        U S5       n[        R                  " U5      nSSS5        [        5       nWR	                  5        Ha  u  pgUS   R	                  5        HE  u  p‰U	S   m[        U4S j[         5       5      (       a  M*  [        TUS9mUR                  T5        MG     Mc     [        U5      n
U(       a  [        S[        U
5       S35        U
$ ! , (       d  f       N¹= f)	uJ  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   ó,   >#   • U  H	  oT;   v •  M     g 7f)Nr4   )r6   ÚexÚ	chan_names     €r   r8   Ú&get_channel_summary.<locals>.<genexpr>U  s   øé € Ð:ª\ r˜–?ª\ùs   ƒr   z[get_channel_summary] Found z unique EEG channels.)ÚopenÚpickleÚloadÚsetr   ÚanyÚEXG_PATTERNSr   ÚaddÚsortedÚprintr   )rm   r   rl   ÚfÚmetadataÚchannel_namesÚentryÚmetaÚ_kÚvÚresultrs   s              @r   Úget_channel_summaryr†   7  sÄ   ø€ ô, 
ˆm˜TÔ	" aÜ#)§;¢;¨q£>ˆ÷ 
#ô ›€MØ—~‘~Ö'‰ˆØ˜/Ñ*×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          
      ó0  • [        XS9n[        X2S9nU(       d  [        S5        g[        S UR	                  5        5       5      S-   n[        S UR	                  5        5       5      S-   n[
        R                  " XV4[        S9nUR                  S5        UR                  5        H  u  nu  pšX‡Xš4'   M     [        S5        [        S	5        [        S
5        [        S5        U H8  n[        SR                  U Vs/ s H  oˆ(       a  US OSPM     sn5      5        M:     [        S5        [        S5        UR                  5        H  u  pÍ[        SU SU S35        M     [        5         [        S[        U5       35        0 nUR                  5        H&  u  p�UR                  U/ 5      R                  U5        M(     UR                  5        VVs0 s H  u  nn[        U5      S:”  d  M  UU_M     nnnU(       ao  [        S5        [        S5        [        S5        [        UR                  5       5       H&  u  nn[        SU SSR                  U5       35        M(     [        5         O[        S5        U(       a  [        X4U5        ggs  snf s  snnf )u*  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   ó*   #   • U  H	  oS    v •  M     g7f)r   Nr4   ©r6   Úps     r   r8   Ú'map_channels_to_grid.<locals>.<genexpr>}  ó   é € Ð3Ò 2˜1�A–$Ò 2ùó   ‚r   c              3   ó*   #   • U  H	  oS    v •  M     g7f)r   Nr4   rŠ   s     r   r8   rŒ   ~  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†   rk   r}   ÚmaxÚvaluesÚnpÚemptyÚobjectÚfillr   Újoinr   Ú
setdefaultÚappendr|   Úwrite_channel_results_to_file)rm   r‡   r   r0   Ú	positionsÚmax_rowÚmax_colÚgridrA   ÚrÚcri   r7   r„   ÚdupÚposr‹   ÚchsÚ
collisionss                      r   Úmap_channels_to_gridr¬   e  s5  € ô" # =Ñ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Ð&¬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ñ ô 
ˆ/ÔÜ	Ð
%Ô&Ø—‘Ö!‰ˆÜ��a�S˜˜A˜3˜aÐ Ö!ñ "ä	„GÜ	Ðœc )›nÐ-Ð
.Ô/ð -/€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   Ã=JÇJÇ-Jc                ó*  • [        XS9n[        S5        [        S5        [        S5        [        S5        [        U5       H  u  pE[        SU SU S35        M     [        S	5        [        S
[        U5       S35        U(       a  [	        U0 U5        gg)u%  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†   r}   Ú	enumerater   r¡   )rm   r‡   r   Úchannel_vectorÚirA   s         r   Úmap_channel_to_vectorr³   ©  s‹   € ô" )¨ÑH€Nä	ˆ/ÔÜ	Ð
$Ô%Ü	ˆ/Ôä	Ð
ÔÜ˜>Ö*‰ˆÜ��b�T˜˜Q˜C˜qÐ!Ö"ñ +ä	ˆ#„JÜ	Ð¤ NÓ 3Ð4°BÐ
7Ô8æÜ% n°b¸+ÕFð r   r±   Úgrid_positionsc           	      ó¨  • [        US5       nUR                  S5        UR                  S5        [        U 5       H?  u  pEUR                  SS5      R                  SS5      nUR                  SU SU S	35        MA     UR                  S	5        UR                  S
[	        U 5       S	35        U(       au  UR                  S	5        UR                  S5        UR                  5        H?  u  pWUR                  SS5      R                  SS5      nUR                  SU SU S	35        MA     UR                  S	5        SSS5        g! , (       d  f       g= f)u!  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)ru   Úwriter°   Úreplacer   r   )r±   r´   r‡   r~   r²   rA   Úmemberr©   s           r   r¡   r¡   Ï  s  € ô  
ˆk˜3Ô	 1Ø	�‰Ð+Ô,Ø	�‰Ð/Ô0Ü˜~Ö.‰EˆAà—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¨Ó-×5Ñ5°c¸3Ó?�Ø—‘˜$˜v˜h c¨#¨¨bÐ1Ö2ñ 2ð 	
�‰�Œ÷! 
 ×	Ö	ús   �D-EÅ
EÚ__main__z7E:\derivatives\SuperHuge\preprocessed\meta\metadata.pklzchannel_enum.pyT)Ú )(Ú__doc__Úcollectionsr   Úosrv   rb   Únumpyrš   Útypingr   r   r   r   r   ÚreÚcompiler;   rz   r   r]   Ú__annotations__Úboolr   r/   r^   rH   rV   r`   rk   r†   r¬   r³   r¡   Ú__name__rm   Úpathrž   ÚdirnameÚ__file__r‡   r4   r   r   Ú<module>rÌ      s�  ðò
õ $Û 	Û Û ã ß 3Õ 3Û 	ð" �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   