PySDKit 0.4.41__tar.gz → 0.4.42__tar.gz

{pysdkit-0.4.41 → pysdkit-0.4.42}/PKG-INFO

@@ -1,10 +1,9 @@
 Metadata-Version: 2.4
 Name: PySDKit
-Version: 0.4.41
+Version: 0.4.42
 Summary: A Python library for signal decomposition algorithms with a unified interface.
 Author: josefinez, Deeksha Manjunath, Yuan Feng, JacktheFowler
-Author-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>, WenTong Zhao <23049200290@stu.xidian.edu.cn>
-Maintainer-email: Whenxuan Wang <wwhenxuan@gmail.com>
+Author-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>, Rongkun Zhu <mrpigzrk@gmail.com>, Kai Wu <kwu@xidian.edu.cn>, Lei Wang <wang_lei4759@163.com>, WenTong Zhao <23049200290@stu.xidian.edu.cn>
 License: MIT License
         
         Copyright (c) 2019 Whenxuan Wang
@@ -189,7 +188,7 @@ plot_IMFs_amplitude_spectra(IMFs, smooth="exp")   # use exp smooth
 | [`JMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/jmd.py) (Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169388-jump-plus-am-fm-mode-decomposition-jmd?s_tid=prof_contriblnk) |   ️✔️   |
 | [`MJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/mjmd.py) (Multivariate Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169393-multivariate-jump-plus-am-fm-mode-decomposition-mjmd?s_tid=prof_contriblnk) |   ✔️   |
 | [`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]]()                          |   ✔️   |
-|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✖️   |
+|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✔️   |
 |   [`STNBMD`]() (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) |   ✖️   |
 | [`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)   |   ✔️   |
 | [`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) |   ✔️   |

{pysdkit-0.4.41 → pysdkit-0.4.42}/PySDKit.egg-info/PKG-INFO

@@ -1,10 +1,9 @@
 Metadata-Version: 2.4
 Name: PySDKit
-Version: 0.4.41
+Version: 0.4.42
 Summary: A Python library for signal decomposition algorithms with a unified interface.
 Author: josefinez, Deeksha Manjunath, Yuan Feng, JacktheFowler
-Author-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>, WenTong Zhao <23049200290@stu.xidian.edu.cn>
-Maintainer-email: Whenxuan Wang <wwhenxuan@gmail.com>
+Author-email: Whenxuan Wang <wwhenxuan@gmail.com>, RuiZhe Wang <3133986068@qq.com>, Rongkun Zhu <mrpigzrk@gmail.com>, Kai Wu <kwu@xidian.edu.cn>, Lei Wang <wang_lei4759@163.com>, WenTong Zhao <23049200290@stu.xidian.edu.cn>
 License: MIT License
         
         Copyright (c) 2019 Whenxuan Wang
@@ -189,7 +188,7 @@ plot_IMFs_amplitude_spectra(IMFs, smooth="exp")   # use exp smooth
 | [`JMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/jmd.py) (Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169388-jump-plus-am-fm-mode-decomposition-jmd?s_tid=prof_contriblnk) |   ️✔️   |
 | [`MJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/mjmd.py) (Multivariate Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169393-multivariate-jump-plus-am-fm-mode-decomposition-mjmd?s_tid=prof_contriblnk) |   ✔️   |
 | [`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]]()                          |   ✔️   |
-|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✖️   |
+|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✔️   |
 |   [`STNBMD`]() (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) |   ✖️   |
 | [`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)   |   ✔️   |
 | [`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) |   ✔️   |

{pysdkit-0.4.41 → pysdkit-0.4.42}/PySDKit.egg-info/SOURCES.txt

@@ -121,6 +121,7 @@ pysdkit/tests/test_ceemdan.py
 pysdkit/tests/test_cvmd2d.py
 pysdkit/tests/test_eemd.py
 pysdkit/tests/test_emd.py
+pysdkit/tests/test_esmd.py
 pysdkit/tests/test_ewt.py
 pysdkit/tests/test_ewt2d.py
 pysdkit/tests/test_faemd.py

{pysdkit-0.4.41 → pysdkit-0.4.42}/README.md

@@ -135,7 +135,7 @@ plot_IMFs_amplitude_spectra(IMFs, smooth="exp")   # use exp smooth
 | [`JMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/jmd.py) (Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169388-jump-plus-am-fm-mode-decomposition-jmd?s_tid=prof_contriblnk) |   ️✔️   |
 | [`MJMD`](https://github.com/wwhenxuan/PySDKit/blob/main/pysdkit/_jmd/mjmd.py) (Multivariate Jump Plus AM-FM Mode Decomposition) |         [[paper]](https://arxiv.org/abs/2407.07800)          | [[code]](https://www.mathworks.com/matlabcentral/fileexchange/169393-multivariate-jump-plus-am-fm-mode-decomposition-mjmd?s_tid=prof_contriblnk) |   ✔️   |
 | [`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]]()                          |   ✔️   |
-|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✖️   |
+|   [`ESMD`]() (Extreme-Point Symmetric Mode Decomposition)    |          [[paper]](https://arxiv.org/abs/1303.6540)          |         [[code]](https://github.com/WuShichao/esmd)          |   ✔️   |
 |   [`STNBMD`]() (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) |   ✖️   |
 | [`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)   |   ✔️   |
 | [`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) |   ✔️   |

{pysdkit-0.4.41 → pysdkit-0.4.42}/pyproject.toml

@@ -12,15 +12,15 @@ requires-python = ">=3.8"
 authors = [
     { name = "Whenxuan Wang", email = "wwhenxuan@gmail.com" },
     { name = "RuiZhe Wang", email = "3133986068@qq.com" },
+    { name = "Rongkun Zhu", email = "mrpigzrk@gmail.com"},
+    { name = "Kai Wu", email = "kwu@xidian.edu.cn"},
+    { name = "Lei Wang", email = "wang_lei4759@163.com"},
     { name = "josefinez" },
     { name = "Deeksha Manjunath" },
     { name = "Yuan Feng" },
     { name = "WenTong Zhao", email = "23049200290@stu.xidian.edu.cn" },
     { name = "JacktheFowler" },
 ]
-maintainers = [
-    { name = "Whenxuan Wang", email = "wwhenxuan@gmail.com" },
-]
 keywords = [
     "signal decomposition",
     "signal processing",

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/__init__.py

@@ -2,7 +2,7 @@
 A Python library for signal decomposition algorithms.
 """
 
-__version__ = "0.4.41"
+__version__ = "0.4.42"
 
 # Empirical Mode Decomposition
 from ._emd import EMD
@@ -43,6 +43,9 @@ from ._hvd import HVD
 # Intrinsic Time-Scale Decomposition
 from ._itd import ITD
 
+# Extreme-Point Symmetric Mode Decomposition
+from ._esmd import ESMD, esmd
+
 # Local Mean Decomposition
 from ._lmd import LMD
 
@@ -178,6 +181,7 @@ Empirical Mode Decomposition 2D for images      |    EMD2D
 Bidimensional Multivariate EMD                  |    BMEMD
 Hilbert Vibration Decomposition                 |    HVD
 Intrinsic Time-Scale Decomposition              |    ITD
+Extreme-Point Symmetric Mode Decomposition      |    ESMD
 Local Mean Decomposition                        |    LMD
 Robust Local Mean Decomposition                 |    RLMD
 Singular Spectral Analysis                      |    SSA
@@ -230,6 +234,8 @@ __all__ = [
     "BMEMD",
     "HVD",
     "ITD",
+    "ESMD",
+    "esmd",
     "LMD",
     "RLMD",
     "SSA",

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_alif/__init__.py

@@ -1,5 +1,7 @@
 # -*- coding: utf-8 -*-
-"""Adaptive Local Iterative Filtering (ALIF) package."""
+"""
+alif package exports.
+"""
 
 from .alif import ALIF
 from .iterative_filtering import IterativeFiltering

pysdkit-0.4.42/pysdkit/_apmd/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+"""
+Adaptive Polymorphic Mode Decomposition (APMD).
+"""
+
+from .apmd import APMD

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_apmd/apmd.py

@@ -1,9 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/07/20
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
-
 Adaptive Polymorphic Mode Decomposition (APMD).
 
 Huang Z. and Liu J., Digital Signal Processing, 161:104913, 2025.

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/__init__.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/03 18:36:18
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Empirical Mode Decomposition family (EMD, EEMD, CEEMDAN, …).
 """
 
 from ._splines import akima, cubic, pchip, cubic_hermite, cubic_spline_3pts

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/_find_extrema.py

@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on Sat Mar 5 21:38:26 2024
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
 The following code is mainly used to find extreme points in the EMD algorithm
 
 Code taken from https://github.com/laszukdawid/PyEMD/blob/master/PyEMD/EMD.py

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/_prepare_points.py

@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on Sat Mar 8 22:53:11 2024
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
 The following code is mainly used to Performs extrapolation on edges by adding extra extrema in the EMD algorithm
 
 Code taken from https://github.com/laszukdawid/PyEMD/blob/master/PyEMD/EMD.py

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/_splines.py

@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on Sat Mar 5 22:09:45 2024
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
 The following code is mainly used to find extreme points in the EMD algorithm
 """
 

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/ceemdan.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/04 15:19:08
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Complete Ensemble Empirical Mode Decomposition with Adaptive Noise
 """
 
 import numpy as np

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/eemd.py

@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/03 18:36:18
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
 Code taken from https://github.com/laszukdawid/PyEMD/blob/master/PyEMD/EMD.py
 """
 

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/efd.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/04/16 22:51:55
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Empirical Fourier Decomposition
 """
 
 import numpy as np

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/emd.py

@@ -1,9 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on Sat Mar 4 21:58:54 2024
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
-
 Code taken from https://github.com/laszukdawid/PyEMD/blob/master/PyEMD/EMD.py
 """
 

pysdkit-0.4.42/pysdkit/_emd/hht/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+"""
+Hilbert–Huang Transform helpers.
+"""
+
+from .hht import HHT

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/hht/frequency.py

@@ -1,9 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/06 10:30:01
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
-Hilbert-transform for demodulation
+Perform Hilbert transform along the last axis of input signal.
 """
 
 import numpy as np

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/hht/hht.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/06 10:29:05
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Perform Hilbert-Huang transform on the input signal
 """
 
 import numpy as np

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/memd.py

@@ -1,8 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/04 13:10:33
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
 We refactored from https://github.com/mariogrune/MEMD-Python-
 """
 

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/remd.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/05 13:15:49
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Robust Empirical Mode Decomposition
 """
 
 import numpy as np

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/semd.py

@@ -1,9 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2026/08/01
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
-
 Serial-EMD (SEMD): fast multi-signal EMD via 1-D serialization.
 
 Zhang, J., Feng, F., Marti-Puig, P., Caiafa, C. F., Sun, Z., Duan, F.,

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd/tvf_emd.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/01 22:06:04
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Time Varying Filter based Empirical Mode Decomposition
 """
 
 import warnings

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd2d/__init__.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/03 18:36:49
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+Bidimensional EMD variants (EMD2D, BMEMD, …).
 """
 
 from .emd2d import EMD2D

pysdkit-0.4.42/pysdkit/_emd2d/bemd.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+"""
+Bemd module.
+"""

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd2d/bmemd.py

@@ -1,9 +1,5 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/05 13:18:18
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
-
 Bidimensional Multivariate Empirical Mode Decomposition (BMEMD)
 
 Xia, Y., Zhang, B., Pei, W., and Mandic, D. P. (2019).

{pysdkit-0.4.41 → pysdkit-0.4.42}/pysdkit/_emd2d/emd2d.py

@@ -1,8 +1,6 @@
 # -*- coding: utf-8 -*-
 """
-Created on 2025/02/04 13:13:52
-@author: Whenxuan Wang
-@email: wwhenxuan@gmail.com
+**Empirical Mode Decomposition 2D** for images data.
 """
 
 import numpy as np

pysdkit-0.4.42/pysdkit/_esmd/__init__.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+"""
+Extreme-Point Symmetric Mode Decomposition (ESMD).
+"""
+
+from .esmd import (
+    ESMD,
+    esmd,
+    find_extrema,
+    mean_curve,
+    sift_mode,
+    decompose_fixed_sift,
+    variance_ratio,
+    scan_variance_ratios,
+    instantaneous_amplitude,
+    instantaneous_frequency,
+    total_energy,
+    make_esmd_example3,
+    load_wind_demo,
+)
+
+__all__ = [
+    "ESMD",
+    "esmd",
+    "find_extrema",
+    "mean_curve",
+    "sift_mode",
+    "decompose_fixed_sift",
+    "variance_ratio",
+    "scan_variance_ratios",
+    "instantaneous_amplitude",
+    "instantaneous_frequency",
+    "total_energy",
+    "make_esmd_example3",
+    "load_wind_demo",
+]