评价此页
★ ★ ★ ★ ★
beginner/basics/data_tutorial

注意

跳转到结尾 以下载完整的示例代码。

学习基础知识 || 快速入门 || 张量 || 数据集与数据加载器 || 变换 || 构建模型 || 自动梯度 || 优化 || 保存与加载模型

数据集与数据加载器#

创建于：2021 年 2 月 9 日 | 最后更新：2025 年 9 月 24 日 | 最后验证：2024 年 11 月 5 日

处理数据样本的代码可能会变得混乱且难以维护；我们理想情况下希望我们的数据集代码与我们的模型训练代码分离，以提高可读性和模块化。PyTorch 提供了两种数据原语：torch.utils.data.DataLoader 和 torch.utils.data.Dataset，它们允许您使用预加载的数据集以及您自己的数据。Dataset 存储样本及其对应的标签，而 DataLoader 在 Dataset 周围包装一个可迭代对象，以便轻松访问样本。

PyTorch 领域库提供许多预加载的数据集（例如 FashionMNIST），这些数据集继承自 torch.utils.data.Dataset 并实现特定于特定数据的函数。您可以使用它们来原型设计和基准测试您的模型。您可以在这里找到它们：图像数据集、文本数据集和 音频数据集

加载数据集#

以下是如何从 TorchVision 加载 Fashion-MNIST 数据集的示例。Fashion-MNIST 是 Zalando 的文章图像数据集，包含 60,000 个训练示例和 10,000 个测试示例。每个示例包含一个 28×28 灰度图像和一个与 10 个类别之一相关的标签。

我们使用以下参数加载 FashionMNIST 数据集

  • root 是存储训练/测试数据的路径，

  • train 指定训练或测试数据集，

  • download=True 如果在 root 中不可用，则从互联网下载数据。

  • transform 和 target_transform 指定特征和标签转换

import torch
from torch.utils.data import Dataset
from torchvision import datasets
from torchvision.transforms import ToTensor
import matplotlib.pyplot as plt


training_data = datasets.FashionMNIST(
    root="data",
    train=True,
    download=True,
    transform=ToTensor()
)

test_data = datasets.FashionMNIST(
    root="data",
    train=False,
    download=True,
    transform=ToTensor()
)

  0%|          | 0.00/26.4M [00:00<?, ?B/s]
  0%|          | 65.5k/26.4M [00:00<01:13, 360kB/s]
  1%|          | 229k/26.4M [00:00<00:38, 677kB/s]
  3%|▎         | 918k/26.4M [00:00<00:12, 2.09MB/s]
 14%|█▍        | 3.67M/26.4M [00:00<00:03, 7.22MB/s]
 37%|███▋      | 9.67M/26.4M [00:00<00:01, 16.4MB/s]
 59%|█████▉    | 15.5M/26.4M [00:01<00:00, 21.7MB/s]
 82%|████████▏ | 21.7M/26.4M [00:01<00:00, 25.6MB/s]
 95%|█████████▌| 25.2M/26.4M [00:01<00:00, 23.4MB/s]
100%|██████████| 26.4M/26.4M [00:01<00:00, 18.0MB/s]

  0%|          | 0.00/29.5k [00:00<?, ?B/s]
100%|██████████| 29.5k/29.5k [00:00<00:00, 325kB/s]

  0%|          | 0.00/4.42M [00:00<?, ?B/s]
  1%|▏         | 65.5k/4.42M [00:00<00:12, 358kB/s]
  5%|▌         | 229k/4.42M [00:00<00:06, 672kB/s]
 21%|██        | 918k/4.42M [00:00<00:01, 2.08MB/s]
 83%|████████▎ | 3.67M/4.42M [00:00<00:00, 7.19MB/s]
100%|██████████| 4.42M/4.42M [00:00<00:00, 6.01MB/s]

  0%|          | 0.00/5.15k [00:00<?, ?B/s]
100%|██████████| 5.15k/5.15k [00:00<00:00, 59.6MB/s]

迭代和可视化数据集#

我们可以像列表一样手动索引 Datasets：training_data[index]。我们使用 matplotlib 可视化训练数据中的一些样本。

labels_map = {
    0: "T-Shirt",
    1: "Trouser",
    2: "Pullover",
    3: "Dress",
    4: "Coat",
    5: "Sandal",
    6: "Shirt",
    7: "Sneaker",
    8: "Bag",
    9: "Ankle Boot",
}
figure = plt.figure(figsize=(8, 8))
cols, rows = 3, 3
for i in range(1, cols * rows + 1):
    sample_idx = torch.randint(len(training_data), size=(1,)).item()
    img, label = training_data[sample_idx]
    figure.add_subplot(rows, cols, i)
    plt.title(labels_map[label])
    plt.axis("off")
    plt.imshow(img.squeeze(), cmap="gray")
plt.show()
Trouser, Sneaker, Pullover, Shirt, Sandal, Sandal, Dress, T-Shirt, Coat

为您的文件创建自定义数据集#

自定义 Dataset 类必须实现三个函数：__init__、__len__ 和 __getitem__。请查看此实现；FashionMNIST 图像存储在目录 img_dir 中，它们的标签分别存储在 CSV 文件 annotations_file 中。

在下一节中，我们将分解这些函数中发生的事情。

import os
import pandas as pd
from torchvision.io import decode_image

class CustomImageDataset(Dataset):
    def __init__(self, annotations_file, img_dir, transform=None, target_transform=None):
        self.img_labels = pd.read_csv(annotations_file)
        self.img_dir = img_dir
        self.transform = transform
        self.target_transform = target_transform

    def __len__(self):
        return len(self.img_labels)

    def __getitem__(self, idx):
        img_path = os.path.join(self.img_dir, self.img_labels.iloc[idx, 0])
        image = decode_image(img_path)
        label = self.img_labels.iloc[idx, 1]
        if self.transform:
            image = self.transform(image)
        if self.target_transform:
            label = self.target_transform(label)
        return image, label

__init__#

__init__ 函数在实例化 Dataset 对象时运行一次。我们初始化包含图像的目录、注释文件以及两个转换（在下一节中详细介绍）。

labels.csv 文件如下所示

tshirt1.jpg, 0
tshirt2.jpg, 0
......
ankleboot999.jpg, 9

def __init__(self, annotations_file, img_dir, transform=None, target_transform=None):
    self.img_labels = pd.read_csv(annotations_file)
    self.img_dir = img_dir
    self.transform = transform
    self.target_transform = target_transform

__len__#

__len__ 函数返回我们数据集中样本的数量。

示例

def __len__(self):
    return len(self.img_labels)

__getitem__#

__getitem__ 函数加载并返回给定索引 idx 处的数据集中的样本。根据索引，它识别磁盘上图像的位置，使用 decode_image 将其转换为张量，从 self.img_labels 中的 csv 数据中检索相应的标签，调用转换函数（如果适用），并在元组中返回张量图像和相应的标签。

def __getitem__(self, idx):
    img_path = os.path.join(self.img_dir, self.img_labels.iloc[idx, 0])
    image = decode_image(img_path)
    label = self.img_labels.iloc[idx, 1]
    if self.transform:
        image = self.transform(image)
    if self.target_transform:
        label = self.target_transform(label)
    return image, label

使用 DataLoaders 为训练准备数据#

Dataset 每次检索我们数据集的特征和标签。在训练模型时，我们通常希望以“小批量”传递样本，在每个 epoch 中重新洗牌数据以减少模型过拟合，并使用 Python 的 multiprocessing 来加速数据检索。

DataLoader 是一个可迭代对象，它以易于使用的 API 为我们抽象了这种复杂性。

from torch.utils.data import DataLoader

train_dataloader = DataLoader(training_data, batch_size=64, shuffle=True)
test_dataloader = DataLoader(test_data, batch_size=64, shuffle=True)

迭代 DataLoader#

我们已将该数据集加载到 DataLoader 中，可以根据需要迭代该数据集。以下每次迭代都会返回一批 train_features 和 train_labels（分别包含 batch_size=64 个特征和标签）。由于我们指定了 shuffle=True，因此在迭代所有批次之后，数据会被洗牌（有关数据加载顺序的更精细控制，请参阅 Samplers）。

# Display image and label.
train_features, train_labels = next(iter(train_dataloader))
print(f"Feature batch shape: {train_features.size()}")
print(f"Labels batch shape: {train_labels.size()}")
img = train_features[0].squeeze()
label = train_labels[0]
plt.imshow(img, cmap="gray")
plt.show()
print(f"Label: {label}")
data tutorial
Feature batch shape: torch.Size([64, 1, 28, 28])
Labels batch shape: torch.Size([64])
Label: 5

进一步阅读#

脚本总运行时间：（0 分钟 5.086 秒）

在此页面上
PyTorch 库