tqdm

Mis à jour le 1 avril 2023

tqdm est une bibliothèque Python qui permet de créer des barres de progression pour les boucles. Il est conçu pour être facile à utiliser et à intégrer dans votre code Python existant. « tqdm » signifie « taqadum » en arabe, ce qui signifie « progresser » ou « avancer ».

Installation

La bibliothèque peut être installée via pip, le gestionnaire de packages de Python. Pour l’installer, ouvrez une invite de commande ou un terminal et entrez la commande suivante:

pip install tqdm

Utilisation de base

Pour utiliser tqdm, importez la bibliothèque et enveloppez votre boucle dans la fonction tqdm(). Voici un exemple de boucle for qui utilise tqdm pour afficher une barre de progression :

from tqdm import tqdm
import time
for i in tqdm(range(10)):
time.sleep(1)

Dans cet exemple, nous importons d’abord la bibliothèque tqdm et le module time. Nous créons ensuite une boucle for qui s’exécute 10 fois. A chaque itération de la boucle, nous appelons la fonction tqdm() avec la plage de valeurs à itérer, ici range(10), et affichons une barre de progression.

Options avancées

Il existe plusieurs options avancées que vous pouvez utiliser pour personnaliser votre barre de progression. Par exemple, vous pouvez définir une description pour la barre de progression, ajuster la largeur de la barre, modifier l’unité de mesure utilisée pour afficher les temps, et bien plus encore. Voici quelques exemples :

from tqdm import tqdm
import time
for i in tqdm(range(10), desc="Traitement en cours", bar_format="{l_bar}{bar:10}{r_bar}"):
time.sleep(1)

Dans cet exemple, nous avons défini une description pour notre barre de progression en utilisant l’option desc. Nous avons également ajusté la largeur de la barre en utilisant l’option bar_format.

from tqdm import tqdm
import time
for i in tqdm(range(10), desc="Traitement en cours", bar_format="{l_bar}{bar:10}{r_bar}", unit="sec", unit_scale=True, leave=True):
time.sleep(1)

Dans cet exemple, nous avons ajouté l’option unit pour spécifier l’unité de mesure à utiliser pour afficher les temps, et l’option unit_scale pour activer la mise à l’échelle automatique de l’unité. Nous avons également utilisé l’option leave pour que la barre de progression reste affichée après la fin de la boucle.

Pourquoi parler de tqdm sur un blog dédié à l’analytics?

tqdm peut être utile en analyse de données et en science des données. Lorsque vous travaillez avec des données volumineuses, des boucles itératives peuvent prendre beaucoup de temps pour s’exécuter. tqdm permet de visualiser la progression de ces boucles, ce qui facilite le suivi et l’optimisation du temps d’exécution.

En outre, dans les projets d’analyse de données, il est souvent nécessaire de préparer et de nettoyer les données, ce qui peut impliquer l’utilisation de boucles. tqdm peut aider à rendre ce processus plus efficace en permettant de visualiser rapidement la progression de la boucle et de s’assurer que le code fonctionne correctement.

Enfin, lors de l’analyse de données, il peut être utile de visualiser les résultats de manière interactive, et tqdm peut aider à créer des visualisations de progression en temps réel pour les tâches en cours.

Même si tqdm est un outil relativement simple, il peut aider les analystes de données à optimiser leur travail quotidien et à faciliter le suivi des boucles itératives dans leur travail.

Conclusion

tqdm est une bibliothèque pratique pour ajouter des barres de progression à vos boucles Python. Il est facile à utiliser et offre de nombreuses options pour personnaliser l’apparence et le comportement de la barre de progression.