scitex 2.14.0__py3-none-any.whl → 2.15.2__py3-none-any.whl

scitex/stats/auto/_stat_style.py

@@ -0,0 +1,175 @@
+#!/usr/bin/env python3
+# Timestamp: "2026-01-24 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/stats/auto/_stat_style.py
+
+"""StatStyle dataclass for statistical reporting."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Dict, List, Literal, Optional, Tuple
+
+OutputTarget = Literal["latex", "html", "plain"]
+
+__all__ = ["StatStyle", "OutputTarget"]
+
+
+@dataclass
+class StatStyle:
+    """Style configuration for statistical reporting.
+
+    Defines how to format statistical results for a specific journal
+    or output format.
+
+    Parameters
+    ----------
+    id : str
+        Unique identifier for this style.
+    label : str
+        Human-readable label (e.g., "APA (LaTeX)").
+    target : OutputTarget
+        Output format: "latex", "html", or "plain".
+    stat_symbol_format : dict
+        Maps statistic symbols to their formatted versions.
+    p_format : str
+        Format string for p-values.
+    alpha_thresholds : list of (float, str)
+        P-value thresholds for stars.
+    effect_label_format : dict
+        Maps effect size names to their formatted labels.
+    n_format : str
+        Format string for sample sizes.
+    decimal_places_p : int
+        Decimal places for p-values.
+    decimal_places_stat : int
+        Decimal places for test statistics.
+    decimal_places_effect : int
+        Decimal places for effect sizes.
+    """
+
+    id: str
+    label: str
+    target: OutputTarget
+
+    stat_symbol_format: Dict[str, str] = field(default_factory=dict)
+    p_format: str = "p = {p:.3f}"
+    alpha_thresholds: List[Tuple[float, str]] = field(default_factory=list)
+    effect_label_format: Dict[str, str] = field(default_factory=dict)
+    n_format: str = "n_{%s} = %d"
+
+    decimal_places_p: int = 3
+    decimal_places_stat: int = 2
+    decimal_places_effect: int = 2
+
+    def format_stat(
+        self,
+        symbol: str,
+        value: float,
+        df: Optional[float] = None,
+    ) -> str:
+        """Format a test statistic.
+
+        Parameters
+        ----------
+        symbol : str
+            Statistic symbol (e.g., "t", "F", "chi2").
+        value : float
+            Statistic value.
+        df : float, optional
+            Degrees of freedom.
+
+        Returns
+        -------
+        str
+            Formatted statistic string.
+        """
+        fmt_symbol = self.stat_symbol_format.get(symbol, symbol)
+        dp = self.decimal_places_stat
+
+        if df is not None:
+            return f"{fmt_symbol}({df:.1f}) = {value:.{dp}f}"
+        return f"{fmt_symbol} = {value:.{dp}f}"
+
+    def format_p(self, p_value: float) -> str:
+        """Format a p-value.
+
+        Parameters
+        ----------
+        p_value : float
+            P-value to format.
+
+        Returns
+        -------
+        str
+            Formatted p-value string.
+        """
+        p_symbol = self.stat_symbol_format.get("p", "p")
+        dp = self.decimal_places_p
+
+        if p_value < 0.001:
+            return f"{p_symbol} < 0.001"
+        if p_value < 0.0001:
+            return f"{p_symbol} < 0.0001"
+        return f"{p_symbol} = {p_value:.{dp}f}"
+
+    def format_effect(self, name: str, value: float) -> str:
+        """Format an effect size.
+
+        Parameters
+        ----------
+        name : str
+            Effect size name (e.g., "cohens_d_ind").
+        value : float
+            Effect size value.
+
+        Returns
+        -------
+        str
+            Formatted effect size string.
+        """
+        label = self.effect_label_format.get(name, name)
+        dp = self.decimal_places_effect
+        return f"{label} = {value:.{dp}f}"
+
+    def format_n(self, group: str, n: int) -> str:
+        """Format a sample size.
+
+        Parameters
+        ----------
+        group : str
+            Group name/label.
+        n : int
+            Sample size.
+
+        Returns
+        -------
+        str
+            Formatted sample size string.
+        """
+        if "%s" in self.n_format:
+            return self.n_format % (group, n)
+        return self.n_format % n
+
+    def p_to_stars(self, p_value: float) -> str:
+        """Convert p-value to significance stars.
+
+        Parameters
+        ----------
+        p_value : float
+            P-value.
+
+        Returns
+        -------
+        str
+            Stars string ("***", "**", "*", or "ns").
+        """
+        if p_value is None:
+            return "ns"
+
+        for threshold, stars in self.alpha_thresholds:
+            if p_value < threshold:
+                return stars
+        return "ns"
+
+
+# EOF

scitex/stats/auto/_style_definitions.py

@@ -0,0 +1,411 @@
+#!/usr/bin/env python3
+# Timestamp: "2026-01-24 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/stats/auto/_style_definitions.py
+
+"""Journal style preset definitions for statistical formatting."""
+
+from ._stat_style import StatStyle
+
+__all__ = [
+    "APA_LATEX_STYLE",
+    "APA_HTML_STYLE",
+    "NATURE_LATEX_STYLE",
+    "NATURE_HTML_STYLE",
+    "CELL_LATEX_STYLE",
+    "CELL_HTML_STYLE",
+    "ELSEVIER_LATEX_STYLE",
+    "ELSEVIER_HTML_STYLE",
+    "PLAIN_STYLE",
+]
+
+# =============================================================================
+# APA Style (LaTeX)
+# =============================================================================
+
+APA_LATEX_STYLE = StatStyle(
+    id="apa_latex",
+    label="APA (LaTeX)",
+    target="latex",
+    stat_symbol_format={
+        "t": "\\mathit{t}",
+        "F": "\\mathit{F}",
+        "chi2": "\\chi^2",
+        "U": "\\mathit{U}",
+        "W": "\\mathit{W}",
+        "BM": "\\mathit{BM}",
+        "r": "\\mathit{r}",
+        "n": "\\mathit{n}",
+        "p": "\\mathit{p}",
+    },
+    p_format="\\mathit{p} = {p:.3f}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's~d",
+        "cohens_d_paired": "Cohen's~d",
+        "hedges_g": "Hedges'~g",
+        "cliffs_delta": "Cliff's~$\\delta$",
+        "eta_squared": "$\\eta^2$",
+        "partial_eta_squared": "$\\eta^2_{p}$",
+        "effect_size_r": "\\mathit{r}",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="\\mathit{n}_{%s} = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# APA Style (HTML)
+# =============================================================================
+
+APA_HTML_STYLE = StatStyle(
+    id="apa_html",
+    label="APA (HTML)",
+    target="html",
+    stat_symbol_format={
+        "t": "<i>t</i>",
+        "F": "<i>F</i>",
+        "chi2": "<i>&chi;</i><sup>2</sup>",
+        "U": "<i>U</i>",
+        "W": "<i>W</i>",
+        "BM": "<i>BM</i>",
+        "r": "<i>r</i>",
+        "n": "<i>n</i>",
+        "p": "<i>p</i>",
+    },
+    p_format="<i>p</i> = {p:.3f}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's d",
+        "cohens_d_paired": "Cohen's d",
+        "hedges_g": "Hedges' g",
+        "cliffs_delta": "Cliff's &delta;",
+        "eta_squared": "&eta;<sup>2</sup>",
+        "partial_eta_squared": "&eta;<sup>2</sup><sub>p</sub>",
+        "effect_size_r": "<i>r</i>",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="<i>n</i><sub>%s</sub> = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Nature Style (LaTeX)
+# =============================================================================
+
+NATURE_LATEX_STYLE = StatStyle(
+    id="nature_latex",
+    label="Nature (LaTeX)",
+    target="latex",
+    stat_symbol_format={
+        "t": "\\mathit{t}",
+        "F": "\\mathit{F}",
+        "chi2": "\\chi^2",
+        "U": "\\mathit{U}",
+        "W": "\\mathit{W}",
+        "BM": "\\mathit{BM}",
+        "r": "\\mathit{r}",
+        "n": "\\mathit{n}",
+        "p": "\\mathit{P}",  # Nature uses uppercase P
+    },
+    p_format="\\mathit{P} = {p:.3g}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's~d",
+        "cohens_d_paired": "Cohen's~d",
+        "hedges_g": "Hedges'~g",
+        "cliffs_delta": "Cliff's~$\\delta$",
+        "eta_squared": "$\\eta^2$",
+        "partial_eta_squared": "$\\eta^2_{p}$",
+        "effect_size_r": "\\mathit{r}",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="\\mathit{n} = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Nature Style (HTML)
+# =============================================================================
+
+NATURE_HTML_STYLE = StatStyle(
+    id="nature_html",
+    label="Nature (HTML)",
+    target="html",
+    stat_symbol_format={
+        "t": "<i>t</i>",
+        "F": "<i>F</i>",
+        "chi2": "<i>&chi;</i><sup>2</sup>",
+        "U": "<i>U</i>",
+        "W": "<i>W</i>",
+        "BM": "<i>BM</i>",
+        "r": "<i>r</i>",
+        "n": "<i>n</i>",
+        "p": "<i>P</i>",
+    },
+    p_format="<i>P</i> = {p:.3g}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's d",
+        "cohens_d_paired": "Cohen's d",
+        "hedges_g": "Hedges' g",
+        "cliffs_delta": "Cliff's &delta;",
+        "eta_squared": "&eta;<sup>2</sup>",
+        "partial_eta_squared": "&eta;<sup>2</sup><sub>p</sub>",
+        "effect_size_r": "<i>r</i>",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="<i>n</i> = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Cell Press Style (LaTeX)
+# =============================================================================
+
+CELL_LATEX_STYLE = StatStyle(
+    id="cell_latex",
+    label="Cell (LaTeX)",
+    target="latex",
+    stat_symbol_format={
+        "t": "\\mathit{t}",
+        "F": "\\mathit{F}",
+        "chi2": "\\chi^2",
+        "U": "\\mathit{U}",
+        "W": "\\mathit{W}",
+        "BM": "\\mathit{BM}",
+        "r": "\\mathit{r}",
+        "n": "\\mathit{n}",
+        "p": "\\mathit{p}",
+    },
+    p_format="\\mathit{p} = {p:.3g}",
+    alpha_thresholds=[
+        (0.0001, "****"),
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's~d",
+        "cohens_d_paired": "Cohen's~d",
+        "hedges_g": "Hedges'~g",
+        "cliffs_delta": "Cliff's~$\\delta$",
+        "eta_squared": "$\\eta^2$",
+        "partial_eta_squared": "$\\eta^2_{p}$",
+        "effect_size_r": "\\mathit{r}",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="\\mathit{n} = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Cell Press Style (HTML)
+# =============================================================================
+
+CELL_HTML_STYLE = StatStyle(
+    id="cell_html",
+    label="Cell (HTML)",
+    target="html",
+    stat_symbol_format={
+        "t": "<i>t</i>",
+        "F": "<i>F</i>",
+        "chi2": "<i>&chi;</i><sup>2</sup>",
+        "U": "<i>U</i>",
+        "W": "<i>W</i>",
+        "BM": "<i>BM</i>",
+        "r": "<i>r</i>",
+        "n": "<i>n</i>",
+        "p": "<i>p</i>",
+    },
+    p_format="<i>p</i> = {p:.3g}",
+    alpha_thresholds=[
+        (0.0001, "****"),
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's d",
+        "cohens_d_paired": "Cohen's d",
+        "hedges_g": "Hedges' g",
+        "cliffs_delta": "Cliff's &delta;",
+        "eta_squared": "&eta;<sup>2</sup>",
+        "partial_eta_squared": "&eta;<sup>2</sup><sub>p</sub>",
+        "effect_size_r": "<i>r</i>",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="<i>n</i> = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Elsevier Style (LaTeX)
+# =============================================================================
+
+ELSEVIER_LATEX_STYLE = StatStyle(
+    id="elsevier_latex",
+    label="Elsevier (LaTeX)",
+    target="latex",
+    stat_symbol_format={
+        "t": "\\mathit{t}",
+        "F": "\\mathit{F}",
+        "chi2": "\\chi^2",
+        "U": "\\mathit{U}",
+        "W": "\\mathit{W}",
+        "BM": "\\mathit{BM}",
+        "r": "\\mathit{r}",
+        "n": "\\mathit{n}",
+        "p": "\\mathit{p}",
+    },
+    p_format="\\mathit{p} = {p:.3f}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's~d",
+        "cohens_d_paired": "Cohen's~d",
+        "hedges_g": "Hedges'~g",
+        "cliffs_delta": "Cliff's~$\\delta$",
+        "eta_squared": "$\\eta^2$",
+        "partial_eta_squared": "$\\eta^2_{p}$",
+        "effect_size_r": "\\mathit{r}",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="\\mathit{n} = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Elsevier Style (HTML)
+# =============================================================================
+
+ELSEVIER_HTML_STYLE = StatStyle(
+    id="elsevier_html",
+    label="Elsevier (HTML)",
+    target="html",
+    stat_symbol_format={
+        "t": "<i>t</i>",
+        "F": "<i>F</i>",
+        "chi2": "<i>&chi;</i><sup>2</sup>",
+        "U": "<i>U</i>",
+        "W": "<i>W</i>",
+        "BM": "<i>BM</i>",
+        "r": "<i>r</i>",
+        "n": "<i>n</i>",
+        "p": "<i>p</i>",
+    },
+    p_format="<i>p</i> = {p:.3f}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's d",
+        "cohens_d_paired": "Cohen's d",
+        "hedges_g": "Hedges' g",
+        "cliffs_delta": "Cliff's &delta;",
+        "eta_squared": "&eta;<sup>2</sup>",
+        "partial_eta_squared": "&eta;<sup>2</sup><sub>p</sub>",
+        "effect_size_r": "<i>r</i>",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="<i>n</i> = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+# =============================================================================
+# Plain Text Style
+# =============================================================================
+
+PLAIN_STYLE = StatStyle(
+    id="plain",
+    label="Plain Text",
+    target="plain",
+    stat_symbol_format={
+        "t": "t",
+        "F": "F",
+        "chi2": "chi2",
+        "U": "U",
+        "W": "W",
+        "BM": "BM",
+        "r": "r",
+        "n": "n",
+        "p": "p",
+    },
+    p_format="p = {p:.3f}",
+    alpha_thresholds=[
+        (0.001, "***"),
+        (0.01, "**"),
+        (0.05, "*"),
+    ],
+    effect_label_format={
+        "cohens_d_ind": "Cohen's d",
+        "cohens_d_paired": "Cohen's d",
+        "hedges_g": "Hedges' g",
+        "cliffs_delta": "Cliff's delta",
+        "eta_squared": "eta^2",
+        "partial_eta_squared": "partial eta^2",
+        "effect_size_r": "r",
+        "odds_ratio": "OR",
+        "risk_ratio": "RR",
+        "prob_superiority": "P(X>Y)",
+    },
+    n_format="n_%s = %d",
+    decimal_places_p=3,
+    decimal_places_stat=2,
+    decimal_places_effect=2,
+)
+
+
+# EOF