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:

    1. # Figure
    2. fig = Figure()
    4. # First Axis
    5. plt_barplot = data(df) *
    6.     mapping(
    7.         :name,
    9.         color=:year,
    10.         dodge=:year) *
    11. visual(BarPlot)
    12. subfig1 = draw!(fig[1, 1], plt_barplot)
    13. # Second Axis
    14. plt_custom = data(synthetic_df) *
    15.     mapping(:x, :y) *
    16.     (
    17.         visual(Scatter; color=:steelblue, marker=:cross)
    18.         + (
    19.             linear() * visual(; color=:red, linestyle=:dot, linewidth=5)
    20.         )
    21.     )
    22. subfig2 = draw!(fig[2, 1:2], plt_custom)
    24. # Third Axis
    25.     mapping(:name, :grade) *
    26.     expectation()
    27. subfig3 = draw!(fig[1, 2], plt_expectation)
    29. # Insert the legend
    30. legend!(
    31.     fig[end+1, 1:2],
    32.     subfig1;
    34.     tellheight=true
    35. )
    37. fig

    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 , in order to render our visualization.