Dvclive

What's Changed
* _init_dvc: Skip experiment save if inside repo has stages. by daavoo in https://github.com/iterative/dvclive/pull/382
* update template by dtrifiro in https://github.com/iterative/dvclive/pull/386
* lightning: record actual training step by dberenbaum in https://github.com/iterative/dvclive/pull/383
* write out dvcyaml at each step with relevant outputs by dberenbaum in https://github.com/iterative/dvclive/pull/385
* lightning: log params by dberenbaum in https://github.com/iterative/dvclive/pull/388
* live.end: Don't increment `step` value. by daavoo in https://github.com/iterative/dvclive/pull/390


**Full Changelog**: https://github.com/iterative/dvclive/compare/1.1.0...1.1.1

DVCLive Experiments

Can be enabled by passing `save_dvc_exp=True`.

python
foo.py
import random
from dvclive import Live

with Live(save_dvc_exp=True) as live:
live.log_param("fooparam", random.random())
for i in range(4):
live.log_metric("foo", i * random.random())
live.next_step()


When inside a [`DVC` repository](https://dvc.org/doc/command-reference/init) and `DVC` is available as a Python library, DVCLive will create a new [DVC experiment ](https://dvc.org/doc/start/experiment-management/experiments) as part of `live.end` (called on exit of context manager and inside the integrations with ML frameworks).

console
$ python foo.py
$ dvc exp show
─────────────────────────────────────────────────────────────────
Experiment Created foo step fooparam
─────────────────────────────────────────────────────────────────
workspace - 0.56773 4 0.20543
master 03:45 PM - - -
└── fbed990 [rowdy-vase] 07:25 PM 0.56773 4 0.20543
─────────────────────────────────────────────────────────────────
$ python foo.py
$ dvc exp show
─────────────────────────────────────────────────────────────────
Experiment Created foo step fooparam
─────────────────────────────────────────────────────────────────
workspace - 2.2236 4 0.65216
master 03:45 PM - - -
├── 4ec327f [shock-weka] 07:25 PM 2.2236 4 0.65216
└── fbed990 [rowdy-vase] 07:25 PM 0.56773 4 0.20543
─────────────────────────────────────────────────────────────────


What's Changed
* Create `DVC` experiment on `live.end`. by daavoo in https://github.com/iterative/dvclive/pull/366
* fast.ai: Handle resuming. by daavoo in https://github.com/iterative/dvclive/pull/379

**Full Changelog**: https://github.com/iterative/dvclive/compare/1.0.3...1.1.0

What's Changed
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/iterative/dvclive/pull/351
* report: Handle custom names used in `sklearn_plots`. by daavoo in https://github.com/iterative/dvclive/pull/372


**Full Changelog**: https://github.com/iterative/dvclive/compare/1.0.2...1.0.3

What's Changed
* add bandit, a security linter by skshetry in https://github.com/iterative/dvclive/pull/363
* integration: dvc: test checkpoint file creation by pared in https://github.com/iterative/dvclive/pull/342
* frameworks: Call `live.end` at the end of training. by daavoo in https://github.com/iterative/dvclive/pull/364
* lightning: support report kwarg by dberenbaum in https://github.com/iterative/dvclive/pull/369


**Full Changelog**: https://github.com/iterative/dvclive/compare/1.0.1...1.0.2

What's Changed
* [bug] lightning default dir integration fix by shcheklein in https://github.com/iterative/dvclive/pull/362


**Full Changelog**: https://github.com/iterative/dvclive/compare/1.0...1.0.1

Breaking changes

- Changes to the structure of the output directory and where methods write to 322

| Method | Before | Now
| -------------- | ----------------------| ----------------------- |
live.log_image | `dvclive/images` | `dvclive/plots/images` |
live.log_metric | `dvclive/scalars` | `dvclive/plots/metrics` |
live.log_sklearn_plot | `dvclive/plots` | `dvclive/plots/sklearn` |
live.make_summary | `dvclive.json` | `dvclive/summary.json` |

- `live.log` renamed to `live.log_metric` 343
- `live.log_plot` renamed to `live.log_sklearn_plot` 322
- Removed `live.get_step()` and `live.set_step()` in favor of `live.step` property. 357
- `live.log_image` No longer creates step subfolder. Instead overrides the previous step 331
The subfolder structure can be still manually created:
py
for i in range(2):
live.log_image(f"{live.step}/img.png", img)

- `live.log_metric` No longer calls `live.make_summary` 353
- `live.log_sklearn_plot` No longer raises error on `step` logging. Instead overrides previous step.
- Dropped support for `live` section in `dvc.yaml` 337

New Features

- `Live` can now be used as a context manager 354

py
with Live() as live:
live.log_metric("foo", 0.1)


- New `Live.summary` can be used to add metrics directly to the summary 354

py
with Live() as live:
for epoch in range(EPOCHS):
live.log_metric("loss", 0.1)
live.summary["additional_metric"] = 1.0


- Option to provide custom name for `Live.log_sklearn_plot`

py
live.log_sklearn_plot("confusion_matrix", y_true, y_pred, name="train/cm")


**Full Changelog**: https://github.com/iterative/dvclive/compare/0.12.1...1.0