Style Reference

FigRecipe supports customizable styles for publication-ready figures. This page documents the style parameters and their defaults.

Style Anatomy

The following diagram shows all configurable style parameters on a figure:

Style Parameters

Figure Settings

Parameter	Default	Description
`dpi`	300	Output resolution in dots per inch
`format`	pdf	Default output format (png, pdf, svg)
`facecolor`	white	Figure background color

Axes Settings

Parameter	Default	Description
`axes_size_mm`	[40, 28]	Default axes size in millimeters [width, height]
`axes_linewidth_mm`	0.2	Axes border thickness in mm

Labels and Title

Parameter	Default	Description
`title_pt`	8	Title font size in points
`title_pad`	4	Title padding from axes in points
`axis_label_pt`	7	Axis label font size in points
`axis_label_pad`	2	Axis label padding in points

Ticks

Parameter	Default	Description
`tick_label_pt`	7	Tick label font size in points
`tick_length_mm`	0.8	Major tick length in mm
`tick_width_mm`	0.2	Tick line width in mm
`tick_direction`	out	Tick direction (in, out, inout)
`n_ticks`	3-4	Target number of major ticks per axis
`minor_tick_color`	0.25	Minor tick label color (gray value)

Lines and Markers

Parameter	Default	Description
`trace_mm`	0.12	Default line width in mm
`scatter_mm`	0.8	Default marker size in mm
`marker_edge`	none	Marker edge style

Legend

Parameter	Default	Description
`legend_pt`	6	Legend font size in points
`legend_frameon`	false	Whether to show legend frame

Spines

Parameter	Default	Description
`spine_width_mm`	0.2	Spine line width in mm
`spine_visible`	[bottom, left]	Which spines are visible (top/right hidden by default)

Grid

Parameter	Default	Description
`grid`	false	Whether to show grid
`grid_linestyle`	–	Grid line style
`grid_linewidth`	0.5	Grid line width
`grid_color`	0.25	Grid color (gray value)

Loading Styles

Python API

import figrecipe as fr

# Load a preset style
fr.load_style("SCITEX")

# List available presets
presets = fr.list_presets()
print(presets)

# Unload style (return to matplotlib defaults)
fr.unload_style()

Available Presets

default - Basic clean style
SCITEX - Publication-ready scientific style (recommended)
SCITEX_DARK - Dark mode variant

Custom Styles

You can create custom styles by providing a dictionary:

custom_style = {
    "figure": {
        "dpi": 300,
        "facecolor": "white",
    },
    "axes": {
        "linewidth_mm": 0.3,
    },
    "fonts": {
        "title_pt": 10,
        "axis_label_pt": 8,
    },
    "ticks": {
        "direction": "in",
        "length_mm": 1.0,
    },
}

fr.load_style(custom_style)