ó
    z6Ïjg  ã                  óò   • 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rSSK	J
r
  SSKJr  SSKrSSKrSSKJrJrJrJr  S rS rS	 rSS
 jrSS jrS rSS jrS rS\" S5      4S jrS r S r!S r"S r#g)z>AQ Suite31 data, support, chronology and evaluation contracts.é    )ÚannotationsN)Ú	dataclass)ÚPath)Úaverage_precision_scoreÚroc_auc_scoreÚbrier_score_lossÚlog_lossc           	     ó˜   • [         R                  " [        R                  " U S[        SS9R                  5       5      R                  5       $ )NTF)Ú	sort_keysÚdefaultÚensure_ascii)ÚhashlibÚsha256ÚjsonÚdumpsÚstrÚencodeÚ	hexdigest©Úxs    ÚA/root/disk_3tb/earlywarning/30072026/suite31_CAPT/suite31/core.pyÚstable_hashr      s3   € Ü�>Š>œ$Ÿ*š* Q°$ÄÐRWÑX×_Ñ_ÓaÓb×lÑlÓnÐnó    c           	     óš   • [        U 5      o R                  R                  SSS9  U R                  [        R
                  " USS SS95        g )NT)ÚparentsÚexist_oké   c                óv   • [        U [        R                  5      (       a  U R                  5       $ [	        U 5      $ ©N)Ú
isinstanceÚnpÚgenericÚitemr   r   s    r   Ú<lambda>Údump_json.<locals>.<lambda>   s-   € Ì*ÐUVÔWY×WaÑWa×JbÑJb¸a¿f¹f»hÐ>nÔhkÐlmÓhnÐ>nr   F)Úindentr   r   )r   ÚparentÚmkdirÚ
write_textr   r   )ÚpathÚobjs     r   Ú	dump_jsonr,      sF   € Ü	ˆd‹€D—K‘K×%Ñ%¨d¸DÐ%ÑAØ‡O�O”D—J’J˜s¨!Ñ4nð  }Bñ  Cõ  Dr   c                óØ   • / nUR                  5        H4  u  p4[        U[        5      (       a  US nUR                  U SU 35        M6     [	        SU  S3SR                  U5      -   SS9  g )Nz.6fÚ=Ú[z] Ú T)Úflush)Úitemsr    ÚfloatÚappendÚprintÚjoin)ÚtagÚfieldsÚpartsÚkÚvs        r   Únoter<      se   € Ø
€EØ�|‰|Ž~‰ˆÜ�aœ×Ñ A c 7˜qØ�‰˜�s˜!˜A˜3�ZÖ ñ ô 
ˆAˆcˆU�"ˆ+�c—h‘h˜u“oÑ
%¨DÓ1r   c                óø  • SSK JnJnJn  Uc	  U" XU5      nU" XX#U5      u  p‰n
US4U	S44 GH@  u  p¼[	        UR
                  5      [	        UR                  5      s=:X  a9  [	        UR                  5      s=:X  a  [	        UR                  5      :X  d   U5       e   U5       eUR
                  R                  S:X  a3  [        R                  " UR
                  5      R                  5       (       d   U5       e[        R                  " UR                  SS/5      R                  5       (       d   U5       e[        R                  " UR                  5      R                  5       (       a  GM<   U5       e   X‰U" U
5      U
4$ )Nr   )Úload_fold_bundleÚdiscover_common_feature_namesÚcurrent_feature_namesÚhistoryÚtargetr   é   )Úsuite25_datar>   r?   r@   ÚlenÚcurrentÚyÚ
student_idÚ	row_indexÚndimr!   ÚisfiniteÚallÚisinÚsemester_ordinal)Ú	cache_dirÚ
struct_dirÚ	facultiesÚfoldÚfeature_namesr>   r?   r@   ÚhÚqÚrawÚbÚnames                r   Úload_aqrY      s1  € ßcÑcØÑÑ+HÈÐ]aÓ+b˜]Ù˜Y°)ÀÓO�G€AˆØ�i�= ! H Ô.‰ˆÜ�1—9‘9‹~œs 1§3¡3›xÕL¬¨Q¯\©\Ó):ÕL¼CÀÇÁÓ<LÓLÐQÈTÓQÑLÐQÈTÓQÐLØ�y‰y�~‰~˜qÓ ¤R§[¢[°·±Ó%;×%?Ñ%?×%AÑ%AÐFÀ$ÓFÐAÜ�wŠw�q—s‘s˜A˜a˜5Ó!×%Ñ%×'Ñ'Ð,¨Ó,Ð'Ü�{Š{˜1×-Ñ-Ó.×2Ñ2×4Ô4Ð9°TÓ9Ð4ñ	 /ð
 Ñ$ SÓ)¨#Ð-Ð-r   c                óx  • [         R                  " [         R                  " U R                  5      5      n[	        U5      S:  a  [        S5      e[        [        U5      [	        U5      S-
  5      n[        X#*    5      o@R                  U:  oU) n[         R                  " U R                  U   5      [         R                  " U R                  U   5      :  d   e[        SUSU*  R                  5       X#* S R                  5       U[        UR                  5       5      [        UR                  5       5      SS9  XVU4$ )z=GLOBAL calendar split; do not use faculty-local fold indices.r   z*Need >=2 historical origins for chronologyrC   Ú
CHRONOLOGYNÚ#semester_proxy_not_release_verified)Útrain_originsÚvalidation_originsÚcutoffÚ
train_rowsÚvalidation_rowsÚavailability)r!   ÚsortÚuniquerN   rE   Ú
ValueErrorÚminÚintr3   Úmaxr<   ÚtolistÚsum)rT   Úval_semestersÚtimesÚnr_   ÚtrainÚvalids          r   Úglobal_historical_splitrp   $   s9  € ä
�'Š'”"—)’)˜A×.Ñ.Ó/Ó
0€EÜ
ˆ5ƒz�!ƒ|œ*Ð%QÓRÐRÜ	Œ#ˆmÓ
œS ›Z¨™\Ó*€AÜ��r‘Ó€F×#5Ñ#5°fÑ#<˜UÀF¸eÜ�6Š6�!×$Ñ$ UÑ+Ó,¬R¯VªV°A×4FÑ4FÀuÑ4MÓ-NÓNÐNÐNÜˆ E¨#¨A¨2 J×$5Ñ$5Ó$7È5ÐQSÐQTÈ:×K\ÑK\ÓK^ÐflÔx{ð  }B÷  }Fñ  }Fó  }Hó  yIô  Z]ð  ^c÷  ^gñ  ^gó  ^ió  Zjð  x]ò  ^Ø�vÐÐr   c                óN  • [        U 5      (       aY  [        U5      (       aI  [        R                  " U R                  5      [        R                  " UR                  5      :  d   S5       e[        [        UR                  R                  5       UR                  R                  5       UR                  R                  5       UR                  R                  5       UR                  R                  5       5      5      n[        U5      [        [        U5      5      :X  d   S5       e[        S[        U 5      [        U R                   R#                  5       5      [        U5      [        UR                   R#                  5       5      [        U 5      (       a#  [%        U R                   R'                  5       5      O
[%        S5      [%        UR                   R'                  5       5      [%        U R                  R                  5       5      [%        UR                  R	                  5       5      S9	  g )Nz0Future labels in history: target cutoff violatedz&Duplicate canonical target identifiersÚDATAÚnan)Úhistory_rowsÚhistory_failuresÚtarget_rowsÚtarget_failuresÚhistory_prevalenceÚtarget_prevalenceÚhistory_lastÚtarget_first)rE   r!   rh   rN   rf   ÚlistÚzipÚfaculty_idxri   rH   Ú	course_idÚtarget_semesterrI   Úsetr<   rg   rG   rj   r3   Úmean)rT   rU   Úkeyss      r   Úaudit_targetr„   .   s(  € Ü
ˆ1‡v�v”#�a—&‘&Ü�vŠv�a×(Ñ(Ó)¬"¯&ª&°×1CÑ1CÓ*DÓDÐxÐFxÓxÐDÜ	Œc�!—-‘-×&Ñ&Ó(¨¯©×)<Ñ)<Ó)>¸q¿{¹{×?QÑ?QÓ?SÐTU×TeÑTe×TlÑTlÓTnÐop×ozÑoz÷  pBñ  pBó  pDó  Eó  
F€DÜˆt‹9”cœ#˜d›)“nÓ$ÐNÐ&NÓNÐ$ÜˆœS ›V´S¸¿¹¿¹»³^ÔPSÐTUÓPVÔgjÐkl×knÑkn×krÑkrÓktÓguô  _bð  cd÷  _eñ  _eô  JOð  PQ÷  PSñ  PS÷  PXñ  PXó  PZô  J[ô  kpð  qvó  kwô  JOð  PQ÷  PSñ  PS÷  PXñ  PXó  PZó  J[ô  inð  op÷  oAñ  oA÷  oEñ  oEó  oGó  iHô  V[ð  \]÷  \nñ  \n÷  \rñ  \ró  \tó  Vuó  vr   c                óÀ  • [         R                  " U R                  [        U5      :H  U R                  [        U5      U-
  :  -  5      n[         R                  R                  [        U5      5      n[        [        U5      [        U5      5      n	U	(       a$  [         R                  " UR                  XySS95      O$[         R                  " S[         R                  5      n
U(       d  U	S:X  a  [        S5      e[         R                  " U R                  U
   [        U5      U-
  :  5      (       d   e[        U5      [        U5      [        U5      [        U	5      [        U5      [        U R                   U
   R#                  5       5      U	(       a&  [        U R                   U
   R%                  5       5      OSU
 Vs/ s Hx  n[        U R                  U   5      ['        U R(                  U   5      ['        U R*                  U   5      [        U R,                  U   5      [        U R.                  U   5      4PMz     sn[         R0                  " U R                  U
   5      R3                  [
        5      R5                  5       U	(       a8  [        [         R$                  " [        U5      U R                  U
   -
  5      5      OS[        U5      S.n[7        U5      US'   X¬4$ s  snf )z§Temporal support: faculty-local and before origin by at least release_gap semesters.
release_gap=0 is benchmark-parity semester proxy, NOT grade-release verification.
F)ÚsizeÚreplacer   zEmpty historical supportN)r~   ÚoriginÚrequested_budgetÚactual_budgetÚseedÚfailure_countÚsupport_prevalenceÚrow_identitiesÚsource_originsÚage_meanÚrelease_gapÚhash)r!   Úflatnonzeror~   rg   rN   r3   ÚrandomÚdefault_rngrf   rE   rc   ÚchoiceÚzerosÚint64re   rL   rG   rj   r‚   r   rH   r   r€   rI   rd   Úastyperi   r   )rT   Úfacultyrˆ   Úbudgetr‹   r‘   Úallow_emptyÚeligibleÚrngr†   ÚindicesÚiÚmanifests                r   Úsupport_selectr¢   5   só  € ô �^Š^˜QŸ]™]¬C°«LÑ8¸Q×=OÑ=OÔRWÐX^ÓR_Ð`kÑRkÑ=kÑlÓm€HÜ
�	‰	×Ñœc $›iÓ(€C¬s´3°v³;¼sÀ8»}Ó/M¨$ÞEIŒB�GŠG�C—J‘J˜x¸%�JÐ@ÔAÌrÏxÊxÐXYÔZ\×ZbÑZbÓOc€GÞ˜4 ›7¬Ð4NÓ)OÐ#OÜ�6Š6�!×$Ñ$ WÑ-¬e°F«m¸KÑ.GÑG×HÑHÐHÐHÜ ›L´%¸³-ÔSVÐW]ÓS^ÔorÐswÓoxô  ADð  EIó  AJô  [^ð  _`÷  _bñ  _bð  cjñ  _k÷  _oñ  _oó  _qó  [rö  fjô  HMð  NO÷  NQñ  NQð  RYñ  NZ÷  N_ñ  N_ó  Naô  Hbð  ptñ  AHó  FIò  AHð  |}ô  HKð  LM÷  LYñ  LYð  Z[ñ  L\ó  H]ô  ^að  bc÷  bnñ  bnð  opñ  bqó  ^rô  svð  wx÷  wBñ  wBð  CDñ  wEó  sFô  GLð  MN÷  M^ñ  M^ð  _`ñ  Maó  Gbô  cfð  gh÷  grñ  grð  stñ  guó  cvó  Gwñ  AHñ  FIô  []÷  [dò  [dð  ef÷  ewñ  ewð  xñ  e@ó  [A÷  [Hñ  [Hô  INó  [O÷  [Vñ  [Vó  [Xö  aeô  diô  jl÷  jqò  jqô  rwð  x~ó  rð  @A÷  @Rñ  @Rð  SZñ  @[ñ  r[ó  j\ô  d]ð  koô  ~A	ð  B	M	ó  ~N	ñ  O	€HÜ  Ó*€HˆVÑØÐÐùò FIs   Æ9A?Kc                ó€  ^ ^^• [         R                  " T [        5      m [         R                  " T[        5      m[	        T 5      (       d  [        S5      e[         R                  " T5      R                  5       (       a$  [         R                  " TS:  TS:„  -  5      (       a  [        S5      e[        T S:H  R                  5       =(       a    T S:H  R                  5       5      n[         R                  " TSS5      n[	        T 5      [        T R                  5       5      [        T R                  5       5      [        TR                  5       5      U(       a  [        [        T T5      5      O
[        S5      U(       a  [        [        T T5      5      O
[        S5      [        [        T T5      5      [        [!        T USS/S95      S	.n[         R"                  " [         R                  " TS
-  [        5      S5      m[        [        UUU 4S j[%        S
5       5       5      5      US'   [         R&                  " T* SS9nS Hþ  n[)        S[        [*        R,                  " [	        T 5      U-  5      5      5      n[         R.                  " [	        T 5      [        5      nSX…S U '   [        [         R                  " UT S:H  -  5      5      o™U-  o©[)        S[        T R                  5       5      5      -  nSU
-  U-   S:”  a  SU
-  U-  SU
-  U-   -  OSn[        US-  5      oÔR1                  SU 3U
SU 3USU 3U05        GM      U$ )NzEmpty evaluation cellr   rC   zInvalid probabilitiesg:Œ0âŽyE>gGœ¡úÿÿï?rs   )Úlabels)ÚrowsÚfailuresÚ
prevalenceÚ
mean_scoreÚapÚaucÚbrierÚloglossé
   é	   c           
   3  ó  >#   • U  H�  n[         R                  " TU:H  5      (       d  M#  [         R                  " TU:H  5      [        [         R                  " TTU:H     5      [         R                  " TTU:H     5      -
  5      -  v •  Mƒ     g 7fr   )r!   Úanyr‚   Úabs)Ú.0r:   ÚbinsÚsrG   s     €€€r   Ú	<genexpr>Úscoring.<locals>.<genexpr>I   s§   øé € ð  Afò  IRð  DEô  VX÷  V\ò  V\ð  ]að  cdñ  ]d÷  VeÓA~ÄÇÂÈÈqÉÓAQÔRUÔVX×V]ÒV]Ð^_Ð`dÐfgÑ`gÑ^hÓViÔjl×jqÒjqÐrsÐtxÐz{Ñt{Ñr|Ój}ÑV}ÓR~ÖA~ò  IRùs   ƒ"B©A#BÚece10Ústable)Úkind)gš™™™™™¹?g333333Ã?gš™™™™™É?g      Ð?Té   é   ç        éd   Úprecision_at_Ú
recall_at_Ú	fbeta_at_)r!   Úasarrayrg   r3   rE   re   rK   rL   r°   ÚboolÚcliprj   r‚   r   r   r   r	   ÚminimumÚrangeÚargsortrh   ÚmathÚceilr—   Úupdate)rG   r´   ÚbothÚpÚoÚorderÚrater:   ÚpredÚtpÚprecÚrecÚf2r7   r³   s   ``            @r   ÚscoringrÔ   B   sA  ú€ Ü‡j‚j�”3Ó€Aœ"Ÿ*š* Q¤uÓ-˜Üˆq�6‰6œ
Ð#:Ó;Ð;Ü�;Š;�q‹>×Ñ×Ñ¤2§6¢6¨1¨Q©3°°1±©+×#6Ñ#6¼ZÐH_Ó=`Ð7`Ü	ˆq�!‰t�j‰j‹l×+  1¡Ÿz™z›|Ó	,€D¬r¯wªw°q¸¸fÓ/E¨QÜ�!‹f¤ A§E¡E£G£¼%ÀÇÁÃ»/ÔW\Ð]^×]cÑ]cÓ]eÓWfö  TXÔlqô  sJð  KLð  MNó  sOô  mPô  ^cð  dió  ^jö  NRô  qvô  wDð  EFð  GHó  wIô  qJô  X]ð  ^có  Xdô  mrô  sCð  DEð  FGó  sHó  mIô  TYô  Zbð  cdð  efð  opð  qrð  nsñ  Ztó  Tuñ  v€Aä	�Š”B—J’J˜q ™t¤CÓ(¨Ó	+€D´u¼Sö  Afô  INð  OQô  IRó  Afó  >fó  8g¨A¨g©Jä
�*Š*�a�R˜XÑ
&€EÛ!ˆÜ
ˆa””D—I’Iœc !›f T™kÓ*Ó+Ó
,ˆ´2·8²8¼CÀ»FÄ4Ó3H¨dÐY]ÈÐTVÐUVÈiÉÜŒr�vŠv�d˜a ™d‘mÓ$Ó%ˆ¨a©4 d´s¸1¼SÀÇÁÃ»\Ó7JÑ4J°ÐlmÐnrÑlrÐsvÑlvÐxyÓkyÈqÐQUÉvÐVYÉzÐ[\Ð]aÑ[aÐbeÑ[eÒOfð  @BÈ2Ü��S‘‹MˆŸ(™( m°C°5Ð$9¸$ÀÈCÈ5Ð?QÐRUÐXaÐbeÐafÐVgÐhjÐ#k×lñ "ð €Hr   r¼   rs   c	                ó*  • / n	[        U R                  5       H÷  u  p«U R                  U
:H  nUR                  5       (       d  M+  [        R
                  " [        R                  " U R                  U   5      5       H‘  nXÀR                  U:H  -  n[        U5      U[        U5      U[        U5      [        U5      U[        U5      [        U5      S.	nUR                  [        U R                  U   X   5      5        U	R                  U5        M“     Mù     U	$ )N)	rR   rš   rˆ   ÚmodelÚsupport_seedÚsupport_budgetÚstageÚinference_secondsÚpeak_vram_gb)Ú	enumerateÚfaculty_namesr~   r°   r!   rc   rd   rN   rg   r3   rÉ   rÔ   rG   r4   )rW   rË   rÖ   rR   r‹   r›   rÙ   ÚwallÚvramÚoutÚfiÚfÚmrˆ   ÚmmÚrows                   r   Ú	cell_rowsræ   R   s  € Ø
€CÜ˜!Ÿ/™/Ö*‰ˆØ
�-‰-˜Ñ
ˆØ�u‰u�w‰w‘xÜ—g’gœbŸiši¨×(:Ñ(:¸1Ñ(=Ó>Ö?ˆFØ×&Ñ&¨Ñ.Ñ/ˆBÜ˜D›	¨A´u¸V³}ÈUÔbeÐfjÓbkô  ~Að  BHó  ~Ið  RWô  lqð  rvó  lwô  GLð  MQó  GRñ  SˆCØ�J‰J”w˜qŸs™s 2™w q¡uÓ-Ô.¨s¯z©z¸#®ó @ñ +ð €Jr   c                óº   • U R                   (       a  [        R                  " 5       $ / SQnU R                  USS9R	                  SSSSSS	S
SS9R                  5       $ )N)rÖ   rÙ   rØ   r×   F)Údropna)r©   r‚   )rª   r‚   )Úfbeta_at_20r‚   )r«   r‚   )r·   r‚   )r©   Úcount)r¥   rj   )r¦   rj   )Úmacro_apÚ	macro_aucÚf2_at_20r«   r·   Úcellsr¥   r¦   )ÚemptyÚpdÚ	DataFrameÚgroupbyÚaggÚreset_index)ÚdfÚgrps     r   Úmacro_tabler÷   ]   sz   € Ø	‡x‡x”r—|’|“~Ð%Ú9€CØ�:‰:�c ˆ:Ð'×+Ñ+°]È^Ðe{ð  CSð  Zjð  qð  ESð  ]oÐ+ð  p÷  |ñ  |ó  ~ð  ~r   c                óš  • U R                   (       a  [        R                  " 5       $ / SQnU R                  USSSS9n/ nS Hò  nXB;  a  M
  UR                   HØ  nXT:X  a  M
  X$U/   R                  5       nUR                   (       a  M1  Xe   Xd   -
  nUR                  XT[        UR                  5       5      [        UR                  5       5      [        US:„  R                  5       5      [        US:  R                  5       5      [        US:H  R                  5       5      [        U5      S.5        MÚ     Mô     [        R                  " U5      $ )	N)rR   rš   rˆ   r×   rØ   rÖ   r©   Úfirst)ÚindexÚcolumnsÚvaluesÚaggfunc)Úhgb_matchedÚhgb_fullÚ	committeeÚtabicl_frozenÚtabicl_ordinaryÚtabicl_chronologicalr   )rÖ   Ú	referenceÚmean_delta_apÚmedian_delta_apÚwinsÚlossesÚtiesÚpaired_cells)rï   rð   rñ   Úpivot_tablerû   rè   r4   r3   r‚   Úmedianrg   rj   rE   )rõ   rƒ   Úpvr¥   r  rÖ   ÚjoinedÚds           r   Úpaired_comparisonr  b   s”  € Ø	‡x‡x”r—|’|“~Ð%Ú	D€DØ	‡~�~˜D¨¸ÀW€~ÐM€BØ	€DÛtˆ	ØÓ™xØ—Z”ZˆEØÓ¡Ø Ð'Ñ(×/Ñ/Ó1ˆFØ�|�|™HØ‰m˜FÑ-Ñ-ˆAØ�K‰K ÌUÐST×SYÑSYÓS[Ë_ÔotÐuv×u}Ñu}Óuó  pAô  ILð  NOð  PQñ  NQ÷  MVñ  MVó  MXó  IYô  cfð  hið  jkñ  hk÷  gpñ  gpó  gró  csô  {~ð  @Að  CDñ  @D÷  Iñ  Ió  Kó  {Lô  \_ð  `aó  \bñ  cö  dó  ñ uô �<Š<˜ÓÐr   c                 óÐ   •  SS K n U R                  R                  5       (       a  U R                  R                  5       S-  $ [	        S5      $ ! [
         a    [	        S5      s $ f = f)Nr   i   @rs   )ÚtorchÚcudaÚis_availableÚmax_memory_allocatedr3   Ú	Exception©r  s    r   Úgpu_peakr  q   sT   € ð)ÛØ<A¿J¹J×<SÑ<S×<UÑ<Uˆu�z‰z×.Ñ.Ó0°Ñ8ÐgÔ[`ÐafÓ[gÐgøÜÓ(œE %›LÒ(Ð(ús   ‚?A Á
A ÁA%Á$A%c                 ó¢   •  SS K n U R                  R                  5       (       a  U R                  R                  5         g g ! [         a     g f = f)Nr   )r  r  r  Úreset_peak_memory_statsr  r  s    r   Úreset_gpu_peakr  w   s<   € ðÛØ�:‰:×"Ñ"×$Ñ$ U§Z¡Z×%GÑ%GÕ%IÐ$øÜÓ‘TÐús   ‚=A Á
AÁAr   )é   )r   T)$Ú__doc__Ú
__future__r   r   r   rÇ   ÚosÚsysÚtimeÚdataclassesr   Úpathlibr   Únumpyr!   Úpandasrð   Úsklearn.metricsr   r   r   r	   r   r,   r<   rY   rp   r„   r¢   rÔ   r3   ræ   r÷   r  r  r  © r   r   Ú<module>r(     sv   ðÙ DÝ "ß )× )× )Ý !Ý Û Û ß ^Ó ^òoòDò2ô	.ôòvôòð  57¹EÀ%»Lô 	ò~ò
ò)ór   