MpjUSSKrSSKrSSKrSSKrSSKrSSKJr SSKJrJr SSK J r /SQr \R"5"\R5r"SS5rSrS rg) N)contextmanager)datetimetimezone)AutoPropagatedCallback)Xymetadatafitted_estimatorc\rSrSrSr\S5r\S5rSrSr Sr Sr SS jr S r S S S S S .S jrS S S S S .Sjr\S5rSrg )CallbackContextaxTask level context for the callbacks. This class is responsible for managing the callbacks and holding the tree structure of an estimator's tasks. Each instance corresponds to a task of the estimator. This class should not be instantiated directly, but through the `_init_callback_context` method of the estimator to create the root context or using the `subcontext` method of this class to create sub-contexts. These contexts are passed to the callback hooks to be able to keep track of the position of a task in the task tree from within the callbacks. Attributes ---------- task_name : str The name of the task this context is responsible for. task_id : int The identifier of the task this context is responsible for. It uniquely identifies the task among its siblings. max_subtasks : int or None The maximum number of children tasks for this task. 0 means it's a leaf. None means the maximum number of subtasks is not known in advance. sequential_subtasks : bool Whether this context's subtasks are sequential. When True, children contexts' have consecutive integer task_ids starting from 0. estimator_name : str The name of the estimator that holds this context. parent : CallbackContext or None The parent context of this context. None if this context is the root. root_uuid : uuid.UUID instance The UUID of the root context. All contexts in the same task tree have the same root UUID that is used to identify the task tree itself. init_time : datetime.datetime The time when the context was initialised, in the UTC timezone. source_estimator_name : str or None The name of the estimator that holds the parent task this task was merged with. None if it was not merged with another context. source_task_name : str or None The task name of the parent task this task was merged with. None if it was not merged with another context. cURU5n[US/5UlURRUlX&lX6lXFlXVl SUl [R"5Ul [R"[ R"5Ul0UlSUlSUl[-US5(a3UR.nUR1U5 UR2S-UlU$SUlU$)aPrivate constructor to create a root context. Parameters ---------- estimator : estimator instance The estimator this context is responsible for. task_name : str The name of the root task. task_id : int Identifier for the root task. max_subtasks : int or None The maximum number of subtasks that can be children of the root task. None means the maximum number of subtasks is not known in advance. 0 means it's a leaf. sequential_subtasks : bool Whether the root context has sequential subtasks. If True, children contexts created via `subcontext` will have automatically assigned consecutive integer task_ids starting from 0. _skl_callbacksN_parent_callback_ctxr)__new__getattr _callbacks __class____name__estimator_name task_nametask_id max_subtaskssequential_subtasksparentuuiduuid4 root_uuidrnowrutc init_time _children_mapsource_estimator_namesource_task_namehasattrr _merge_with_propagation_depth)cls estimatorrrrrnew_ctx parent_ctxs ^/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/sklearn/callback/_callback_context.py_from_estimatorCallbackContext._from_estimatorIs6++c"%Y0@"E!*!4!4!=!=%!+&9# JJL$LL6 "(,%#' 94 5 5 #77J    +)3)F)F)JG &*+G &cURU5nURUlURUlURUlX&lX6lXFlXVlURUl[R"[R5Ul SUl0UlSUlSUlUR%U5 U$)aPrivate constructor to create a sub-context. Parameters ---------- parent_context : `CallbackContext` instance The parent context of the new context. task_name : str The name of the task this context is responsible for. task_id : int The identifier of the task this context is responsible for. max_subtasks : int or None The maximum number of tasks that can be children of the task this context is responsible for. 0 means it's a leaf. None means the maximum number of subtasks is not known in advance. sequential_subtasks : bool Whether this context's subtasks are sequential. If True, children contexts created via `subcontext` will have automatically assigned consecutive integer task_ids starting from 0. N)rrrr(rrrrrrr rr!r"rr#r$r% _add_child)r)parent_contextrrrrr+s r- _from_parentCallbackContext._from_parents6++c"+66!/!>!>%3%F%F"%!+&9#*44$LL6 "(,%#'  !!'*r0c#n# Uv URR5H nUShvN M gN 7f)z1Pre-order depth-first traversal of the task tree.N)r#values)selfcontexts r-__iter__CallbackContext.__iter__s/ ))002G  3 s '53 5cURRSUR<SUR<SURS3$)Nz(estimator_name=z , task_name=z , task_id=))rrrrr)r8s r-__repr__CallbackContext.__repr__sL~~&&'("1145*+||nA ' r0c URUR;a3[SURSURSURS35eUR bV[ UR5UR :a3[SURSURSUR S35eXRUR'Xlg) z/Add `child_context` as a child of this context.zCallback context  of estimator z" already has a child with task_id=.Nz%Cannot add child to callback context z8 because it already has its maximum number of children (z).)rr# ValueErrorrrrlenr)r8 child_contexts r-r2CallbackContext._add_childs  D$6$6 6#DNN#3>&&'((0014     )D&&'4+<+<<77G~&&'(''+'8'8&9=  5B=001#r0c URS:waB[SUR<SURSUR<SURS3 5eURUlUR UlUR UlXRRUR 'URUlURUl g)aMerge this context with `other_context`. This method is called on a sub-estimator's root task to merge it with a meta-estimator's leaf task. The sub-estimator's task tree is therefore attached to the meta-estimator's task tree. The root node of the sub-estimator's task tree and the leaf node of the meta-estimator's task tree are both represented by a single node in this combined task tree. rz$Cannot merge callback context (task rAz) with callback context (task z#) because the latter is not a leaf.N) rrCrrrrrr#r%r$)r8 other_contexts r-r'CallbackContext._merge_withs  % % *6t~~6H&&'(&003> //00SU $** $,, &00;?**4<<8!. 7 7%2%A%A"r0Nc TUR(a,Ub)[SURSUSURS35eUR(d,Uc)[SURSUSURS35eUc[ UR 5n[ RUUUUUS9$)a$Create a context for a subtask of the current task. Parameters ---------- task_name : str, default="" The name of the subtask. task_id : int or None, default=None An identifier of the subtask. It must be distinct from the task_ids of its siblings. If None, task_id is automatically set to the next available integer task_id. max_subtasks : int or None, default=0 The maximum number of tasks that can be children of the subtask. 0 means it's a leaf. None means the maximum number of subtasks is not known in advance. sequential_subtasks : bool, default=True Whether the new context's subtasks are sequential. If True, children contexts of the new context, created via `subcontext`, will have automatically assigned consecutive integer task_ids starting from 0. z task_id for  z1 must be None if sequential_subtasks is True for rBz6 must be provided if sequential_subtasks is False for )r3rrrr)rrCrrrDr#r r4)r8rrrrs r- subcontextCallbackContext.subcontexts2  # #(;t2231YK@337>>2B!E ''GOt2231YK@77;~~6FaI  ?$,,-G++% 3 ,  r0c &Sn0nURGHvnU[US/5;aM[[Xb55nURR 5Vs1sH+nUR UR :XdMURiM- n n[U 5[[5- =n (a0[SUSURRSU S[S3 5e0n U Hn X;auU S:Xa@URS S 5n [U 5(aU "5OU n U b [X5OS nXS'O/URU S 5n[U5(aU"5OUnXU 'X\X'M U[![Xb5"X40U D65-nGMy U$s snf) a;Helper to call the hook of all callbacks with their respective arguments. Provide the right arguments to each hook by inspecting their signatures. Any value that is a callable is replaced by what it returns to allow lazy loading of the arguments. Parameters ---------- estimator : estimator instance The estimator calling the callback hook. hook_name : str Name of the callback hook to call. **kwargs: dict Optional keyword arguments passed to the callback context. Returns ------- result : bool True if any hook call returned True. False otherwise. F_propagated_callbackszHook z of the callback z$ has parameters that are not valid: z. The valid parameters are: rBr reconstruction_attributesN)rr_cached_signature parametersr7kind KEYWORD_ONLYnamesetVALID_HOOK_PARAMS_OUT TypeErrorrrgetcallable_from_reconstruction_attributesbool)r8r* hook_namekwargsresultevaluated_argscallback signaturep params_namesdiff args_to_pass param_nameattrsnew_estvals r- _call_hooksCallbackContext._call_hooks!s.H74)@"EE)'(*FGI#--4466A66Q^^+6  <(3/D+EEEtEI;&78J8J8S8S7TU::>@12!5 L* 3"%77 & +F M+3E?? %0E'9:$jjT:'/}}ce#58z2+9+E ('+* d,YM M FU(\ Ms F:F)rrr rPc .URUSUUUUS9 U$)aGCall the `on_fit_task_begin` hook of the callbacks. Parameters ---------- estimator : estimator instance The estimator calling the callback hook. X : array-like or None, default=None The training data of the current task. y : array-like or None, default=None The training targets of the current task. metadata : dict or None, default=None A dictionary containing training metadata for the current task. reconstruction_attributes : dict or None, default=None A dictionary of the sufficient fitted attributes needed to construct a `fitted_estimator` from the current state of the estimator, i.e. an estimator instance ready to predict, transform, etc ... as if the fit had stopped at the beginning of this task. The `fitted_estimator` is the object that will be passed to the callbacks, if required. on_fit_task_beginr]rrr rPrkr8r*rrr rPs r-call_on_fit_task_begin&CallbackContext.call_on_fit_task_beginms1@  )&?   r0c *URUSUUUUS9$)aCall the `on_fit_task_end` hook of the callbacks. Parameters ---------- estimator : estimator instance The estimator calling the callback hook. X : array-like or None, default=None The training data of the current task. y : array-like or None, default=None The training targets of the current task. metadata : dict or None, default=None A dictionary containing training metadata of the current task. reconstruction_attributes : dict or None, default=None A dictionary of the sufficient fitted attributes needed to construct a `fitted_estimator` from the current state of the estimator, i.e. an estimator instance ready to predict, transform, etc ... as if the fit had stopped at the end of this task. The `fitted_estimator` is the object that will be passed to the callbacks, if required. Returns ------- stop : bool Whether or not to stop the current level of iterations at this end of this task. on_fit_task_endrorprqs r-call_on_fit_task_end$CallbackContext.call_on_fit_task_ends/L '&?    r0c ## [US/5Vs/sH0n[U[5(dMURRPM2 nnU(a3[ SURRSUR SUS35eXlURVs/sHEn[U[5(dMURbURUR:dMCUPMG nnU(aN[US5(d=[R"SURRS UR S 35 /nU(a$X@l[US/5nUR"XT-6 Sv U(a2UR Vs/sH nXd;dM UPM nnUR"U6 U?gs snfs snfs snf!U(a8UR Vs/sH nXd;dM UPM Os snfnnUR"U6 U?f=f7f) a.Propagate the context and callbacks to a sub-estimator. Clear the propagated callbacks from the sub-estimator on exit. Only auto-propagated callbacks are propagated to the sub-estimator. An error is raised if the sub-estimator already holds auto-propagated callbacks. The sub-estimator receives this context as an attribute named `_parent_callback_ctx` so that the meta-estimator's task tree can be merged with the sub-estimator's one. Parameters ---------- sub_estimator : estimator instance The estimator to propagate the callbacks and context to. rzThe sub-estimator (z) of a meta-estimator (z() can't have auto-propagated callbacks (z0). Register them directly on the meta-estimator.N set_callbackszThe estimator z7 does not support callbacks. The callbacks attached to z* will not be propagated to this estimator.)r isinstancerrrrXrrrmax_propagation_depthr(r&warningswarnrOryr)r8 sub_estimatorra bad_callbackscallbacks_to_propagatecurr_callbackscbkept_callbackss r-propagate_callback_context*CallbackContext.propagate_callback_contexts"($M3CRH H($:; (H   ' 'H  %m&=&=&F&F%GH$$($7$7#89//AA .2*!OO" +($:; ..6**X-K-KK + "  "'-*Q*Q MM !8!8!A!A BC88<8K8K7LM34  &( " !)? &$]4DbIN  ' '.*Q S 3 %,::":7:" ++^<2i (" 4"&,::":7:"" ++^<2skG=F(F( AG=F-6%F-F-%BG=(F7,G= F2F2#G=7G: G!G! G::G=)rOrrr$r%r)NrT)r __module__ __qualname____firstlineno____doc__ classmethodr.r4r:r>r2r'rLrkrrrvrr__static_attributes__r0r-r r s1f77r--^  $,B:OS, \J`  "&(\  "&- ^E3E3r0r c|[R"U5nUR5Hup4[X#U5 M U$)aReturn a copy of the estimator as if it was fitted. Parameters ---------- estimator : estimator instance The estimator from which to make a ready-to-be-evaluated copy. reconstruction_attributes : dict A dictionary containing the necessary attributes to create a working fitted estimator from this instance. Returns ------- fitted_estimator : estimator instance The fitted copy of this estimator. )copyitemssetattr)r*rP new_estimatorkeyrjs r-r[r[s7"IIi(M-335 C(6 r0cTURcU/$[UR5U/-$)anHelper function to get the path from the root context down to a given context. Parameters ---------- context : `CallbackContext` instance The context to get the path to. Returns ------- list of `CallbackContext` instances The list of the ancestors (itself included) of the given context. The list is ordered from the root context to the given context. )rget_context_path)r9s r-rr&s4 >> !  gnn - 9r0)r functoolsinspectrr| contextlibrrrsklearn.callback._baserrW lru_cacherbrQr r[rrr0r-rs[  %'9C'')'*;*;<w3w3t.r0