Python：tqdm 库高级用法举例和应用详解

python库 › 数据处理
, , ,

Python tqdm库

模块介绍

tqdm 是一个用于显示进度条的 Python 库，适合于处理长循环或耗时任务时，让用户能够实时看到进度更新。该库广泛应用于数据处理、文件读取、机器学习训练等场景，同时支持 Python 3.5 及以上版本。

应用场景

tqdm 被广泛应用于需要监控进度的场景，如：

  1. 数据处理：在处理大规模数据时，例如数据清洗或数据分析，可以使用 tqdm 来显示处理进度。
  2. API 调用：在批量调用 API 时，使用 tqdm 可以实时查看请求的完成情况，避免用户等待的焦虑感。
  3. 模型训练：在机器学习的模型训练过程，往往会有较长的训练时间，添加 tqdm 进度条能够直观展示训练的进度。

安装说明

tqdm 并不是 Python 的内置库，因此需要通过 pip 进行安装。可以使用如下命令安装：

1
pip install tqdm

安装完成后，就可以在 Python 代码中导入 tqdm 模块进行使用。

用法举例

1. 基本使用

1
2
3
4
5
6
from tqdm import tqdm  # 导入tqdm模块

# 使用tqdm包装一个可迭代对象进行进度条显示
for i in tqdm(range(100)):  # 遍历0到99，显示进度条
    # 模拟某项耗时操作
    time.sleep(0.1)  # 暂停0.1秒以模拟耗时

在这个例子中，我们使用 tqdm 来显示一个简单的进度条，随着循环的进行，进度条逐渐填满。

2. 处理数据时的应用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import pandas as pd  # 导入pandas以处理数据
from tqdm import tqdm  # 导入tqdm模块
import time  # 导入time模块，用于模拟耗时任务

# 创建一个示例数据集
data = pd.DataFrame({'id': range(1000), 'value': range(1000)})

# 使用tqdm确保在Pandas的apply中显示进度条
tqdm.pandas()  # 启用pandas与tqdm的兼容性

# 使用progress_apply来显示应用过程的进度条
def process_value(x):
    time.sleep(0.01)  # 模拟处理时间
    return x * 2  # 返回处理结果

# 在DataFrame上应用process_value函数并显示进度条
data['processed'] = data['value'].progress_apply(process_value)  # 应用函数并显示进度

这个例子展示了如何在处理数据时结合 tqdm 和 pandas 库使用进度条，通过 progress_apply 可以轻松地在 apply 操作中显示进度。

3. 自定义进度条格式

1
2
3
4
5
6
from tqdm import tqdm  # 导入tqdm模块
import time  # 导入time模块

# 自定义进度条格式
for i in tqdm(range(100), desc="Processing", bar_format="{l_bar}{bar} [{elapsed}]", ncols=100):  
    time.sleep(0.1)  # 模拟任务耗时

这里我们使用了 tqdm 的 desc 参数来设置进度条的描述，并自定义了进度条的格式，展示了经过时间的格式化效果，增强了用户体验。

总之，tqdm 通过极其简便的方式，让各种耗时的操作都有了可视化过程，提升了程序的交互性和友好程度。

最后，我想强烈建议大家关注我的博客（全糖冲击博客）。在这里，我分享了所有 Python 标准库的使用教程，为您的学习和查询提供了极大的便利。每篇文章都附带详细的示例和注意事项，让您能更快地掌握每个模块的应用。同时，我们也建立了相互学习的环境，可以在评论区与我进行互动，提出问题或分享您的使用经验。感谢您的支持，在全糖冲击博客，我们一起进步，一起学习！