From 51733ed276f75af719b71381bc8c5977c74c03f5 Mon Sep 17 00:00:00 2001 From: Kim Louisa Auth Date: Fri, 20 Sep 2024 11:42:31 +0200 Subject: [PATCH] helper functions for scaling --- README.md | 47 +++++++++++++++++++++- assets/my_12x8cm_figure.png | Bin 0 -> 104819 bytes src/MakiePublicationTheme.jl | 4 +- src/figure_sizes.jl | 73 +++++++++++++++++++++++++++++++++++ test/figure_size.jl | 23 +++++++++++ test/runtests.jl | 1 + 6 files changed, 146 insertions(+), 2 deletions(-) create mode 100644 assets/my_12x8cm_figure.png create mode 100644 src/figure_sizes.jl create mode 100644 test/figure_size.jl diff --git a/README.md b/README.md index f906866..f20b1e4 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,55 @@ # MakiePublicationTheme [![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://kimauth.github.io/MakiePublicationTheme.jl/stable/) -[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://kimauth.github.io/MakiePublicationTheme.jl/dev/) [![Build Status](https://github.com/kimauth/MakiePublicationTheme.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/kimauth/MakiePublicationTheme.jl/actions/workflows/CI.yml?query=branch%3Amain) My favourite settings for publication quality [`Makie.jl`](https://docs.makie.org/) plots. This theme is for example used in [Auth et. al., 2024](https://doi.org/10.1016/j.euromechsol.2024.105418). + +The [Makie demofigure for themes](https://docs.makie.org/stable/explanations/theming/predefined_themes) will look as follows: +```julia +using MakiePublicationTheme +using CairoMakie, Random # needed for demofigure + +with_theme(publication_theme()) do + f = demofigure() +end +``` ![Makie-theme-demofigure for publication theme](/assets/makie_demofigure.png) + +# Exporting figures with physical dimensions +`MakiePublicationTheme.jl` supplies helper functions in order to [match physical figure and +font sizes](https://docs.makie.org/v0.21/explanations/figure#Matching-figure-and-font-sizes-to-documents) +when saving figures. +```julia +using MakiePublicationTheme +using CairoMakie, Random + +set_theme!(publication_theme()) +update_theme!(fontsize=11) # use fontsize 11 instead of the default fontsize 10 here + +size_cm = (12.0, 8.0) +dpi = 300 +size, px_per_unit = size_pixelgraphic(size_cm, dpi) + +# generate figure with correct canvas size +f = Figure(; size) + +# fill the figure with a few things with font sizes +ax = Axis(f[1,1]; + xlabel = "xlabel in fontsize 11", + ylabel = "ylabel in fontsize 11", + title = "My 12cm x 8cm figure", + xticks = MultiplesTicks(5, π, "π"), + ) +lines!(ax, 0.0:0.1:3π, sin) +lines!(ax, 0.0:0.1:3π, cos) +cycle = (color=:color) # cycle over (lineplot) colors instead of inheriting :textcolor +text!(ax, 3π/4, sin(3π/4); text="sin", align=(:left, :bottom), cycle, fontsize=16) +text!(ax, 3π/4, cos(3π/4); text="cos", align=(:right, :top), cycle, fontsize=16) + +# save figure that will have a resolution of 300dpi at 12cm x 8cm size +save("my_12x8cm_figure.png", f; px_per_unit) +``` +![Demofigure for figure + font sizes](/assets/my_12x8cm_figure.png) diff --git a/assets/my_12x8cm_figure.png b/assets/my_12x8cm_figure.png new file mode 100644 index 0000000000000000000000000000000000000000..355462f3b2b4cff53467f6516cea538d77ea71c6 GIT binary patch literal 104819 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
H(EWCjfH*N$2 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 literal 0 HcmV?d00001 diff --git a/src/MakiePublicationTheme.jl b/src/MakiePublicationTheme.jl index 57c2d05..d62cec6 100644 --- a/src/MakiePublicationTheme.jl +++ b/src/MakiePublicationTheme.jl @@ -3,7 +3,9 @@ module MakiePublicationTheme using Makie include("publication_theme.jl") - export publication_theme +include("figure_sizes.jl") +export size_vectorgraphic, size_pixelgraphic + end diff --git a/src/figure_sizes.jl b/src/figure_sizes.jl new file mode 100644 index 0000000..d0710be --- /dev/null +++ b/src/figure_sizes.jl @@ -0,0 +1,73 @@ +""" + size_vectorgraphic(size; unit=:cm) + +Compute the required figure size and `pt_per_unit` for a given physical size in `:cm` or +`:inch`. The (physical) font size will be the same as set in the theme, i.e. the default is +10 pt. + +Example: +```@example +using MakiePublicationTheme +using CairoMakie + +size_cm = (12.0, 8.0) +size, pt_per_unit = size_vectorgraphic(size_cm) + +f = Figure(; size) +# lots of plotting here +save("my_12x8cm_figure.pdf", f; pt_per_unit) +``` + +More information about matching figure and font sizes can be found in the +[Makie documentation](https://docs.makie.org/v0.21/explanations/figure#Matching-figure-and-font-sizes-to-documents). +""" +function size_vectorgraphic(size; unit=:cm) + if unit == :cm + size_pt = size ./ 2.54 .* 72.0 + elseif unit == :inch + size_pt = size .* 72.0 + else + error("Unknown unit $unit.") + end + pt_per_unit = 1 + + return size_pt, pt_per_unit +end + +""" + size_pixelgraphic(size, dpi; unit=:cm) + +Compute the required figure size and `px_per_unit` at a resolution of `dpi` dots-per-inch +and for a given physical size in `:cm` or `:inch`. The (physical) font size will be the same +as set in the theme, i.e. the default is 10 pt. + +Example: +```@example +using MakiePublicationTheme +using CairoMakie + +size_cm = (12.0, 8.0) +dpi = 600 +size, px_per_unit = size_pixelgraphic(size_cm, dpi) + +f = Figure(; size) +# lots of plotting here +save("my_12x8cm_figure.png", f; px_per_unit) +``` + +More information about matching figure and font sizes can be found in the +[Makie documentation](https://docs.makie.org/v0.21/explanations/figure#Matching-figure-and-font-sizes-to-documents). +""" +function size_pixelgraphic(size, dpi; unit=:cm) + if unit == :cm + size_inch = size ./ 2.54 + elseif unit == :inch + size_inch = size + else + error("Unknown unit $unit.") + end + size_pt = size_inch .* 72.0 + px_per_unit = first(size_inch) * dpi / first(size_pt) + + return size_pt, px_per_unit +end diff --git a/test/figure_size.jl b/test/figure_size.jl new file mode 100644 index 0000000..c19638b --- /dev/null +++ b/test/figure_size.jl @@ -0,0 +1,23 @@ +@testset "figure sizes" begin + size_inch = (5, 4) + size_cm = size_inch .* 2.54 + dpi = 600.0 + + # vector graphics + size_inchbased, pt_per_unit_inchbased = size_vectorgraphic(size_inch; unit=:inch) + @test size_inchbased == (360.0, 288.0) + @test pt_per_unit_inchbased == 1.0 + + size_cmbased, pt_per_unit_cmbased = size_vectorgraphic(size_cm; unit=:cm) + @test all(size_cmbased .≈ size_inchbased) + @test pt_per_unit_inchbased == 1.0 + + # pixel graphics + size_inchbased, px_per_unit_inchbased = size_pixelgraphic(size_inch, dpi; unit=:inch) + @test size_inchbased == (360.0, 288.0) + @test px_per_unit_inchbased == 25/3 + + size_cmbased, px_per_unit_cmbased = size_pixelgraphic(size_cm, dpi; unit=:cm) + @test all(size_cmbased .≈ size_inchbased) + @test px_per_unit_cmbased == 25/3 +end diff --git a/test/runtests.jl b/test/runtests.jl index 5738244..659df61 100644 --- a/test/runtests.jl +++ b/test/runtests.jl @@ -3,4 +3,5 @@ using Test @testset "MakiePublicationTheme.jl" begin include("makie_demofigure.jl") + include("figure_size.jl") end