jarvisplot 1.3.0__tar.gz → 1.3.2__tar.gz

{jarvisplot-1.3.0 → jarvisplot-1.3.2/JarvisPLOT.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
-Name: jarvisplot
-Version: 1.3.0
-Summary: JarvisPLOT: YAML-driven plotting engine
+Name: JarvisPLOT
+Version: 1.3.2
+Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: loguru
@@ -18,19 +18,37 @@ Requires-Dist: scipy
 Requires-Dist: shapely
 Requires-Dist: deepmerge
 
-# JarvisPLOT
+# Jarvis-PLOT
 
-JarvisPLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
+Jarvis-PLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
 but it can also be used as a **standalone scientific plotting tool**.
 
 It provides a simple command-line interface (CLI) to generate publication-quality figures from YAML configuration files, with most layout and style decisions handled by predefined profiles and style cards.
 
 ---
 
-## Installation 
+## Installation
 
-```bash 
-pip install jarvisplot
+```bash
+pip install Jarvis-PLOT
+```
+
+The PyPI distribution name is now `Jarvis-PLOT`.
+The Python import package and entrypoint remain unchanged:
+
+```python
+import jarvisplot
+```
+
+```bash
+jplot path/to/config.yaml
+```
+
+If you have an older environment that still uses the historical package name, replace:
+
+```bash
+pip uninstall jarvisplot
+pip install Jarvis-PLOT
 ```
 
 ## Command-Line Usage
@@ -41,7 +59,7 @@ Display help information:
 jplot -h
 ```
 
-Run JarvisPLOT with one or more YAML configuration files:
+Run Jarvis-PLOT with one or more YAML configuration files:
 
 ```bash
 jplot path/to/config.yaml
@@ -56,7 +74,7 @@ jplot path/to/config.yaml --rebuild-cache
 ### Project Workdir and Cache
 
 - You can set `project.workdir` in YAML.
-- If `output.dir` is omitted, JarvisPLOT now defaults to `<workdir>/plots/`.
+- If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
 - 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.
@@ -76,7 +94,7 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 
 - Figures are saved automatically to the output paths defined in the YAML configuration.
 - Common output formats include PNG and PDF (backend-dependent).
-- JarvisPLOT works in headless environments (SSH, batch jobs) without any GUI backend.
+- Jarvis-PLOT works in headless environments (SSH, batch jobs) without any GUI backend.
 
 ---
 
@@ -103,6 +121,20 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Repository Docs
+
+Tracked project docs live in `docs/`.
+
+- `docs/README.md` - repo doc index
+- `docs/context/JARVIS_PLOT_CONTEXT.md` - primary Codex-facing boundary doc
+- `docs/context/CODE_MAP_JARVIS_PLOT.md` - concrete code owner map
+- `docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md` - runtime execution contract
+- `docs/roadmap/IMPLEMENTATION_ROADMAP.md` - active backlog and future work list
+- `docs/dev/DEVELOPER_RULES.md` - current pipeline and cache rules
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md` - narrow-table memory notes
+
+Read the context docs and roadmap before changing parsing, transforms, rendering, or layout-related behavior.
+
 ---
 
 ## License

{jarvisplot-1.3.0/jarvisplot.egg-info → jarvisplot-1.3.2/JarvisPLOT.egg-info}/SOURCES.txt

@@ -1,28 +1,42 @@
 README.md
 pyproject.toml
+JarvisPLOT.egg-info/PKG-INFO
+JarvisPLOT.egg-info/SOURCES.txt
+JarvisPLOT.egg-info/dependency_links.txt
+JarvisPLOT.egg-info/entry_points.txt
+JarvisPLOT.egg-info/requires.txt
+JarvisPLOT.egg-info/top_level.txt
 jarvisplot/__init__.py
 jarvisplot/cache_store.py
 jarvisplot/cli.py
 jarvisplot/client.py
 jarvisplot/config.py
 jarvisplot/core.py
+jarvisplot/core_assets.py
+jarvisplot/core_runtime.py
 jarvisplot/data_loader.py
+jarvisplot/data_loader_hdf5.py
+jarvisplot/data_loader_runtime.py
+jarvisplot/data_loader_summary.py
 jarvisplot/inner_func.py
 jarvisplot/memtrace.py
-jarvisplot.egg-info/PKG-INFO
-jarvisplot.egg-info/SOURCES.txt
-jarvisplot.egg-info/dependency_links.txt
-jarvisplot.egg-info/entry_points.txt
-jarvisplot.egg-info/requires.txt
-jarvisplot.egg-info/top_level.txt
 jarvisplot/Figure/__init__.py
 jarvisplot/Figure/adapters.py
+jarvisplot/Figure/adapters_rect.py
+jarvisplot/Figure/adapters_ternary.py
+jarvisplot/Figure/colorbar_runtime.py
+jarvisplot/Figure/config_runtime.py
 jarvisplot/Figure/data_pipelines.py
 jarvisplot/Figure/figure.py
 jarvisplot/Figure/helper.py
+jarvisplot/Figure/layer_runtime.py
+jarvisplot/Figure/layout_runtime.py
 jarvisplot/Figure/load_data.py
 jarvisplot/Figure/method_registry.py
 jarvisplot/Figure/preprocessor.py
+jarvisplot/Figure/preprocessor_runtime.py
+jarvisplot/Figure/profile_runtime.py
+jarvisplot/Figure/style_runtime.py
 jarvisplot/Figure/cards/std_axes_adapter_config.json
 jarvisplot/cards/args.json
 jarvisplot/cards/style_preference.json
@@ -47,4 +61,11 @@ jarvisplot/cards/icons/gambit.png
 jarvisplot/cards/icons/gambit_small.png
 jarvisplot/utils/__init__.py
 jarvisplot/utils/cmaps.py
-jarvisplot/utils/interpolator.py
+jarvisplot/utils/expression.py
+jarvisplot/utils/interpolator.py
+jarvisplot/utils/pathing.py
+tests/test_data_loader_contracts.py
+tests/test_docs_status_labels.py
+tests/test_figure_contracts.py
+tests/test_pathing_contracts.py
+tests/test_template_json.py

{jarvisplot-1.3.0/jarvisplot.egg-info → jarvisplot-1.3.2}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
-Name: jarvisplot
-Version: 1.3.0
-Summary: JarvisPLOT: YAML-driven plotting engine
+Name: JarvisPLOT
+Version: 1.3.2
+Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: loguru
@@ -18,19 +18,37 @@ Requires-Dist: scipy
 Requires-Dist: shapely
 Requires-Dist: deepmerge
 
-# JarvisPLOT
+# Jarvis-PLOT
 
-JarvisPLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
+Jarvis-PLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
 but it can also be used as a **standalone scientific plotting tool**.
 
 It provides a simple command-line interface (CLI) to generate publication-quality figures from YAML configuration files, with most layout and style decisions handled by predefined profiles and style cards.
 
 ---
 
-## Installation 
+## Installation
 
-```bash 
-pip install jarvisplot
+```bash
+pip install Jarvis-PLOT
+```
+
+The PyPI distribution name is now `Jarvis-PLOT`.
+The Python import package and entrypoint remain unchanged:
+
+```python
+import jarvisplot
+```
+
+```bash
+jplot path/to/config.yaml
+```
+
+If you have an older environment that still uses the historical package name, replace:
+
+```bash
+pip uninstall jarvisplot
+pip install Jarvis-PLOT
 ```
 
 ## Command-Line Usage
@@ -41,7 +59,7 @@ Display help information:
 jplot -h
 ```
 
-Run JarvisPLOT with one or more YAML configuration files:
+Run Jarvis-PLOT with one or more YAML configuration files:
 
 ```bash
 jplot path/to/config.yaml
@@ -56,7 +74,7 @@ jplot path/to/config.yaml --rebuild-cache
 ### Project Workdir and Cache
 
 - You can set `project.workdir` in YAML.
-- If `output.dir` is omitted, JarvisPLOT now defaults to `<workdir>/plots/`.
+- If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
 - 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.
@@ -76,7 +94,7 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 
 - Figures are saved automatically to the output paths defined in the YAML configuration.
 - Common output formats include PNG and PDF (backend-dependent).
-- JarvisPLOT works in headless environments (SSH, batch jobs) without any GUI backend.
+- Jarvis-PLOT works in headless environments (SSH, batch jobs) without any GUI backend.
 
 ---
 
@@ -103,6 +121,20 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Repository Docs
+
+Tracked project docs live in `docs/`.
+
+- `docs/README.md` - repo doc index
+- `docs/context/JARVIS_PLOT_CONTEXT.md` - primary Codex-facing boundary doc
+- `docs/context/CODE_MAP_JARVIS_PLOT.md` - concrete code owner map
+- `docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md` - runtime execution contract
+- `docs/roadmap/IMPLEMENTATION_ROADMAP.md` - active backlog and future work list
+- `docs/dev/DEVELOPER_RULES.md` - current pipeline and cache rules
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md` - narrow-table memory notes
+
+Read the context docs and roadmap before changing parsing, transforms, rendering, or layout-related behavior.
+
 ---
 
 ## License

{jarvisplot-1.3.0 → jarvisplot-1.3.2}/README.md

@@ -1,16 +1,34 @@
-# JarvisPLOT
+# Jarvis-PLOT
 
-JarvisPLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
+Jarvis-PLOT is a lightweight, Python/Matplotlib-based plotting framework developed for **Jarvis-HEP**,  
 but it can also be used as a **standalone scientific plotting tool**.
 
 It provides a simple command-line interface (CLI) to generate publication-quality figures from YAML configuration files, with most layout and style decisions handled by predefined profiles and style cards.
 
 ---
 
-## Installation 
+## Installation
 
-```bash 
-pip install jarvisplot
+```bash
+pip install Jarvis-PLOT
+```
+
+The PyPI distribution name is now `Jarvis-PLOT`.
+The Python import package and entrypoint remain unchanged:
+
+```python
+import jarvisplot
+```
+
+```bash
+jplot path/to/config.yaml
+```
+
+If you have an older environment that still uses the historical package name, replace:
+
+```bash
+pip uninstall jarvisplot
+pip install Jarvis-PLOT
 ```
 
 ## Command-Line Usage
@@ -21,7 +39,7 @@ Display help information:
 jplot -h
 ```
 
-Run JarvisPLOT with one or more YAML configuration files:
+Run Jarvis-PLOT with one or more YAML configuration files:
 
 ```bash
 jplot path/to/config.yaml
@@ -36,7 +54,7 @@ jplot path/to/config.yaml --rebuild-cache
 ### Project Workdir and Cache
 
 - You can set `project.workdir` in YAML.
-- If `output.dir` is omitted, JarvisPLOT now defaults to `<workdir>/plots/`.
+- If `output.dir` is omitted, Jarvis-PLOT defaults to `<workdir>/plots/`.
 - Data cache is stored in `<workdir>/.cache/`.
 - 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.
@@ -56,7 +74,7 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 
 - Figures are saved automatically to the output paths defined in the YAML configuration.
 - Common output formats include PNG and PDF (backend-dependent).
-- JarvisPLOT works in headless environments (SSH, batch jobs) without any GUI backend.
+- Jarvis-PLOT works in headless environments (SSH, batch jobs) without any GUI backend.
 
 ---
 
@@ -83,6 +101,20 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Repository Docs
+
+Tracked project docs live in `docs/`.
+
+- `docs/README.md` - repo doc index
+- `docs/context/JARVIS_PLOT_CONTEXT.md` - primary Codex-facing boundary doc
+- `docs/context/CODE_MAP_JARVIS_PLOT.md` - concrete code owner map
+- `docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md` - runtime execution contract
+- `docs/roadmap/IMPLEMENTATION_ROADMAP.md` - active backlog and future work list
+- `docs/dev/DEVELOPER_RULES.md` - current pipeline and cache rules
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md` - narrow-table memory notes
+
+Read the context docs and roadmap before changing parsing, transforms, rendering, or layout-related behavior.
+
 ---
 
 ## License

jarvisplot-1.3.2/jarvisplot/Figure/adapters.py

@@ -0,0 +1,6 @@
+#!/usr/bin/env python3
+
+from .adapters_rect import StdAxesAdapter
+from .adapters_ternary import TernaryAxesAdapter
+
+__all__ = ["StdAxesAdapter", "TernaryAxesAdapter"]

jarvisplot-1.3.0/jarvisplot/Figure/adapters.py → jarvisplot-1.3.2/jarvisplot/Figure/adapters_rect.py

@@ -13,6 +13,7 @@ from .helper import _auto_clip, _mask_by_extend, voronoi_finite_polygons_2d, _cl
 
 
 # —— Basic Adapter: Forward to the underlying Axes, merge default parameters, perform automatic clipping ——
+
 class StdAxesAdapter:
     def __init__(self, ax: Axes, defaults: Optional[Dict[str, Dict[str, Any]]] = None,
                  clip_path=None):
@@ -963,75 +964,3 @@ class StdAxesAdapter:
         return [palette[i % len(palette)] for i in range(n)]
 
 # —— Ternary 适配器：在 Std 基础上增加 (a,b,c)->(x,y) 投影 ——
-class TernaryAxesAdapter(StdAxesAdapter):
-    def __init__(self, ax: Axes, defaults: Optional[Dict[str, Any]] = None,
-                 clip_path=None):
-        # Allow a flat defaults dict like {"facecolor": "..."} and keep it internal.
-        d = dict(defaults) if isinstance(defaults, dict) else {}
-        facecolor = d.pop("facecolor", None)
-
-        super().__init__(ax, defaults=d or None, clip_path=clip_path)
-
-        if facecolor is not None:
-            self.set_facecolor(facecolor)
-
-        self.status = "init"
-
-    def set_facecolor(self, color, zorder=-100):
-        self.ax.fill(
-            [0.0, 1.0, 0.5],
-            [0.0, 0.0, 1.0],
-            facecolor=color,
-            edgecolor="none",
-            zorder=zorder
-        )
-
-    @staticmethod
-    def _lbr_to_xy(a, b, c):
-        s = (a + b + c)
-        s = np.where(s == 0.0, 1.0, s)  # 避免除零
-        aa, bb, cc = a/s, b/s, c/s
-        x = bb + 0.5 * cc
-        y = cc
-        return x, y
-
-    def scatter(self, **kwargs):
-        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
-            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
-            kwargs['x'] = x
-            kwargs['y'] = y
-        return super().scatter(**kwargs)
-
-    def grid_profile(self, **kwargs):
-        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
-            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
-            kwargs['x'] = x
-            kwargs['y'] = y
-        return super().grid_profile(**kwargs)
-
-
-    def plot(self, **kwargs):
-        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
-            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
-            kwargs['x'] = x
-            kwargs['y'] = y
-        return super().plot(**kwargs)
-
-
-    def tricontour(self, **kwargs):
-        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
-            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
-            kwargs['x'] = x
-            kwargs['y'] = y
-        return super().tricontour( **kwargs)
-
-
-    def tricontourf(self, **kwargs):
-        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
-            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
-            kwargs['x'] = x
-            kwargs['y'] = y
-
-        return super().tricontourf(**kwargs)
-        # else:
-        #     raise ValueError("scatter() needs either (a,b,c) or (x,y) inputs")

jarvisplot-1.3.2/jarvisplot/Figure/adapters_ternary.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+from typing import Any, Dict, Optional
+import numpy as np
+import os
+import json
+
+from matplotlib.axes import Axes
+from matplotlib.collections import PolyCollection
+#
+from .helper import _auto_clip, _mask_by_extend, voronoi_finite_polygons_2d, _clip_poly_to_rect
+from .adapters_rect import StdAxesAdapter
+
+
+# —— Basic Adapter: Forward to the underlying Axes, merge default parameters, perform automatic clipping ——
+
+class TernaryAxesAdapter(StdAxesAdapter):
+    def __init__(self, ax: Axes, defaults: Optional[Dict[str, Any]] = None,
+                 clip_path=None):
+        # Allow a flat defaults dict like {"facecolor": "..."} and keep it internal.
+        d = dict(defaults) if isinstance(defaults, dict) else {}
+        facecolor = d.pop("facecolor", None)
+
+        super().__init__(ax, defaults=d or None, clip_path=clip_path)
+
+        if facecolor is not None:
+            self.set_facecolor(facecolor)
+
+        self.status = "init"
+
+    def set_facecolor(self, color, zorder=-100):
+        self.ax.fill(
+            [0.0, 1.0, 0.5],
+            [0.0, 0.0, 1.0],
+            facecolor=color,
+            edgecolor="none",
+            zorder=zorder
+        )
+
+    @staticmethod
+    def _lbr_to_xy(a, b, c):
+        s = (a + b + c)
+        s = np.where(s == 0.0, 1.0, s)  # 避免除零
+        aa, bb, cc = a/s, b/s, c/s
+        x = bb + 0.5 * cc
+        y = cc
+        return x, y
+
+    def scatter(self, **kwargs):
+        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
+            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
+            kwargs['x'] = x
+            kwargs['y'] = y
+        return super().scatter(**kwargs)
+
+    def grid_profile(self, **kwargs):
+        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
+            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
+            kwargs['x'] = x
+            kwargs['y'] = y
+        return super().grid_profile(**kwargs)
+
+
+    def plot(self, **kwargs):
+        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
+            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
+            kwargs['x'] = x
+            kwargs['y'] = y
+        return super().plot(**kwargs)
+
+
+    def tricontour(self, **kwargs):
+        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
+            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
+            kwargs['x'] = x
+            kwargs['y'] = y
+        return super().tricontour( **kwargs)
+
+
+    def tricontourf(self, **kwargs):
+        if {"left", "right", "bottom"}.issubset(kwargs.keys()):
+            x, y = self._lbr_to_xy(kwargs.pop('left'), kwargs.pop('right'), kwargs.pop('bottom'))
+            kwargs['x'] = x
+            kwargs['y'] = y
+
+        return super().tricontourf(**kwargs)
+        # else:
+        #     raise ValueError("scatter() needs either (a,b,c) or (x,y) inputs")