jarvisplot 2.1.7__tar.gz → 2.1.9__tar.gz

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/JarvisPLOT.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JarvisPLOT
-Version: 2.1.7
+Version: 2.1.9
 Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -66,6 +66,7 @@ Render with a bare path — there is no `jplot run`:
 ```bash
 jplot path/to/config.yaml
 jplot path/to/config.yaml --rebuild-cache
+jplot path/to/config.yaml --print
 ```
 
 Everything else is discovery and judgement, in three groups.
@@ -218,9 +219,45 @@ from jarvisplot import render_flowchart, render_flowchart_file
 - You can set `project.workdir` in YAML.
 - If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
+- `--print` accepts the current settings and renders final figures without the logo. It announces that, after all enabled figures are saved successfully, cache payloads used or created by this run will be deleted (pipeline data and metadata, named/shared data, summaries, and HDF5 materialization slots). Rendering failures or a run with no enabled figures keep the cache. Unrelated cache entries and the lightweight fingerprint manifest are retained; later renders rebuild deleted entries as needed.
 - Profiling pipelines are prebuilt once and reused from cache when source fingerprint and profile settings are unchanged.
 - Profiling uses a fast two-stage grid reduction (`pregrid` + render `bin`) for large datasets.
 
+Plot caches are automatically registered in `~/.jarvis/plot.json` (or
+`$JARVIS_HOME/plot.json`). The registry groups caches by workdir and records
+associated YAML paths and last use; payloads stay in their original directories.
+This includes caches created by `data describe` and default `dryrun --with-data`
+exports. Sizes are calculated when listing, rather than stored in the registry.
+
+```bash
+jplot cache list
+jplot cache scan ~/Jarvis-Workshop               # register existing plot caches
+jplot cache clean --workdir /path/to/project    # this directory and all nested projects; repeatable
+jplot cache clean --all --older-than 30         # unused for at least 30 days
+jplot cache clean --all --dry-run               # preview; no deletion/index changes
+jplot cache clean --all                         # clean all registered inactive caches
+jplot cache -h
+jplot man cache
+```
+
+`--workdir PATH` selects registered caches in PATH itself and all of its
+subdirectories, even when PATH has no cache of its own. Repeat it to select
+multiple directory trees; overlapping selections are deduplicated. Use
+`cache scan PATH` first for old caches that have not been registered.
+
+All cache subcommands accept `--json` and use the existing CLI envelope and
+exit codes (0 success/partial, 1 failure, 2 usage). Non-TTY stdout defaults to
+JSON; human results go to stderr. Active caches are skipped (`ok: null` when
+the remaining operation succeeds), and records for missing paths are pruned
+during cleanup. Only marked Jarvis-PLOT components are removed; source data,
+plots, and unrelated `.cache` content are retained. Failed deletions retain
+their registry entries. Scanning adopts legacy caches only when the four
+pipeline directories and a compatible `manifest.json` identify them; old
+unmarked twin-only directories need a new `dryrun --with-data` run to register.
+An explicitly supplied `--out-dir` is an export directory and is not registered.
+Concurrent registry writes use a lock and atomic replacement. Registration
+failures warn without preventing rendering.
+
 ### Example: SUSYRun2 Ternary Plots
 
 ```bash
@@ -313,3 +350,5 @@ Read the context docs and roadmap before changing parsing, transforms, rendering
 ## License
 
 MIT License
+
+Create a continuous forest figure with `type: forest`, a generic row table and optional point table. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](docs/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/JarvisPLOT.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ JarvisPLOT.egg-info/top_level.txt
 jarvisplot/__init__.py
 jarvisplot/agent_digest.py
 jarvisplot/agent_io.py
+jarvisplot/cache_registry.py
 jarvisplot/cache_store.py
 jarvisplot/capabilities.py
 jarvisplot/cli.py
@@ -35,6 +36,8 @@ jarvisplot/dryrun_runtime.py
 jarvisplot/expr_names.py
 jarvisplot/fix_apply.py
 jarvisplot/flowchart.py
+jarvisplot/forest_contract.py
+jarvisplot/forest_text.py
 jarvisplot/generated_data.py
 jarvisplot/inner_func.py
 jarvisplot/legend_cards.py
@@ -72,6 +75,9 @@ jarvisplot/Figure/distribution_1d_runtime.py
 jarvisplot/Figure/dynesty_runtime.py
 jarvisplot/Figure/figure.py
 jarvisplot/Figure/figure_types.py
+jarvisplot/Figure/forest_debug.py
+jarvisplot/Figure/forest_legend.py
+jarvisplot/Figure/forest_runtime.py
 jarvisplot/Figure/helper.py
 jarvisplot/Figure/interp_2d_runtime.py
 jarvisplot/Figure/interp_natural_neighbor.py
@@ -109,6 +115,7 @@ jarvisplot/cards/corrplot/diamond.json
 jarvisplot/cards/corrplot/matrix.json
 jarvisplot/cards/default/output.json
 jarvisplot/cards/flowchart/default.json
+jarvisplot/cards/forest/swiss_column.json
 jarvisplot/cards/gambit/1x1/ternary.json
 jarvisplot/cards/gambit/2x1/rect_cmap.json
 jarvisplot/cards/gambit/2x1/ternary.json
@@ -127,6 +134,7 @@ jarvisplot/cards/legends/default/legend-card.json
 jarvisplot/cards/legends/paper/legend-card.json
 jarvisplot/cards/legends/presentation/legend-card.json
 jarvisplot/manual_cards/agent-output.yaml
+jarvisplot/manual_cards/cache.yaml
 jarvisplot/manual_cards/cli-map.yaml
 jarvisplot/manual_cards/data-columns.yaml
 jarvisplot/manual_cards/debug-overlay.yaml
@@ -140,6 +148,7 @@ jarvisplot/manual_cards/manifest.yaml
 jarvisplot/manual_cards/method_notes.yaml
 jarvisplot/manual_cards/style-axes.yaml
 jarvisplot/manual_cards/type-correlation-matrix.yaml
+jarvisplot/manual_cards/type-forest.yaml
 jarvisplot/manual_cards/type-posterior-2d.yaml
 jarvisplot/manual_cards/type-profile-2d.yaml
 jarvisplot/manual_cards/validate.yaml
@@ -186,6 +195,7 @@ jarvisplot/schema/methods/tripcolor_axes.json
 jarvisplot/schema/methods/triplot.json
 jarvisplot/schema/methods/voronoi.json
 jarvisplot/schema/methods/voronoif.json
+jarvisplot/schema/types/forest.json
 jarvisplot/utils/__init__.py
 jarvisplot/utils/cmaps.py
 jarvisplot/utils/dataframes.py
@@ -193,6 +203,7 @@ jarvisplot/utils/expression.py
 jarvisplot/utils/interpolator.py
 jarvisplot/utils/pathing.py
 jarvisplot/verbs/__init__.py
+jarvisplot/verbs/cache.py
 jarvisplot/verbs/cap.py
 jarvisplot/verbs/config_cmd.py
 jarvisplot/verbs/data.py
@@ -204,15 +215,19 @@ jarvisplot/verbs/suggest.py
 jarvisplot/verbs/template.py
 jarvisplot/verbs/validate.py
 tests/test_adaptive_cdf.py
+tests/test_add_column.py
 tests/test_agent_digest.py
 tests/test_agent_envelope.py
 tests/test_axis_title.py
+tests/test_cache_cleanup.py
+tests/test_cache_registry.py
 tests/test_capabilities.py
 tests/test_card_debug_shape.py
 tests/test_cli_help.py
 tests/test_cli_verbs.py
 tests/test_cmaps.py
 tests/test_column_existence.py
+tests/test_column_pruning.py
 tests/test_config_addressing.py
 tests/test_config_edit.py
 tests/test_config_expand.py
@@ -232,11 +247,14 @@ tests/test_diagnostic_guidance.py
 tests/test_distribution_1d_transform.py
 tests/test_docs_status_labels.py
 tests/test_doctor_partial.py
+tests/test_examples_validate.py
 tests/test_explain.py
+tests/test_expression_semantics.py
 tests/test_figure_contracts.py
 tests/test_figure_type_expander.py
 tests/test_fix_application.py
 tests/test_flowchart_renderer.py
+tests/test_forest.py
 tests/test_generated_data.py
 tests/test_imshow_adapter.py
 tests/test_interp_2d_transform.py
@@ -253,6 +271,7 @@ tests/test_pathing_contracts.py
 tests/test_posterior_hpd.py
 tests/test_profile_runtime.py
 tests/test_render_health.py
+tests/test_render_lifecycle.py
 tests/test_row_ledger.py
 tests/test_schema_catalog.py
 tests/test_suggest.py

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JarvisPLOT
-Version: 2.1.7
+Version: 2.1.9
 Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -66,6 +66,7 @@ Render with a bare path — there is no `jplot run`:
 ```bash
 jplot path/to/config.yaml
 jplot path/to/config.yaml --rebuild-cache
+jplot path/to/config.yaml --print
 ```
 
 Everything else is discovery and judgement, in three groups.
@@ -218,9 +219,45 @@ from jarvisplot import render_flowchart, render_flowchart_file
 - You can set `project.workdir` in YAML.
 - If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
+- `--print` accepts the current settings and renders final figures without the logo. It announces that, after all enabled figures are saved successfully, cache payloads used or created by this run will be deleted (pipeline data and metadata, named/shared data, summaries, and HDF5 materialization slots). Rendering failures or a run with no enabled figures keep the cache. Unrelated cache entries and the lightweight fingerprint manifest are retained; later renders rebuild deleted entries as needed.
 - Profiling pipelines are prebuilt once and reused from cache when source fingerprint and profile settings are unchanged.
 - Profiling uses a fast two-stage grid reduction (`pregrid` + render `bin`) for large datasets.
 
+Plot caches are automatically registered in `~/.jarvis/plot.json` (or
+`$JARVIS_HOME/plot.json`). The registry groups caches by workdir and records
+associated YAML paths and last use; payloads stay in their original directories.
+This includes caches created by `data describe` and default `dryrun --with-data`
+exports. Sizes are calculated when listing, rather than stored in the registry.
+
+```bash
+jplot cache list
+jplot cache scan ~/Jarvis-Workshop               # register existing plot caches
+jplot cache clean --workdir /path/to/project    # this directory and all nested projects; repeatable
+jplot cache clean --all --older-than 30         # unused for at least 30 days
+jplot cache clean --all --dry-run               # preview; no deletion/index changes
+jplot cache clean --all                         # clean all registered inactive caches
+jplot cache -h
+jplot man cache
+```
+
+`--workdir PATH` selects registered caches in PATH itself and all of its
+subdirectories, even when PATH has no cache of its own. Repeat it to select
+multiple directory trees; overlapping selections are deduplicated. Use
+`cache scan PATH` first for old caches that have not been registered.
+
+All cache subcommands accept `--json` and use the existing CLI envelope and
+exit codes (0 success/partial, 1 failure, 2 usage). Non-TTY stdout defaults to
+JSON; human results go to stderr. Active caches are skipped (`ok: null` when
+the remaining operation succeeds), and records for missing paths are pruned
+during cleanup. Only marked Jarvis-PLOT components are removed; source data,
+plots, and unrelated `.cache` content are retained. Failed deletions retain
+their registry entries. Scanning adopts legacy caches only when the four
+pipeline directories and a compatible `manifest.json` identify them; old
+unmarked twin-only directories need a new `dryrun --with-data` run to register.
+An explicitly supplied `--out-dir` is an export directory and is not registered.
+Concurrent registry writes use a lock and atomic replacement. Registration
+failures warn without preventing rendering.
+
 ### Example: SUSYRun2 Ternary Plots
 
 ```bash
@@ -313,3 +350,5 @@ Read the context docs and roadmap before changing parsing, transforms, rendering
 ## License
 
 MIT License
+
+Create a continuous forest figure with `type: forest`, a generic row table and optional point table. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](docs/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/README.md

@@ -44,6 +44,7 @@ Render with a bare path — there is no `jplot run`:
 ```bash
 jplot path/to/config.yaml
 jplot path/to/config.yaml --rebuild-cache
+jplot path/to/config.yaml --print
 ```
 
 Everything else is discovery and judgement, in three groups.
@@ -196,9 +197,45 @@ from jarvisplot import render_flowchart, render_flowchart_file
 - You can set `project.workdir` in YAML.
 - If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
+- `--print` accepts the current settings and renders final figures without the logo. It announces that, after all enabled figures are saved successfully, cache payloads used or created by this run will be deleted (pipeline data and metadata, named/shared data, summaries, and HDF5 materialization slots). Rendering failures or a run with no enabled figures keep the cache. Unrelated cache entries and the lightweight fingerprint manifest are retained; later renders rebuild deleted entries as needed.
 - Profiling pipelines are prebuilt once and reused from cache when source fingerprint and profile settings are unchanged.
 - Profiling uses a fast two-stage grid reduction (`pregrid` + render `bin`) for large datasets.
 
+Plot caches are automatically registered in `~/.jarvis/plot.json` (or
+`$JARVIS_HOME/plot.json`). The registry groups caches by workdir and records
+associated YAML paths and last use; payloads stay in their original directories.
+This includes caches created by `data describe` and default `dryrun --with-data`
+exports. Sizes are calculated when listing, rather than stored in the registry.
+
+```bash
+jplot cache list
+jplot cache scan ~/Jarvis-Workshop               # register existing plot caches
+jplot cache clean --workdir /path/to/project    # this directory and all nested projects; repeatable
+jplot cache clean --all --older-than 30         # unused for at least 30 days
+jplot cache clean --all --dry-run               # preview; no deletion/index changes
+jplot cache clean --all                         # clean all registered inactive caches
+jplot cache -h
+jplot man cache
+```
+
+`--workdir PATH` selects registered caches in PATH itself and all of its
+subdirectories, even when PATH has no cache of its own. Repeat it to select
+multiple directory trees; overlapping selections are deduplicated. Use
+`cache scan PATH` first for old caches that have not been registered.
+
+All cache subcommands accept `--json` and use the existing CLI envelope and
+exit codes (0 success/partial, 1 failure, 2 usage). Non-TTY stdout defaults to
+JSON; human results go to stderr. Active caches are skipped (`ok: null` when
+the remaining operation succeeds), and records for missing paths are pruned
+during cleanup. Only marked Jarvis-PLOT components are removed; source data,
+plots, and unrelated `.cache` content are retained. Failed deletions retain
+their registry entries. Scanning adopts legacy caches only when the four
+pipeline directories and a compatible `manifest.json` identify them; old
+unmarked twin-only directories need a new `dryrun --with-data` run to register.
+An explicitly supplied `--out-dir` is an export directory and is not registered.
+Concurrent registry writes use a lock and atomic replacement. Registration
+failures warn without preventing rendering.
+
 ### Example: SUSYRun2 Ternary Plots
 
 ```bash
@@ -291,3 +328,5 @@ Read the context docs and roadmap before changing parsing, transforms, rendering
 ## License
 
 MIT License
+
+Create a continuous forest figure with `type: forest`, a generic row table and optional point table. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](docs/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/jarvisplot/Figure/config_runtime.py

@@ -3,6 +3,8 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Mapping
 
+from .style_runtime import normalize_style_tokens
+
 
 def apply_figure_config(fig, info: Mapping) -> bool:
     """Apply a YAML figure block to a Figure instance."""
@@ -55,7 +57,7 @@ def apply_figure_config(fig, info: Mapping) -> bool:
             )
 
         if "style" in info:
-            style_tokens = info["style"]
+            style_tokens = normalize_style_tokens(info["style"])
         else:
             style_tokens = ["a4paper_2x1"]
         fig.style = style_tokens

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/jarvisplot/Figure/debug_config.py

@@ -71,6 +71,13 @@ _LABEL_FONT = {
 
 
 DEFAULT_DEBUG = {
+    "forest_grid": {
+        "show": True,
+        "columns": {"show": True, "plot": {"color": "#DA291C", "linewidth": 0.3, "linestyle": ":", "alpha": 0.7}},
+        "baselines": {"show": True, "plot": {"color": "#DA291C", "linewidth": 0.2, "linestyle": "--", "alpha": 0.5}},
+        "bands": {"show": True, "Rectangle": {"edgecolor": "#DA291C", "linewidth": 0.25, "fill": False, "alpha": 0.5}},
+        "labels": {"show": True, "text": {"color": "#DA291C", "fontsize": 4, "ha": "left", "va": "top"}},
+    },
     # Which axes gets fully dimensioned and hosts the info panel. First match wins.
     "primary_order": ["ax", "ax0", "ax1", "axtri"],
     "units": {"cm_per_inch": 2.54, "pt_per_inch": 72.0},

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/jarvisplot/Figure/design_runtime.py

@@ -185,6 +185,10 @@ def draw_design_reference(fig) -> None:
 
 
 def _draw(fig) -> None:
+    if hasattr(fig, 'forest_layout'):
+        from .forest_debug import draw_forest_reference
+        draw_forest_reference(fig, _debug_config(fig)['forest_grid'])
+        return
     F = fig.fig
     w_in, h_in = (float(v) for v in F.get_size_inches())
     debug = _debug_config(fig)

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/jarvisplot/Figure/figure.py

@@ -11,7 +11,7 @@ from types import MethodType
 from .adapters_rect import StdAxesAdapter
 from .adapters_ternary import TernaryAxesAdapter
 from .method_registry import resolve_callable
-from .style_runtime import resolve_style_bundle_payload
+from .style_runtime import normalize_style_tokens, resolve_style_bundle_payload
 from .config_runtime import apply_figure_config
 from .design_runtime import draw_design_reference
 from .legend_runtime import apply_legend
@@ -399,10 +399,13 @@ class Figure:
     
     
     @style.setter
-    def style(self, value) -> None: 
-        if len(value) not in (1, 2):
-            self.logger.error("Undefined style -> {}".format(value))
-            raise TypeError
+    def style(self, value) -> None:
+        value = normalize_style_tokens(value)
+        if not isinstance(value, list) or len(value) not in (1, 2):
+            raise TypeError(
+                "style must name a card family or [family, variant], e.g. "
+                "a4paper_2x1 or [a4paper_2x1, rect]; got {!r}".format(value)
+            )
         family, selected, bundle = resolve_style_bundle_payload(self.jpstyles, value)
         self._frame = deepcopy(bundle["Frame"])
         self._legend_disabled_axes = set()
@@ -508,7 +511,7 @@ class Figure:
             return {kk: self._ensure_pandas_data(vv, reason=reason) for kk, vv in data.items()}
         return data
 
-    def _concat_loaded_data(self, items):
+    def _concat_loaded_data(self, items, layer_name: str = ""):
         if len(items) == 0:
             return None
         if len(items) == 1:
@@ -519,7 +522,28 @@ class Figure:
         pandas_items = [self._ensure_pandas_data(item, reason="concat-layer") for item in items]
         try:
             return pd.concat(pandas_items, ignore_index=False)
-        except Exception:
+        except Exception as exc:
+            # Keep drawing what can be drawn, but never drop data silently.
+            if self.logger:
+                shapes = ", ".join(
+                    str(getattr(item, "shape", type(item).__name__)) for item in pandas_items
+                )
+                self.logger.warning(
+                    "Layer '{}': the {} data blocks could not be concatenated, so only "
+                    "the first block is drawn and the other {} are dropped.\n"
+                    "\t reason \t-> {}: {}\n"
+                    "\t blocks \t-> {}\n"
+                    "\t hint \t\t-> blocks combined with `combine: concat` must be tables "
+                    "with compatible columns (no duplicated column names); use "
+                    "`combine: separate` to draw them independently.".format(
+                        layer_name or "<unnamed>",
+                        len(pandas_items),
+                        len(pandas_items) - 1,
+                        type(exc).__name__,
+                        exc,
+                        shapes,
+                    )
+                )
             return pandas_items[0]
 
     def _store_share_data_if_needed(self, layer, data, cache_ref: str | None = None):

{jarvisplot-2.1.7 → jarvisplot-2.1.9}/jarvisplot/Figure/figure_types.py

@@ -752,7 +752,8 @@ def expand_correlation_matrix(info: Mapping[str, Any]) -> dict[str, Any]:
 
 # Types that expand_figure_type can lower to layers. Keep in sync with
 # expand_figure_type dispatch and capabilities.figure_types.
-KNOWN_FIGURE_TYPES = frozenset({"posterior_2d", "profile_2d", "correlation_matrix"})
+NATIVE_FIGURE_TYPES = frozenset({"forest"})
+KNOWN_FIGURE_TYPES = frozenset({"posterior_2d", "profile_2d", "correlation_matrix"}) | NATIVE_FIGURE_TYPES
 
 
 def expand_figure_type(info: Any) -> Any:
@@ -849,6 +850,7 @@ def expand_typed_figures(
             raise KeyError(f"figure(s) not found: {', '.join(missing)}")
 
     expanded_names: list[str] = []
+    native_found = False
     for index, fig in enumerate(figures):
         if not isinstance(fig, Mapping):
             continue
@@ -876,6 +878,12 @@ def expand_typed_figures(
             _note(logger, msg)
             continue
 
+        if fig_type in NATIVE_FIGURE_TYPES:
+            # Native table-driven formats keep their public contract. Their
+            # physical solve is inspectable, not a list of hand-authored layers.
+            native_found = True
+            continue
+
         try:
             out = expand_figure_type(fig)
         except Exception as exc:
@@ -897,6 +905,7 @@ def expand_typed_figures(
 
     if (
         not expanded_names
+        and not native_found
         and not allow_noop
         and raise_on_error
         and wanted is not None

jarvisplot-2.1.9/jarvisplot/Figure/forest_debug.py

@@ -0,0 +1,35 @@
+"""Read-only Swiss grid and physical band references on a separate overlay."""
+from matplotlib.patches import Rectangle
+from ..forest_text import font_properties
+
+
+def draw_forest_reference(fig, cfg):
+    if not cfg['show'] or any(ax.get_label() == 'forest-design-reference' for ax in fig.fig.axes):
+        return
+    scene = fig.forest_layout
+    g = scene['geometry']
+    ax = fig.fig.add_axes([0, 0, 1, 1], label='forest-design-reference', zorder=10000)
+    ax.set(xlim=(0, scene['width_mm']), ylim=(scene['height_mm'], 0)); ax.axis('off')
+    ax.patch.set_alpha(0)
+    if cfg['columns']['show']:
+        for index, x in enumerate(g['grid_lines_mm']):
+            line, = ax.plot([x]*2, [0, scene['height_mm']], **cfg['columns']['plot'])
+            line.set_gid(f'forest-grid-{index:02d}')
+    if cfg['labels']['show']:
+        opts = dict(cfg['labels']['text'])
+        size = opts.pop('fontsize')
+        for index, x in enumerate(g['grid_lines_mm'][:-1]):
+            ax.text(x, g['top_axis_y_mm']+.35, f'{index+1:02d}', fontproperties=font_properties(size, scene['typography']['family']), **opts)
+    if cfg['baselines']['show']:
+        ys = [g[key] for key in ('meta_y_mm','title_y_mm','description_y_mm','x_label_y_mm','column_header_y_mm','top_tick_y_mm')]
+        ys += [r['top_mm']+g[key] for r in scene['rows'] for key in ('cell_y_mm','plot_y_mm')]
+        for index, y in enumerate(ys):
+            line, = ax.plot([g['plot_left_mm'], g['plot_right_mm']], [y]*2, **cfg['baselines']['plot'])
+            line.set_gid(f'forest-baseline-{index:03d}')
+    if cfg['bands']['show']:
+        for index, row in enumerate(scene['rows']):
+            for name, y, height in (('text', row['top_mm'], g['plot_y_mm']-g['point_band_mm']/2),
+                                    ('marks', row['top_mm']+g['plot_y_mm']-g['point_band_mm']/2, g['point_band_mm'])):
+                box = Rectangle((g['plot_left_mm'], y), scene['plot_width_mm'], height, **cfg['bands']['Rectangle'])
+                box.set_gid(f'forest-band-{name}-{index:03d}')
+                ax.add_patch(box)

jarvisplot-2.1.9/jarvisplot/Figure/forest_legend.py

@@ -0,0 +1,88 @@
+"""A native legend handler for the actual forest glyph artist container."""
+from matplotlib.container import Container
+from matplotlib.legend_handler import HandlerBase, HandlerPathCollection
+from matplotlib.lines import Line2D
+from matplotlib.patches import Rectangle
+from matplotlib.offsetbox import VPacker
+
+
+class PhysicalLegendColumn(VPacker):
+    """Recompute physical column width for each raster/vector renderer."""
+    def __init__(self, width_mm, **kwargs):
+        super().__init__(**kwargs)
+        self.width_pt = width_mm*72/25.4
+
+    def _get_bbox_and_child_offsets(self, renderer):
+        self.width = self.width_pt*renderer.points_to_pixels(1)
+        return super()._get_bbox_and_child_offsets(renderer)
+
+
+class ForestGlyph(Container):
+    def __init__(self, artists, *, glyph):
+        super().__init__(artists)
+        self.glyph = glyph
+
+
+class HandlerForestPoint(HandlerPathCollection):
+    """Place one point at the left of its compact native key."""
+    def __init__(self, key_width_pt):
+        super().__init__(numpoints=1)
+        self.key_width_pt = key_width_pt
+
+    def get_xdata(self, legend, xdescent, ydescent, width, height, fontsize):
+        x = -xdescent+self.key_width_pt/2
+        return [x, x], [x]
+
+
+def group_glyph_and_points(legend, config, layers, glyph_object, *, base_dir=None):
+    """Use the canonical native items, with glyphs left and point classes right.
+
+    Matplotlib normally balances item counts across columns, which would place
+    some point classes beside the box sample. Repack its existing item boxes
+    without recreating handles, labels, or their handlers.
+    """
+    from matplotlib.offsetbox import DrawingArea
+    from ..legend_cards import resolve_axes_legend
+    kwargs, entries = resolve_axes_legend(config, layers, base_dir=base_dir)
+    if kwargs.get('ncols', kwargs.get('ncol', 1)) != 2:
+        return
+    legend._ncols = 2
+    if kwargs.get('reverse', False):
+        entries = list(reversed(entries))
+    objects = {id(text): entry['object'] for text, entry in zip(legend.get_texts(), entries)}
+    columns = legend._legend_handle_box.get_children()
+    groups = [[], []]
+    for column in columns:
+        for item in column.get_children():
+            label = item.get_children()[-1]._text
+            groups[0 if objects[id(label)] == glyph_object else 1].append(item)
+    # Preserve the empty semantic column when only one group is present.
+    legend._legend_handle_box._children = [
+        VPacker(pad=0, sep=legend.labelspacing*legend._fontsize,
+                align='left', children=items or [DrawingArea(0, 0)])
+        for items in groups
+    ]
+    legend._legend_handle_box.align = 'top'
+
+
+class HandlerForestGlyph(HandlerBase):
+    def create_artists(self, legend, orig_handle, xdescent, ydescent, width, height, fontsize, trans):
+        whisker = orig_handle[0]
+        left, right = -xdescent, width-xdescent
+        yc = (height-ydescent)/2
+        half = height*.32
+        stroke = {'color': whisker.get_color(), 'linewidth': whisker.get_linewidth(), 'transform': trans}
+        artists = [Line2D([left, right], [yc, yc], **stroke)]
+        for xx in (left, right):
+            artists.append(Line2D([xx, xx], [yc-half, yc+half], **stroke))
+        if orig_handle.glyph == 'box':
+            box, median = orig_handle[1:]
+            artists.append(Rectangle((left+width*.25, yc-half), width*.5, half*2,
+                                     facecolor=box.get_facecolor(), edgecolor=box.get_edgecolor(),
+                                     linewidth=box.get_linewidth(), alpha=box.get_alpha(), transform=trans))
+            artists.append(Line2D([(left+right)/2]*2, [yc-half, yc+half], color=median.get_color(), linewidth=median.get_linewidth(), transform=trans))
+        else:
+            point = orig_handle[1]
+            artists.append(Line2D([(left+right)/2], [yc], linestyle='', marker=point.get_marker(), color=point.get_color(),
+                                  markersize=point.get_markersize(), markeredgewidth=point.get_markeredgewidth(), transform=trans))
+        return artists