Backends

Backends are the lifeblood of Plots, and the diversity between features, approaches, and strengths/weaknesses was one of the primary reasons that I started this package.

For those who haven't had the pleasure of hacking on 15 different plotting APIs: first, consider yourself lucky. However, you will probably have a hard time choosing the right backend for your task at hand. This document is meant to be a guide and introduction to make that choice.

At a glance

My favorites: GR for speed, Plotly(JS) for interactivity, UnicodePlots for REPL/SSH and PyPlot otherwise.

If you require...then use...
featuresGR, PyPlot, Plotly(JS), Gaston
speedGR, UnicodePlots, InspectDR, Gaston
interactivityPyPlot, Plotly(JS), InspectDR
beautyGR, Plotly(JS), PGFPlots/ PGFPlotsX
REPL plottingUnicodePlots
3D plotsGR, PyPlot, Plotly(JS), Gaston
a GUI windowGR, PyPlot, PlotlyJS, Gaston, InspectDR
a small footprintUnicodePlots, Plotly
backend stabilityPyPlot, Gaston
plot+data -> .hdf5 fileHDF5

Of course this list is rather subjective and nothing in life is that simple. Likely there are subtle tradeoffs between backends, long hidden bugs, and more excitement. Don't be shy to try out something new !


GR

The default backend. Very fast with lots of plot types. Still actively developed and improving daily.

Pros:

  • Speed
  • 2D and 3D
  • Standalone or inline

Cons:

  • Limited interactivity

Primary author: Josef Heinen (@jheinen)

Fine tuning

It is possible to use more features of GR via the extra_kwargs mechanism.

using Plots; gr()

x = range(-3, 3, length=30)
surface(
  x, x, (x, y)->exp(-x^2 - y^2), c=:viridis, legend=:none,
  nx=50, ny=50, display_option=Plots.GR.OPTION_SHADED_MESH,  # <-- series[:extra_kwargs]
)

Supported :subplot :extra_kwargs

KeywordDescription
legend_hfactorVertical spacing factor for legends
legend_wfactorMultiplicative factor influencing the legend width

Supported :series :extra_kwargs

Series TypeKeywordDescription
:surfacenxNumber of interpolation points in the x direction
:surfacenyNumber of interpolation points in the y direction
:surface, :wireframedisplay_optionsee GR doc

Plotly / PlotlyJS

These are treated as separate backends, though they share much of the code and use the Plotly JavaScript API. plotly() is the only dependency-free plotting option, as the required JavaScript is bundled with Plots. It can create inline plots in IJulia, or open standalone browser windows when run from the Julia REPL.

plotlyjs() is the preferred option, and taps into the great functionality of Spencer Lyon's PlotlyJS.jl. Inline IJulia plots can be updated from any cell... something that makes this backend stand out. From the Julia REPL, it taps into Blink.jl and Electron to plot within a standalone GUI window... also very cool. Also, PlotlyJS supports saving the output to more formats than Plotly, such as EPS and PDF, and thus is the recommended version of Plotly for developing publication-quality figures.

"backends_plotlyjs.png"

Pros:

Cons:

  • No custom shapes
  • JSON may limit performance

Primary PlotlyJS.jl author: Spencer Lyon (@spencerlyon2)

MathJax

Plotly needs to load MathJax to render LaTeX strings, therefore passing extra keywords with extra_kwargs = :plot is implemented. With that it is possible to pass a header to the extra include_mathjax keyword. It has the following options:

  • include_mathjax = "" (default): no mathjax header
  • include_mathjax = "cdn" include the standard online version of the header
  • include_mathjax = "<filename?config=xyz>" include a user-defined file

These can also be passed using the extra_plot_kwargs keyword.

using LaTeXStrings
plotlyjs()
plot(
    1:4,
    [[1,4,9,16]*10000, [0.5, 2, 4.5, 8]],
    labels = [L"\alpha_{1c} = 352 \pm 11 \text{ km s}^{-1}";
              L"\beta_{1c} = 25 \pm 11 \text{ km s}^{-1}"] |> permutedims,
    xlabel = L"\sqrt{(n_\text{c}(t|{T_\text{early}}))}",
    ylabel = L"d, r \text{ (solar radius)}",
    yformatter = :plain,
    extra_plot_kwargs = KW(
        :include_mathjax => "cdn",
        :yaxis => KW(:automargin => true),
        :xaxis => KW(:domain => "auto")
   ),
)
"plotly_mathjax.html"

Fine tuning

It is possible to add additional arguments to the plotly series and layout dictionaries via the extra_kwargs mechanism. Arbitrary arguments are supported but one needs to be careful since no checks are performed and thus it is possible to unintentionally overwrite existing entries.

For example adding customdata can be done the following way scatter(1:3, customdata=["a", "b", "c"]). One can also pass multiple extra arguments to plotly.

pl = scatter(
    1:3,
    rand(3),
    extra_kwargs = KW(
        :series => KW(:customdata => ["a", "b", "c"]),
        :plot => KW(:legend => KW(:itemsizing => "constant"))
    )
)

PyPlot

A Julia wrapper around the popular python package PyPlot (Matplotlib). It uses PyCall.jl to pass data with minimal overhead.

Pros:

  • Tons of functionality
  • 2D and 3D
  • Mature library
  • Standalone or inline
  • Well supported in Plots

Cons:

  • Uses Python
  • Dependencies frequently cause setup issues

Primary author: Steven G Johnson (@stevengj)

Fine tuning

It is possible to use more features of PyPlot/matplotlib via the extra_kwargs mechanism. For example, for a 3D plot, the following example should generate a colorbar at a proper location; without the extra_kwargs below, the colorbar is displayed too far right to see its ticks and numbers. The four coordinates in the example below, i.e., [0.9, 0.05, 0.05, 0.9] specify the colorbar location [ left, bottom, width, height ]. Note that for 2D plots, this fine tuning is not necessary.

using Plots; pyplot()

x = y = collect(range(-π, π; length = 100))
fn(x, y) = 3 * exp(-(3x^2 + y^2)/5) * (sin(x+2y))+0.1randn(1)[1]
surface(x, y, fn, c=:viridis, extra_kwargs=Dict(:subplot=>Dict("3d_colorbar_axis" => [0.9, 0.05, 0.05, 0.9])))

Supported :subplot :extra_kwargs

KeywordDescription
3dcolorbaraxisSpecifying the colorbar location [ left, bottom, width, height ] for a 3D plot

PGFPlotsX

LaTeX plotting, based on PGF/TikZ.