La bibliothèque GoldenViz

Pourquoi cette bibliothèque existe

Dans ce chapitre, je présente la bibliothèque GoldenViz comme le prolongement pratique de ce livre.

Le livre pose les bases conceptuelles. La bibliothèque, elle, transforme ces idées en outils concrets, en vérifications réutilisables et en vrais flux de travail.

Vous pouvez consulter la documentation ici : documentation GoldenViz.

Installer la bibliothèque

GoldenViz est disponible comme package Python. Je vous conseille de l’installer avec pip dans un environnement virtuel propre à votre projet.

Installation depuis PyPI

pip install GoldenViz

Après l’installation, importez la bibliothèque avec la même casse :

import GoldenViz as gv

Vérifier l’installation

Vous pouvez exécuter ce petit exemple pour vérifier que GoldenViz inspecte bien une figure Matplotlib :

import matplotlib.pyplot as plt
import GoldenViz as gv

fig, ax = plt.subplots()
ax.plot([2021, 2022, 2023], [10, 13, 16])
ax.set_title("Revenue trend by year")
ax.set_xlabel("Year")
ax.set_ylabel("Revenue (M EUR)")

gv.check(fig)

Si l’installation fonctionne correctement, vous devriez obtenir un graphique simple comme celui-ci :

Vous devriez également obtenir un rapport HTML similaire à l’exemple ci-dessous :

Vous pouvez aussi l’ouvrir dans un nouvel onglet ici : exemple de rapport HTML GoldenViz.

Pour les utilisateurs de notebooks

GoldenViz fonctionne très bien dans les notebooks Jupyter et dans les notebooks VS Code. Pour une bonne expérience, assurez-vous que ipykernel est installé dans le même environnement :

pip install ipykernel

Ensuite, vous pouvez activer la vérification automatique des graphiques dans un notebook :

import GoldenViz as gv

gv.auto()