scitex 2.8.1__py3-none-any.whl → 2.10.0__py3-none-any.whl

scitex/fts/_fig/_models/_Styles.py

@@ -0,0 +1,245 @@
+#!/usr/bin/env python3
+# File: ./src/scitex/vis/model/styles.py
+"""
+Style dataclasses for scitex.fig objects.
+
+Separating style properties from data makes:
+- UI property panels easy to auto-generate
+- Style copy/paste straightforward
+- Batch style application simple
+"""
+
+from dataclasses import asdict, dataclass, field
+from typing import Any, Dict, Optional
+
+
+@dataclass
+class PlotStyle:
+    """Style properties for plots."""
+
+    # Color and transparency
+    color: Optional[str] = None
+    alpha: Optional[float] = None
+
+    # Line properties
+    linewidth: Optional[float] = None
+    linestyle: Optional[str] = None
+
+    # Marker properties
+    marker: Optional[str] = None
+    markersize: Optional[float] = None
+
+    # Fill properties (for fill_between, etc.)
+    fill_color: Optional[str] = None
+    fill_alpha: Optional[float] = None
+
+    # Heatmap/image properties
+    cmap: Optional[str] = None
+    vmin: Optional[float] = None
+    vmax: Optional[float] = None
+    interpolation: Optional[str] = None
+
+    # Error bar properties
+    capsize: Optional[float] = None
+    xerr: Optional[float] = None
+    yerr: Optional[float] = None
+
+    # Bar properties
+    width: Optional[float] = None
+
+    # Histogram properties
+    bins: Optional[int] = None
+    density: bool = False
+    cumulative: bool = False
+
+    # Layering
+    zorder: Optional[int] = None
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary, omitting None values."""
+        return {k: v for k, v in asdict(self).items() if v is not None}
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "PlotStyle":
+        """Create from dictionary."""
+        return cls(**{k: v for k, v in data.items() if k in cls.__annotations__})
+
+
+@dataclass
+class AxesStyle:
+    """Style properties for axes."""
+
+    # Background
+    facecolor: Optional[str] = None
+
+    # Grid
+    grid: bool = False
+    grid_alpha: Optional[float] = 0.3
+    grid_linestyle: Optional[str] = "--"
+    grid_linewidth: Optional[float] = 0.5
+
+    # Spines visibility
+    spines_visible: Dict[str, bool] = field(
+        default_factory=lambda: {
+            "top": True,
+            "right": True,
+            "bottom": True,
+            "left": True,
+        }
+    )
+
+    # Font sizes
+    label_fontsize: Optional[float] = None
+    title_fontsize: Optional[float] = None
+    tick_fontsize: Optional[float] = None
+
+    # Legend
+    legend: bool = False
+    legend_loc: str = "best"
+    legend_fontsize: Optional[float] = None
+    legend_frameon: bool = True
+
+    # Aspect
+    aspect: Optional[str] = None  # "auto", "equal", or numeric
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary."""
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "AxesStyle":
+        """Create from dictionary."""
+        return cls(**{k: v for k, v in data.items() if k in cls.__annotations__})
+
+
+@dataclass
+class GuideStyle:
+    """Style properties for guides (reference lines/spans)."""
+
+    color: Optional[str] = None
+    alpha: Optional[float] = None
+    linestyle: Optional[str] = "--"
+    linewidth: Optional[float] = None
+    zorder: Optional[int] = None
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary, omitting None values."""
+        return {k: v for k, v in asdict(self).items() if v is not None}
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "GuideStyle":
+        """Create from dictionary."""
+        return cls(**{k: v for k, v in data.items() if k in cls.__annotations__})
+
+
+@dataclass
+class TextStyle:
+    """Style properties for text/annotations."""
+
+    fontsize: Optional[float] = None
+    fontweight: Optional[str] = None  # "normal", "bold"
+    color: Optional[str] = None
+    ha: str = "center"  # Horizontal alignment
+    va: str = "center"  # Vertical alignment
+    rotation: Optional[float] = None
+    zorder: Optional[int] = None
+
+    # Bounding box (for text background)
+    bbox: Optional[Dict[str, Any]] = None
+
+    # Arrow properties (for annotate)
+    arrowprops: Optional[Dict[str, Any]] = None
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary, omitting None values."""
+        return {k: v for k, v in asdict(self).items() if v is not None}
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "TextStyle":
+        """Create from dictionary."""
+        return cls(**{k: v for k, v in data.items() if k in cls.__annotations__})
+
+
+# ============================================================================
+# Style Copy/Paste Helpers
+# ============================================================================
+
+
+def copy_plot_style(src_plot, dst_plot) -> None:
+    """
+    Copy style from one plot to another.
+
+    Parameters
+    ----------
+    src_plot : PlotModel
+        Source plot
+    dst_plot : PlotModel
+        Destination plot
+    """
+    dst_plot.style = PlotStyle.from_dict(src_plot.style.to_dict())
+
+
+def copy_axes_style(src_axes, dst_axes) -> None:
+    """
+    Copy style from one axes to another.
+
+    Parameters
+    ----------
+    src_axes : AxesModel
+        Source axes
+    dst_axes : AxesModel
+        Destination axes
+    """
+    dst_axes.style = AxesStyle.from_dict(src_axes.style.to_dict())
+
+
+def copy_guide_style(src_guide, dst_guide) -> None:
+    """
+    Copy style from one guide to another.
+
+    Parameters
+    ----------
+    src_guide : GuideModel
+        Source guide
+    dst_guide : GuideModel
+        Destination guide
+    """
+    dst_guide.style = GuideStyle.from_dict(src_guide.style.to_dict())
+
+
+def copy_text_style(src_annotation, dst_annotation) -> None:
+    """
+    Copy style from one annotation to another.
+
+    Parameters
+    ----------
+    src_annotation : AnnotationModel
+        Source annotation
+    dst_annotation : AnnotationModel
+        Destination annotation
+    """
+    dst_annotation.style = TextStyle.from_dict(src_annotation.style.to_dict())
+
+
+def apply_style_to_plots(style: PlotStyle, plots: list) -> None:
+    """
+    Apply the same style to multiple plots.
+
+    Parameters
+    ----------
+    style : PlotStyle
+        Style to apply
+    plots : list
+        List of PlotModel objects
+
+    Examples
+    --------
+    >>> blue_style = PlotStyle(color="blue", linewidth=2, alpha=0.8)
+    >>> apply_style_to_plots(blue_style, my_plots)
+    """
+    style_dict = style.to_dict()
+    for plot in plots:
+        plot.style = PlotStyle.from_dict(style_dict)
+
+
+# EOF

scitex/fts/_fig/_models/__init__.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/__init__.py
+
+"""JSON models for FTS figure specifications."""
+
+from ._Annotations import AnnotationModel
+from ._Axes import AxesModel
+from ._Figure import FigureModel
+from ._Guides import GuideModel
+from ._Plot import PlotModel
+from ._plot_types import (
+    PLOT_TYPE_CONFIGS,
+    BarHPlotConfig,
+    BarPlotConfig,
+    BoxConfig,
+    BoxPlotConfig,
+    ContourConfig,
+    ECDFConfig,
+    ErrorbarPlotConfig,
+    FillBetweenConfig,
+    HeatmapConfig,
+    HistPlotConfig,
+    ImshowConfig,
+    KDEConfig,
+    LinePlotConfig,
+    MeanStdConfig,
+    PlotLineConfig,
+    ScatterPlotConfig,
+    SeabornBarplotConfig,
+    SeabornBoxplotConfig,
+    SeabornHistplotConfig,
+    SeabornKDEplotConfig,
+    SeabornLineplotConfig,
+    SeabornScatterplotConfig,
+    SeabornStripplotConfig,
+    SeabornViolinplotConfig,
+    ShadedLineConfig,
+    ViolinConfig,
+    ViolinPlotConfig,
+    get_plot_config_class,
+    list_plot_types,
+)
+from ._Styles import (
+    AxesStyle,
+    GuideStyle,
+    PlotStyle,
+    TextStyle,
+    apply_style_to_plots,
+    copy_axes_style,
+    copy_guide_style,
+    copy_plot_style,
+    copy_text_style,
+)
+
+__all__ = [
+    # Core models
+    "FigureModel",
+    "AxesModel",
+    "PlotModel",
+    "GuideModel",
+    "AnnotationModel",
+    # Style models
+    "PlotStyle",
+    "AxesStyle",
+    "GuideStyle",
+    "TextStyle",
+    # Style helpers
+    "copy_plot_style",
+    "copy_axes_style",
+    "copy_guide_style",
+    "copy_text_style",
+    "apply_style_to_plots",
+    # Registry
+    "PLOT_TYPE_CONFIGS",
+    "get_plot_config_class",
+    "list_plot_types",
+]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/__init__.py

@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/__init__.py
+
+"""Plot type configurations and registry."""
+
+from typing import List, Type
+
+# Line plots
+from ._line import LinePlotConfig, PlotLineConfig, ShadedLineConfig
+
+# Scatter plots
+from ._scatter import ScatterPlotConfig
+
+# Bar plots
+from ._bar import BarHPlotConfig, BarPlotConfig
+
+# Histograms
+from ._histogram import HistPlotConfig
+
+# Box plots
+from ._box import BoxConfig, BoxPlotConfig
+
+# Violin plots
+from ._violin import ViolinConfig, ViolinPlotConfig
+
+# Error bars and fill
+from ._errorbar import ErrorbarPlotConfig, FillBetweenConfig, MeanStdConfig
+
+# Image plots
+from ._image import ContourConfig, HeatmapConfig, ImshowConfig
+
+# Distribution plots
+from ._distribution import ECDFConfig, KDEConfig
+
+# Seaborn plots
+from ._seaborn import (
+    SeabornBarplotConfig,
+    SeabornBoxplotConfig,
+    SeabornHistplotConfig,
+    SeabornKDEplotConfig,
+    SeabornLineplotConfig,
+    SeabornScatterplotConfig,
+    SeabornStripplotConfig,
+    SeabornViolinplotConfig,
+)
+
+# =============================================================================
+# PLOT TYPE REGISTRY
+# =============================================================================
+
+PLOT_TYPE_CONFIGS = {
+    # Matplotlib basic
+    "line": LinePlotConfig,
+    "scatter": ScatterPlotConfig,
+    "bar": BarPlotConfig,
+    "barh": BarHPlotConfig,
+    "hist": HistPlotConfig,
+    "boxplot": BoxPlotConfig,
+    "errorbar": ErrorbarPlotConfig,
+    "fill_between": FillBetweenConfig,
+    "imshow": ImshowConfig,
+    "contour": ContourConfig,
+    "contourf": ContourConfig,
+    "violinplot": ViolinPlotConfig,
+    # Custom scitex
+    "heatmap": HeatmapConfig,
+    "stx_line": PlotLineConfig,
+    "stx_shaded_line": ShadedLineConfig,
+    "stx_violin": ViolinConfig,
+    "stx_ecdf": ECDFConfig,
+    "stx_box": BoxConfig,
+    "stx_mean_std": MeanStdConfig,
+    "stx_kde": KDEConfig,
+    # Seaborn
+    "sns_boxplot": SeabornBoxplotConfig,
+    "sns_violinplot": SeabornViolinplotConfig,
+    "sns_scatterplot": SeabornScatterplotConfig,
+    "sns_lineplot": SeabornLineplotConfig,
+    "sns_histplot": SeabornHistplotConfig,
+    "sns_barplot": SeabornBarplotConfig,
+    "sns_stripplot": SeabornStripplotConfig,
+    "sns_kdeplot": SeabornKDEplotConfig,
+}
+
+
+def get_plot_config_class(plot_type: str) -> Type:
+    """Get the configuration dataclass for a plot type.
+
+    Args:
+        plot_type: Plot type name
+
+    Returns:
+        Configuration dataclass for the plot type
+
+    Raises:
+        ValueError: If plot type is not supported
+    """
+    if plot_type not in PLOT_TYPE_CONFIGS:
+        raise ValueError(
+            f"Unknown plot type: {plot_type}. "
+            f"Supported: {list(PLOT_TYPE_CONFIGS.keys())}"
+        )
+    return PLOT_TYPE_CONFIGS[plot_type]
+
+
+def list_plot_types() -> List[str]:
+    """List all supported plot types."""
+    return list(PLOT_TYPE_CONFIGS.keys())
+
+
+__all__ = [
+    # Registry
+    "PLOT_TYPE_CONFIGS",
+    "get_plot_config_class",
+    "list_plot_types",
+    # Line plots
+    "LinePlotConfig",
+    "PlotLineConfig",
+    "ShadedLineConfig",
+    # Scatter
+    "ScatterPlotConfig",
+    # Bar
+    "BarPlotConfig",
+    "BarHPlotConfig",
+    # Histogram
+    "HistPlotConfig",
+    # Box
+    "BoxPlotConfig",
+    "BoxConfig",
+    # Violin
+    "ViolinPlotConfig",
+    "ViolinConfig",
+    # Error/Fill
+    "ErrorbarPlotConfig",
+    "FillBetweenConfig",
+    "MeanStdConfig",
+    # Image
+    "ImshowConfig",
+    "ContourConfig",
+    "HeatmapConfig",
+    # Distribution
+    "ECDFConfig",
+    "KDEConfig",
+    # Seaborn
+    "SeabornBoxplotConfig",
+    "SeabornViolinplotConfig",
+    "SeabornScatterplotConfig",
+    "SeabornLineplotConfig",
+    "SeabornHistplotConfig",
+    "SeabornBarplotConfig",
+    "SeabornStripplotConfig",
+    "SeabornKDEplotConfig",
+]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/_bar.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/_bar.py
+
+"""Bar plot configurations."""
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+
+@dataclass
+class BarPlotConfig:
+    """Bar plot configuration."""
+
+    x: Union[List[float], List[str]]
+    height: List[float]
+    width: Optional[float] = 0.8
+    color: Optional[str] = None
+    alpha: Optional[float] = None
+    edge_thickness_mm: Optional[float] = None
+    edgecolor: Optional[str] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+@dataclass
+class BarHPlotConfig:
+    """Horizontal bar plot configuration."""
+
+    y: Union[List[float], List[str]]
+    width: List[float]
+    height: Optional[float] = 0.8
+    color: Optional[str] = None
+    alpha: Optional[float] = None
+    edge_thickness_mm: Optional[float] = None
+    edgecolor: Optional[str] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+__all__ = ["BarPlotConfig", "BarHPlotConfig"]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/_box.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/_box.py
+
+"""Box plot configurations."""
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+
+@dataclass
+class BoxPlotConfig:
+    """Box plot configuration."""
+
+    data: Union[List[List[float]], List[float]]
+    labels: Optional[List[str]] = None
+    positions: Optional[List[float]] = None
+    widths: Optional[float] = None
+    linewidth_mm: Optional[float] = None
+    showfliers: bool = True
+    showmeans: bool = False
+    id: Optional[str] = None
+
+
+@dataclass
+class BoxConfig:
+    """Box plot configuration (scitex.plt.ax.stx_box)."""
+
+    data: List[float]
+    color: Optional[str] = None
+    linewidth_mm: Optional[float] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+__all__ = ["BoxPlotConfig", "BoxConfig"]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/_distribution.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/_distribution.py
+
+"""Distribution plot configurations (ECDF, KDE)."""
+
+from dataclasses import dataclass
+from typing import List, Optional
+
+
+@dataclass
+class ECDFConfig:
+    """ECDF configuration (scitex.plt.ax.stx_ecdf)."""
+
+    data: List[float]
+    color: Optional[str] = None
+    linewidth_mm: Optional[float] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+@dataclass
+class KDEConfig:
+    """KDE configuration (scitex.plt.ax.stx_kde)."""
+
+    data: List[float]
+    bw_method: Optional[str] = None
+    color: Optional[str] = None
+    linewidth_mm: Optional[float] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+__all__ = ["ECDFConfig", "KDEConfig"]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/_errorbar.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/_errorbar.py
+
+"""Error bar and fill configurations."""
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+
+@dataclass
+class ErrorbarPlotConfig:
+    """Error bar plot configuration."""
+
+    x: List[float]
+    y: List[float]
+    xerr: Optional[Union[float, List[float]]] = None
+    yerr: Optional[Union[float, List[float]]] = None
+    fmt: str = "o-"
+    color: Optional[str] = None
+    capsize: Optional[float] = None
+    capthick: Optional[float] = None
+    thickness_mm: Optional[float] = None
+    cap_width_mm: Optional[float] = None
+    alpha: Optional[float] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+@dataclass
+class FillBetweenConfig:
+    """Fill between configuration."""
+
+    x: List[float]
+    y1: List[float]
+    y2: List[float]
+    color: Optional[str] = None
+    alpha: Optional[float] = 0.3
+    linewidth: Optional[float] = None
+    edgecolor: Optional[str] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+@dataclass
+class MeanStdConfig:
+    """Mean±Std configuration (scitex.plt.ax.stx_mean_std)."""
+
+    y_mean: List[float]
+    xx: Optional[List[float]] = None
+    sd: Union[float, List[float]] = 1.0
+    color: Optional[str] = None
+    alpha: Optional[float] = 0.3
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+__all__ = ["ErrorbarPlotConfig", "FillBetweenConfig", "MeanStdConfig"]
+
+# EOF

scitex/fts/_fig/_models/_plot_types/_histogram.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+# Timestamp: 2025-12-20
+# File: /home/ywatanabe/proj/scitex-code/src/scitex/fsb/_fig/_models/_plot_types/_histogram.py
+
+"""Histogram configurations."""
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+
+@dataclass
+class HistPlotConfig:
+    """Histogram configuration."""
+
+    x: List[float]
+    bins: Union[int, List[float]] = 10
+    density: bool = False
+    cumulative: bool = False
+    histtype: str = "bar"
+    color: Optional[str] = None
+    alpha: Optional[float] = None
+    edgecolor: Optional[str] = None
+    range: Optional[tuple] = None
+    label: Optional[str] = None
+    id: Optional[str] = None
+
+
+__all__ = ["HistPlotConfig"]
+
+# EOF