scitex 2.4.3__py3-none-any.whl → 2.7.0__py3-none-any.whl

scitex/tex/_preview.py

@@ -21,14 +21,17 @@ import numpy as np
 
 try:
     from scitex.str._latex_fallback import safe_latex_render, latex_fallback_decorator
+
     FALLBACK_AVAILABLE = True
 except ImportError:
     FALLBACK_AVAILABLE = False
+
     def latex_fallback_decorator(fallback_strategy="auto", preserve_math=True):
         def decorator(func):
             return func
+
         return decorator
-    
+
     def safe_latex_render(text, fallback_strategy="auto", preserve_math=True):
         return text
 
@@ -55,10 +58,10 @@ def preview(tex_str_list, enable_fallback=True):
     >>> tex_strings = ["x^2", r"\sum_{i=1}^n i", r"\alpha + \beta"]
     >>> fig = preview(tex_strings)
     >>> scitex.plt.show()
-    
+
     Notes
     -----
-    If LaTeX rendering fails, this function automatically falls back to 
+    If LaTeX rendering fails, this function automatically falls back to
     mathtext or unicode alternatives while preserving the preview layout.
     """
     from scitex.plt import subplots
@@ -70,7 +73,7 @@ def preview(tex_str_list, enable_fallback=True):
         nrows=len(tex_str_list), ncols=1, figsize=(10, 3 * len(tex_str_list))
     )
     axes = np.atleast_1d(axes)
-    
+
     for ax, tex_string in zip(axes, tex_str_list):
         try:
             # Original LaTeX string (raw)
@@ -79,23 +82,35 @@ def preview(tex_str_list, enable_fallback=True):
                 ax.text(0.5, 0.7, safe_raw, size=20, ha="center", va="center")
             else:
                 ax.text(0.5, 0.7, tex_string, size=20, ha="center", va="center")
-            
+
             # LaTeX-formatted string
-            latex_formatted = f"${tex_string}$" if not (tex_string.startswith("$") and tex_string.endswith("$")) else tex_string
-            
+            latex_formatted = (
+                f"${tex_string}$"
+                if not (tex_string.startswith("$") and tex_string.endswith("$"))
+                else tex_string
+            )
+
             if enable_fallback and FALLBACK_AVAILABLE:
                 safe_latex = safe_latex_render(latex_formatted, preserve_math=True)
                 ax.text(0.5, 0.3, safe_latex, size=20, ha="center", va="center")
             else:
                 ax.text(0.5, 0.3, latex_formatted, size=20, ha="center", va="center")
-                
+
         except Exception as e:
             # Fallback for individual preview failures
             ax.text(0.5, 0.7, f"Raw: {tex_string}", size=16, ha="center", va="center")
-            ax.text(0.5, 0.3, f"Error: {str(e)[:50]}...", size=12, ha="center", va="center", color='red')
-            
+            ax.text(
+                0.5,
+                0.3,
+                f"Error: {str(e)[:50]}...",
+                size=12,
+                ha="center",
+                va="center",
+                color="red",
+            )
+
         ax.hide_spines()
-        
+
     fig.tight_layout()
     return fig
 

scitex/tex/_to_vec.py

@@ -19,14 +19,17 @@ Prerequisites:
 
 try:
     from scitex.str._latex_fallback import safe_latex_render, latex_fallback_decorator
+
     FALLBACK_AVAILABLE = True
 except ImportError:
     FALLBACK_AVAILABLE = False
+
     def latex_fallback_decorator(fallback_strategy="auto", preserve_math=True):
         def decorator(func):
             return func
+
         return decorator
-    
+
     def safe_latex_render(text, fallback_strategy="auto", preserve_math=True):
         return text
 
@@ -54,10 +57,10 @@ def to_vec(v_str, enable_fallback=True, fallback_strategy="auto"):
     --------
     >>> vector = to_vec("AB")
     >>> print(vector)  # LaTeX: \overrightarrow{\mathrm{AB}}
-    
+
     >>> vector = to_vec("AB")  # Falls back to unicode if LaTeX fails
     >>> print(vector)  # Unicode: A⃗B or AB⃗
-    
+
     Notes
     -----
     If LaTeX rendering fails, this function automatically falls back to:
@@ -67,10 +70,10 @@ def to_vec(v_str, enable_fallback=True, fallback_strategy="auto"):
     """
     if not v_str:
         return ""
-    
+
     # Create LaTeX vector notation
     latex_vector = f"\\overrightarrow{{\\mathrm{{{v_str}}}}}"
-    
+
     if enable_fallback and FALLBACK_AVAILABLE:
         # Custom fallback handling for vectors
         if fallback_strategy == "auto":
@@ -94,14 +97,14 @@ def to_vec(v_str, enable_fallback=True, fallback_strategy="auto"):
 def safe_to_vec(v_str, fallback_strategy="auto"):
     """
     Safe version of to_vec with explicit fallback control.
-    
+
     Parameters
     ----------
     v_str : str
         String representation of the vector
     fallback_strategy : str, optional
         Explicit fallback strategy: "auto", "mathtext", "unicode", "plain"
-        
+
     Returns
     -------
     str

scitex/torch/__init__.py

@@ -2,7 +2,17 @@
 """Scitex torch module."""
 
 from ._apply_to import apply_to
-from ._nan_funcs import nanargmax, nanargmin, nancumprod, nancumsum, nanmax, nanmin, nanprod, nanstd, nanvar
+from ._nan_funcs import (
+    nanargmax,
+    nanargmin,
+    nancumprod,
+    nancumsum,
+    nanmax,
+    nanmin,
+    nanprod,
+    nanstd,
+    nanvar,
+)
 
 __all__ = [
     "apply_to",

scitex/types/_ArrayLike.py

@@ -22,6 +22,7 @@ def _get_torch_tensor_type():
     """Lazily import torch.Tensor to avoid circular imports."""
     try:
         import torch
+
         return torch.Tensor
     except (ImportError, RuntimeError):
         # If torch is not available or has import issues, return None
@@ -56,6 +57,7 @@ def is_array_like(obj) -> bool:
     # Check torch tensor lazily to avoid circular imports
     try:
         import torch
+
         return torch.is_tensor(obj)
     except (ImportError, RuntimeError):
         return False

scitex/types/_is_listed_X.py

@@ -54,13 +54,13 @@ def is_listed_X(obj, types):
 def is_list_of_type(obj, types):
     """
     Check if obj is a list where all elements are of one of the specified types.
-    
+
     This is an alias for is_listed_X with a more conventional name.
-    
+
     Args:
         obj: Object to check
         types: Type or list of types to check against
-        
+
     Returns:
         bool: True if obj is a list and all elements are of one of the specified types
     """

scitex/units.py

@@ -26,116 +26,110 @@ import warnings
 @dataclass
 class Unit:
     """Represents a physical unit with dimensions."""
-    
+
     name: str
     symbol: str
     dimensions: Dict[str, float]  # e.g., {'length': 1, 'time': -1} for m/s
     scale: float = 1.0  # Conversion factor to SI base unit
-    
-    def __mul__(self, other: 'Unit') -> 'Unit':
+
+    def __mul__(self, other: "Unit") -> "Unit":
         """Multiply units."""
         new_dims = self.dimensions.copy()
         for dim, power in other.dimensions.items():
             new_dims[dim] = new_dims.get(dim, 0) + power
-        
+
         # Clean up zero dimensions
         new_dims = {k: v for k, v in new_dims.items() if v != 0}
-        
+
         return Unit(
             name=f"{self.name}*{other.name}",
             symbol=f"{self.symbol}·{other.symbol}",
             dimensions=new_dims,
-            scale=self.scale * other.scale
+            scale=self.scale * other.scale,
         )
-    
-    def __truediv__(self, other: 'Unit') -> 'Unit':
+
+    def __truediv__(self, other: "Unit") -> "Unit":
         """Divide units."""
         new_dims = self.dimensions.copy()
         for dim, power in other.dimensions.items():
             new_dims[dim] = new_dims.get(dim, 0) - power
-        
+
         # Clean up zero dimensions
         new_dims = {k: v for k, v in new_dims.items() if v != 0}
-        
+
         return Unit(
             name=f"{self.name}/{other.name}",
             symbol=f"{self.symbol}/{other.symbol}",
             dimensions=new_dims,
-            scale=self.scale / other.scale
+            scale=self.scale / other.scale,
         )
-    
-    def __pow__(self, exponent: float) -> 'Unit':
+
+    def __pow__(self, exponent: float) -> "Unit":
         """Raise unit to a power."""
         new_dims = {k: v * exponent for k, v in self.dimensions.items()}
-        
+
         return Unit(
             name=f"{self.name}^{exponent}",
             symbol=f"{self.symbol}^{exponent}",
             dimensions=new_dims,
-            scale=self.scale ** exponent
+            scale=self.scale**exponent,
         )
-    
-    def is_compatible(self, other: 'Unit') -> bool:
+
+    def is_compatible(self, other: "Unit") -> bool:
         """Check if units have same dimensions."""
         return self.dimensions == other.dimensions
 
 
 class Quantity:
     """A numeric value with associated units."""
-    
+
     def __init__(self, value: Union[float, np.ndarray], unit: Unit):
         self.value = np.asarray(value)
         self.unit = unit
-    
-    def to(self, target_unit: Unit) -> 'Quantity':
+
+    def to(self, target_unit: Unit) -> "Quantity":
         """Convert to different unit."""
         if not self.unit.is_compatible(target_unit):
             raise ValueError(
                 f"Cannot convert {self.unit.symbol} to {target_unit.symbol}: "
                 f"incompatible dimensions"
             )
-        
+
         # Convert value
         conversion_factor = self.unit.scale / target_unit.scale
         new_value = self.value * conversion_factor
-        
+
         return Quantity(new_value, target_unit)
-    
-    def __add__(self, other: 'Quantity') -> 'Quantity':
+
+    def __add__(self, other: "Quantity") -> "Quantity":
         """Add quantities (must have compatible units)."""
         if not isinstance(other, Quantity):
             raise TypeError("Can only add Quantity to Quantity")
-        
+
         if not self.unit.is_compatible(other.unit):
             raise ValueError(
                 f"Cannot add {self.unit.symbol} and {other.unit.symbol}: "
                 f"incompatible units"
             )
-        
+
         # Convert other to self's units
         other_converted = other.to(self.unit)
         return Quantity(self.value + other_converted.value, self.unit)
-    
-    def __mul__(self, other: Union[float, 'Quantity']) -> 'Quantity':
+
+    def __mul__(self, other: Union[float, "Quantity"]) -> "Quantity":
         """Multiply quantities or by scalar."""
         if isinstance(other, Quantity):
-            return Quantity(
-                self.value * other.value,
-                self.unit * other.unit
-            )
+            return Quantity(self.value * other.value, self.unit * other.unit)
         else:
             return Quantity(self.value * other, self.unit)
-    
-    def __truediv__(self, other: Union[float, 'Quantity']) -> 'Quantity':
+
+    def __truediv__(self, other: Union[float, "Quantity"]) -> "Quantity":
         """Divide quantities or by scalar."""
         if isinstance(other, Quantity):
-            return Quantity(
-                self.value / other.value,
-                self.unit / other.unit
-            )
+            return Quantity(self.value / other.value, self.unit / other.unit)
         else:
             return Quantity(self.value / other, self.unit)
-    
+
     def __repr__(self) -> str:
         return f"{self.value} {self.unit.symbol}"
 
@@ -143,7 +137,7 @@ class Quantity:
 # Common unit definitions
 class Units:
     """Common scientific units."""
-    
+
     # Base SI units
     meter = Unit("meter", "m", {"length": 1})
     kilogram = Unit("kilogram", "kg", {"mass": 1})
@@ -151,13 +145,13 @@ class Units:
     ampere = Unit("ampere", "A", {"current": 1})
     kelvin = Unit("kelvin", "K", {"temperature": 1})
     mole = Unit("mole", "mol", {"amount": 1})
-    
+
     # Derived units
     newton = Unit("newton", "N", {"mass": 1, "length": 1, "time": -2})
     joule = Unit("joule", "J", {"mass": 1, "length": 2, "time": -2})
     watt = Unit("watt", "W", {"mass": 1, "length": 2, "time": -3})
     pascal = Unit("pascal", "Pa", {"mass": 1, "length": -1, "time": -2})
-    
+
     # Length units
     millimeter = Unit("millimeter", "mm", {"length": 1}, scale=0.001)
     centimeter = Unit("centimeter", "cm", {"length": 1}, scale=0.01)
@@ -165,46 +159,78 @@ class Units:
     inch = Unit("inch", "in", {"length": 1}, scale=0.0254)
     foot = Unit("foot", "ft", {"length": 1}, scale=0.3048)
     mile = Unit("mile", "mi", {"length": 1}, scale=1609.344)
-    
+
     # Time units
     millisecond = Unit("millisecond", "ms", {"time": 1}, scale=0.001)
     microsecond = Unit("microsecond", "μs", {"time": 1}, scale=1e-6)
     minute = Unit("minute", "min", {"time": 1}, scale=60)
     hour = Unit("hour", "h", {"time": 1}, scale=3600)
     day = Unit("day", "d", {"time": 1}, scale=86400)
-    
+
     # Mass units
     gram = Unit("gram", "g", {"mass": 1}, scale=0.001)
     milligram = Unit("milligram", "mg", {"mass": 1}, scale=1e-6)
     pound = Unit("pound", "lb", {"mass": 1}, scale=0.453592)
-    
+
     # Temperature (special handling needed for non-linear conversions)
     celsius = Unit("celsius", "°C", {"temperature": 1})
     fahrenheit = Unit("fahrenheit", "°F", {"temperature": 1})
-    
+
     # Dimensionless
     dimensionless = Unit("dimensionless", "", {})
     percent = Unit("percent", "%", {}, scale=0.01)
-    
+
     # Frequency
     hertz = Unit("hertz", "Hz", {"time": -1})
     kilohertz = Unit("kilohertz", "kHz", {"time": -1}, scale=1000)
     megahertz = Unit("megahertz", "MHz", {"time": -1}, scale=1e6)
-    
+
     # Electrical units
     volt = Unit("volt", "V", {"mass": 1, "length": 2, "time": -3, "current": -1})
-    millivolt = Unit("millivolt", "mV", {"mass": 1, "length": 2, "time": -3, "current": -1}, scale=0.001)
-    microvolt = Unit("microvolt", "μV", {"mass": 1, "length": 2, "time": -3, "current": -1}, scale=1e-6)
-    kilovolt = Unit("kilovolt", "kV", {"mass": 1, "length": 2, "time": -3, "current": -1}, scale=1000)
-    
+    millivolt = Unit(
+        "millivolt",
+        "mV",
+        {"mass": 1, "length": 2, "time": -3, "current": -1},
+        scale=0.001,
+    )
+    microvolt = Unit(
+        "microvolt",
+        "μV",
+        {"mass": 1, "length": 2, "time": -3, "current": -1},
+        scale=1e-6,
+    )
+    kilovolt = Unit(
+        "kilovolt",
+        "kV",
+        {"mass": 1, "length": 2, "time": -3, "current": -1},
+        scale=1000,
+    )
+
     ohm = Unit("ohm", "Ω", {"mass": 1, "length": 2, "time": -3, "current": -2})
-    kiloohm = Unit("kiloohm", "kΩ", {"mass": 1, "length": 2, "time": -3, "current": -2}, scale=1000)
-    
+    kiloohm = Unit(
+        "kiloohm", "kΩ", {"mass": 1, "length": 2, "time": -3, "current": -2}, scale=1000
+    )
+
     farad = Unit("farad", "F", {"mass": -1, "length": -2, "time": 4, "current": 2})
-    microfarad = Unit("microfarad", "μF", {"mass": -1, "length": -2, "time": 4, "current": 2}, scale=1e-6)
-    nanofarad = Unit("nanofarad", "nF", {"mass": -1, "length": -2, "time": 4, "current": 2}, scale=1e-9)
-    picofarad = Unit("picofarad", "pF", {"mass": -1, "length": -2, "time": 4, "current": 2}, scale=1e-12)
-    
+    microfarad = Unit(
+        "microfarad",
+        "μF",
+        {"mass": -1, "length": -2, "time": 4, "current": 2},
+        scale=1e-6,
+    )
+    nanofarad = Unit(
+        "nanofarad",
+        "nF",
+        {"mass": -1, "length": -2, "time": 4, "current": 2},
+        scale=1e-9,
+    )
+    picofarad = Unit(
+        "picofarad",
+        "pF",
+        {"mass": -1, "length": -2, "time": 4, "current": 2},
+        scale=1e-12,
+    )
+
     # Common abbreviations
     s = second
     ms = millisecond
@@ -216,10 +242,11 @@ class Units:
 
 def validate_units(func):
     """Decorator to validate unit compatibility in operations."""
+
     def wrapper(*args, **kwargs):
         # Extract quantities from args
         quantities = [arg for arg in args if isinstance(arg, Quantity)]
-        
+
         # Check if all quantities have compatible units
         if len(quantities) > 1:
             base_unit = quantities[0].unit
@@ -227,11 +254,11 @@ def validate_units(func):
                 if not base_unit.is_compatible(q.unit):
                     warnings.warn(
                         f"Unit mismatch: {base_unit.symbol} vs {q.unit.symbol}",
-                        UserWarning
+                        UserWarning,
                     )
-        
+
         return func(*args, **kwargs)
-    
+
     return wrapper
 
 
@@ -241,8 +268,9 @@ def Q(value: Union[float, np.ndarray], unit: Unit) -> Quantity:
     return Quantity(value, unit)
 
 
-def ensure_units(value: Union[float, np.ndarray, Quantity], 
-                default_unit: Unit) -> Quantity:
+def ensure_units(
+    value: Union[float, np.ndarray, Quantity], default_unit: Unit
+) -> Quantity:
     """Ensure value has units, applying default if needed."""
     if isinstance(value, Quantity):
         return value
@@ -262,20 +290,20 @@ def strip_units(quantity: Union[Quantity, float, np.ndarray]) -> np.ndarray:
 def convert_temperature(value: float, from_unit: str, to_unit: str) -> float:
     """Convert temperature between units (handles non-linear conversions)."""
     conversions = {
-        ('C', 'F'): lambda c: c * 9/5 + 32,
-        ('F', 'C'): lambda f: (f - 32) * 5/9,
-        ('C', 'K'): lambda c: c + 273.15,
-        ('K', 'C'): lambda k: k - 273.15,
-        ('F', 'K'): lambda f: (f - 32) * 5/9 + 273.15,
-        ('K', 'F'): lambda k: (k - 273.15) * 9/5 + 32
+        ("C", "F"): lambda c: c * 9 / 5 + 32,
+        ("F", "C"): lambda f: (f - 32) * 5 / 9,
+        ("C", "K"): lambda c: c + 273.15,
+        ("K", "C"): lambda k: k - 273.15,
+        ("F", "K"): lambda f: (f - 32) * 5 / 9 + 273.15,
+        ("K", "F"): lambda k: (k - 273.15) * 9 / 5 + 32,
     }
-    
+
     from_unit = from_unit.upper()[0]
     to_unit = to_unit.upper()[0]
-    
+
     if from_unit == to_unit:
         return value
-    
+
     key = (from_unit, to_unit)
     if key in conversions:
         return conversions[key](value)
@@ -285,7 +313,12 @@ def convert_temperature(value: float, from_unit: str, to_unit: str) -> float:
 
 # Export main components
 __all__ = [
-    'Unit', 'Quantity', 'Units', 'Q',
-    'validate_units', 'ensure_units', 'strip_units',
-    'convert_temperature'
-]
+    "Unit",
+    "Quantity",
+    "Units",
+    "Q",
+    "validate_units",
+    "ensure_units",
+    "strip_units",
+    "convert_temperature",
+]

scitex/utils/_compress_hdf5.py

@@ -31,7 +31,7 @@ def compress_hdf5(input_file, output_file=None, compression_level=4):
         import h5py
     except ImportError:
         raise ImportError("h5py is required for HDF5 compression but not installed")
-    
+
     # Import tqdm if available
     try:
         from tqdm import tqdm
@@ -100,8 +100,8 @@ def compress_hdf5(input_file, output_file=None, compression_level=4):
         src.visititems(copy_dataset)
 
     print(
-        f"Compression complete. Original size: {os.path.getsize(input_file)/1e9:.2f} GB, "
-        f"New size: {os.path.getsize(output_file)/1e9:.2f} GB"
+        f"Compression complete. Original size: {os.path.getsize(input_file) / 1e9:.2f} GB, "
+        f"New size: {os.path.getsize(output_file) / 1e9:.2f} GB"
     )
 
     return output_file

scitex/utils/_email.py

@@ -48,13 +48,17 @@ def send_gmail(
 
     # Auto-detect SMTP server based on sender email or use provided server
     if smtp_server is None:
-        if '@gmail.com' in sender_gmail:
-            smtp_server = 'smtp.gmail.com'
+        if "@gmail.com" in sender_gmail:
+            smtp_server = "smtp.gmail.com"
             smtp_port = smtp_port or 587
         else:
             # Use scitex.ai mail server for scitex.ai emails
-            smtp_server = os.getenv('SCITEX_SCHOLAR_FROM_EMAIL_SMTP_SERVER', 'mail1030.onamae.ne.jp')
-            smtp_port = smtp_port or int(os.getenv('SCITEX_SCHOLAR_FROM_EMAIL_SMTP_PORT', '587'))
+            smtp_server = os.getenv(
+                "SCITEX_SCHOLAR_FROM_EMAIL_SMTP_SERVER", "mail1030.onamae.ne.jp"
+            )
+            smtp_port = smtp_port or int(
+                os.getenv("SCITEX_SCHOLAR_FROM_EMAIL_SMTP_PORT", "587")
+            )
 
     smtp_port = smtp_port or 587
 

scitex/utils/_notify.py

@@ -4,6 +4,7 @@
 # File: /ssh:ywatanabe@sp:/home/ywatanabe/proj/SciTeX-Code/src/scitex/utils/_notify.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -57,12 +58,12 @@ def get_git_branch(scitex):
 def gen_footer(sender, script_name, scitex, branch):
     return f"""
 
-{'-'*30}
+{"-" * 30}
 Sent via
 - Host: {sender}
 - Script: {script_name}
 - Source: scitex v{scitex.__version__} (github.com/ywatanabe1989/scitex/blob/{branch}/src/scitex/gen/system_ops/_notify.py)
-{'-'*30}"""
+{"-" * 30}"""
 
 
 # This is an automated system notification. If received outside working hours, please disregard.
@@ -88,9 +89,16 @@ def notify(
 
     FAKE_PYTHON_SCRIPT_NAME = "$ python -c ..."
     # Use scitex.ai email addresses (not Gmail)
-    sender_gmail = os.getenv("SCITEX_SCHOLAR_FROM_EMAIL_ADDRESS", os.getenv("SCITEX_EMAIL_AGENT", "agent@scitex.ai"))
-    sender_password = os.getenv("SCITEX_SCHOLAR_FROM_EMAIL_PASSWORD", os.getenv("SCITEX_EMAIL_PASSWORD", ""))
-    recipient_email = recipient_email or os.getenv("SCITEX_SCHOLAR_TO_EMAIL_ADDRESS", "ywata1989@gmail.com")
+    sender_gmail = os.getenv(
+        "SCITEX_SCHOLAR_FROM_EMAIL_ADDRESS",
+        os.getenv("SCITEX_EMAIL_AGENT", "agent@scitex.ai"),
+    )
+    sender_password = os.getenv(
+        "SCITEX_SCHOLAR_FROM_EMAIL_PASSWORD", os.getenv("SCITEX_EMAIL_PASSWORD", "")
+    )
+    recipient_email = recipient_email or os.getenv(
+        "SCITEX_SCHOLAR_TO_EMAIL_ADDRESS", "ywata1989@gmail.com"
+    )
 
     if file is not None:
         script_name = str(file)
@@ -100,9 +108,7 @@ def notify(
         else:
             frames = inspect.stack()
             script_name = (
-                os.path.basename(frames[-1].filename)
-                if frames
-                else "(Not found)"
+                os.path.basename(frames[-1].filename) if frames else "(Not found)"
             )
         if (script_name == "-c") or (not script_name.endswith(".py")):
             script_name = FAKE_PYTHON_SCRIPT_NAME