diff --git a/content/docs/command-reference/exp/show.md b/content/docs/command-reference/exp/show.md index 14489cc70a..b8935095cb 100644 --- a/content/docs/command-reference/exp/show.md +++ b/content/docs/command-reference/exp/show.md @@ -15,6 +15,7 @@ usage: dvc exp show [-h] [-q | -v] [-a] [-T] [-A] [-n ] [--sort-by ] [--sort-order {asc,desc}] [--no-timestamp] [--sha] [--json] [--csv] [--md] [--precision ] + [--only-changed] ``` ## Description @@ -73,6 +74,12 @@ metric or param. - `--param-deps` - include only parameters that are stage dependencies. +- `--only-changed` - show only parameters and metrics with values that vary + across experiments. Note that this option takes precedence over + `--include-params` and `--include-metrics`, for example given + `--include-params=foo --only-changed`, param `foo` would still be hidden if + its value is the same in all experiments. + - `--include-params ` - show the specified `dvc params` in the table only. Accepts a comma-separated `list` of param names. Shell style wildcards supported: `*`, `?`, `[seq]`, `[!seq]`, and `**` If a `path:` prefix is @@ -171,6 +178,22 @@ $ dvc exp show --include-params=featurize └───────────────────────┴──────────────┴─────────┴────────────────────────┴──────────────────┘ ``` +You can also filter out any metrics and parameters that do not change across the +shown experiments: + +```dvc +$ dvc exp show --only-changed +┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┓ +┃ Experiment ┃ Created ┃ auc ┃ featurize.max_features ┃ +┡━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━┩ +│ workspace │ - │ 0.61314 │ 1500 │ +│ 10-bigrams-experiment │ Jun 20, 2020 │ 0.61314 │ 1500 │ +│ ├── exp-e6c97 │ Oct 21, 2020 │ 0.61314 │ 1500 │ +│ ├── exp-1dad0 │ Oct 09, 2020 │ 0.57756 │ 2000 │ +│ └── exp-1df77 │ Oct 09, 2020 │ 0.51676 │ 500 │ +└───────────────────────┴──────────────┴─────────┴────────────────────────┘ +``` + Sort experiments by the `auc` metric, in ascending order: ```dvc