Check out our new VS Code extension for experiment tracking and model development
Commit the results from an experiment in a new Git branch.
usage: dvc exp branch [-h] [-q | -v] experiment branch
positional arguments:
experiment Experiment to turn into a branch
branch Git branch name to use
Makes a given Git branch
containing the target experiment
. This makes the
experiment into a regular commit, or several in the case of checkpoint
experiments (one per checkpoint).
The new branch
will be based on the experiment's parent commit (HEAD
at the
time that the experiment was run). Note that DVC does not switch into the
new branch
automatically.
dvc exp branch
is useful to make an experiment persistent without modifying
the workspace so they can be continued, stored and shared in a normal Git +
DVC workflow.
To switch into the new branch, use git checkout branch
and dvc checkout
. Or
use git merge branch
and dvc repro
to combine it with your current project
version.
-h
, --help
- shows the help message and exit.
-q
, --quiet
- do not write anything to standard output. Exit with 0 if no
problems arise, otherwise 1.
-v
, --verbose
- displays detailed tracing information from executing the
dvc pull
command.
This example is based on our Get Started, where you can find the actual source code.
Let's say we have run 3 experiments in our project:
$ dvc exp show --include-params=featurize
────────────────────────────────────────────────────────────────────────────────────────────
Experiment Created metric: auc featurize.max_features featurize.ngrams
────────────────────────────────────────────────────────────────────────────────────────────
workspace - 0.61314 1500 2
10-bigrams-experiment Jun 20, 2020 0.61314 1500 2
├── exp-e6c97 Oct 21, 2020 0.61314 1500 2
├── exp-1dad0 Oct 09, 2020 0.57756 2000 2
└── exp-1df77 Oct 09, 2020 0.51676 500 2
────────────────────────────────────────────────────────────────────────────────────────────
We may want to branch-off exp-1dad0
for a separate experimentation process
(based on 2000 max_features
).
$ dvc exp branch exp-1dad0 maxf-2000
Git branch 'maxf-2000' has been created from experiment 'exp-1dad0'.
To switch to the new branch run:
git checkout my-branch
We can inspect the result with Git:
$ git branch
* master
maxf-2000
maxf-2000
can now be checked out, merged, rebased, pushed, etc. like any other
Git branch.