ó
    ›uhj‰<  ã                  óX  • % S SK Jr  S SKJr  S SKJrJrJrJrJ	r	  S SK
rS SKrSSKJr  SSKJr  1 Skr1 S	kr1 S
kr1 Skr1 Skr1 Skr1 Skr1 Skr\" SS9 " S S5      5       r\" SSS5      \" SSSSS9\" SSSSSS9\" SS S!SSSS"9\" S#S$S%SSSSS&9\" S'S(S)SSSSSS*9\" S+S,S-SSSSSSS.9	\" S/S0S1SSSSSSSS29
\" S3S4S5SSSSSSSSS69\" S7S8S9SSSSSSSSSS:9S;.
rS<\S='   \ " S> S?5      5       rSES@ jr\R>                  4SFSA jjr SGSB jr!        SHSC jr"              SISD jr#g)Jé    )Úannotations)Ú	dataclass)ÚDictÚIterableÚListÚSequenceÚTupleNé   )ÚSuiteConfig)Úbaseline_feature_columns>	   Úreg_span_daysÚprev_ssvhk_NHHKÚprev_semester_NHHKÚprev_semester_ordinalÚreg_last_days_from_openÚreg_after_deadline_countÚreg_first_days_from_openÚprev_ssvhk_semester_ordinalÚhist_target_course_pass_rate>	   Úhist_component_coursesÚhist_main_semester_countÚhist_ssvhk_semester_countÚhist_course_grade10_medianÚhist_same_course_pass_rateÚhist_component_grade_medianÚrecent3_course_grade10_medianÚhist_warning_credit_debt_countÚrecent3_component_grade_median>   Úeng_course_seen_beforeÚeng_has_course_historyÚeng_repeat_course_flagÚeng_has_student_historyÚeng_student_seen_beforeÚeng_has_component_historyÚeng_has_same_course_historyÚ!eng_has_previous_semester_history>   Úeng_student_grade_trendr#   Úeng_student_prior_mean_gradeÚeng_student_recent_mean_gradeÚeng_student_long_duration_flagÚeng_student_prior_failure_rateÚeng_student_prior_failure_countÚeng_student_recent_failure_rateÚ eng_student_prior_semester_countÚ eng_student_recent_failure_countÚ#eng_student_failure_rate_volatilityÚ$eng_student_prior_registration_countÚ%eng_student_recent_registration_countÚ%eng_student_semesters_since_last_seenÚ(eng_student_semesters_since_last_failureÚ)eng_student_consecutive_failure_semesters>   Úeng_course_grade_trendr   Úeng_course_prior_mean_gradeÚeng_course_recent_mean_gradeÚeng_course_prior_failure_rateÚeng_global_prior_failure_rateÚeng_course_prior_failure_countÚeng_course_recent_failure_rateÚeng_course_prior_semester_countÚeng_course_recent_failure_countÚ eng_course_smoothed_failure_rateÚ"eng_course_failure_rate_volatilityÚ#eng_course_prior_registration_countÚ$eng_course_recent_registration_countÚ$eng_course_semesters_since_last_seenÚ'eng_course_semesters_since_last_failureÚ(eng_course_consecutive_failure_semesters>   r!   Úeng_ability_difficulty_gapÚeng_same_course_best_gradeÚeng_same_course_last_gradeÚeng_same_course_mean_gradeÚeng_same_course_grade_trendÚeng_low_gpa_x_difficult_courseÚeng_same_course_prior_attemptsÚeng_student_risk_x_course_riskÚ!eng_recent_ability_difficulty_gapÚ"eng_new_student_x_difficult_courseÚ"eng_same_course_prior_failure_rateÚ#eng_same_course_prior_failure_countÚ$eng_repeat_course_x_previous_failureÚ,eng_same_course_semesters_since_last_attempt>   Úeng_is_special_termÚeng_target_term_numberÚeng_student_program_stageÚeng_is_first_main_semesterÚeng_is_second_main_semester>   Úeng_workload_deltaÚeng_warning_per_semesterÚeng_hist_failed_credits_gt9Úeng_prev_failed_credits_gt3Úeng_prev_failed_credits_gt6Úeng_hist_failed_credits_gt18Úeng_prev_failed_credit_ratioÚeng_log1p_hist_failed_creditsÚeng_log1p_prev_failed_creditsÚeng_prev_gpa_shortfall_below5Úeng_prev_gpa_shortfall_below6Úeng_course_status_fit_completedÚeng_recent_minus_cumulative_gpaÚ!eng_course_status_total_completedÚ$eng_hist_failed_credits_per_semesterÚ$eng_hist_passed_credits_per_semesterÚ$eng_log1p_course_prior_registrationsÚ%eng_log1p_student_prior_registrationsT)Úfrozenc                  ó²   • \ rS rSr% S\S'   S\S'   S\S'   SrS\S'   SrS\S	'   SrS\S
'   SrS\S'   Sr	S\S'   Sr
S\S'   SrS\S'   SrS\S'   SrS\S'   Srg)ÚExperimentSpecé‡   ÚstrÚcodeÚslugÚdescriptionFÚboolÚclean_basicÚdrop_course_statusÚreduce_redundancyÚadd_availabilityÚadd_studentÚ
add_courseÚadd_compatibilityÚadd_termÚadd_transformations© N)Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__Ú__annotations__rt   ru   rv   rw   rx   ry   rz   r{   r|   Ú__static_attributes__r}   ó    ÚI/mnt/data/early_warning_feature_suite/early_warning_suite/feature_sets.pyrm   rm   ‡   sq   ‡ à
ƒIØ
ƒIØÓØ€K�ÓØ$Ð˜Ó$Ø#Ð�tÓ#Ø"Ð�dÓ"Ø€K�ÓØ€J�ÓØ#Ð�tÓ#Ø€HˆdÓØ %Ð˜Ö%r„   rm   ÚE0Úbaselinez#Original effective-number baseline.ÚE1Úbasic_cleanzQRemove constants, unstable timing, absolute time, and one course-risk complement.)rt   ÚE2Úcourse_status_ablationz0E1 plus remove all sparse course_status columns.)rt   ru   ÚE3Úredundancy_reductionz/E2 plus conservative redundant-feature pruning.)rt   ru   rv   ÚE4Úavailabilityz4E3 plus missingness/history availability indicators.)rt   ru   rv   rw   ÚE5Ústudent_historyz*E4 plus leak-safe student historical risk.)rt   ru   rv   rw   rx   ÚE6Údynamic_course_riskz&E5 plus leak-safe dynamic course risk.)rt   ru   rv   rw   rx   ry   ÚE7Úcompatibilityz>E6 plus student-course history and compatibility interactions.)rt   ru   rv   rw   rx   ry   rz   ÚE8Úterm_contextz)E7 plus academic-term and cohort context.)rt   ru   rv   rw   rx   ry   rz   r{   ÚE9Úfull_engineeredzZE8 plus exposure-normalized, threshold, log, workload, and compressed curriculum features.)	rt   ru   rv   rw   rx   ry   rz   r{   r|   )
r†   rˆ   rŠ   rŒ   rŽ   r�   r’   r”   r–   r˜   zDict[str, ExperimentSpec]ÚEXPERIMENTSc                  óf   • \ rS rSr% S\S'   S\S'   S\S'   S\S'   S\S	'   S\S
'   S\S'   S\S'   Srg)ÚPreparedMatricesé¥   úpd.DataFrameÚX_trainÚX_testz
np.ndarrayÚy_trainÚy_testz	List[str]Úfeature_namesÚdropped_columnsÚmetadata_trainÚmetadata_testr}   N)r~   r   r€   r�   r‚   rƒ   r}   r„   r…   rœ   rœ   ¥   s2   ‡ àÓØÓØÓØÓØÓØÓØ Ó ØÖr„   rœ   c                ó¼   • U R                  [        R                  SS9nUR                  [        R
                  [        R
                  * /[        R                  5      $ )NÚcoerce©Úerrors)ÚapplyÚpdÚ
to_numericÚreplaceÚnpÚinfÚnan)ÚframeÚouts     r…   Ú_numericr´   ±   s<   € Ø
�+‰+”b—m‘m¨Hˆ+Ð
5€CØ�;‰;œŸ™¤§¡ Ð(¬"¯&©&Ó1Ð1r„   c                ó”   • XR                   ;   a  [        R                  " X   SS9$ [        R                  " X R                  [
        S9$ )Nr¨   r©   )ÚindexÚdtype)Úcolumnsr¬   r­   ÚSeriesr¶   Úfloat)r²   ÚnameÚdefaults      r…   Ú_seriesr½   ¶   s4   € Ø�}‰}ÓÜ�}Š}˜U™[°Ñ:Ð:Ü�9Š9�W§K¡K´uÑ=Ð=r„   c                óŠ  • [         R                  " U R                  S9n[        U SS5      R	                  S5      S:„  R                  [        5      US'   [        U S5      R                  5       R                  [        5      US'   [        U SS5      R	                  S5      S:„  R                  [        5      US'   [        U S	S5      R	                  S5      S:„  R                  [        5      US
'   [        U SS5      R	                  S5      S:„  R                  [        5      US'   S H  nX1R                  ;   a  X   OSX#'   M     U$ )N©r¶   Úhist_semester_countr   r"   Úprev_semester_gpa10r&   Úhist_same_course_attemptsr%   Úhist_target_course_countr    Úhist_component_countr$   )r#   r   r!   ç        )	r¬   Ú	DataFramer¶   r½   ÚfillnaÚastyperº   Únotnar¸   )r²   Úhistr³   Úcs       r…   Ú_availability_featuresrÌ   ¼   s.  € Ü
�,Š,˜UŸ[™[Ñ
)€CÜ&-¨eÐ5JÈAÓ&N×&UÑ&UÐVWÓ&XÐ[\Ñ&\×%dÑ%dÔejÓ%k€CÐ!Ñ"Ü/6°uÐ>SÓ/T×/ZÑ/ZÓ/\×/cÑ/cÔdiÓ/j€CÐ+Ñ,Ü*1°%Ð9TÐVWÓ*X×*_Ñ*_Ð`aÓ*bÐefÑ*f×)nÑ)nÔotÓ)u€CÐ%Ñ&Ü%,¨UÐ4NÐPQÓ%R×%YÑ%YÐZ[Ó%\Ð_`Ñ%`×$hÑ$hÔinÓ$o€CÐ Ñ!Ü(/°Ð7MÈqÓ(Q×(XÑ(XÐYZÓ([Ð^_Ñ(_×'gÑ'gÔhmÓ'n€CÐ#Ñ$Û\ˆØ§¡Ó-�’°3ˆ‹ñ ]à€Jr„   c                ó  • [         R                  " U R                  S9n[        U SS5      R	                  S5      R                  SS9n[        U SS5      R	                  S5      R                  SS9n[        U SS5      R	                  S5      R                  SS9n[        U SS5      R	                  S5      R                  SS9n[        U SS5      R	                  S5      R                  SS9n[        U S	S5      R	                  S5      R                  SS9n	[        U S
5      n
[        U S5      n[        U S5      n[        U S5      nXER                  SS9-  US'   XhR                  SS9-  US'   XxR                  SS9-  US'   X˜R                  SS9-  US'   X«-
  US'   XÍ-
  US'   US:„  R                  [        5      US'   US:„  R                  [        5      US'   US:„  R                  [        5      US'   US:„  R                  [        5      US'   SU
-
  R                  SS9US'   SU
-
  R                  SS9US '   [        R                  " U5      US!'   [        R                  " U5      US"'   [        R                  " [        US#S5      R	                  S5      R                  SS95      US$'   [        R                  " [        US%S5      R	                  S5      R                  SS95      US&'   U(       a�  [        U [        U5         5      R	                  S'5      nUR                  S(S)9US*'   U Vs/ s H  oÿR                  S+5      (       d  M  UPM     nnU(       a  UU   R                  S(S)9OS'US,'   U$ S'US*'   S'US,'   U$ s  snf )-Nr¿   Úprev_failed_creditsr   )ÚlowerÚprev_registered_creditsÚhist_failed_credits_sumÚhist_passed_credits_sumrÀ   Úhist_warning_countrÁ   Úprev_cumulative_gpa10Ú"target_semester_registered_creditsÚhist_registered_credits_meang      ð?r_   rg   rh   rZ   re   rY   é   r\   é   r]   é	   r[   é   r^   g      @rc   g      @rb   ra   r`   r1   rj   rA   ri   rÅ   r
   ©Úaxisrf   Úcourse_status_FITrd   )r¬   rÆ   r¶   r½   rÇ   ÚcliprÈ   rº   r¯   Úlog1pr´   ÚlistÚsumÚ
startswith)r²   rÊ   Úcourse_status_colsr³   Ú	prev_failÚprev_regÚ	hist_failÚ	hist_passÚhist_semÚwarning_countÚprev_gpaÚcum_gpaÚworkloadÚhistorical_workloadÚstatusrË   Úfit_colss                    r…   Ú_transformation_featuresrð   È   s­  € ô
 �,Š,˜UŸ[™[Ñ
)€CÜ˜Ð4°aÓ8×?Ñ?ÀÓB×GÑGÈaÐGÐP€IÜ�uÐ7¸Ó;×BÑBÀ1ÓE×JÑJÐQRÐJÐS€HÜ˜Ð8¸!Ó<×CÑCÀAÓF×KÑKÐRSÐKÐT€IÜ˜Ð8¸!Ó<×CÑCÀAÓF×KÑKÐRSÐKÐT€IÜ�uÐ3°QÓ7×>Ñ>¸qÓA×FÑFÈQÐFÐO€HÜ˜EÐ#7¸Ó;×BÑBÀ1ÓE×JÑJÐQRÐJÐS€MÜ�uÐ3Ó4€HÜ�eÐ4Ó5€GÜ�uÐBÓC€HÜ! %Ð)GÓHÐà*3·m±mÈ#°mÐ6NÑ*N€CÐ&Ñ'Ø2;¿m¹mÐRU¸mÐ>VÑ2V€CÐ.Ñ/Ø2;¿m¹mÐRU¸mÐ>VÑ2V€CÐ.Ñ/Ø&3·m±mÈ#°mÐ6NÑ&N€CÐ"Ñ#Ø-5Ñ-?€CÐ)Ñ*Ø (Ñ >€CÐÑØ*3°a©-×)?Ñ)?ÄÓ)F€CÐ%Ñ&Ø*3°a©-×)?Ñ)?ÄÓ)F€CÐ%Ñ&Ø*3°a©-×)?Ñ)?ÄÓ)F€CÐ%Ñ&Ø+4°r©>×*AÑ*AÄ%Ó*H€CÐ&Ñ'Ø,/°(©N×+@Ñ+@ÀqÐ+@Ð+I€CÐ'Ñ(Ø,/°(©N×+@Ñ+@ÀqÐ+@Ð+I€CÐ'Ñ(Ü+-¯8ª8°IÓ+>€CÐ'Ñ(Ü+-¯8ª8°IÓ+>€CÐ'Ñ(Ü35·8²8Ü�Ð<¸aÓ@×GÑGÈÓJ×OÑOÐVWÐOÐXó4€CÐ/Ñ0ô 35·(²(Ü�Ð;¸QÓ?×FÑFÀqÓI×NÑNÐUVÐNÐWó3€CÐ.Ñ/ö Ü˜%¤Ð%7Ó 8Ñ9Ó:×AÑAÀ#ÓFˆØ39·:±:À1°:Ð3EˆÐ/Ñ0Ù1ÓWÒ1˜!·\±\ÐBU×5V—AÑ1ˆÐWæ,4ˆF�8Ñ× Ñ  aÐ Ñ(¸#ð 	Ð-Ñ.ð €Jð 47ˆÐ/Ñ0Ø14ˆÐ-Ñ.Ø€Jùò Xs   Ì.M?ÍM?c                ó†  ^• [        X5      nU Vs/ s H  owUR                  ;   d  M  UPM     nnU Vs/ s H  owR                  S5      (       d  M  UPM     nn/ n	UR                  (       a¦  U Vs/ s H  ow[        ;  d  M  UPM     n
nU	R                  S U 5       5        U
n[        X   5      nU Vs/ s H+  nX·   R                  5       R                  5       S::  d  M)  UPM-     nnU Vs/ s H  owU;  d  M
  UPM     nnU	R                  U5        UR                  (       aS  U Vs/ s H  owR                  S5      (       d  M  UPM     nnU Vs/ s H  owU;  d  M
  UPM     nnU	R                  U5        UR                  (       aG  U Vs/ s H  ow[        ;   d  M  UPM     nnU Vs/ s H  owU;  d  M
  UPM     nnU	R                  U5        [        X   5      R                  SS9/n[        X   5      R                  SS9/nUR                  (       aO  UR                  [        U T5      R                  SS95        UR                  [        X5      R                  SS95        UR                   (       a[  [#        U4S j[$         5       5      nUR                  TU   R                  SS95        UR                  UU   R                  SS95        UR&                  (       a[  [#        U4S j[(         5       5      nUR                  TU   R                  SS95        UR                  UU   R                  SS95        UR*                  (       a[  [#        U4S j[,         5       5      nUR                  TU   R                  SS95        UR                  UU   R                  SS95        UR.                  (       a[  [#        U4S	 j[0         5       5      nUR                  TU   R                  SS95        UR                  UU   R                  SS95        UR2                  (       aQ  UR                  [5        U TU5      R                  SS95        UR                  [5        XU5      R                  SS95        [6        R8                  " USS
9n[6        R8                  " USS
9nUR:                  S S 2UR                  R=                  SS9) 4   nUR:                  S S 2UR                  R=                  SS9) 4   nUR?                  UR                  S9nURA                  SS
9nURC                  U5      RC                  S5      nURC                  U5      RC                  S5      nURE                  [F        RH                  [F        RH                  * /S5      RK                  [F        RL                  5      nURE                  [F        RH                  [F        RH                  * /S5      RK                  [F        RL                  5      nURN                  URP                  URR                  URT                  URV                  S4 Vs/ s H'  nXpR                  ;   d  M  XqR                  ;   d  M%  UPM)     nnU U   R                  SS9RY                  5       nUU   R                  SS9RY                  5       nTR                   HF  nUR                  S5      (       d  M  TU   R[                  5       UU'   X7   R[                  5       UU'   MH     []        UU[6        R^                  " XR`                     SS9R[                  [b        S9[6        R^                  " XR`                     SS9R[                  [b        S9[e        UR                  5      [#        [g        U	5      5      UUS9$ s  snf s  snf s  snf s  snf s  snf s  snf s  snf s  snf s  snf s  snf )NÚcourse_status_c              3  ó<   #   • U  H  o[         ;   d  M  Uv •  M     g 7f©N)ÚBASIC_DROP_COLUMNS)Ú.0rË   s     r…   Ú	<genexpr>Ú.prepare_experiment_matrices.<locals>.<genexpr>	  s   é € ÐG¢)˜QÔ4FÑ/F—q‘q¢)ùs   ‚“	r
   T)Údropc              3  óJ   >#   • U  H  oTR                   ;   d  M  Uv •  M     g 7frô   ©r¸   ©rö   rË   Ú
hist_trains     €r…   r÷   rø   #  s    øé € ÐWÒ!;˜AÀJ×DVÑDVÑ?V—a‘aÒ!;ùó   ƒ#š	#c              3  óJ   >#   • U  H  oTR                   ;   d  M  Uv •  M     g 7frô   rû   rü   s     €r…   r÷   rø   '  s    øé € ÐVÒ!:˜AÀ:×CUÑCUÑ>U—a‘aÒ!:ùrþ   c              3  óJ   >#   • U  H  oTR                   ;   d  M  Uv •  M     g 7frô   rû   rü   s     €r…   r÷   rø   +  s    øé € ÐRÒ!6˜A¸z×?QÑ?QÑ:Q—a‘aÒ!6ùrþ   c              3  óJ   >#   • U  H  oTR                   ;   d  M  Uv •  M     g 7frô   rû   rü   s     €r…   r÷   rø   /  s   øé € ÐI¢˜A°j×6HÑ6HÑ1H—a‘a¢ùrþ   rÛ   Úfirst)Úkeeprû   r   rÅ   Útarget_statusÚeng_Úraiser©   )r·   )rŸ   r    r¡   r¢   r£   r¤   r¥   r¦   )4r   r¸   râ   rt   rõ   Úextendr´   ÚdropnaÚnuniqueru   rv   ÚREDUNDANT_DROP_COLUMNSÚreset_indexrw   ÚappendrÌ   rx   ÚsortedÚSTUDENT_HISTORICAL_COLUMNSry   ÚCOURSE_HISTORICAL_COLUMNSrz   ÚCOMPATIBILITY_COLUMNSr{   ÚTERM_COLUMNSr|   rð   r¬   ÚconcatÚlocÚ
duplicatedÚreindexÚmeanrÇ   r®   r¯   r°   rÈ   Úfloat32Ústudent_colÚ
course_colÚregistration_colÚsemester_code_colÚsemester_colÚcopyÚto_numpyrœ   r­   Ú
target_colrº   rà   Úset)Útrain_dfÚtest_dfrý   Ú	hist_testÚspecÚconfigÚ	base_colsrË   Úoriginal_course_statusÚdroppedr  Únumeric_trainÚ	constantsÚcourse_statusÚ	redundantÚtrain_partsÚ
test_partsÚcolsrŸ   r    ÚmeansÚmetadata_colsr¥   r¦   s     `                     r…   Úprepare_experiment_matricesr2  ú   s½  ø€ ô )¨Ó:€IÙ%Ó>šI�q¨g¯o©oÑ)=—™I€IÐ>Ù)2ÓUª A·l±lÐCS×6TŸa©ÐÐUØ€Gà××Ù$ÓDš9�aÔ1CÑ(C—™9ˆÐDØ�‰ÑG¡)ÓGÔGØˆ	Ü  Ñ!4Ó5ˆñ ó
â�ØÑ×&Ñ&Ó(×0Ñ0Ó2°aÑ7÷ Ùð 	ð 
ñ
 !*Ó@¢	˜1°iÑ-?—Q¡	ˆ	Ð@Ø�‰�yÔ!Ø××Ù$-ÓP¢I˜q·±Ð>N×1OŸ¡IˆÐPÙ )ÓD¢	˜1°mÑ-C—Q¡	ˆ	ÐDØ�‰�}Ô%Ø××Ù )ÓI¢	˜1Ô2HÑ-H—Q¡	ˆ	ÐIÙ )Ó@¢	˜1°iÑ-?—Q¡	ˆ	Ð@Ø�‰�yÔ!ä˜HÑ/Ó0×<Ñ<À$Ð<ÐGÐH€KÜ˜7Ñ-Ó.×:Ñ:ÀÐ:ÐEÐF€Jà××Ø×ÑÔ1°(¸JÓG×SÑSÐY]ÐSÐ^Ô_Ø×ÑÔ0°ÓD×PÑPÐVZÐPÐ[Ô\Ø××ÜÔWÕ!;ÓWÓWˆØ×Ñ˜: dÑ+×7Ñ7¸TÐ7ÐBÔCØ×Ñ˜) D™/×5Ñ5¸4Ð5Ð@ÔAØ‡‡ÜÔVÕ!:ÓVÓVˆØ×Ñ˜: dÑ+×7Ñ7¸TÐ7ÐBÔCØ×Ñ˜) D™/×5Ñ5¸4Ð5Ð@ÔAØ××ÜÔRÕ!6ÓRÓRˆØ×Ñ˜: dÑ+×7Ñ7¸TÐ7ÐBÔCØ×Ñ˜) D™/×5Ñ5¸4Ð5Ð@ÔAØ‡}‡}ÜÔI¥ÓIÓIˆØ×Ñ˜: dÑ+×7Ñ7¸TÐ7ÐBÔCØ×Ñ˜) D™/×5Ñ5¸4Ð5Ð@ÔAØ××Ø×ÑÜ$ X¨zÐ;QÓR×^Ñ^ÐdhÐ^Ðiô	
ð 	×ÑÜ$ WÐ9OÓP×\Ñ\ÐbfÐ\Ðgô	
ô �iŠi˜¨!Ñ,€GÜ�YŠY�z¨Ñ*€FØ�k‰kš!˜gŸo™o×8Ñ8¸gÐ8ÐFÐFÐFÑG€GØ�Z‰Zš˜FŸN™N×5Ñ5¸7Ð5ÐCÐCÐCÑD€FØ�^‰^ G§O¡Oˆ^Ð4€Fà�L‰L˜aˆLÐ €EØ�n‰n˜UÓ#×*Ñ*¨3Ó/€GØ�]‰]˜5Ó!×(Ñ(¨Ó-€FØ�o‰oœrŸv™v¬¯© wÐ/°Ó5×<Ñ<¼R¿Z¹ZÓH€GØ�^‰^œRŸV™V¤b§f¡f WÐ-¨sÓ3×:Ñ:¼2¿:¹:ÓF€Fð
 ×ÑØ×ÑØ×#Ñ#Ø×$Ñ$Ø×ÑØñ
óò
ˆAð × Ñ Ñ ó 	
ð &'¯/©/Ñ%9÷ 	
ñ
ð ð ð ˜mÑ,×8Ñ8¸dÐ8ÐC×HÑHÓJ€NØ˜MÑ*×6Ñ6¸DÐ6ÐA×FÑFÓH€MØ×ÔˆØ�<‰<˜×ÓØ *¨1¡× 6Ñ 6Ó 8ˆN˜1ÑØ(™|×4Ñ4Ó6ˆM˜!Óñ  ô
 ØØÜ—’˜h×'8Ñ'8Ñ9À'ÑJ×SÑSÔZ_ÐSÐ`Ü�}Š}˜W×%6Ñ%6Ñ7ÀÑH×QÑQÔX]ÐQÐ^Ü˜7Ÿ?™?Ó+Üœs 7›|Ó,Ø%Ø#ñ	ð 	ùòm ?ùÚUùò Eùò
ùò
 Aùò QùÚDùò JùÚ@ùòZs{   ‘^¨^´^Á^Á0^Â^Â4(^ Ã ^ Ã,	^%Ã9^%Ä'^*Å^*Å	^/Å^/Æ^4Æ^4Æ(	^9Æ5^9Ø6^>Ù^>Ù^>)r²   rž   Úreturnrž   )r²   rž   r»   ro   r¼   rº   r3  z	pd.Series)r²   rž   rÊ   rž   r3  rž   )r²   rž   rÊ   rž   rã   zSequence[str]r3  rž   )r!  rž   r"  rž   rý   rž   r#  rž   r$  rm   r%  r   r3  rœ   )$Ú
__future__r   Údataclassesr   Útypingr   r   r   r   r	   Únumpyr¯   Úpandasr¬   r%  r   Údatar   rõ   r
  ÚAVAILABILITY_COLUMNSr  r  r  r  ÚTRANSFORM_COLUMNSrm   rš   r‚   rœ   r´   r±   r½   rÌ   rð   r2  r}   r„   r…   Ú<module>r<     s  ðÞ "å !ß 8Õ 8ã Û å Ý *ò
Ð ò
Ð ò	Ð òÐ ò&Ð ò(Ð ò$€òÐ ñ, �$Ñ÷&ð &ó ð&ñ  ˜˜zÐ+PÓ
QÙ
˜˜}ð  /Bð  PTñ  UÙ
˜Ð7Ð9kÐy}ð  SWñ  XÙ
˜Ð5Ð7hÐvzð  PTð  hlñ  mÙ
˜˜~Ð/eÐswð  MQð  eið  |@ñ  AÙ
˜Ð0Ð2^Ðlpð  FJð  ^bð  uyð  GKñ  LÙ
˜Ð4Ð6^Ðlpð  FJð  ^bð  uyð  GKð  X\ñ  ]Ù
˜˜Ð0pð  Cð  X\ð  ptð  GKð  Y]ð  jnð  BFñ  GÙ
˜˜~Ð/ZÐhlð  BFð  Z^ð  quð  CGð  TXð  lpð  {ñ  @Ù
˜Ð0ð  3Oð  ]að  vzð  NRð  eið  w{ð  HLð  `dð  osð  IMñ  Nñ*€Ð&ó ð ÷ ð  ó ð ô2ð
 >@¿V¹Vö >ô	ð/Øð/à
ð/ð &ð/ð ô	/ðdhØðhàðhð ðhð ð	hð
 ðhð ðhð õhr„   