Ë
    7™´jª7  ã                  ó~  — 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Zddlm	Z	 ddl
ZddlZddlZddlmZ ej"                  j%                  ej"                  j'                  e«      «      Zej"                  j'                  ej"                  j-                  ed«      «      Z eej"                  j-                  ed«      «      5 Z ej4                  e«      Zddd«       ed   d	   Zej"                  j-                  eed   d
   «      Zej"                  j-                  eed   d   «      Zej"                  j-                  eed   d   «      Zej"                  j-                  ed«      Z ej"                  j-                  ed«      Z!ej"                  j-                  ed«      Z"ej"                  j-                  ed«      Z#e e!e"e#fD ]  Z$ ejJ                  e$d¬«       Œ ed   Z&e&D � cg c]  } | d   ‘Œ	 c} Z'e&D � ci c]  } | d   | “Œ
 c} Z(e&D � ci c]  } | d   | “Œ
 c} Z)e&D � ci c]  } | d   | d   “Œ c} Z*e&D � ci c]  } | d   | d   “Œ c} Z+ed   Z,ed   Z-g d¢Z.e.D �cg c]  }|j_                  «       ‘Œ c}Z0h d£Z1ddhZ2e0D �cg c]  }|e1e2z  vsŒ|‘Œ c}e0D �cg c]	  }|e1vsŒ|‘Œ c}e0D �cg c]	  }|e2vsŒ|‘Œ c}dœZ3d=d„Z4 e	d ¬!«      d>d"„«       Z5d?d#„Z6d@d$„Z7dAd%„Z8dBdCd&„Z9dBdCd'„Z:dDd(„Z; e	d)¬!«      d*„ «       Z< e	d)¬!«      d+„ «       Z= e	d)¬!«      d,„ «       Z>d-„ Z?d.„ Z@e,fdEd/„ZAd0„ ZB	 ddlCZC eCjˆ                  d¬1«      d2„ «       ZEdFd3„ZGd4„ ZHdGd5„ZId6„ ZJej–                  dde-fd7„ZLdHd8„ZMd9„ ZNdIdJd:„ZOd;„ ZPdKd<„ZQy# 1 sw Y   �Œ§xY wc c} w c c} w c c} w c c} w c c} w c c}w c c}w c c}w c c}w # eF$ r dZEY Œww xY w)LzWShared helpers for the full-corpus EDA (config, paths, index, loaders, filters, stats).é    )ÚannotationsN)Ú	lru_cache)Úsignalz..zconfig.yamlÚpathsÚrootÚsuperhuge_rawÚsuperhuge_preÚcndÚfiguresÚtablesÚcacheÚlogsT)Úexist_okÚdatasetsÚkeyÚsh_nameÚcolorÚlabelÚfs_rawÚseed)@ÚFp1ÚAF7ÚAF3ÚF1ÚF3ÚF5ÚF7ÚFT7ÚFC5ÚFC3ÚFC1ÚC1ÚC3ÚC5ÚT7ÚTP7ÚCP5ÚCP3ÚCP1ÚP1ÚP3ÚP5ÚP7ÚP9ÚPO7ÚPO3ÚO1ÚIzÚOzÚPOzÚPzÚCPzÚFpzÚFp2ÚAF8ÚAF4ÚAFzÚFzÚF2ÚF4ÚF6ÚF8ÚFT8ÚFC6ÚFC4ÚFC2ÚFCzÚCzÚC2ÚC4ÚC6ÚT8ÚTP8ÚCP6ÚCP4ÚCP2ÚP2ÚP4ÚP6ÚP8ÚP10ÚPO8ÚPO4ÚO2>   ÚIZr.   r   r9   ÚAFZrS   rX   ÚFCZ)Úcommon57Ú	b64ustc58Úb64uhd62c                óò  — t        j                  | «      }|j                  sÕ|j                  t         j                  «       t        j
                  d«      }t        j                  t        j                  j                  t        | › d�«      «      }|j                  |«       t        j                  t        j                  «      }|j                  |«       |j                  |«       |j                  |«       |S )Nz.%(asctime)s %(name)s %(levelname)s %(message)sz.log)ÚloggingÚ	getLoggerÚhandlersÚsetLevelÚINFOÚ	FormatterÚFileHandlerÚosÚpathÚjoinÚLOGSÚsetFormatterÚStreamHandlerÚsysÚstdoutÚ
addHandler)ÚnameÚlgÚfmtÚfhÚshs        ú[/root/disk_3tb/EEG-sAAD-Grand-Challenge-Training-Dataset/reports/eda_full/scripts/common.pyÚ
get_loggerrt   8   s¨   € Ü	×	Ñ	˜4Ó	 €BØ�;Š;Ø
�‰”G—L‘LÔ!Ü×ÑÐ PÓQˆÜ× Ñ ¤§¡§¡¬d°t°f¸D°MÓ!BÓCˆØ
�‰˜ÔÜ×"Ñ"¤3§:¡:Ó.ˆØ
�‰˜ÔØ
�‰�bÔØ
�‰�bÔØ€Ió    é   )Úmaxsizec                 óš  — t         j                  j                  t        d«      } t         j                  j	                  | «      rt        j                  | «      S t        j                  t        t         j                  j                  t        dd«      d«      «      }g }|j                  «       D ]ß  \  }}t        j                  |d   «      }|€Œ!t        |d   j                  «       «      D ��cg c]
  \  }}|d   ‘Œ }}}|j                  t!        ||d   |d	   t#        |d
   «      t#        |d   «      t#        |d   «      t#        |d   «      t#        |d   «      t%        |j                  dd«      «      dj                  |«      ¬«
      «       Œá t        j&                  |«      }	t        j(                  |	d   t*        d¬«      |	d<   |	j-                  g d¢«      j/                  d¬«      }	|	d   j1                  t$        «      dz   |	d   j3                  dj4                  «      z   |	d<   |	d   |	d   z  |	d<   |	j7                  | «       |	S c c}}w )zBOne row per SuperHuge raw trial with channel names and file paths.ztrial_index.parquetÚmetazmetadata.pklÚrbÚdataset_nameÚchannel_infosrn   r   Ú
dataset_idÚ
subject_idÚtrial_idÚsignal_lengthÚnum_channelÚfsr   Ú Ú|)
r   ÚdsÚdidÚsubjectÚtrialÚnÚnchr‚   r   Úchannelsr…   T)Úordered)r…   r‡   rˆ   )ÚdropÚ-r‡   z{:02d}Úsubj_uidr‰   Údur_s)re   rf   rg   ÚTABÚexistsÚpdÚread_parquetÚpickleÚloadÚopenÚSH_RAWÚitemsÚDS_BY_SHÚgetÚsortedÚappendÚdictÚintÚstrÚ	DataFrameÚCategoricalÚDS_KEYSÚsort_valuesÚreset_indexÚastypeÚmapÚformatÚ
to_parquet)
Úpry   Úrowsr   ÚrÚdÚ_ÚvÚnamesÚdfs
             rs   Útrial_indexr²   I   sè  € ô 	�‰�‰”SÐ/Ó0€AÜ	‡w�w‡~�~�aÔÜ�‰˜qÓ!Ð!Ü�;‰;”tœBŸG™GŸL™L¬°¸ÓHÈ$ÓOÓP€DØ€DØ—*‘*–,‰ˆˆQÜ�L‰L˜˜>Ñ*Ó+ˆØˆ9ØÜ'-¨a°Ñ.@×.FÑ.FÓ.HÔ'IÔJÑ'I™t˜q !��6“Ð'IˆÑJØ�‰”D˜S Q u¡X°1°\±?ÌCÐPQÐR^ÑP_ÓL`Ü" 1 Z¡=Ó1´S¸¸?Ñ9KÓ5LÔRUÐVWÐXeÑVfÓRgÜ  $¡›L´°A·E±E¸'À2Ó4FÓ0GØ"%§(¡(¨5£/ô3õ 	4ð ô 
�‰�dÓ	€BÜ�~‰~˜b ™h¬¸Ô>€B€t�HØ	�‰Ò2Ó	3×	?Ñ	?ÀTÐ	?Ó	J€BØ˜‘X—_‘_¤SÓ)¨CÑ/°"°Y±-×2CÑ2CÀHÇOÁOÓ2TÑT€B€z�NØ�S‘'˜B˜t™HÑ$€B€w�KØ‡M�M�!ÔØ€Iùó Ks   Ã-Ic                ó*   — | d   j                  d«      S )Nr‹   r„   )Úsplit)Úrows    rs   Úchannel_namesr¶   c   s   € Øˆz‰?× Ñ  Ó%Ð%ru   c                ó  — t        | «      D �cg c]  }|j                  «       ‘Œ }}t        |«      D ��ci c]  \  }}||“Œ
 }}}t        j                  t
        |   D �cg c]  }||   ‘Œ	 c}«      S c c}w c c}}w c c}w )z`Column indices (into this trial's raw EEG) of the montage channels, matched by upper-cased name.)r¶   ÚupperÚ	enumerateÚnpÚarrayÚMONTAGES)rµ   ÚmontageÚcÚupÚiÚposs         rs   Úmontage_idxrÂ   g   sw   € ä*¨3Ô/Ó	0Ñ/˜ˆ!�'‰'�)Ð/€BÐ	0Ü% bœMÔ
*™M‘D�A�qˆ1ˆa‰4˜M€CÑ
*Ü�8‰8¤X¨gÒ%6Ó7Ñ%6 �S˜“VÐ%6Ñ7Ó8Ð8ùò 
1ùÛ
*ùÚ7s   ŽA2µA7ÁA=c           	     ó&  — t        | «      D �cg c]  }|j                  «       ‘Œ }}t        |«      D ��ci c]  \  }}||“Œ
 }}}t        j                  t
        D �cg c]  }|j                  |d«      ‘Œ c}«      }||dk\  fS c c}w c c}}w c c}w )z<(source column or -1, present mask) for the 64 B64 channels.éÿÿÿÿr   )r¶   r¸   r¹   rº   r»   ÚB64Ur›   )rµ   r¾   r¿   rÀ   rÁ   Úsrcs         rs   Úb64_idxrÇ   n   sƒ   € ä*¨3Ô/Ó	0Ñ/˜ˆ!�'‰'�)Ð/€BÐ	0Ü% bœMÔ
*™M‘D�A�qˆ1ˆa‰4˜M€CÑ
*Ü
�(‰(­DÓ1©D q�C—G‘G˜A˜r•N¨DÑ1Ó
2€CØ��q‘ˆ=Ðùò 
1ùÛ
*ùÚ1s   ŽBµBÁBc                ó–   — |dk(  rt         nt        }t        j                  t        j
                  j                  |d| › d�«      d¬«      S )NÚrawÚeegz.npyr¬   ©Ú	mmap_mode)r˜   ÚSH_PRErº   r–   re   rf   rg   )r   ÚstageÚbases      rs   Úload_eegrÐ   y   s7   € Ø˜e’^�6¬€DÜ�7‰7”2—7‘7—<‘<  e°¨u°D¨\Ó:ÀcÔJÐJru   c           	     óÖ   — |dk(  rt         nt        }t        j                  t        j
                  j                  |dd| › d�«      d¬«      }t        j                  |dd…ddd…f   «      S )	zC(T, 2): column 0 = majority-attended stream (converter convention).rÉ   ÚstimuliÚenvz_env.npyr¬   rË   Nr   )r˜   rÍ   rº   r–   re   rf   rg   Úasarray)r   rÎ   rÏ   Úes       rs   Úload_envrÖ   ~   sS   € à˜e’^�6¬€DÜ
�‰”—‘—‘˜T 9¨e¸°u¸HÐ5EÓFÐRUÔV€AÜ�:‰:�aš˜1ša˜‘jÓ!Ð!ru   c           
     óŽ   — t        t        j                  t        j                  j                  t        d| › d�«      d¬«      «      S )zGPer-sample CND ground truth for one trial (built by b1_cnd_extract.py).r
   ú.npzT)Úallow_pickle)rž   rº   r–   re   rf   rg   ÚCACHE)r   s    rs   Úload_labelsrÛ   …   s/   € ä”—‘œŸ™Ÿ™¤U¨E°c°U¸$°<Ó@ÈtÔTÓUÐUru   é@   c                ó6   — t        j                  || d|d¬«      S )NÚhighpassÚsos©r‚   Úoutput©r   Úbutter©ÚfcÚorderr‚   s      rs   Úsos_hprç   �   s   € ä�=‰=˜  J°2¸eÔDÐDru   c                ó6   — t        j                  || d|d¬«      S )NÚlowpassrß   rà   râ   rä   s      rs   Úsos_lprê   ’   s   € ä�=‰=˜  I°"¸UÔCÐCru   c                ó:   — t        j                  || |gd|d¬«      S )NÚbandpassrß   rà   râ   )ÚloÚhiræ   r‚   s       rs   Úsos_bprï   —   s   € ä�=‰=˜  R ¨*¸ÀEÔJÐJru   c                óÊ   — t        j                  | «      }|j                  dk(  r|dd…dd…df   |d   dddd…f   z  n||d   z  }t        j                  | |d|¬«      \  }}|S )zQCausal sosfilt along axis 0, initialised to the steady state of the first sample.é   Nr   )ÚaxisÚzi)r   Ú
sosfilt_ziÚndimÚsosfilt)rß   Úxró   Úyr®   s        rs   Úcfiltrù   œ   sf   € ä	×	Ñ	˜3Ó	€BØ12·±¸1²ˆŠAŠq�$ˆJ‰˜!˜A™$˜t Tª1˜}Ñ-Ò	-À"ÀqÈÁtÁ)€BÜ�>‰>˜#˜q q¨RÔ0�D€A€qØ€Hru   c                ó2   — t        j                  | |d¬«      S )Nr   ©rò   )r   Úsosfiltfilt)rß   r÷   s     rs   Úzfiltrý   ¤   s   € Ü×Ñ˜c 1¨1Ô-Ð-ru   c                ó0  — t         d   }t        j                  | t        j                  ¬«      } |j	                  d«      rt
        nt        }|dv rm |t        |d   |d   |«      | «      } |t        |d   d   |d   d	   |d
   |«      |«      } |t        |d   |d   |«      |«      }||d   z  }|dd|…   |d   fS |dv rL |t        |d   d   |d   |«      | «      } |t        |d   |d   |«      |«      }||d   z  }|dd|…   |d   fS t        |«      ‚)a  Apply the per-channel LTI part of a pipeline variant and decimate.

    Returns (y, fs_out). CAR is NOT applied here: it commutes with these per-channel LTI
    filters (including the linear sosfilt_zi initialisation), so it is applied later per montage.
    Úpipeline©Údtyper¾   )Úc19Úz19Úhp_hzÚhp_orderÚbp_hzr   rv   Úbp_orderÚaa_hzÚaa_orderÚfs_outN)ÚcwideÚzwideÚ
wide_bp_hzÚ
aa_hz_wideÚfs_out_wide)ÚCFGrº   rÔ   Úfloat64Ú
startswithrù   rý   rç   rï   rê   Ú
ValueError)r÷   Úvariantr‚   ÚPÚfrø   Úqs          rs   Úfilter_chainr  ¨   sA  € ô 	ˆJ‰€AÜ
�
‰
�1œBŸJ™JÔ'€AØ×#Ñ# CÔ(�¬e€AØ�.Ñ ÙŒf�Q�w‘Z  :¡°Ó3°QÓ7ˆÙŒf�Q�w‘Z ‘] A g¡J¨q¡M°1°Z±=À"ÓEÀqÓIˆÙŒf�Q�w‘Z  :¡°Ó3°QÓ7ˆØ�!�H‘+ÑˆØ‘�1�‰v�q˜‘{Ð"Ð"ØÐ$Ñ$ÙŒf�Q�|‘_ QÑ'¨¨:©¸Ó;¸QÓ?ˆÙŒf�Q�|‘_ a¨
¡m°RÓ8¸!Ó<ˆØ�!�MÑ"Ñ"ˆØ‘�1�‰v�q˜Ñ'Ð'Ð'Ü
�WÓ
Ðru   c                óü  — | j                   \  }}t        j                  | «      }| d | j                  d«      j	                  «       }dt        j
                  | d | |z
  «      j                  d«      z  dz   }t        |«      D ]w  }	| |	   |z
  |z  }
t        j                  |
| |«      }
|
||	<   ||
|z  z   }||||z
  z  z   }||dt        j
                  ||z
  «      z  |z
  z  z   }t        j                  |d«      }Œy |S )Nr   ç“:M„ô?çê-�™—q=)	Úshaperº   Ú
empty_likeÚmeanÚcopyÚabsÚrangeÚclipÚmaximum)r÷   Úalphar"  Ún_initÚTÚCÚoutÚmÚsÚtÚzÚxvs               rs   Ú_runz_pyr.  ¿   sÿ   € Ø�7‰7�D€A€qÜ
�-‰-˜Ó
€CØ	ˆ'ˆ6ˆ
�‰˜Ó×ÑÓ!€AØ”—‘˜˜'˜6˜
 Q™Ó'×,Ñ,¨QÓ/Ñ/°%Ñ7€AÜ�1ŽXˆØˆq‰T�A‰X˜‰NˆÜ�G‰G�A˜�u˜dÓ#ˆØˆˆA‰Ø��Q‘‰YˆØ�˜˜a™Ñ Ñ ˆØ�˜¤"§&¡&¨¨a©£.Ñ0°1Ñ4Ñ5Ñ5ˆÜ�J‰J�q˜%Ó ‰ð ð €Jru   )r   c                óÆ  — | j                   \  }}t        j                  | «      }t        j                  |«      }t        j                  |«      }t	        |«      D ]_  }	d}
t	        |«      D ]  }|
| ||	f   z  }
Œ |
|z  ||	<   d}
t	        |«      D ]  }|
t        | ||	f   ||	   z
  «      z  }
Œ d|
z  |z  dz   ||	<   Œa t	        |«      D ]—  }t	        |«      D ]‡  }	| ||	f   ||	   z
  ||	   z  }||kD  r|}n	|| k  r| }||||	f<   ||	   |||	   z  z   }||	xx   ||||	   z
  z  z  cc<   ||	xx   |dt        |||	   z
  «      z  ||	   z
  z  z  cc<   ||	   dk  sŒƒd||	<   Œ‰ Œ™ |S )Nç        r  r  )r  rº   r  Úzerosr!  r   )r÷   r$  r"  r%  r&  r'  r(  r)  r*  r¾   Úaccr+  r,  r-  s                 rs   Ú_runz_nbr3  Ò   sœ  € à�w‰w‰ˆˆ1Ü�m‰m˜AÓˆÜ�H‰H�Q‹KˆÜ�H‰H�Q‹KˆÜ�q–ˆAØˆCÜ˜6–]�Ø�q˜˜A˜‘w‘‘ð #à˜‘<ˆAˆa‰DØˆCÜ˜6–]�Ø”s˜1˜Q ˜T™7 Q q¡T™>Ó*Ñ*‘ð #à˜C‘< &Ñ(¨5Ñ0ˆAˆaŠDð ô �q–ˆAÜ˜1–X�Ø�q˜!�t‘W˜q ™t‘^ q¨¡tÑ+�Ø�t’8Ø‘AØ˜$˜’YØ˜�AØ��A�q�D‘	Ø�q‘T˜A  !¡™H‘_�Ø�!“˜  a¨¡d¡Ñ+Ñ+“Ø�!“˜ ¬#¨b°1°Q±4©i«.Ñ!8¸1¸Q¹4Ñ!?Ñ@Ñ@“Ø�Q‘4˜%“<Ø �A�a’Dñ ð ð ˆ
ru   c                ó   — t         d   }|€|d   n|}|€|d   n|}|€t        t        |d   |z  «      «      n|}t        j                  t        j
                  | t        j                  ¬«      «      } | j                  dk(  }|r	| dd…df   } d||z  z  }t        �t        nt        } || |t        |«      t        |«      «      }	|r	|	dd…d	f   S |	S )
a[  Causal running robust z-score per column (EW mean + EW mean-absolute-deviation*1.2533).

    Output at t uses statistics from samples < t only (plus an initial estimate from the first
    n_init samples, which lie inside the trimmed warm-up second). Updates use the winsorised
    (clipped) value so single artefacts cannot blow the scale up.
    rÿ   NÚ
runz_tau_sÚ	runz_clipÚedge_trim_sr   rv   g      ð?r   )r  rŸ   Úroundrº   ÚascontiguousarrayrÔ   r  rõ   r3  r.  Úfloat)
r÷   r‚   Útau_sr"  r%  r  Úsqueezer$  r  rø   s
             rs   Ú	running_zr=  ó   sÍ   € ô 	ˆJ‰€AØ$˜}ˆAˆlŠO°%€EØ!˜\ˆ1ˆ[Š>¨t€DØ28°.ŒS”�q˜Ñ'¨"Ñ,Ó-Ô.Àf€FÜ
×ÑœRŸZ™Z¨´·±Ô<Ó=€AØ�f‰f˜‰k€GÙØŠa�ˆg‰JˆØ�5˜2‘:Ñ€EÜÐ(�¬h€AÙ	ˆ!ˆU”E˜$“K¤ V£Ó-€AÙˆ1ŠQ�ˆT‰7Ð$ 1Ð$ru   c                ó.   — | | j                  dd¬«      z
  S )Nrv   T©Úkeepdims)r  )r÷   s    rs   ÚcarrA    s   € Øˆq�v‰v�a $ˆvÓ'Ñ'Ð'ru   c           	     óò  — | d   }t         |   }t        j                  |D �cg c]  }t        j	                  |«      ‘Œ c}«      }	|dk(  r t        |d«      }
t        | «      \  }}t        j                  |
j                  d   df«      }t        j                  |
dd…||   f   t        j                  ¬«      |dd…|f<   t        |d«      j                  t        j                  «      }d}n®t        j                  t        j                  j!                  t"        d	||› d
�«      «      }|d   j                  t        j                  «      |d   j                  t        j                  «      |d   }}}|j%                  d«      rt&        d   d   nt&        d   d   }|dd…|	f   }||	   }|r+|dd…|f   |dd…|f   j)                  dd¬«      z
  |dd…|f<   |r"t+        ||«      }d|dd…| f<   t+        ||«      }t-        |«      }t.        |z  }|d   dd|…   dt1        |«       }|d   dd|…   dt1        |«       }t3        t1        |«      t1        |«      t1        |«      «      }|d| |d| |d| |d| f\  }}}}d}|rIt5        t7        t&        d   d   |z  «      «      }||||z
   ||||z
   ||||z
   ||||z
   f\  }}}}||z  }t9        ||||j                  t        j:                  «      |||¬«      S c c}w )a›  EEG + envelopes for one trial after a pipeline variant, per montage.

    variant: c19 | z19 | cwide (cache/pp) or 'sup' (supplied 32 Hz preprocessed data).
    Returns dict(eeg (T,C), env (T,2), fs, att_col (T,) int8 per-sample attended column,
    az (T,) attended azimuth, t0_s (time of first returned sample in the trial)).
    Montage channels a dataset lacks are zero columns (excluded from the CAR).
    r   ÚsupÚprer   rÜ   Nr   é    ÚpprØ   rÊ   rÓ   ÚpresentÚwiderÿ   r  r
  rv   Tr?  r0  Úatt_colÚatt_azr7  )rÊ   rÓ   r‚   rI  ÚazÚt0_srG  )r¼   rº   r»   rÅ   ÚindexrÐ   rÇ   r1  r  rÔ   r  rÖ   r¦   r–   re   rf   rg   rÚ   Úendswithr  r  r=  rÛ   ÚFSÚlenÚminrŸ   r8  rž   Úint8)rµ   r  r½   Údo_carÚdo_runzÚdo_trimr   Úmontr¾   ÚselrÉ   rÆ   rG  r÷   rÓ   r‚   r,  ÚpresÚlabr  ÚattrK  r‰   Út0Úks                            rs   Úload_ppr]    sä  € ð ˆe‰*€CÜ�GÑ€DÜ
�(‰(©4Ó0©4 a”D—J‘J˜q•M¨4Ñ0Ó
1€CØ�%ÒÜ�s˜EÓ"ˆÜ˜s“|‰ˆˆWÜ�H‰H�c—i‘i ‘l BÐ'Ó(ˆÜŸ
™
 3¢q¨#¨g©, Ñ#7¼r¿z¹zÔJˆŠ!ˆWˆ*‰Ü�s˜EÓ"×)Ñ)¬"¯*©*Ó5ˆØ‰ä�G‰G”B—G‘G—L‘L¤¨¨g¸#¸¸d°|ÓDÓEˆØ˜E™(Ÿ/™/¬"¯*©*Ó5°q¸±x·±ÄrÇzÁzÓ7RÐTUÐV_ÑT`�ˆ3ˆØ/6×/?Ñ/?ÀÔ/GŒS�‰_˜]Ò+ÌSÐQ[É_Ð]eÑMfˆØ	Š!ˆSˆ&‰	€AØ�3‰<€DÙØ’q˜$�w‘Z !¢A t G¡*§/¡/°!¸d /Ó"CÑCˆŠ!ˆTˆ'‰
ÙÜ�a˜ÓˆØˆŠ!ˆdˆUˆ(‰Ü˜˜RÓ ˆÜ
�cÓ
€CÜ
ˆb‰€AØ
ˆi‰.™˜1˜Ñ
˜h¤ A£Ð
'€CØ	ˆX‰‘s˜�sÑ	˜Hœc !›fÐ	%€BÜŒC�‹F”C˜“Hœc #›hÓ'€AØ˜˜�e˜S  !˜W c¨"¨1 g¨r°"°1¨vÐ5�O€A€sˆC�Ø	€BÙÜ””c˜*‘o mÑ4°rÑ9Ó:Ó;ˆØ˜A˜a !™e˜* c¨!¨A°©E l°C¸¸!¸a¹%°LÀ"ÀQÀqÈ1ÁuÀ+ÐM‰ˆˆ3��RØ�‰VˆÜ�A˜3 2¨s¯z©z¼"¿'¹'Ó/BÀrÐPRÐ\`ÔaÐaùò? 1s   ¢K4c                óf   — t        t        t        d   d   |z  «      «      }| |t        | «      |z
   S )Nrÿ   r7  )rŸ   r8  r  rP  )r÷   r‚   r\  s      rs   Útrimr_  8  s3   € ÜŒE”#�j‘/ -Ñ0°2Ñ5Ó6Ó7€AØˆQŒs�1‹v˜‰zˆ?Ðru   c           	     óð  — t        j                  | t        «      } | t        j                  | «         } t	        | «      dk(  r/t         j
                  t         j
                  t         j
                  fS |€t        d   d   n|}|€t        d   d   n|}t         j                  j                  |«      }|j                  dt	        | «      |t	        | «      f«      }|t         j                  t         j                  fvrt        j                  |d| |   «      n || |   d¬«      }d|z
  dz  }t         || «      «      t        t        j                  ||«      «      t        t        j                  |d|z
  «      «      fS )Nr   ÚstatsÚn_bootÚcirv   rû   rñ   )rº   rÔ   r:  ÚisfiniterP  Únanr  ÚrandomÚdefault_rngÚintegersÚmedianr  Úapply_along_axisÚquantile)	r¯   Ústatr‰   rc  r   ÚrngÚidxÚbÚas	            rs   Úboot_cirq  @  s&  € Ü
�
‰
�1”eÓ€AØ	Œ"�+‰+�a‹.Ñ€AÜ
ˆ1ƒv�‚{Ü—‘œŸ™¤§¡Ð'Ð'Ø"# )ŒˆG‰�XÒ°€AØ!˜zŒˆW‰�dÒ	¨r€BÜ
�)‰)×
Ñ
 Ó
%€CØ
�,‰,�qœ#˜a›& 1¤c¨!£f +Ó
.€CØ04¼R¿Y¹YÌÏÉÐ<PÑ0PŒ×Ñ˜D ! Q s¡VÔ,ÑVZÐ[\Ð]`Ñ[aÐhiÔVj€AØ	
ˆR‰�1‰€AÜ‘$�q“'‹NœE¤"§+¡+¨a°Ó"3Ó4´e¼B¿K¹KÈÈ1ÈqÉ5Ó<QÓ6RÐSÐSru   c                óH   — | d   d|› d�›d| d   d|› d�›d| d   d|› d�›d�S )	Nr   Ú.r  z [rv   z, rñ   Ú]© )r+  Únds     rs   Úfmt_cirw  N  sE   € Ø�‰d�1�R�D˜�'ˆ]˜"˜Q˜q™T ! B 4 q ˜M¨¨A¨a©D°°2°$°a°¨=¸Ð:Ð:ru   c                óp  — t        j                  | t        «      } t        | «      }t        j                  | «      }| |   |z  t        j
                  d|dz   «      z  }t         j                  j                  |d d d…   «      d d d…   }t        j                  |«      }t        j                  |d«      ||<   |S )Nrv   rÄ   )	rº   rÔ   r:  rP  ÚargsortÚarangeÚminimumÚ
accumulateÚempty)rª   r‰   Úor¬   r  s        rs   Úfdr_bhr  R  s”   € Ü
�
‰
�1”eÓ€AÜˆA‹€AÜ
�
‰
�1‹€AØ	ˆ!‰ˆq‰”2—9‘9˜Q  A¡Ó&Ñ&€AÜ
�
‰
×Ñ˜a¡ " ™gÓ&¡t¨ tÑ,€AÜ
�‰�‹€AÜ�:‰:�a˜Ó€A€a�DØ€Hru   c                ó  — dd l m} | j                  t        j                  j                  t        |› d�«      dd¬«       |j                  | «       |�9|j                  t        j                  j                  t        |› d�«      d¬«       y y )	Nr   z.pngé–   Útight)ÚdpiÚbbox_inchesz.csvF)rM  )	Úmatplotlib.pyplotÚpyplotÚsavefigre   rf   rg   ÚFIGÚcloseÚto_csv)Úfigrn   r±   Úplts       rs   r‡  r‡  ]  sf   € Ý#Ø‡K�K”—‘—‘œS T F¨$ -Ó0°cÀw€KÔOØ‡I�Iˆc„NØ	€~Ø
�	‰	”"—'‘'—,‘,œs t f¨D MÓ2¸%ˆ	Õ@ð ru   c                 ó6   ‡ — t        j                   «       Š ˆ fd„S )Nc                 ó2   •— t        j                   «       ‰ z
  S ©N©Útime©r[  s   €rs   Ú<lambda>ztimer.<locals>.<lambda>g  s   ø€ ”4—9‘9“; Ò#ru   r�  r’  s   @rs   Útimerr”  e  s   ø€ Ü	�‰‹€BÛ#Ð#ru   c
                óÄ  — ddl m}
 ddlm} t	        j
                  dd|	«      }t	        j                  ||«      \  }} |t        j                  ||f   |||fd¬«      }t        j                  |t	        j                  ||«      dkD  <   | j                  |||d	|||t	        j
                  |�|nt	        j                  |«      |�|nt	        j                  |«      d
«      ¬«      }| j                  ||dd¬«       t	        j
                  ddt        j                  z  d«      }| j                  dt	        j                   |«      z  dt	        j"                  |«      z  dd¬«       | j                  g d¢g d¢dd¬«       |�+t%        |||«      D ]  \  }}}| j'                  |||d¬«       Œ | j)                  d«       | j+                  d«       |r|
j-                  || d¬«       |S )zXMinimal topographic map (linear interpolation inside the electrode hull + head outline).r   N)Úgriddatagš™™™™™á¿gš™™™™™á?Úcubic)Úmethodg      à?é   é   )ÚcmapÚvminÚvmaxÚlevelsé   r\  )r*  r¾   rñ   éÈ   rv   )Úlw)gš™™™™™©¿r   gš™™™™™©?)ç®Gáz®ß?gìQ¸…ëá?r¢  é   )ÚfontsizeÚequalÚoffg{®Gáz¤?)ÚaxÚfraction)r…  r†  Úscipy.interpolater–  rº   ÚlinspaceÚmeshgridÚc_re  ÚhypotÚcontourfÚnanminÚnanmaxÚscatterÚpiÚplotÚcosÚsinÚzipÚtextÚ
set_aspectrò   Úcolorbar)r§  r÷   rø   r¯   r›  rœ  r�  r°   ÚcbarÚresrŒ  r–  ÚxiÚXÚYÚZÚimr+  ÚxxÚyyÚnns                        rs   ÚtoporÄ  j  s˜  € å#Ý*Ü	�‰�U˜D #Ó	&€BÜ�;‰;�r˜2Ó�D€A€qÙ”—‘�q˜!�t‘˜a ! Q °Ô8€AÜ Ÿf™f€A„b‡h�hˆq�!ƒn�sÑÑØ	�‰�Q˜˜1˜b t°$¸TÜŸK™K°Ð0@©ÄbÇiÁiÐPQÃlØ04Ð0@©ÄbÇiÁiÐPQÃlÐTVóXð 
ó 
Y€Bð ‡J�Jˆq�!�q˜C€JÔ Ü
�‰�A�qœ2Ÿ5™5‘y #Ó&€AØ‡G�GˆC”"—&‘&˜“)‰O˜S¤2§6¡6¨!£9™_¨c°a€GÔ8Ø‡G�GÒÒ2°C¸A€GÔ>ØÐÜ˜a  EÖ*‰JˆB��BØ�G‰G�B˜˜B¨ˆGÕ+ð +à‡M�M�'ÔØ‡G�GˆE„NÙØ�‰�R˜B¨ˆÔ.Ø€Iru   )rn   r    Úreturnzlogging.Logger)rÅ  zpd.DataFrame)rÅ  z	list[str])r½   r    rÅ  ú
np.ndarray)rÅ  ztuple[np.ndarray, np.ndarray])rÉ   )r   r    rÎ   r    rÅ  rÆ  )r   r    rÅ  rž   )r  r    r‚   rŸ   )NNN)r  rZ   TTT)rŸ  r�  )r±   zpd.DataFrame | None)ÚRdBu_rNNNTrÜ   )RÚ__doc__Ú
__future__r   r^   re   r•   rk   r‘  Ú	functoolsr   Únumpyrº   Úpandasr“   ÚyamlÚscipyr   rf   ÚdirnameÚabspathÚ__file__ÚHERErg   ÚOUTr—   rq   Ú	safe_loadr  ÚROOTr˜   rÍ   ÚCNDrˆ  r‘   rÚ   rh   Ú_dÚmakedirsÚDSr£   Ú	DS_BY_KEYrš   ÚCOLORSÚLABELSrO  ÚSEEDÚB64r¸   rÅ   Ú_MISSING_USTCÚ_MISSING_UHDr¼   rt   r²   r¶   rÂ   rÇ   rÐ   rÖ   rÛ   rç   rê   rï   rù   rý   r  r.  ÚnumbaÚnjitr3  Ú	Exceptionr=  rA  r]  r_  ri  rq  rw  r  r‡  r”  rÄ  )r­   r¾   s   00rs   Ú<module>rä     sý  ðÙ ]Ý "ã Û 	Û Û 
Û Ý ã Û Û Ý à	‡w�w‡��r—w‘w—‘ xÓ0Ó1€Ø‡g�g‡o�o�b—g‘g—l‘l 4¨Ó.Ó/€Ù	ˆ"�'‰'�,‰,�s˜MÓ
*Ô+¨rØ
ˆ$�.‰.˜Ó
€C÷ ,à
ˆ7�|�FÑ€Ø	�‰�‰�d˜C ™L¨Ñ9Ó	:€Ø	�‰�‰�d˜C ™L¨Ñ9Ó	:€Ø‡g�g‡l�l�4˜˜W™ eÑ,Ó-€Ø‡g�g‡l�l�3˜	Ó"€Ø‡g�g‡l�l�3˜Ó!€Ø
�‰�‰�S˜'Ó"€Ø	‡w�w‡|�|�C˜Ó €Ø��U˜DÓ
!€BØ€B‡K�K�˜TÖ"ð "ð 	ˆ�_€ÙÓ
 ™R˜ˆ1ˆU‹8˜RÑ
 €Ù"$Ó%¡"˜QˆQˆu‰X�q‰[ "Ñ%€	Ù%'Ó(¡R ˆAˆi‰L˜!‰O RÑ(€Ù(*Ó	+© 1ˆ!ˆE‰(�A�g‘JÑ
¨Ñ	+€Ù(*Ó	+© 1ˆ!ˆE‰(�A�g‘JÑ
¨Ñ	+€Øˆ�]€Ø
ˆ6�{€ò:€ñ
 Ó™3�aˆ�‰�	˜3Ñ€Ú8€Ø�uˆ~€ñ !ÓJ™D�q A¨]¸\Ñ-IÒ$I’˜DÑJÙ!Ó<™T˜ Q¨mÒ%;’!˜TÑ<Ù Ó:™D�q A¨\Ò$9’˜DÑ:ñ	€óñ" �1Ôòó ðó2&ó9óôKô
"óVñ �2ÔñEó ðEñ �2ÔñDó ðDñ �2ÔñKó ðKòò.ð -/ô ò.ð !Ûà€U‡Z�Z�dÔñó ðó@%ò*(ó)bòXð —I‘I ¨$°Tó Tó;òôAò$ô
÷q
 ,Ñ+üò !ùÚ%ùÚ(ùÚ	+ùÚ	+ùò  ùò
 KùÚ<ùÚ:øðv ò Ø‚Hðúsf   Ã M8Ç!NÇ4N
ÈNÈNÈ3NÉNÉ>N#ÊN#Ê	N(ÊN(Ê)	N-Ê3N-Ì'N2 Í8NÎ2N<Î;N<