Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

experiment-management: remove warning about no parameter validation #2824

Merged
merged 8 commits into from
Oct 20, 2021
6 changes: 3 additions & 3 deletions content/docs/command-reference/exp/run.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ CPU cores).
> `dvc repro`, with the exception that `--no-commit` has no effect here.

- `-S [<filename>:]<param_name>=<param_value>`,
`--set-param [<filename>:]<param_name>=<param_value>` - set the specified
`--set-param [<filename>:]<param_name>=<param_value>` - set the value of existing
`dvc params` for this experiment. `filename` can be any valid params file
(`params.yaml` by default). This will override the param values coming from
the params file.
Expand Down Expand Up @@ -258,8 +258,8 @@ experiment we just ran (`exp-44136`).

You could modify a params file just like any other <abbr>dependency</abbr> and
run an experiment on that basis. Since this is a common need, `dvc exp run`
comes with the `--set-param` (`-S`) option built-in. This saves you the need to
manually edit the params file:
comes with the `--set-param` (`-S`) option built-in to update existing
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved
parameters. This saves you the need to manually edit the params file.

```dvc
$ dvc exp run -S prepare.split=0.25 -S featurize.max_features=2000
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -146,12 +146,17 @@ $ dvc exp run -S myparams.toml:learning_rate = 0.0001

### Updating experiment parameters on-the-fly

DVC allows to update the parameters from command line when running experiments.
The `--set-param` (`-S`) option takes a parameter name and its value, and
DVC allows to update parameters from command line when running experiments.
The `--set-param` (`-S`) option takes an existing parameter name and its value, and
updates the params file before the run.

```dvc
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved
$ cat params.yaml
model:
learning_rate: 0.001

$ dvc exp run --set-param model.learning_rate=0.0002
jorgeorpinel marked this conversation as resolved.
Show resolved Hide resolved
...
```

> Note that parameters are attached to experiments so you can view them together
Expand All @@ -164,10 +169,6 @@ times:
$ dvc exp run -S learning_rate=0.001 -S units=128
```

> ⚠️ Note that DVC doesn't check whether parameters given to `--set-param` are
> already in the parameters file. If there is a typo, a new or different param
> will be added/changed.

## The experiments queue

The `--queue` option of `dvc exp run` tells DVC to append an experiment for
Expand Down