Custom Charts

Search…
Custom Charts
Custom visualizations and custom panels using queries
Use Custom Charts to create charts that aren't possible right now in the default UI. Log arbitrary tables of data and visualize them exactly how you want. Control details of fonts, colors, and tooltips with the power of Vega.
What's possible: Read the launch announcement →​
Code: Try a live example in a hosted notebook →​
Video: Watch a quick walkthrough video →​
Example: Quick Keras and Sklearn demo notebook →​
Contact Carey ([email protected]) with questions or suggestions
Supported charts from vega.github.io/vega
How it works
1.Log data: From your script, log config and summary data as you normally would when running with W&B. To visualize a list of multiple values logged at one specific time, use a customwandb.Table
2.Customize the chart: Pull in any of this logged data with a GraphQL query. Visualize the results of your query with Vega, a powerful visualization grammar.
3.Log the chart: Call your own preset from your script with wandb.plot_table() or use one of our builtins.
Custom Charts Walkthrough
Log charts from a script
Builtin presets
These presets have builtin wandb.plot methods that make it fast to log charts directly from your script and see the exact visualizations you're looking for in the UI.
Line plot
Scatter plot
Bar chart
Histogram
PR curve
ROC curve
wandb.plot.line()
Log a custom line plot—a list of connected and ordered points (x,y) on arbitrary axes x and y.
1
data = [[x, y] for (x, y) in zip(x_values, y_values)]
2
table = wandb.Table(data=data, columns = ["x", "y"])
3
wandb.log({"my_custom_plot_id" : wandb.plot.line(table, "x", "y", title="Custom Y vs X Line Plot")})
Copied!
You can use this to log curves on any two dimensions. Note that if you're plotting two lists of values against each other, the number of values in the lists must match exactly (i.e. each point must have an x and a y).
​See in the app →​
​Run the code →​
wandb.plot.scatter()
Log a custom scatter plot—a list of points (x, y) on a pair of arbitrary axes x and y.
1
data = [[x, y] for (x, y) in zip(class_x_prediction_scores, class_y_prediction_scores)]
2
table = wandb.Table(data=data, columns = ["class_x", "class_y"])
3
wandb.log({"my_custom_id" : wandb.plot.scatter(table, "class_x", "class_y")})
Copied!
You can use this to log scatter points on any two dimensions. Note that if you're plotting two lists of values against each other, the number of values in the lists must match exactly (i.e. each point must have an x and a y).
​See in the app →​
​Run the code →​
wandb.plot.bar()
Log a custom bar chart—a list of labeled values as bars—natively in a few lines:
1
data = [[label, val] for (label, val) in zip(labels, values)]
2
table = wandb.Table(data=data, columns = ["label", "value"])
3
wandb.log({"my_bar_chart_id" : wandb.plot.bar(table, "label", "value", title="Custom Bar Chart")})
Copied!
You can use this to log arbitrary bar charts. Note that the number of labels and values in the lists must match exactly (i.e. each data point must have both).
​See in the app →​
​Run the code →​
wandb.plot.histogram()
Log a custom histogram—sort list of values into bins by count/frequency of occurrence—natively in a few lines. Let's say I have a list of prediction confidence scores (scores) and want to visualize their distribution:
1
data = [[s] for s in scores]
2
table = wandb.Table(data=data, columns=["scores"])
3
wandb.log({'my_histogram': wandb.plot.histogram(table, "scores", title=None)})
Copied!
You can use this to log arbitrary histograms. Note that data is a list of lists, intended to support a 2D array of rows and columns.
​See in the app →​
​Run the code →​
wandb.plot.pr_curve()
Create a Precision-Recall curve in one line:
1
plot = wandb.plot.pr_curve(
2
    ground_truth, predictions,
3
    labels=None, classes_to_plot=None)
4
    
5
wandb.log({"pr":})
Copied!
You can log this whenever your code has access to:
a model's predicted scores (predictions) on a set of examples
the corresponding ground truth labels (ground_truth) for those examples
(optionally) a list of the labels/class names (labels=["cat", "dog", "bird"...] if label index 0 means cat, 1 = dog, 2 = bird, etc.)
(optionally) a subset (still in list format) of the labels to visualize in the plot
​See in the app →​
​Run the code →​
wandb.plot.roc_curve()
Create an ROC curve in one line:
1
plot = wandb.plot.roc_curve(
2
    ground_truth, predictions,
3
    labels=None, classes_to_plot=None)
4
    
5
wandb.log({"roc": plot})
Copied!
You can log this whenever your code has access to:
a model's predicted scores (predictions) on a set of examples
the corresponding ground truth labels (ground_truth) for those examples
(optionally) a list of the labels/ class names (labels=["cat", "dog", "bird"...] if label index 0 means cat, 1 = dog, 2 = bird, etc.)
(optionally) a subset (still in list format) of these labels to visualize on the plot
​See in the app →​
​Run the code →​
Custom presets
Tweak a builtin preset, or create a new preset, then save the chart. Use the chart ID to log data to that custom preset directly from your script.
1
# Create a table with the columns to plot
2
table = wandb.Table(data=data, columns=["step", "height"])
3
​
4
# Map from the table's columns to the chart's fields
5
fields = {"x": "step",
6
          "value": "height"}
7
​
8
# Use the table to populate the new custom chart preset
9
# To use your own saved chart preset, change the vega_spec_name
10
my_custom_chart = wandb.plot_table(vega_spec_name="carey/new_chart",
11
              data_table=table,
12
              fields=fields,
13
              )
Copied!
​Run the code →​
Log data
Here are the data types you can log from your script and use in a custom chart:
Config: Initial settings of your experiment (your independent variables). This includes any named fields you've logged as keys to wandb.config at the start of your training (e.g. wandb.config.learning_rate = 0.0001)
Summary: Single values logged during training (your results or dependent variables), e.g. wandb.log({"val_acc" : 0.8}). If you write to this key multiple times during training via wandb.log(), the summary is set to the final value of that key.
History: The full timeseries of the logged scalar is available to the query via the history field
summaryTable: If you need to log a list of multiple values, use a wandb.Table() to save that data, then query it in your custom panel.
historyTable: If you need to see the history data, then query historyTable in your custom chart panel. Each time you call wandb.Table()  or log a custom chart, you're creating a new table in history for that step.
How to log a custom table
Use wandb.Table() to log your data as a 2D array. Typically each row of this table represents one data point, and each column denotes the relevant fields/dimensions for each data point which you'd like to plot. As you configure a custom panel, the whole table will be accessible via the named key passed to wandb.log()("custom_data_table" below), and the individual fields will be accessible via the column names ("x", "y", and "z"). You can log tables at multiple time steps throughout your experiment. The maximum size of each table is 10,000 rows.
​Try it in a Google Colab →​
1
# Logging a custom table of data
2
my_custom_data = [[x1, y1, z1], [x2, y2, z2]]
3
wandb.log({"custom_data_table": wandb.Table(data=my_custom_data,
4
                                columns = ["x", "y", "z"])})
Copied!
Customize the chart
Add a new custom chart to get started, then edit the query to select data from your visible runs. The query uses GraphQL to fetch data from the config, summary, and history fields in your runs.
Add a new custom chart, then edit the query
Custom visualizations
Select a Chart in the upper right corner to start with a default preset. Next, pick Chart fields to map the data you're pulling in from the query to the corresponding fields in your chart. Here's an example of selecting a metric to get from the query, then mapping that into the bar chart fields below.
Creating a custom bar chart showing accuracy across runs in a project
How to edit Vega
Click Edit at the top of the panel to go into Vega edit mode. Here you can define a Vega specification that creates an interactive chart in the UI. You can change any aspect of the chart, from the visual style (e.g. change the title, pick a different color scheme, show curves as a series of points instead of as connected lines) to the data itself (use a Vega transform to bin an array of values into a histogram, etc.). The panel preview will update interactively, so you can see the effect of your changes as you edit the Vega spec or query. The Vega documentation and tutorials are an excellent source of inspiration.
Field references
To pull data into your chart from W&B, add template strings of the form "${field:<field-name>}" anywhere in your Vega spec. This will create a dropdown in the Chart Fields area on the right side, which users can use to select a query result column to map into Vega.
To set a default value for a field, use this syntax: "${field:<field-name>:<placeholder text>}"
Saving chart presets
Apply any changes to a specific visualization panel with the button at the bottom of the modal. Alternatively, you can save the Vega spec to use elsewhere in your project. To save the reusable chart definition, click Save as at the top of the Vega editor and give your preset a name.
Articles and guides
1.​The W&B Machine Learning Visualization IDE​
2.​Visualizing NLP Attention Based Models​
3.​Visualizing The Effect of Attention on Gradient Flow​
4.​Logging arbitrary curves​
Frequently asked questions
Coming soon
Polling: Auto-refresh of data in the chart
Sampling: Dynamically adjust the total number of points loaded into the panel for efficiency
Gotchas
Not seeing the data you're expecting in the query as you're editing your chart? It might be because the column you're looking for is not logged in the runs you have selected. Save your chart and go back out to the runs table, and select the runs you'd like to visualize with the eye icon.
How to show a "step slider" in a custom chart?
This can be enabled on the “Other settings” page of the custom chart editor. If you change your query to use a historyTable instead of the summaryTable, you'll get an option to “Show step selector” in the custom chart editor. This gives you a slider that lets you select the step.
Show step slider in a custom chart
Common use cases
Customize bar plots with error bars
Show model validation metrics which require custom x-y coordinates (like precision-recall curves)
Overlay data distributions from two different models/experiments as histograms
Show changes in a metric via snapshots at multiple points during training
Create a unique visualization not yet available in W&B (and hopefully share it with the world) 