> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/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 les performances 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>
    Try in 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 explique comment utiliser l’intégration W\&B avec XGBoost pour consigner automatiquement les métriques de gradient boosting, les configurations de modèle, l’importance des variables et les boosters entraînés, afin de suivre, de comparer et de reproduire vos expériences XGBoost.

Le SDK Python W\&B (`wandb`) fournit le callback `WandbCallback`, qui journalise les métriques, les configurations et les boosters enregistrés lors de l’entraînement avec XGBoost. Consultez un [tableau de bord W\&B en direct](https://wandb.ai/morg/credit_scorecard) qui présente les sorties du `WandbCallback` de XGBoost.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/xgb_dashboard.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=cc5d70f5f84ba45748f080471dabffc9" alt="Tableau de bord W&B avec XGBoost" width="2673" height="1345" data-path="products/wandb/_media/xgb_dashboard.png" />
</Frame>

<h2 id="get-started">
  Premiers pas
</h2>

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

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

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

Pour découvrir en détail la journalisation avec XGBoost et W\&B, consultez le [notebook sur la journalisation avec XGBoost et W\&B](https://wandb.me/xgboost).

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

<h3 id="functionality">
  Fonctionnalités
</h3>

Transmettre `WandbCallback` à un modèle XGBoost permet de :

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

<h3 id="arguments">
  Arguments
</h3>

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

* `log_feature_importance` : (booléen) si True, journalise un diagramme en barres de l’importance des variables.

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

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

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

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

<h2 id="tune-your-hyperparameters-with-sweeps">
  Ajuster vos hyperparamètres avec Sweeps
</h2>

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

Pour améliorer les performances du modèle, ajustez des hyperparamètres tels que la profondeur des arbres 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 également 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/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/xgboost_sweeps_example.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=a524e277faa6ec202fc33fe99ff57f64" alt="Comparaison des performances de XGBoost" width="1190" height="868" data-path="products/wandb/_media/xgboost_sweeps_example.png" />
</Frame>
