iterative/vscode-dvc

# Plots Dashboard

Select (click the circle beside the experiment name) up to 7 experiments in the
table view to visualize in the [**Plots Dashboard**](command:dvc.showPlots).

<p align="center">
  <img src="images/click-the-circle-beside-experiment-name.png"
       alt="Select for Plots" />
</p>

Use
[`DVC: Show Plots`](command:workbench.action.quickOpen?%22>DVC:%20Show%20Plots%22)
from the command palette to open it or open it using the table's row context
menu.

[`dvc plots show`]: https://dvc.org/doc/command-reference/plots/show
[`dvc plots diff`]: https://dvc.org/doc/command-reference/plots/diff

💡 To add [DVC plots] to the project, start writing data series into JSON, YAML,
CSV, or TSV files; or save your own plot images (`.png`, etc.). Use
[`DVC: Add Plot`](command:workbench.action.quickOpen?%22>DVC:%20Add%20Plot%22)
to define plots in a `dvc.yaml` file. If you're using Python, the [DVCLive]
helper library can save plots data for you!

```python
points = metrics.precision_recall_curve(labels, predictions)
with open("plots.json", "w") as fd:
     json.dump({"prc": [
          {"precision": p, "recall": r, "threshold": t}
               for p, r, t in points
     ]})
```

```python
from matplotlib import pyplot as plt
fig, axes = plt.subplots(dpi=100)
...
fig.savefig("importance.png")
```

```python
from dvclive import Live
live = Live("evaluation")
live.log_plot("roc", labels, predictions)
```

[dvc plots]: https://dvc.org/doc/start/experiments/visualization
[dvclive]: https://dvc.org/doc/dvclive

These are the types of plots that can be displayed (for the selected
experiments):

<p align="center">
  <img src="images/plots-data-series.png"
       alt="Plots: Data Series" />
</p>

**Data Series** are JSON, YAML, CSV, or TSV files visualized using [plot
templates], which may be predefined (e.g. confusion matrix, linear) or custom
([Vega-lite] files)

[plot templates]:
  https://dvc.org/doc/user-guide/experiment-management/visualizing-plots#plot-templates-data-series-only
[vega-lite]: https://vega.github.io/vega-lite/

<p align="center">
  <img src="images/plots-images.png"
       alt="Plots: Images" />
</p>

**Images** (e.g. `.jpg` or `.svg` files) can be visualized as well. They will be
rendered side by side for the selected experiments.

<p align="center">
  <img src="images/plots-custom.png"
       alt="Plots: Custom" />
</p>

**Custom** plots compare a chosen [metric] and [param] across experiments.

[metric]: https://dvc.org/doc/command-reference/metrics
[param]: https://dvc.org/doc/command-reference/params

<p align="center">
  <img src="images/plots-view-icon.png"
       alt="Plots View Icon" />
</p>

The **Plots Dashboard** can be configured and accessed from the _Plots_ side
panel in the [**DVC View**](command:views.dvc-views).

> This is equivalent to the [`dvc plots show`] and [`dvc plots diff`] commands.