ó
    �7ÉjÉ  ã                  óp   • S r SSKJr  SSKrSSKrSSKJr  SS jr " S S\5      r	S r
S	 rSS
 jrSS jrg)zJGroup student-course registrations by (faculty, student, target semester).é    )ÚannotationsN)ÚDatasetc           	     ó   • Uc)  [         R                  " [        U R                  5      5      O$[         R                  " U[         R
                  5      n0 nU Ht  n[        U R                  U   5      [        U R                  U   5      [        U R                  U   5      4nUR                  U/ 5      R                  [        U5      5        Mv     / nUR                  5        Hj  u  pWU(       a,  [        U5      U:”  a  [        SU S[        U5       SU 35      eUR                  [         R                  " U[         R
                  S95        Ml     U$ )NzGroup z has z registrations > max_courses=©Údtype)ÚnpÚarangeÚlenÚyÚasarrayÚint64ÚintÚfaculty_idxÚstrÚ
student_idÚfloatÚtarget_semesterÚ
setdefaultÚappendÚitemsÚ
ValueError)ÚbundleÚselectedÚmax_coursesÚgroupsÚiÚkeyÚresultÚrowss           ÚL/root/disk_3tb/earlywarning/30072026/suite30_joint_portfolio/suite30_data.pyÚbuild_groupsr!      s
  € Ø)1Ñ)9ŒR�YŠY”s˜6Ÿ8™8“}Ô%¼r¿zºzÈ(ÔSU×S[ÑS[Ó?\€HØ€FÛˆÜ�×#Ñ# AÑ&Ó'¬¨F×,=Ñ,=¸aÑ,@Ó(AÄ%È×H^ÑH^Ð_`ÑHaÓBbÐcˆØ×Ñ˜#˜bÓ!×(Ñ(¬¨Q«Ö0ñ ð €FØ—L‘L–N‰ˆæœ3˜t›9 [Ó0Ü˜v c U¨%´°D³	¨{Ð:WÐXcÐWdÐeÓfÐfØ�‰”b—j’j ¬B¯H©HÑ5Ö6ñ	 #ð
 €Mó    c                  ó*   • \ rS rSrSS jrS rS rSrg)ÚEnrollmentDataseté   Nc                ó>   • Xl         X@l        [        XU5      U l        g ©N)r   Úcontext_overrider!   r   )Úselfr   Úindicesr   r(   s        r    Ú__init__ÚEnrollmentDataset.__init__   s   € ØŒØ.ÔÜ  °Ó<ˆ�r"   c                ó,   • [        U R                  5      $ r'   )r
   r   )r)   s    r    Ú__len__ÚEnrollmentDataset.__len__   s   € œS §¡Ó-Ð-r"   c                óÔ  • U R                   U   o R                  n[        U[        R                  " UR
                  U   [        R                  5      [        R                  " UR                  U   [        R                  5      [        R                  " UR                  U   [        R                  5      [        R                  " UR                  U   [        R                  5      [        R                  " UR                  U   [        R                  5      [        R                  " U R                  c  UR
                  USS 24   OU R                  U   [        R                  5      S9$ )Niïÿÿÿ)ÚindexÚxr   ÚfacultyÚ
semester_zÚsemester_ordinalÚcontext_course)r   r   Údictr   r   ÚcurrentÚfloat32r   r   r   r4   r5   r(   )r)   r   ÚidxÚbs       r    Ú__getitem__ÚEnrollmentDataset.__getitem__   sç   € Ø�K‰K˜‰NˆŸ[™[˜1Ü˜#¤§¢¨A¯I©I°c©N¼2¿:¹:Ó!FÜ�jŠj˜Ÿ™˜S™¤"§*¡*Ó-Ü—J’J˜qŸ}™}¨SÑ1´"·(±(Ó;Ü—z’z !§,¡,¨sÑ"3´B·J±JÓ?ÜŸZšZ¨×(:Ñ(:¸3Ñ(?ÄÇ
Á
ÓKÜŸ:š:Ø'+×'<Ñ'<Ñ'D�—	‘	˜#˜c™d˜(Ò#Ø×*Ñ*¨3Ñ/´·
±
ó<ñ=ð 	=r"   )r   r(   r   )Nr   N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r+   r.   r<   Ú__static_attributes__© r"   r    r$   r$      s   † ô=ò .õ	=r"   r$   c                ó8  • [        U 5      n[        S U  5       5      o S   S   R                  S   n[        R                  " XU5      n[        R                  " X5      n[        R                  " X[        R
                  S9n[        R                  " XS5      n[        R                  " X5      n[        R                  " X5      n	[        R                  " X[        R                  S9n
[        R                  " X4S[        R
                  S9n[        U 5       Hô  u  pÍ[        US   5      nS	X¬S U24'   [        R                  " US   5      XLS U24'   [        R                  " US
   5      X\S U24'   [        R                  " US   5      XlS U24'   [        R                  " US   5      XœS U24'   [        R                  " US   5      X|S U24'   [        R                  " US   5      XŒS U24'   [        R                  " US   5      X¼S U24'   Mö     [        XEXiX‡X«S9$ )Nc              3  ó>   #   • U  H  n[        US    5      v •  M     g7f)r1   N©r
   )Ú.0r2   s     r    Ú	<genexpr>Ú!collate_groups.<locals>.<genexpr>&   s   é € Ð7²¨Aœ˜A˜g™JŸ˜²ùs   ‚r   r2   é   r   é   éÿÿÿÿr1   Tr   r3   r4   r6   r5   )r2   r   r3   r4   r5   r6   Úvalidr1   )r
   ÚmaxÚshapeÚtorchÚzerosÚlongÚboolÚfullÚ	enumerateÚ
from_numpyr7   )Úbatchr;   ÚmÚdr2   r   ÚfacÚcontextÚordinalÚszÚmaskr1   ÚjÚrÚns                  r    Úcollate_groupsrb   %   sÎ  € Ü	ˆ%ƒj€A”CÑ7±Ó7Ó7�!À¹(À3¹-×:MÑ:MÈaÑ:P¸Ü‡k‚k�!�aÓ€Aœ5Ÿ;š; qÓ+˜´·²¸AÄeÇjÁjÑ0Q¨CÜ�KŠK˜˜BÓ€G¬¯ª°AÓ(8 Ü‡{‚{�1Ó€BœUŸ[š[¨´5·:±:Ñ>˜ÄUÇZÂZÐQRÐPUÐVXÔ_d×_iÑ_iÑEj¸uÜ˜Ö‰ˆÜ
ˆa�‰j‹/ˆ T˜$  ! ˜t™*Ü× Ò   3¡Ó(ˆˆBˆQˆBˆ$‰´×1AÒ1AÀ!ÀCÁ&Ó1I¨¨R¨a¨R¨4©Ü×"Ò" 1 Y¡<Ó0ˆˆbˆqˆbˆD‰	¼%×:JÒ:JÈ1È\É?Ó:[°°b°q°b°D±Ü×&Ò& qÐ)9Ñ':Ó;ˆ�"�1�"�‰Ü×&Ò& qÐ);Ñ'<Ó=ˆ�"�1�"�‰Ü×$Ò$ Q w¡ZÓ0ˆ���ˆd‹ñ  ô �! À7ÐhlÑyÐyr"   c                óJ  • [         R                  " U R                   Vs/ s H  n[        U5      PM     sn[        5      n[        [        U5      [	        US:H  R                  5       5      [        U5      (       a  [        US:H  R                  5       5      OS[        U5      (       a  [        UR                  5       5      OS[        U5      (       a  [        [         R                  " U5      5      OS[        U5      (       a  [	        UR                  5       5      S9$ SS9$ s  snf )NrJ   g        )r   Ú	singletonÚsingleton_fractionÚ	mean_sizeÚmedian_sizeÚmaximum)r   r   r   r
   r   r7   Úsumr   ÚmeanÚmedianrN   )ÚdsÚgÚlengthss      r    Úgroup_summaryro   3   sÌ   € Ü�JŠJ¨¯	ª	Ó2ª	 1œ˜Až©	Ñ2´3Ó7€GÜ”s˜7“|¬c°7¸A±:×2BÑ2BÓ2DÓ.EÜ9<¸W¿¹œ5 '¨1¡*×!2Ñ!2Ó!4Ô5È2Ü+.¨w¯<©<”%˜Ÿ™›Ô'¸RÜ14°W·±”Eœ"Ÿ)š) GÓ,Ô-À2Ü&)¨'§l¡l”�G—K‘K“MÓ"ñ	<ð <ð 9;ñ	<ð <ùò 3s   ŸD c                óð  • [         R                  " U R                  [        S9n[         R                  " U5      R                  5       (       d  [        S5      e[         R                  " U5      n[        U5      S:  a  [        S5      e[        [        U5      [        U5      S-
  5      nUS:  a  [        S5      eX4*    nX%:  nX%:¬  nUR                  5       (       a  UR                  5       (       d   e[         R                  " X&   5      [         R                  " X'   5      :  d   eXg[        USU*  R                  5       X4* S R                  5       [        U5      [        UR                  5       5      [        UR                  5       5      [        [        [         R                  " U R                   U   5      5      5      [        [        [         R                  " U R                   U   5      5      5      S94$ )	a  One calendar-time cutoff across *all* faculties.

Per-faculty latest-block splitting is not a valid prospective simulation
for a shared cross-faculty network: a newer semester in faculty B could
train the encoder used to validate that same semester in faculty A.
r   z$Semester ordinals must all be finiteé   z7At least two historical calendar semesters are requiredrJ   z!validation_semesters must be >= 1N)Útrain_semestersÚvalidation_semestersÚfirst_validation_semesterÚ
train_rowsÚvalidation_rowsÚtrain_facultiesÚvalidation_faculties)r   r   r5   r   ÚisfiniteÚallr   Úuniquer
   Úminr   ÚanyrN   r7   Útolistri   r   )r   rs   ÚordinalsÚ	semestersÚnvÚfirst_validationÚtrÚvas           r    Úglobal_chronological_splitr…   <   s‰  € ô �zŠz˜&×1Ñ1¼Ñ?€HÜ�;Š;�xÓ ×$Ñ$×&Ñ&ÜÐ?Ó@Ð@Ü—	’	˜(Ó#€IÜ
ˆ9ƒ~˜ÓÜÐRÓSÐSÜ	ŒSÐ%Ó&¬¨I«°qÑ(8Ó	9€BØ	ˆAƒvÜÐ<Ó=Ð=Ø  ‘~ÐØ	Ñ	$€BØ	Ñ	%€BØ�6‰6�8‰8˜Ÿ™Ÿ™Ð Ð Ü�6Š6�(‘,Ó¤"§&¢&¨©Ó"6Ó6Ð6Ð6Ø”4Ø! $ B 3˜×.Ñ.Ó0Ø& s t˜_×3Ñ3Ó5Ü"'Ð(8Ó"9Ü�r—v‘v“x“=´#°b·f±f³h³-ÜœC¤§	¢	¨&×*<Ñ*<¸RÑ*@Ó AÓBÓCÜ ¤¤R§Y¢Y¨v×/AÑ/AÀ"Ñ/EÓ%FÓ!GÓHñð ð r"   c                óš  ^• [        U 5      n0 n[        U5       Hf  u  pg[        U R                  US      5      [	        U R
                  US      5      [        U5      4nUR                  U/ 5      R                  U5        Mh     [        R                  R                  U5      n	[        R                  " U R                  SS2U* S24   [        R                  5      R                  5       n
[        R                   " [        U5      ["        5      m0 n[        U5       GHY  u  pg[        U R                  US      5      nU[	        U R
                  US      5      [        U5      4nXX    Vs/ s HH  oÝU:w  d  M
  [%        U R&                  XM   S      5      [%        U R&                  US      5      :w  d  MF  UPMJ     nnU(       a7  U[        U	R)                  U5      5         nU R                  Xò* S24   X§'   STU'   UR                  U R*                  U   [-        SSSSS95      nUS==   S-  ss'   US==   [        U5      -  ss'   TU   (       d  GM6  US==   S-  ss'   US	==   [        U5      -  ss'   GM\     [-        [        U5      [        TR/                  5       5      [        [        U R0                  5      5      [        [/        U4S
 j[        U5       5       5      5      US9nU(       aV  [        R                   " [        U R0                  5      ["        S9n[        U5       H  u  pgTU   (       d  M  SUU'   M     U
UU4$ U
U4$ s  snf )zãReturn [N,course_dim] donor features matched on faculty, calendar semester,
and EXACT enrollment-set size, excluding the original student-semester group.
Never reads outcome labels. Unmatched groups are unchanged and reported.
r   NT)r   Úmatched_groupsr   Úmatched_rowsr   rJ   r   r‡   rˆ   c              3  óV   >#   • U  H  u  pTU   (       d  M  [        U5      v •  M      g 7fr'   rF   )rG   r_   rm   Úmatcheds      €r    rH   Ú'matched_peer_placebo.<locals>.<genexpr>x   s&   øé € ÐBuÒUfÉcÈaÐjqÐrsÕjtÃ6Ä3ÀqÇ6À6ÒUfùs   ƒ)—))Útotal_groupsr‡   Ú
total_rowsrˆ   r3   r   )r!   rU   r   r   r   r5   r
   r   r   r   ÚrandomÚdefault_rngr   r8   r9   ÚcopyrQ   rS   r   r   ÚchoiceÚfaculty_namesr7   ri   r   )r   ÚseedÚ
course_dimÚreturn_maskr   ÚbucketsÚgiÚidsÚkÚrngÚoverrideÚfaculty_summaryÚfÚotherÚdonorsÚchosenÚcurr   Ú	row_matchrŠ   s                      @r    Úmatched_peer_placebor£   [   sÛ  ø€ ô
 ˜Ó€FØ€GÜ˜FÖ#‰ˆÜˆv×!Ñ! # a¡&Ñ)Ó*¬5°×1HÑ1HÈÈQÉÑ1PÓ+QÔRUÐVYÓRZÐ
[ˆØ×Ñ˜1˜RÓ ×'Ñ'¨Ö+ñ $ô 	�	‰	×Ñ˜dÓ#€CÜ�ZŠZ˜Ÿ™¢q¨*¨© ~Ñ6´r·z±zÓB×GÑGÓI€HÜ�HŠH”S˜“[¤Ó&€GØ€OÜ˜F×#‰ˆÜ
ˆf× Ñ   Q¡Ñ(Ó
)ˆØŒU�6×*Ñ*¨3¨q©6Ñ2Ó3´C¸³HÐ
=ˆØ#*¢:ó Z¢:˜%¸±“Ü�F×%Ñ% f¡m°AÑ&6Ñ7Ó8¼#¸f×>OÑ>OÐPSÐTUÑPVÑ>WÓ:XÑX÷ ¡:ˆð ZæØœ#˜cŸj™j¨Ó0Ó1Ñ2ˆFØ Ÿ.™.¨°±Ð)<Ñ=ˆH‰MØˆG�B‰KØ×&Ñ& v×';Ñ';¸AÑ'>Ü
�a q¨a¸QÑ
?óAˆàˆH‹�qÑ‹˜˜V›¤c¨#£hÑ.›Ø�2�;Š;ØÐ Ó! 1Ñ$Ó! S¨Ó%8¼#¸c»(Ñ%BÖ%8ñ $ô œS ›[¼¸G¿K¹K»MÓ8JÜœs 6§8¡8›}Ó-¼3¼sÔBuÔU^Ð_eÔUfÓBuÓ?uÓ;vØ'ñ)€Fö Ü—(’(œ3˜vŸx™x›=¬tÑ4ˆ	Ü Ö'‰FˆBØ�r�{‰{¨$˜9 S›>ñ (à˜˜yÐ(Ð(Ø�Fˆ?Ðùò'Zs   Å)	MÅ68MÆ2M)Nr   )é   )é   rK   F)Ú__doc__Ú
__future__r   Únumpyr   rP   Útorch.utils.datar   r!   r$   rb   ro   r…   r£   rC   r"   r    Ú<module>rª      s:   ðÙ PÝ "Û Û Ý $ôô=˜ô =ò zò<ôõ>$r"   