ó
    …—jà  ã                  ód   • S r SSKJr  SSKrSSKrS
S jrSS jrSS jr	SSS jjr
SS jrSS	 jrg)zôSuite18-only reporting helpers.

These helpers deliberately do not alter Suite17 metrics.  They only make the
inherited report labels truthful and summarize FMM-specific diagnostics so the
plain log is sufficient for scientific interpretation.
é    )ÚannotationsNc                óX   • [        U 5      R                  SS5      R                  SS5      $ )NÚSUITE17ÚSUITE18ÚSuite17ÚSuite18)ÚstrÚreplace)Útitles    ÚA/root/disk_3tb/earlywarning/30072026/suite18/suite18_reporting.pyÚsuite18_titler      s&   € Üˆu‹:×Ñ˜i¨Ó3×;Ñ;¸IÀyÓQÐQó    c                ó  • U R                  5       n0 nUR                   HX  nUnUR                  S5      (       a  SU[        S5      S -   nO'UR                  S5      (       a  SU[        S5      S -   nXBU'   MZ     UR	                  US9$ )z?Rename inherited Suite17 display-only column labels to Suite18.Úsuite17_Úsuite18_NÚs17_Ús18_©Úcolumns)Úcopyr   Ú
startswithÚlenÚrename)ÚdfÚzÚrenÚcÚncs        r   Úsuite18_display_framer      s‡   € à
�‰‹	€AØ
€CØ�YŒYˆØˆØ�<‰<˜
×#Ñ#Ø˜a¤ J£Ð 0Ð1Ñ1‰BØ�\‰\˜&×!Ñ!Ø˜!œC ›K˜L˜/Ñ)ˆBØˆA‹ñ ð �8‰8˜Cˆ8Ð Ð r   c                óê  • U b  [        U 5      S:X  a  / $ / nU R                  SSS9 GHG  u  p#SU;   a  US   R                  [        5      O[        R
                  " SUR                  S9nX4   R                  5       nSn[        R                  n[        U5      (       Ga
  SS1R                  UR                  5      (       aè  [        R                  " US   S	S
9R                  [        5      n[        R                  " US   S	S
9R                  [        5      n	[        R                  " U5      [        R                  " U	5      -  n
[        R                   " U
5      (       aJ  XŠ   Xš   -
  n[#        [        R$                  " US:¬  5      5      n[        [        R&                  " U5      5      nUR)                  U[#        [        U5      5      [#        UR%                  5       5      [#        U) R%                  5       5      [        U5      (       a  [        UR+                  5       5      O[        R                  [        U5      (       a5  SU;   a/  [        [        R                  " US   S	S
9R-                  5       5      O[        R                  [        U5      (       a5  SU;   a/  [        [        R                  " US   S	S
9R'                  5       5      O[        R                  [        U5      (       a5  SU;   a/  [#        [        R                  " US   S	S
9R-                  5       5      OS[        U5      (       a5  SU;   a/  [#        [        R                  " US   S	S
9R'                  5       5      OSUUS.5        GMJ     U$ )Nr   ÚviewF)ÚsortÚ	available)ÚindexÚmax_train_blockÚquery_blockÚcoerce)ÚerrorsÚ
train_rows)r!   ÚblocksÚavailable_blocksÚunavailable_blocksÚavailability_rateÚfirst_available_blockÚlast_available_blockÚmin_train_rows_when_availableÚmax_train_rows_when_availableÚchronology_violationsÚmax_train_minus_query)r   ÚgroupbyÚastypeÚboolÚpdÚSeriesr$   r   ÚnpÚnanÚissubsetr   Ú
to_numericÚto_numpyÚfloatÚisfiniteÚanyÚintÚsumÚmaxÚappendÚmeanÚmin)r   Úrowsr!   ÚgÚavailÚgaÚ
violationsÚmax_gapÚtrÚquÚfiniteÚgaps               r   Úprequential_summary_rowsrQ   !   s�  € Ø	�z”S˜“W “\Øˆ	Ø€DØ—:‘:˜f¨5�:Ô1‰ˆØ/:¸aÓ/?��+‘×%Ñ%¤dÔ+ÄRÇYÂYÈuÐ\]×\cÑ\cÑEdˆØ‰X�]‰]‹_ˆØˆ
Ü—&‘&ˆÜˆr�7Š7Ð)¨=Ð9×BÑBÀ2Ç:Á:×NÑNÜ—’˜rÐ"3Ñ4¸XÑF×OÑOÔPUÓVˆBÜ—’˜r -Ñ0¸ÑB×KÑKÌEÓRˆBÜ—[’[ “_¤r§{¢{°2£Ñ6ˆFÜ�vŠv�f�~‰~Ø‘j 2¡:Ñ-�Ü ¤§¢¨¨q©Ó!1Ó2�
Ü¤§¢ s£Ó,�Ø�‰ØÜœ#˜a›&“kÜ # E§I¡I£KÓ 0Ü"%¨ v§l¡l£nÓ"5Ü8;¸E¿
¹
¤ u§z¡z£|Ô!4ÌÏÉô �r—7‘7˜}°Ó2ô ”b—m’m B }Ñ$5¸hÑG×KÑKÓMÔNÜ8:¿¹ô �r—7‘7˜}°Ó2ô ”b—m’m B }Ñ$5¸hÑG×KÑKÓMÔNÜ8:¿¹ô �r—7‘7˜|¨rÓ1ô ”B—M’M " \Ñ"2¸8ÑD×HÑHÓJÔKØ78ô �r—7‘7˜|¨rÓ1ô ”B—M’M " \Ñ"2¸8ÑD×HÑHÓJÔKØ78à%/Ø%,ñ/
÷ 	ñ 2ðL €Kr   c                óŒ  • U b  [        U 5      S:X  a  [        R                  " 5       $ U R                  5       nSU;   a  X"S   R	                  [
        5         nSU;   a  UR                  SS/5      nS Vs/ s H  o3U;   d  M
  UPM     nnX$   R                  SSS9R                  [        U5      5      R                  SS	9$ s  snf )
Nr   ÚselectedÚrankr!   )Úfoldr!   rT   ÚfeatureÚf_scoreÚinitialization_blockF)Ú
group_keysT©Údrop)r   r7   Ú	DataFramer   r5   r6   Úsort_valuesr4   ÚheadrA   Úreset_index)r   Útop_nr   r   Úkeeps        r   Úfeature_selection_preview_rowsrb   N   sµ   € Ø	�z”S˜“W “\Ü�|Š|‹~ÐØ
�‰‹	€AØ�QƒØ�
‰m×"Ñ"¤4Ó(Ñ)ˆØ�ƒ{Ø�M‰M˜6 6Ð*Ó+ˆÙ]ÓhÒ]�!ÐfgÑag�AÑ]€DÐhØ‰7�?‰?˜6¨eˆ?Ð4×9Ñ9¼#¸e»*ÓE×QÑQÐW[ÐQÐ\Ð\ùò is   Á5	CÂCc                óÊ   • U b  [        U 5      S:X  a  [        R                  " 5       $ / SQnX Vs/ s H  o"U R                  ;   d  M  UPM     sn   R	                  5       $ s  snf )Nr   )rU   r!   ÚthetaÚclassÚboxesÚsupportÚsupport_medianÚsupport_p95Úconfidence_meanÚconfidence_p95Ú
width_meanÚ	width_p95Úcontraction_events)r   r7   r\   r   r   )r   ra   r   s      r   Úhyperbox_summary_for_logro   Z   sT   € Ø	�z”S˜“W “\Ü�|Š|‹~Ðò€Dð
 ˜$Ó2š$�Q r§z¡z¡/�q™$Ñ2Ñ3×8Ñ8Ó:Ð:ùÒ2s   °A ÁA c           	     ó  ^• U b  [        U 5      S:X  a  [        R                  " 5       $ X S   T:H     R                  5       nUR                  (       a  [        R                  " 5       $ SSSS.n/ n[        U4S jU S   R                  5       R                  5        5       5       GHˆ  nX S   U:H     R                  5       nS/UR                  5        Vs/ s H'  owUR                  ;   d  M  XvR                  ;   d  M%  UPM)     sn-   n[        U5      S	::  a  Mt  X(   R                  U Vs0 s H  owS:w  d  M
  US
U 3_M     snS9n	Xh   R                  U Vs0 s H  owS:w  d  M
  USU 3_M     snS9n
U	R                  U
SSS9nUR                  (       a  Mò  U[        [        U5      5      S.nUR                  5        GHY  u  pÞS
U 3SU 3nnXû;  d  UU;  a  M  X¿   R                  [        5      UU   R                  [        5      -
  n[        [         R"                  " X¿   5      5      USU 3'   [        [         R"                  " UU   5      5      USU 3'   [        [         R"                  " U5      5      USU 3'   [        [         R$                  " U5      5      USU 3'   [        [         R&                  " U5      5      USU 3'   [        [         R(                  " US:„  5      5      XÍ S3'   [        [         R"                  " US:„  5      5      XÍ S3'   GM\     UR+                  U5        GM‹     U(       d  [        R                  " 5       $ [        R                  " U5      R-                  SS/SSS9R/                  SS9$ s  snf s  snf s  snf )zHPairwise faculty-level comparison of candidate vs every available model.r   ÚmodelÚmean_fold_apÚmean_fold_aucÚmean_fold_f2_at_20)ÚapÚaucÚf2c              3  ó6   >#   • U  H  oT:w  d  M
  Uv •  M     g 7f)N© )Ú.0ÚmÚ	candidates     €r   Ú	<genexpr>Ú)reference_head_to_head.<locals>.<genexpr>r   s   øé € ÐTÒ!A˜AÈ)Á^—a‘aÒ!Aùs   ƒ	�	Úfacultyé   Ú
candidate_r   Ú
reference_Úinner)ÚonÚhow)Ú	referenceÚ	facultiesÚcandidate_macro_Úreference_macro_Úmean_delta_Úmedian_delta_Úworst_delta_Ú_winsÚ	_win_rateÚmean_delta_apÚmean_delta_f2FÚlast)Ú	ascendingÚna_positionTrZ   )r   r7   r\   r   ÚemptyÚsortedÚdropnaÚuniqueÚvaluesr   r   ÚmergerA   Úitemsr=   r>   r9   ÚnanmeanÚ	nanmedianÚnanminÚnansumrD   r]   r_   )Úmeanfr|   ÚcandÚmetricsrG   ÚrefÚotherr   ÚcolsÚaÚbr   ÚrowÚshortÚcolÚacÚbcÚdeltas    `                r   Úreference_head_to_headr­   e   s7  ø€ à�}œ˜E›
 a›Ü�|Š|‹~ÐØ�w‘ 9Ñ,Ñ-×2Ñ2Ó4€DØ‡z‡zÜ�|Š|‹~ÐàØØ"ñ€Gð
 €DÜÔT  w¡×!6Ñ!6Ó!8×!?Ñ!?Ô!AÓT×TˆØ˜G‘n¨Ñ+Ñ,×1Ñ1Ó3ˆØˆ{¨¯©Ô)9ÓfÒ)9 AÀ$Ç,Á,Ñ=N›aÐST×XeÑXeÑSeŸaÑ)9ÑfÑfˆÜˆt‹9˜‹>ÙØ‰J×ÑÁ4Ó&XÂ4¸aÈiÉ<Ó'9 q¨:°a°SÐ)9Ò'9Á4Ñ&XÐÐYˆØ‰K×ÑÁDÓ'YÂD¸qÈyÉLÓ(:¨¨J°q°cÐ*:Ò(:ÁDÑ'YÐÐZˆØ�G‰G�A˜)¨ˆGÐ1ˆØ�7�7ÙØ¬c´#°a³&«kÑ:ˆØ!Ÿ-™-Ÿ/‰JˆEØ! # Ð'¨:°c°UÐ);�ˆBØ‹{˜b¨›kÙØ‘E—N‘N¤5Ó)¨A¨b©E¯N©N¼5Ó,AÑAˆEÜ.3´B·J²J¸q¹uÓ4EÓ.FˆCÐ" 5 'Ð*Ñ+Ü.3´B·J²J¸qÀ¹uÓ4EÓ.FˆCÐ" 5 'Ð*Ñ+Ü).¬r¯zªz¸%Ó/@Ó)AˆC�+˜e˜WÐ%Ñ&Ü+0´·²¸eÓ1DÓ+EˆC�- ˜wÐ'Ñ(Ü*/´·	²	¸%Ó0@Ó*AˆC�,˜u˜gÐ&Ñ'Ü#&¤r§y¢y°¸±Ó';Ó#<ˆC�'˜�Ñ Ü',¬R¯ZªZ¸À¹	Ó-BÓ'CˆC�'˜Ð#Ô$ñ *ð 	�‰�C×ñ/ Uö0 Ü�|Š|‹~ÐÜ�<Š<˜Ó×)Ñ)Ø	˜/Ð*ØØð *ð ÷ �k�t€kÐð	ùò1 gùò 'YùÚ'Ys*   ÃN Ã*N Ã;N Ä(	N
Ä5
N
Å	N

Å"
N

)r   r	   Úreturnr	   )r   úpd.DataFramer®   r¯   )r   r¯   r®   z
list[dict])é
   )r   r¯   r`   rA   r®   r¯   )rŸ   r¯   r|   r	   r®   r¯   )Ú__doc__Ú
__future__r   Únumpyr9   Úpandasr7   r   r   rQ   rb   ro   r­   ry   r   r   Ú<module>rµ      s6   ðñõ #ã Û ôRô!ô*öZ	]ô;õ+r   