plot-io 0.12.0__py3-none-win_arm64.whl

plot_io/defaults.py

@@ -0,0 +1,809 @@
+"""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, color maps,
+  …): 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.opacity`` overrides ``Series.opacity``).
+
+* ``"XAxis.name"``/``"YAxis.name"`` is the default of one axis, before ``"Axis.name"``.
+
+Values are plain data, parsed by each setting's validator: units (``"1.2em"``, ``"60%"``),
+``var()`` and ``calc()`` express defaults that depend on other settings (a title's size
+follows the plot's font size).  ``DEFAULTS`` is the ``"default"`` style, the last of
+every figure's style chain; it is read-only (styles change the look).  ``None``
+means unset (no value, inherit, or off); ``"auto"`` means chosen when drawing by a rule
+the setting's doc states, or that the setting's other defaults parametrize
+(``Axis.padding`` and ``Axis.auto_padding``, ``Axis.max_ticks`` and ``Axis.tick_spacing``).
+"""
+
+from collections.abc import Iterator, Mapping
+from typing import Any, NoReturn
+
+__all__ = ["DEFAULTS", "inherited", "default_of"]
+
+
+_DEFAULTS: dict[str, Any] = {
+    # Inherited settings
+    "font_size": 11.0,
+    "font_family": ("Helvetica, Nimbus Sans, Nimbus Sans L, TeX Gyre Heros, FreeSans, Arial, "
+                    "Liberation Sans, Arimo"),
+    "font_stretch": "normal",
+    "font_variations": None,
+    "font_optical_sizing": "auto",
+    "line_height": 1.0,
+    "markup": True,
+    "text_color": "black",
+    "line_width": 0.5,
+    "opacity": 1.0,
+    "rasterize": False,
+    "simplify": "auto",
+    "qualitative_map": "tab10_custom",
+    "sequential_map": "rainbow_lc",
+    "diverging_map": "blue_white_red_hc",
+    "cyclic_map": "romao",
+    "decimal_separator": ".",
+    "thousands_separator": "",
+    "minus": "hyphen",
+    "prefix": "",
+    "suffix": "",
+    "precision": None,
+    "color_variant": "forest",
+    "plain_color": None,
+    "data": None,
+
+    # Setting groups: defaults of every embedding of a member (an owner's key comes first)
+    "Marker.marker": "circle",
+    "Marker.size": 4.5,
+    "Marker.color": None,
+    "Dendrogram.color": None,
+    "Dendrogram.clusters": None,
+    "Dendrogram.orientation": "vertical",
+    "QQ.dist": "normal",
+    "QQ.pvalues": False,
+    "QQ.line": "auto",
+    "QQ.band": "auto",
+    "QQ.band_opacity": 0.2,
+    "QQ.edge_color": None,
+    "Raincloud.color": None,
+    "Raincloud.parts": ("violin", "box", "points"),
+    "Raincloud.orientation": "vertical",
+    "Raincloud.width": "100%",
+    "Raincloud.violin_width": "45%",
+    "Raincloud.box_width": "8%",
+    "Raincloud.points_offset": "-22%",
+    "Raincloud.jitter": "8%",
+    "Raincloud.seed": 0,
+    "Raincloud.fill_opacity": 0.4,
+    "Raincloud.bandwidth": "scott",
+    "Raincloud.adjust": 1.0,
+    "Raincloud.cut": 2.0,
+    "Raincloud.points": 512,
+    "Raincloud.whiskers": 1.5,
+    "Raincloud.weights": None,
+    "Raincloud.median_width": "calc(2 * var(line_width))",
+    "Raincloud.marker_size": 3.0,
+    "Raincloud.marker_edge_color": None,
+    "Raincloud.categories": None,
+    "Volcano.fold_change_threshold": 1.0,
+    "Volcano.p_threshold": 0.05,
+    "Volcano.colors": {"up": "#d6604d", "down": "#4393c3", "n.s.": "#bdbdbd"},
+    "Volcano.counts": True,
+    "Volcano.thresholds": True,
+    "Volcano.threshold_color": "#808080",
+    "Volcano.threshold_width": "var(line_width)",
+    "Volcano.label": "top",
+    "Volcano.label_count": 10,
+    "Ma.fold_change_threshold": 1.0,
+    "Ma.p_threshold": 0.05,
+    "Ma.colors": {"up": "#d6604d", "down": "#4393c3", "n.s.": "#bdbdbd"},
+    "Ma.counts": True,
+    "Ma.thresholds": True,
+    "Ma.threshold_color": "#808080",
+    "Ma.threshold_width": "var(line_width)",
+    "Ma.label": "top",
+    "Ma.label_count": 10,
+    "Manhattan.chr_sizes": None,
+    "Manhattan.colors": ("#2c5d8f", "#8fb0d3"),
+    "Manhattan.threshold": 5e-8,
+    "Manhattan.threshold_color": "#808080",
+    "Manhattan.threshold_width": "var(line_width)",
+    "Manhattan.label": "top",
+    "Manhattan.label_count": 10,
+    "Marker.edge_color": "auto",
+    "Marker.edge_width": 0.5,
+    "Marker.fill": True,
+    "Marker.fill_opacity": 1.0,
+    "Marker.size_basis": "area",
+    "Stroke.line_width": 0.5,
+    "Stroke.line_style": "solid",
+    "Stroke.cap": "butt",
+    "Stroke.join": "round",
+    "TextStyle.font_size": "1em",
+    "TextStyle.font_weight": "normal",
+    "TextStyle.font_style": "normal",
+    "TextStyle.color": "var(text_color)",
+    # Figures: size, arrangement, spacing, output
+    "Figure.layout": "auto",
+    "Figure.rows": None,
+    "Figure.cols": None,
+    "Figure.fill_order": "auto",
+    "Figure.align": "axes",
+    "Figure.widths": None,
+    "Figure.heights": None,
+    "Figure.width": "150px",
+    "Figure.height": "calc(var(width) / var(aspect_ratio))",
+    "Figure.aspect_ratio": 5 / 4,
+    "Figure.reference": "axes",
+    "Figure.spacing": 13.0,
+    "Figure.margin": 5.0,
+    "Figure.background": "white",
+    "Figure.default_dpi": "4x",
+    "Figure.quality": "auto",
+    "Figure.fonts": None,
+    "Figure.share_x": None,
+    "Figure.share_color": False,
+    "Figure.share_size": False,
+    "Figure.share_legend": False,
+    "Figure.share_y": None,
+    "Figure.share": None,
+    "Figure.label_outer": None,
+    "Figure.style": None,
+    "Figure.scaling": 1.0,
+    "Figure.vars": None,
+
+    # Titles (plot and figure titles)
+    "TitleBase.text": None,
+    "TitleBase.side": "top",
+    "TitleBase.align": "center",
+    "TitleBase.over": "axes",
+    "TitleBase.rotation": "auto",
+    "TitleBase.pad": 5.0,
+    "TitleBase.order": None,
+    "TitleBase.rule": False,
+    "TitleBase.rule_color": "var(color)",
+    "TitleBase.rule_width": "var(line_width)",
+    "TitleBase.rule_gap": "0.5em",
+
+    # Figure titles
+    "FigureTitle.font_weight": "bold",
+    "FigureTitle.pad": "0.5em",
+
+    # Plots
+    "Plot.spines": "bottom left",
+    "Plot.data_ratio": None,
+    "Plot.background": None,
+    "Plot.border_color": None,
+    "Plot.clip": True,
+    "Plot.axes": True,
+    "Plot.share_x": None,
+    "Plot.share_y": None,
+    "Plot.share": None,
+    "Plot.vars": None,
+    "Plot.space_above": 0.0,
+
+    # Figure legends (the other settings: Legend.*)
+    "FigureLegend.side": "right",
+    "FigureLegend.align": "center",
+    "FigureLegend.order": None,
+
+    # Legends
+    "Legend.inside": "auto",
+    "Legend.side": None,
+    "Legend.align": "auto",
+    "Legend.visible": True,
+    "Legend.columns": 1,
+    "Legend.frame": False,
+    "Legend.title": "auto",
+    "Legend.background": "white",
+    "Legend.frame_color": "#999999",
+    "Legend.pad": 5.0,
+    "Legend.frame_radius": 0.0,
+    "Legend.frame_opacity": 1.0,
+    "Legend.glyph_opacity": None,
+    "Legend.glyph": "series",
+    "Legend.orientation": "auto",
+    "Legend.glyph_length": "1.4em",
+    "Legend.row_height": "1.35em",
+    "Legend.glyph_gap": "0.5em",
+    "Legend.column_gap": "1em",
+    "Legend.inner_pad": "auto",
+    "Legend.title_gap": "0.3em",
+
+    # Size legends (a size key in its own grid area)
+    "SizeLegend.values": None,
+    "SizeLegend.title": None,
+    "SizeLegend.font_size": None,
+
+    # Axes
+    "Axis.label": None,
+    "Axis.label_position": "axis",
+    "Axis.region": None,
+    "Axis.chr_sizes": None,
+    "Axis.scale_bar": False,
+    "Axis.unit": "auto",
+    "Axis.unit_in": "label",
+    "Axis.origin": None,
+    "Axis.region_widths": "span",
+    "Axis.region_gap": "1em",
+    "Axis.scale": None,
+    "Axis.linthresh": 1.0,
+    "Axis.tz": None,
+    "Axis.limits": "auto",
+    "ColorAxis.center": None,
+    "ColorAxis.color_map": "auto",
+    "Axis.padding": "auto",
+    "Axis.auto_padding": "5%",
+    "Axis.sticky": True,
+    "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": ("3em", "2em"),
+    "Axis.time_tick_spacing": ("5em", "2.5em"),
+    "Axis.tick_label_gap": "0.6em",
+    "Axis.category_label_spacing": ("1.6em", "1.3em"),
+    "Axis.label_min_size": "6pt",
+    "Axis.auto_max_ticks": (10, 8),
+    "Axis.sci_limits": (-4, 5),
+    "Axis.tick_length": 6.0,
+    "Axis.minor_tick_length": "60%",
+    "Axis.tick_direction": "out",
+    "Axis.tick_pad": 5.0,
+    "Axis.label_pad": 5.0,
+    "Axis.color": "var(text_color)",
+    "Axis.line_color": "var(color)",
+    "Axis.tick_color": "var(color)",
+    "Axis.tick_label_color": "var(color)",
+    "Axis.label_color": "var(color)",
+    "XAxis.side": "bottom",
+    "YAxis.side": "left",
+    "Axis.side": "left",
+    "Axis.mirror": False,
+    "Axis.spine_offset": 0.0,
+    "Axis.spine_trim": False,
+    "Axis.include_zero": False,
+    "Axis.zero_line": False,
+    "Axis.zero_line_color": "var(line_color)",
+    "Axis.zero_line_width": "var(line_width)",
+    "Axis.snap": ("4%", "8%"),
+    "Axis.grid": False,
+    "Axis.grid_color": "#dddddd",
+    "Axis.minor_grid": False,
+    "Axis.minor_grid_color": "var(grid_color)",
+    "Axis.minor_grid_width": "50%",
+    "Axis.minor_grid_style": "var(grid_style)",
+    "Axis.visible": True,
+
+    # Size axes (color axes take the Axis defaults, and colorbar keys)
+    "SizeAxis.size_map": None,
+
+    # Colorbars
+    "Colorbar.side": "bottom",
+    "Colorbar.inside": None,
+    "Colorbar.align": "center",
+    "Colorbar.order": None,
+    "Colorbar.style": "key",
+    "Colorbar.orientation": "auto",
+    "Colorbar.thickness": "auto",
+    "Colorbar.length": "auto",
+    "Colorbar.values": "limits",
+    "Colorbar.value_gap": "0.6em",
+    "Colorbar.label_gap": "1.2em",
+    "Colorbar.label_position": "end",
+    "Colorbar.pad": "auto",
+    "Colorbar.label": None,
+    "Colorbar.extend": "auto",
+    "Colorbar.extend_shape": "auto",
+    "Colorbar.frame": False,
+    "Colorbar.count": 3,
+    "Colorbar.marker_gap": "0.4em",
+    "Colorbar.frame_color": "#666666",
+    "Decoration.name": None,
+    "Decoration.opacity": 1.0,
+    "Decoration.z": 1.0,
+    "Decoration.extend_limits": False,
+    "Decoration.clip": True,
+    "HLine.color": "#4d4d4d",
+    "HLine.min": "0%",
+    "HLine.max": "100%",
+    "VLine.color": "#4d4d4d",
+    "VLine.min": "0%",
+    "VLine.max": "100%",
+    "AxLine.color": "#4d4d4d",
+    "HSpan.color": "#e5e5e5",
+    "HSpan.edge_color": None,
+    "HSpan.edge_width": 0.0,
+    "HSpan.min": "0%",
+    "HSpan.max": "100%",
+    "HSpan.z": -1.0,
+    "VSpan.color": "#e5e5e5",
+    "VSpan.edge_color": None,
+    "VSpan.edge_width": 0.0,
+    "VSpan.min": "0%",
+    "VSpan.max": "100%",
+    "VSpan.z": -1.0,
+    "Text.align": "left",
+    "Text.valign": "baseline",
+    "Text.rotation": 0.0,
+    "Text.coords": "data",
+    "Text.clip": False,
+    "Annotate.align": "center",
+    "Annotate.valign": "center",
+    "Annotate.text_coords": "var(coords)",
+    "Annotate.arrow": True,
+    "Annotate.arrow_style": "->",
+    "Annotate.arrow_color": "var(color)",
+    "Annotate.head_length": 7.0,
+    "Annotate.shrink": 3.0,
+    "Bracket.color": "var(text_color)",
+    "Bracket.y": None,
+    "Bracket.format": "stars",
+    "Bracket.stars": (0.05, 0.01, 0.001, 0.0001),
+    "Bracket.tip": "0.4em",
+    "Bracket.step": "8%",
+    "Bracket.gap": "0.15em",
+    "Bracket.extend_limits": True,
+    "Bracket.clip": False,
+
+    # Every series
+    "Series.name": None,
+    "Series.markers": None,
+    "Series.line_styles": None,
+    "Series.level_order": None,
+    "Series.level_missing": "keep",
+    "Series.estimate": None,
+    "Series.interval": None,
+    "Series.color_limits": None,
+    "Series.color_scale": None,
+    "Series.center": None,
+    "Series.color_map": "auto",
+    "Series.color_axis": None,
+    "Series.colorbar": False,
+    "Series.size_limits": None,
+    "Series.size_scale": None,
+    "Series.size_axis": None,
+    "Series.z": None,
+    "Series.x_origin": None,
+    "Series.x_scale": 1.0,
+    "Series.x_extent": None,
+    "Series.y_origin": None,
+    "Series.y_scale": 1.0,
+    "Series.y_extent": None,
+
+    # Scatter
+    "Scatter.size_map": None,
+    "Scatter.size_key": "key",
+    "Scatter.draw_order": None,
+    "Scatter.opacity_range": (0.2, 1.0),
+    "Scatter.x_error": None,
+    "Scatter.y_error": None,
+    "Scatter.orientation": "vertical",
+    "Scatter.labels": None,
+    "Scatter.label_font_size": "0.9em",
+    "Scatter.label_color": None,
+    "Scatter.label_reach": "6em",
+    "Scatter.label_leaders": True,
+
+    # Line
+    "Line.color": None,
+    "Line.interpolation": "linear",
+    "Line.missing": "break",
+    "Line.orientation": "vertical",
+    "Line.x_error": None,
+    "Line.y_error": None,
+    "Line.show_markers": False,
+    "Line.interval_style": "band",
+
+    # Fill
+    "Fill.color": None,
+    "Fill.color_below": None,
+    "Fill.opacity": "calc(0.3 * inherit)",
+    "Fill.edge_color": None,
+    "Fill.edge_width": "var(line_width)",
+    "Fill.interpolation": "linear",
+    "Fill.missing": "break",
+    "Fill.orientation": "vertical",
+
+    # Area
+    "Area.orientation": "vertical",
+    "Area.baseline": "zero",
+    "Area.stack": True,
+    "Area.color": None,
+    "Area.fill": True,
+    "Area.fill_opacity": 0.25,
+    "Area.edge_color": "series",
+    "Area.edge_width": "var(line_width)",
+    "Area.interpolation": "linear",
+    "Area.missing": "break",
+
+    # Error bars
+    "Errorbar.orientation": "vertical",
+    "Errorbar.marker": None,
+    "Errorbar.color": None,
+    "Errorbar.cap_length": 4.0,
+    "Errorbar.x_error": None,
+    "Errorbar.y_error": None,
+    "Errorbar.y_error_style": "bars",
+    "Errorbar.band_opacity": 0.25,
+
+    # Stem
+    "Stem.marker_size": 5.0,
+    "Stem.marker_edge_color": None,
+    "Stem.marker_edge_width": 0.0,
+    "Stem.color": None,
+    "Stem.baseline": 0.0,
+    "Stem.baseline_color": "#4d4d4d",
+    "Stem.orientation": "vertical",
+
+    # Regression
+    "Regression.orientation": "vertical",
+    "Regression.order": 1,
+    "Regression.lowess": False,
+    "Regression.frac": 0.6666666666666666,
+    "Regression.weights": None,
+    "Regression.ci": 95.0,
+    "Regression.logx": False,
+    "Regression.scatter": True,
+    "Regression.range": None,
+    "Regression.points": 100,
+    "Regression.color": None,
+    "Regression.band_opacity": 0.2,
+
+    # Bar
+    "Bar.color": None,
+    "Bar.edge_color": "series",
+    "Bar.edge_width": "var(line_width)",
+    "Bar.fill": True,
+    "Bar.fill_opacity": 0.25,
+    "Bar.seam_color": "white",
+    "Bar.width": "80%",
+    "Bar.max_width": None,
+    "Bar.bottom": 0.0,
+    "Bar.orientation": "vertical",
+    "Bar.stack": False,
+    "Bar.dodge": True,
+    "Bar.gap": "15%",
+    "Bar.saturation": 1.0,
+    "Bar.y_error": None,
+    "Bar.error_color": "#333333",
+    "Bar.value_labels": False,
+    "Bar.value_label_format": "auto",
+
+    # Histogram
+    "Hist.bins": "auto",
+    "Hist.range": None,
+    "Hist.weights": None,
+    "Hist.stat": "count",
+    "Hist.cumulative": False,
+    "Hist.shape": "stepfilled",
+    "Hist.bins_scale": "axis",
+    "Hist.orientation": "vertical",
+    "Hist.stack": False,
+    "Hist.dodge": False,
+    "Hist.color": None,
+    "Hist.edge_color": None,
+    "Hist.edge_width": 0.0,
+    "Hist.line_color": None,
+    "Hist.outline": True,
+    "Hist.fill": True,
+    "Hist.fill_opacity": "auto",
+    "Hist.saturation": 1.0,
+    "Hist.value_labels": False,
+    "Hist.value_label_format": "auto",
+
+    # Density curves
+    "Kde.bandwidth": "scott",
+    "Kde.adjust": 1.0,
+    "Kde.cut": 3.0,
+    "Kde.range": None,
+    "Kde.points": 512,
+    "Kde.cumulative": False,
+    "Kde.fill": False,
+    "Kde.fill_opacity": 0.25,
+    "Kde.weights": None,
+    "Kde.orientation": "vertical",
+    "Kde.stack": False,
+    "Kde.color": None,
+
+    # ECDF
+    "Ecdf.weights": None,
+    "Ecdf.stat": "proportion",
+    "Ecdf.complementary": False,
+    "Ecdf.stack": False,
+    "Ecdf.orientation": "vertical",
+    "Ecdf.color": None,
+
+    # Box plots
+    "Box.color": None,
+    "Box.edge_color": "series",
+    "Box.edge_width": "var(line_width)",
+    "Box.fill": True,
+    "Box.fill_opacity": 0.25,
+    "Box.whisker_color": None,
+    "Box.whisker_width": "var(edge_width)",
+    "Box.median_color": None,
+    "Box.median_width": "calc(3 * var(edge_width))",
+    "Box.width": "80%",
+    "Box.offset": 0.0,
+    "Box.max_width": "60%",
+    "Box.cap_length": "50%",
+    "Box.whiskers": 1.5,
+    "Box.weights": None,
+    "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": "15%",
+    "Box.categories": None,
+    "Box.marker_size": 3.5,
+    "Box.marker_edge_color": None,
+
+    # Violins
+    "Violin.color": None,
+    "Violin.edge_color": "series",
+    "Violin.edge_width": "var(line_width)",
+    "Violin.saturation": 1.0,
+    "Violin.fill": True,
+    "Violin.fill_opacity": 0.25,
+    "Violin.width": "80%",
+    "Violin.max_width": None,
+    "Violin.bandwidth": "scott",
+    "Violin.weights": None,
+    "Violin.adjust": 1.0,
+    "Violin.cut": 2.0,
+    "Violin.points": 512,
+    "Violin.width_scale": "area",
+    "Violin.inner": "box",
+    "Violin.split": False,
+    "Violin.side": "both",
+    "Violin.orientation": "vertical",
+    "Violin.dodge": True,
+    "Violin.gap": "15%",
+    "Violin.categories": None,
+    "Strip.size_map": None,
+    "Strip.size_key": "key",
+    "Strip.orientation": "vertical",
+    "Strip.width": "80%",
+    "Strip.offset": 0.0,
+    "Strip.max_width": None,
+    "Strip.dodge": True,
+    "Strip.gap": "15%",
+    "Strip.categories": None,
+    "Strip.jitter": "10%",
+    "Strip.seed": 0,
+    "Strip.draw_order": None,
+    "Strip.opacity_range": (0.2, 1.0),
+    "Swarm.size_map": None,
+    "Swarm.size_key": "key",
+    "Swarm.orientation": "vertical",
+    "Swarm.width": "80%",
+    "Swarm.offset": 0.0,
+    "Swarm.max_width": None,
+    "Swarm.dodge": True,
+    "Swarm.gap": "15%",
+    "Swarm.categories": None,
+    "Swarm.draw_order": None,
+    "Swarm.opacity_range": (0.2, 1.0),
+
+    # Heatmaps
+    "Heatmap.kind": "image",
+    "Heatmap.nan_color": None,
+    "Heatmap.origin": "top",
+    "Heatmap.value_labels": False,
+    "Heatmap.value_label_format": "auto",
+    "Heatmap.value_label_font_size": "0.9em",
+    # Dot plots
+    "Dots.size_map": (0.0, 12.0),
+    "Dots.size_limits": "0/max",
+    "Dots.size_key": "key",
+    "Dots.scale_color": None,
+    "Dots.origin": "top",
+    "Dots.colorbar": True,
+
+    # 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.bins": 30,
+    "Hexbin.weights": None,
+    "Hexbin.stat": "count",
+    "Hexbin.min_count": 1.0,
+    "Hexbin.edge_color": None,
+    "Hexbin.edge_width": 0.0,
+
+    # Contours
+    "Contour.levels": 10,
+    "Contour.fill": False,
+    "Contour.fill_opacity": 1.0,
+    "Contour.lines": True,
+    "Contour.negative_style": None,
+    "Contour.opacity": 1.0,
+    "Contour.value_labels": False,
+    "Contour.value_label_format": "auto",
+    "Contour.value_label_font_size": "0.8em",
+
+    # 2-D densities (contours of a density)
+    "Kde2d.thresh": 0.05,
+    "Kde2d.bandwidth": "scott",
+    "Kde2d.adjust": 1.0,
+    "Kde2d.weights": None,
+    "Kde2d.cut": 3.0,
+    "Kde2d.points": 128,
+
+    # Pies
+    "Pie.names": None,
+    "Pie.start": 90.0,
+    "Pie.counterclockwise": True,
+    "Pie.hole": 0.0,
+    "Pie.explode": None,
+    "Pie.sort": False,
+    "Pie.name_position": "outside",
+    "Pie.value_labels": False,
+    "Pie.value_label_format": "auto",
+    "Pie.label_spacing": "1.25em",
+    "Pie.edge_color": "series",
+    "Pie.edge_width": 1.25,
+    "Pie.opacity": 1.0,
+    "Pie.fill": True,
+    "Pie.fill_opacity": 0.25,
+    "Pie.seam_color": "white",
+    # Lines and bands through rows, groups of rows (figure.vline, vspan, group)
+    "FigureVLine.color": "#4d4d4d",
+    "FigureVLine.line_style": "dashed",
+    "FigureVLine.opacity": 1.0,
+    "FigureVSpan.color": "#e5e5e5",
+    "FigureVSpan.opacity": 1.0,
+    "FigureGroup.label": None,
+    "FigureGroup.letter": None,
+    "FigureGroup.font_size": "1em",
+    "FigureGroup.letter_font_size": "1.4em",
+    "FigureGroup.letter_weight": "bold",
+    "FigureGroup.pad": "0.5em",
+    # Genome tracks
+    "Track.height": "auto",
+    "Track.auto_height": "4.5em",
+    "Track.space_above": "auto",
+    "Track.auto_space_above": "0.6em",
+    "Track.lane_gap": "0.3em",
+    "Track.fill_mode": None,
+    "GenomeSeries.region": None,
+    "BigWig.bins": "0.5px",
+    "BigWig.bin_mode": "mean",
+    "BigWig.def_value": 0.0,
+    "BigWig.kind": "step",
+    "BigWig.fill_to": 0.0,
+    "BigWig.fill": True,
+    "BigWig.fill_opacity": 0.2,
+    "BigWig.color": None,
+    "BigWig.transform": None,
+    "BigWig.lane": "below",
+    "BigWig.row_height": "1.2em",
+    "Bed.lane": "below",
+    "Bed.kind": "boxes",
+    "Bed.rows": "collapse",
+    "Bed.max_rows": 20,
+    "Bed.min_width": 0.75,
+    "Bed.color": "black",
+    "Bed.names": False,
+    "Bed.name_position": "auto",
+    "Bed.name_region": None,
+    "Bed.recolor": False,
+    "Bed.nan_color": "gray",
+    "Bed.outline": True,
+    "Bed.fill": True,
+    "Bed.fill_opacity": 0.3,
+    "Bed.strand": False,
+    "Bed.row_height": "1.2em",
+    "Bed.name_font_size": "0.85em",
+    "Genes.kind": "genes",
+    "Genes.rows": "expand",
+    "Genes.names": True,
+    "Genes.strand": True,
+    "Genes.outline": False,
+    "Genes.fill_opacity": 1.0,
+    "Gtf.model": "gene",
+    "Gtf.gene_type": None,
+    "Gtf.transcript_type": None,
+    "HiC.depth": None,
+    "HiC.bins": "0.5px",
+    "HiC.normalization": "none",
+    "HiC.matrix_type": "observed",
+    "HiC.color_limits": "q:0.01/q:0.99",
+    "HiC.color_scale": "log",
+    "HiC.nan_color": None,
+    "HiC.direction": "up",
+    "HiC.max_height": None,
+    "HiC.fit": "clip",
+    "HiC.shape": "triangle",
+    "HiC.region2": None,
+    "Links.lane": "below",
+    "Links.direction": "up",
+    "Links.color": "black",
+    "Links.max_height": "4.5em",
+    "Links.outside": "clip",
+    "Links.nan_color": "gray",
+    # Site matrices (site_heatmap, site_profile)
+    "SiteHeatmap.flank": "5kb",
+    "SiteHeatmap.bins": 100,
+    "SiteHeatmap.anchor": "center",
+    "SiteHeatmap.bin_mode": "mean",
+    "SiteHeatmap.sort": "mean",
+    "SiteHeatmap.row_bins": "auto",
+    "SiteHeatmap.nan_color": None,
+    "SiteProfile.flank": "5kb",
+    "SiteProfile.bins": 100,
+    "SiteProfile.anchor": "center",
+    "SiteProfile.bin_mode": "mean",
+    "SiteProfile.stat": "mean",
+    "SiteProfile.band": None,
+    "SiteProfile.color": None,
+    "SiteProfile.fill_opacity": 0.2,
+}
+
+
+class _ReadOnly(Mapping[str, Any]):
+    """``DEFAULTS``: a read-only view of the default values."""
+
+    __slots__ = ("_d",)
+
+    def __init__(self, d: dict[str, Any]) -> None:
+        self._d = d
+
+    def __getitem__(self, key: str) -> Any:
+        return self._d[key]
+
+    def __contains__(self, key: object) -> bool:
+        return key in self._d
+
+    def get(self, key: str, default: Any = None) -> Any:
+        return self._d.get(key, default)
+
+    def __iter__(self) -> Iterator[str]:
+        return iter(self._d)
+
+    def __len__(self) -> int:
+        return len(self._d)
+
+    def __repr__(self) -> str:
+        return f"DEFAULTS({self._d!r})"
+
+    def _refuse(self, *args: Any, **kwargs: Any) -> NoReturn:
+        raise TypeError("DEFAULTS is read-only: change settings with a style "
+                        "(plt.set_style({...}), plt.use_style or plt.registry.styles.add)")
+
+    __setitem__ = __delitem__ = __ior__ = _refuse
+    update = pop = popitem = setdefault = clear = _refuse
+
+
+DEFAULTS: Mapping[str, Any] = _ReadOnly(_DEFAULTS)
+
+
+def inherited() -> dict[str, Any]:
+    """The inherited settings of ``DEFAULTS`` (bare names), under every style's."""
+    return {k: v for k, v in DEFAULTS.items() if "." not in k}
+
+
+def default_of(setting: Any, key: str) -> Any:
+    """``DEFAULTS[key]`` (a key not in ``DEFAULTS``: the setting's declared default), text
+    and sequences parsed by ``setting``'s validator.  ``ValueError`` when it rejects it."""
+    d = DEFAULTS[key] if key in DEFAULTS else setting.default
+    if isinstance(d, (str, tuple, list)):
+        from .settings import check_value
+        try:
+            d = check_value(setting, d)
+        except ValueError as e:
+            raise ValueError(f"default {key}: {e}") from None
+    return d