Pythonで進行状況を美しく表示！tqdmの使い方を徹底解説

Pythonでプログラミングをしていると、処理が長時間かかる場合があります。そのような場合に、進捗状況を表示することで、プログラムの処理状況を把握できます。そこで、今回はPythonの進捗状況表示ライブラリである「tqdm」について解説します。

tqdmとは？

tqdmはPythonの進捗状況表示ライブラリです。主にforループなどの処理状況を表示するために使用されます。tqdmは以下のような特徴があります。

  • インストールが簡単
  • 進捗状況をプログレスバーで表示することができる
  • ループ処理の終了時間を予測し、表示することができる
  • 様々なオプションが用意されている

tqdmのインストール方法

tqdmのインストール方法は簡単です。以下のコマンドを実行してください。

!pip install tqdm

または、以下のコマンドを実行してください。

!conda install tqdm

tqdmの基本的な使い方

tqdmを使用するためには、以下のようにimportします。

from tqdm import tqdm

そして、forループなどの処理を以下のようにtqdmでラップします。

for i in tqdm(range(100)):
    # 処理

これで、forループの進捗状況が表示されます。

tqdmでループの進行状況を表示する方法

tqdmを使用すると、ループ処理の進行状況をプログレスバーで表示することができます。以下は、10回のループ処理をtqdmで表示する例です。

from tqdm import tqdm
for i in tqdm(range(10)):
    # 処理

実行結果は以下のようになります。

tqdmで複数のループの進行状況を表示する方法

tqdmを使用すると、複数のループ処理の進行状況をプログレスバーで表示することができます。以下は、2つのループ処理をtqdmで表示する例です。

from tqdm import tqdm
for i in tqdm(range(10)):
    # 処理
for j in tqdm(range(5)):
    # 処理

tqdmのオプションについて

tqdmには、様々なオプションが用意されています。以下は、代表的なオプションについて説明します。

  • desc：プログレスバーの前に表示されるテキストを指定できます。
  • ncols：プログレスバーの幅を指定できます。
  • leave：処理が終了した後、プログレスバーを表示するかどうかを指定できます。
  • position：プログレスバーの表示位置を指定できます。

以下は、descオプションを使用した例です。

from tqdm import tqdm
for i in tqdm(range(10), desc='ループ処理'):
    # 処理

まとめ

tqdmはPythonの進捗状況表示ライブラリであり、forループなどの処理状況を表示するために使用されます。tqdmを使用することで、処理状況を把握しやすくなります。tqdmの基本的な使い方やオプションについて解説しました。ぜひ、tqdmを活用して効率的なプログラミングを行いましょう！