Skip to content

Commit

Permalink
ref: improve queued exp remove examples
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel authored Aug 25, 2021
1 parent 700a966 commit 4ab2e36
Showing 1 changed file with 16 additions and 21 deletions.
37 changes: 16 additions & 21 deletions content/docs/command-reference/exp/remove.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ positional arguments:
## Description

Deletes one or more experiments, indicated by name (see `dvc exp run`) or
commit SHA (only queued experiments).
ID (only queued experiments).

With `--queue`, the list of experiments awaiting execution is cleared instead.

Expand Down Expand Up @@ -58,41 +58,36 @@ master:
exp-e6c97
```

For those experiments in the queue, things are pretty similiar. Let us first
create some queued experiments.
The same applies to queued experiments but they won't have a name to give to
`dvc exp remove` yet unless you specify one. Alternatively, you can use their ID
instead (shown when queued and by `dvc exp show`).

Let's queue a few experiments in different ways and then delete some of them:

```dvc
$ dvc exp run --queue -S train.min_split=64 --name split64
$ dvc exp run --queue -S train.min_split=64
Queued experiment 'e41d5b4' for future execution.
$ dvc exp run --queue -S train.min_split=32 --name split32
Queued experiment '5751540' for future execution.
$ dvc exp run --queue -S train.min_split=16 --name split16
Queued experiment '8de9a6c' for future execution.
$ dvc exp run --queue -S train.min_split=128
Queued experiment 'dbca012' for future execution.
$ dvc exp show --include-params=train.min_split --no-pager
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ Experiment ┃ Created ┃ State ┃ avg_prec ┃ roc_auc ┃ train.min_split ┃
┑━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
β”‚ workspace β”‚ - β”‚ - β”‚ 0.57553 β”‚ 0.94652 β”‚ 2 β”‚
β”‚ master β”‚ Aug 02, 2021 β”‚ - β”‚ 0.53252 β”‚ 0.9107 β”‚ 2 β”‚
β”‚ β”œβ”€β”€ dbca012 β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 128 β”‚
β”‚ β”œβ”€β”€ 8de9a6c [split16] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 16 β”‚
β”‚ β”œβ”€β”€ 5751540 [split32] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 32 β”‚
β”‚ └── e41d5b4 [split64] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 64 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
$ dvc exp remove dbca012
$ dvc exp remove split16
$ dvc exp e41d5b4 split16
$ dvc exp show --include-params=train.min_split --no-pager
```

```table
┏━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ Experiment ┃ Created ┃ State ┃ avg_prec ┃ roc_auc ┃ train.min_split ┃
┑━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
β”‚ workspace β”‚ - β”‚ - β”‚ 0.57553 β”‚ 0.94652 β”‚ 2 β”‚
β”‚ master β”‚ Aug 02, 2021 β”‚ - β”‚ 0.53252 β”‚ 0.9107 β”‚ 2 β”‚
β”‚ β”œβ”€β”€ 5751540 [split32] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 32 β”‚
β”‚ └── e41d5b4 [split64] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 64 β”‚
β”‚ └── 5751540 [split32] β”‚ 04:57 PM β”‚ Queued β”‚ - β”‚ - β”‚ 32 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
```

```dvc
$ dvc exp remove --queue
$ dvc exp show --include-params=train.min_split --no-pager
┏━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
Expand Down

0 comments on commit 4ab2e36

Please sign in to comment.