ML-Dash
  1. ML-Dash
  2. Dashboard

Experiment Chart Configuration

Customize the charts displayed in an experiment's Dashboard tab by creating a .dashrc file inside the experiment folder.

Creating and Editing .dashrc

If no .dashrc exists yet, click the save icon (tooltip Save current dashboard view as .dashrc) in the Dashboard tab toolbar. This generates a default configuration based on the current auto-generated charts, which you can then edit.

To edit an existing .dashrc:

  1. Click the edit icon (tooltip Edit .dashrc) in the top-right of the Dashboard tab, or click the .dashrc file.
  2. A split view opens: YAML editor on the right, live chart preview on the left.
  3. Edit — charts update automatically.

.dashrc split editor view

The .dashrc editor: YAML editor on the right with live chart preview on the left. Charts re-render automatically as you edit.

metrics — Header Metrics Filter

Controls which metrics appear in the experiment header, displayed as a row of key-value pairs above the charts.

yaml
metrics:
  fields:
    - "*"          # Show all metrics (default)
    # - "train*"   # Only metrics starting with "train"
    # - "eval*"    # Only metrics starting with "eval"
FieldTypeDefaultDescription
fieldsstring[]["*"]Glob patterns to filter which metrics are shown in the header

Line Charts (ctype: line)

Line charts display time-series metrics tracked with exp.metrics().

Minimal Example

yaml
charts:
  - ctype: line
    xKey: step
    yKey: train.loss

Full Example

yaml
charts:
  - ctype: line
    title: Training & Eval Loss
    xKey: step
    yKeys:
      - train.loss
      - eval.loss
    xLabel: Steps
    yLabel: Loss
    bins: 500
    xTicks: 10
    yTicks: 5

Field Reference

FieldTypeDefaultDescription
ctype"line"—Chart type (required)
titlestringmetric nameChart title shown above the chart
xKeystring—Metric name for the x-axis (required). Use "default" to let the server pick one, see below
yKeystring—Single y-axis metric. Mutually exclusive with yKeys
yKeysstring[]—Multiple y-axis metrics on the same chart. Mutually exclusive with yKey
xLabelstringxKey valueX-axis label
yLabelstringmetric nameY-axis label
binsnumber1000Number of points to downsample to. Higher values show more detail but are slower to render
xFormatstring | nullnullFormat specifier for x-axis tick labels
yFormatstring | nullnullFormat specifier for y-axis tick labels
xTicksnumberautoNumber of grid ticks on the x-axis
yTicksnumberautoNumber of grid ticks on the y-axis

yKey vs yKeys

Use yKey for a single metric:

yaml
- ctype: line
  xKey: step
  yKey: train.loss

Use yKeys to plot multiple metrics on the same chart:

yaml
- ctype: line
  xKey: step
  yKeys:
    - train.loss
    - eval.loss

xKey: "default"

When xKey is set to "default", the server picks the x-axis from the metric's own fields, in this order:

  1. step
  2. epoch

If the metric has neither, the data index (the order points were logged in) is used. To plot against wall-clock time, set xKey: timestamp explicitly.

Image Charts (ctype: image)

Image charts display image files uploaded with exp.files().save_image() or any image artifact.

Example

yaml
charts:
  - ctype: image
    title: Training Samples
    glob: "frames/**/*.png"
    nCols: 4
    nRows: 2
    sort: date

Field Reference

FieldTypeDefaultDescription
ctype"image"—Chart type (required)
titlestring"Images"Title shown above the grid
globstring"**/*.{png,jpg,jpeg,gif,webp}"Glob pattern to match image files within the experiment folder
nColsnumber3Number of columns in the image grid
nRowsnumber2Number of rows in the image grid. The grid shows at most nCols × nRows images
sort"name" | "date" | "size""name"Sort order for matched files

Video Charts (ctype: video)

Video charts display video files uploaded with exp.files().save_video() or any video artifact.

Example

yaml
charts:
  - ctype: video
    title: Episode Rollouts
    glob: "videos/**/*.mp4"
    nCols: 2
    nRows: 2
    sort: name

Field Reference

FieldTypeDefaultDescription
ctype"video"—Chart type (required)
titlestring"Videos"Title shown above the grid
globstring"**/*.{mp4,webm,mov}"Glob pattern to match video files within the experiment folder
nColsnumber3Number of columns in the video grid
nRowsnumber2Number of rows in the video grid. The grid shows at most nCols × nRows videos
sort"name" | "date" | "size""name"Sort order for matched files

Complete Example

yaml
metrics:
  fields:
    - "*"

charts:
  # Training and evaluation loss on one chart
  - ctype: line
    title: Loss
    xKey: step
    yKeys:
      - train.loss
      - eval.loss
    xLabel: Steps
    yLabel: Loss
    bins: 500

  # Accuracy as a separate chart
  - ctype: line
    title: Accuracy
    xKey: step
    yKey: eval.accuracy
    bins: 500

  # Latest rendered frames
  - ctype: image
    title: Rendered Frames
    glob: "frames/**/*.jpg"
    nCols: 4
    nRows: 2
    sort: date

  # Episode rollout videos
  - ctype: video
    title: Episode Rollouts
    glob: "videos/**/*.mp4"
    nCols: 2
    nRows: 2
    sort: name

Next: Learn how to compare multiple experiments with Compare.