Vindaar · Vindaar · Feb 11, 2024 · Oct 21, 2023 · Oct 21, 2023 · Oct 21, 2023
diff --git a/changelog.org b/changelog.org
@@ -1,3 +1,80 @@
+* v0.7.0
+This release is a rather big one. The majority of features added
+relates to customization of plots.
+~Theme~ related improvements:
+- ~baseLabelMargin~ field to adjust the default range between tick
+  labels and labels in cm.
+- allow adjustment of plot size via ~Theme~
+- adjustment of annotation font via ~Theme~
+- scale grid lines via ~Theme~
+- add ~themeLatex~, a very useful helper when producing PDF plots via
+  TikZ where the actual target is a TeX file. Its argument ~fWidth~
+  combined with ~width~ (in pixel), ~textWidth~ (in pt of the actual
+  ~\textwidth~ of the LaTeX document to be inserted) it allows to
+  exactly specify font sizes of plots such that they match a given
+  size in the resulting PDF. E.g. a plot to be inserted at
+  ~0.9\textwidth~ using ~fWidth = 0.9~, a plot size of e.g. ~width =
+  600~ pixel (for the standalone plot) and a ~textWidth~ of ~450 pt~
+  (LaTeX pt) produces a resulting PDF after inserting the plot at the
+  ~0.9\textwidth~ that matches exactly the font sizes given by
+  ~ggplotnim~. The ~baseTheme~ is an argument of a procedure that
+  returns the desired ~Theme~ to be used as a base.
+  - ~singlePlot~ and ~sideBySide~ are two ~baseTheme~ procedures that
+    produce nice looking graphs when inserting as a single or 2
+    side-by-side setup in a TeX file.
+- add ~coord_fixed~ option that creates the actual data portion of the
+  plot in fixed ratio. E.g. an argument of ~1.0~ creates a plot of
+  user given ~width~ where the height is computed precisely such that
+  the data portion is of ratio 1:1. Useful for physical coordinates in
+  a plot to correspond to the desired ratio.
+- allow setting ~useTeX~ argument via ~Theme~ (to enable/disable TikZ
+  backend)
+- allow hiding x or y labels individually
+- adjust styling of ridgeline plots
+- add ~cool~ colormap
+- fields ~discrete/continuousLegendWidth/Height~ fields to ~Theme~ to
+  adjust the size of continuous / discrete legends
+- add helper to add two ~Themes~ via ~+~
+- respect user set margins in facet plots
+- add ~tomlTheme~ to set a theme at runtime from a TOML file. Example
+  given in PR description (PR #176)
+- draw histograms as lines in discrete legends
+- add ~hideTitle~ to disable title (among other ~hide~ procedures)    
+
+- add ~dataAsBitmap~ feature for Cairo, TikZ backend. In a vector
+  graphic target will draw all the actual data as a PNG, similar to in
+  a raster plot. This makes plots with large amounts of data as a
+  vector graphic feasible.
+- make ~aes~ arguments to initial ~ggplot~ call optional. This of
+  course implies arguments to ~geom_*~ calls are mandatory. There is a
+  chance this is a breaking change in some contexts and decreases
+  CT safety to some extent. But it can be very useful when combining
+  different geoms that don't share column names as well as using
+  different aesthetics.  
+- add experimental (CT + RT) option ~WritePlotCsv~. If compiled with
+  ~-d:WritePlotCsv~ and then a ~WRITE_PLOT_CSV=true~ environment
+  variable set, ~ggplotnim~ will write CSV files for every plot
+  produced. The filename is the filename of the plot with ~.csv~
+  suffix. For each geom that has a separate dataframe an extra CSV
+  file is produced. This allows for easy sharing of data that is used
+  to produce a plot.
+- add ~TEXT_PRECISION~ environment variable check for ~geom_text~ to
+  adjust the precision used for floating point numbers.  
+- allow assignment of facets in user given order by ~order~ argument
+  to ~facet_wrap~
+- add option ~gradient~ opposite to ~factor~ to force an aesthetic argument to
+  be continuous
+- adjust data scale in ~scale_fill/color_continuous/gradient~ procs
+- allow annotations to be placed at ~top/right~ positions in addition
+  to ~left/bottom~
+- fixes to raster plots with other geoms resulting in bad data ranges
+- better support for histograms with minimal values != 0
+- use ~expandTilde~ in ~ggsave~
+- improve logic detecting discreteness of arguments  
+- better exception message when color parsing fails
+- refactoring of facet logic
+- fixes to legend heights in some setups
+- better date logic for non facet plots  
 * v0.6.3
 - allow adjustment of title position in relative coordinates using
   ~titlePosition~
@@ -12,7 +89,23 @@
   sizes etc. by a factor. Useful to effectively change the DPI of the
   figure.
 - add experimental ~theme_font_scale~ which acts like ~theme_scale~,
-  but does not adjust the base scale (related to scaling the margins)  
+  but does not adjust the base scale (related to scaling the margins)
+- allow to assign custom order in ~facet_wrap~ based on a ~order:
+  seq[Value]~ argument
+- add new feature helping with reproducibility of plots: 
+  If compiled with ~-d:WritePlotCsv~ ~ggplotnim~ now provides the option to automatically
+  write out CSV files for input DF for each plot that is created (if
+  enabled via environment variable ~WRITE_PLOT_CSV=true~). Also all
+  DFs associated with individual geoms will be written with a geom
+  specific suffix.
+- fix ~geom_raster~ when used in conjunction with another geom that
+  has a larger data range
+- allow adjustment of margin used by default between the tick labels
+  and the labels. Default is 0.3 cm, can be changed using
+  ~baseLabelMargin~ proc / ~Theme~ field
+- improve logic for histograms in the case where the minimum viewport
+  is not 0, which can happen for custom ~ylim~ calls (for example for
+  manual log10 histograms via ~stat = "identity"~)
 * v0.6.2
 - handle geom calls with constant values better. Previously we
   sometimes ended up drawing the same e.g. text multiple times, once

diff --git a/ggplotnim.nimble b/ggplotnim.nimble
@@ -10,11 +10,12 @@ srcDir        = "src"
 
 requires "nim >= 1.0.0"
 requires "https://github.com/Vindaar/seqmath >= 0.1.16"
-requires "ginger == 0.5.3"
-requires "datamancer >= 0.3.2"
+requires "ginger == 0.6.1"
+requires "datamancer >= 0.4.0"
 requires "arraymancer >= 0.7.22"
 requires "shell >= 0.4.3"
 requires "webview"
+requires "parsetoml"
 requires "https://github.com/SciNim/scinim >= 0.1.0"
 
 task testCI, "Run standard tests w/o cairo dependency":
@@ -126,5 +127,5 @@ task generateAll, "Generate all output files (requires lualatex, inkscape)":
   exec "nim c -r recipes/rTikZLandau.nim" # generate `.tex` file for Landau
   exec "lualatex --shell-escape media/recipes/rTikZLandau.tex"
   exec "inkscape --export-type=png --pdf-poppler rTikZLandau.pdf"
-  exec "mv rTikZLandau.pdf.png media/recipes/rTikZLandau.png"
+  exec "mv rTikZLandau.png media/recipes/rTikZLandau.png"
   exec "rm rTikZLandau.pdf rTikZLandau.aux rTikZLandau.log"
diff --git a/media/expected/rAnnotateMaxValues.png b/media/expected/rAnnotateMaxValues.png
diff --git a/media/expected/rAnnotateUsingGeomText.png b/media/expected/rAnnotateUsingGeomText.png
diff --git a/media/expected/rAnnotatedHeatmap.png b/media/expected/rAnnotatedHeatmap.png
diff --git a/media/expected/rAutoColoredNeuralSpikes.png b/media/expected/rAutoColoredNeuralSpikes.png
diff --git a/media/expected/rAxionMassVsDensity.png b/media/expected/rAxionMassVsDensity.png
diff --git a/media/expected/rAxionMassesLogLog.png b/media/expected/rAxionMassesLogLog.png
diff --git a/media/expected/rBarPlotCompStats.png b/media/expected/rBarPlotCompStats.png
diff --git a/media/expected/rBarPlotRotatedLabels.png b/media/expected/rBarPlotRotatedLabels.png
diff --git a/media/expected/rBothDiscreteAxes.png b/media/expected/rBothDiscreteAxes.png
diff --git a/media/expected/rClassifiedGeomText.png b/media/expected/rClassifiedGeomText.png
diff --git a/media/expected/rColormaps.png b/media/expected/rColormaps.png
diff --git a/media/expected/rCreateMarginBuffer.png b/media/expected/rCreateMarginBuffer.png
diff --git a/media/expected/rCustomAnnotations.png b/media/expected/rCustomAnnotations.png
diff --git a/media/expected/rCustomBreaks.png b/media/expected/rCustomBreaks.png
diff --git a/media/expected/rCustomColoredNeuralSpikes.png b/media/expected/rCustomColoredNeuralSpikes.png
diff --git a/media/expected/rCustomColormap.png b/media/expected/rCustomColormap.png
diff --git a/media/expected/rCustomFill.png b/media/expected/rCustomFill.png
diff --git a/media/expected/rCustomMargins.png b/media/expected/rCustomMargins.png
diff --git a/media/expected/rDiscreteXLine.png b/media/expected/rDiscreteXLine.png
diff --git a/media/expected/rDiscreteYAxis.png b/media/expected/rDiscreteYAxis.png
diff --git a/media/expected/rEnlargeXRange.png b/media/expected/rEnlargeXRange.png
diff --git a/media/expected/rErrorBar.png b/media/expected/rErrorBar.png
diff --git a/media/expected/rFacetRaster.png b/media/expected/rFacetRaster.png
diff --git a/media/expected/rFacetTpa.png b/media/expected/rFacetTpa.png
diff --git a/media/expected/rFormatDatesPlot.png b/media/expected/rFormatDatesPlot.png
diff --git a/media/expected/rFormatDecimalsPlot.png b/media/expected/rFormatDecimalsPlot.png
diff --git a/media/expected/rFormulaAesthetic.png b/media/expected/rFormulaAesthetic.png
diff --git a/media/expected/rFreqPolyWithAlpha.png b/media/expected/rFreqPolyWithAlpha.png
diff --git a/media/expected/rGeomSmooth.png b/media/expected/rGeomSmooth.png
diff --git a/media/expected/rHighlightMinMax.png b/media/expected/rHighlightMinMax.png
diff --git a/media/expected/rHistogramDensity.png b/media/expected/rHistogramDensity.png
diff --git a/media/expected/rHistogramOutline.png b/media/expected/rHistogramOutline.png
diff --git a/media/expected/rLimitXRange.png b/media/expected/rLimitXRange.png
diff --git a/media/expected/rLinePlotSize.png b/media/expected/rLinePlotSize.png
diff --git a/media/expected/rLinearFit.png b/media/expected/rLinearFit.png
diff --git a/media/expected/rLongTitleMultiline.png b/media/expected/rLongTitleMultiline.png
diff --git a/media/expected/rMassAttenuationFunction.png b/media/expected/rMassAttenuationFunction.png
diff --git a/media/expected/rMpgContinuousColorPoints.png b/media/expected/rMpgContinuousColorPoints.png
diff --git a/media/expected/rMpgCustomColorPoint.png b/media/expected/rMpgCustomColorPoint.png
diff --git a/media/expected/rMpgDiscreteXScale.png b/media/expected/rMpgDiscreteXScale.png
diff --git a/media/expected/rMpgHistoBinWidth.png b/media/expected/rMpgHistoBinWidth.png
diff --git a/media/expected/rMpgHistoCustomBreaks.png b/media/expected/rMpgHistoCustomBreaks.png
diff --git a/media/expected/rMpgHistoNumBins.png b/media/expected/rMpgHistoNumBins.png
diff --git a/media/expected/rMpgHistoPlusPoints.png b/media/expected/rMpgHistoPlusPoints.png
diff --git a/media/expected/rMpgSimpleBarPlot.png b/media/expected/rMpgSimpleBarPlot.png
diff --git a/media/expected/rMpgStackedBarPlot.png b/media/expected/rMpgStackedBarPlot.png
diff --git a/media/expected/rMpgStackedPointPlot.png b/media/expected/rMpgStackedPointPlot.png
diff --git a/media/expected/rMultiSubplots.png b/media/expected/rMultiSubplots.png
diff --git a/media/expected/rMultipleLegends.png b/media/expected/rMultipleLegends.png
diff --git a/media/expected/rNegativeBarPlot.png b/media/expected/rNegativeBarPlot.png
diff --git a/media/expected/rNewtonAcceleration.png b/media/expected/rNewtonAcceleration.png
diff --git a/media/expected/rPeriodicTable.png b/media/expected/rPeriodicTable.png
diff --git a/media/expected/rPointInPolygons.png b/media/expected/rPointInPolygons.png
diff --git a/media/expected/rPrebinnedHisto.png b/media/expected/rPrebinnedHisto.png
diff --git a/media/expected/rRidgeLineGauss.png b/media/expected/rRidgeLineGauss.png
diff --git a/media/expected/rScaleXDate.png b/media/expected/rScaleXDate.png
diff --git a/media/expected/rSimpleFacet.png b/media/expected/rSimpleFacet.png
diff --git a/media/expected/rSimpleGeomText.png b/media/expected/rSimpleGeomText.png
diff --git a/media/expected/rSimpleLinePlot.png b/media/expected/rSimpleLinePlot.png
diff --git a/media/expected/rSimpleRaster.png b/media/expected/rSimpleRaster.png
diff --git a/media/expected/rSimpleTile.png b/media/expected/rSimpleTile.png
diff --git a/media/expected/rSimpleVegaLite.png b/media/expected/rSimpleVegaLite.png
diff --git a/media/expected/rStackedMpgFreqpoly.png b/media/expected/rStackedMpgFreqpoly.png
diff --git a/media/expected/rStackedMpgHistogram.png b/media/expected/rStackedMpgHistogram.png
diff --git a/media/expected/rTikZLandau.png b/media/expected/rTikZLandau.png
diff --git a/media/expected/rTwoSensorsBadStyle.png b/media/expected/rTwoSensorsBadStyle.png
diff --git a/media/expected/rTwoSensorsGoodStyle.png b/media/expected/rTwoSensorsGoodStyle.png
diff --git a/media/expected/rWeightedHistogram.png b/media/expected/rWeightedHistogram.png
diff --git a/media/recipes/rAnnotateMaxValues.png b/media/recipes/rAnnotateMaxValues.png
diff --git a/media/recipes/rAnnotateUsingGeomText.png b/media/recipes/rAnnotateUsingGeomText.png
diff --git a/media/recipes/rAnnotatedHeatmap.png b/media/recipes/rAnnotatedHeatmap.png
diff --git a/media/recipes/rAutoColoredNeuralSpikes.png b/media/recipes/rAutoColoredNeuralSpikes.png
diff --git a/media/recipes/rAxionMassVsDensity.png b/media/recipes/rAxionMassVsDensity.png
diff --git a/media/recipes/rAxionMassesLogLog.png b/media/recipes/rAxionMassesLogLog.png
diff --git a/media/recipes/rBarPlotCompStats.png b/media/recipes/rBarPlotCompStats.png
diff --git a/media/recipes/rBarPlotRotatedLabels.png b/media/recipes/rBarPlotRotatedLabels.png
diff --git a/media/recipes/rBothDiscreteAxes.png b/media/recipes/rBothDiscreteAxes.png
diff --git a/media/recipes/rClassifiedGeomText.png b/media/recipes/rClassifiedGeomText.png
diff --git a/media/recipes/rColormaps.png b/media/recipes/rColormaps.png
diff --git a/media/recipes/rCreateMarginBuffer.png b/media/recipes/rCreateMarginBuffer.png
diff --git a/media/recipes/rCustomAnnotations.png b/media/recipes/rCustomAnnotations.png
diff --git a/media/recipes/rCustomBreaks.png b/media/recipes/rCustomBreaks.png
diff --git a/media/recipes/rCustomColoredNeuralSpikes.png b/media/recipes/rCustomColoredNeuralSpikes.png
diff --git a/media/recipes/rCustomColormap.png b/media/recipes/rCustomColormap.png
diff --git a/media/recipes/rCustomFill.png b/media/recipes/rCustomFill.png
diff --git a/media/recipes/rCustomMargins.png b/media/recipes/rCustomMargins.png
diff --git a/media/recipes/rDiscreteXLine.png b/media/recipes/rDiscreteXLine.png
diff --git a/media/recipes/rDiscreteYAxis.png b/media/recipes/rDiscreteYAxis.png
diff --git a/media/recipes/rEnlargeXRange.png b/media/recipes/rEnlargeXRange.png
diff --git a/media/recipes/rErrorBar.png b/media/recipes/rErrorBar.png
diff --git a/media/recipes/rFacetRaster.png b/media/recipes/rFacetRaster.png
diff --git a/media/recipes/rFacetTpa.png b/media/recipes/rFacetTpa.png
diff --git a/media/recipes/rFormatDatesPlot.png b/media/recipes/rFormatDatesPlot.png
diff --git a/media/recipes/rFormatDecimalsPlot.png b/media/recipes/rFormatDecimalsPlot.png
diff --git a/media/recipes/rFormulaAesthetic.png b/media/recipes/rFormulaAesthetic.png
diff --git a/media/recipes/rFreqPolyWithAlpha.png b/media/recipes/rFreqPolyWithAlpha.png
diff --git a/media/recipes/rGeomSmooth.png b/media/recipes/rGeomSmooth.png
diff --git a/media/recipes/rHighlightMinMax.png b/media/recipes/rHighlightMinMax.png
diff --git a/media/recipes/rHistogramDensity.png b/media/recipes/rHistogramDensity.png
diff --git a/media/recipes/rHistogramOutline.png b/media/recipes/rHistogramOutline.png
diff --git a/media/recipes/rLimitXRange.png b/media/recipes/rLimitXRange.png
diff --git a/media/recipes/rLinePlotSize.png b/media/recipes/rLinePlotSize.png
diff --git a/media/recipes/rLinearFit.png b/media/recipes/rLinearFit.png
diff --git a/media/recipes/rLongTitleMultiline.png b/media/recipes/rLongTitleMultiline.png
diff --git a/media/recipes/rMassAttenuationFunction.png b/media/recipes/rMassAttenuationFunction.png
diff --git a/media/recipes/rMpgContinuousColorPoints.png b/media/recipes/rMpgContinuousColorPoints.png
diff --git a/media/recipes/rMpgCustomColorPoint.png b/media/recipes/rMpgCustomColorPoint.png
diff --git a/media/recipes/rMpgDiscreteXScale.png b/media/recipes/rMpgDiscreteXScale.png
diff --git a/media/recipes/rMpgHistoBinWidth.png b/media/recipes/rMpgHistoBinWidth.png
diff --git a/media/recipes/rMpgHistoCustomBreaks.png b/media/recipes/rMpgHistoCustomBreaks.png
diff --git a/media/recipes/rMpgHistoNumBins.png b/media/recipes/rMpgHistoNumBins.png
diff --git a/media/recipes/rMpgHistoPlusPoints.png b/media/recipes/rMpgHistoPlusPoints.png
diff --git a/media/recipes/rMpgSimpleBarPlot.png b/media/recipes/rMpgSimpleBarPlot.png
diff --git a/media/recipes/rMpgStackedBarPlot.png b/media/recipes/rMpgStackedBarPlot.png
diff --git a/media/recipes/rMpgStackedPointPlot.png b/media/recipes/rMpgStackedPointPlot.png
diff --git a/media/recipes/rMultiSubplots.png b/media/recipes/rMultiSubplots.png
diff --git a/media/recipes/rMultipleLegends.png b/media/recipes/rMultipleLegends.png
diff --git a/media/recipes/rNegativeBarPlot.png b/media/recipes/rNegativeBarPlot.png
diff --git a/media/recipes/rNewtonAcceleration.png b/media/recipes/rNewtonAcceleration.png
diff --git a/media/recipes/rPeriodicTable.png b/media/recipes/rPeriodicTable.png
diff --git a/media/recipes/rPointInPolygons.png b/media/recipes/rPointInPolygons.png
diff --git a/media/recipes/rPrebinnedHisto.png b/media/recipes/rPrebinnedHisto.png
diff --git a/media/recipes/rRidgeLineGauss.png b/media/recipes/rRidgeLineGauss.png
diff --git a/media/recipes/rScaleXDate.png b/media/recipes/rScaleXDate.png
diff --git a/media/recipes/rSimpleFacet.png b/media/recipes/rSimpleFacet.png
diff --git a/media/recipes/rSimpleGeomText.png b/media/recipes/rSimpleGeomText.png
diff --git a/media/recipes/rSimpleLinePlot.png b/media/recipes/rSimpleLinePlot.png
diff --git a/media/recipes/rSimpleRaster.png b/media/recipes/rSimpleRaster.png
diff --git a/media/recipes/rSimpleTile.png b/media/recipes/rSimpleTile.png
diff --git a/media/recipes/rStackedMpgFreqpoly.png b/media/recipes/rStackedMpgFreqpoly.png
diff --git a/media/recipes/rStackedMpgHistogram.png b/media/recipes/rStackedMpgHistogram.png
diff --git a/media/recipes/rTikZLandau.png b/media/recipes/rTikZLandau.png
diff --git a/media/recipes/rTikZLandau.tex b/media/recipes/rTikZLandau.tex
@@ -1,12 +1,15 @@
 \documentclass[tikz,border=0mm]{standalone}
 \usepackage[utf8]{inputenc}
-\usepackage{unicode-math}
+\usepackage{unicode-math} % for unicode support in math environments
 \usepackage{amsmath}
 \usepackage{siunitx}
+\usepackage{booktabs}
+\sisetup{mode=text,range-phrase = {\text{~to~}}, range-units=single, print-unity-mantissa=false}
 \usepackage{mhchem}
 \usepackage{tikz}
 
 
+
 \begin{document}
 \definecolor{backgroundColor}{rgb}{1.0, 1.0, 1.0}
 
@@ -20,7 +23,7 @@
 
 \draw [color = drawColor, fill = fillColor, draw opacity = 0.0, fill opacity = 1.0, line width = 0.0bp] (0.0000bp, 480.0000bp) rectangle (640.0000bp, 0.0000bp) ;
 \node [right, font=\fontsize{16.0}{19.2}\selectfont
-, anchor=west] at (70.8661bp, 464.2537bp){Approximation of Landau distribution: $p(x) \approx \frac{1}{\sqrt{2π}} \exp\left(- \frac{x + e^{-x}}{2} \right)$} ;
+, anchor=west] at (70.8661bp, 463.5125bp){Approximation of Landau distribution: $p(x) \approx \frac{1}{\sqrt{2π}} \exp\left(- \frac{x + e^{-x}}{2} \right)$} ;
 \definecolor{drawColor}{rgb}{0.0, 0.0, 0.0}
 \definecolor{fillColor}{rgb}{0.9200000166893005, 0.9200000166893005, 0.9200000166893005}
 
@@ -34,37 +37,37 @@
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (464.1661bp, 51.6929bp)--(464.1661bp, 56.6929bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (587.0723bp, 51.6929bp)--(587.0723bp, 56.6929bp) ;
 \node [font=\fontsize{8.0}{9.6}\selectfont
-] at (95.4474bp, 45.7962bp){-5} ;
+] at (95.4474bp, 46.3613bp){-5} ;
 \node [font=\fontsize{8.0}{9.6}\selectfont
-] at (218.3536bp, 45.7962bp){0} ;
+] at (218.3536bp, 46.3319bp){0} ;
 \node [font=\fontsize{8.0}{9.6}\selectfont
-] at (341.2598bp, 45.7962bp){5} ;
+] at (341.2598bp, 46.3613bp){5} ;
 \node [font=\fontsize{8.0}{9.6}\selectfont
-] at (464.1661bp, 45.7962bp){10} ;
+] at (464.1661bp, 46.3319bp){10} ;
 \node [font=\fontsize{8.0}{9.6}\selectfont
-] at (587.0723bp, 45.7962bp){15} ;
+] at (587.0723bp, 46.3535bp){15} ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 56.6929bp)--(65.8661bp, 56.6929bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 135.6850bp)--(65.8661bp, 135.6850bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 214.6772bp)--(65.8661bp, 214.6772bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 293.6693bp)--(65.8661bp, 293.6693bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 372.6614bp)--(65.8661bp, 372.6614bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 451.6535bp)--(65.8661bp, 451.6535bp) ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 56.6929bp){0} ;
+, anchor=east] at (63.1381bp, 56.6929bp){0} ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 135.6850bp){0.05} ;
+, anchor=east] at (63.1381bp, 135.6850bp){0.05} ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 214.6772bp){0.1} ;
+, anchor=east] at (63.1381bp, 214.6772bp){0.1} ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 293.6693bp){0.15} ;
+, anchor=east] at (63.1381bp, 293.6693bp){0.15} ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 372.6614bp){0.2} ;
+, anchor=east] at (63.1381bp, 372.6614bp){0.2} ;
 \node [left, font=\fontsize{8.0}{9.6}\selectfont
-, anchor=east] at (62.6394bp, 451.6535bp){0.25} ;
+, anchor=east] at (63.1381bp, 451.6535bp){0.25} ;
 \node [font=\fontsize{12.0}{14.4}\selectfont
-] at (341.2598bp, 28.3465bp){x} ;
+] at (341.2598bp, 26.2053bp){x} ;
 \node [rotate = 90.0, font=\fontsize{12.0}{14.4}\selectfont
-] at (33.0283bp, 254.1732bp){y} ;
+] at (33.9522bp, 254.1732bp){y} ;
 \definecolor{drawColor}{rgb}{1.0, 1.0, 1.0}
 \definecolor{fillColor}{rgb}{0.0, 0.0, 0.0}
 
@@ -80,7 +83,12 @@
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 372.6614bp)--(611.6535bp, 372.6614bp) ;
 \draw [color = drawColor, fill = fillColor, draw opacity = 1.0, fill opacity = 0.0, line width = 1.0bp] (70.8661bp, 451.6535bp)--(611.6535bp, 451.6535bp) ;
 \node [right, rotate = -0.0, font=\fontsize{12.0}{14.4}\selectfont
-, align=left] at (341.2598bp, 223.7903bp){The Landau distribution\\ \\ $p(x) = \frac{1}{2πi}\int_{a-i∞}^{a+i∞} e^{s \log(s) + xs}\, ds$\\ \\reduces to the approximation:\\ \\ $p(x) \approx \frac{1}{\sqrt{2π}} \exp\left(- \frac{x + e^{-x}}{2} \right)$\\ \\ for $μ = 0, c = 1$} ;
+, anchor=south west] at (341.2598bp, 214.6772bp){
+\begin{tabular}{@{}l@{}}
+The Landau distribution\\\\$p(x) = \frac{1}{2πi}\int_{a-i∞}^{a+i∞} e^{s \log(s) + xs}\, ds$\\\\reduces to the approximation:\\\\$p(x) \approx \frac{1}{\sqrt{2π}} \exp\left(- \frac{x + e^{-x}}{2} \right)$\\\\for $μ = 0, c = 1$
+\end{tabular}
+
+} ;
 \definecolor{drawColor}{rgb}{0.2000000029802322, 0.2000000029802322, 0.2000000029802322}
 \definecolor{fillColor}{rgb}{0.0, 0.0, 0.0}
 

diff --git a/media/recipes/rTwoSensorsBadStyle.png b/media/recipes/rTwoSensorsBadStyle.png
diff --git a/media/recipes/rTwoSensorsGoodStyle.png b/media/recipes/rTwoSensorsGoodStyle.png
diff --git a/media/recipes/rWeightedHistogram.png b/media/recipes/rWeightedHistogram.png
diff --git a/recipes.org b/recipes.org
@@ -982,7 +982,7 @@ for i in 0 ..< 5:
   df.add toDf({"x" : xs, "y" : i })
 
 for scale in [viridis(), magma(), plasma(), inferno()]:
-  plts.add ggplot(df, aes("x", "y", fill = "x")) +
+  plts.add ggplot(df, aes("x", "y", fill = "x"), backend = bkCairo, fType = fkPng) +
     scale_fill_gradient(scale) + # assign the correct scale
     geom_raster() +
     ylim(0, 5) +   # due to our weird data (height deduced as 1, set correct limits)
@@ -1220,15 +1220,15 @@ let df = toDf({ "t" : t,
                     "Im x(t)" : y2 })
 let plt1 = ggcreate(
   ggplot(df, aes("t", "Re x(t)"),
-         backend = bkCairo) + # tell `ggsave` we wish to create the plot on the cairo backend
+         backend = bkCairo, fType = fkPng) + # tell `ggsave` we wish to create the plot on the cairo backend and as a PNG 
     geom_line() + 
     xlim(-0.02, 0.05) + 
     ggtitle("Real part of x(t)=e^{j 100 π t}"),
   width = 800, height = 300
 )
 let plt2 = ggcreate(
   ggplot(df, aes("t", "Im x(t)"),
-         backend = bkCairo) +
+         backend = bkCairo, fType = fkPng) +
     geom_line() + 
     xlim(-0.02, 0.05) + 
     ggtitle("Imaginary part of x(t)=e^{j 100 π t}"),

diff --git a/recipes/rColormaps.nim b/recipes/rColormaps.nim
@@ -10,7 +10,7 @@ for i in 0 ..< 5:
   df.add toDf({"x" : xs, "y" : i })
 
 for scale in [viridis(), magma(), plasma(), inferno()]:
-  plts.add ggplot(df, aes("x", "y", fill = "x")) +
+  plts.add ggplot(df, aes("x", "y", fill = "x"), backend = bkCairo, fType = fkPng) +
     scale_fill_gradient(scale) + # assign the correct scale
     geom_raster() +
     ylim(0, 5) +   # due to our weird data (height deduced as 1, set correct limits)

diff --git a/recipes/rMultiSubplots.nim b/recipes/rMultiSubplots.nim
@@ -7,15 +7,15 @@ let df = toDf({ "t" : t,
                     "Im x(t)" : y2 })
 let plt1 = ggcreate(
   ggplot(df, aes("t", "Re x(t)"),
-         backend = bkCairo) + # tell `ggsave` we wish to create the plot on the cairo backend
+         backend = bkCairo, fType = fkPng) + # tell `ggsave` we wish to create the plot on the cairo backend and as a PNG 
     geom_line() + 
     xlim(-0.02, 0.05) + 
     ggtitle("Real part of x(t)=e^{j 100 π t}"),
   width = 800, height = 300
 )
 let plt2 = ggcreate(
   ggplot(df, aes("t", "Im x(t)"),
-         backend = bkCairo) +
+         backend = bkCairo, fType = fkPng) +
     geom_line() + 
     xlim(-0.02, 0.05) + 
     ggtitle("Imaginary part of x(t)=e^{j 100 π t}"),

diff --git a/resources/expected/rAnnotateMaxValues.json b/resources/expected/rAnnotateMaxValues.json
diff --git a/resources/expected/rAnnotateUsingGeomText.json b/resources/expected/rAnnotateUsingGeomText.json
diff --git a/resources/expected/rAnnotatedHeatmap.json b/resources/expected/rAnnotatedHeatmap.json
diff --git a/resources/expected/rAutoColoredNeuralSpikes.json b/resources/expected/rAutoColoredNeuralSpikes.json
diff --git a/resources/expected/rAxionMassVsDensity.json b/resources/expected/rAxionMassVsDensity.json
diff --git a/resources/expected/rAxionMassesLogLog.json b/resources/expected/rAxionMassesLogLog.json
diff --git a/resources/expected/rBarPlotCompStats.json b/resources/expected/rBarPlotCompStats.json
diff --git a/resources/expected/rBarPlotRotatedLabels.json b/resources/expected/rBarPlotRotatedLabels.json
diff --git a/resources/expected/rBothDiscreteAxes.json b/resources/expected/rBothDiscreteAxes.json
diff --git a/resources/expected/rClassifiedGeomText.json b/resources/expected/rClassifiedGeomText.json
diff --git a/resources/expected/rCreateMarginBuffer.json b/resources/expected/rCreateMarginBuffer.json
diff --git a/resources/expected/rCustomAnnotations.json b/resources/expected/rCustomAnnotations.json
diff --git a/resources/expected/rCustomBreaks.json b/resources/expected/rCustomBreaks.json
diff --git a/resources/expected/rCustomColoredNeuralSpikes.json b/resources/expected/rCustomColoredNeuralSpikes.json
diff --git a/resources/expected/rCustomColormap.json b/resources/expected/rCustomColormap.json
diff --git a/resources/expected/rCustomFill.json b/resources/expected/rCustomFill.json
diff --git a/resources/expected/rCustomMargins.json b/resources/expected/rCustomMargins.json
diff --git a/resources/expected/rDiscreteXLine.json b/resources/expected/rDiscreteXLine.json
diff --git a/resources/expected/rDiscreteYAxis.json b/resources/expected/rDiscreteYAxis.json
diff --git a/resources/expected/rEnlargeXRange.json b/resources/expected/rEnlargeXRange.json
diff --git a/resources/expected/rErrorBar.json b/resources/expected/rErrorBar.json
diff --git a/resources/expected/rFacetRaster.json b/resources/expected/rFacetRaster.json
diff --git a/resources/expected/rFacetTpa.json b/resources/expected/rFacetTpa.json
diff --git a/resources/expected/rFormatDatesPlot.json b/resources/expected/rFormatDatesPlot.json
diff --git a/resources/expected/rFormatDecimalsPlot.json b/resources/expected/rFormatDecimalsPlot.json
diff --git a/resources/expected/rFormulaAesthetic.json b/resources/expected/rFormulaAesthetic.json
diff --git a/resources/expected/rFreqPolyWithAlpha.json b/resources/expected/rFreqPolyWithAlpha.json
diff --git a/resources/expected/rGeomSmooth.json b/resources/expected/rGeomSmooth.json
diff --git a/resources/expected/rHighlightMinMax.json b/resources/expected/rHighlightMinMax.json
diff --git a/resources/expected/rHistogramDensity.json b/resources/expected/rHistogramDensity.json
diff --git a/resources/expected/rHistogramOutline.json b/resources/expected/rHistogramOutline.json
diff --git a/resources/expected/rJoyplot.json b/resources/expected/rJoyplot.json
diff --git a/resources/expected/rLimitXRange.json b/resources/expected/rLimitXRange.json
diff --git a/resources/expected/rLinePlotSize.json b/resources/expected/rLinePlotSize.json
diff --git a/resources/expected/rLinearFit.json b/resources/expected/rLinearFit.json
diff --git a/resources/expected/rLongTitleMultiline.json b/resources/expected/rLongTitleMultiline.json
diff --git a/resources/expected/rMassAttenuationFunction.json b/resources/expected/rMassAttenuationFunction.json
diff --git a/resources/expected/rMpgContinuousColorPoints.json b/resources/expected/rMpgContinuousColorPoints.json
diff --git a/resources/expected/rMpgCustomColorPoint.json b/resources/expected/rMpgCustomColorPoint.json
diff --git a/resources/expected/rMpgDiscreteXScale.json b/resources/expected/rMpgDiscreteXScale.json
diff --git a/resources/expected/rMpgHistoBinWidth.json b/resources/expected/rMpgHistoBinWidth.json
diff --git a/resources/expected/rMpgHistoCustomBreaks.json b/resources/expected/rMpgHistoCustomBreaks.json
diff --git a/resources/expected/rMpgHistoNumBins.json b/resources/expected/rMpgHistoNumBins.json
diff --git a/resources/expected/rMpgHistoPlusPoints.json b/resources/expected/rMpgHistoPlusPoints.json
diff --git a/resources/expected/rMpgSimpleBarPlot.json b/resources/expected/rMpgSimpleBarPlot.json
diff --git a/resources/expected/rMpgStackedBarPlot.json b/resources/expected/rMpgStackedBarPlot.json
diff --git a/resources/expected/rMpgStackedPointPlot.json b/resources/expected/rMpgStackedPointPlot.json
diff --git a/resources/expected/rMultipleLegends.json b/resources/expected/rMultipleLegends.json
diff --git a/resources/expected/rNegativeBarPlot.json b/resources/expected/rNegativeBarPlot.json
diff --git a/resources/expected/rNewtonAcceleration.json b/resources/expected/rNewtonAcceleration.json
diff --git a/resources/expected/rPeriodicTable.json b/resources/expected/rPeriodicTable.json
diff --git a/resources/expected/rPointInPolygons.json b/resources/expected/rPointInPolygons.json
diff --git a/resources/expected/rPrebinnedHisto.json b/resources/expected/rPrebinnedHisto.json
diff --git a/resources/expected/rRidgeLineGauss.json b/resources/expected/rRidgeLineGauss.json
diff --git a/resources/expected/rRidgeLineGaussBlack.json b/resources/expected/rRidgeLineGaussBlack.json
diff --git a/resources/expected/rScaleXDate.json b/resources/expected/rScaleXDate.json
diff --git a/resources/expected/rSimpleFacet.json b/resources/expected/rSimpleFacet.json
diff --git a/resources/expected/rSimpleGeomText.json b/resources/expected/rSimpleGeomText.json
diff --git a/resources/expected/rSimpleLinePlot.json b/resources/expected/rSimpleLinePlot.json
diff --git a/resources/expected/rSimpleRaster.json b/resources/expected/rSimpleRaster.json
diff --git a/resources/expected/rSimpleTile.json b/resources/expected/rSimpleTile.json
diff --git a/resources/expected/rStackedMpgFreqpoly.json b/resources/expected/rStackedMpgFreqpoly.json
diff --git a/resources/expected/rStackedMpgHistogram.json b/resources/expected/rStackedMpgHistogram.json
diff --git a/resources/expected/rTwoSensorsBadStyle.json b/resources/expected/rTwoSensorsBadStyle.json
diff --git a/resources/expected/rTwoSensorsGoodStyle.json b/resources/expected/rTwoSensorsGoodStyle.json
diff --git a/resources/expected/rWeightedHistogram.json b/resources/expected/rWeightedHistogram.json