Dvclive

What's Changed
* mypy: remove --install-types by daavoo in https://github.com/iterative/dvclive/pull/567
* use markdown for notebook reports by dberenbaum in https://github.com/iterative/dvclive/pull/558
* read studio token from dvc config by dberenbaum in https://github.com/iterative/dvclive/pull/561
* fix(make_dvcyaml): make it idempotent for artifacts by shcheklein in https://github.com/iterative/dvclive/pull/573


**Full Changelog**: https://github.com/iterative/dvclive/compare/2.9.0...2.9.1

What's Changed
* fix(log_artifact): don't follow symlink on dumping dvc.yaml by shcheklein in https://github.com/iterative/dvclive/pull/564
* feat(log_artifact): add an option to copy (capture) into dvclive dir by shcheklein in https://github.com/iterative/dvclive/pull/559
* studio: send images. by daavoo in https://github.com/iterative/dvclive/pull/525


**Full Changelog**: https://github.com/iterative/dvclive/compare/2.8.1...2.9.0

What's Changed
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/iterative/dvclive/pull/554
* allow for custom image subclasses by dberenbaum in https://github.com/iterative/dvclive/pull/553
* live: Catch errors in `_ensure_paths_are_tracked_in_dvc_exp`. by daavoo in https://github.com/iterative/dvclive/pull/555


**Full Changelog**: https://github.com/iterative/dvclive/compare/2.8.0...2.8.1

New Features

Live.log_plot

Create DVC plots from datapoints (list of dictionaries) and plot config.


py
datapoints = [{"foo": 1, "bar": 2}, {"foo": 3, "bar": 4}]
with Live() as live:
live.log_plot("foo_default", datapoints, x="foo", y="bar", title="Default Linear Plot")
live.log_plot(
"foo_scatter",
datapoints,
x="foo",
y="bar",
template="scatter",
title="Plot using Scatter template",
y_label="CUSTOM LABEL: BAR",
x_label="CUSTOM LABEL: FOO"
)


Example output:

- `dvclive/plots/custom/foo_default.json`

json
[
{
"foo": 1,
"bar": 2
},
{
"foo": 3,
"bar": 4
}
]


- `dvclive/dvc.yaml`

yaml
plots:
- plots/custom/foo_default.json:
x: foo
y: bar
title: Default Linear Plot
- plots/custom/foo_scatter.json:
template: scatter
x: foo
y: bar
title: Plot using Scatter template
x_label: 'CUSTOM LABEL: FOO'
y_label: 'CUSTOM LABEL: BAR'


- `dvc plots show`

<img width="956" alt="Captura de pantalla 2023-04-26 a las 20 16 51" src="https://user-images.githubusercontent.com/12677733/234666832-322cb625-1cdc-4df8-9be1-bf15c7c9470b.png">

Custom plot properties for `Live.log_sklearn_plot`

py
from dvclive import Live

y_true = [0, 0, 1, 1]

New Features

`artifacts` section

You can now pass metadata to [`Live.log_artifact` ](https://dvc.org/doc/dvclive/live/log_artifact) that will be written to a new `artifacts` section in the [`dvc.yaml`](https://dvc.org/doc/user-guide/project-structure/dvcyaml-files) located at `{Live.dir}/{Live.dvc_file}`.

Available metadata fields are:

py
type: Optional[str] = None,
name: Optional[str] = None,
desc: Optional[str] = None,
labels: Optional[List[str]] = None,
meta: Optional[Dict[str, Any]] = None,


When passing `type="model"`, the artifact will be identified by [Studio](https://studio.iterative.ai/) and automatically included in the [Studio Model Registry](https://dvc.org/doc/studio/user-guide/model-registry/).

- Example

py
from pathlib import Path
from dvclive import Live

Path("model.pth").write_text("foo")

with Live(save_dvc_exp=True) as live:
live.log_artifact(
"model.pth",
type="model",
name="mymodel",
desc="Finetuned ResNet50",
)

yaml
dvclive/dvc.yaml
artifacts:
mymodel:
path: ../model.pth
type: model
desc: Finetuned ResNet50


Auto-initialization of DVC Repo

When inside a non-empty Git Repository, DVCLive will auto-initialize a DVC Repository when needed.

What's Changed
* Add DVCLive-Quickstart by daavoo in https://github.com/iterative/dvclive/pull/530
* studio: Support `DVC_` env vars. by daavoo in https://github.com/iterative/dvclive/pull/533
* Support `artifacts` section by daavoo in https://github.com/iterative/dvclive/pull/521
* feat(sklplots): add confusion matrix normalized option by shcheklein in https://github.com/iterative/dvclive/pull/538
* revert get_dvc_stage_template by dberenbaum in https://github.com/iterative/dvclive/pull/540
* Auto-initialize DVC repo by dberenbaum in https://github.com/iterative/dvclive/pull/539

New Contributors
* dependabot made their first contribution in https://github.com/iterative/dvclive/pull/503

**Full Changelog**: https://github.com/iterative/dvclive/compare/2.6.4...2.7.0

What's Changed
* Maintenance by daavoo in https://github.com/iterative/dvclive/pull/527
* Update README by daavoo in https://github.com/iterative/dvclive/pull/528
* studio: Save experiment before posting `done` event. by daavoo in https://github.com/iterative/dvclive/pull/529


**Full Changelog**: https://github.com/iterative/dvclive/compare/2.6.3...2.6.4