Skip to content

Commit

Permalink
ref: dump and copy edit exp branch Example
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel committed Mar 1, 2021
1 parent a0ccd63 commit 7f41d83
Showing 1 changed file with 41 additions and 0 deletions.
41 changes: 41 additions & 0 deletions content/docs/command-reference/exp/branch.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,3 +48,44 @@ To switch into the new branch, use `git checkout branch` and `dvc checkout`.

- `-v`, `--verbose` - displays detailed tracing information from executing the
`dvc pull` command.

## Example: Make a persistent branch from an experiment

> This example is based on our
> [Get Started](/doc/tutorials/get-started/experiments), where you can find the
> actual source code.
Let's say we have run 3 experiments in our project:

```dvc
$ dvc exp show --include-params=featurize
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Experiment ┃ Created ┃ auc ┃ featurize.max_features ┃ featurize.ngrams ┃
┑━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
β”‚ workspace β”‚ - β”‚ 0.61314 β”‚ 1500 β”‚ 2 β”‚
β”‚ 11-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
$ 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:

```dvc
$ git branch
* master
maxf-2000
```

`maxf-2000` can now be merged, rebased, pushed, etc. like any other Git branch.

0 comments on commit 7f41d83

Please sign in to comment.