Skip to content
Open
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
4 changes: 3 additions & 1 deletion models/app/features/panels/line-plot/reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,8 +86,10 @@ Configure the chart type in the **Data** tab. Refer to [](/models/app/features/p
## Grouping settings
Aggregate all runs by turning on grouping, or group over an individual variable. When you turn on grouping in the runs table, the groups automatically populate into the graph.

- **Group by**: Select a column. All runs with the same value in that column are grouped together.
- **Group runs**: Turn on run grouping in the plot. Required to configure the shaded range in the plot, below.
- **Group by**: Optionally select a column. All runs with the same value in that column are grouped together.
- **Aggregation**: The value of the line on the graph. Options are mean, median, min, and max of the group.
- **Range**: Configure the shaded area of a full-fidelity line plot. Options are Min/Max, Std Dev, Std Err or None.

## Chart settings
Configure titles and legend visibility:
Expand Down
69 changes: 46 additions & 23 deletions models/app/features/panels/line-plot/sampling.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,40 +15,63 @@ There are three main advantages to using full fidelity mode for point aggregatio
* Configure how minimum and maximum points render: use the W&B App to interactively decide whether you want to show extreme (min/max) values as a shaded area.
* Explore your data without losing data fidelity: W&B recalculates x-axis bucket sizes when you zoom into specific data points. This helps ensure that you can explore your data without losing accuracy. Caching is used to store previously computed aggregations to help reduce loading times which is particularly useful if you are navigating through large datasets.

### Configure how minimum and maximum points render

Show or hide minimum and maximum values with shaded areas around your line plots.

The proceeding image shows a blue line plot. The light blue shaded area represents the minimum and maximum values for each bucket.

<Frame>
<img src="/images/app_ui/shaded-areas.png" alt="Shaded confidence areas" />
</Frame>

There are three ways to render minimum and maximum values in your line plots:

* **Never**: The min/max values are not displayed as a shaded area. Only show the aggregated line across the x-axis bucket.
* **On hover**: The shaded area for min/max values appears dynamically when you hover over the chart. This option keeps the view uncluttered while allowing you to inspect ranges interactively.
* **Always**: The min/max shaded area is consistently displayed for every bucket in the chart, helping you visualize the full range of values at all times. This can introduce visual noise if there are many runs visualized in the chart.

By default, the minimum and maximum values are not displayed as shaded areas. To view one of the shaded area options, follow these steps:
### Turn on full fidelity
W&B uses full fidelity mode by default. To configure it manually, follow these steps:

<Tabs>
<Tab title="All charts in a workspace">
1. Navigate to your W&B project
2. Select on the **Workspace** icon on the left tab
1. Navigate to your workspace.
3. Select the gear icon on the top right corner of the screen next to the left of the **Add panels** button.
4. From the UI slider that appears, select **Line plots**
5. Within the **Point aggregation** section, choose **On over** or **Always** from the **Show min/max values as a shaded area** dropdown menu.
5. Choose **Full fidelity** from the **Point aggregation** section.
6. Configure the **Smoothing** algorithm and settings.
7. Set **Aggregation** to **Mean**, **Min**, or **Max**.
8. Click **Apply**.
</Tab>
<Tab title="Individual chart in a workspace">
1. Navigate to your W&B project
1. Navigate to your workspace.
2. Select on the **Workspace** icon on the left tab
3. Select the line plot panel you want to enable full fidelity mode for
4. Within the modal that appears, select **On hover** or **Always** from the **Show min/max values as a shaded area** dropdown menu.
3. Hover over the line plot panel you want to configure, then click the gear icon.
4. Within the modal that appears, set **Point aggregation method** to **Full fidelity**.
5. Configure the **Smoothing** algorithm and settings.
6. Click **Apply**.
</Tab>
</Tabs>

### Configure shading

The shaded areas of a full-fidelity line plot can show:
- **Min/Max**: For each X-axis point, shade the area between the minimum and maximum values. The shaded area shows all points from the lowest to the highest value in each bucket:
$$
\text{Min/Max Range} = [\min(x_1, x_2, \ldots, x_n),\ \max(x_1, x_2, \ldots, x_n)]
$$
where $x_1, x_2, \ldots, x_n$ are the values in a given bucket.

- **Standard deviation**: For each X-axis point, calculate the variability of the values using standard deviation, and shade the resulting area.
$$
SD = \sqrt{\frac{1}{n}\sum_{i=1}^{n}(x_i - \overline{x})^2}
$$
- **Standard error**: For each X-axis point, calculate the likelihood of a sampling error by dividing the value by the square root of the sample size:
$$
SE = \frac{SD}{\sqrt{n}}
$$
- **None**: No shading (the default).

The proceeding image shows a blue line plot. The light blue shaded area represents the minimum and maximum values for each bucket.

<Frame>
<img src="/images/app_ui/shaded-areas.png" alt="Shaded confidence areas" />
</Frame>

To configure shading:

1. Navigate to your workspace.
2. Hover over a line plot, then click the gear icon.
3. In the **Data** tab, set **Point aggregation** to **Full fidelity** if necessary, then configure the smoothing algorithm.
4. In the **Grouping** tab, turn on **Group runs**. Optionally, set **Group by** to a run attribute.
5. Set **Agg** to **Mean** (default), **Min**, or **Max**.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does Mean, Min, or Max mean in this context? Similar comment applies to the next line (step 6)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now defined, PTAL!

6. Set **Range** to **Min/Max**, **Std Dev**, **Std Err**, or **None**.
7. Click **Apply**.

### Explore your data without losing data fidelity

Expand Down