t:i\SrSSKrSSKrSSKJr SSKJr SSKJrJ r J r J r J r J r SSKJr SSKJrJrJrJr SSSSSS .S \ \S \ \S \ \S \ \S\ \S\ \/\44 Sjjr\"SSS9S\SS4Sj5r\"SSS9S\ \\44Sj5r\\"SSSSS9S\S\ S4Sj55rg)z Global configuration for XGBoostN)contextmanager)wraps)AnyCallableDictIteratorOptionalcast)_F)_LIB _check_callc_strpy_str)header extra_note parametersreturnssee_alsorrrrrreturnc ^^^^^^^^SmSmS[[S[4SjmS[S[4UUUUUUUU4SjjnU$)aDecorator to format docstring for config functions. Parameters ---------- header: str An introducion to the function extra_note: str Additional notes parameters: str Parameters of the function returns: str Return value see_also: str Related functions a {header} Global configuration consists of a collection of parameters that can be applied in the global scope. See :ref:`global_config` for the full list of parameters supported in the global configuration. {extra_note} .. versionadded:: 1.4.0 af Example ------- .. code-block:: python import xgboost as xgb # Show all messages, including ones pertaining to debugging xgb.set_config(verbosity=2) # Get current value of global configuration # This is a dict containing all parameters in the global configuration, # including 'verbosity' config = xgb.get_config() assert config['verbosity'] == 2 # Example of using the context manager xgb.config_context(). # The context manager will restore the previous value of the global # configuration upon exiting. with xgb.config_context(verbosity=0): # Suppress warning caused by model generated with XGBoost version < 1.0.0 bst = xgb.Booster(model_file='./old_model.bin') assert xgb.get_config()['verbosity'] == 2 # old value restored Nested configuration context is also supported: Example ------- .. code-block:: python with xgb.config_context(verbosity=3): assert xgb.get_config()["verbosity"] == 3 with xgb.config_context(verbosity=2): assert xgb.get_config()["verbosity"] == 2 xgb.set_config(verbosity=2) assert xgb.get_config()["verbosity"] == 2 with xgb.config_context(verbosity=3): assert xgb.get_config()["verbosity"] == 3 valuercUcS$U$)N)rs Q/srv/projetos/modelo_ml_acdoc/venv/lib/python3.13/site-packages/xgboost/config.py none_to_strconfig_doc..none_to_str\s]r--funcc>^TRT"T5T"T5S9T"T5-T"T5-T"T5-T"T 5-Tl[T5S[S[S[4U4Sjj5n[ [ U5$)N)rrargskwargsrc>T"U0UD6$Nr)r"r#r s rwrap6config_doc..config_doc_decorator..wrapjs(( (r)format__doc__rrr r ) r r&common_example doc_templaterrrrrrs ` rconfig_doc_decorator(config_doc..config_doc_decorator_s   "6*{:7N  *% &'"  # .)  * (#  $  t ) )s )s )  )B~r)r strr ) rrrrrr,r*r+rs ````` @@@r config_docr/ sI0 L)NV.8C=.S.2"" rz# Set global configuration. z Parameters ---------- new_config: Dict[str, Any] Keyword arguments representing the parameters and their values )rr new_configc 0nUR5Hup#UcM X1U'M [R"U5n[[R "[ U555 gr%)itemsjsondumpsrr XGBSetGlobalConfigr)r0not_nonekvconfigs r set_configr:ssQH  " =QK#ZZ !F''f 67rz9 Get current values of the global configuration. zu Returns ------- args: Dict[str, Any] The list of global parameters and their values )rrc[R"5n[[R"[R "U555 UR nU(de[R"[U55nU$r%) ctypesc_char_prr XGBGetGlobalConfigbyrefrr3loadsr) config_strrr9s r get_configrBsU"J'' Z(@AB   E L5 ZZu &F Mrz; Context manager for global XGBoost configuration. z .. note:: All settings, not just those presently modified, will be returned to their previous values when the context manager is exited. This is not thread-safe. z See Also -------- set_config: Set global XGBoost configuration get_config: Get current values of the global configuration )rrrrc+# [5R5n[S0UD6 Sv [S0UD6 g![S0UD6 f=f7f)Nr)rBcopyr:)r0 old_configs rconfig_contextrFs@2""$J!  Z  Z s$A7 A AA)r)r<r3 contextlibr functoolsrtypingrrrrr r _typingr corer rrrr.r/r:rBrFrrrrLsD& %@@22 ! $ $!" c SMc  c  c c] c sm c rdBhc L   8S8T8 8    DcN     !.!!$!/0!r