scitex 2.1.2__py3-none-any.whl → 2.4.2__py3-none-any.whl

scitex/dict/_DotDict.py

@@ -1,15 +1,10 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Timestamp: "2025-08-22 22:03:48 (ywatanabe)"
-# File: /home/ywatanabe/proj/SciTeX-Code/src/scitex/dict/_DotDict.py
-# ----------------------------------------
-from __future__ import annotations
-import os
-__FILE__ = __file__
-__DIR__ = os.path.dirname(__FILE__)
-# ----------------------------------------
+# Timestamp: "2025-11-10 22:40:05 (ywatanabe)"
+
 
 import json
+import pprint as _pprint
 
 
 class DotDict:
@@ -94,14 +89,20 @@ class DotDict:
         # Use _data's get method
         return self._data.get(key, default)
 
-    def to_dict(self):
+    def to_dict(self, include_private=False):
         """
         Recursively converts DotDict and nested DotDict objects back to ordinary dictionaries.
+
+        Args:
+            include_private: If False, exclude keys starting with '_' (default: False)
         """
         result = {}
         for key, value in self._data.items():
+            # Skip private keys (starting with _) unless explicitly requested
+            if not include_private and isinstance(key, str) and key.startswith('_'):
+                continue
             if isinstance(value, DotDict):
-                value = value.to_dict()
+                value = value.to_dict(include_private=include_private)
             result[key] = value
         return result
 
@@ -134,10 +135,55 @@ class DotDict:
     def __repr__(self):
         """
         Returns a string representation suitable for debugging.
-        Shows the class name and the internal data representation.
+        Returns a nicely formatted representation that pprint can display properly.
+        Private keys (starting with '_') are hidden by default.
+        """
+        # Use pprint.pformat for nice formatting
+        # Convert to regular dict recursively, hiding private keys
+        return _pprint.pformat(self.to_dict(include_private=False), indent=2, width=80, compact=False)
+
+    def _repr_pretty_(self, p, cycle):
         """
-        # Use repr of the internal data for clarity
-        return f"{type(self).__name__}({repr(self._data)})"
+        IPython/Jupyter pretty printing support.
+        This method is called by IPython's pprint when displaying DotDict objects.
+        Private keys (starting with '_') are hidden by default.
+
+        Args:
+            p: The pretty printer object
+            cycle: Boolean indicating if we're in a reference cycle
+        """
+        if cycle:
+            p.text('DotDict(...)')
+        else:
+            with p.group(8, 'DotDict(', ')'):
+                if self._data:
+                    # Filter out private keys for display
+                    public_data = self.to_dict(include_private=False)
+                    p.pretty(public_data)
+                else:
+                    p.text('{}')
+
+    def pformat(self, indent=2, width=80, depth=None, compact=False, include_private=False):
+        """
+        Return a pretty-formatted string representation of the DotDict.
+
+        Args:
+            indent: Number of spaces per indentation level (default: 2)
+            width: Maximum line width (default: 80)
+            depth: Maximum depth to print (default: None for unlimited)
+            compact: If True, use more compact representation (default: False)
+            include_private: If True, include keys starting with '_' (default: False)
+
+        Returns:
+            Pretty-formatted string
+        """
+        return _pprint.pformat(
+            self.to_dict(include_private=include_private),
+            indent=indent,
+            width=width,
+            depth=depth,
+            compact=compact
+        )
 
     def __len__(self):
         """
@@ -274,7 +320,9 @@ class DotDict:
             if len(self._data) == 0:
                 return 0 < other
             # If single numeric value in total field, use it
-            if "total" in self._data and isinstance(self._data["total"], (int, float)):
+            if "total" in self._data and isinstance(
+                self._data["total"], (int, float)
+            ):
                 return self._data["total"] < other
             # Otherwise not comparable
             return NotImplemented
@@ -291,7 +339,9 @@ class DotDict:
             if len(self._data) == 0:
                 return 0 > other
             # If single numeric value in total field, use it
-            if "total" in self._data and isinstance(self._data["total"], (int, float)):
+            if "total" in self._data and isinstance(
+                self._data["total"], (int, float)
+            ):
                 return self._data["total"] > other
             # Otherwise not comparable
             return NotImplemented
@@ -374,127 +424,4 @@ if __name__ == "__main__":
     print(f"Original dd.name: {dd.name}")
     print(f"Copy dd_copy.name: {dd_copy.name}")
 
-# class DotDict:
-#     """
-#     A dictionary subclass that allows attribute-like access to keys.
-#     """
-
-#     def __init__(self, dictionary):
-#         for key, value in dictionary.items():
-#             if isinstance(value, dict):
-#                 value = DotDict(value)
-#             setattr(self, key, value)
-
-#     def __getitem__(self, key):
-#         return getattr(self, key)
-
-#     def __setitem__(self, key, value):
-#         setattr(self, key, value)
-
-#     def get(self, key, default=None):
-#         return getattr(self, key, default)
-
-#     def to_dict(self):
-#         """
-#         Recursively converts DotDict and nested DotDict objects back to ordinary dictionaries.
-#         """
-#         result = {}
-#         for key, value in self.__dict__.items():
-#             if isinstance(value, DotDict):
-#                 value = value.to_dict()
-#             result[key] = value
-#         return result
-
-#     # def __str__(self):
-#     #     """
-#     #     Returns a string representation of the dotdict by converting it to a dictionary and pretty-printing it.
-#     #     """
-#     #     return json.dumps(self.to_dict(), indent=4)
-
-#     def __str__(self):
-#         """
-#         Returns a string representation, handling non-JSON-serializable objects.
-#         """
-#         def default_handler(obj):
-#             return str(obj)
-
-#         return json.dumps(self.to_dict(), indent=4, default=default_handler)
-
-#     def __repr__(self):
-#         """
-#         Returns a string representation of the dotdict for debugging and development.
-#         """
-#         return self.__str__()
-
-#     def __len__(self):
-#         """
-#         Returns the number of key-value pairs in the dictionary.
-#         """
-#         return len(self.__dict__)
-
-#     def keys(self):
-#         """
-#         Returns a view object displaying a list of all the keys in the dictionary.
-#         """
-#         return self.__dict__.keys()
-
-#     def values(self):
-#         """
-#         Returns a view object displaying a list of all the values in the dictionary.
-#         """
-#         return self.__dict__.values()
-
-#     def items(self):
-#         """
-#         Returns a view object displaying a list of all the items (key, value pairs) in the dictionary.
-#         """
-#         return self.__dict__.items()
-
-#     def update(self, dictionary):
-#         """
-#         Updates the dictionary with the key-value pairs from another dictionary.
-#         """
-#         for key, value in dictionary.items():
-#             if isinstance(value, dict):
-#                 value = DotDict(value)
-#             setattr(self, key, value)
-
-#     def setdefault(self, key, default=None):
-#         """
-#         Returns the value of the given key. If the key does not exist, insert the key with the specified default value.
-#         """
-#         if key not in self.__dict__:
-#             self[key] = default
-#         return self[key]
-
-#     def pop(self, key, default=None):
-#         """
-#         Removes the specified key and returns the corresponding value.
-#         """
-#         return self.__dict__.pop(key, default)
-
-#     def __contains__(self, key):
-#         """
-#         Checks if the dotdict contains the specified key.
-#         """
-#         return key in self.__dict__
-
-#     def __iter__(self):
-#         """
-#         Returns an iterator over the keys of the dictionary.
-#         """
-#         return iter(self.__dict__)
-
-#     def copy(self):
-#         """
-#         Creates a deep copy of the DotDict object.
-#         """
-#         return DotDict(self.to_dict().copy())
-
-#     def __delitem__(self, key):
-#         """
-#         Deletes the specified key from the dictionary.
-#         """
-#         delattr(self, key)
-
 # EOF

scitex/dict/__init__.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+
 """Scitex dict module."""
 
 from ._DotDict import DotDict

scitex/dict/_flatten.py

@@ -1,15 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Timestamp: "2025-10-07 21:42:24 (ywatanabe)"
-# File: /home/ywatanabe/proj/scitex_repo/src/scitex/dict/_flatten.py
-# ----------------------------------------
-from __future__ import annotations
-import os
-__FILE__ = (
-    "./src/scitex/dict/_flatten.py"
-)
-__DIR__ = os.path.dirname(__FILE__)
-# ----------------------------------------
+# Timestamp: "2025-11-10 22:38:40 (ywatanabe)"
+
 
 def flatten(nested_dict, parent_key="", sep="_"):
     items = []

scitex/dict/_listed_dict.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Time-stamp: "2024-11-02 12:40:01 (ywatanabe)"
-# File: ./scitex_repo/src/scitex/dict/_listed_dict.py
+# Timestamp: "2025-11-10 22:39:50 (ywatanabe)"
+
 
 from collections import defaultdict
 
@@ -38,5 +38,4 @@ def listed_dict(keys=None):
             dict_list[k] = []
     return dict_list
 
-
 # EOF

scitex/dict/_pop_keys.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Time-stamp: "2024-11-02 12:40:04 (ywatanabe)"
-# File: ./scitex_repo/src/scitex/dict/_pop_keys.py
+# Timestamp: "2025-11-10 22:40:16 (ywatanabe)"
+
 
 import numpy as np
 
@@ -32,5 +32,4 @@ def pop_keys(keys_list, keys_to_pop):
     keys_remainded_list = list(np.array(keys_list)[list(indi_to_remain)])
     return keys_remainded_list
 
-
 # EOF

scitex/dict/_replace.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Time-stamp: "ywatanabe (2024-11-03 00:48:34)"
-# File: ./scitex_repo/src/scitex/dict/_replace.py
+# Timestamp: "2025-11-10 22:40:21 (ywatanabe)"
 
 
 def replace(string, dict):
@@ -9,5 +8,4 @@ def replace(string, dict):
         string = string.replace(k, v)
     return string
 
-
 # EOF

scitex/dict/_safe_merge.py

@@ -1,23 +1,12 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-# Time-stamp: "ywatanabe (2024-11-03 00:47:50)"
-# File: ./scitex_repo/src/scitex/dict/_safe_merge.py
-
-"""
-Functionality:
-    - Safely merges multiple dictionaries without overlapping keys
-Input:
-    - Multiple dictionaries to be merged
-Output:
-    - A single merged dictionary
-Prerequisites:
-    - scitex.gen package with search function
-"""
+# Timestamp: "2025-11-10 22:55:38 (ywatanabe)"
+
 
 from typing import Any as _Any
 from typing import Dict
 
-from ..utils import search
+from scitex.utils import search
 
 
 def safe_merge(*dicts: Dict[_Any, _Any]) -> Dict[_Any, _Any]:
@@ -49,7 +38,9 @@ def safe_merge(*dicts: Dict[_Any, _Any]) -> Dict[_Any, _Any]:
         merged_dict: Dict[_Any, _Any] = {}
         for current_dict in dicts:
             overlap_check = search(
-                merged_dict.keys(), current_dict.keys(), only_perfect_match=True
+                merged_dict.keys(),
+                current_dict.keys(),
+                only_perfect_match=True,
             )
             if overlap_check != ([], []):
                 raise ValueError("Overlapping keys found between dictionaries")
@@ -58,5 +49,4 @@ def safe_merge(*dicts: Dict[_Any, _Any]) -> Dict[_Any, _Any]:
     except Exception as error:
         raise ValueError(f"Dictionary merge failed: {str(error)}")
 
-
 # EOF

scitex/dict/_to_str.py

@@ -1,7 +1,9 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# Timestamp: "2025-11-10 22:38:47 (ywatanabe)"
+
+
 # Time-stamp: "ywatanabe (2024-11-03 00:48:22)"
-# File: ./scitex_repo/src/scitex/dict/_to_str.py
 
 
 def to_str(dictionary, delimiter="_"):
@@ -26,7 +28,8 @@ def to_str(dictionary, delimiter="_"):
     str
         A string representation of the input dictionary.
     """
-    return delimiter.join(f"{key}-{value}" for key, value in dictionary.items())
-
+    return delimiter.join(
+        f"{key}-{value}" for key, value in dictionary.items()
+    )
 
 # EOF

scitex/dsp/_demo_sig.py

@@ -15,7 +15,7 @@ from ripple_detection.simulate import simulate_LFP, simulate_time
 from scipy.signal import chirp
 from tensorpac.signals import pac_signals_wavelet
 
-from ..io._load_configs import load_configs
+from scitex.io._load_configs import load_configs
 
 # Config
 CONFIG = load_configs(verbose=False)

scitex/dsp/_detect_ripples.py

@@ -7,7 +7,7 @@ import numpy as np
 import pandas as pd
 from scipy.signal import find_peaks
 
-from ..gen._norm import to_z
+from scitex.gen._norm import to_z
 from ._demo_sig import demo_sig
 from ._hilbert import hilbert
 from ._resample import resample

scitex/dsp/_ensure_3d.py

@@ -3,7 +3,7 @@
 # Time-stamp: "2024-11-05 01:03:47 (ywatanabe)"
 # File: ./scitex_repo/src/scitex/dsp/_ensure_3d.py
 
-from ..decorators import signal_fn
+from scitex.decorators import signal_fn
 
 
 @signal_fn

scitex/dsp/_hilbert.py

@@ -10,9 +10,9 @@ This script does XYZ.
 import sys
 
 import matplotlib.pyplot as plt
-from ..nn._Hilbert import Hilbert
+from scitex.nn._Hilbert import Hilbert
 
-from ..decorators import signal_fn
+from scitex.decorators import signal_fn
 
 
 # Functions

scitex/dsp/_misc.py

@@ -7,7 +7,7 @@
 # -*- coding: utf-8 -*-
 # Time-stamp: "2024-04-05 12:14:08 (ywatanabe)"
 
-from ..decorators import torch_fn
+from scitex.decorators import torch_fn
 
 
 @torch_fn

scitex/dsp/_modulation_index.py

@@ -5,8 +5,8 @@
 
 import torch
 
-from ..decorators import signal_fn
-from ..nn._ModulationIndex import ModulationIndex
+from scitex.decorators import signal_fn
+from scitex.nn._ModulationIndex import ModulationIndex
 
 
 @signal_fn

scitex/dsp/_pac.py

@@ -10,10 +10,10 @@ import sys
 import matplotlib.pyplot as plt
 import numpy as np
 import torch
-from ..str import printc
+from scitex.str import printc
 
-from ..decorators import signal_fn, batch_fn
-from ..nn._PAC import PAC
+from scitex.decorators import signal_fn, batch_fn
+from scitex.nn._PAC import PAC
 
 """
 scitex.dsp.pac function

scitex/dsp/_psd.py

@@ -7,8 +7,8 @@
 
 import torch
 
-from ..decorators import signal_fn
-from ..nn._PSD import PSD
+from scitex.decorators import signal_fn
+from scitex.nn._PSD import PSD
 
 
 @signal_fn

scitex/dsp/_resample.py

@@ -5,7 +5,7 @@
 
 import torch
 import torchaudio.transforms as T
-from ..decorators import signal_fn
+from scitex.decorators import signal_fn
 import scitex
 
 

scitex/dsp/_transform.py

@@ -8,7 +8,7 @@ import warnings
 import numpy as np
 import pandas as pd
 import torch
-from ..decorators import torch_fn
+from scitex.decorators import torch_fn
 
 
 def to_sktime_df(arr):

scitex/dsp/_wavelet.py

@@ -6,8 +6,8 @@
 """scitex.dsp.wavelet function"""
 
 
-from ..decorators import batch_fn, signal_fn
-from ..nn._Wavelet import Wavelet
+from scitex.decorators import batch_fn, signal_fn
+from scitex.nn._Wavelet import Wavelet
 import scitex
 
 

scitex/dsp/add_noise.py

@@ -4,7 +4,7 @@
 # File: ./scitex_repo/src/scitex/dsp/add_noise.py
 
 import torch
-from ..decorators import signal_fn
+from scitex.decorators import signal_fn
 
 
 def _uniform(shape, amp=1.0):

scitex/dsp/filt.py

@@ -6,7 +6,7 @@
 import scitex
 import numpy as np
 
-from ..decorators import signal_fn
+from scitex.decorators import signal_fn
 
 # No top-level imports from nn module to avoid circular dependency
 # Filters will be imported inside functions when needed
@@ -14,14 +14,14 @@ from ..decorators import signal_fn
 
 @signal_fn
 def gauss(x, sigma, t=None):
-    from ..nn._Filters import GaussianFilter
+    from scitex.nn._Filters import GaussianFilter
     return GaussianFilter(sigma)(x, t=t)
 
 
 @signal_fn
 def bandpass(x, fs, bands, t=None):
     import torch
-    from ..nn._Filters import BandPassFilter
+    from scitex.nn._Filters import BandPassFilter
 
     # Convert bands to tensor if it's not already
     if not isinstance(bands, torch.Tensor):
@@ -31,19 +31,19 @@ def bandpass(x, fs, bands, t=None):
 
 @signal_fn
 def bandstop(x, fs, bands, t=None):
-    from ..nn._Filters import BandStopFilter
+    from scitex.nn._Filters import BandStopFilter
     return BandStopFilter(bands, fs, x.shape[-1])(x, t=t)
 
 
 @signal_fn
 def lowpass(x, fs, cutoffs_hz, t=None):
-    from ..nn._Filters import LowPassFilter
+    from scitex.nn._Filters import LowPassFilter
     return LowPassFilter(cutoffs_hz, fs, x.shape[-1])(x, t=t)
 
 
 @signal_fn
 def highpass(x, fs, cutoffs_hz, t=None):
-    from ..nn._Filters import HighPassFilter
+    from scitex.nn._Filters import HighPassFilter
     return HighPassFilter(cutoffs_hz, fs, x.shape[-1])(x, t=t)
 
 

scitex/dsp/norm.py

@@ -3,7 +3,7 @@
 # Time-stamp: "2024-04-05 12:15:42 (ywatanabe)"
 
 import torch as _torch
-from ..decorators import signal_fn as _signal_fn
+from scitex.decorators import signal_fn as _signal_fn
 
 
 @_signal_fn

scitex/dsp/reference.py

@@ -4,7 +4,7 @@
 # File: ./scitex_repo/src/scitex/dsp/reference.py
 
 import torch as _torch
-from ..decorators import torch_fn as _torch_fn
+from scitex.decorators import torch_fn as _torch_fn
 
 
 @_torch_fn

scitex/dsp/utils/_differential_bandpass_filters.py

@@ -12,9 +12,9 @@ import numpy as np
 import torch
 import torch.nn as nn
 
-from ...decorators import torch_fn
-from ...gen._to_even import to_even
-from ...gen._to_odd import to_odd
+from scitex.decorators import torch_fn
+from scitex.gen._to_even import to_even
+from scitex.gen._to_odd import to_odd
 
 try:
     from torchaudio.prototype.functional import sinc_impulse_response

scitex/dsp/utils/_ensure_3d.py

@@ -3,7 +3,7 @@
 # Time-stamp: "2024-11-05 01:04:03 (ywatanabe)"
 # File: ./scitex_repo/src/scitex/dsp/utils/_ensure_3d.py
 
-from ...decorators import torch_fn
+from scitex.decorators import torch_fn
 
 
 @torch_fn

scitex/dsp/utils/_zero_pad.py

@@ -8,7 +8,7 @@ THIS_FILE = "/home/ywatanabe/proj/scitex_repo/src/scitex/dsp/utils/_zero_pad.py"
 import numpy as np
 import torch
 import torch.nn.functional as F
-from ...decorators import torch_fn
+from scitex.decorators import torch_fn
 
 
 def _zero_pad_1d(x, target_length):

scitex/dsp/utils/filter.py

@@ -7,8 +7,8 @@ import matplotlib.pyplot as plt
 import numpy as np
 from scipy.signal import firwin, freqz
 
-from ...decorators import numpy_fn
-from ...gen._to_even import to_even
+from scitex.decorators import numpy_fn
+from scitex.gen._to_even import to_even
 
 
 @numpy_fn

scitex/dt/_normalize_timestamp.py

@@ -405,7 +405,7 @@ def run_main() -> None:
 
     args = parse_args()
 
-    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng_manager = stx.session.start(
         sys,
         plt,
         args=args,

scitex/gen/_check_host.py

@@ -4,7 +4,7 @@
 # File: ./scitex_repo/src/scitex/gen/_check_host.py
 
 
-from .._sh import sh
+from scitex.sh import sh
 import sys