krastanov/julia-makie-recipes

Julia Makie Recipes

Create custom Makie plot types using recipes. This skill assumes recipes live in package extensions (see julia-package-dev).

Type Recipes (Conversions)

function Makie.convert_arguments(P::Type{<:Makie.Heatmap}, data::MyType)
    matrix = extract_matrix(data)
    return Makie.convert_arguments(P, matrix)
end

Full Recipes (Custom Plots)

Makie.@recipe(CircuitPlot, circuit) do scene
    Makie.Theme(;
        gatewidth = 0.8,
        wirecolor = :black,
    )
end

Implement plot!

function Makie.plot!(plot::CircuitPlot)
    circuit = plot[:circuit][]
    Makie.lines!(plot, xs, ys; color = plot.wirecolor)
    Makie.scatter!(plot, points; markersize = 10)
    return plot
end

Notes

• Pass the recipe plot object as the first argument to primitives.
• Use plot.attr[] for the current value and plot.attr for Observables.

Checklist

• [ ] Add Makie as a weak dep via Pkg (pkg> add --weak Makie)
• [ ] Add [extensions] mapping for {Package}MakieExt
• [ ] Create stub functions in the main package (with docstrings)
• [ ] Implement the recipe and Makie.plot! in the extension
• [ ] Test with CairoMakie and GLMakie

Reference

• Complete Examples - Full extension example with recipes
• Patterns - Attributes, reactivity, axis configuration

Related Skills

• julia-package-dev - Package extension setup
• julia-docs - Documenting extension functionality