Tutorial: Log tables, visualize, and query data

Explore how to use W&B Tables with this 5-minute Quickstart.

This Quickstart walks you through logging data tables to W&B, visualizing them in your project workspace, and comparing results across runs. By the end, you have a logged table that you can explore and compare in the W&B App.

Select the button below to try a PyTorch Quickstart example project on MNIST data.

Log a table

In this step, you create a table and log it to W&B so that it’s available for visualization later in the walkthrough. You can either construct a new table or pass a Pandas DataFrame.

Construct a table

To construct and log a new table, use the following:

• wandb.init(): Create a run to track results.
• wandb.Table(): Create a new table object.
  • columns: Set the column names.
  • data: Set the contents of each row.
• wandb.Run.log(): Log the table to save it to W&B.

Here’s an example:

import wandb

with wandb.init(project="table-test") as run:
    # Create and log a new table.
    my_table = wandb.Table(columns=["a", "b"], data=[["a1", "b1"], ["a2", "b2"]])
    run.log({"Table Name": my_table})

Pandas DataFrame

Pass a Pandas DataFrame to wandb.Table() to create a new table.

import wandb
import pandas as pd

df = pd.read_csv("my_data.csv")

with wandb.init(project="df-table") as run:
    # Create a new table from the DataFrame
    # and log it to W&B.
  my_table = wandb.Table(dataframe=df)
  run.log({"Table Name": my_table})

For more information on supported data types, see the wandb.Table in the W&B API Reference Guide.

Visualize tables in your project workspace

After logging a table, you can view it in the W&B App to confirm W&B recorded it correctly and to explore its contents.

1. Navigate to your project in the W&B App.
2. Select the name of your run in your project workspace. W&B adds a new panel for each unique table key.

In this example, my_table is logged under the key "Table Name".

Compare across model versions

After you have logged tables from more than one run, you can use the project workspace to compare results side by side and evaluate how model versions differ.

Log sample tables from multiple W&B Runs and compare results in the project workspace. This example workspace shows how to combine rows from multiple different versions in the same table.

Use the table filter, sort, and grouping features to explore and evaluate model results.