> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-2751.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Intégrez W&B à XGBoost pour journaliser automatiquement les métriques de gradient boosting, l’importance des variables et la performance du modèle.

# XGBoost

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Essayer sur Colab
  </a>;

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/boosting/Credit_Scorecards_with_XGBoost_and_W%26B.ipynb" />

Cette page vous montre comment utiliser l’intégration W\&B avec XGBoost pour journaliser automatiquement les métriques de gradient boosting, les configurations du modèle, l’importance des variables et les boosters entraînés afin de vous permettre de suivre, comparer et reproduire vos expériences XGBoost.

Le SDK Python W\&B (`wandb`) inclut un callback `WandbCallback` pour journaliser les métriques, les configurations et les boosters enregistrés lors de l'entraînement avec XGBoost. Vous pouvez voir ici un [tableau de bord W\&B en direct](https://wandb.ai/morg/credit_scorecard) avec les résultats du `WandbCallback` de XGBoost.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/26y6qBOOzah48_IG/images/integrations/xgb_dashboard.png?fit=max&auto=format&n=26y6qBOOzah48_IG&q=85&s=534568a9a4ea9538c6ca7454445a850d" alt="Tableau de bord W&B avec XGBoost" width="2756" height="1430" data-path="images/integrations/xgb_dashboard.png" />
</Frame>

<div id="get-started">
  ## Premiers pas
</div>

Pour enregistrer les métriques, les configurations et les modèles booster d’XGBoost dans W\&B, passez `WandbCallback` à XGBoost :

```python theme={null}
import wandb
from wandb.integration.xgboost import WandbCallback
from xgboost import XGBClassifier

...
# Démarrer un run wandb
with wandb.init() as run:
  # Passer WandbCallback au modèle
  bst = XGBClassifier()
  bst.fit(X_train, y_train, callbacks=[WandbCallback(log_model=True)])
```

Pour un aperçu complet de la journalisation avec XGBoost et W\&B, consultez le [notebook sur la journalisation avec XGBoost et W\&B](https://wandb.me/xgboost).

<div id="wandbcallback-reference">
  ## Référence de `WandbCallback`
</div>

<div id="functionality">
  ### Fonctionnalités
</div>

Passer `WandbCallback` à un modèle XGBoost entraîne les actions suivantes :

* Journalise la configuration du modèle booster dans W\&B.
* Journalise les métriques d’évaluation collectées par XGBoost, telles que `rmse`, la précision, etc., dans W\&B.
* Journalise les métriques d’entraînement collectées par XGBoost (si vous fournissez des données à `eval_set`).
* Journalise le meilleur score et la meilleure itération.
* Enregistre et téléverse votre modèle entraîné vers les artefacts W\&B (lorsque `log_model = True`).
* Journalise le graphique d’importance des variables lorsque `log_feature_importance=True` (par défaut).
* Capture la meilleure métrique d’évaluation dans `wandb.Run.summary` lorsque `define_metric=True` (par défaut).

<div id="arguments">
  ### Arguments
</div>

* `log_model` : (boolean) si True, enregistre et téléverse le modèle dans les artefacts W\&B.

* `log_feature_importance` : (boolean) si True, journalise un graphique à barres d’importance des variables.

* `importance_type` : (str) l’une des valeurs `{weight, gain, cover, total_gain, total_cover}` pour un modèle basé sur des arbres. `weight` pour un modèle linéaire.

* `define_metric` : (boolean) si True (par défaut), capture les performances du modèle à la meilleure étape de l’entraînement, plutôt qu’à la dernière étape, dans votre `run.summary`.

Consultez le [code source de WandbCallback](https://github.com/wandb/wandb/blob/main/wandb/integration/xgboost/xgboost.py).

Pour plus d’exemples, consultez le [dépôt d’exemples sur GitHub](https://github.com/wandb/examples/tree/master/examples/boosting-algorithms).

<div id="tune-your-hyperparameters-with-sweeps">
  ## Ajustez vos hyperparamètres avec Sweeps
</div>

W\&B [Sweeps](/fr/models/sweeps/) est une boîte à outils pour configurer, orchestrer et analyser des expériences de test d’hyperparamètres. Cette section montre comment combiner l’intégration XGBoost avec le balayage W\&B pour explorer différentes configurations d’hyperparamètres.

Pour améliorer les performances du modèle, ajustez des hyperparamètres comme la profondeur de l’arbre et le taux d’apprentissage.

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/boosting/Using_W%26B_Sweeps_with_XGBoost.ipynb" />

Vous pouvez aussi essayer ce [script Python XGBoost et Sweeps](https://github.com/wandb/examples/blob/master/examples/wandb-sweeps/sweeps-xgboost/xgboost_tune.py).

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-docs-2751/26y6qBOOzah48_IG/images/integrations/xgboost_sweeps_example.png?fit=max&auto=format&n=26y6qBOOzah48_IG&q=85&s=86dec64e2b9ee1b02f1da03e8beee7ab" alt="Comparaison des performances de XGBoost" width="1190" height="868" data-path="images/integrations/xgboost_sweeps_example.png" />
</Frame>
