Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/app_ui/run-colors-default.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/images/app_ui/run-colors-key-based.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 19 additions & 5 deletions content/en/guides/models/track/runs/color-code-runs.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,32 @@ title: Semantic run plot legends

Create visually meaningful line plots and plot legends by color-coding your W&B runs based on metrics or configuration parameters. Identify patterns and trends across experiments by coloring runs according to their performance metrics (highest, lowest, or latest values). W&B automatically groups your runs into color-coded buckets based on the values of your selected parameter.

Navigate to your workspace's settings page to configure metric or configuration-based colors for runs:
To use metric or configuration-based colors for your runs, you need to configure two settings:

### Turn on key-based colors

1. Navigate to your W&B project.
2. Select the **Workspace** tab from the project sidebar.
3. Click on the **Settings** icon (⚙️) in the top right corner.
4. From the drawer, select **Runs** then select **Key-based colors**.
3. Click on the **Settings** icon in the top right corner.
4. From the drawer, select **Runs**.
5. In the **Run colors** section, select **Key-based colors**.
6. Configure the following options:
- From the **Key** dropdown, select the metric you want to use for assigning colors to runs.
- From the **Y value** dropdown, select the y value you want to use for assigning colors to runs.
- Set the the number of buckets to a value from 2 to 8.
- Set the number of buckets to a value from 2 to 8.

{{% alert %}}
When you use key-based colors, the option to [customize run colors]({{ relref "/guides/track/runs/run-colors.md" }}) is not available.
{{% /alert %}}

The following sections describe how to set the metric and y value and as how to customize the buckets used for assigning colors to runs.

### Example: Key-based coloring with loss metric

In this example plot, runs are colored with a gradient where darker colors represent higher loss values and lighter colors represent lower loss values. The Y value is set to `latest` to use the most recent loss value for each run.

{{< img src="/images/app_ui/run-colors-key-based.png" alt="W&B workspace showing runs colored based on their loss values using key-based coloring.">}}

## Set a metric

The metric options in your **Key** dropdown are derived from the key-value pairs [you log to W&B]({{< relref "guides/models/track/runs/color-code-runs/#custom-metrics" >}}) and [default metrics]({{< relref "guides/models/track/runs/color-code-runs/#default-metrics" >}}) defined by W&B.
Expand Down Expand Up @@ -109,4 +123,4 @@ Six buckets are defined for the metric, with each bucket representing a range of

In the line plot below, the run with the highest accuracy (0.8232) is colored in a deep purple (Bucket 5), while the run with the lowest accuracy (0.7684) is colored in a light orange (Bucket 2). The other runs are colored based on their accuracy values, with the color gradient indicating their relative performance.

{{< img src="/images/track/color-code-runs-plot.png" alt="Color coded runs plot" >}}
{{< img src="/images/track/color-code-runs-plot.png" alt="Color coded runs plot" >}}
56 changes: 47 additions & 9 deletions content/en/guides/models/track/runs/run-colors.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,47 @@ menu:
title: Customize run colors
---

W&B automatically assigns a color to each run that you create in your project. You can change the default color of a run to help you visually distinguish it from other runs in the table and graphs. Reset your project workspace to restore the default colors for all runs in the table.
W&B automatically assigns a color to each run that you create in your project. You can customize these colors to help you visually distinguish runs in tables and graphs. Run colors are locally scoped—on the project page, custom colors apply only to your own workspace. In reports, custom colors for runs apply only at the section level.

Run colors are locally scoped. On the project page, custom colors apply only to your own workspace. In reports, custom colors for runs apply only at the section level. You can visualize the same run in different sections, which can use different custom colors per section.
## Choose a color palette

## Edit default run colors
W&B provides several predefined color palettes to suit different needs and preferences. You can select a palette that works best for your team and use case.


1. Navigate to your W&B project.
2. Click on the **Workspace** tab from the project sidebar.
3. Click the **Settings** icon in the top right corner.
4. Select **Runs** from the settings drawer.
5. In the **Color palette** section, choose from the available options.

### Available color palettes

W&B offers three color palette options:

- **Default**: The standard W&B color palette with a vibrant range of colors
- **Colorblind-safe (deuteranomaly)**: Optimized for red-green color blindness, the most common form.
- **Colorblind-safe (all other forms)**: Optimized for protanopia, tritanopia, and other forms of color vision difference.

The colorblind-safe palettes use colors that remain distinguishable across different types of color vision difference, while maintaining visual appeal for users with typical color vision.

#### Default palette
In this example plot, runs are colored with the default palette, displaying a variety of vibrant colors for different runs.

{{< img src="/images/app_ui/run-colors-default.png" alt="W&B workspace showing runs colored with the default palette" >}}

#### Colorblind-safe (deuteranomaly) palette
In this example plot, runs are colored with the colorblind-safe palette optimized for deuteranomaly (red-green color blindness), using colors that remain distinguishable for affected users.

{{< img src="/images/app_ui/run-colors-colorblind-deuteranomaly.png" alt="W&B workspace showing runs colored with the colorblind-safe palette optimized for deuteranomaly (red-green color blindness)" >}}

#### Colorblind-safe (all other forms) palette
In this example plot, runs are colored with the colorblind-safe palette optimized for protanopia, tritanopia, and other forms of color vision difference.

{{< img src="/images/app_ui/run-colors-colorblind-other.png" alt="W&B workspace showing runs colored with the colorblind-safe palette optimized for protanopia, tritanopia, and other forms of color vision difference" >}}

## Edit individual run colors

To manually change the color of specific runs:

1. Click the **Runs** tab from the project sidebar.
2. Click the dot color next to the run name in the **Name** column.
Expand All @@ -27,19 +63,21 @@ To randomize the colors of all runs in the table:
2. Hover over the **Name** column header, click the three horizontal dots (**...**), and select **Randomize run colors** from the dropdown menu.

{{% alert %}}
The option to randomize run colors is available only after modify the run's table in some way, such as by sorting, filtering, searching, or grouping.
The option to randomize run colors is available only after modifying the run's table in some way, such as by sorting, filtering, searching, or grouping.
{{% /alert %}}

## Color options for grouped runs

## Reset run colors
When using the **Run colors** setting, you have two options:

<!-- {{% alert %}}
The option to randomize run colors is only available if there are at least two runs in the table or selector, and you have made some kind of modification to the view (sorting, filtering, searching, or grouping).
{{% /alert %}} -->
- **Original project colors**: Uses the default color assignment for runs.
- **Key-based colors**: Colors runs based on metric or configuration values (see [Semantic run plot legends]({{< relref "color-code-runs" >}}) for details).

## Reset run colors

To restore the default colors for all runs in the table:

1. Click the **Runs** tab from the project sidebar.
2. Hover over the **Name** column header, click the three horizontal dots (**...**), and select **Reset colors** from the dropdown menu.

{{< img src="/images/runs/reset-run-colors.png" alt="Reset run colors in project workspace">}}
{{< img src="/images/runs/reset-run-colors.png" alt="Reset run colors in project workspace">}}
Loading