Layer plots

To “layer” or “stack” multiple plots on top of each other, use the layer function. This is useful if you want to combine multiple plots of different types into a single visualization, such as a scatter plot and a line plot. This is distinct from sub-plots, which present multiple plots side-by-side. By default, the stacked plot will use the layout (axis labels, axis ranges, and title) from the last plot in the sequence. The which_layout parameter can be used to specify which plot’s layout should be used.

Examples

Layering two plots

Use a candlestick plot and a line plot for two different perspectives on the same data.

import deephaven.plot.express as dx
import deephaven.agg as agg
stocks = dx.data.stocks()  # import the example stock market data set

# select only DOG prices and compute ohlc
dog_prices = stocks.where("Sym == `DOG`")
dog_ohlc = dog_prices.update_view(
    "BinnedTimestamp = lowerBin(Timestamp, 'PT1m')"
).agg_by(
    [
        agg.first("Open=Price"),
        agg.max_("High=Price"),
        agg.min_("Low=Price"),
        agg.last("Close=Price"),
    ],
    by="BinnedTimestamp",
)

# layer a line plot and a candlestick plot by passing both to layer()
financial_plot = dx.layer(
    dx.line(
        dog_prices, x="Timestamp", y="Price"),
    dx.candlestick(
        dog_ohlc, x="BinnedTimestamp",
        open="Open", high="High", low="Low", close="Close")
)

API Reference

Layers the provided figures. Be default, the layouts are sequentially applied, so the layouts of later figures will override the layouts of early figures.

Returns: DeephavenFigure The layered chart