評價此頁
★ ★ ★ ★ ★
intermediate/tensorboard_tutorial

使用 TensorBoard 視覺化模型、資料和訓練#

建立日期：2019 年 8 月 8 日 | 最後更新：2025 年 9 月 10 日 | 最後驗證：2024 年 11 月 5 日

在 60 分鐘快速教程 中，我們向您展示瞭如何載入資料，將其輸入到我們定義為 nn.Module 子類的模型中，在訓練資料上訓練此模型，並在測試資料上對其進行測試。為了檢視正在發生的情況，我們在模型訓練時打印出一些統計資訊，以瞭解訓練是否在進展。但是，我們可以做得更好：PyTorch 與 TensorBoard 整合，TensorBoard 是一個用於視覺化神經網路訓練執行結果的工具。本教程將演示其部分功能，使用 Fashion-MNIST 資料集，該資料集可以使用 torchvision.datasets 載入到 PyTorch 中。

在本教程中，我們將學習如何

  1. 讀取資料並進行適當的轉換（與之前的教程幾乎相同）。

  2. 設定 TensorBoard。

  3. 寫入 TensorBoard。

  4. 使用 TensorBoard 檢查模型架構。

  5. 使用 TensorBoard 以更少的程式碼建立上一個教程中建立的視覺化的互動式版本

具體來說，在第 5 點，我們將看到

  • 幾種檢查訓練資料的方法

  • 如何跟蹤模型的訓練過程中的效能

  • 如何評估模型訓練完成後的效能。

我們將從與 CIFAR-10 教程 相似的樣板程式碼開始

# imports
import matplotlib.pyplot as plt
import numpy as np

import torch
import torchvision
import torchvision.transforms as transforms

import torch.nn as nn
import torch.nn.functional as F
import torch.optim as optim

# transforms
transform = transforms.Compose(
    [transforms.ToTensor(),
    transforms.Normalize((0.5,), (0.5,))])

# datasets
trainset = torchvision.datasets.FashionMNIST('./data',
    download=True,
    train=True,
    transform=transform)
testset = torchvision.datasets.FashionMNIST('./data',
    download=True,
    train=False,
    transform=transform)

# dataloaders
trainloader = torch.utils.data.DataLoader(trainset, batch_size=4, shuffle=True)

testloader = torch.utils.data.DataLoader(testset, batch_size=4, shuffle=False)

# constant for classes
classes = ('T-shirt/top', 'Trouser', 'Pullover', 'Dress', 'Coat',
        'Sandal', 'Shirt', 'Sneaker', 'Bag', 'Ankle Boot')

# helper function to show an image
# (used in the `plot_classes_preds` function below)
def matplotlib_imshow(img, one_channel=False):
    if one_channel:
        img = img.mean(dim=0)
    img = img / 2 + 0.5     # unnormalize
    npimg = img.numpy()
    if one_channel:
        plt.imshow(npimg, cmap="Greys")
    else:
        plt.imshow(np.transpose(npimg, (1, 2, 0)))

我們將定義一個與該教程類似的相似模型架構，僅進行少量修改，以適應影像現在是一個通道而非三個通道，以及 28x28 而非 32x32 的事實

class Net(nn.Module):
    def __init__(self):
        super(Net, self).__init__()
        self.conv1 = nn.Conv2d(1, 6, 5)
        self.pool = nn.MaxPool2d(2, 2)
        self.conv2 = nn.Conv2d(6, 16, 5)
        self.fc1 = nn.Linear(16 * 4 * 4, 120)
        self.fc2 = nn.Linear(120, 84)
        self.fc3 = nn.Linear(84, 10)

    def forward(self, x):
        x = self.pool(F.relu(self.conv1(x)))
        x = self.pool(F.relu(self.conv2(x)))
        x = x.view(-1, 16 * 4 * 4)
        x = F.relu(self.fc1(x))
        x = F.relu(self.fc2(x))
        x = self.fc3(x)
        return x


net = Net()

我們將定義之前相同的 optimizer 和 criterion

criterion = nn.CrossEntropyLoss()
optimizer = optim.SGD(net.parameters(), lr=0.001, momentum=0.9)

1. TensorBoard 設定#

現在我們將設定 TensorBoard，從 torch.utils 匯入 tensorboard，並定義一個 SummaryWriter，這是我們向 TensorBoard 寫入資訊的主要物件。

from torch.utils.tensorboard import SummaryWriter

# default `log_dir` is "runs" - we'll be more specific here
writer = SummaryWriter('runs/fashion_mnist_experiment_1')

請注意，僅這一行就會建立一個 runs/fashion_mnist_experiment_1 資料夾。

2. 寫入 TensorBoard#

現在讓我們使用 make_grid 將一個影像寫入我們的 TensorBoard - 特別是一個網格。

# get some random training images
dataiter = iter(trainloader)
images, labels = next(dataiter)

# create grid of images
img_grid = torchvision.utils.make_grid(images)

# show images
matplotlib_imshow(img_grid, one_channel=True)

# write to tensorboard
writer.add_image('four_fashion_mnist_images', img_grid)

現在從命令列執行

PYTHONWARNINGS="ignore:pkg_resources is deprecated as an API:UserWarning" tensorboard --logdir=runs

然後導航到 https://:6006 應該會顯示以下內容。

../_static/img/tensorboard_first_view.png

現在您知道如何使用 TensorBoard 了！但是，這個例子可以在 Jupyter Notebook 中完成 — TensorBoard 真正擅長的是建立互動式視覺化。我們將在下一個教程中介紹其中一個，並在本教程結束時介紹更多。

3. 使用 TensorBoard 檢查模型#

TensorBoard 的優勢之一是其視覺化複雜模型結構的能力。讓我們視覺化我們構建的模型。

writer.add_graph(net, images)
writer.close()

現在重新整理 TensorBoard 後，您應該會看到一個“Graphs”選項卡，看起來像這樣

../_static/img/tensorboard_model_viz.png

請雙擊“Net”以檢視其展開，看到構成模型的各個操作的詳細檢視。

TensorBoard 有一個非常有用的功能，可以視覺化高維資料，如影像資料在低維空間中的表示；我們將在下一節介紹。

4. 為 TensorBoard 新增“Projector”#

我們可以透過 add_embedding 方法視覺化高維資料的低維表示

# helper function
def select_n_random(data, labels, n=100):
    '''
    Selects n random datapoints and their corresponding labels from a dataset
    '''
    assert len(data) == len(labels)

    perm = torch.randperm(len(data))
    return data[perm][:n], labels[perm][:n]

# select random images and their target indices
images, labels = select_n_random(trainset.data, trainset.targets)

# get the class labels for each image
class_labels = [classes[lab] for lab in labels]

# log embeddings
features = images.view(-1, 28 * 28)
writer.add_embedding(features,
                    metadata=class_labels,
                    label_img=images.unsqueeze(1))
writer.close()

現在在 TensorBoard 的“Projector”選項卡中，您可以看到這 100 張影像 — 每張影像都有 784 維 — 被投影到三維空間中。此外，這是互動式的：您可以單擊並拖動以旋轉三維投影。最後，有幾個技巧可以使視覺化更容易檢視：選擇左上角的“color: label”，以及啟用“night mode”，這將使影像更容易看到，因為它們的背景是白色的

../_static/img/tensorboard_projector.png

現在我們已經仔細檢查了我們的資料，讓我們展示 TensorBoard 如何使跟蹤模型訓練和評估更加清晰，從訓練開始。

5. 使用 TensorBoard 跟蹤模型訓練#

在之前的示例中，我們只是每 2000 次迭代 *列印* 模型的執行損失。現在，我們將把執行損失記錄到 TensorBoard，並透過 plot_classes_preds 函式提供模型預測的檢視。

# helper functions

def images_to_probs(net, images):
    '''
    Generates predictions and corresponding probabilities from a trained
    network and a list of images
    '''
    output = net(images)
    # convert output probabilities to predicted class
    _, preds_tensor = torch.max(output, 1)
    preds = np.squeeze(preds_tensor.numpy())
    return preds, [F.softmax(el, dim=0)[i].item() for i, el in zip(preds, output)]


def plot_classes_preds(net, images, labels):
    '''
    Generates matplotlib Figure using a trained network, along with images
    and labels from a batch, that shows the network's top prediction along
    with its probability, alongside the actual label, coloring this
    information based on whether the prediction was correct or not.
    Uses the "images_to_probs" function.
    '''
    preds, probs = images_to_probs(net, images)
    # plot the images in the batch, along with predicted and true labels
    fig = plt.figure(figsize=(12, 48))
    for idx in np.arange(4):
        ax = fig.add_subplot(1, 4, idx+1, xticks=[], yticks=[])
        matplotlib_imshow(images[idx], one_channel=True)
        ax.set_title("{0}, {1:.1f}%\n(label: {2})".format(
            classes[preds[idx]],
            probs[idx] * 100.0,
            classes[labels[idx]]),
                    color=("green" if preds[idx]==labels[idx].item() else "red"))
    return fig

最後，讓我們使用與先前教程相同的模型訓練程式碼來訓練模型，但每 1000 個批次將結果寫入 TensorBoard，而不是列印到控制檯；這是透過 add_scalar 函式實現的。

此外，在訓練過程中，我們將生成一張影像，顯示模型在批次中包含的四張影像上的預測與實際結果。

running_loss = 0.0
for epoch in range(1):  # loop over the dataset multiple times

    for i, data in enumerate(trainloader, 0):

        # get the inputs; data is a list of [inputs, labels]
        inputs, labels = data

        # zero the parameter gradients
        optimizer.zero_grad()

        # forward + backward + optimize
        outputs = net(inputs)
        loss = criterion(outputs, labels)
        loss.backward()
        optimizer.step()

        running_loss += loss.item()
        if i % 1000 == 999:    # every 1000 mini-batches...

            # ...log the running loss
            writer.add_scalar('training loss',
                            running_loss / 1000,
                            epoch * len(trainloader) + i)

            # ...log a Matplotlib Figure showing the model's predictions on a
            # random mini-batch
            writer.add_figure('predictions vs. actuals',
                            plot_classes_preds(net, inputs, labels),
                            global_step=epoch * len(trainloader) + i)
            running_loss = 0.0
print('Finished Training')

您現在可以檢視 scalars 選項卡，檢視在 15,000 次訓練迭代中繪製的執行損失圖

../_static/img/tensorboard_scalar_runs.png

此外，我們可以檢視模型在學習過程中對任意批次的預測。檢視“Images”選項卡，並在“predictions vs. actuals”視覺化下方滾動，可以看到這一點；這表明，例如，在僅 3000 次訓練迭代後，模型已經能夠區分視覺上不同的類，如襯衫、運動鞋和外套，儘管它不像在訓練後期那樣自信

../_static/img/tensorboard_images.png

在先前的教程中，我們查看了模型訓練完成後的每個類別的準確率；在這裡，我們將使用 TensorBoard 為每個類繪製精確率-召回率曲線（在此處有很好的解釋 here）。

6. 評估訓練好的模型#

# 1. gets the probability predictions in a test_size x num_classes Tensor
# 2. gets the preds in a test_size Tensor
# takes ~10 seconds to run
class_probs = []
class_label = []
with torch.no_grad():
    for data in testloader:
        images, labels = data
        output = net(images)
        class_probs_batch = [F.softmax(el, dim=0) for el in output]

        class_probs.append(class_probs_batch)
        class_label.append(labels)

test_probs = torch.cat([torch.stack(batch) for batch in class_probs])
test_label = torch.cat(class_label)

# helper function
def add_pr_curve_tensorboard(class_index, test_probs, test_label, global_step=0):
    '''
    Takes in a "class_index" from 0 to 9 and plots the corresponding
    precision-recall curve
    '''
    tensorboard_truth = test_label == class_index
    tensorboard_probs = test_probs[:, class_index]

    writer.add_pr_curve(classes[class_index],
                        tensorboard_truth,
                        tensorboard_probs,
                        global_step=global_step)
    writer.close()

# plot all the pr curves
for i in range(len(classes)):
    add_pr_curve_tensorboard(i, test_probs, test_label)

您現在將看到一個包含每個類別的精確率-召回率曲線的“PR Curves”選項卡。請隨意探索；您會發現，在某些類別上，模型的“曲線下面積”接近 100%，而在其他類別上，這個面積較低

../_static/img/tensorboard_pr_curves.png

這就是 TensorBoard 和 PyTorch 與其整合的入門介紹。當然，您可以在 Jupyter Notebook 中完成 TensorBoard 的所有功能，但有了 TensorBoard，您將獲得預設的互動式視覺化。

在此頁面上
PyTorch 庫