Deephaven Express

Deephaven Express is a powerful plotting library built on top of Plotly Express that extends its capabilities by natively supporting real-time Deephaven tables, along with automatic downsampling, server-side data grouping and aggregation using the Deephaven query engine. This library seamlessly integrates real-time data from Deephaven with the interactive and expressive visualizations of Plotly Express, allowing you to plot or aggregate millions of data points easily. It can mostly be considered a drop-in replacement for Plotly Express, with the added benefit of real-time data support when used within Deephaven.

Features

• Real-Time Deephaven Tables: Deephaven Plotly Express enables direct integration with real-time Deephaven tables, allowing you to visualize and analyze data as it updates in real time.
• Automatic Downsampling: The library offers pixel-accurate automatic downsampling that reduces the number of data points displayed, ensuring smooth and responsive visualizations even with large datasets.
• Server-Side Data Grouping and Aggregation: Deephaven Plotly Express leverages server-side processing capabilities to perform data grouping and aggregation directly within Deephaven, enabling efficient analysis of huge datasets without requiring data transfer.
• Plotly Express Compatibility: Built on top of Plotly Express, the library inherits its comprehensive features, enabling you to create stunning and interactive visualizations effortlessly. In most cases, you can directly swap px for dx for instant compatibility.
• Interactive Visualizations: Deephaven Plotly Express supports interactive features such as zooming, panning, and hovering, allowing you to explore and interact with your data conveniently.
• Easy-to-Use API: The library provides a simple and intuitive API, making it easy for users to generate a wide range of visualizations and customize them according to their specific needs.
• Single entry point: import deephaven.plot.express as dx enables easy access to all plotting functions and built-in demo datasets.

Plot Types

This page contains links to examples demonstrating different plot types and usage scenarios. Explore these examples to better understand how to leverage the library in your projects.

Under construction

The following links are still under construction, as an early preview documentation is available directly on GitHub. Please check back soon for the complete set of examples.

Basic plots

• Scatter plot
• Line plot
• Bar plot
• Area plot
• Pie plot

1D Distribution plots

• Histogram
• Box plot
• Violin plot
• Strip plot

Financial plots

• Candlestick
• OHLC
• Treemap
• Icicle
• Sunburst
• Funnel
• Funnel Area

3D, Polar, Ternary and other plots

• Scatter 3d
• Line 3d
• Scatter polar
• Line polar
• Scatter ternary
• Line ternary
• Timeline

Concepts

• Plot by
• Sub plot
• Layer plot
• Multiple axes

Getting started

To create a real-time plot using Deephaven Plotly Express, run the following example with Deephaven:

import deephaven.plot.express as dx

# Deephaven express includes several generated data sets for examples
my_table = dx.data.stocks()

# Create a line plot, and assign colors by distinct values in the `sym` column
my_plot = dx.line(table=my_table, x="timestamp", y="price", color="sym")

In this example, we create a Deephaven table and create a line plot of timestamp against price with automatic downsampling and partitions by sym for each trace assigned to the color option.