Skip to content

Commit

Permalink
some suggestions of Ivan applied.
Browse files Browse the repository at this point in the history
  • Loading branch information
iesahin committed Oct 8, 2021
1 parent 46411bf commit 72cca7c
Showing 1 changed file with 11 additions and 18 deletions.
29 changes: 11 additions & 18 deletions content/docs/start/experiments.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,14 +54,6 @@ experiments.

</details>

## Running the experiment with default parameters

The purpose of `dvc exp` subcommands is to let you run, capture, compare the
machine learning experiments at once as you iterate on your code, data, and
hyperparameters. The artifacts like models, metrics produced by each experiment
are tracked by DVC and the associated parameters and metrics can be committed to
Git as text files.

Running the experiment with the default project settings requires only the
command:

Expand All @@ -80,6 +72,12 @@ This experiment is then associated with the values found in parameters file
(`params.yaml`), and other dependencies (`data/images/`) with these produced
metrics.

The purpose of `dvc exp` family of commands is to let you run, capture, compare
the machine learning experiments at once as you iterate on your code, data,
models, and hyperparameters. The artifacts like models, metrics produced by each
experiment are tracked by DVC and the associated parameters and metrics can be
committed to Git as text files.

You can review the experiment results with `dvc exp show` and see these metrics
and results in a nicely formatted table:

Expand All @@ -98,7 +96,10 @@ $ dvc exp show
```

The `workspace` row in the table shows the results of the most recent experiment
that's available in the <bbr>workspace</abbr>.
that's available in the <bbr>workspace</abbr>. The table also shows each
experiment in a separate row, along with the Git commit IDs they are attached
to. We can see that the experiment we run has a name `exp-6dccf` and run from
the commit ID `7317bc6`.

<details>

Expand All @@ -119,8 +120,6 @@ experiments easily.

</details>

## Running the experiment by setting parameters

Now let's do some more experimentation.

DVC allows to update the parameters defined in the pipeline without modifying
Expand Down Expand Up @@ -165,7 +164,7 @@ $ dvc exp run --run-all --jobs 2

</details>

## Comparing experiments
## Comparing and persisting experiments

The experiments are run several times with different parameters. We use
`dvc exp show` to compare all of these experiments. This command presents the
Expand Down Expand Up @@ -216,10 +215,6 @@ $ dvc exp show --no-timestamp \
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
```

<details>

### βœ… Persisting experiments

After selecting an experiment from the table, it's possible to apply the
experiment results to your workspace, or you can create a Git branch that
contains the experiment with all its related files.
Expand All @@ -235,8 +230,6 @@ To switch to the new branch run:
You can then checkout and continue working from this branch, or merge the branch
your `main` branch with usual Git commands.

</details>

## Go Further

There are many other features of `dvc exp`, like cleaning up the unused
Expand Down

0 comments on commit 72cca7c

Please sign in to comment.