7.5 Makie.jl and AlgebraOfGraphics.jl

Since AlgebraOfGraphics.jl uses Makie.jl as a backend, most of advanced customizations such as layouts are only possible by interacting directly with Makie.jl. Makie.jl layouts uses Figure, Axis and other types (see Section 6.8).

You can instantiate a Figure and use the mutating draw! function to draw a layer into an existing Figure or Axis. It is preferable to pass a GridPosition, e.g. fig[1, 1], instead of an Axis because draw! can pass Axis attributes, such as axis labels and axis tick labels, to the underlying visualization. If you pass an Axis to draw! these attributes need to be specified again as keyword arguments inside Axis:

fig = Figure()

# preferable
draw!(fig[1, 1], plt)

# avoid
ax = Axis(fig[1, 1])
draw!(ax, plt)

As an example, let’s create an advanced layout by combining Makie.jl with AlgebraOfGraphics.jl. We’ll use visualizations that had been already covered in this chapter:

# Figure
fig = Figure()

# First Axis
plt_barplot = data(df) *
    mapping(
        :name,
        :grade;
        color=:year,
        dodge=:year) *
visual(BarPlot)
subfig1 = draw!(fig[1, 1], plt_barplot)

# Second Axis
plt_custom = data(synthetic_df) *
    mapping(:x, :y) *
    (
        visual(Scatter; color=:steelblue, marker=:cross)
        + (
            linear() * visual(; color=:red, linestyle=:dot, linewidth=5)
        )
    )
subfig2 = draw!(fig[2, 1:2], plt_custom)

# Third Axis
plt_expectation = data(df) *
    mapping(:name, :grade) *
    expectation()
subfig3 = draw!(fig[1, 2], plt_expectation)

# Insert the legend
legend!(
    fig[end+1, 1:2],
    subfig1;
    orientation=:horizontal,
    tellheight=true
)

# Recover the Figure
fig
Figure 61: AlgebraOfGraphics custom layout with Makie.

Here, we are instantiating a Figure called fig. Then, we proceed by creating three Layers that have the prefix plt_. Each one of these are followed by a draw! with the desired fig’s GridPosition as the first position argument followed by the Layer as the second argument. Furthermore, we use AlgebraOfGraphics.jl’s legend! to add the legend to the visualization. They way legend! works is by passing first the desired fig’s GridPosition for the placement of the legend, and the desired legend labels. For the legend’s label, we use the output of the draw! function that was called in the Layers and that has legend labels already, in our case the plt_barplot. All of the Legend/axislegend keyword arguments (Section 6.2) can be used in legend!. Finally, as the last step, we call the Figure, fig, to recover it after it was mutated by all of the mutating “bang” functions, e.g. draw! and legend!, in order to render our visualization.

NOTE: Don’t forget to check AlgebraOfGraphics.jl documentation for additional examples.



Support this project
CC BY-NC-SA 4.0 Jose Storopoli, Rik Huijzer, Lazaro Alonso