Description
Display a table of experiments with their parameters and metrics. This command provides a comprehensive view of all experiments, allowing you to compare results across different runs and identify the best performing configurations.
Use --only-changed to focus on metrics and parameters that vary across experiments, making it easier to identify what impacts performance.
Usage
Options
Filtering Options
Show experiments derived from the tip of all Git branches.dvc exp show --all-branches
Show experiments derived from all Git tags. Show experiments from all Git commits (not just latest).
Show experiments derived from specific Git revisions.dvc exp show --rev main --rev feature-branch
Show experiments from the last N commits. Hide failed experiments in the table.dvc exp show --hide-failed
Hide queued experiments in the table.dvc exp show --hide-queued
Hide workspace row in the table.
Display Options
Only show metrics and parameters with values varying across experiments. Very useful for identifying what parameters affect results.dvc exp show --only-changed
Remove columns matching the specified regex pattern. Can be used multiple times.dvc exp show --drop 'params.yaml:data.*' --drop 'metrics.json:train.*'
Preserve only columns matching the specified regex pattern. Can be used multiple times.dvc exp show --keep 'metrics.*' --keep 'params.yaml:model.*'
Show only parameters that are stage dependencies (defined in dvc.yaml).dvc exp show --param-deps
Do not pipe output into a pager. Useful when redirecting output or in CI/CD. Always show Git commit SHAs instead of branch/tag names. Sorting Options
Sort experiments by the specified metric or parameter.dvc exp show --sort-by metrics.json:accuracy
dvc exp show --sort-by params.yaml:train.lr
Sort order to use with --sort-by. Options: asc (ascending) or desc (descending).dvc exp show --sort-by accuracy --sort-order desc
Print output in JSON format instead of a human-readable table.dvc exp show --json > experiments.json
Print output in CSV format instead of a human-readable table.dvc exp show --csv > experiments.csv
Show output in Markdown table format (GitHub Flavored Markdown). Round metrics and parameters to N digits after the decimal point.dvc exp show --precision 3
Force re-collection of experiments instead of loading from cache. Examples
Show all experiments
Output:
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━┓
┃ Experiment ┃ Created ┃ accuracy ┃ loss ┃ lr ┃ epochs ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━┩
│ workspace │ - │ 0.92 │ 0.234 │ 0.001 │ 50 │
│ ├── exp-a1b2c │ Mar 04 │ 0.89 │ 0.287 │ 0.01 │ 50 │
│ └── exp-d3e4f │ Mar 03 │ 0.85 │ 0.312 │ 0.1 │ 50 │
│ main │ Mar 02 │ 0.83 │ 0.351 │ 0.001 │ 30 │
└───────────────────┴─────────┴──────────┴─────────────┴────────┴─────────┘
Show only changed values
dvc exp show --only-changed
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┓
┃ Experiment ┃ accuracy ┃ loss ┃ lr ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━┩
│ workspace │ 0.92 │ 0.234 │ 0.001 │
│ ├── exp-a1b2c │ 0.89 │ 0.287 │ 0.01 │
│ └── exp-d3e4f │ 0.85 │ 0.312 │ 0.1 │
│ main │ 0.83 │ 0.351 │ 0.001 │
└───────────────────┴──────────┴─────────────┴────────┘
The epochs column is hidden because all experiments used the same value.
Sort by metric
dvc exp show --sort-by accuracy --sort-order desc --only-changed
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━┓
┃ Experiment ┃ accuracy ┃ loss ┃ lr ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━┩
│ workspace │ 0.92 │ 0.234 │ 0.001 │
│ ├── exp-a1b2c │ 0.89 │ 0.287 │ 0.01 │
│ └── exp-d3e4f │ 0.85 │ 0.312 │ 0.1 │
│ main │ 0.83 │ 0.351 │ 0.001 │
└───────────────────┴──────────┴─────────────┴────────┘
Sorting by metrics helps quickly identify the best performing experiments.
Filter columns with regex
dvc exp show --keep 'metrics.*' --only-changed
┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━┓
┃ Experiment ┃ accuracy ┃ loss ┃
┡━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━┩
│ workspace │ 0.92 │ 0.234 │
│ ├── exp-a1b2c │ 0.89 │ 0.287 │
│ └── exp-d3e4f │ 0.85 │ 0.312 │
│ main │ 0.83 │ 0.351 │
└───────────────────┴──────────┴─────────────┘
Export to CSV
dvc exp show --csv > experiments.csv
experiments.csv):
Experiment,Created,accuracy,loss,lr,epochs
workspace,-,0.92,0.234,0.001,50
exp-a1b2c,Mar 04,0.89,0.287,0.01,50
exp-d3e4f,Mar 03,0.85,0.312,0.1,50
main,Mar 02,0.83,0.351,0.001,30
CSV output is useful for importing results into spreadsheets or data analysis tools.
Export to JSON
dvc exp show --json | jq '.[] | select(.data.metrics.accuracy > 0.9)'
JSON output works great with tools like jq for programmatic filtering and analysis.
Show experiments from multiple branches
dvc exp show --rev main --rev feature-branch --only-changed
Show last 10 commits with experiments
dvc exp show --md --only-changed --sort-by accuracy --sort-order desc
| Experiment | accuracy | loss | lr |
|--------------|----------|-------|-------|
| workspace | 0.92 | 0.234 | 0.001 |
| exp-a1b2c | 0.89 | 0.287 | 0.01 |
| exp-d3e4f | 0.85 | 0.312 | 0.1 |
| main | 0.83 | 0.351 | 0.001 |
Understanding the Output
Experiment Tree Structure
Experiments are shown in a tree structure:
- Bold rows indicate baseline commits (Git commits)
- └── and ├── symbols show experiment hierarchy
- workspace shows current uncommitted changes
Column Types
Columns are color-coded by type:
- Experiment info (grey background): Experiment name, creation date, state
- Metrics (orange background): Performance metrics from your model
- Parameters (cyan background): Hyperparameters and configuration
- Dependencies (purple background): Input data checksums
Failed experiments show ! in the State column. Use --hide-failed to exclude them.
Common Workflows
Find best experiment
dvc exp show --sort-by metrics.json:accuracy --sort-order desc --only-changed | head -n 5
Compare specific parameters
dvc exp show --keep 'params.yaml:model.*' --keep 'metrics.json:accuracy'
Generate report for stakeholders
dvc exp show --md --only-changed --hide-failed --sort-by accuracy --sort-order desc > report.md
dvc exp run - Create new experimentsdvc exp diff - Compare two specific experimentsdvc exp apply - Apply experiment to workspacedvc metrics show - View metrics without experiment context
