Ë
     'ïjWk  ã            
       ót  — d Z ddlZddlZddlZddlmZmZ ej                  j                  dej                  j                  ej                  j                  e«      «      «       ddlmZmZmZ ddlmZmZmZmZmZmZmZmZmZmZ ddlmZ d¡d„Zd¢d„Z d	„ Z!d£d
„Z"	 	 d¤d„Z#dZ$d¥d„Z%d„ Z&i dd“dd“dd“dd“dd“dd“dd“dd“dd “d!d"“d#d$“d%d&“d'd(“d)d*“d+d,“d-d.“d/d0“i d1d2“d3d4“d5d6“d7d8“d9d:“d;d<“d=d>“d?d@“dAdB“dCdD“dEdF“dGdH“dIdJ“dKdL“dMdN“dOdP“dQdR“¥i dSdT“dUdV“dWdX“dYdZ“d[d\“d]d^“d_d`“dadb“dcdd“dedf“dgdh“didj“dkdl“dmdn“dodp“dqdr“dsdt“¥dudvdwdxdydzd{d|œ¥Z'd¦d~„Z( e(«       Z)d§d„Z*d§d€„Z+d§d�„Z,d§d‚„Z-d§dƒ„Z.d„„ Z/d…„ Z0d¨d†„Z1d©d‡„Z2da3dˆ„ Z4dªd‰„Z5dªdŠ„Z6d‹„ Z7dŒ„ Z8d�„ Z9d«dŽ„Z:d�„ Z;d�„ Z<d‘„ Z=e>d’k(  �r‰ e«       Z?ej€                  d“d xs ed”   D �]g  ZAed”   eA   j…                  d•«      r=  ed}¬–«      d—„ e?j‡                  «       D «       «      ZD eEeAd˜ eFeD«      d™ eGe?«      «       ŒXed”   eA   j…                  dš«      r=  ed}¬–«      d›„ e?j‡                  «       D «       «      ZD eEeAd˜ eFeD«      d™ eGe?«      «       Œ¬ed”   eA   j…                  dœ«      rie?j‘                  d�«      D � �cg c]  \  } } eI|j•                  dž«      «      ‘Œ c}} ZK  ed}¬–«      dŸ„ eKD «       «      ZD eEeAd˜ eFeD«      d™ eGe?«      «       �Œ,  ed}¬–«      d „ e?j‡                  «       D «       «      ZD eEeAd˜ eFeD«      d™ eGe?«      «       �Œj yyc c}} w )¬a5  Build per-trial caches for both preprocessing pipelines (58-ch baseline montage, 32 Hz).
Normalisation per prep: norm=trial -> full-trial z-score (loadSubject.m), norm=running -> causal running z.
cache/<prep>/<key>.npz: eeg (T,58) float32, env (T,2) float32 (column 0 = majority-attended), att (T,) int8, t0.é    N)ÚParallelÚdelayed)ÚCFGÚ
cache_pathÚresolve_read)
r   ÚFSÚB64UÚMONTAGESÚb64_idxÚload_eegÚload_envÚload_labelsÚload_ppÚtrial_index)Údetrendc                 ó<  — t        t        j                  | t        j                  «      dd¬«      } t	        ||z  «      }t        j
                  | ||fdfd¬«      }t        j                  j                  t        |«      d|z  «      }t        j                  |«      }	d|	||k\  ||k  z  <   |||z
  kD  ||k  z  }
d	d	t        j                  t        j                  ||
   ||z
  z
  z  |z  «      z  z
  |	|
<   ||kD  |||z   k  z  }d	d	t        j                  t        j                  ||   |z
  z  |z  «      z  z   |	|<   t        j                  j                  t        j                  j                  |d¬
«      |	dd…df   z  t        |«      d¬«      }|||t        | «      z    S )zéZero-phase FFT band-pass of a whole trial (NON-causal): linear detrend, reflect-pad pad_s on both sides,
    rfft, keep lo..hi Hz with raised-cosine edges of width `taper` Hz (0.25 Hz: EEG 1/f power below 1 Hz is large), irfft, crop.r   Úlinear)ÚaxisÚtype)r   r   Úreflect)Úmodeé   ç      ð?g      à?©r   N)Únr   )r   ÚnpÚasarrayÚfloat64ÚintÚpadÚfftÚrfftfreqÚlenÚ
zeros_likeÚcosÚpiÚirfftÚrfft)ÚxÚfsÚloÚhiÚtaperÚpad_sÚpÚxpÚfÚgÚaÚbÚys                ú'/root/disk_3tb/eeg-thao/prepare_data.pyÚfft_bandpassr7      sm  € ô 	”—
‘
˜1œbŸj™jÓ)°¸ÔA€AÜˆE�B‰J‹€AÜ	�‰��Q˜�F˜FÐ#¨)Ô	4€BÜ
�‰�‰œ˜B›  R¡Ó(€AÜ
�‰�aÓ€AØ"€A€qˆB�w�1˜‘7ÑÑØ	
ˆR�%‰Z‰˜A ™FÑ#€AØ�”r—v‘vœbŸe™e q¨¡t¨r°E©zÑ':Ñ;¸eÑCÓDÑDÑD€A€a�DØ	
ˆR‰�A˜˜U™
‘NÑ#€AØ�”r—v‘vœbŸe™e q¨¡t¨b¡yÑ1°EÑ9Ó:Ñ:Ñ:€A€a�DÜ
�‰�‰”R—V‘V—[‘[ ¨!�[Ó,¨q²°D°©zÑ9¼SÀ»WÈ1ˆÓM€AØˆQˆq”3�q“6‰zˆ?Ðó    c           	      ó*  — | d   }t        | «      \  }}t        |«      }t        j                  |j                  d   df«      }t        j
                  |dd…||   f   t        j                  ¬«      |dd…|f<   t        |«      j                  t        j                  «      }t        t        d   z  }	t        |t        |d   |d   «      dd|	…   }t        |t        |d   |d   «      dd|	…   }d|dd…| f<   t        j                  t        |   D �
cg c]  }
t        j                  |
«      ‘Œ c}
«      }|dd…|f   ||   }}|dd…|fxx   |dd…|f   j!                  dd	¬
«      z  cc<   t#        |«      }|d   dd|	…   dt%        |«       }t'        t%        |«      t%        |«      t%        |«      «      }t)        t+        t,        d   d   t        d   z  «      «      }t/        ||||z
   ||||z
   t        d   ||||z
   |t        d   z  ¬«      S c c}
w )a'  'fft' pipeline: raw 128 Hz -> FFT band-pass 1-9 Hz (0.25-Hz cosine edges) on EEG and envelopes -> 32 Hz
    (every 4th sample; band-limited to < 9.5 Hz so no aliasing) -> montage -> CAR over present channels -> 1-s edge trim.
    Normalisation is applied by the caller (same as the other preps).Úkeyr   é@   N©Údtyper*   r   ç        T©ÚkeepdimsÚatt_colÚpipelineÚedge_trim_s)ÚeegÚenvr*   rA   Út0_s)r   r   r   ÚzerosÚshaper   r   r   ÚastypeÚFS_RAWr   r7   Úarrayr
   r	   ÚindexÚmeanr   r#   Úminr   ÚroundÚECFGÚdict)ÚrowÚmontageÚbandr:   ÚsrcÚpresentÚrawr)   ÚeÚqÚcÚselÚpresÚlabÚattr   Úks                    r6   Úload_fftr`   !   sñ  € ð ˆe‰*€CÜ˜3“<�L€CˆÜ
�3‹-€CÜ
�‰�#—)‘)˜A‘, Ð#Ó$€AÜ—J‘J˜s¢1 c¨'¡l ?Ñ3¼2¿:¹:ÔF€A‚aˆ€j�MÜ�‹×ÑœRŸZ™ZÓ(€AÜ”#�d‘)Ñ€AÜ�Qœ  Q¡¨¨a©Ó1±#°A°#Ñ6€AÜ�Qœ  Q¡¨¨a©Ó1±#°A°#Ñ6€AØ€A‚aˆ'ˆ€k�NÜ
�(‰(¬8°GÒ+<Ó=Ñ+< a”D—J‘J˜q•MÐ+<Ñ=Ó
>€CØ’�3�‰i˜ ™€t€AØ‚aˆ€gƒJ�!’A�t�G‘*—/‘/ !¨d�/Ó3Ñ3ƒJÜ
�cÓ
€CØ
ˆi‰.™˜1˜Ñ
˜h¤ A£Ð
'€CÜŒC�‹F”C˜“FœC ›HÓ%€AÜŒE”$�zÑ" =Ñ1´C¸±IÑ=Ó>Ó?€AÜ�A�a˜˜A™�J A a¨¨A© J´3°t±9ÀcÈ!ÈAÐPQÉEÀlÐYZÔ]`ÐaeÑ]fÑYfÔgÐgùò >s   ÄHc                 ó®   — t        j                  | t         j                  «      } | j                  dd¬«      }d||dk(  <   | | j	                  d«      z
  |z  S )z`MATLAB zscore along time: N-1 std, a zero-variance column (zero-filled channel) is divided by 1.r   r   )Úddofr   )r   r   r   ÚstdrM   )r)   Úsds     r6   Úzscore_trialre   9   sL   € ä
�
‰
�1”b—j‘jÓ!€AØ	
�‰ˆq�qˆÓ	€BØ€B€rˆQ�w�KØ�—‘�q“	‰M˜RÑÐr8   c           
      ó¶  — t        j                  | t         j                  «      } | j                  d«      dkD  }| j	                  «       }	| dd…|f   }
|
j
                  d   }|�|j
                  ||fk7  rt        j                  |«      n|j	                  «       }||z  }|€dn||z  }t        ||z  «      }t        dt        |
«      |«      D �]  }|
|||z    }d|z
  |z  |t        j                  |«      z  |z  t        j                  |«      z  z   }t         j                  j                  |«      \  }}||dt        j                  t        j                  |d«      «      z  z  z  |j                  z  |	|||z   …|f<   |j                  |z  t!        t        |«      d«      z  }|€d|z
  |z  ||z  z   }Œçd|z
  |z  dz   }d|z
  |z  |z  |z   |z  |}}�Œ |r|	|fS |	S )aŒ  Causal running Euclidean alignment (whitening by R^-1/2). R = exponentially weighted spatial covariance of
    PAST 1-s blocks only (time constant tau_s), shrunk towards the identity; block k is whitened with R estimated
    from blocks < k (R starts at the identity: data are z-scored). Zero (absent) channels are left untouched.
    Not an exempted whole-trial method, hence causal (1-s lookahead rule).
    n0 (s): weight of the start value R0 / identity, as seconds of data. None = tau_s (the original recursion). A small n0
    gives a fast warm-up: a plain cumulative mean of the trial's own blocks at first, exponential forgetting (tau_s) later.r   Nr   r   g:Œ0âŽyE>)r   r   r   rc   ÚcopyrH   Úeyer   Úranger#   ÚtraceÚlinalgÚeighÚsqrtÚmaximumÚTÚmax)r)   r*   Útau_sÚblock_sÚshrinkÚR0Úreturn_RÚn0r\   r5   r0   ÚCÚRr3   ÚNÚBÚs0ÚblkÚRsÚwÚVÚCbÚN1s                          r6   Ú	causal_ear‚   A   sË  € ô 	�
‰
�1”b—j‘jÓ!€AØ�5‰5�‹8�a‰<€DØ	�‰‹€AØ	
Š1ˆdˆ7‰€BØ
�‰�‰€AØ�Z 2§8¡8°°1¨vÒ#5Œ�‰ˆqŒ	¸2¿7¹7»9€AØ�%‰€AØ�
‰  W¡€AÜˆG�b‰LÓ€AÜ�A”s˜2“w ×"ˆØ��B˜‘FˆmˆØ�&‰j˜AÑ ¬¯©°!«Ñ 4°qÑ 8¼2¿6¹6À!»9Ñ DÑDˆÜ�y‰y�~‰~˜bÓ!‰ˆˆ1Ø  A¨¬r¯w©w´r·z±zÀ!ÀTÓ7JÓ/KÑ)KÑ$LÑMÐPQ×PSÑPSÑSˆˆ"ˆR�!‰Vˆ)�Tˆ/ÑØ�e‰e�c‰kœS¤ S£¨1Ó-Ñ-ˆØˆ:Ø�Q‘˜!‘˜a "™fÑ$‰Aà�a‘%˜1‘˜sÑ"ˆBØ˜‘U˜a‘K !‘O bÑ(¨BÑ.°ˆqŠAð #ñ ˆAˆqˆ6Ð$ 1Ð$r8   c
                 óò  ‡‡‡‡ — t        j                  | t         j                  «      } | j                  \  }
}t	        |«      t	        ||z  «      ||z  cŠ}}|€t        j
                  |‰dz   f«      n|j                  «       }|€	d|dd…df<   t        j                  t        j
                  ‰|f«      | g«      }t        j                  | «      }t        j                  t        j                  ‰«      dd…df   t        j                  ‰«      ddd…f   z
  «      }t        d|
|«      D �]×  }t        ||
|z
  «      Š|||‰z   ‰z    Š |dd…df   dkD  }t        j
                  |‰f«      Š|j                  «       r^||   dd…|f   |||dd…df   z  t        j                  ‰«      z  z   }t         j                  j!                  |||dd…df   «      d   ‰|<   ‰|z  Št#        ˆˆˆˆ fd„t        d‰dz   «      D «       «      }|dd…df   d‰|dd…dd…f   z  j#                  d«      z  z
  t        j$                  d	‰|dd…|f   ‰«      z   }‰ ‰d |z
  t        j&                  t        j(                  |t        j*                  |d
|dd…df   z  «      d«      «      z  |||‰z    t        j,                  t        ‰dz   «      D �cg c]%  }‰ ‰d ‰ ‰|z
  ‰|z
  ‰z    z  j/                  d«      ‘Œ' c}d«      }d|z
  |z  ||z  z   }�ŒÚ |	�Ìddlm} t        j4                  dgt        j                  |	t6        «      d‰ g«      }t         j                  j!                  ||   |t        j                  ‰«      z  z   |dd «      }|d   d|z  |dd z  z
  |||   z  |z  z   } |t        j&                  |«      gt        j4                  dg| g«      |d¬«      }d|dd…| j9                  d«      dk(  f<   |r||fS |S c c}w )a„  Causal TEMPORAL whitening per channel: adaptive linear-prediction error filter.
    y(t) = (x(t) - strength * sum_k a_k x(t-k)) / sd_err, with the AR(order) coefficients a of every channel solved
    (Yule-Walker, diagonal loading shrink * r0) from the exponentially weighted autocovariances r_0..r_order of PAST
    1-s blocks only (time constant tau_s; `state` = r carried across a subject's trials). Block k is filtered with
    coefficients estimated from blocks < k; the first block of a subject is unfiltered (r = [1, 0, ...]: data are
    z-scored). sd_err = sqrt of the predicted error variance (from the same past statistics), so the output has about
    unit variance. Flattens each channel's spectrum inside the pass band (1/f slope, alpha peak), which differs between
    subjects and datasets. Filter memory restarts at a trial start (zeros). Absent (zero) channels stay zero.
    Not an exempted whole-trial method, hence strictly causal.
    recolor_acf (autocorrelation at lags 1..order of a CANONICAL spectrum): spectral STANDARDISATION instead of
    whitening: the whitened signal is re-coloured by the FIXED all-pole filter of that canonical AR model (same
    shrinkage), so every channel of every recording gets the same canonical spectral shape. Recordings whose spectrum is
    already canonical come out nearly unchanged, atypical ones (e.g. KUL-AV-GC) are pulled to the canonical shape.Nr   r   r   gê-�™—q=).r   c              3   óT   •K  — | ]  }‰‰|z
  ‰|z
  ‰z    ‰d d …|dz
  f   z  –— Œ! y ­w)Nr   © )Ú.0r_   r3   r   r/   Úsegs     €€€€r6   Ú	<genexpr>zcausal_tw.<locals>.<genexpr>€   s6   øè ø€ ÐO¹¸!�3�q˜1‘u˜Q ™U Q™YÐ'¨!ªA¨q°1©u¨H©+Õ5¹ùs   ƒ%(é   zci,cij,cj->cç�íµ ÷Æ°>)Úlfilterr   r>   )r   r   r   rH   r   rG   rg   ÚvstackÚ
empty_likeÚabsÚarangeri   rN   Úanyrh   rk   ÚsolveÚsumÚeinsumrm   Úwherern   ÚstackrM   Úscipy.signalr‹   ÚconcatenateÚfloatrc   )!r)   r*   Úorderrq   rr   rs   ÚstrengthÚstateÚreturn_stateÚrecolor_acfro   rw   rz   ÚalÚrr0   r5   Úiir{   Úokrx   ÚpredÚevr_   Úrbr‹   ÚrcÚacÚevcr3   r   r/   r‡   s!                                @@@@r6   Ú	causal_twr¨   _   s¸  û€ ô 	�
‰
�1”b—j‘jÓ!€AØ�7‰7�D€A€qÜ�5‹zœ3˜w¨™|Ó,¨g¸©o€H€A€qˆ"Ø % Œ�‰�!�Q˜‘U�Ô°5·:±:³<€AØ€}ØˆŠ!ˆQˆ$‰Ü	�‰”B—H‘H˜a ˜VÓ$ aÐ(Ó	)€BÜ
�‰�aÓ€AÜ	�‰”—	‘	˜!“šQ ˜WÑ%¬¯	©	°!«°Tº1°WÑ(=Ñ=Ó	>€BÜ�A�q˜!�nˆÜ��1�r‘6‹NˆØ��B˜‘F˜Q‘JÐˆØŠq�!ˆt‰W�u‰_ˆÜ�H‰H�a˜�VÓˆØ�6‰6Œ8Ø�"‘’a˜�e‘˜v¨¨"¨b¨q¨b°$¨,©Ñ7¼"¿&¹&À»)ÑCÑCˆAÜ—I‘I—O‘O A q¨¨Q©R°¨¡Ó7¸Ñ?ˆAˆb‰EØ	ˆX‰ˆÜÖO¼uÀQÈÈAÉ¼ÓOÓOˆØŠq�!ˆt‰W�q˜A ¢! Q¡R %¡™L×-Ñ-¨aÓ0Ñ0Ñ0´2·9±9¸^ÈQÐPQÒRSÐUWÐRWÑPXÐZ[Ó3\Ñ\ˆØ˜A˜B˜ $™¬"¯'©'´"·(±(¸2¼r¿z¹zÈ"ÈdÐUVÒWXÐZ[ÐW[ÑU\ÉnÓ?]Ð_bÓ2cÓ*dÑdˆˆ"ˆR�!‰VˆÜ�X‰XÌÈqÐSTÉuÌÓVÉÀA˜˜A˜B˜ # a¨!¡e¨A°©E°A©IÐ"6Ñ6×<Ñ<¸QÕ?ÈÑVÐXYÓZˆØ�‰V�q‰L˜2 ™7Ñ"Šð ð ÐÝ(Ü�^‰^˜c˜U¤B§J¡J¨{¼EÓ$BÀ2ÀAÐ$FÐGÓHˆÜ�Y‰Y�_‰_˜R ™V f¬r¯v©v°a«yÑ&8Ñ8¸"¸Q¸R¸&ÓAˆØ�‰e�a˜"‘f˜r ! "˜v‘oÑ%¨¨R°©V©°bÑ(8Ñ8ˆÙ”R—W‘W˜S“\�N¤B§N¡N°S°E¸B¸3°<Ó$@À!È!ÔLˆØ€A‚aˆ�‰ˆq‹�Q‰ÐÑÙ!ˆAˆqˆ6Ð( qÐ(ùò Ws   Ë *O4
))r   ç      @)r©   ç      @)rª   ç      "@c                 ód  — ddl m}m} t        j                  | t        j
                  «      } | j                  d«      dkD  }| j                  d   t        ||z  «      }	}t        D �
�cg c]  \  }
} | |d|
|gd|d¬«      | d¬«      ‘Œ }}
}|€-t        j                  t        |«      |fd
t        |«      z  «      n|j                  «       }||z  }t        j                  | «      }t        dt        | «      |	«      D ]�  }t        |«      D ]q  \  }}||||	z    }||||	z   xxx |t        j                   t        j"                  ||   d«      «      z  z  ccc d|z
  ||   z  ||dz  j%                  d«      z  z   ||<   Œs Œƒ d|d	d	…| f<   |t        j                   t        |«      «      z  |fS c c}}
w )a°  F1, causal spectral equalisation: split each channel into BEQ_BANDS with CAUSAL Butterworth band-passes,
    scale every band of every channel by 1/sqrt(its running power) estimated from PAST 1-s blocks only (EW, tau_s;
    state carried across a subject's trials), then sum the bands. Equalises the within-band spectral shape
    (1/f slope, alpha leakage near 9 Hz) that differs between datasets. Absent (zero) channels stay zero.r   ©ÚbutterÚsosfiltr   r‰   ÚbandpassÚsos©r*   Úoutputr   Nr   rŠ   r>   )r–   r®   r¯   r   r   r   rc   rH   r   Ú	BEQ_BANDSÚfullr#   rg   r$   ri   Ú	enumeraterm   rn   rM   )r)   r*   r›   rq   rr   r®   r¯   r\   rw   rz   r+   r,   ÚbandsÚPwr3   r5   r{   Úir4   r|   s                       r6   Úcausal_band_eqrº   ’   sŒ  € ÷
 -Ü
�
‰
�1”b—j‘jÓ!€AØ�5‰5�‹8�a‰<€DØ�7‰7�1‰:”s˜7 R™<Ó(€q€AÝdmÔnÑdmÑZ`ÐZ\Ð^`‰W‘V˜A  B˜x¨¸À5ÔIÈ1ÐSTÖUÐdm€EÑnØ7<°}Œ�‰”#�e“*˜a� #¬¨E«
Ñ"2Ô	3È%Ï*É*Ë,€BØ�%‰€AÜ
�‰�aÓ€AÜ�A”s˜1“v˜qÖ!ˆÜ˜eÖ$‰DˆAˆqØ�B�r˜A‘v�,ˆCØˆb��a‘‹L˜C¤"§'¡'¬"¯*©*°R¸±U¸DÓ*AÓ"BÑBÑB‹LØ˜‘U˜b ™e‘O a¨3°!©8¯/©/¸!Ó*<Ñ&<Ñ<ˆBˆqŠEñ %ð "ð
 €A‚aˆ$ˆ€h�KØŒr�w‰w”s˜5“zÓ"Ñ" BÐ&Ð&ùó os   Á'"F,c                 ó”  — ddl m}m} ddlm}m}m}m}m}	  || «      \  }
} || d   «      }t        j                  |j                  d   df«      }t        j                  |dd…|
|   f   t        j                  ¬«      |dd…|f<   t        j                  |t        d      D �cg c]  } |j                   |«      ‘Œ c}«      }|dd…|f   ||   }}|dd…|fxx   |dd…|f   j#                  d	d
¬«      z  cc<   d}t        j$                   | |dddgd|d¬«      |d¬«      «      } | |ddd|d¬«      |d¬«      dd|t        d   z  …   } |	|t        d   «      }d|dd…| f<   ||||z    }t'        |«      |k  rEt        j(                  |t        j                  |t'        |«      z
  |j                  d	   f«      g«      }|S c c}w )a0  E2: causal 30-40 Hz envelope per montage channel from the RAW 128 Hz EEG: CAR -> causal band-pass 30-40 Hz
    (Butterworth 4) -> |.| -> causal low-pass 8 Hz -> every 4th sample (32 Hz) -> same 1-s edge trim as the other
    preps -> causal running robust z (EDA running_z; no second full-trial z-score).r   r­   )r	   r
   r   r   Ú	running_zr:   r;   Nr<   rS   r   Tr?   é€   é   é   é(   r°   r±   r²   r   r‰   é   Úlowpassr*   r>   )r–   r®   r¯   Úcommonr	   r
   r   r   r¼   r   rG   rH   r   r   rK   r   rL   rM   rŽ   r#   rŒ   )rR   Ún_outÚk_trimr®   r¯   r	   r
   r   r   r¼   rU   rV   rW   r)   rZ   r[   r\   Úfs_rawr2   s                      r6   Úgamma_enveloperÇ   ¨   s±  € ÷ -ßCÕCÙ˜3“<�L€CˆÙ
�3�u‘:Ó
€CÜ
�‰�#—)‘)˜A‘, Ð#Ó$€AÜ—J‘J˜s¢1 c¨'¡l ?Ñ3¼2¿:¹:ÔF€A‚aˆ€j�MÜ
�(‰(¨8´C¸	±NÒ+CÓDÑ+C a�J�D—J‘J˜q•MÐ+CÑDÓ
E€CØ’�3�‰i˜ ™€t€AØ‚aˆ€gƒJ�!’A�t�G‘*—/‘/ !¨d�/Ó3Ñ3ƒJØ€FÜ
�‰‰w‘v˜a " b ¨:¸&ÈÔOÐQRÐYZÔ[Ó\€AÙ‘�q˜!˜Y¨6¸%Ô@À!È!ÔLÑMbÈvÔY\Ð]aÑYbÑObÐMbÑc€AÙ�!”S˜‘YÓ€AØ€A‚aˆ$ˆ€h�KØ	ˆ&�˜%‘Ð €AÜ
ˆ1ƒv�‚~Ü�I‰I�qœ"Ÿ(™( E¬C°«F¡N°A·G±G¸A±JÐ#?Ó@ÐAÓBˆØ€Hùò Es   Â$GÚFP1)çffffffÖ¿r   ÚFPZ)r>   çÍÌÌÌÌÌð?ÚFP2)çffffffÖ?r   ÚAF3)rÉ   ç=
×£p=ê?ÚAF4)rÍ   rÏ   ÚF7)çffffffî¿çš™™™™™á?ÚF5)ç
×£p=
ç¿ç×£p=
×ã?ÚF3)ç¸…ëQ¸Þ¿ç…ëQ¸å?ÚF1)ç¸…ëQ¸Î¿çÃõ(\�Âå?ÚFZ)r>   gffffffæ?ÚF2)ç¸…ëQ¸Î?rÜ   ÚF4)ç¸…ëQ¸Þ?rÙ   ÚF6)ç
×£p=
ç?rÖ   ÚF8)çffffffî?rÓ   ÚFT7)çÍÌÌÌÌÌð¿çìQ¸…ëÑ?ÚFC5)çö(\�Âõè¿ç
×£p=
×?ÚFC3)ç¤p=
×£à¿çš™™™™™Ù?ÚFC1)ç¤p=
×£Ð¿çáz®GáÚ?ÚFCZ)r>   g)\�Âõ(Ü?ÚFC2)ç¤p=
×£Ð?rñ   ÚFC4)ç¤p=
×£à?rî   ÚFC6)çö(\�Âõè?rë   ÚFT8)rË   rè   ÚT7)gìQ¸…ëñ¿r>   ÚC5)gáz®Gáê¿çš™™™™™©?ÚC3)gìQ¸…ëá¿ç{®Gáz´?ÚC1)çìQ¸…ëÑ¿çš™™™™™¹?ÚCZ)r>   r  ÚC2)rè   r  ÚC4)gìQ¸…ëá?rþ   ÚC6)gáz®Gáê?rü   ÚT8)gìQ¸…ëñ?r>   ÚTP7)rç   r   ÚCP5)rê   ç)\�Âõ(Ì¿ÚCP3)rí   ç
×£p=
Ç¿ÚCP1)rð   ç{®GázÄ¿ÚCPZ)r>   gìQ¸…ëÁ¿ÚCP2)rô   r  ÚCP4)rö   r  ÚCP6)rø   r	  ÚTP8)rË   r   ÚP7)rÒ   çš™™™™™á¿ÚP5)rÕ   ç      à¿ÚP3)rØ   çq=
×£pÝ¿ÚP1)rÛ   ç)\�Âõ(Ü¿ÚPZ)r>   gáz®GáÚ¿ÚP2)rß   r  ÚP4)rá   r  ÚP6)rã   r  ÚP8)rå   r  ÚPO7)r  rê   )g333333Ó¿rÕ   )r>   gÃõ(\�Âå¿)g333333Ó?rÕ   )rÓ   rê   )r	  rÒ   )r>   ç      ð¿)g)\�Âõ(Ì?rÒ   )ÚPO3ÚPOZÚPO4ÚPO8ÚO1ÚOZÚO2r¾   c           	      ó.  — t         t        d      }t        j                  |D �cg c]  }t        |   ‘Œ c}t
        «      }t        j                  |dd…ddd…f   |ddd…dd…f   z
  dz  j                  d«      «      }t        j                  |t        j                  «       g }t        t        |«      «      D ]P  }t        j                  ||   «      }|j                  |D �	cg c]  }	|||	f   | k  sŒt        |	«      ‘Œ c}	d| «       ŒR |S c c}w c c}	w )z^Up to k anatomical neighbours per montage channel, within max_dist of the planar 10-10 layout.rS   Nr‰   éÿÿÿÿ)r
   r   r   rK   Ú_LAP_XYr˜   rm   r’   Úfill_diagonalÚinfri   r#   ÚargsortÚappendr   )
Úmax_distr_   ÚnamesrZ   ÚxyÚdÚneighr¹   r™   Újs
             r6   Úlaplacian_neighborsr6  Ô   sï   € ä”S˜‘^Ñ$€EÜ	�‰¡uÓ-¡u !”7˜1“: uÑ-¬uÓ	5€BÜ
�‰�"’Q˜ša�Z‘. 2 dªAªq j¡>Ñ1°aÑ7×<Ñ<¸RÓ@ÓA€AÜ×Ñ�QœŸ™ÔØ€EÜ”3�u“:ÖˆÜ—
‘
˜1˜Q™4Ó ˆØ�‰¡eÓC¡e ¨q°°A°©w¸(Ó/B”c˜!•f eÑCÀBÀQÐGÕHð ð €Lùò .ùò Ds   ¤DÃ"D
Ã2D
c                 ó  — ddl m}m} |€	t        d   n|}t	        j
                  | t        j                  «      }  |d|d|d¬«      } ||| d¬	«      }t	        j
                  | «      j                  d«      dk(  }d
|dd…|f<   |S )zUCausal Butterworth low-pass. Uses only the present and the past (no second filtfilt).r   r­   Nr*   r‰   rÂ   r±   r²   r   r>   )r–   r®   r¯   r   r   r   r   rc   )r)   Úhzr*   r®   r¯   r±   r5   Údeads           r6   Úcausal_lowpassr:  ä   sw   € ç,Ø�jŒˆTŠ b€BÜ
�
‰
�1”b—j‘jÓ!€AÙ
��B˜	 b°Ô
7€CÙ��Q˜QÔ€AÜ�:‰:�a‹=×Ñ˜QÓ 1Ñ$€DØ€A‚aˆ€g�JØ€Hr8   c                 ó|  — t        j                  | t         j                  «      } |€t        n|}| j	                  d«      dkD  }t        j
                  | «      }t        j                  |«      D ]G  }||   D �cg c]
  }||   sŒ	|‘Œ }}| dd…|f   |r| dd…|f   j                  d«      ndz
  |dd…|f<   ŒI |S c c}w )aI  Hjorth surface Laplacian: each present channel minus the mean of its present neighbours.

    Same-time spatial mix (no samples from the future, no other trial). Absent channels stay zero.
    Neighbours that are absent in this recording are dropped, so a missing electrode is not interpolated
    and is not used as a reference.Nr   r   r>   )r   r   r   Ú	LAP_NEIGHrc   r$   ÚflatnonzerorM   ©r)   r4  r\   r5   r¹   r5  Únbs          r6   Úsurface_laplacianr@  ð   s®   € ô 	�
‰
�1”b—j‘jÓ!€AØ˜�I¨E€EØ�5‰5�‹8�a‰<€DÜ
�‰�aÓ€AÜ�^‰^˜DÖ!ˆØ˜qšÓ-™�A T¨!£WŠa˜ˆÐ-Ø’A�q�D‘'±˜Qšq "˜u™XŸ]™]¨1Ô-¸Ñ=ˆŠ!ˆQˆ$Šð "ð €Hùò .s   Á7
B9ÂB9c                 ó  — |€t         n|}t        j                  |«      }t        |«      D ��ci c]  \  }}t	        |«      |“Œ }}}t        |«      }t        j                  |«      }t        |«      D ]>  \  }}|t	        |«         D �	cg c]  }	|	|v sŒ||	   ‘Œ }
}	|
sŒ,dt        |
«      z  |||
f<   Œ@ t        j                  | t        «      t        j                  ||«         }||z  |j                  z  S c c}}w c c}	w )zXMap a sensor-space covariance into the Laplacian space of the channels that are present.r!  ©r<  r   r=  r¶   r   r#   rh   r   r˜   Úix_ro   ©rx   r\   r4  Úidxr¹   rZ   Úinvr_   ÚLr5  r?  ÚRps               r6   Úlaplacian_priorrI     sã   € à˜�I¨E€EÜ
�.‰.˜Ó
€CÜ!*¨3¤Ô
0¡™˜˜AŒ3ˆq‹6�1‰9 €CÑ
0ÜˆC‹€AÜ
�‰ˆq‹	€AÜ˜#–‰ˆˆ1Ø#¤C¨£FšmÓ8™m˜¨q°Cªxˆc�!‹f˜mˆÐ8ÚØœc "›g‘~ˆAˆa�ˆeŠHð ô 
�‰�A”uÓ	œbŸf™f S¨#Ó.Ñ	/€BØˆr‰6�A—C‘C‰<Ðùó 1ùò 9s   ®C6Â	C<ÂC<c                 óX  — t        j                  | t         j                  «      } |€t        n|}| j	                  d«      dkD  }| j                  «       }t        j                  |«      D ]:  }||   D �cg c]
  }||   sŒ	|‘Œ }}|sŒ| dd…|f   | dd…|d   f   z
  |dd…|f<   Œ< |S c c}w )u*  Nearest-neighbour bipolar: each present channel minus its single nearest present neighbour.

    Distinct from surface_laplacian (which subtracts the mean of â‰¤k neighbours). Keeps C channels.
    Absent channels / channels whose neighbour is absent stay as the (possibly CAR'd) sensor value.
    Nr   )r   r   r   r<  rc   rg   r=  r>  s          r6   Únearest_bipolarrK    s¥   € ô 	�
‰
�1”b—j‘jÓ!€AØ˜�I¨E€EØ�5‰5�‹8�a‰<€DØ	�‰‹€AÜ�^‰^˜DÖ!ˆØ˜qšÓ-™�A T¨!£WŠa˜ˆÐ-ÚØš˜1˜‘g ¢! R¨¡U (¡Ñ+ˆAŠa�ˆdŠGð "ð €Hùò .s   Á2
B'Á=B'c                 óð  — |€t         n|}t        j                  |«      }t        |«      D ��ci c]  \  }}t	        |«      |“Œ }}}t        |«      }t        j                  |«      }t        |«      D ]5  \  }}|t	        |«         D �	cg c]  }	|	|v sŒ||	   ‘Œ }
}	|
sŒ,d|||
d   f<   Œ7 t        j                  | t        «      t        j                  ||«         }||z  |j                  z  S c c}}w c c}	w )zMMap a sensor-space covariance into nearest-neighbour bipolar space (L R L^T).r!  r   rB  rD  s               r6   Úbipolar_priorrM     sß   € à˜�I¨E€EÜ
�.‰.˜Ó
€CÜ!*¨3¤Ô
0¡™˜˜AŒ3ˆq‹6�1‰9 €CÑ
0ÜˆC‹€AÜ
�‰ˆq‹	€AÜ˜#–‰ˆˆ1Ø#¤C¨£FšmÓ8™m˜¨q°Cªxˆc�!‹f˜mˆÐ8ÚØˆAˆa��A‘ˆhŠKð ô 
�‰�A”uÓ	œbŸf™f S¨#Ó.Ñ	/€BØˆr‰6�A—C‘C‰<Ðùó 1ùò 9s   ®C-Â	C3ÂC3c            	      ó0  — t         t        d      } t        j                  | D �cg c]  }t        |   ‘Œ c}t
        «      }t        j                  |dz  j                  d«      «      }t        |j                  «       «      dz  }||z  }t        j                  t        j                  dd|dz  j                  d«      z
  «      «      }t        j                  |dd…df   |dd…df   |g«      }|t        j                  j                  |dd	¬
«      z  }|S c c}w )ua   Approximate 10â€“10 positions as unit-sphere vectors from planar _LAP_XY (hemisphere projection).rS   r‰   r   gR¸…ëQð?r>   r   Nr   T)r   r@   )r
   r   r   rK   r+  r˜   rm   r’   rp   rn   Úcolumn_stackrk   Únorm)r1  rZ   r2  rŸ   ÚscaleÚxy_nÚzÚposs           r6   Ú_montage_unit_sphererU  /  sâ   € ä”S˜‘^Ñ$€EÜ	�‰¡uÓ-¡u !”7˜1“: uÑ-¬uÓ	5€BÜ
�‰��q‘—‘˜aÓ Ó!€AÜ�!—%‘%“'‹N˜TÑ!€EØ�‰:€DÜ
�‰”—
‘
˜3  t¨q¡y§o¡o°aÓ&8Ñ 8Ó9Ó:€AÜ
�/‰/˜4¢ 1 ™: tªA¨q¨D¡z°1Ð5Ó
6€CØŒ2�9‰9�>‰>˜# A°ˆ>Ó5Ñ5€CØ€Jùò .s   ¤Dc                 ó"  — t        j                  |t        «      }t        j                  | dz   f|j                  z   t        «      }d|d<   | dk\  r||d<   t        d| «      D ]+  }d|z  dz   |z  ||   z  |||dz
     z  z
  |dz   z  ||dz   <   Œ- |S )z[P_0..P_n_max evaluated at x (any shape) via Bonnet recurrence. Returns (n_max+1, *x.shape).r   r   r   r‰   )r   r   r˜   ÚemptyrH   ri   )Ún_maxr)   Úoutr   s       r6   Ú_legendre_PnrZ  <  s›   € ä
�
‰
�1”eÓ€AÜ
�(‰(�E˜A‘I�< !§'¡'Ñ)¬5Ó
1€CØ€Cˆ�FØ�‚zØˆˆA‰Ü�1�eŽ_ˆØ˜1‘u˜q‘y A‘o¨¨A©Ñ.°°S¸¸Q¹±Z±Ñ?ÀAÈÁEÑJˆˆA�‰EŠ
ð à€Jr8   c                 óÌ  — |€
t        «       nt        j                  |t        «      }t        j                  ||j
                  z  dd«      }t        ||«      }t        j                  |«      }t        j                  |«      }t        | «      }t        d|dz   «      D ]D  }d|z  dz   }	||	||z  |dz   |z  z  z  ||   z  z  }||	||dz
  z  |dz   |dz
  z  z  z  ||   z  z  }ŒF ||fS )u)  Perrin et al. spherical-spline G and H kernels on the 58-ch montage (or a subset of unit vectors).

    G_ij = Î£_n (2n+1) / (n^m (n+1)^m) P_n(cos Î¸_ij)
    H_ij = -Î£_n (2n+1) / (n^{m-1} (n+1)^{m-1}) P_n(cos Î¸_ij)
    with m = stiffness. Same-time spatial operator (no temporal lookahead).
    r!  r   r   r‰   )
rU  r   r   r˜   Úclipro   rZ  r$   r   ri   )
Ú	stiffnessÚn_termsrT  ÚcosangÚPnÚGÚHÚmr   Útwos
             r6   Úspherical_spline_Ghre  H  sñ   € ð %( KÔ
Ô
 ´R·Z±ZÀÄUÓ5K€CÜ�W‰W�S˜3Ÿ5™5‘[ $¨Ó,€FÜ	�g˜vÓ	&€BÜ
�‰�fÓ€AÜ
�‰�fÓ€AÜˆI‹€AÜ�1�g ‘kÖ"ˆØ�!‰e�a‰iˆØ	ˆS�Q˜!‘V  Q¡¨1¡Ñ-Ñ.°°A±Ñ6Ñ6ˆØ	ˆS�Q˜1˜q™5‘\ q¨1¡u°!°a±%Ñ&8Ñ9Ñ:¸RÀ¹UÑBÑB‰ð #ð ˆaˆ4€Kr8   c                 ó¨  — t         t        d      }t        |«      }t        «       }| €t	        j
                  |t        «      } nt	        j                  | t        «      } t	        j                  | «      }t        |«      }t	        j                  ||ft        «      }	|dk(  r|	S t        ||||   ¬«      \  }
}t	        j                  |dz   |dz   ft        «      }|
|t	        j                  |«      z  z   |d|…d|…f<   d|d|…|f<   d||d|…f<   t        j                  j                  |«      }||d|…d|…f   z  }||	t	        j                  ||«      <   |	S )u¥  CÃ—C Perrin CSD transform for (a subset of) present channels: y = x @ L.T on present cols.

    Solves the rigid spherical-spline system on the present electrodes only (absent stay zero):
      [G+Î»I  1] [c ]   [v]
      [1^T    0] [c0] = [0]
    then CSD = H @ c. Equivalent linear map L such that csd = L @ v (column vector).
    Distinct from nearest-neighbour surface_laplacian (ch âˆ’ mean of â‰¤k neighbours).
    rS   Nr   )r]  r^  rT  r   r   )r
   r   r#   rU  r   ÚonesÚboolr   r=  rG   r˜   re  rh   rk   rF  rC  )r\   r]  r^  Úlamr1  rw   Úpos_allrE  r_   ÚLfullra  rb  ÚAÚAinvÚTcs                  r6   Úspherical_csd_matrixro  \  sB  € ô ”S˜‘^Ñ$€EÜˆE‹
€AÜ"Ó$€GØ€|Ü�w‰w�qœ$Ó‰ä�z‰z˜$¤Ó%ˆÜ
�.‰.˜Ó
€CÜˆC‹€AÜ�H‰H�a˜�VœUÓ#€EØˆA‚vØˆÜ¨¸GÈÐQTÉÔV�D€A€qä
�‰�!�a‘%˜˜Q™�¤Ó'€AØ�Cœ"Ÿ&™& ›)‘OÑ#€A€b€q€bˆ"ˆ1ˆ"€f�IØ€A€b€q€bˆ!€e�HØ€A€aˆˆ!ˆ€e�Hô �9‰9�=‰=˜Ó€DØ	
ˆT�"�1�"�b�q�b�&‰\Ñ	€BØ €EŒ"�&‰&��cÓ
ÑØ€Lr8   c                  ó.   — t         €
t        «       a t         S ©N)Ú_SPH_CSD_FULLro  r…   r8   r6   Ú_sph_csd_fullrs  ƒ  s   € äÐÜ,Ó.ˆÜÐr8   c                 óF  — t        j                  | t         j                  «      } | j                  d«      dkD  }|j	                  «       st        j
                  | «      S |j                  «       rt        «       }nt        ||||¬«      }| |j                  z  }d|dd…| f<   |S )zôSpherical-spline / CSD surface Laplacian on present channels. Keeps C channels.

    Same-time spatial mix only. Absent (zero-variance) channels stay zero and are excluded
    from the spline solve (no interpolation of missing electrodes).
    r   ©r\   r]  r^  ri  r>   N)
r   r   r   rc   r�   r$   Úallrs  ro  ro   )r)   r]  r^  ri  r\   rG  r5   s          r6   Úspherical_surface_laplacianrw  Š  sƒ   € ô 	�
‰
�1”b—j‘jÓ!€AØ�5‰5�‹8�a‰<€DØ�8‰8Œ:Ü�}‰}˜QÓÐØ‡x�x„zÜ‹O‰ä  d°iÈÐVYÔZˆØ	ˆA�C‰C‰€AØ€A‚aˆ$ˆ€h�KØ€Hr8   c                 ó  — t        j                  |«      }t        ||||¬«      }|t        j                  ||«         }t        j                  | t
        «      t        j                  ||«         }||z  |j                  z  S )zHMap a sensor-space covariance into spherical-spline CSD space (L R L^T).ru  )r   r=  ro  rC  r   r˜   ro   )	rx   r\   r]  r^  ri  rE  rG  ÚLprH  s	            r6   Úspherical_laplacian_priorrz  �  sh   € ä
�.‰.˜Ó
€CÜ $°)ÀWÐRUÔV€AØ	
Œ2�6‰6�#�sÓÑ	€BÜ	�‰�A”uÓ	œbŸf™f S¨#Ó.Ñ	/€BØ�‰7�R—T‘T‰>Ðr8   c           
      óÚ  — | j                  d«      syt        j                  t        t        j
                  j                  dd| d   › d�«      «      «      }t        j                  |«      j                  d«      dkD  }| j                  d«      rt        ||«      S | j                  d«      rt        ||«      S | j                  d	«      rt        ||«      S |t        j                  ||«         S )
a3  Start value of the EA covariance: None (identity) or the fixed population prior of build_ea_prior.py, cut to
    the channels present in this recording (prep key ea_prior). A Laplacian/bipolar prep maps that prior by L R L^T so the
    shrinkage target lives in the same space as the spatially remapped EEG.Úea_priorNÚcacheÚ	ea_prior_z.npyr   Ú	laplacianÚspherical_laplacianÚbipolar)Úgetr   Úloadr   ÚosÚpathÚjoinr   rc   rI  rz  rM  rC  )ÚPr)   rx   r\   s       r6   r|  r|  ¦  sÁ   € ð �5‰5�ÔØÜ
�‰”œRŸW™WŸ\™\¨'°Y¸qÀ¹}¸oÈTÐ3RÓSÓTÓU€AÜ�:‰:�a‹=×Ñ˜QÓ !Ñ#€DØ‡u�uˆ[ÔÜ˜q $Ó'Ð'Ø‡u�uÐ"Ô#Ü(¨¨DÓ1Ð1Ø‡u�uˆYÔÜ˜Q Ó%Ð%ØŒR�V‰V�D˜$ÓÑ Ð r8   c                 ó4   ‡— ddl mŠ ˆfd„}t        | |¬«      S )ziRecording order of a subject's trials: orig_pos when the dataset stores it (>= 0), else the trial number.r   )r   c                 óÚ   •—  ‰| d   «      j                  d«      }|�6t        j                  |«      r!t        t        j                  |«      d   «      nd}|dk\  r|ndt        | d   «      fS )Nr:   Úorig_posr   r*  i@B Útrial)r‚  r   Úsizer   Úravel)rŸ   ÚopÚvr   s      €r6   rT  ztrial_order.<locals>.pos¹  s]   ø€ Ù˜˜5™Ó"×&Ñ& zÓ2ˆØ$& N´r·w±w¸r´{ŒC”—‘˜“˜Q‘Ô ÈˆØ˜!’V‘ ¬#¨a°©j«/Ð:Ð:r8   )r:   )rÃ   r   Úsorted)ÚrowsrT  r   s     @r6   Útrial_orderr’  ¶  s   ø€ å"ô;ô �$˜CÔ Ð r8   c                 ó   — t         d   |   }d\  }}}}t        | «      D �]Û  }t        ||d   «      }t        ||d   t         d   ddd¬«      }	t	        |	d	   «      t	        |	d
   «      c|	d	<   |	d
<   |j                  d«      rt        |	d	   t         d   |¬«      \  |	d	<   }|j                  d«      rDt        |	d	   t         d   |d   |j                  dd«      |d|j                  d«      ¬«      \  |	d	<   }t        |	d	   t         d   |j                  dd«      |d¬«      \  |	d	<   }t        j                  j                  |«      r�Œ&t        j                  t        j                  j                  |«      d¬«       t        j                  ||	d	   j!                  t        j"                  «      |	d
   j!                  t        j"                  «      |	d   j!                  t        j$                  «      |	d   ¬«       |dz  }�ŒÞ |S )zÙCausal EA with the covariance estimate CARRIED across the subject's trials in recording order (a device
    keeps adapting to its user). Still causal: each trial only uses earlier samples of itself and earlier trials.Úpreps)NNNr   r:   ÚvariantrS   TF©Údo_carÚdo_runzÚdo_trimrD   rE   Úband_eqr*   )r›   Útw_orderÚtw_strengthr   Útw_recolor_acf)r™   rš   r›   rœ   r�   Úea_tauç      N@)rq   rt   ru   ©Úexist_okrA   rF   ©rD   rE   r^   Út0r   )r   r’  r   r   re   r‚  rº   r¨   r‚   r„  r…  ÚexistsÚmakedirsÚdirnamer   ÚsavezrI   Úfloat32Úint8)
r‘  Úprepr‡  rx   ÚBQÚTWr   rR   r/   r3  s
             r6   Úbuild_subject_carryr­  À  sº  € ô 	ˆG‰�TÑ€AØ&�L€A€rˆ2ˆqÜ˜4× ˆÜ�t˜S ™ZÓ(ˆÜ�C˜˜9™¤s¨9¡~¸dÈEÐ[_Ô`ˆÜ)¨!¨E©(Ó3´\À!ÀEÁ(Ó5KÐˆˆ%‰�!�E‘(Ø�5‰5�ÔÜ)¨!¨E©(´C¸±IÀRÔH‰LˆAˆe‰H�bØ�5‰5�ÔÜ$ Q u¡X¬s°4©yÀÀ*ÁÐXY×X]ÑX]Ð^kÐmpÓXqØ+-¸DÈaÏeÉeÐTdÓNeôg‰LˆAˆe‰H�bä  %¡¬#¨d©)¸1¿5¹5ÀÈ4Ó;PÐUVÐaeÔf‰ˆˆ%‰�!Ü�w‰w�~‰~˜aÖ Ü�K‰KœŸ™Ÿ™¨Ó*°TÕ:Ü�H‰H�Q˜A˜e™HŸO™O¬B¯J©JÓ7¸Q¸u¹X¿_¹_ÌRÏZÉZÓ=XØ˜9™×,Ñ,¬R¯W©WÓ5¸!¸F¹)õEà�‰FŠAð !ð €Hr8   c           
      ó(  — ddl m}m}m}m} |dz  } ||d|dz  dz
  gdgd|¬«      }	g }
|D ]Ð  \  }} | |d||gd|d	¬
«      | d¬«      } ||	dg|d¬«       }t        j                  t        j                  || j                  d   f«      |d|  g«      }t        j                  |dz  |dz  z   «      dz   }||z  ||z  }}d|dd…| j                  d«      dk(  f<   d|dd…| j                  d«      dk(  f<   |
||gz  }
ŒÒ t        j                  |
«      S )a¥  E1: CAUSAL instantaneous phase per band: causal Butterworth band-pass, then an analytic signal from a causal
    FIR Hilbert transformer (taps = 2D+1, equiripple) paired with the band signal delayed by D samples:
    z(t) = x_b(t - D) + i H{x_b}(t), i.e. the phase of time t - D computed from samples <= t (a fixed delay, no
    lookahead). Returns [cos(phase), sin(phase)] per band and channel -> (T, 4 C) for two bands.r   )r®   Úremezr¯   r‹   r‰   g333333ã?r   Úhilbert)r   r*   r°   r±   r²   r   r   Ng•Ö&è.>r>   )r–   r®   r¯  r¯   r‹   r   rŒ   rG   rH   rm   rc   Úhstack)r)   r*   r·   Útapsr®   r¯  r¯   r‹   ÚDÚhrY  r+   r,   ÚxbÚimÚreÚmagrZ   Ús_s                      r6   Úcausal_phaserº  ×  s0  € ÷
 =Ó<Ø�‰	€AÙˆd�S˜"˜q™& 3™,Ð'¨#¨°YÀ2ÔF€AØ
€CÛ‰ˆˆBÙ‘V˜A  B˜x¨¸À5ÔIÈ1ÐSTÔUˆÙ�a˜#˜ ¨Ô+Ð+ˆÜ�Y‰YœŸ™ ! Q§W¡W¨Q¡Z Ó1°2°c¸°r°7Ð;Ó<ˆÜ�g‰g�b˜A‘g  a¡Ñ'Ó(¨4Ñ/ˆØ�S‘˜"˜s™(ˆ2ˆØ!ˆŠ!ˆQ�U‰U�1‹X˜‰]Ð
ÑØ"ˆŠ1ˆa�e‰e�A‹h˜!‰mÐÑØ��2ˆw‰‰ð ô �9‰9�S‹>Ðr8   c           	      óB  — t         d   |   }t        || d   «      }t        j                  j	                  |«      ryt        j                  t        |d   | d   «      «      }t        |d   j                  t
        j                  «      t         d   «      }t        j                  t        j                  j                  |«      d¬«       t        j                  |t        j                  |d   |j                  t
        j                  «      g«      |d	   |d
   |d   ¬«       y)z`prep with 'phase_of': base prep cache + causal cos/sin phase channels (delta, theta) of its EEG.r”  r:   r   Úphase_ofrD   r*   Tr   rE   r^   r£  r¢  r   )r   r   r„  r…  r¤  r   rƒ  rº  rI   r   r¥  r¦  r§  r±  r¨  )rR   rª  r‡  r/   rS  Úphs         r6   Úbuild_phaser¾  ì  sÔ   € äˆG‰�TÑ€AÜ�4˜˜U™Ó$€AÜ	‡w�w‡~�~�aÔØÜ
�‰”
˜1˜Z™=¨#¨e©*Ó5Ó6€AÜ	�a˜‘h—o‘o¤b§j¡jÓ1´3°t±9Ó	=€BÜ‡K�K”—‘—‘ Ó"¨TÕ2Ü‡H�HˆQ”B—I‘I˜q ™x¨¯©´2·:±:Ó)>Ð?Ó@ÀaÈÁhÐTUÐV[ÑT\ÐabÐcgÑahÕiØr8   c           	      ób  — t         d   |   }t        || d   «      }t        j                  j	                  |«      ryt        j                  t        |d   | d   «      «      }t        t        t        |d   «      t         d   z  «      «      }t        | t        |d   «      |«      }t        j                  t        j                  j                  |«      d¬	«       t        j                  |t        j                  |d   |j!                  t
        j"                  «      g«      |d
   |d   |d   ¬«       y)zbprep with 'gamma_of': copy the base prep's cache and append the 58 causal gamma-envelope channels.r”  r:   r   Úgamma_ofr£  r*   rD   Tr   rE   r^   r¢  r   )r   r   r„  r…  r¤  r   rƒ  r   rO   r˜   rÇ   r#   r¥  r¦  r§  r±  rI   r¨  )rR   rª  r‡  r/   rS  r_   r2   s          r6   Úbuild_gammarÁ  ù  sé   € äˆG‰�TÑ€AÜ�4˜˜U™Ó$€AÜ	‡w�w‡~�~�aÔØÜ
�‰”
˜1˜Z™=¨#¨e©*Ó5Ó6€AÜŒE”%˜˜$™“.¤3 t¡9Ñ,Ó-Ó.€AÜ�sœC  %¡›M¨1Ó-€AÜ‡K�K”—‘—‘ Ó"¨TÕ2Ü‡H�HˆQ”B—I‘I˜q ™x¨¯©´"·*±*Ó)=Ð>Ó?ÀQÀuÁXÐSTÐUZÑS[Ð`aÐbfÑ`gÕhØr8   c                 ó¶  — t        || d   «      }t        j                  j                  |«      ryt        d   |   }|d   dk(  r8|d   dk(  sJ ‚t        | t        d   t        |j                  d	d
«      «      «      }n!t        | |d   t        d   d|d   dk(  d¬«      }|j                  d«      r°t        |d   «      }|d   t        d   |z  k(  sJ |d   t        d   |f«       ‚|j                  d«      r4t        |d   |d   |d   ¬«      |d<   t        |d   |d   |d   ¬«      |d<   |d   d d |…   |d   d d |…   c|d<   |d<   |d   d d |…   |d<   t        d   |d<   |d   dk(  r#t        |d   «      t        |d   «      c|d<   |d<   |j                  d«      r*t        |d   |d   «      |d<   t        |d   |d   «      |d<   |j                  d«      rt        |d   «      |d<   |j                  d«      rt        |d   «      |d<   |j                  d«      rt        |d   «      |d<   |j                  d«      dk(  rZt        |d   t        d   |j                  dd«      t!        ||d   «      |j                  d«      |j                  dd«      ¬ «      |d<   |d   t        d   k(  sJ ‚t        j"                  t        j                  j%                  |«      d¬!«       t'        j(                  ||d   j+                  t&        j,                  «      |d   j+                  t&        j,                  «      |d   j+                  t&        j.                  «      |d"   ¬#«       y$)%Nr:   r   r”  r•  r!   rP  r‹  rS   rT   ©r   r«   TÚrunningr–  Úwide_dsr*   Ú
wide_lp_hzrD   )r*   rE   rA   Ú
lowpass_hzr  r€  r�  ÚeaÚcausalrž  rŸ  Úea_n0Ú	ea_shrinkr  )rq   rt   rv   rs   r   rF   r¢  r   )r   r„  r…  r¤  r   r`   Útupler‚  r   r   r:  re   r@  rw  rK  r‚   r|  r¥  r¦  r   r§  rI   r¨  r©  )rR   rª  r/   r‡  r3  rY   s         r6   ÚbuildrÍ    s2  € Ü�4˜˜U™Ó$€AÜ	‡w�w‡~�~�aÔØÜˆG‰�TÑ€AØˆ�|�uÒØ�‰y˜GÒ#Ð#Ð#Ü�Sœ#˜i™.¬%°·±°f¸jÓ0IÓ*JÓK‰ä�C˜˜9™¤s¨9¡~¸dÈAÈfÉIÐYbÑLbÐlpÔqˆà‡u�uˆYÔÜ��)‘ÓˆØ�‰wœ#˜d™) a™-Ò'Ð@¨!¨D©'´3°t±9¸aÐ)@Ó@Ð'Ø�5‰5�ÔÜ% a¨¡h°°,±ÀAÀdÁGÔLˆAˆe‰HÜ% a¨¡h°°,±ÀAÀdÁGÔLˆAˆe‰HØ˜u™X¡c¨ c™]¨A¨e©H±S°q°S©MÐˆˆ%‰�!�E‘(Ø˜‘|¡C a CÑ(ˆˆ)‰Ü�d‘)ˆˆ$‰àˆ�y�GÒä)¨!¨E©(Ó3´\À!ÀEÁ(Ó5KÐˆˆ%‰�!�E‘(Ø‡u�uˆ\ÔÜ! ! E¡(¨A¨l©OÓ<ˆˆ%‰Ü! ! E¡(¨A¨l©OÓ<ˆˆ%‰Ø‡u�uˆ[ÔÜ$ Q u¡XÓ.ˆˆ%‰Ø‡u�uÐ"Ô#Ü.¨q°©xÓ8ˆˆ%‰Ø‡u�uˆYÔÜ" 1 U¡8Ó,ˆˆ%‰Ø‡u�uˆTƒ{�hÒÜ˜Q˜u™X¤s¨4¡y¸¿¹¸hÈÓ8MÔRZÐ[\Ð^_Ð`eÑ^fÓRgÐlm×lqÑlqÐryÓlzØ$%§E¡E¨+°sÓ$;ô=ˆˆ%‰àˆT‰7”c˜$‘iÒÐÐÜ‡K�K”—‘—‘ Ó"¨TÕ2Ü‡H�HˆQ�A�e‘H—O‘O¤B§J¡JÓ/°Q°u±X·_±_ÄRÇZÁZÓ5PÐVWÐXaÑVb×ViÑViÔjl×jqÑjqÓVrØ�&‘	õàr8   Ú__main__r   r”  r¼  )Ún_jobsc              #   óV   K  — | ]!  \  }} t        t        «      |t        «      –— Œ# y ­wrq  )r   r¾  rª  ©r†   Ú_rŸ   s      r6   rˆ   rˆ   6  ó$   è ø€ Ð"[É]ÁTÀQÈÐ#7¤7¬;Ó#7¸¼4×#@É]ùó   ‚')ÚbuiltÚofrÀ  c              #   óV   K  — | ]!  \  }} t        t        «      |t        «      –— Œ# y ­wrq  )r   rÁ  rª  rÑ  s      r6   rˆ   rˆ   :  rÓ  rÔ  Úea_carryÚsubj_uidÚrecordsc              #   óP   K  — | ]  } t        t        «      |t        «      –— Œ  y ­wrq  )r   r­  rª  )r†   Úrss     r6   rˆ   rˆ   ?  s#   è ø€ Ð"YÑTXÈbÐ#?¤7Ô+>Ó#?ÀÄD×#IÑTXùs   ‚$&c              #   óV   K  — | ]!  \  }} t        t        «      |t        «      –— Œ# y ­wrq  )r   rÍ  rª  rÑ  s      r6   rˆ   rˆ   B  s"   è ø€ ÐQÁ=¹4¸1¸a˜~œw¤u›~¨a´×6Á=ùrÔ  )g      Ð?ç      @)rÃ  )rŸ  r   r  NFN)é   rŸ  r   rü   r   NFN)NrŸ  r   )rñ   r¾   rq  )r¾   é2   N)Nr¾   rà  çñhãˆµøä>)r¾   rà  rá  )))r   rÞ  )rÞ  g       @é   )LÚ__doc__r„  ÚsysÚnumpyr   Újoblibr   r   r…  Úinsertr¦  ÚabspathÚ__file__Ú
common_expr   r   r   rÃ   rP   r   rJ   r	   r
   r   r   r   r   r   r   r–   r   r7   r`   re   r‚   r¨   r´   rº   rÇ   r+  r6  r<  r:  r@  rI  rK  rM  rU  rZ  re  ro  rr  rs  rw  rz  r|  r’  r­  rº  r¾  rÁ  rÍ  Ú__name__ÚtiÚargvrª  r‚  Úiterrowsr   Úprintr’   r#   ÚgroupbyÚlistÚto_dictÚsubs)rÒ  r2   s   00r6   Ú<module>rô     s+  ðñtó 
Û 
ã ß $à ‡�‡���2—7‘7—?‘? 2§7¡7§?¡?°8Ó#<Ó=Ô >ß 4Ñ 4ß |× |× |Ý  óó"hò0 ó%ð< lqØó-)ð` 1€	ó'ò,ð4Ø	ˆ=ðØ ðØ/4°lðà	ˆ=ðà ðð 	ˆ-ðð ˜}ðð /3°Mðð DHÈðð Y]Ð^jðð 	ˆ,ð	ð ˜lð	ð -1°,ð	ð AEÀlð	ð
 
ˆ=ðð
   ðð
 16°}ñð
 GLÈ]ðð
 ]bÐcoðð 
ˆ<ðð  ðð /4°\ðð DIÈ,ðð 	ˆ-ðð ˜}ðð /3°Mðð DHÈðð Y]Ð^jðð 	ˆ,ðð ˜lðð -1°,ðð AEÀlðð 
ˆ>ðð ! .òð 38¸ðð JOÐP^ðð afÐgtðð 
ˆ=ðð   ðð 16°}ðð GLÈ]ðð 	ˆ.ðð  ðð 15°nðð GKÈNðð ]aÐboðð 	ˆ-ðð ˜}ðð /3°Mðð DHÈðð 
ˆ>ñð #1¸È}ÐerØ
 °]ò€ó$
ñ  Ó!€	ó	óó óó"ò
ò	óó( ðH €òóó&ò!ò !òó.ò*
òò(ðV ˆzÓÙ	‹€BØ—‘˜!˜"�Ò-  W¡Ó-ˆØˆw‰<˜Ñ×!Ñ! *Ô-Ø"‘ Ô"Ñ"[ÈRÏ[É[Ì]Ó"[Ó[ˆAÙ�$˜¡ Q£¨©s°2«wÔ7ØØˆw‰<˜Ñ×!Ñ! *Ô-Ø"‘ Ô"Ñ"[ÈRÏ[É[Ì]Ó"[Ó[ˆAÙ�$˜¡ Q£¨©s°2«wÔ7ØØˆw‰<˜Ñ×!Ñ! *Ô-Ø;=¿:¹:ÀjÔ;QÔRÑ;Q±4°1°a‘D˜Ÿ™ 9Ó-Õ.Ð;QÒRˆDØ"‘ Ô"Ñ"YÑTXÓ"YÓYˆAÙ�$˜¡ Q£¨©s°2«wÔ7ÙØ‰H˜AÔÑQÀ2Ç;Á;Ä=ÓQÓQˆÙˆd�G™S ›V T©3¨r«7Ö3ñ .ð ùó Ss   Ê!L4