plot-io 0.1.0__py3-none-any.whl

plot_io/defaults.py

@@ -0,0 +1,766 @@
+"""Every default setting of plot_io, in one place: the default look.
+
+``DEFAULTS`` maps setting names to their default values:
+
+* bare names are inherited settings (fonts, colors, line width, number formats, palette,
+  …): a figure passes them to its plots, a plot to its series, unless set lower down;
+* ``"Class.name"`` is the default of one setting of one class.  A class without an entry
+  of its own uses its base class's (``Fill.alpha`` overrides ``Series.alpha``).
+
+Values are used as given, except functions, which are called with the object and give a
+default that depends on it (a title's size follows the plot's font size).  Styles are
+merged over the inherited settings.  ``None`` means unset (no value, inherit, or off);
+``"auto"`` means chosen when drawing by the rule that the setting's other defaults
+parametrize (``Axis.padding`` and ``Axis.auto_padding``, ``Axis.max_ticks`` and
+``Axis.tick_spacing``).
+"""
+
+from typing import Any
+
+__all__ = ["DEFAULTS", "OKABE_ITO", "inherited", "class_default", "default_of"]
+
+#: Okabe–Ito's eight colorblind-safe colors, extended with indigo and dark brown.  The
+#: two were chosen as the pair farthest (in Oklab) from every other color under normal
+#: vision and simulated protan, deutan and tritan vision; they stay farther apart than
+#: the closest Okabe–Ito pair.
+OKABE_ITO = ("#0072B2", "#E69F00", "#009E73", "#D55E00", "#CC79A7", "#56B4E9", "#F0E442",
+             "#000000", "#332288", "#661100")
+
+
+# -- defaults that depend on the object ----------------------------------------------------
+
+def figure_plot_width(f: Any) -> float:
+    """3 in, in the figure's unit."""
+    return 216.0 / f.points_per_unit
+
+
+def figure_plot_height(f: Any) -> float:
+    """2.25 in, in the figure's unit."""
+    return 162.0 / f.points_per_unit
+
+
+def figure_spacing(f: Any) -> float:
+    """10 pt, in the figure's unit."""
+    return 10.0 / f.points_per_unit
+
+
+def figure_margin(f: Any) -> float:
+    """4 pt, in the figure's unit."""
+    return 4.0 / f.points_per_unit
+
+
+def figure_title_size(t: Any) -> float:
+    """1.4 × the figure's font size."""
+    return 1.4 * t._figure.get("font_size")
+
+
+def figure_title_pad(t: Any) -> float:
+    """0.5 × the title's font size."""
+    return 0.5 * t.get("font_size")
+
+
+def figure_title_color(t: Any) -> Any:
+    """The figure's text color."""
+    return t._figure.get("text_color")
+
+
+def title_size(t: Any) -> float:
+    """1.2 × the plot's font size."""
+    return 1.2 * t._plot.get("font_size")
+
+
+def title_color(t: Any) -> Any:
+    """The plot's text color."""
+    return t._plot.get("text_color")
+
+
+def legend_title(g: Any) -> Any:
+    """The `group` column name, when there is one."""
+    return getattr(g._plot, "_legend_title", None)
+
+
+def legend_font_size(g: Any) -> float:
+    """The plot's font size."""
+    return g._plot.get("font_size")
+
+
+def legend_color(g: Any) -> Any:
+    """The plot's text color."""
+    return g._plot.get("text_color")
+
+
+def axis_font_size(a: Any) -> float:
+    """The axis font size."""
+    return a.get("font_size")
+
+
+def axis_minor_tick_length(a: Any) -> float:
+    """0.6 × `tick_length`."""
+    return 0.6 * a.get("tick_length")
+
+
+def axis_color(a: Any) -> Any:
+    """The text color."""
+    return a.get("text_color")
+
+
+def axis_part_color(a: Any) -> Any:
+    """The axis `color`."""
+    return a.get("color")
+
+
+def axis_side(a: Any) -> str:
+    """`bottom` for x, `left` for y."""
+    return "bottom" if a.role == "x" else "left"
+
+
+def axis_zero_line_color(a: Any) -> Any:
+    """The axis `line_color`."""
+    return a.get("line_color")
+
+
+def axis_zero_line_width(a: Any) -> float:
+    """The axis `line_width`."""
+    return a.get("line_width")
+
+
+def axis_minor_grid_color(a: Any) -> Any:
+    """`grid_color`."""
+    return a.get("grid_color")
+
+
+def axis_minor_grid_width(a: Any) -> float:
+    """0.5 × `grid_width`."""
+    return 0.5 * a.get("grid_width")
+
+
+def axis_minor_grid_style(a: Any) -> Any:
+    """`grid_style`."""
+    return a.get("grid_style")
+
+
+def colorbar_orientation(c: Any) -> str:
+    """`vertical` beside the axes or in a grid area, `horizontal` above or below them."""
+    if c.plot is None or c.get("position") in ("left", "right"):
+        return "vertical"
+    return "horizontal"
+
+
+def colorbar_size(c: Any) -> float:
+    """10 pt, in the figure's unit."""
+    return 10.0 / c._points_per_unit()
+
+
+def colorbar_pad(c: Any) -> float:
+    """8 pt, in the figure's unit."""
+    return 8.0 / c._points_per_unit()
+
+
+def fill_alpha(s: Any) -> float:
+    """0.3 × the plot's alpha."""
+    return 0.3 * s.plot.get("alpha")
+
+
+def hist_line_width(h: Any) -> float:
+    """No outline on bars, 1 pt for step outlines."""
+    return 0.0 if h.get("kind") == "bar" else 1.0
+
+
+def hist_alpha(h: Any) -> float:
+    """0.5 when several value sets overlap (neither stacked nor dodged), else the plot's."""
+    if len(h.sets) > 1 and not h.get("stack") and not h.get("dodge"):
+        return 0.5
+    return h.plot.get("alpha")
+
+
+def kde_alpha(k: Any) -> float:
+    """Fill opacity: 1 when stacked, 0.25 otherwise."""
+    return 1.0 if k.get("stack") else 0.25
+
+
+def heatmap_label_size(h: Any) -> float:
+    """0.9 × the font size."""
+    return 0.9 * h.get("font_size")
+
+
+def contour_label_size(c: Any) -> float:
+    """0.8 × the font size."""
+    return 0.8 * c.get("font_size")
+
+
+def text_color(t: Any) -> Any:
+    """The text color."""
+    return t.get("text_color")
+
+
+def annotate_text_coords(a: Any) -> str:
+    """As `coords`."""
+    return a.get("coords")
+
+
+def annotate_arrow_color(a: Any) -> Any:
+    """The text's `color`."""
+    return a.get("color")
+
+
+DEFAULTS: dict[str, Any] = {
+    # Inherited settings
+    "font_size": 8.0,
+    "font_family": "sans-serif",
+    "text_color": "black",
+    "line_width": 1.0,
+    "alpha": 1.0,
+    "rasterize": False,
+    "simplify": "auto",
+    "color_map": "viridis",
+    "decimal_separator": ".",
+    "thousands_separator": "",
+    "minus": "hyphen",
+    "prefix": "",
+    "suffix": "",
+    "precision": None,
+    "palette": OKABE_ITO,
+    "data": None,
+    # Figures: size, arrangement, spacing, output
+    "Figure.grid": None,
+    "Figure.rows": None,
+    "Figure.cols": None,
+    "Figure.order": "auto",
+    "Figure.align": "axes",
+    "Figure.widths": None,
+    "Figure.heights": None,
+    "Figure.plot_width": figure_plot_width,
+    "Figure.plot_height": figure_plot_height,
+    "Figure.width": None,
+    "Figure.height": None,
+    "Figure.unit": "in",
+    "Figure.spacing": figure_spacing,
+    "Figure.margin": figure_margin,
+    "Figure.background": None,
+    "Figure.image_background": "white",
+    "Figure.dpi": 150.0,
+    "Figure.quality": None,
+    "Figure.title_rule": None,
+    "Figure.title_rule_width": 3.0,
+    "Figure.share_x": None,
+    "Figure.share_y": None,
+    "Figure.share": None,
+    "Figure.label_outer": None,
+    "Figure.style": None,
+    "Figure.scaling": 1.0,
+
+    # Figure title
+    "FigureTitle.text": None,
+    "FigureTitle.font_size": figure_title_size,
+    "FigureTitle.font_weight": "bold",
+    "FigureTitle.align": "center",
+    "FigureTitle.over": "axes",
+    "FigureTitle.pad": figure_title_pad,
+    "FigureTitle.color": figure_title_color,
+
+    # Plots
+    "Plot.spines": frozenset({"bottom", "left"}),
+    "Plot.aspect": None,
+    "Plot.background": None,
+    "Plot.border": None,
+    "Plot.border_width": 0.8,
+    "Plot.clip": True,
+    "Plot.axes": True,
+    "Plot.share_x": None,
+    "Plot.share_y": None,
+    "Plot.share": None,
+
+    # Plot titles
+    "Title.text": None,
+    "Title.font_size": title_size,
+    "Title.font_weight": "normal",
+    "Title.color": title_color,
+    "Title.align": "center",
+    "Title.pad": 4.0,
+    "Title.over": "axes",
+
+    # Legends
+    "Legend.position": "auto",
+    "Legend.columns": 1,
+    "Legend.frame": False,
+    "Legend.title": legend_title,
+    "Legend.font_size": legend_font_size,
+    "Legend.color": legend_color,
+    "Legend.background": "white",
+    "Legend.frame_color": "#999999",
+    "Legend.pad": 4.0,
+    "Legend.frame_width": 0.5,
+    "Legend.frame_radius": 0.0,
+    "Legend.frame_alpha": 1.0,
+    "Legend.glyph_alpha": None,
+    "Legend.glyph": "series",
+    "Legend.orientation": "auto",
+    "Legend.glyph_width": 2.0,
+    "Legend.row_height": 1.35,
+
+    # Axes
+    "Axis.label": None,
+    "Axis.label_size": axis_font_size,
+    "Axis.scale": None,
+    "Axis.linthresh": 1.0,
+    "Axis.tz": None,
+    "Axis.limits": "auto",
+    "Axis.padding": "auto",
+    "Axis.auto_padding": 0.05,
+    "Axis.invert": False,
+    "Axis.ticks": None,
+    "Axis.tick_labels": None,
+    "Axis.minor_ticks": None,
+    "Axis.tick_format": "auto",
+    "Axis.tick_rotation": "auto",
+    "Axis.max_ticks": "auto",
+    "Axis.tick_spacing": (3.5, 2.5),
+    "Axis.time_tick_spacing": (5.0, 2.5),
+    "Axis.auto_max_ticks": (10, 8),
+    "Axis.sci_limits": (-4, 5),
+    "Axis.tick_length": 3.0,
+    "Axis.minor_tick_length": axis_minor_tick_length,
+    "Axis.tick_direction": "out",
+    "Axis.tick_width": 0.6,
+    "Axis.tick_size": axis_font_size,
+    "Axis.tick_pad": 2.0,
+    "Axis.label_pad": 3.0,
+    "Axis.color": axis_color,
+    "Axis.line_color": axis_part_color,
+    "Axis.tick_color": axis_part_color,
+    "Axis.tick_label_color": axis_part_color,
+    "Axis.label_color": axis_part_color,
+    "Axis.label_weight": "normal",
+    "Axis.label_style": "normal",
+    "Axis.side": axis_side,
+    "Axis.tick_label_weight": "normal",
+    "Axis.mirror": False,
+    "Axis.spine_offset": 0.0,
+    "Axis.spine_trim": False,
+    "Axis.include_zero": False,
+    "Axis.zero_line": False,
+    "Axis.zero_line_color": axis_zero_line_color,
+    "Axis.zero_line_width": axis_zero_line_width,
+    "Axis.nice": False,
+    "Axis.line_width": 0.8,
+    "Axis.grid": False,
+    "Axis.grid_color": "#dddddd",
+    "Axis.grid_width": 0.5,
+    "Axis.grid_style": "solid",
+    "Axis.minor_grid": False,
+    "Axis.minor_grid_color": axis_minor_grid_color,
+    "Axis.minor_grid_width": axis_minor_grid_width,
+    "Axis.minor_grid_style": axis_minor_grid_style,
+    "Axis.visible": True,
+
+    # Colorbars
+    "Colorbar.position": "right",
+    "Colorbar.orientation": colorbar_orientation,
+    "Colorbar.size": colorbar_size,
+    "Colorbar.length": 1.0,
+    "Colorbar.pad": colorbar_pad,
+    "Colorbar.label": None,
+    "Colorbar.extend": "auto",
+    "Colorbar.frame": False,
+    "Colorbar.frame_color": "#666666",
+    "Colorbar.frame_width": 0.5,
+    "HLine.color": "#4d4d4d",
+    "HLine.line_style": "solid",
+    "HLine.min": 0.0,
+    "HLine.max": 1.0,
+    "HLine.name": None,
+    "HLine.alpha": 1.0,
+    "HLine.z": 1.0,
+    "HLine.extend_limits": False,
+    "HLine.clip": True,
+    "VLine.color": "#4d4d4d",
+    "VLine.line_style": "solid",
+    "VLine.min": 0.0,
+    "VLine.max": 1.0,
+    "VLine.name": None,
+    "VLine.alpha": 1.0,
+    "VLine.z": 1.0,
+    "VLine.extend_limits": False,
+    "VLine.clip": True,
+    "AxLine.color": "#4d4d4d",
+    "AxLine.line_style": "solid",
+    "AxLine.name": None,
+    "AxLine.alpha": 1.0,
+    "AxLine.z": 1.0,
+    "AxLine.extend_limits": False,
+    "AxLine.clip": True,
+    "HSpan.color": "#e5e5e5",
+    "HSpan.line_color": None,
+    "HSpan.line_width": 0.0,
+    "HSpan.min": 0.0,
+    "HSpan.max": 1.0,
+    "HSpan.name": None,
+    "HSpan.alpha": 1.0,
+    "HSpan.z": -1.0,
+    "HSpan.extend_limits": False,
+    "HSpan.clip": True,
+    "VSpan.color": "#e5e5e5",
+    "VSpan.line_color": None,
+    "VSpan.line_width": 0.0,
+    "VSpan.min": 0.0,
+    "VSpan.max": 1.0,
+    "VSpan.name": None,
+    "VSpan.alpha": 1.0,
+    "VSpan.z": -1.0,
+    "VSpan.extend_limits": False,
+    "VSpan.clip": True,
+    "Text.align": "left",
+    "Text.valign": "baseline",
+    "Text.rotation": 0.0,
+    "Text.coords": "data",
+    "Text.color": text_color,
+    "Text.font_weight": "normal",
+    "Text.name": None,
+    "Text.alpha": 1.0,
+    "Text.z": 1.0,
+    "Text.extend_limits": False,
+    "Text.clip": False,
+    "Annotate.align": "center",
+    "Annotate.valign": "center",
+    "Annotate.text_coords": annotate_text_coords,
+    "Annotate.arrow": True,
+    "Annotate.arrow_style": "->",
+    "Annotate.arrow_color": annotate_arrow_color,
+    "Annotate.arrow_width": 0.8,
+    "Annotate.head_size": 5.0,
+    "Annotate.shrink": 2.0,
+
+    # Every series
+    "Series.name": None,
+    "Series.z": None,
+
+    # Scatter
+    "Scatter.marker": "circle",
+    "Scatter.size": 4.0,
+    "Scatter.color": None,
+    "Scatter.line_color": None,
+    "Scatter.line_width": 0.5,
+    "Scatter.filled": True,
+    "Scatter.size_basis": "area",
+    "Scatter.size_map": None,
+    "Scatter.size_legend": True,
+    "Scatter.order": None,
+    "Scatter.alpha_range": (0.2, 1.0),
+    "Scatter.x_error": None,
+    "Scatter.y_error": None,
+
+    # Line
+    "Line.color": None,
+    "Line.line_style": "solid",
+    "Line.interpolation": "linear",
+    "Line.missing": "break",
+    "Line.cap": "butt",
+    "Line.join": "round",
+    "Line.marker": "circle",
+    "Line.marker_size": 4.0,
+    "Line.marker_color": None,
+    "Line.marker_line_color": None,
+    "Line.marker_line_width": 0.5,
+    "Line.marker_filled": True,
+    "Line.size_basis": "area",
+    "Line.x_error": None,
+    "Line.y_error": None,
+    "Line.show_markers": False,
+
+    # Fill
+    "Fill.color": None,
+    "Fill.alpha": fill_alpha,
+    "Fill.line_color": None,
+    "Fill.interpolation": "linear",
+    "Fill.missing": "break",
+    "Fill.orientation": "vertical",
+
+    # Area
+    "Area.baseline": "zero",
+    "Area.stack": True,
+    "Area.color": None,
+    "Area.alpha": 0.85,
+    "Area.line_color": None,
+    "Area.interpolation": "linear",
+    "Area.missing": "break",
+
+    # Error bars
+    "Errorbar.marker": None,
+    "Errorbar.marker_size": 4.0,
+    "Errorbar.marker_color": None,
+    "Errorbar.marker_line_color": None,
+    "Errorbar.marker_line_width": 0.0,
+    "Errorbar.marker_filled": True,
+    "Errorbar.size_basis": "area",
+    "Errorbar.color": None,
+    "Errorbar.cap": 3.0,
+    "Errorbar.x_error": None,
+    "Errorbar.y_error": None,
+    "Errorbar.y_error_style": "bars",
+    "Errorbar.band_alpha": 0.25,
+
+    # Stem
+    "Stem.marker": "circle",
+    "Stem.marker_size": 5.0,
+    "Stem.marker_color": None,
+    "Stem.marker_line_color": None,
+    "Stem.marker_line_width": 0.0,
+    "Stem.marker_filled": True,
+    "Stem.size_basis": "area",
+    "Stem.color": None,
+    "Stem.baseline": 0.0,
+    "Stem.baseline_color": "#4d4d4d",
+    "Stem.baseline_width": 0.8,
+    "Stem.orientation": "vertical",
+
+    # Regression
+    "Regression.order": 1,
+    "Regression.lowess": False,
+    "Regression.frac": 0.6666666666666666,
+    "Regression.ci": 95.0,
+    "Regression.logx": False,
+    "Regression.scatter": True,
+    "Regression.truncate": True,
+    "Regression.points": 100,
+    "Regression.color": None,
+    "Regression.line_width": 1.5,
+    "Regression.line_style": "solid",
+    "Regression.band_alpha": 0.2,
+    "Regression.marker": "circle",
+    "Regression.marker_size": 4.0,
+    "Regression.marker_color": None,
+    "Regression.marker_line_color": None,
+    "Regression.marker_line_width": 0.0,
+    "Regression.marker_filled": True,
+    "Regression.size_basis": "area",
+
+    # Bar
+    "Bar.color": None,
+    "Bar.line_color": None,
+    "Bar.line_width": 0.0,
+    "Bar.width": 0.8,
+    "Bar.bottom": 0.0,
+    "Bar.orientation": "vertical",
+    "Bar.stack": False,
+    "Bar.dodge": True,
+    "Bar.gap": 0.0,
+    "Bar.saturation": 1.0,
+    "Bar.error": None,
+    "Bar.error_color": "#333333",
+    "Bar.labels": False,
+    "Bar.label_format": "auto",
+
+    # Histogram
+    "Hist.bins": "auto",
+    "Hist.range": None,
+    "Hist.weights": None,
+    "Hist.stat": "count",
+    "Hist.cumulative": False,
+    "Hist.kind": "bar",
+    "Hist.bins_scale": "axis",
+    "Hist.orientation": "vertical",
+    "Hist.stack": False,
+    "Hist.dodge": False,
+    "Hist.color": None,
+    "Hist.line_color": None,
+    "Hist.line_width": hist_line_width,
+    "Hist.alpha": hist_alpha,
+    "Hist.saturation": 1.0,
+    "Hist.labels": False,
+    "Hist.label_format": "auto",
+
+    # Density curves
+    "Kde.bandwidth": "scott",
+    "Kde.adjust": 1.0,
+    "Kde.cut": 3.0,
+    "Kde.clip": None,
+    "Kde.grid": 512,
+    "Kde.cumulative": False,
+    "Kde.fill": False,
+    "Kde.weights": None,
+    "Kde.orientation": "vertical",
+    "Kde.stack": False,
+    "Kde.color": None,
+    "Kde.alpha": kde_alpha,
+    "Kde.line_style": "solid",
+
+    # ECDF
+    "Ecdf.weights": None,
+    "Ecdf.stat": "proportion",
+    "Ecdf.complementary": False,
+    "Ecdf.orientation": "vertical",
+    "Ecdf.color": None,
+    "Ecdf.line_style": "solid",
+
+    # Box plots
+    "Box.color": None,
+    "Box.line_color": "black",
+    "Box.whisker_color": None,
+    "Box.whisker_style": "solid",
+    "Box.line_width": 0.8,
+    "Box.median_color": None,
+    "Box.median_width": 1.5,
+    "Box.width": 0.8,
+    "Box.cap_width": 0.5,
+    "Box.whiskers": 1.5,
+    "Box.outliers": True,
+    "Box.saturation": 1.0,
+    "Box.mean": False,
+    "Box.mean_marker": "diamond",
+    "Box.mean_color": "white",
+    "Box.orientation": "vertical",
+    "Box.dodge": True,
+    "Box.gap": 0.1,
+    "Box.categories": None,
+    "Box.marker": "circle",
+    "Box.marker_size": 3.0,
+    "Box.marker_color": None,
+    "Box.marker_line_color": None,
+    "Box.marker_line_width": 0.6,
+    "Box.marker_filled": True,
+    "Box.size_basis": "area",
+
+    # Violins
+    "Violin.color": None,
+    "Violin.line_color": "#333333",
+    "Violin.line_width": 0.8,
+    "Violin.saturation": 1.0,
+    "Violin.alpha": 1.0,
+    "Violin.width": 0.8,
+    "Violin.bandwidth": "scott",
+    "Violin.adjust": 1.0,
+    "Violin.cut": 2.0,
+    "Violin.grid": 512,
+    "Violin.scale": "area",
+    "Violin.inner": "box",
+    "Violin.split": False,
+    "Violin.orientation": "vertical",
+    "Violin.dodge": True,
+    "Violin.gap": 0.1,
+    "Violin.categories": None,
+    "Strip.marker": "circle",
+    "Strip.size": 4.0,
+    "Strip.color": None,
+    "Strip.line_color": None,
+    "Strip.line_width": 0.5,
+    "Strip.filled": True,
+    "Strip.size_basis": "area",
+    "Strip.size_map": None,
+    "Strip.size_legend": True,
+    "Strip.orientation": "vertical",
+    "Strip.width": 0.8,
+    "Strip.dodge": True,
+    "Strip.gap": 0.0,
+    "Strip.categories": None,
+    "Strip.jitter": 0.1,
+    "Strip.seed": 0,
+    "Strip.order": None,
+    "Strip.alpha_range": (0.2, 1.0),
+    "Swarm.marker": "circle",
+    "Swarm.size": 4.0,
+    "Swarm.color": None,
+    "Swarm.line_color": None,
+    "Swarm.line_width": 0.5,
+    "Swarm.filled": True,
+    "Swarm.size_basis": "area",
+    "Swarm.size_map": None,
+    "Swarm.size_legend": True,
+    "Swarm.orientation": "vertical",
+    "Swarm.width": 0.8,
+    "Swarm.dodge": True,
+    "Swarm.gap": 0.0,
+    "Swarm.categories": None,
+    "Swarm.order": None,
+    "Swarm.alpha_range": (0.2, 1.0),
+
+    # Heatmaps
+    "Heatmap.color_limits": None,
+    "Heatmap.color_scale": None,
+    "Heatmap.mode": "image",
+    "Heatmap.nan_color": None,
+    "Heatmap.origin": "top",
+    "Heatmap.labels": False,
+    "Heatmap.label_format": "auto",
+    "Heatmap.label_size": heatmap_label_size,
+    "Heatmap.colorbar": False,
+
+    # 2-D histograms
+    "Hist2d.bins": ("auto", "auto"),
+    "Hist2d.range": None,
+    "Hist2d.weights": None,
+    "Hist2d.stat": "count",
+    "Hist2d.min_count": 1.0,
+    "Hist2d.origin": "bottom",
+
+    # Hexagonal bins
+    "Hexbin.gridsize": 30,
+    "Hexbin.weights": None,
+    "Hexbin.stat": "count",
+    "Hexbin.min_count": 1.0,
+    "Hexbin.color_limits": None,
+    "Hexbin.color_scale": None,
+    "Hexbin.line_color": None,
+    "Hexbin.line_width": 0.0,
+    "Hexbin.colorbar": False,
+
+    # Contours
+    "Contour.levels": 10,
+    "Contour.filled": False,
+    "Contour.lines": True,
+    "Contour.colors": None,
+    "Contour.line_width": 0.8,
+    "Contour.line_style": "solid",
+    "Contour.negative_style": None,
+    "Contour.alpha": 1.0,
+    "Contour.labels": False,
+    "Contour.label_format": "auto",
+    "Contour.label_size": contour_label_size,
+    "Contour.colorbar": False,
+
+    # 2-D densities (contours of a density)
+    "Kde2d.thresh": 0.05,
+    "Kde2d.bandwidth": "scott",
+    "Kde2d.adjust": 1.0,
+    "Kde2d.cut": 3.0,
+    "Kde2d.gridsize": 128,
+    "Kde2d.color": None,
+
+    # Pies
+    "Pie.labels": None,
+    "Pie.colors": None,
+    "Pie.start": 90.0,
+    "Pie.counterclockwise": True,
+    "Pie.hole": 0.0,
+    "Pie.explode": None,
+    "Pie.sort": False,
+    "Pie.label_position": "outside",
+    "Pie.value_labels": False,
+    "Pie.label_format": "auto",
+    "Pie.line_color": "white",
+    "Pie.line_width": 1.0,
+    "Pie.alpha": 1.0,
+}
+
+
+def inherited() -> dict[str, Any]:
+    """The inherited settings of ``DEFAULTS`` (bare names): the base styles merge over."""
+    return {k: v for k, v in DEFAULTS.items() if "." not in k}
+
+
+_MISSING = object()
+
+
+def class_default(cls: type, name: str) -> Any:
+    """The ``DEFAULTS`` entry of setting ``name`` of ``cls``, along its MRO (a value or a
+    function of the object)."""
+    for c in cls.__mro__:
+        d = DEFAULTS.get(f"{c.__name__}.{name}", _MISSING)
+        if d is not _MISSING:
+            return d
+    raise KeyError(f"no default for {cls.__name__}.{name}")
+
+
+def default_of(obj: Any, name: str) -> Any:
+    """The default of setting ``name`` of ``obj``."""
+    d = class_default(type(obj), name)
+    return d(obj) if callable(d) else d