jarvisplot 1.2.5__tar.gz → 1.3.1__tar.gz

{jarvisplot-1.2.5 → jarvisplot-1.3.1/JarvisPLOT.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
-Name: jarvisplot
-Version: 1.2.5
-Summary: JarvisPLOT: YAML-driven plotting engine
+Name: JarvisPLOT
+Version: 1.3.1
+Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: loguru
@@ -10,6 +10,7 @@ Requires-Dist: jsonschema
 Requires-Dist: Jarvis-Operas>=1.1.4
 Requires-Dist: numpy
 Requires-Dist: pandas
+Requires-Dist: polars
 Requires-Dist: matplotlib
 Requires-Dist: h5py
 Requires-Dist: sympy
@@ -17,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
@@ -40,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
@@ -55,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.
@@ -75,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.
 
 ---
 
@@ -102,6 +121,19 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Developer Docs
+
+Tracked architecture and maintenance docs now live in `docs/dev/`.
+
+- `docs/dev/ARCHITECTURE_OVERVIEW.md`
+- `docs/dev/DATAFLOW_ARCHITECTURE.md`
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md`
+- `docs/dev/DEVELOPER_RULES.md`
+- `docs/dev/MEMTRACE_SYSTEM.md`
+- `docs/dev/CONTRIBUTION_GUIDE.md`
+
+These documents describe the 1.3.0 selection-table pipeline architecture that 1.3.1 consolidates. Future work should preserve the narrow-table dataflow and must not reintroduce wide-table profiling or cache payloads.
+
 ---
 
 ## License

{jarvisplot-1.2.5/jarvisplot.egg-info → jarvisplot-1.3.1/JarvisPLOT.egg-info}/SOURCES.txt

@@ -1,5 +1,11 @@
 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
@@ -8,12 +14,7 @@ jarvisplot/config.py
 jarvisplot/core.py
 jarvisplot/data_loader.py
 jarvisplot/inner_func.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/memtrace.py
 jarvisplot/Figure/__init__.py
 jarvisplot/Figure/adapters.py
 jarvisplot/Figure/data_pipelines.py

{jarvisplot-1.2.5/jarvisplot.egg-info → jarvisplot-1.3.1/JarvisPLOT.egg-info}/requires.txt

@@ -4,6 +4,7 @@ jsonschema
 Jarvis-Operas>=1.1.4
 numpy
 pandas
+polars
 matplotlib
 h5py
 sympy

{jarvisplot-1.2.5/jarvisplot.egg-info → jarvisplot-1.3.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
-Name: jarvisplot
-Version: 1.2.5
-Summary: JarvisPLOT: YAML-driven plotting engine
+Name: JarvisPLOT
+Version: 1.3.1
+Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 Requires-Dist: loguru
@@ -10,6 +10,7 @@ Requires-Dist: jsonschema
 Requires-Dist: Jarvis-Operas>=1.1.4
 Requires-Dist: numpy
 Requires-Dist: pandas
+Requires-Dist: polars
 Requires-Dist: matplotlib
 Requires-Dist: h5py
 Requires-Dist: sympy
@@ -17,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
@@ -40,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
@@ -55,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.
@@ -75,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.
 
 ---
 
@@ -102,6 +121,19 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Developer Docs
+
+Tracked architecture and maintenance docs now live in `docs/dev/`.
+
+- `docs/dev/ARCHITECTURE_OVERVIEW.md`
+- `docs/dev/DATAFLOW_ARCHITECTURE.md`
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md`
+- `docs/dev/DEVELOPER_RULES.md`
+- `docs/dev/MEMTRACE_SYSTEM.md`
+- `docs/dev/CONTRIBUTION_GUIDE.md`
+
+These documents describe the 1.3.0 selection-table pipeline architecture that 1.3.1 consolidates. Future work should preserve the narrow-table dataflow and must not reintroduce wide-table profiling or cache payloads.
+
 ---
 
 ## License

{jarvisplot-1.2.5 → jarvisplot-1.3.1}/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,19 @@ jplot ./bin/SUSYRun2_GEWMSSM.yaml
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
+### Developer Docs
+
+Tracked architecture and maintenance docs now live in `docs/dev/`.
+
+- `docs/dev/ARCHITECTURE_OVERVIEW.md`
+- `docs/dev/DATAFLOW_ARCHITECTURE.md`
+- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md`
+- `docs/dev/DEVELOPER_RULES.md`
+- `docs/dev/MEMTRACE_SYSTEM.md`
+- `docs/dev/CONTRIBUTION_GUIDE.md`
+
+These documents describe the 1.3.0 selection-table pipeline architecture that 1.3.1 consolidates. Future work should preserve the narrow-table dataflow and must not reintroduce wide-table profiling or cache payloads.
+
 ---
 
 ## License

jarvisplot-1.3.1/jarvisplot/Figure/data_pipelines.py

@@ -0,0 +1,165 @@
+#!/usr/bin/env python3 
+
+#!/usr/bin/env python3
+from __future__ import annotations
+from typing import Any, Callable, Dict, Optional
+import threading
+
+class SharedContent:
+    """
+    Session-level variable shared storage for all Figures (supports lazy evaluation and updates).
+    - register(name, compute_fn): Register a lazy evaluation function.
+    - get(name): Return cached value if available; otherwise, compute using compute_fn and cache the result.
+    - update(name, value): Explicitly write or overwrite a value.
+    - invalidate(name=None): Invalidate a specific entry or all entries.
+    - stats(): Diagnostic information.
+    """
+    def __init__(self, seed: Optional[int] = None, logger: Any = None):
+        self._logger = logger
+        self._seed = seed
+        self._store: Dict[str, Any] = {}
+        self._registry: Dict[str, Callable[[SharedContent], Any]] = {}
+        self._release_registry: Dict[str, Callable[[], None]] = {}
+        self._remaining_uses: Dict[str, int] = {}
+        self._lock = threading.RLock()
+
+    # ---- 懒计算接口 ----
+    def register(
+        self,
+        name: str,
+        compute_fn: Callable[[SharedContent], Any],
+        release_fn: Optional[Callable[[], None]] = None,
+    ) -> None:
+        with self._lock:
+            self._registry[name] = compute_fn
+            if release_fn is not None:
+                self._release_registry[name] = release_fn
+            if self._logger:
+                self._logger.debug(f"SharedContent: register -> {name}")
+
+    def get(self, name: str) -> Any:
+        with self._lock:
+            if name in self._store:
+                return self._store[name]
+            if name in self._registry:
+                if self._logger:
+                    self._logger.debug(f"SharedContent: MISS -> {name}; computing...")
+                val = self._registry[name](self)
+                self._store[name] = val
+                return val
+            if self._logger:
+                self._logger.debug(f"SharedContent: MISS (no registry) -> {name}; returning None")
+            return None
+
+    def update(self, name: str, value: Any, release_fn: Optional[Callable[[], None]] = None) -> None:
+        with self._lock:
+            self._store[name] = value
+            if release_fn is not None:
+                self._release_registry[name] = release_fn
+            if self._logger:
+                self._logger.debug(f"SharedContent: update -> {name}")
+
+    def invalidate(self, name: Optional[str] = None) -> None:
+        with self._lock:
+            if name is None:
+                for key, release_fn in list(self._release_registry.items()):
+                    try:
+                        release_fn()
+                    except Exception:
+                        pass
+                self._store.clear()
+                if self._logger:
+                    self._logger.debug("SharedContent: invalidate ALL")
+            else:
+                self._store.pop(name, None)
+                release_fn = self._release_registry.get(name)
+                if release_fn is not None:
+                    try:
+                        release_fn()
+                    except Exception:
+                        pass
+                if self._logger:
+                    self._logger.debug(f"SharedContent: invalidate -> {name}")
+
+    def set_usage_plan(self, counts: Dict[str, int]) -> None:
+        with self._lock:
+            self._remaining_uses = {}
+            for name, count in counts.items():
+                try:
+                    ival = int(count)
+                except Exception:
+                    continue
+                if ival >= 0:
+                    self._remaining_uses[str(name)] = ival
+            if self._logger:
+                self._logger.debug(
+                    "SharedContent: usage plan loaded -> {}".format(
+                        ", ".join(f"{k}:{v}" for k, v in sorted(self._remaining_uses.items()))
+                    )
+                )
+
+    def remaining_uses(self, name: str) -> int:
+        with self._lock:
+            return int(self._remaining_uses.get(str(name), 0))
+
+    def consume(self, name: str, amount: int = 1) -> int:
+        key = str(name)
+        with self._lock:
+            if key not in self._remaining_uses:
+                return 0
+            try:
+                dec = max(int(amount), 0)
+            except Exception:
+                dec = 0
+            remain = max(int(self._remaining_uses.get(key, 0)) - dec, 0)
+            self._remaining_uses[key] = remain
+            if self._logger:
+                self._logger.debug(f"SharedContent: consume -> {key}, remain={remain}")
+        if remain == 0:
+            self.invalidate(key)
+        return remain
+
+    def stats(self) -> Dict[str, int]:
+        with self._lock:
+            return {
+                "cached": len(self._store),
+                "registered": len(self._registry),
+                "tracked": len(self._remaining_uses),
+            }
+
+class DataContext:
+    """
+    Inject it into the facade of each Figure to isolate the Figure from the core implementation.
+    Figures use it to get, update, register, and invalidate shared content.
+    """
+    def __init__(self, shared: SharedContent):
+        self._shared = shared
+
+    def get(self, name: str) -> Any:
+        return self._shared.get(name)
+
+    def update(self, name: str, value: Any, release_fn: Optional[Callable[[], None]] = None) -> None:
+        self._shared.update(name, value, release_fn=release_fn)
+
+    def register(
+        self,
+        name: str,
+        compute_fn: Callable[[SharedContent], Any],
+        release_fn: Optional[Callable[[], None]] = None,
+    ) -> None:
+        self._shared.register(name, compute_fn, release_fn=release_fn)
+
+    def invalidate(self, name: Optional[str] = None) -> None:
+        self._shared.invalidate(name)
+
+    def set_usage_plan(self, counts: Dict[str, int]) -> None:
+        self._shared.set_usage_plan(counts)
+
+    def remaining_uses(self, name: str) -> int:
+        return self._shared.remaining_uses(name)
+
+    def consume(self, name: str, amount: int = 1) -> int:
+        return self._shared.consume(name, amount=amount)
+
+    def stats(self) -> Dict[str, int]:
+        return self._shared.stats()