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

scitex/stats/descriptive/__init__.py

@@ -1,6 +1,14 @@
 #!/usr/bin/env python3
-"""Scitex desc module."""
+"""Scitex descriptive statistics module."""
 
+from ._ci import ci
+from ._circular import (
+    circular_concentration,
+    circular_kurtosis,
+    circular_mean,
+    circular_skewness,
+    describe_circular,
+)
 from ._describe import describe, verify_non_leakage
 from ._nan import (
     nanargmax,
@@ -35,15 +43,10 @@ from ._real import (
     var,
     zscore,
 )
-from ._circular import (
-    circular_mean,
-    circular_concentration,
-    circular_skewness,
-    circular_kurtosis,
-    describe_circular,
-)
 
 __all__ = [
+    # Confidence interval
+    "ci",
     # For Ordinal Distribution
     "describe",
     "kurtosis",

scitex/stats/descriptive/_ci.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-26
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/stats/descriptive/_ci.py
+
+"""Confidence interval computation."""
+
+import numpy as np
+
+
+def ci(xx, axis=None):
+    """Compute 95% confidence interval.
+
+    Calculates the confidence interval using the formula:
+    CI = 1.96 * std / sqrt(n)
+
+    Parameters
+    ----------
+    xx : array-like
+        Input data array
+    axis : int, optional
+        Axis along which to compute CI (default: None, compute over entire array)
+
+    Returns
+    -------
+    float or array
+        95% confidence interval
+
+    Example
+    -------
+    >>> import numpy as np
+    >>> data = np.array([1, 2, 3, 4, 5])
+    >>> ci(data)
+    1.2389...
+    """
+    indi = ~np.isnan(xx)
+    return 1.96 * (xx[indi]).std(axis=axis) / np.sqrt(indi.sum())
+
+
+# EOF

scitex/stats/power/_power.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # Timestamp: "2025-10-01 14:55:00 (ywatanabe)"
 # File: /home/ywatanabe/proj/scitex_repo/src/scitex/stats/utils/_power.py
 
@@ -19,12 +18,13 @@ IO:
 """
 
 """Imports"""
-import sys
 import argparse
+from typing import Literal, Optional, Union
+
 import numpy as np
 import pandas as pd
-from typing import Union, Optional, Literal
 from scipy import stats
+
 import scitex as stx
 from scitex.logging import getLogger
 
@@ -151,7 +151,17 @@ def power_ttest(
         ncp = effect_size * np.sqrt(sample_size)
 
     # Compute power using non-central t-distribution
-    if alternative == "two-sided":
+    # For very large ncp (>37), power is essentially 1.0 (avoid numerical overflow)
+    if abs(ncp) > 37:
+        # With ncp > 37, the non-central t-distribution is so far from 0
+        # that power approaches 1.0 for correct direction, 0.0 for wrong direction
+        if alternative == "two-sided":
+            power = 1.0
+        elif alternative == "greater":
+            power = 1.0 if ncp > 0 else 0.0
+        else:  # less
+            power = 1.0 if ncp < 0 else 0.0
+    elif alternative == "two-sided":
         # For two-sided, power = P(|T| > t_crit | ncp)
         power = 1 - stats.nct.cdf(t_crit, df, ncp) + stats.nct.cdf(-t_crit, df, ncp)
     elif alternative == "greater":
@@ -405,6 +415,7 @@ def run_main():
     global CONFIG, sys, plt, rng
 
     import sys
+
     import matplotlib.pyplot as plt
 
     args = parse_args()

scitex/str/__init__.py

@@ -1,5 +1,4 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # Timestamp: "2025-06-13 22:55:11 (ywatanabe)"
 # File: /ssh:sp:/home/ywatanabe/proj/SciTeX-Code/src/scitex/str/__init__.py
 # ----------------------------------------
@@ -62,6 +61,7 @@ from ._remove_ansi import remove_ansi
 from ._replace import replace
 from ._search import search
 from ._squeeze_space import squeeze_spaces
+from ._title_case import title_case
 
 __all__ = [
     "LaTeXFallbackError",
@@ -106,6 +106,7 @@ __all__ = [
     "smart_tick_formatter",
     "squeeze_spaces",
     "title",
+    "title_case",
     "to_latex_style",
 ]
 

scitex/str/_title_case.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+# Timestamp: 2026-01-26
+# File: /home/ywatanabe/proj/scitex-python/src/scitex/str/_title_case.py
+
+"""Title case conversion for strings."""
+
+
+def title_case(text):
+    """
+    Convert a string to title case.
+
+    Keeps certain prepositions, conjunctions, and articles in lowercase,
+    and ensures words detected as potential acronyms (all uppercase) are
+    fully capitalized.
+
+    Parameters
+    ----------
+    text : str
+        The text to convert to title case.
+
+    Returns
+    -------
+    str
+        The converted text in title case with certain words in lowercase
+        and potential acronyms fully capitalized.
+
+    Examples
+    --------
+    >>> title_case("welcome to the world of ai and using CPUs for gaming")
+    'Welcome to the World of AI and Using CPUs for Gaming'
+    """
+    # List of words to keep in lowercase
+    lowercase_words = [
+        "a",
+        "an",
+        "the",
+        "and",
+        "but",
+        "or",
+        "nor",
+        "at",
+        "by",
+        "to",
+        "in",
+        "with",
+        "of",
+        "on",
+    ]
+
+    words = text.split()
+    final_words = []
+    for word in words:
+        # Check if the word is fully in uppercase and more than one character
+        if word.isupper() and len(word) > 1:
+            final_words.append(word)
+        elif word.lower() in lowercase_words:
+            final_words.append(word.lower())
+        else:
+            final_words.append(word.capitalize())
+    return " ".join(final_words)
+
+
+# EOF

scitex/template/README.md

@@ -1,7 +1,7 @@
 <!-- ---
 !-- Timestamp: 2025-10-29 05:56:40
 !-- Author: ywatanabe
-!-- File: /home/ywatanabe/proj/scitex-code/src/scitex/template/README.md
+!-- File: /home/ywatanabe/proj/scitex-python/src/scitex/template/README.md
 !-- --- -->
 
 # SciTeX Template Module

scitex/template/__init__.py

@@ -1,25 +1,36 @@
 #!/usr/bin/env python3
-# -*- coding: utf-8 -*-
 # File: /home/ywatanabe/proj/scitex_repo/src/scitex/template/__init__.py
 
 """
 Template management for SciTeX projects.
 """
 
-from .clone_research import clone_research, TEMPLATE_REPO_URL as RESEARCH_URL
-from .clone_pip_project import clone_pip_project, TEMPLATE_REPO_URL as PIP_PROJECT_URL
-from .clone_singularity import clone_singularity, TEMPLATE_REPO_URL as SINGULARITY_URL
-from .clone_writer_directory import (
-    clone_writer_directory,
-    TEMPLATE_REPO_URL as PAPER_DIRECTORY_URL,
-)
 from scitex.git import (
-    init_git_repo,
-    find_parent_git,
     create_child_git,
+    find_parent_git,
+    init_git_repo,
     remove_child_git,
 )
 
+from ._code_templates import (
+    CODE_TEMPLATES,
+    get_all_templates,
+    get_code_template,
+    list_code_templates,
+)
+from .clone_pip_project import TEMPLATE_REPO_URL as PIP_PROJECT_URL
+from .clone_pip_project import clone_pip_project
+from .clone_research import TEMPLATE_REPO_URL as RESEARCH_URL
+from .clone_research import clone_research
+from .clone_singularity import TEMPLATE_REPO_URL as SINGULARITY_URL
+from .clone_singularity import clone_singularity
+from .clone_writer_directory import (
+    TEMPLATE_REPO_URL as PAPER_DIRECTORY_URL,
+)
+from .clone_writer_directory import (
+    clone_writer_directory,
+)
+
 
 def get_available_templates_info():
     """
@@ -106,6 +117,10 @@ __all__ = [
     "clone_singularity",
     "clone_writer_directory",
     "get_available_templates_info",
+    "get_code_template",
+    "list_code_templates",
+    "get_all_templates",
+    "CODE_TEMPLATES",
     "init_git_repo",
     "find_parent_git",
     "create_child_git",

scitex/template/_code_templates.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+"""Code templates for common SciTeX patterns.
+
+Provides ready-to-use code snippets for scripts and modules.
+"""
+
+from datetime import datetime
+from pathlib import Path
+from typing import Optional
+
+# Import templates from subdirectory
+from ._templates import CODE_TEMPLATES
+
+
+def get_code_template(
+    template_id: str,
+    filepath: Optional[str] = None,
+    docstring: Optional[str] = None,
+) -> str:
+    """
+    Get a code template by ID.
+
+    Parameters
+    ----------
+    template_id : str
+        Template identifier (session, session-minimal, session-plot, etc.)
+    filepath : str, optional
+        File path to include in template header.
+    docstring : str, optional
+        Custom docstring for the template.
+
+    Returns
+    -------
+    str
+        Formatted template content.
+    """
+    if template_id not in CODE_TEMPLATES:
+        available = ", ".join(CODE_TEMPLATES.keys())
+        raise ValueError(f"Unknown template: '{template_id}'. Available: {available}")
+
+    template = CODE_TEMPLATES[template_id]
+    content = template["content"]
+
+    # Format placeholders
+    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    filepath = filepath or template["filename"]
+    docstring = docstring or "Description of this script/module"
+
+    filename = Path(filepath).name
+    filename_stem = Path(filepath).stem
+
+    return content.format(
+        timestamp=timestamp,
+        filepath=filepath,
+        filename=filename,
+        filename_stem=filename_stem,
+        docstring=docstring,
+    )
+
+
+def list_code_templates():
+    """
+    List all available code templates.
+
+    Returns
+    -------
+    list[dict]
+        List of template info dictionaries.
+    """
+    return [
+        {
+            "id": tid,
+            "name": info["name"],
+            "description": info["description"],
+            "filename": info["filename"],
+            "usage": info.get("usage", ""),
+        }
+        for tid, info in CODE_TEMPLATES.items()
+    ]
+
+
+def get_all_templates() -> str:
+    """
+    Get all templates combined into one string.
+
+    Returns
+    -------
+    str
+        All templates with headers, ordered by priority:
+        1. session - Main workflow template
+        2. io - File I/O patterns
+        3. Others (config, module, etc.)
+    """
+    # Priority order
+    priority_order = [
+        # Core templates (priority 1-3)
+        "session",
+        "io",
+        "config",
+        # Session variants
+        "session-minimal",
+        "session-plot",
+        "session-stats",
+        "module",
+        # Module usage templates
+        "plt",
+        "stats",
+        "scholar",
+        "audio",
+        "capture",
+        "diagram",
+        "canvas",
+        "writer",
+    ]
+
+    sections = []
+    sections.append("=" * 70)
+    sections.append("SCITEX CODE TEMPLATES")
+    sections.append("=" * 70)
+
+    for tid in priority_order:
+        if tid not in CODE_TEMPLATES:
+            continue
+        info = CODE_TEMPLATES[tid]
+        sections.append("")
+        sections.append("-" * 70)
+        sections.append(f"TEMPLATE: {tid}")
+        sections.append(f"  {info['name']} - {info['description']}")
+        sections.append("-" * 70)
+        if info.get("usage"):
+            sections.append(info["usage"].strip())
+        sections.append("")
+        sections.append("```python" if not tid == "config" else "```yaml")
+        sections.append(info["content"].strip())
+        sections.append("```")
+
+    return "\n".join(sections)
+
+
+__all__ = [
+    "get_code_template",
+    "list_code_templates",
+    "get_all_templates",
+    "CODE_TEMPLATES",
+]
+
+# EOF

scitex/template/_mcp/handlers.py

@@ -201,6 +201,85 @@ async def clone_template_handler(
         }
 
 
+async def get_code_template_handler(
+    template_id: str,
+    filepath: Optional[str] = None,
+    docstring: Optional[str] = None,
+) -> dict:
+    """
+    Get a code template by ID.
+
+    Parameters
+    ----------
+    template_id : str
+        Template identifier (session, io, config, session-minimal, session-plot, session-stats, module, all)
+    filepath : str, optional
+        File path to include in template header
+    docstring : str, optional
+        Custom docstring for the template
+
+    Returns
+    -------
+    dict
+        Success status and template content
+    """
+    try:
+        if template_id == "all":
+            from scitex.template import get_all_templates
+
+            content = get_all_templates()
+        else:
+            from scitex.template import get_code_template
+
+            content = get_code_template(
+                template_id=template_id,
+                filepath=filepath,
+                docstring=docstring,
+            )
+
+        return {
+            "success": True,
+            "template_id": template_id,
+            "content": content,
+        }
+    except ValueError as e:
+        return {
+            "success": False,
+            "error": str(e),
+        }
+    except Exception as e:
+        return {
+            "success": False,
+            "error": str(e),
+        }
+
+
+async def list_code_templates_handler() -> dict:
+    """
+    List all available code templates.
+
+    Returns
+    -------
+    dict
+        Success status and list of code templates
+    """
+    try:
+        from scitex.template import list_code_templates
+
+        templates = list_code_templates()
+
+        return {
+            "success": True,
+            "count": len(templates),
+            "templates": templates,
+        }
+    except Exception as e:
+        return {
+            "success": False,
+            "error": str(e),
+        }
+
+
 async def list_git_strategies_handler() -> dict:
     """
     List available git initialization strategies.
@@ -254,6 +333,8 @@ __all__ = [
     "get_template_info_handler",
     "clone_template_handler",
     "list_git_strategies_handler",
+    "get_code_template_handler",
+    "list_code_templates_handler",
 ]
 
 # EOF

scitex/template/_mcp/tool_schemas.py

@@ -104,6 +104,61 @@ def get_tool_schemas() -> list[types.Tool]:
                 "required": [],
             },
         ),
+        # Get code template
+        types.Tool(
+            name="get_code_template",
+            description="Get a code template for @stx.session scripts, module usage, or config files. Returns ready-to-use Python code with usage guidelines. Core templates: session, io, config. Module usage: plt, stats, scholar, audio, capture, diagram, canvas, writer.",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "template_id": {
+                        "type": "string",
+                        "description": "Template identifier. Core (priority 1-3): session, io, config. Session variants: session-minimal, session-plot, session-stats, module. Module usage: plt, stats, scholar, audio, capture, diagram, canvas, writer. Use 'all' for all templates.",
+                        "enum": [
+                            # Core templates
+                            "session",
+                            "io",
+                            "config",
+                            # Session variants
+                            "session-minimal",
+                            "session-plot",
+                            "session-stats",
+                            "module",
+                            # Module usage templates
+                            "plt",
+                            "stats",
+                            "scholar",
+                            "audio",
+                            "capture",
+                            "diagram",
+                            "canvas",
+                            "writer",
+                            # All
+                            "all",
+                        ],
+                    },
+                    "filepath": {
+                        "type": "string",
+                        "description": "File path to include in template header (optional)",
+                    },
+                    "docstring": {
+                        "type": "string",
+                        "description": "Custom docstring for the template (optional)",
+                    },
+                },
+                "required": ["template_id"],
+            },
+        ),
+        # List code templates
+        types.Tool(
+            name="list_code_templates",
+            description="List all available code templates for scripts and modules",
+            inputSchema={
+                "type": "object",
+                "properties": {},
+                "required": [],
+            },
+        ),
     ]
 
 

scitex/template/_templates/__init__.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""Code templates registry - loads all template definitions."""
+
+# Core templates (priority 1-3)
+from .audio import TEMPLATE as AUDIO
+from .canvas import TEMPLATE as CANVAS
+from .capture import TEMPLATE as CAPTURE
+from .config import TEMPLATE as CONFIG
+from .diagram import TEMPLATE as DIAGRAM
+from .io import TEMPLATE as IO
+
+# Module template
+from .module import TEMPLATE as MODULE
+
+# Module usage templates (priority 4+)
+from .plt import TEMPLATE as PLT
+from .scholar import TEMPLATE as SCHOLAR
+from .session import TEMPLATE as SESSION
+
+# Session variants
+from .session_minimal import TEMPLATE as SESSION_MINIMAL
+from .session_plot import TEMPLATE as SESSION_PLOT
+from .session_stats import TEMPLATE as SESSION_STATS
+from .stats import TEMPLATE as STATS
+from .writer import TEMPLATE as WRITER
+
+CODE_TEMPLATES = {
+    # Priority 1-3: Core templates
+    "session": SESSION,
+    "io": IO,
+    "config": CONFIG,
+    # Session variants
+    "session-minimal": SESSION_MINIMAL,
+    "session-plot": SESSION_PLOT,
+    "session-stats": SESSION_STATS,
+    # Module template
+    "module": MODULE,
+    # Module usage templates
+    "plt": PLT,
+    "stats": STATS,
+    "scholar": SCHOLAR,
+    "audio": AUDIO,
+    "capture": CAPTURE,
+    "diagram": DIAGRAM,
+    "canvas": CANVAS,
+    "writer": WRITER,
+}
+
+__all__ = ["CODE_TEMPLATES"]
+
+# EOF