ó
    7™´jª7  ã                  óÆ  • 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rSSKJ	r	  SSK
rSSKrSSKrSSKJr  \R"                  R%                  \R"                  R'                  \5      5      r\R"                  R'                  \R"                  R-                  \S5      5      r\" \R"                  R-                  \S5      5       r\R4                  " \5      rSSS5        \S   S	   r\R"                  R-                  \\S   S
   5      r\R"                  R-                  \\S   S   5      r\R"                  R-                  \\S   S   5      r\R"                  R-                  \S5      r \R"                  R-                  \S5      r!\R"                  R-                  \S5      r"\R"                  R-                  \S5      r#\ \!\"\#4 H  r$\RJ                  " \$SS9  M     \S   r&\& V s/ s H  o S   PM	     sn r'\& V s0 s H  o S   U _M
     sn r(\& V s0 s H  o S   U _M
     sn r)\& V s0 s H  o S   U S   _M     sn r*\& V s0 s H  o S   U S   _M     sn r+\S   r,\S   r-/ SQr.\. Vs/ s H  oR_                  5       PM     snr01 Skr1SS1r2\0 Vs/ s H  o\1\2-  ;  d  M  UPM     sn\0 Vs/ s H  o\1;  d  M
  UPM     sn\0 Vs/ s H  o\2;  d  M
  UPM     snS.r3S=S jr4\	" S S!9S>S" j5       r5S?S# jr6S@S$ jr7SAS% jr8SBSCS& jjr9SBSCS' jjr:SDS( jr;\	" S)S!9S* 5       r<\	" S)S!9S+ 5       r=\	" S)S!9S, 5       r>S- r?S. r@\,4SES/ jjrAS0 rB SSKCrC\CRˆ                  " SS19S2 5       rESFS3 jrGS4 rHSGS5 jrIS6 rJ\R–                  SS\-4S7 jrLSHS8 jrMS9 rNSISJS: jjrOS; rPSKS< jrQg! , (       d  f       GNÊ= fs  sn f s  sn f s  sn f s  sn f s  sn f s  snf s  snf s  snf s  snf ! \F a    SrE N„f = f)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                ó  • [         R                  " U 5      nUR                  (       dØ  UR                  [         R                  5        [         R
                  " S5      n[         R                  " [        R                  R                  [        U  S35      5      nUR                  U5        [         R                  " [        R                  5      nUR                  U5        UR                  U5        UR                  U5        U$ )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                 ó¢  • [         R                  R                  [        S5      n [         R                  R	                  U 5      (       a  [
        R                  " U 5      $ [        R                  " [        [         R                  R                  [        SS5      S5      5      n/ nUR                  5        Hß  u  p4[        R                  US   5      nUc  M"  [        US   R                  5       5       VVs/ s H
  u  pgUS   PM     nnnUR                  [!        X5S   US	   [#        US
   5      [#        US   5      [#        US   5      [#        US   5      [#        US   5      [%        UR                  SS5      5      SR                  U5      S9
5        Má     [
        R&                  " U5      n	[
        R(                  " U	S   [*        SS9U	S'   U	R-                  / SQ5      R/                  SS9n	U	S   R1                  [$        5      S-   U	S   R3                  SR4                  5      -   U	S'   U	S   U	S   -  U	S'   U	R7                  U 5        U	$ s  snnf )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Ø—*‘*–,‰ˆÜ�L‰L˜˜>Ñ*Ó+ˆØ‰9ÙÜ'-¨a°Ñ.@×.FÑ.FÓ.HÔ'IÔJÒ'I™t˜q��6”Ñ'IˆÑJØ�‰”D˜S 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   Ã5Ic                ó*   • U S   R                  S5      $ )Nr‹   r„   )Úsplit)Úrows    rs   Úchannel_namesr¶   c   s   € Øˆz‰?× Ñ  Ó%Ð%ru   c                ó  • [        U 5       Vs/ s H  o"R                  5       PM     nn[        U5       VVs0 s H  u  pBX$_M	     nnn[        R                  " [
        U    Vs/ s H  o%U   PM	     sn5      $ s  snf s  snnf s  snf )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   so   € ä*¨3Ô/Ó	0Ò/˜�'‰'Ž)Ñ/€BÐ	0Ü% bœMÔ
*šM‘D�Aˆ1Š4™M€CÑ
*Ü�8Š8¤X¨gÒ%6Ó7Ò%6 ˜”VÑ%6Ñ7Ó8Ð8ùò 
1ùÛ
*ùÚ7s   ŽA8·A=Á#Bc           	     ó0  • [        U 5       Vs/ s H  oR                  5       PM     nn[        U5       VVs0 s H  u  p1X_M	     nnn[        R                  " [
         Vs/ s H  oR                  US5      PM     sn5      nXUS:¬  4$ s  snf s  snnf s  snf )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   sy   € ä*¨3Ô/Ó	0Ò/˜�'‰'Ž)Ñ/€BÐ	0Ü% bœMÔ
*šM‘D�Aˆ1Š4™M€CÑ
*Ü
�(Š(­DÓ1ªD q—G‘G˜A˜r–N©DÑ1Ó
2€CØ�q‘ˆ=Ðùò 
1ùÛ
*ùÚ1s   ŽB·BÁ Bc                ó”   • US:X  a  [         O[        n[        R                  " [        R
                  R                  USU  S35      SS9$ )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           	     óÖ   • US:X  a  [         O[        n[        R                  " [        R
                  R                  USSU  S35      SS9n[        R                  " USS2SSS24   5      $ )	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           
     óŠ   • [        [        R                  " [        R                  R                  [        SU  S35      SS95      $ )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                ó0   • [         R                  " XSUSS9$ )NÚhighpassÚsos©r‚   Úoutput©r   Úbutter©ÚfcÚorderr‚   s      rs   Úsos_hprç   �   s   € ä�=Š=˜ J°2¸eÑDÐDru   c                ó0   • [         R                  " XSUSS9$ )NÚlowpassrß   rà   râ   rä   s      rs   Úsos_lprê   ’   s   € ä�=Š=˜ I°"¸UÑCÐCru   c                ó4   • [         R                  " X U/SUSS9$ )NÚbandpassrß   rà   râ   )ÚloÚhiræ   r‚   s       rs   Úsos_bprï   —   s   € ä�=Š=˜ R ¨*¸ÀEÑJÐJru   c                óÄ   • [         R                  " U 5      nUR                  S:X  a  USS2SS2S4   US   SSSS24   -  OX!S   -  n[         R                  " XSUS9u  p4U$ )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ù   œ   s`   € ä	×	Ò	˜3Ó	€BØ12·±¸1³ˆŠAŠq�$ˆJ‰˜!˜A™$˜t Tª1˜}Ñ-Ò	-À"ÈÁtÁ)€BÜ�>Š>˜# q¨RÑ0�D€AØ€Hru   c                ó,   • [         R                  " XSS9$ )Nr   ©rò   )r   Úsosfiltfilt)rß   r÷   s     rs   Úzfiltrý   ¤   s   € Ü×Ò˜c¨1Ñ-Ð-ru   c                ó:  • [         S   n[        R                  " U [        R                  S9n UR	                  S5      (       a  [
        O[        nUS;   al  U" [        US   US   U5      U 5      nU" [        US   S   US   S	   US
   U5      U5      nU" [        US   US   U5      U5      nX#S   -  nUSSU2   US   4$ US;   aK  U" [        US   S   US   U5      U 5      nU" [        US   US   U5      U5      nX#S   -  nUSSU2   US   4$ [        U5      e)z÷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  ¨   s@  € ô 	ˆ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                óø  • U R                   u  pE[        R                  " U 5      nU S U R                  S5      R	                  5       nS[        R
                  " U S U U-
  5      R                  S5      -  S-   n[        U5       Hs  n	X	   U-
  U-  n
[        R                  " X¢* U5      n
X¦U	'   XzU-  -   nXqX·-
  -  -   nX�S[        R
                  " X·-
  5      -  U-
  -  -   n[        R                  " US5      nMu     U$ )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Ü
�-Š-˜Ó
€CØ	ˆ'ˆ6ˆ
�‰˜Ó×ÑÓ!€AØ”—’˜˜'˜6˜
 Q™Ó'×,Ñ,¨QÓ/Ñ/°%Ñ7€AÜ�1ŽXˆØ‰T�A‰X˜‰NˆÜ�GŠG�A�u˜dÓ#ˆØˆA‰Ø�Q‘‰YˆØ˜™Ñ Ñ ˆØ˜¤"§&¢&¨©£.Ñ0°1Ñ4Ñ5Ñ5ˆÜ�JŠJ�q˜%Ó Šñ ð €Jru   )r   c                ó¶  • U R                   u  pE[        R                  " U 5      n[        R                  " U5      n[        R                  " U5      n[	        U5       H]  n	Sn
[	        U5       H  nX X¹4   -  n
M     X£-  Xy'   Sn
[	        U5       H  nU
[        XU	4   Xy   -
  5      -  n
M     SU
-  U-  S-   X‰'   M_     [	        U5       H�  n[	        U5       H{  n	XU	4   Xy   -
  X‰   -  nXÂ:”  a  UnO	XÂ* :  a  U* nXÆX¹4'   Xy   XÈU	   -  -   nXy==   XXy   -
  -  -  ss'   X‰==   US[        X×U	   -
  5      -  X‰   -
  -  -  ss'   X‰   S:  d  Mw  SX‰'   M}     M�     U$ )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  Ò   sj  € à�w‰w‰ˆÜ�mŠm˜AÓˆÜ�HŠH�Q‹KˆÜ�HŠH�Q‹KˆÜ�q–ˆAØˆCÜ˜6–]�Ø˜˜‘w‘’ñ #à‘<ˆA‰DØˆCÜ˜6–]�Ø”s˜1 ˜T™7 Q¡T™>Ó*Ñ*’ñ #à˜C‘< &Ñ(¨5Ñ0ˆA‹Dñ ô �q–ˆAÜ˜1–X�Ø˜!�t‘W˜q™t‘^ q¡tÑ+�Ø“8Ø‘AØ˜“YØ˜�AØ�A�D‘	Ø‘T˜A !¡™H‘_�Ø“˜ a¡d¡Ñ+Ñ+“Ø“˜ ¬#¨b°Q±4©i«.Ñ!8¸1¹4Ñ!?Ñ@Ñ@“Ø‘4˜%•<Ø �A“Dó ñ ð ˆ
ru   c                ó¶  • [         S   nUc  US   OUnUc  US   OUnUc  [        [        US   U-  5      5      OUn[        R                  " [        R
                  " U [        R                  S95      n U R                  S:H  nU(       a	  U SS2S4   n SX!-  -  n[        b  [        O[        nU" X[        U5      [        U5      5      n	U(       a	  U	SS2S	4   $ U	$ )
aK  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‘:Ñ€EÜÑ(�¬h€AÙ	ˆ!”E˜$“K¤ V£Ó-€AÞˆ1ŠQ�ˆT‰7Ð$ 1Ð$ru   c                ó&   • X R                  SSS9-
  $ )Nrv   T©Úkeepdims)r  )r÷   s    rs   ÚcarrA    s   € Ø�v‰v�a $ˆvÐ'Ñ'Ð'ru   c           
     ó  • U S   n[         U   n[        R                  " U Vs/ s H  n[        R	                  U5      PM     sn5      n	US:X  a�  [        US5      n
[        U 5      u  p¼[        R                  " U
R                  S   S45      n[        R                  " U
SS2X¼   4   [        R                  S9USS2U4'   [        US5      R                  [        R                  5      nSnO²[        R                  " [        R                  R!                  ["        S	X S
35      5      nUS   R                  [        R                  5      US   R                  [        R                  5      US   pÎnUR%                  S5      (       a  [&        S   S   O[&        S   S   nUSS2U	4   nXÉ   nU(       a(  USS2U4   USS2U4   R)                  SSS9-
  USS2U4'   U(       a   [+        Xß5      nSUSS2U) 4'   [+        Xï5      n[-        U5      n[.        U-  nUS   SSU2   S[1        U5       nUS   SSU2   S[1        U5       n[3        [1        U5      [1        U5      [1        U5      5      nUSU USU USU USU 4u  pÞnnSnU(       aH  [5        [7        [&        S   S   U-  5      5      nUUUU-
   UUUU-
   UUUU-
   UUUU-
   4u  pÞnnUU-  n[9        XÞUUR                  [        R:                  5      UUUS9$ s  snf )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“|‰ˆÜ�HŠH�c—i‘i ‘l BÐ'Ó(ˆÜŸ
š
 3¢q¨#©, Ñ#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`�ˆØ/6×/?Ñ/?À×/GÑ/GŒS�‰_˜]Ò+ÌSÐQ[É_Ð]eÑMfˆØ	Š!ˆSˆ&‰	€AØ‰<€DÞØ’q˜$�w‘Z !¢A t G¡*§/¡/°!¸d /Ð"CÑCˆŠ!ˆTˆ'‰
ÞÜ�aÓˆØˆŠ!ˆdˆUˆ(‰Ü˜Ó ˆÜ
�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ˆC�Ø	€BÞÜ””c˜*‘o mÑ4°rÑ9Ó:Ó;ˆØ˜A˜a !™e˜* c¨!¨A°©E l°C¸¸!¸a¹%°LÀ"ÀQÀqÈ1ÁuÀ+ÐM‰ˆ��RØ�‰VˆÜ�A 2¨s¯z©z¼"¿'¹'Ó/BÀrÐPRÐ\`ÑaÐaùò? 1s   £K=c                ód   • [        [        [        S   S   U-  5      5      nX[        U 5      U-
   $ )Nrÿ   r7  )rŸ   r8  r  rP  )r÷   r‚   r\  s      rs   Útrimr_  8  s1   € ÜŒE”#�j‘/ -Ñ0°2Ñ5Ó6Ó7€AØŒs�1‹v˜‰zˆ?Ðru   c           	     óø  • [         R                  " U [        5      n U [         R                  " U 5         n [	        U 5      S:X  a/  [         R
                  [         R
                  [         R
                  4$ Uc  [        S   S   OUnUc  [        S   S   OUn[         R                  R                  U5      nUR                  S[	        U 5      U[	        U 5      45      nU[         R                  [         R                  4;  a  [         R                  " USX   5      OU" X   SS9nSU-
  S-  n[        U" U 5      5      [        [         R                  " Xx5      5      [        [         R                  " USU-
  5      5      4$ )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¡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   • U S   SU S3 SU S   SU S3 SU S   SU S3 S3$ )	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                óv  • [         R                  " U [        5      n [        U 5      n[         R                  " U 5      nX   U-  [         R
                  " SUS-   5      -  n[         R                  R                  US S S2   5      S S S2   n[         R                  " U5      n[         R                  " US5      XB'   U$ )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�DØ€Hru   c                ó  • SS K Jn  U R                  [        R                  R                  [        U S35      SSS9  UR                  U 5        Ub6  UR                  [        R                  R                  [        U S35      SS9  g g )	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                 ó:   ^ • [         R                   " 5       m U 4S j$ )Nc                 ó4   >• [         R                   " 5       T -
  $ ©N©Útime©r[  s   €rs   Ú<lambda>Útimer.<locals>.<lambda>g  s   ø€ ”4—9’9“; Ò#ru   r�  r’  s   @rs   Útimerr•  e  s   ø€ Ü	�Š‹€BÜ#Ð#ru   c
                ó®  • SSK Jn
  SSKJn  [        R
                  " SSU	5      n[        R                  " XÌ5      u  pÞU" [        R                  X4   X=U4SS9n[        R                  U[        R                  " XÞ5      S:„  '   U R                  XÞUS	XEU[        R
                  " Ub  UO[        R                  " U5      Ub  UO[        R                  " U5      S
5      S9nU R                  XSSS9  [        R
                  " SS[        R                  -  S5      nU R                  S[        R                   " U5      -  S[        R"                  " U5      -  SSS9  U R                  / SQ/ SQSSS9  Ub)  [%        XU5       H  u  nnnU R'                  UUUSS9  M     U R)                  S5        U R+                  S5        U(       a  U
R-                  UU SS9  U$ )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Ó�D€AÙ”—‘�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Ø‡K‚K�˜TÔ"ñ "ð 	ˆ�_€ÙÓ
 šR˜ˆUŒ8™RÑ
 €Ù"$Ó%¢"˜Qˆu‰X�qŠ[¡"Ñ%€	Ù%'Ó(¢R ˆi‰L˜!ŠO¡RÑ(€Ù(*Ó	+ª 1ˆE‰(�A�g‘JÒ
©Ñ	+€Ù(*Ó	+ª 1ˆE‰(�A�g‘JÒ
©Ñ	+€Øˆ�]€Ø
ˆ6�{€ò:€ñ
 Óš3�a�‰Ž	™3Ñ€Ú8€Ø�uˆ~€ñ !ÓJšD�q¨]¸\Ñ-IÑ$I—™DÑJÙ!Ó<šT˜¨mÑ%;—!™TÑ<Ù Ó:šD�q¨\Ñ$9—™DÑ:ñ	€ôñ" �1Ñóó ðô2&ô9ôöKö
"ôVñ �2ÑñEó ðEñ �2ÑñDó ðDñ �2ÑñKó ðKòò.ð -/ö ò.ð !Ûà
‡Z‚Z�dÑñó ðô@%ò*(ô)bòXð —I‘I ¨$°Tô Tô;òöAò$õ
÷q
 ,Ö+üò !ùÚ%ùÚ(ùÚ	+ùÚ	+ùò  ùò
 KùÚ<ùÚ:øðv ó Ø‚Hðúsf   Ã NÇ N(Ç5N-ÈN2È!N7È:N<É!OÊ	OÊOÊ%	OÊ2OÊ>	OËOÍO Î
N%ÏO ÏO 