PySDKit 0.4.53__tar.gz → 0.4.55__tar.gz

{pysdkit-0.4.53 → pysdkit-0.4.55}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PySDKit
-Version: 0.4.53
+Version: 0.4.55
 Summary: A Python library for signal decomposition algorithms with a unified interface.
 Author: Whenxuan Wang, RuiZhe Wang, Rongkun Zhu, Kai Wu, Lei Wang, josefinez, Deeksha Manjunath, Yuan Feng, WenTong Zhao, JacktheFowler
 Maintainer-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>
@@ -198,7 +198,9 @@ plot_IMFs(signal, IMFs)             # per-channel panels
 | [`SJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/sjmd.py) / `SMJMD` (Successive Jump and Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2504.08453)          |                          [[code]]()                          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/jmd/sjmd.ipynb) |
 | [`ESMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_emd/esmd.py) (Extreme-Point Symmetric Mode Decomposition) |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/emd_variants/esmd.ipynb) |
 | [`STNBMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_vncmd/stnbmd.py) (Short-Time Narrow-Band Mode Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0022460X16002443?via%3Dihub) | [[code]](https://ww2.mathworks.cn/matlabcentral/fileexchange/56226-short-time-narrow-band-mode-decomposition-stnbmd-toolbox) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/vncmd/stnbmd.ipynb) |
-| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vftmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vtfmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`SST`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/sst.py) (Synchrosqueezing Transform) | [[paper]](https://doi.org/10.1016/j.sigpro.2014.08.010) | [[code]](https://www.commsp.ee.ic.ac.uk/~mandic/research/sst.htm) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/sst.ipynb) |
+| [`SET`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/set.py) (Synchroextracting Transform) | [[paper]](https://doi.org/10.1109/TIE.2017.2696503) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/62483-synchroextracting-transform?s_tid=srchtitle) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/set.ipynb) |
 | [`SWD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/swd.py) (Swarm Decomposition) |   [[paper]](https://doi.org/10.1016/j.sigpro.2016.09.004)    |  [[code]](https://github.com/gkaposto/Swarm-Decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/swd.ipynb) |
 | [`OSD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/osd.py) (Optimization-based Signal Decomposition) | [[paper]](https://web.stanford.edu/~boyd/papers/sig_decomp_mprox.html) |   [[code]](https://github.com/cvxgrp/signal-decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/osd_intro.ipynb) |
 | [`STL`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/tsa/_stl.py) (Seasonal-Trend decomposition using LOESS) | [[paper]](https://www.nniiem.ru/file/news/2016/stl-statistical-model.pdf) | [[code]](https://www.statsmodels.org/stable/examples/notebooks/generated/stl_decomposition.html) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tsa/stl.ipynb) |

{pysdkit-0.4.53 → pysdkit-0.4.55}/PySDKit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PySDKit
-Version: 0.4.53
+Version: 0.4.55
 Summary: A Python library for signal decomposition algorithms with a unified interface.
 Author: Whenxuan Wang, RuiZhe Wang, Rongkun Zhu, Kai Wu, Lei Wang, josefinez, Deeksha Manjunath, Yuan Feng, WenTong Zhao, JacktheFowler
 Maintainer-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>
@@ -198,7 +198,9 @@ plot_IMFs(signal, IMFs)             # per-channel panels
 | [`SJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/sjmd.py) / `SMJMD` (Successive Jump and Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2504.08453)          |                          [[code]]()                          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/jmd/sjmd.ipynb) |
 | [`ESMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_emd/esmd.py) (Extreme-Point Symmetric Mode Decomposition) |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/emd_variants/esmd.ipynb) |
 | [`STNBMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_vncmd/stnbmd.py) (Short-Time Narrow-Band Mode Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0022460X16002443?via%3Dihub) | [[code]](https://ww2.mathworks.cn/matlabcentral/fileexchange/56226-short-time-narrow-band-mode-decomposition-stnbmd-toolbox) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/vncmd/stnbmd.ipynb) |
-| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vftmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vtfmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`SST`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/sst.py) (Synchrosqueezing Transform) | [[paper]](https://doi.org/10.1016/j.sigpro.2014.08.010) | [[code]](https://www.commsp.ee.ic.ac.uk/~mandic/research/sst.htm) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/sst.ipynb) |
+| [`SET`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/set.py) (Synchroextracting Transform) | [[paper]](https://doi.org/10.1109/TIE.2017.2696503) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/62483-synchroextracting-transform?s_tid=srchtitle) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/set.ipynb) |
 | [`SWD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/swd.py) (Swarm Decomposition) |   [[paper]](https://doi.org/10.1016/j.sigpro.2016.09.004)    |  [[code]](https://github.com/gkaposto/Swarm-Decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/swd.ipynb) |
 | [`OSD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/osd.py) (Optimization-based Signal Decomposition) | [[paper]](https://web.stanford.edu/~boyd/papers/sig_decomp_mprox.html) |   [[code]](https://github.com/cvxgrp/signal-decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/osd_intro.ipynb) |
 | [`STL`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/tsa/_stl.py) (Seasonal-Trend decomposition using LOESS) | [[paper]](https://www.nniiem.ru/file/news/2016/stl-statistical-model.pdf) | [[code]](https://www.statsmodels.org/stable/examples/notebooks/generated/stl_decomposition.html) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tsa/stl.ipynb) |

{pysdkit-0.4.53 → pysdkit-0.4.55}/PySDKit.egg-info/SOURCES.txt

@@ -62,6 +62,8 @@ pysdkit/_osd/components.py
 pysdkit/_osd/osd.py
 pysdkit/_osd/swd.py
 pysdkit/_tfa/__init__.py
+pysdkit/_tfa/set.py
+pysdkit/_tfa/sst.py
 pysdkit/_tfa/vtfmtd.py
 pysdkit/_tid/__init__.py
 pysdkit/_tid/alif.py
@@ -102,8 +104,12 @@ pysdkit/data/_time_series.py
 pysdkit/data/apitmemd_section_2b.npy
 pysdkit/data/apitmemd_section_3a.npy
 pysdkit/data/apitmemd_section_3b.npy
+pysdkit/data/deconv_sig1.npy
+pysdkit/data/deconv_sig2.npy
+pysdkit/data/deconv_sig3.npy
 pysdkit/data/dual_signal_noise.npy
 pysdkit/data/ecg_055m.npy
+pysdkit/data/fast_kurtogram_x.npy
 pysdkit/data/fmd_demo.npy
 pysdkit/data/gearbox_fault_snippet.npy
 pysdkit/data/input_sig.npy
@@ -114,7 +120,11 @@ pysdkit/data/memd_syn_hex.npy
 pysdkit/data/memd_taichi_hex.npy
 pysdkit/data/oemd_ecg.npy
 pysdkit/data/prefixed_double_filter.npy
+pysdkit/data/set_batdata2.npy
+pysdkit/data/set_vibdata.npy
 pysdkit/data/single_nsignal.npy
+pysdkit/data/sst_doppler.npy
+pysdkit/data/sst_float.npy
 pysdkit/data/texture.txt
 pysdkit/data/vmd_example.npy
 pysdkit/entropy/__init__.py
@@ -145,6 +155,7 @@ pysdkit/tests/test_bmemd.py
 pysdkit/tests/test_ceemdan.py
 pysdkit/tests/test_cvmd2d.py
 pysdkit/tests/test_ddacmd.py
+pysdkit/tests/test_deconvolution.py
 pysdkit/tests/test_eemd.py
 pysdkit/tests/test_efd.py
 pysdkit/tests/test_emd.py
@@ -163,6 +174,7 @@ pysdkit/tests/test_imd.py
 pysdkit/tests/test_itd.py
 pysdkit/tests/test_ivgnmd.py
 pysdkit/tests/test_jmd.py
+pysdkit/tests/test_kurtogram.py
 pysdkit/tests/test_lmd.py
 pysdkit/tests/test_memd.py
 pysdkit/tests/test_moving_decomp.py
@@ -175,8 +187,10 @@ pysdkit/tests/test_ovmd.py
 pysdkit/tests/test_remd.py
 pysdkit/tests/test_rlmd.py
 pysdkit/tests/test_semd.py
+pysdkit/tests/test_set.py
 pysdkit/tests/test_sjmd.py
 pysdkit/tests/test_ssa.py
+pysdkit/tests/test_sst.py
 pysdkit/tests/test_stl.py
 pysdkit/tests/test_stnbmd.py
 pysdkit/tests/test_stvmd.py
@@ -211,7 +225,14 @@ pysdkit/utils/_function.py
 pysdkit/utils/_hilbert.py
 pysdkit/utils/_instantaneous.py
 pysdkit/utils/_kernel_matrix.py
+pysdkit/utils/_kurtogram.py
 pysdkit/utils/_mirror.py
 pysdkit/utils/_pca.py
 pysdkit/utils/_process.py
-pysdkit/utils/_smooth1d.py
+pysdkit/utils/_smooth1d.py
+pysdkit/utils/deconvolution/__init__.py
+pysdkit/utils/deconvolution/_acycbd.py
+pysdkit/utils/deconvolution/_common.py
+pysdkit/utils/deconvolution/_imckd.py
+pysdkit/utils/deconvolution/_plot.py
+pysdkit/utils/deconvolution/_smhd.py

{pysdkit-0.4.53 → pysdkit-0.4.55}/README.md

@@ -145,7 +145,9 @@ plot_IMFs(signal, IMFs)             # per-channel panels
 | [`SJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/sjmd.py) / `SMJMD` (Successive Jump and Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2504.08453)          |                          [[code]]()                          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/jmd/sjmd.ipynb) |
 | [`ESMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_emd/esmd.py) (Extreme-Point Symmetric Mode Decomposition) |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/emd_variants/esmd.ipynb) |
 | [`STNBMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_vncmd/stnbmd.py) (Short-Time Narrow-Band Mode Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0022460X16002443?via%3Dihub) | [[code]](https://ww2.mathworks.cn/matlabcentral/fileexchange/56226-short-time-narrow-band-mode-decomposition-stnbmd-toolbox) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/vncmd/stnbmd.ipynb) |
-| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vftmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`VTFMTD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/vtfmtd.py) (Variational TF Mode Tracking Decomposition) | [[paper]](https://www.sciencedirect.com/science/article/pii/S0165168426001179) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/183389-variational-time-frequency-mode-tracking-decomposition) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/vtfmtd.ipynb) |
+| [`SST`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/sst.py) (Synchrosqueezing Transform) | [[paper]](https://doi.org/10.1016/j.sigpro.2014.08.010) | [[code]](https://www.commsp.ee.ic.ac.uk/~mandic/research/sst.htm) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/sst.ipynb) |
+| [`SET`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_tfa/set.py) (Synchroextracting Transform) | [[paper]](https://doi.org/10.1109/TIE.2017.2696503) | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/62483-synchroextracting-transform?s_tid=srchtitle) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tfa/set.ipynb) |
 | [`SWD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/swd.py) (Swarm Decomposition) |   [[paper]](https://doi.org/10.1016/j.sigpro.2016.09.004)    |  [[code]](https://github.com/gkaposto/Swarm-Decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/swd.ipynb) |
 | [`OSD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_osd/osd.py) (Optimization-based Signal Decomposition) | [[paper]](https://web.stanford.edu/~boyd/papers/sig_decomp_mprox.html) |   [[code]](https://github.com/cvxgrp/signal-decomposition)   | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/osd/osd_intro.ipynb) |
 | [`STL`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/tsa/_stl.py) (Seasonal-Trend decomposition using LOESS) | [[paper]](https://www.nniiem.ru/file/news/2016/stl-statistical-model.pdf) | [[code]](https://www.statsmodels.org/stable/examples/notebooks/generated/stl_decomposition.html) | [[notebook]](https://github.com/wwhenxuan/PySDKit/blob/main/examples/tsa/stl.ipynb) |

{pysdkit-0.4.53 → pysdkit-0.4.55}/pysdkit/__init__.py

@@ -2,7 +2,7 @@
 A Python library for signal decomposition algorithms.
 """
 
-__version__ = "0.4.53"
+__version__ = "0.4.55"
 
 # Empirical Mode Decomposition
 from ._emd import EMD
@@ -130,6 +130,12 @@ from ._tid import ALIF
 # Variational Time-Frequency Mode Tracking Decomposition (TFA)
 from ._tfa import VTFMTD, vtfmtd
 
+# Synchrosqueezing Transform
+from ._tfa import SST, sst
+
+# Synchroextracting Transform
+from ._tfa import SET, set
+
 # Adaptive Polymorphic Mode Decomposition / Impulsive Mode Decomposition
 from ._imd import APMD, IMD, imd
 
@@ -231,6 +237,8 @@ Adaptive Variational Nonlinear Chirp Mode Dec.  |    AVNCMD
 Short-Time Narrow-Banded Mode Decomposition     |    STNBMD
 Adaptive Local Iterative Filtering              |    ALIF
 Variational TF Mode Tracking Decomposition      |    VTFMTD
+Synchrosqueezing Transform                      |    SST
+Synchroextracting Transform                     |    SET
 Adaptive Polymorphic Mode Decomposition         |    APMD
 Impulsive Mode Decomposition                    |    IMD
 Empirical Wavelet Transform                     |    EWT
@@ -308,6 +316,10 @@ __all__ = [
     "ALIF",
     "VTFMTD",
     "vtfmtd",
+    "SST",
+    "sst",
+    "SET",
+    "set",
     "APMD",
     "IMD",
     "imd",

pysdkit-0.4.55/pysdkit/_tfa/__init__.py

@@ -0,0 +1,97 @@
+# -*- coding: utf-8 -*-
+"""
+Time-Frequency Analysis (TFA).
+
+Methods that operate primarily on time-frequency representations
+(e.g. STFT) for mode separation and instantaneous-frequency tracking.
+"""
+
+from .vtfmtd import (
+    VTFMTD,
+    vtfmtd,
+    stft,
+    frequency_axis,
+    bin_index_grid,
+    expand_omega_init,
+    first_difference_gram,
+    estimate_if_centroid,
+    smooth_if,
+    moving_average_if,
+    omega_bins_to_hz,
+)
+from .sst import (
+    SST,
+    sst,
+    as_channels,
+    bump_transfer,
+    cwavelet_transform,
+    frequency_axis_linear,
+    invert_sst_band,
+    morlet_transfer,
+    multivariate_bandwidth,
+    parse_wavelet,
+    reflect_pad,
+    selective_cwt_mask,
+    sst_wavelet_linear,
+    universal_threshold,
+)
+from .set import (
+    SET,
+    set,
+    brevridge,
+    brevridge_mult,
+    frequency_axis_set,
+    gaussian_window,
+    odd_window_length,
+    reconstruct_from_ridges,
+    set_transform,
+    stft_gaussian_pair,
+    synchroextracting_operator,
+)
+from pysdkit.data._loaders import (
+    load_dual_signal_noise,
+    load_map2,
+    load_single_nsignal,
+)
+
+__all__ = [
+    "VTFMTD",
+    "vtfmtd",
+    "stft",
+    "frequency_axis",
+    "bin_index_grid",
+    "expand_omega_init",
+    "first_difference_gram",
+    "estimate_if_centroid",
+    "smooth_if",
+    "moving_average_if",
+    "omega_bins_to_hz",
+    "SST",
+    "sst",
+    "as_channels",
+    "bump_transfer",
+    "cwavelet_transform",
+    "frequency_axis_linear",
+    "invert_sst_band",
+    "morlet_transfer",
+    "multivariate_bandwidth",
+    "parse_wavelet",
+    "reflect_pad",
+    "selective_cwt_mask",
+    "sst_wavelet_linear",
+    "universal_threshold",
+    "SET",
+    "set",
+    "brevridge",
+    "brevridge_mult",
+    "frequency_axis_set",
+    "gaussian_window",
+    "odd_window_length",
+    "reconstruct_from_ridges",
+    "set_transform",
+    "stft_gaussian_pair",
+    "synchroextracting_operator",
+    "load_dual_signal_noise",
+    "load_single_nsignal",
+    "load_map2",
+]