ó
    ¾åÀj±=  ã            
       óÐ  • S r SSKrSSKrSSKrSSKJrJr  \R                  R                  S\R                  R                  \R                  R                  \5      5      5        SSKJrJr  SSKJrJrJrJrJrJrJrJrJrJr  SSKJr  S%S jrS&S jrS	 r S'S
 jr!  S(S jr"Sr#S)S jr$S r%S r&S r'S*S jr(S r)S r*S r+\,S:X  Ga˜  \" 5       r-\R\                  SS =(       d    \S    GHp  r/\S   \/   Ra                  S5      (       a;  \" SS9" S \-Rc                  5        5       5      r2\3" \/S\4" \25      S\5" \-5      5        M[  \S   \/   Ra                  S5      (       a;  \" SS9" S \-Rc                  5        5       5      r2\3" \/S\4" \25      S\5" \-5      5        M²  \S   \/   Ra                  S 5      (       ai  \-Rm                  S!5       V Vs/ s H  u  p\7" URq                  S"5      5      PM     snn r9\" SS9" S# \9 5       5      r2\3" \/S\4" \25      S\5" \-5      5        GM7  \" SS9" S$ \-Rc                  5        5       5      r2\3" \/S\4" \25      S\5" \-5      5        GMs     ggs  snn f )+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)
r   ÚFSÚB64UÚMONTAGESÚb64_idxÚload_eegÚload_envÚload_labelsÚload_ppÚtrial_index)Údetrendc                 ó  • [        [        R                  " U [        R                  5      SSS9n [	        XQ-  5      n[        R
                  " XU4S4SS9n[        R                  R                  [        U5      SU-  5      n[        R                  " U5      n	SX˜U:¬  Xƒ:*  -  '   X‚U-
  :„  X‚:  -  n
S	S	[        R                  " [        R                  XŠ   X$-
  -
  -  U-  5      -  -
  Xš'   Xƒ:„  XƒU-   :  -  nS	S	[        R                  " [        R                  X‹   U-
  -  U-  5      -  -   X›'   [        R                  R                  [        R                  R                  USS
9U	SS2S4   -  [        U5      SS9nXÆU[        U 5      -    $ )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                Úa/root/disk_3tb/EEG-sAAD-Grand-Challenge-Training-Dataset/experiments/decoder_lodo/prepare_data.pyÚfft_bandpassr6      sQ  € ô 	”—
’
˜1œbŸj™jÓ)°¸ÑA€AÜˆE‰J‹€AÜ	�Š�˜�F˜FÐ#¨)Ñ	4€BÜ
�‰�‰œ˜B›  R¡Ó(€AÜ
�Š�aÓ€AØ"€AˆB�w�1‘7ÑÑØ	
�%‰Z‰˜A™FÑ#€AØ�”r—v’vœbŸe™e q¡t¨r©zÑ':Ñ;¸eÑCÓDÑDÑD€A�DØ	
‰�A˜U™
‘NÑ#€AØ�”r—v’vœbŸe™e q¡t¨b¡yÑ1°EÑ9Ó:Ñ:Ñ:€A�DÜ
�‰�‰”R—V‘V—[‘[ ¨!�[Ð,¨q²°D°©zÑ9¼SÀ»WÈ1ˆÐM€AØˆq”3�q“6‰zˆ?Ðó    c           	      ó  • U S   n[        U 5      u  pE[        U5      n[        R                  " UR                  S   S45      n[        R
                  " USS2XE   4   [        R                  S9USS2U4'   [        U5      R                  [        R                  5      n[        [        S   -  n	[        U[        US   US   5      SSU	2   n[        U[        US   US   5      SSU	2   nSUSS2U) 4'   [        R                  " [        U    V
s/ s H  n
[        R                  " U
5      PM     sn
5      nUSS2U4   X[   pÇUSS2U4==   USS2U4   R!                  SS	S
9-  ss'   [#        U5      nUS   SSU	2   S[%        U5       n['        [%        U5      [%        U5      [%        U5      5      n[)        [+        [,        S   S   [        S   -  5      5      n[/        UUUU-
   UUUU-
   [        S   UUUU-
   U[        S   -  S9$ s  sn
f )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)   r@   Út0_s)r
   r   r   ÚzerosÚshaper   r   r   ÚastypeÚFS_RAWr   r6   Úarrayr	   r   ÚindexÚmeanr   r"   Úminr   ÚroundÚECFGÚdict)ÚrowÚmontageÚbandr9   ÚsrcÚpresentÚrawr(   ÚeÚqÚcÚselÚpresÚlabÚattr   Úks                    r5   Ú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ˆ€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                 ó¦   • [         R                  " U [         R                  5      n U R                  SSS9nSXS:H  '   X R	                  S5      -
  U-  $ )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   ÚstdrL   )r(   Úsds     r5   Úzscore_trialrd   9   sH   € ä
�
Š
�1”b—j‘jÓ!€AØ	
�‰ˆq�qˆÐ	€BØ€BˆQ�w�KØ—‘�q“	‰M˜RÑÐr7   c           
      óf  • [         R                  " U [         R                  5      n U R                  S5      S:„  nU R	                  5       nU SS2U4   n	U	R
                  S   n
Ub  UR
                  Xª4:w  a  [         R                  " U
5      OUR	                  5       nX2-  n[        X1-  5      n[        S[        U	5      U5       Hà  nXžXí-    nSU-
  U-  U[         R                  " U5      -  U
-  [         R                  " U
5      -  -   n[         R                  R                  U5      u  nnUUS[         R                  " [         R                  " US5      5      -  -  -  UR                  -  XŽXí-   2U4'   SU-
  U-  XÏR                  U-  -  [!        [        U5      S5      -  -   nMâ     U(       a  X‹4$ U$ )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).r   Nr   r   g:Œ0âŽyE>)r   r   r   rb   ÚcopyrG   Úeyer   Úranger"   ÚtraceÚlinalgÚeighÚsqrtÚmaximumÚTÚmax)r(   r)   Útau_sÚblock_sÚshrinkÚR0Úreturn_Rr[   r4   r/   ÚCÚRr2   ÚBÚs0ÚblkÚRsÚwÚVs                      r5   Ú	causal_ear}   A   sp  € ô
 	�
Š
�1”b—j‘jÓ!€AØ�5‰5�‹8�a‰<€DØ	�‰‹€AØ	
Š1ˆdˆ7‰€BØ
�‰�‰€AØ‘Z 2§8¡8°¨vÓ#5Œ�ŠˆqŒ	¸2¿7¹7»9€AØ‰€AÜˆG‰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ˆ/ÑØ�‰U�a‰K˜!Ÿu™u s™{Ñ+¬c´#°c³(¸AÓ.>Ñ>Ñ>Šñ #ö ˆAˆ6Ð$ 1Ð$r7   c
                 ó,  ^^^^ • [         R                  " U [         R                  5      n U R                  u  p«[	        U5      [	        XA-  5      XC-  smpÍUc  [         R
                  " UTS-   45      OUR                  5       nUc	  SUSS2S4'   [         R                  " [         R
                  " TU45      U /5      n[         R                  " U 5      n[         R                  " [         R                  " T5      SS2S4   [         R                  " T5      SSS24   -
  5      n[        SX¬5       GHæ  n[        XÊU-
  5      mUUUT-   T-    m USS2S4   S:„  n[         R
                  " UT45      mUR                  5       (       a^  UU   SS2U4   X^USS2S4   -  [         R                  " T5      -  -   n[         R                  R!                  UUUSS2S4   5      S   TU'   TU-  m[#        UUUU 4S j[        STS-   5       5       5      nUSS2S4   STUSS2SS24   -  R#                  S5      -  -
  [         R$                  " S	TUSS2U4   T5      -   nT TS U-
  [         R&                  " [         R(                  " U[         R*                  " US
USS2S4   -  5      S5      5      -  UUUT-   & [         R,                  " [        TS-   5       Vs/ s H&  nT TS T TU-
  TU-
  T-    -  R/                  S5      PM(     snS5      nSU-
  U-  UU-  -   nGMé     U	bÎ  SSKJn  [         R4                  " S/[         R                  " U	[6        5      ST /5      n[         R                  R!                  UU   U[         R                  " T5      -  -   USS 5      nUS   SU-  USS -  -
  UUU   -  U-  -   nU" [         R&                  " U5      /[         R4                  " S/U* /5      USS9nSUSS2U R9                  S5      S:H  4'   U(       a  UU4$ U$ s  snf )aT  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   óZ   >#   • U  H   nTTU-
  TU-
  T-    TS S 2US-
  4   -  v •  M"     g 7f)Nr   © )Ú.0r^   r2   r   r.   Úsegs     €€€€r5   Ú	<genexpr>Úcausal_tw.<locals>.<genexpr>x   s5   øé € Ð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   rG   r   rF   rf   ÚvstackÚ
empty_likeÚabsÚarangerh   rM   Úanyrg   rj   ÚsolveÚsumÚeinsumrl   Úwhererm   ÚstackrL   Úscipy.signalr‡   ÚconcatenateÚfloatrb   )!r(   r)   Úorderrp   rq   rr   ÚstrengthÚstateÚreturn_stateÚrecolor_acfrn   ru   rw   ÚalÚrr/   r4   Úiirx   Úokrv   ÚpredÚevr^   Úrbr‡   ÚrcÚacÚevcr2   r   r.   r‚   s!                                @@@@r5   Ú	causal_twr¤   W   s¬  û€ ô 	�
Š
�1”b—j‘jÓ!€AØ�7‰7�D€AÜ�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ˆÜ��r‘6‹NˆØ��B˜‘F˜Q‘JÐˆØŠq�!ˆt‰W�u‰_ˆÜ�HŠH�a˜�VÓˆØ�6‰6�8‰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   Ë-P
))r   ç      @)r¥   ç      @)r¦   ç      "@c                 ój  • SSK JnJn  [        R                  " U [        R
                  5      n U R                  S5      S:„  nU R                  S   [        XA-  5      p˜[         V
Vs/ s H  u  p«U" U" SX«/SUSS9U SS9PM     nn
nUc.  [        R                  " [        U5      U4S
[        U5      -  5      OUR                  5       nXC-  n[        R                  " U 5      n[        S[        U 5      U	5       H†  n[        U5       Ht  u  nnUUUU	-    nUUUU	-   === U[        R                   " [        R"                  " UU   S5      5      -  -  sss& SU-
  UU   -  UUS-  R%                  S5      -  -   UU'   Mv     Mˆ     SUS	S	2U) 4'   U[        R                   " [        U5      5      -  U4$ s  snn
f )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   rb   rG   r   Ú	BEQ_BANDSÚfullr"   rf   r#   rh   Ú	enumeraterl   rm   rL   )r(   r)   r—   rp   rq   rª   r«   r[   ru   rw   r*   r+   ÚbandsÚPwr2   r4   rx   Úir3   ry   s                       r5   Úcausal_band_eqr¶   Š   s�  € ÷
 -Ü
�
Š
�1”b—j‘jÓ!€AØ�5‰5�‹8�a‰<€DØ�7‰7�1‰:”s˜7™<Ó(€qÝdmÔnÒdmÑZ`ÐZ\‰W‘V˜A ˜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                 óz  • SSK JnJn  SSKJnJnJnJnJn	  U" U 5      u  p«U" U S   5      n[        R                  " UR                  S   S45      n[        R                  " USS2X«   4   [        R                  S9USS2U4'   [        R                  " U[        S       Vs/ s H  oåR                   " U5      PM     sn5      nUSS2U4   X¿   nnUSS2U4==   USS2U4   R#                  S	S
S9-  ss'   Sn[        R$                  " U" U" SSS/SUSS9USS95      nU" U" SSSUSS9USS9SSU[        S   -  2   nU	" U[        S   5      nSUSS2U) 4'   UX"U-    n['        U5      U:  aG  [        R(                  " U[        R                  " U['        U5      -
  UR                  S	   45      /5      nU$ s  snf )a(  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_zr9   r:   Nr;   rR   r   Tr>   é€   é   é   é(   r¬   r­   r®   r   r…   é   Úlowpassr)   r=   )r’   rª   r«   Úcommonr   r	   r
   r   r¸   r   rF   rG   r   r   rJ   r   rK   rL   rŠ   r"   rˆ   )rQ   Ún_outÚk_trimrª   r«   r   r	   r
   r   r¸   rT   rU   rV   r(   rY   rZ   r[   Úfs_rawr1   s                      r5   Ú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’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   Â"F8c                 ó.   ^• SSK Jm  U4S jn[        XS9$ )ziRecording order of a subject's trials: orig_pos when the dataset stores it (>= 0), else the trial number.r   )r   c                 óì   >• T" U S   5      R                  S5      nUb=  [        R                  " U5      (       a"  [        [        R                  " U5      S   5      OSnUS:¼  a  UOS[        U S   5      4$ )Nr9   Úorig_posr   éÿÿÿÿi@B Útrial)Úgetr   Úsizer   Úravel)r›   ÚopÚvr   s      €r5   ÚposÚtrial_order.<locals>.pos»   s_   ø€ Ù˜˜5™Ó"×&Ñ& zÓ2ˆØ$&¡N´r·w²w¸r·{±{ŒC”—’˜“˜Q‘Ô ÈˆØ˜!“V‘ ¬#¨a°©j«/Ð:Ð:r7   )r9   )r¿   r   Úsorted)ÚrowsrÎ   r   s     @r5   Útrial_orderrÒ   ¸   s   ø€ å"õ;ô �$Ñ Ð r7   c                 óú  • [         S   U   nSu  p4pV[        U 5       GHÙ  n[        XS   5      n[        XrS   [         S   SSSS9n	[	        U	S	   5      [	        U	S
   5      sU	S	'   U	S
'   UR                  S5      (       a  [        U	S	   [         S   US9u  U	S	'   nUR                  S5      (       aA  [        U	S	   [         S   US   UR                  SS5      USUR                  S5      S9u  U	S	'   n[        U	S	   [         S   UR                  SS5      USS9u  U	S	'   n[        R                  R                  U5      (       a  GM(  [        R                  " [        R                  R                  U5      SS9  [        R                  " X‰S	   R!                  [        R"                  5      U	S
   R!                  [        R"                  5      U	S   R!                  [        R$                  5      U	S   S9  US-  nGMÜ     U$ )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   r9   ÚvariantrR   TF©Údo_carÚdo_runzÚdo_trimrC   rD   Úband_eqr)   )r—   Útw_orderÚtw_strengthr   Útw_recolor_acf)r•   r–   r—   r˜   r™   Úea_tauç      N@)rp   rs   rt   ©Úexist_okr@   rE   ©rC   rD   r]   Út0r   )r   rÒ   r   r   rd   rÉ   r¶   r¤   r}   ÚosÚpathÚexistsÚmakedirsÚdirnamer   ÚsavezrH   Úfloat32Úint8)
rÑ   ÚprepÚPrv   ÚBQÚTWr   rQ   r.   Úds
             r5   Úbuild_subject_carryrñ   Â   s¹  € ô 	ˆG‰�TÑ€AØ&�L€Aˆ2Ü˜4× ˆÜ�t ™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˜e™HŸO™O¬B¯J©JÓ7¸Q¸u¹X¿_¹_ÌRÏZÉZÓ=XØ˜9™×,Ñ,¬R¯W©WÓ5¸!¸F¹)òEà�‰F‹Añ !ð €Hr7   c                 ó  • SSK JnJnJnJn  US-  nU" USUS-  S-
  /S/SUS9n	/ n
U HÈ  u  p¼U" U" SX¼/SUS	S
9U SS9nU" U	S/USS9* n[
        R                  " [
        R                  " X€R                  S   45      USU*  /5      n[
        R                  " US-  US-  -   5      S-   nUU-  UU-  nnSUSS2U R                  S5      S:H  4'   SUSS2U R                  S5      S:H  4'   U
UU/-  n
MÊ     [
        R                  " U
5      $ )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ˆ   rF   rG   rl   rb   Úhstack)r(   r)   r³   Útapsrª   ró   r«   r‡   ÚDÚhÚoutr*   r+   ÚxbÚimÚreÚmagrY   Ús_s                      r5   Úcausal_phaserÿ   Ù   s*  € ÷
 =Ó<Ø�‰	€AÙˆd�S˜"˜q™& 3™,Ð'¨#¨°YÀ2ÑF€AØ
€CÛ‰ˆÙ‘V˜A ˜x¨¸À5ÑIÈ1ÐSTÑUˆÙ�a˜#˜ ¨Ñ+Ð+ˆÜ�YŠYœŸš !§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‹>Ðr7   c           	      óF  • [         S   U   n[        XS   5      n[        R                  R	                  U5      (       a  g[
        R                  " [        US   U S   5      5      n[        US   R                  [
        R                  5      [         S   5      n[        R                  " [        R                  R                  U5      SS9  [
        R                  " U[
        R                  " US   UR                  [
        R                  5      /5      US	   US
   US   S9  g)z`prep with 'phase_of': base prep cache + causal cos/sin phase channels (delta, theta) of its EEG.rÔ   r9   r   Úphase_ofrC   r)   Trà   rD   r]   rã   râ   r   )r   r   rä   rå   ræ   r   Úloadrÿ   rH   r   rç   rè   ré   rõ   rê   )rQ   rì   rí   r.   ÚzÚphs         r5   Ú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Ør7   c           	      óf  • [         S   U   n[        XS   5      n[        R                  R	                  U5      (       a  g[
        R                  " [        US   U S   5      5      n[        [        [        US   5      [         S   -  5      5      n[        U [        US   5      U5      n[        R                  " [        R                  R                  U5      SS	9  [
        R                  " U[
        R                  " US   UR!                  [
        R"                  5      /5      US
   US   US   S9  g)zbprep with 'gamma_of': copy the base prep's cache and append the 58 causal gamma-envelope channels.rÔ   r9   r   Úgamma_ofrã   r)   rC   Trà   rD   r]   râ   r   )r   r   rä   rå   ræ   r   r  r   rN   r”   rÃ   r"   rç   rè   ré   rõ   rH   rê   )rQ   rì   rí   r.   r  r^   r1   s          r5   Ú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Ør7   c           
      óŽ  • [        XS   5      n[        R                  R                  U5      (       a  g[        S   U   nUS   S:X  a9  US   S:X  d   e[        U [        S   [        UR                  S	S
5      5      5      nO[        XS   [        S   SUS   S:H  SS9nUS   S:X  a#  [        US   5      [        US   5      sUS'   US'   UR                  S5      S:X  a(  [        US   [        S   UR                  SS5      S9US'   US   [        S   :X  d   e[        R                  " [        R                  R                  U5      SS9  [        R                  " X$S   R                  [        R                   5      US   R                  [        R                   5      US   R                  [        R"                  5      US   S9  g)Nr9   r   rÔ   rÕ   r    ÚnormrÈ   rR   rS   ©r   r§   TÚrunningrÖ   rC   rD   ÚeaÚcausalr)   rÞ   rß   )rp   rà   r@   rE   râ   r   )r   rä   rå   ræ   r   r_   ÚtuplerÉ   r   rd   r}   rç   rè   r   ré   rH   rê   rë   )rQ   rì   r.   rí   rð   s        r5   Úbuildr  	  sˆ  € Ü�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ˆØˆ�y�GÓä)¨!¨E©(Ó3´\À!ÀEÁ(Ó5KÐˆˆ%‰�!�E‘(Ø‡u�uˆTƒ{�hÓÜ˜Q˜u™X¤s¨4¡y¸¿¹¸hÈÓ8MÑNˆˆ%‰ØˆT‰7”c˜$‘iÓÐÐÜ‡K‚K”—‘—‘ Ó"¨TÒ2Ü‡H‚HˆQ�e‘H—O‘O¤B§J¡JÓ/°Q°u±X·_±_ÄRÇZÁZÓ5PÐVWÐXaÑVb×ViÑViÔjl×jqÑjqÓVrØ�&‘	òàr7   Ú__main__r   rÔ   r  rº   )Ún_jobsc              #   óZ   #   • U  H!  u  p[        [        5      " U[        5      v •  M#     g 7f©N)r   r  rì   ©r�   Ú_r›   s      r5   rƒ   rƒ   #  ó!   é € Ð"[Ê]ÁTÀQ¤7¬;Ô#7¸¼4×#@Ð#@Ê]ùó   ‚)+ÚbuiltÚofr  c              #   óZ   #   • U  H!  u  p[        [        5      " U[        5      v •  M#     g 7fr  )r   r  rì   r  s      r5   rƒ   rƒ   '  r  r  Úea_carryÚsubj_uidÚrecordsc              #   óV   #   • U  H  n[        [        5      " U[        5      v •  M!     g 7fr  )r   rñ   rì   )r�   Úrss     r5   rƒ   rƒ   ,  s"   é € Ð"YÒTXÈb¤7Ô+>Ô#?ÀÄD×#IÐ#IÒTXùs   ‚')c              #   óZ   #   • U  H!  u  p[        [        5      " U[        5      v •  M#     g 7fr  )r   r  rì   r  s      r5   rƒ   rƒ   /  s    é € ÐQÂ=¹4¸1œw¤uœ~¨a´×6Ð6Â=ùr  )g      Ð?ç      @)r  )rß   r   gš™™™™™¹?NF)é   rß   r   gš™™™™™©?r   NFN)Nrß   r   )))r   r"  )r"  g       @é   ):Ú__doc__rä   ÚsysÚnumpyr   Újoblibr   r   rå   Úinsertrè   ÚabspathÚ__file__Ú
common_expr   r   r¿   rO   r   rI   r   r	   r
   r   r   r   r   r   r’   r   r6   r_   rd   r}   r¤   r°   r¶   rÃ   rÒ   rñ   rÿ   r  r  r  Ú__name__ÚtiÚargvrì   rÉ   Úiterrowsr   ÚprintrŽ   r"   ÚgroupbyÚlistÚto_dictÚsubs)r  r1   s   00r5   Ú<module>r6     s1  ðñtó 
Û 
ã ß $à ‡�‡���2—7‘7—?‘? 2§7¡7§?¡?°8Ó#<Ó=Ô >ß &ß |× |× |Ý  ôô"hò0 ô%ð, lqØô-)ð` 1€	ô'ò,ò0!òô.ò*
òòð, ˆ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‘D˜Ÿ™ 9Ó-Ö.Ñ;QÒRˆDÙ Ò"Ñ"YÑTXÓ"YÓYˆAÙ�$˜¡ Q£¨©s°2«wÔ7ÚÙ˜AÒÑQÀ2Ç;Á;Ä=ÓQÓQˆÙˆd�G™S ›V T©3¨r«7×3ò .ð ùó Ss   Ç#I"