scitex 2.5.0__py3-none-any.whl → 2.7.3__py3-none-any.whl

scitex/{vis/io/canvas.py → fig/io/_canvas.py}

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/canvas.py
 """
-Canvas JSON operations for scitex.vis.
+Canvas JSON operations for scitex.fig.
 
 Handles saving, loading, and updating canvas.json files.
 """
@@ -13,7 +13,7 @@ from typing import Dict, Any, Union, Optional
 from datetime import datetime
 import json
 
-from .directory import get_canvas_directory_path, SCHEMA_VERSION
+from ._directory import get_canvas_directory_path, SCHEMA_VERSION
 
 
 def _get_empty_canvas_template(canvas_name: str) -> Dict[str, Any]:
@@ -144,11 +144,13 @@ def load_canvas_json(
 
     # Verify data hashes if requested
     if verify_data_hashes and canvas_json.get("data_files"):
-        from .data import verify_all_data_hashes
+        from ._data import verify_all_data_hashes
+
         hash_results = verify_all_data_hashes(project_dir, canvas_name)
         invalid_files = [f for f, valid in hash_results.items() if not valid]
         if invalid_files:
-            from .data import HashMismatchError
+            from ._data import HashMismatchError
+
             raise HashMismatchError(
                 f"Data file hash mismatch for: {', '.join(invalid_files)}"
             )
@@ -217,7 +219,9 @@ def get_canvas_schema_version(
         Schema version string or None if not found
     """
     try:
-        canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
+        canvas_json = load_canvas_json(
+            project_dir, canvas_name, verify_data_hashes=False
+        )
         return canvas_json.get("schema_version")
     except FileNotFoundError:
         return None

scitex/{vis/io/data.py → fig/io/_data.py}

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/data.py
 """
-Data operations for scitex.vis.
+Data operations for scitex.fig.
 
 Handles SHA256 hash computation and verification for data integrity.
 """
@@ -15,6 +15,7 @@ import hashlib
 
 class HashMismatchError(Exception):
     """Raised when a data file hash doesn't match expected value."""
+
     pass
 
 
@@ -92,8 +93,8 @@ def verify_all_data_hashes(
     Dict[str, bool]
         Dictionary mapping file paths to validation results
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
 
@@ -103,6 +104,7 @@ def verify_all_data_hashes(
         return {}
 
     import json
+
     with open(json_path, "r") as f:
         canvas_json = json.load(f)
 
@@ -140,8 +142,8 @@ def update_data_hash(
     str
         New hash value
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json, save_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json, save_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     filepath = canvas_dir / rel_path
@@ -161,10 +163,12 @@ def update_data_hash(
     if not found:
         if "data_files" not in canvas_json:
             canvas_json["data_files"] = []
-        canvas_json["data_files"].append({
-            "path": rel_path,
-            "hash": new_hash,
-        })
+        canvas_json["data_files"].append(
+            {
+                "path": rel_path,
+                "hash": new_hash,
+            }
+        )
 
     save_canvas_json(project_dir, canvas_name, canvas_json)
 
@@ -190,7 +194,7 @@ def list_data_files(
     Dict[str, str]
         Dictionary mapping file paths to hash values
     """
-    from .canvas import load_canvas_json
+    from ._canvas import load_canvas_json
 
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 

scitex/{vis/io/directory.py → fig/io/_directory.py}

@@ -36,7 +36,7 @@ def _normalize_canvas_name(canvas_name: str) -> str:
 def _strip_canvas_extension(canvas_name: str) -> str:
     """Remove .canvas extension from canvas_name."""
     if canvas_name.endswith(CANVAS_EXTENSION):
-        return canvas_name[:-len(CANVAS_EXTENSION)]
+        return canvas_name[: -len(CANVAS_EXTENSION)]
     return canvas_name
 
 
@@ -75,8 +75,9 @@ def ensure_canvas_directory(
     # Create empty canvas.json if not exists
     json_path = canvas_dir / "canvas.json"
     if not json_path.exists():
-        from .canvas import _get_empty_canvas_template
+        from ._canvas import _get_empty_canvas_template
         import json
+
         # Use the name without extension for canvas_name in JSON
         base_name = _strip_canvas_extension(canvas_name)
         template = _get_empty_canvas_template(base_name)
@@ -137,9 +138,11 @@ def list_canvas_directories(
     # Find .canvas directories that contain canvas.json
     canvas_names = []
     for item in sorted(parent_dir.iterdir()):
-        if (item.is_dir()
+        if (
+            item.is_dir()
             and item.name.endswith(CANVAS_EXTENSION)
-            and (item / "canvas.json").exists()):
+            and (item / "canvas.json").exists()
+        ):
             if include_extension:
                 canvas_names.append(item.name)
             else:

scitex/{vis/io/export.py → fig/io/_export.py}

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/export.py
 """
-Export operations for scitex.vis.
+Export operations for scitex.fig.
 
 Handles composing and exporting canvas to various formats (PNG, PDF, SVG).
 """
@@ -42,8 +42,8 @@ def export_canvas_to_file(
     Path
         Path to exported file in exports/ directory
     """
-    from .directory import get_canvas_directory_path
-    from .canvas import load_canvas_json
+    from ._directory import get_canvas_directory_path
+    from ._canvas import load_canvas_json
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
@@ -130,7 +130,7 @@ def list_canvas_exports(
     List[Path]
         List of paths in exports/ directory
     """
-    from .directory import get_canvas_directory_path
+    from ._directory import get_canvas_directory_path
 
     canvas_dir = get_canvas_directory_path(project_dir, canvas_name)
     exports_dir = canvas_dir / "exports"
@@ -179,10 +179,7 @@ def _compose_and_export(
         fig.patch.set_facecolor(bg_color)
 
     # Sort panels by z_index
-    panels = sorted(
-        canvas_json.get("panels", []),
-        key=lambda p: p.get("z_index", 0)
-    )
+    panels = sorted(canvas_json.get("panels", []), key=lambda p: p.get("z_index", 0))
 
     # Place each panel
     for panel in panels:
@@ -361,11 +358,14 @@ def _add_panel_label(ax, label: Dict[str, Any]) -> None:
     x, y, ha, va = pos_map.get(position, pos_map["top-left"])
 
     ax.text(
-        x, y, text,
+        x,
+        y,
+        text,
         transform=ax.transAxes,
         fontsize=fontsize,
         fontweight=fontweight,
-        ha=ha, va=va,
+        ha=ha,
+        va=va,
     )
 
 
@@ -385,7 +385,8 @@ def _add_annotations(
             y = 1 - pos.get("y_mm", 0) / canvas_height_mm
 
             fig.text(
-                x, y,
+                x,
+                y,
                 ann.get("content", ""),
                 fontsize=ann.get("fontsize", 10),
                 color=ann.get("color", "#000000"),
@@ -406,7 +407,8 @@ def _add_title(
     y = 1 - pos.get("y_mm", 5) / canvas_height_mm
 
     fig.text(
-        x, y,
+        x,
+        y,
         title_config.get("text", ""),
         fontsize=title_config.get("fontsize", 14),
         ha="center",
@@ -448,7 +450,8 @@ def _add_caption(
     wrapped_text = textwrap.fill(text, width=wrap_width)
 
     fig.text(
-        x, y_norm,
+        x,
+        y_norm,
         wrapped_text,
         fontsize=fontsize,
         ha="left",

scitex/{vis/io/load.py → fig/io/_load.py}

@@ -47,7 +47,7 @@ def load_figure_json(
 
     # Validate if requested
     if validate:
-        from ..backend.parser import validate_figure_json
+        from ..backend._parser import validate_figure_json
 
         validate_figure_json(fig_json)
 
@@ -115,7 +115,7 @@ def load_figure_model(
 
     Examples
     --------
-    >>> from scitex.vis.io import load_figure_model
+    >>> from scitex.fig.io import load_figure_model
     >>> fig_model = load_figure_model("figure.json")
     >>> fig_model.width_mm
     180

scitex/{vis/io/panel.py → fig/io/_panel.py}

@@ -3,7 +3,7 @@
 # Timestamp: 2025-12-08
 # File: ./src/scitex/vis/io/panel.py
 """
-Panel operations for scitex.vis.
+Panel operations for scitex.fig.
 
 Handles adding, removing, updating, and listing panels within a canvas.
 Panels can be either 'scitex' type (full stx.plt output) or 'image' type (static image).
@@ -13,9 +13,9 @@ from pathlib import Path
 from typing import Dict, Any, Union, List, Optional
 import shutil
 
-from .directory import get_canvas_directory_path
-from .canvas import load_canvas_json, save_canvas_json
-from .data import compute_file_hash
+from ._directory import get_canvas_directory_path
+from ._canvas import load_canvas_json, save_canvas_json
+from ._data import compute_file_hash
 
 
 def _symlink_or_copy(source: Path, dest: Path, bundle: bool = False) -> None:
@@ -142,7 +142,9 @@ def add_panel_from_scitex(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     # Remove existing panel with same name
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Add new panel
     canvas_json["panels"].append(panel_entry)
@@ -153,13 +155,14 @@ def add_panel_from_scitex(
         csv_hash = compute_file_hash(panel_dir / "panel.csv")
         # Remove existing reference
         canvas_json["data_files"] = [
-            d for d in canvas_json.get("data_files", [])
-            if d.get("path") != csv_path
+            d for d in canvas_json.get("data_files", []) if d.get("path") != csv_path
         ]
-        canvas_json["data_files"].append({
-            "path": csv_path,
-            "hash": csv_hash,
-        })
+        canvas_json["data_files"].append(
+            {
+                "path": csv_path,
+                "hash": csv_hash,
+            }
+        )
 
     save_canvas_json(project_dir, canvas_name, canvas_json)
 
@@ -222,7 +225,9 @@ def add_panel_from_image(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     # Remove existing panel with same name
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Add new panel
     canvas_json["panels"].append(panel_entry)
@@ -261,11 +266,14 @@ def remove_panel(
     canvas_json = load_canvas_json(project_dir, canvas_name, verify_data_hashes=False)
 
     original_count = len(canvas_json["panels"])
-    canvas_json["panels"] = [p for p in canvas_json["panels"] if p.get("name") != panel_name]
+    canvas_json["panels"] = [
+        p for p in canvas_json["panels"] if p.get("name") != panel_name
+    ]
 
     # Remove data file references for this panel
     canvas_json["data_files"] = [
-        d for d in canvas_json.get("data_files", [])
+        d
+        for d in canvas_json.get("data_files", [])
         if not d.get("path", "").startswith(f"panels/{panel_name}/")
     ]
 

scitex/{vis/io/save.py → fig/io/_save.py}

@@ -119,7 +119,7 @@ def save_figure_model(
 
     Examples
     --------
-    >>> from scitex.vis.model import FigureModel
+    >>> from scitex.fig.model import FigureModel
     >>> fig_model = FigureModel(width_mm=180, height_mm=120)
     >>> save_figure_model(fig_model, "figure.json")
     PosixPath('figure.json')

scitex/{vis → fig}/model/__init__.py

@@ -2,18 +2,18 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/__init__.py
 """
-JSON models for scitex.vis figure specifications.
+JSON models for scitex.fig figure specifications.
 
 This module provides dataclass-based models for representing
 publication-quality figures as JSON structures.
 """
 
-from .figure import FigureModel
-from .axes import AxesModel
-from .plot import PlotModel
-from .guides import GuideModel
-from .annotations import AnnotationModel
-from .styles import (
+from ._figure import FigureModel
+from ._axes import AxesModel
+from ._plot import PlotModel
+from ._guides import GuideModel
+from ._annotations import AnnotationModel
+from ._styles import (
     PlotStyle,
     AxesStyle,
     GuideStyle,
@@ -24,7 +24,7 @@ from .styles import (
     copy_text_style,
     apply_style_to_plots,
 )
-from .plot_types import (
+from ._plot_types import (
     # Registry
     PLOT_TYPE_CONFIGS,
     get_plot_config_class,

scitex/{vis/model/annotations.py → fig/model/_annotations.py}

@@ -1,12 +1,12 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/annotations.py
-"""Annotation JSON model for scitex.vis."""
+"""Annotation JSON model for scitex.fig."""
 
 from typing import Optional, Dict, Any, Tuple
 from dataclasses import dataclass, field, asdict
 
-from .styles import TextStyle
+from ._styles import TextStyle
 
 
 @dataclass
@@ -94,9 +94,7 @@ class AnnotationModel:
         # Type-specific validation
         if self.annotation_type in ["text", "annotate"]:
             if not self.text:
-                raise ValueError(
-                    f"{self.annotation_type} requires 'text' parameter"
-                )
+                raise ValueError(f"{self.annotation_type} requires 'text' parameter")
 
         if self.annotation_type == "annotate":
             if self.xytext is None:

scitex/{vis/model/axes.py → fig/model/_axes.py}

@@ -1,12 +1,12 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/axes.py
-"""Axes JSON model for scitex.vis."""
+"""Axes JSON model for scitex.fig."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import AxesStyle
+from ._styles import AxesStyle
 
 
 @dataclass

scitex/{vis/model/figure.py → fig/model/_figure.py}

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/figure.py
-"""Figure JSON model for scitex.vis."""
+"""Figure JSON model for scitex.fig."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict

scitex/{vis/model/guides.py → fig/model/_guides.py}

@@ -1,12 +1,12 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/guides.py
-"""Guide elements (lines, spans) JSON model for scitex.vis."""
+"""Guide elements (lines, spans) JSON model for scitex.fig."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import GuideStyle
+from ._styles import GuideStyle
 
 
 @dataclass

scitex/{vis/model/plot.py → fig/model/_plot.py}

@@ -1,12 +1,12 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/plot.py
-"""Plot JSON model for scitex.vis."""
+"""Plot JSON model for scitex.fig."""
 
 from typing import Optional, List, Dict, Any
 from dataclasses import dataclass, field, asdict
 
-from .styles import PlotStyle
+from ._styles import PlotStyle
 
 
 @dataclass
@@ -104,9 +104,7 @@ class PlotModel:
         # Type-specific validation
         if self.plot_type in ["heatmap", "imshow"]:
             if "z" not in self.data and "img" not in self.data:
-                raise ValueError(
-                    f"{self.plot_type} requires 'z' or 'img' in data"
-                )
+                raise ValueError(f"{self.plot_type} requires 'z' or 'img' in data")
 
         elif self.plot_type in ["line", "scatter", "errorbar"]:
             if "x" not in self.data or "y" not in self.data:

scitex/{vis/model/styles.py → fig/model/_styles.py}

@@ -2,7 +2,7 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/model/styles.py
 """
-Style dataclasses for scitex.vis objects.
+Style dataclasses for scitex.fig objects.
 
 Separating style properties from data makes:
 - UI property panels easy to auto-generate

scitex/{vis → fig}/utils/__init__.py

@@ -2,13 +2,13 @@
 # -*- coding: utf-8 -*-
 # File: ./src/scitex/vis/utils/__init__.py
 """
-Utilities for scitex.vis.
+Utilities for scitex.fig.
 
 Includes validation functions and default templates for
 common publication formats.
 """
 
-from .validate import (
+from ._validate import (
     validate_json_structure,
     validate_plot_data,
     check_schema_version,
@@ -16,7 +16,7 @@ from .validate import (
     validate_axes_layout,
 )
 
-from .defaults import (
+from ._defaults import (
     # Constants
     NATURE_SINGLE_COLUMN_MM,
     NATURE_DOUBLE_COLUMN_MM,

scitex/{vis/utils/defaults.py → fig/utils/_defaults.py}

@@ -313,8 +313,7 @@ def get_template(name: str, **kwargs) -> Dict[str, Any]:
     """
     if name not in TEMPLATES:
         raise ValueError(
-            f"Unknown template: {name}. "
-            f"Available: {list(TEMPLATES.keys())}"
+            f"Unknown template: {name}. Available: {list(TEMPLATES.keys())}"
         )
 
     return TEMPLATES[name](**kwargs)

scitex/{vis/utils/validate.py → fig/utils/_validate.py}

@@ -44,9 +44,7 @@ def validate_json_structure(fig_json: Dict[str, Any]) -> bool:
         raise ValueError(f"width_mm must be positive, got {fig_json['width_mm']}")
 
     if fig_json["height_mm"] <= 0:
-        raise ValueError(
-            f"height_mm must be positive, got {fig_json['height_mm']}"
-        )
+        raise ValueError(f"height_mm must be positive, got {fig_json['height_mm']}")
 
     # Optional fields validation
     if "nrows" in fig_json:
@@ -103,9 +101,7 @@ def validate_plot_data(plot_data: Dict[str, Any]) -> bool:
         y_len = len(data["y"]) if hasattr(data["y"], "__len__") else 1
 
         if x_len != y_len:
-            raise ValueError(
-                f"x and y data must have same length: {x_len} != {y_len}"
-            )
+            raise ValueError(f"x and y data must have same length: {x_len} != {y_len}")
 
     elif plot_type in ["bar", "barh"]:
         if "x" not in data:
@@ -170,9 +166,7 @@ def validate_color(color: str) -> bool:
     return True
 
 
-def validate_axes_layout(
-    nrows: int, ncols: int, num_axes: int
-) -> bool:
+def validate_axes_layout(nrows: int, ncols: int, num_axes: int) -> bool:
     """
     Validate axes layout is consistent.
 

scitex/gen/_DimHandler.py

@@ -78,9 +78,9 @@ class DimHandler:
         Returns:
             x_flattened (numpy.ndarray): The reshaped array with kept dimensions moved to the end.
         """
-        assert len(keepdims) <= len(
-            x.shape
-        ), "keepdims cannot have more dimensions than the array itself."
+        assert len(keepdims) <= len(x.shape), (
+            "keepdims cannot have more dimensions than the array itself."
+        )
 
         # Normalize negative indices to positive indices
         total_dims = len(x.shape)
@@ -117,9 +117,9 @@ class DimHandler:
         Note:
             This method modifies the `orig_shape`, `keepdims`, `n_non_keepdims`, and `n_keepdims` attributes based on the input.
         """
-        assert len(keepdims) <= len(
-            x.shape
-        ), "keepdims cannot have more dimensions than the tensor itself."
+        assert len(keepdims) <= len(x.shape), (
+            "keepdims cannot have more dimensions than the tensor itself."
+        )
 
         keepdims = torch.tensor(keepdims).clone().detach().cpu().int()
         # Normalize negative indices to positive indices

scitex/gen/__init__.py

@@ -7,6 +7,7 @@ from ._alternate_kwarg import alternate_kwarg
 from ._cache import cache
 from ._check_host import check_host, is_host, verify_host
 from ._ci import ci
+
 # _close.py moved to old/ directory - functionality now in scitex.session
 from ._embed import embed
 from ._inspect_module import inspect_module
@@ -31,7 +32,10 @@ from ._src import src
 
 # BACKWARD COMPATIBILITY: Import deprecated wrappers
 from ._deprecated_start import start as _deprecated_start
-from ._deprecated_close import close as _deprecated_close, running2finished as _deprecated_running2finished
+from ._deprecated_close import (
+    close as _deprecated_close,
+    running2finished as _deprecated_running2finished,
+)
 
 # Override the imported functions with deprecated wrappers
 start = _deprecated_start

scitex/gen/_deprecated_close.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------

scitex/gen/_deprecated_start.py

@@ -14,13 +14,15 @@ from scitex.decorators._deprecated import deprecated
 
 @deprecated(
     reason="Use scitex.session.start instead. The old interface will be removed in a future version.",
-    forward_to="..session.start"
+    forward_to="..session.start",
 )
 def start(*args, **kwargs):
     """This docstring will be auto-generated by the @deprecated decorator."""
     # This function body will never be executed due to forwarding
     # but we need a placeholder implementation
-    raise NotImplementedError("This function should be forwarded by the @deprecated decorator")
+    raise NotImplementedError(
+        "This function should be forwarded by the @deprecated decorator"
+    )
 
 
-__all__ = ['start']
+__all__ = ["start"]