View experiments results

A playground for exploring run data with interactive visualizations

W&B workspace is your personal sandbox to customize charts and explore model results. A W&B workspace consists of Tables and Panel sections:

  • Tables: All runs logged to your project are listed in the project’s table. Turn on and off runs, change colors, and expand the table to see notes, config, and summary metrics for each run.
  • Panel sections: A section that contains one or more panels. Create new panels, organize them, and export to reports to save snapshots of your workspace.

Workspace types

There are two main workspace categories: Personal workspaces and Saved views.

  • Personal workspaces: A customizable workspace for in-depth analysis of models and data visualizations. Only the owner of the workspace can edit and save changes. Teammates can view a personal workspace but teammates can not make changes to someone else’s personal workspace.
  • Saved views: Saved views are collaborative snapshots of a workspace. Anyone on your team can view, edit, and save changes to saved workspace views. Use saved workspace views for reviewing and discussing experiments, runs, and more.

The proceeding image shows multiple personal workspaces created by Cécile-parker’s teammates. In this project, there are no saved views:

Saved workspace views

Improve team collaboration with tailored workspace views. Create Saved Views to organize your preferred setup of charts and data.

Create a new saved workspace view

  1. Navigate to a personal workspace or a saved view.
  2. Make edits to the workspace.
  3. Click on the meatball menu (three horizontal dots) at the top right corner of your workspace. Click on Save as a new view.

New saved views appear in the workspace navigation menu.

Update a saved workspace view

Saved changes overwrite the previous state of the saved view. Unsaved changes are not retained. To update a saved workspace view in W&B:

  1. Navigate to a saved view.
  2. Make the desired changes to your charts and data within the workspace.
  3. Click the Save button to confirm your changes.

Delete a saved workspace view

Remove saved views that are no longer needed.

  1. Navigate to the saved view you want to remove.
  2. Select the three horizontal lines () at the top right of the view.
  3. Choose Delete view.
  4. Confirm the deletion to remove the view from your workspace menu.

Share a workspace view

Share your customized workspace with your team by sharing the workspace URL directly. All users with access to the workspace project can see the saved Views of that workspace.

Workspace templates

Use workspace templates to quickly create workspaces using the same settings as an existing workspace instead of the default settings for new workspaces. Currently, a workspace template can define custom line plot settings.

Default workspace settings

By default, new workspaces use these default settings for line plots:

Setting Default
X axis Step
Smoothing type Time weight EMA
Smoothing weight 0
Max runs 10
Grouping in charts on
Group aggregation Mean

Configure your workspace template

  1. Open any workspace or create a new one.
  2. Configure the workspace’s line plot settings according to your preferences.
  3. Save the settings to your workspace template:
    1. At the top of the workspace, click the action menu ... near the Undo and Redo arrow icons.
    2. Click Save personal workspace template.
    3. Review the line plot settings for the template, then click Save.

New workspaces will use these settings instead of the defaults.

Update your workspace template

Follow these steps to update your workspace template:

  1. Open any workspace.
  2. Modify the workspace’s line plot settings. For example, set the number of runs to include to 11.
  3. To save the changes to the template, click the action menu ... near the Undo and Redo arrow icons, then click Update personal workspace template.
  4. Verify the new line plot settings, then click Update. The template is updated, and reapplied to all workspaces that use it.

Programmatically creating workspaces

wandb-workspaces is a Python library for programmatically working with W&B workspaces and reports.

Define a workspace programmatically with wandb-workspaces. wandb-workspaces is a Python library for programmatically working with W&B workspaces and reports.

You can define the workspace’s properties, such as:

  • Set panel layouts, colors, and section orders.
  • Configure workspace settings like default x-axis, section order, and collapse states.
  • Add and customize panels within sections to organize workspace views.
  • Load and modify existing workspaces using a URL.
  • Save changes to existing workspaces or save as new views.
  • Filter, group, and sort runs programmatically using simple expressions.
  • Customize run appearance with settings like colors and visibility.
  • Copy views from one workspace to another for integration and reuse.

Install Workspace API

In addition to wandb, ensure that you install wandb-workspaces:

pip install wandb wandb-workspaces

Define and save a workspace view programmatically

import wandb_workspaces.reports.v2 as wr

workspace = ws.Workspace(entity="your-entity", project="your-project", views=[...])
workspace.save()

Edit an existing view

existing_workspace = ws.Workspace.from_url("workspace-url")
existing_workspace.views[0] = ws.View(name="my-new-view", sections=[...])
existing_workspace.save()

Copy a workspace saved view to another workspace

old_workspace = ws.Workspace.from_url("old-workspace-url")
old_workspace_view = old_workspace.views[0]
new_workspace = ws.Workspace(entity="new-entity", project="new-project", views=[old_workspace_view])

new_workspace.save()

See wandb-workspace examples for comprehensive workspace API examples. For an end to end tutorial, see Programmatic Workspaces tutorial.