Modal-Decomposition 0.2.0__tar.gz → 0.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/MANIFEST.in +1 -0
  2. {Modal-Decomposition-0.2.0/src/Modal_Decomposition.egg-info → modal_decomposition-0.3.0}/PKG-INFO +116 -15
  3. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/README.md +333 -236
  4. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/pyproject.toml +2 -4
  5. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/setup.py +21 -1
  6. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Base/Cache.py +2 -2
  7. modal_decomposition-0.3.0/src/Modal_Decomposition/Base/ConstDefine.py +237 -0
  8. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Base/TextDefine.py +2 -0
  9. modal_decomposition-0.3.0/src/Modal_Decomposition/Base/__init__.py +59 -0
  10. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/EEMD.py +2 -2
  11. modal_decomposition-0.3.0/src/Modal_Decomposition/EMD.py +417 -0
  12. modal_decomposition-0.3.0/src/Modal_Decomposition/EWT.py +1034 -0
  13. modal_decomposition-0.3.0/src/Modal_Decomposition/EWTpy.py +196 -0
  14. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/ICEEMDAN.py +4 -2
  15. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/LMD.py +48 -59
  16. modal_decomposition-0.3.0/src/Modal_Decomposition/Operator/Daubechies_polynomial.py +29 -0
  17. modal_decomposition-0.3.0/src/Modal_Decomposition/Operator/Empirical_wavelet.py +36 -0
  18. modal_decomposition-0.3.0/src/Modal_Decomposition/Operator/__init__.py +2 -0
  19. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/RPSEMD.py +4 -2
  20. modal_decomposition-0.3.0/src/Modal_Decomposition/SSA.py +450 -0
  21. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/SVMD.py +2 -2
  22. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Check.py +48 -26
  23. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Chunk.py +96 -41
  24. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Envelope.py +33 -11
  25. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/FFT.py +418 -0
  26. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Hilbert.py +6 -10
  27. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/Memory.py +346 -0
  28. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/Mirror.py +236 -0
  29. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Peaks.py +2 -2
  30. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/Slepian.py +468 -0
  31. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Spline.py +71 -129
  32. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/__init__.py +9 -8
  33. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Hilbert/_scipy_backend.py +8 -0
  34. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Slepian/C.py +228 -0
  35. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Slepian/_C/slepian_core.c +608 -0
  36. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Slepian/_C/slepian_dpss.h +67 -0
  37. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Slepian/__init__.py +1 -0
  38. modal_decomposition-0.3.0/src/Modal_Decomposition/Utils/_Slepian/numpy_slepian.py +295 -0
  39. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/__init__.py +77 -1
  40. modal_decomposition-0.3.0/src/Modal_Decomposition/VMD.py +931 -0
  41. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/_SVMD_numba.py +2 -2
  42. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/__init__.py +23 -3
  43. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0/src/Modal_Decomposition.egg-info}/PKG-INFO +116 -15
  44. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition.egg-info/SOURCES.txt +19 -4
  45. modal_decomposition-0.3.0/src/Modal_Decomposition.egg-info/requires.txt +19 -0
  46. Modal-Decomposition-0.2.0/tests/test_emd_new.py → modal_decomposition-0.3.0/tests/test_emd.py +268 -204
  47. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_envelope.py +3 -1
  48. modal_decomposition-0.3.0/tests/test_ewt.py +312 -0
  49. modal_decomposition-0.3.0/tests/test_ewtpy_adapter.py +220 -0
  50. modal_decomposition-0.3.0/tests/test_slepian.py +411 -0
  51. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_spline.py +24 -30
  52. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_utils.py +26 -0
  53. modal_decomposition-0.3.0/tests/test_vmd.py +193 -0
  54. Modal-Decomposition-0.2.0/src/Modal_Decomposition/Base/ConstDefine.py +0 -19
  55. Modal-Decomposition-0.2.0/src/Modal_Decomposition/Base/__init__.py +0 -21
  56. Modal-Decomposition-0.2.0/src/Modal_Decomposition/EMD.py +0 -102
  57. Modal-Decomposition-0.2.0/src/Modal_Decomposition/EMD_new.py +0 -267
  58. Modal-Decomposition-0.2.0/src/Modal_Decomposition/EWT.py +0 -110
  59. Modal-Decomposition-0.2.0/src/Modal_Decomposition/SSA.py +0 -238
  60. Modal-Decomposition-0.2.0/src/Modal_Decomposition/Utils/Memory.py +0 -160
  61. Modal-Decomposition-0.2.0/src/Modal_Decomposition/Utils/_Hilbert/_scipy_backend.py +0 -6
  62. Modal-Decomposition-0.2.0/src/Modal_Decomposition/VMD.py +0 -99
  63. Modal-Decomposition-0.2.0/src/Modal_Decomposition.egg-info/requires.txt +0 -13
  64. Modal-Decomposition-0.2.0/tests/test_path.py +0 -6
  65. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/LICENSE +0 -0
  66. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/setup.cfg +0 -0
  67. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Base/ClassDefine.py +0 -0
  68. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Base/ConfigDefine.py +0 -0
  69. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Base/PathDefine.py +0 -0
  70. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/CEEFD.py +0 -0
  71. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/CEEMD.py +0 -0
  72. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/CEEMDAN.py +0 -0
  73. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/EFD.py +0 -0
  74. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Error/RealizationError.py +0 -0
  75. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Error/__init__.py +0 -0
  76. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/FMD.py +0 -0
  77. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/MEMD.py +0 -0
  78. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Monotonicity.py +0 -0
  79. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/Seed.py +0 -0
  80. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.c +0 -0
  81. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.h +0 -0
  82. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/math_const.h +0 -0
  83. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.c +0 -0
  84. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.h +0 -0
  85. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_fft.py +0 -0
  86. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_fht.py +0 -0
  87. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_fht_native.pyx +0 -0
  88. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_fir.py +0 -0
  89. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_forth_order_wave.py +0 -0
  90. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_kramers_kronig.py +0 -0
  91. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/Utils/_Hilbert/_wave.py +0 -0
  92. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition/_Registry.py +0 -0
  93. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition.egg-info/dependency_links.txt +0 -0
  94. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/src/Modal_Decomposition.egg-info/top_level.txt +0 -0
  95. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_cache.py +0 -0
  96. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_chunk.py +0 -0
  97. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_contract.py +0 -0
  98. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_facade.py +0 -0
  99. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_fht.py +0 -0
  100. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_fmd_lmd_refactor.py +0 -0
  101. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_import.py +0 -0
  102. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_montonic.py +0 -0
  103. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_peaks.py +0 -0
  104. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_reconstruction.py +0 -0
  105. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_registry.py +0 -0
  106. {Modal-Decomposition-0.2.0 → modal_decomposition-0.3.0}/tests/test_seed.py +0 -0
@@ -6,3 +6,4 @@ include LICENSE
6
6
  include README.md
7
7
  recursive-include src/Modal_Decomposition/Utils/_Hilbert/_C *
8
8
  include src/Modal_Decomposition/Utils/_Hilbert/_fht_native.pyx
9
+ recursive-include src/Modal_Decomposition/Utils/_Slepian/_C *.c *.h
@@ -1,6 +1,6 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.4
2
2
  Name: Modal-Decomposition
3
- Version: 0.2.0
3
+ Version: 0.3.0
4
4
  Summary: a package for modal decomposition
5
5
  Author-email: Mao_HaoChuan <2215269365@qq.com>
6
6
  License: Apache-2.0
@@ -19,15 +19,19 @@ Description-Content-Type: text/markdown
19
19
  License-File: LICENSE
20
20
  Requires-Dist: numpy
21
21
  Requires-Dist: EMD-signal
22
- Requires-Dist: ewtpy
23
22
  Requires-Dist: scipy
24
- Requires-Dist: vmdpy
25
23
  Requires-Dist: psutil
26
- Provides-Extra: dev
27
- Requires-Dist: pytest>=7.0; extra == "dev"
28
- Requires-Dist: black; extra == "dev"
29
- Provides-Extra: plot
30
- Requires-Dist: matplotlib; extra == "plot"
24
+ Provides-Extra: cupy
25
+ Requires-Dist: cupy-cuda12x; extra == "cupy"
26
+ Provides-Extra: pyfftw
27
+ Requires-Dist: pyfftw; extra == "pyfftw"
28
+ Provides-Extra: vmdpy
29
+ Requires-Dist: vmdpy; extra == "vmdpy"
30
+ Provides-Extra: scipy
31
+ Requires-Dist: scipy; extra == "scipy"
32
+ Provides-Extra: ewtpy
33
+ Requires-Dist: ewtpy; extra == "ewtpy"
34
+ Dynamic: license-file
31
35
 
32
36
  # Modal-Decomposition
33
37
 
@@ -52,6 +56,7 @@ algorithms (or benchmarking them against each other) is a one-line change.
52
56
  | EFD | Empirical Fourier Decomposition | `Function.EFD(S)` | [10.1016/j.ymssp.2021.108155](https://www.sciencedirect.com/science/article/abs/pii/S0888327021005355?via%3Dihub) |
53
57
  | EMD | Empirical Mode Decomposition | `Function.EMD(S)` | [10.1098/rspa.1998.0193](https://www.semanticscholar.org/paper/The-empirical-mode-decomposition-and-the-Hilbert-Huang-Shen/3842d81b0375dae8ae92734aa2a5d4aeed7a91d1) |
54
58
  | EWT | Empirical Wavelet Transform | `Function.EWT(S)` | [10.48550/arXiv.2304.06274](https://arxiv.org/abs/2304.06274) |
59
+ | EWTpy | Empirical Wavelet Transform (optional `ewtpy` backend) | `Function.EWTpy(S)` | [10.48550/arXiv.2304.06274](https://arxiv.org/abs/2304.06274) |
55
60
  | FMD | Filtered Mode Decomposition | `Function.FMD(S)` | [10.1109/TIE.2022.3156156](https://ieeexplore.ieee.org/document/9732251) |
56
61
  | ICEEMDAN | Improved Complete Ensemble Empirical Mode Decomposition with Adaptive Noise | `Function.ICEEMDAN(S)` | [10.1007/s10470-021-01901-3](https://link.springer.com/article/10.1007/s10470-021-01901-3#citeas) |
57
62
  | LMD | Local Mean Decomposition | `Function.LMD(S)` | [10.1098/rsif.2005.0058](https://royalsocietypublishing.org/doi/10.1098/rsif.2005.0058) |
@@ -95,18 +100,41 @@ Requires **Python >= 3.10**.
95
100
  |-------------|-----------------------------------------------------|
96
101
  | numpy | core arrays and vectorized kernels |
97
102
  | scipy | splines, envelope / Hilbert, filtering, peaks, FFT |
98
- | EMD-signal (PyEMD) | EMD, EEMD, CEEMDAN (and ensemble chains) |
99
- | ewtpy | EWT |
100
- | vmdpy | VMD |
103
+ | EMD-signal (PyEMD) | **EEMD and CEEMDAN only** — the last remaining third-party decomposition dependency |
101
104
  | psutil | available-memory reading for the memmap policy |
102
105
 
103
106
  > Please install `EMD-signal`, not `PyEMD` (the latter is an unrelated older package).
104
107
 
108
+ **PyEMD is the only third-party decomposition backend left.** Every other
109
+ method — `EMD`, `CEEMD`, `ICEEMDAN`, `RPSEMD`, `VMD`, `EWT`, `LMD`, `FMD`,
110
+ `EFD`, `CEEFD`, `SSA`, `SVMD`, `MEMD` — is implemented inside this library and
111
+ needs nothing beyond numpy/scipy. Only `EEMD` and `CEEMDAN` still delegate to
112
+ PyEMD, and **that dependency is being removed**: the `0.3.x` line exists
113
+ precisely to finish porting those two remaining branches, after which the
114
+ library stands on its own (see [Roadmap](#roadmap)).
115
+
116
+ `vmdpy` and `ewtpy` are **not** required: the native `VMD` / `EWT` replace them
117
+ entirely. `vmdpy` survives only as an optional parity-check backend
118
+ (`Class.VMD(vmdpy=True)`) and `EWTpy` / `ewtpy` only as an optional
119
+ reference-implementation adapter. Both are imported lazily, so neither is a
120
+ runtime dependency.
121
+
122
+ `EWT` (Empirical Wavelet Transform) is implemented **inside this library** and
123
+ needs no third-party package. The ewtpy-backed variant `EWTpy` is **optional**:
124
+ `ewtpy` is imported lazily (via `cache.import_module`) only when you actually
125
+ call `Function.EWTpy` / `Class.EWTpy(...).decompose(...)`, so a missing `ewtpy`
126
+ never affects the rest of the library — install it with
127
+ `pip install Modal-Decomposition[ewtpy]` (or plain `pip install ewtpy`) if you
128
+ want that entry.
129
+
105
130
  Optional extras (not required at runtime): `[dev]` (pytest, black) and
106
131
  `[plot]` (matplotlib). `numba` may be installed to activate the optional
107
132
  `"numba"` backend of `Utils.Peaks` / `SVMD`; everything degrades gracefully
108
133
  without it.
109
134
 
135
+ Accessing any method other than `EEMD` / `CEEMDAN` therefore never triggers a
136
+ PyEMD import at all — `EMD` in particular is the native sifting engine.
137
+
110
138
  ## Quick Start
111
139
 
112
140
  ```python
@@ -199,18 +227,91 @@ checks and chunked utilities (`Utils.Chunk`) follow the same policy.
199
227
  src/Modal_Decomposition/
200
228
  ├── __init__.py Class / Function namespaces + global API
201
229
  ├── <METHOD>.py 1 Config dataclass + 1 Decomposer per method
202
- ├── EMD_new.py experimental native (PyEMD-free) EMD engine
230
+ ├── EMD.py native EMD engine (PyEMD-free; original EMD_new,
231
+ │ registered as the public "EMD"). Only EEMD / CEEMDAN
232
+ │ still reach PyEMD; the 0.3.x line removes that too
203
233
  ├── _Registry.py class registry (registration at import time)
204
234
  ├── Base/ Decomposer ABC, DecompositionResult, Config,
205
235
  │ import Cache, metadata tables, size constants
206
- └── Utils/ Check / Chunk / Peaks / Spline / Envelope / Hilbert /
207
- Monotonicity / Memory / Seed (+ _Hilbert FHT backends)
236
+ └── Utils/ Check / Chunk / Peaks / Mirror / Spline / Envelope /
237
+ Hilbert / Monotonicity / Memory / Seed / FFT / Slepian
238
+ (+ _Hilbert FHT and _Slepian C backends)
208
239
  tests/ pytest suite + benchmarking harnesses (comparison/,
209
240
  ssa/, test_memory/) against PyEMD and PySDKit
210
241
  ```
211
242
 
243
+ ## Roadmap
244
+
245
+ **`0.3.0` is the current release.** PyEMD is the only third-party
246
+ decomposition backend still in use, and it is on the way out; the version
247
+ plan splits the remaining work into two lines:
248
+
249
+ | Line | Scope |
250
+ |------|-------|
251
+ | **`0.3.x`** | **Finish removing PyEMD.** Port the two remaining PyEMD-backed branches (`EEMD`, `CEEMDAN`) onto the native engine, so the whole package runs on numpy/scipy alone. Nothing else is planned for this line — bug fixups are deliberately deferred. |
252
+ | **`0.4.0`** | **First fully self-developed release.** With every method native, this line takes on the remaining bug fixups and correctness work across the library. |
253
+
212
254
  ## Changelog
213
255
 
256
+ ### 0.3.0
257
+
258
+ - **Version line opened.** PyEMD is now the *only* third-party decomposition
259
+ dependency: `EEMD` and `CEEMDAN` are the sole methods still backed by it,
260
+ and removing that dependency is the entire scope of the `0.3.x` line.
261
+ Everything else — `EMD`, `CEEMD`, `ICEEMDAN`, `RPSEMD`, `VMD`, `EWT`,
262
+ `LMD`, `FMD`, `EFD`, `CEEFD`, `SSA`, `SVMD`, `MEMD` — is already native.
263
+ - `vmdpy` and `ewtpy` are demoted to optional parity-check / reference
264
+ backends (`Class.VMD(vmdpy=True)`, `Class.EWTpy`), no longer runtime
265
+ dependencies of `VMD` / `EWT`.
266
+ - `EWT` is fully re-implemented in-library (boundary detection, filter bank,
267
+ transform and inverse) and no longer requires `ewtpy`; the `Operator`
268
+ package supplies the Daubechies transition functions.
269
+ - New `Utils.Slepian` (DPSS / Slepian sequences) with three backends —
270
+ `scipy` (default), `C` (self-contained compiled core, loaded via `ctypes`)
271
+ and `numpy` — plus a bounded process-wide LRU cache; used by the EWT
272
+ `pre_deal="Slepian-Optimize"` multitaper branch.
273
+ - `Utils.FFT` gained a backend dispatcher (`numpy` / `scipy` / `pyfftw` /
274
+ `tiled` / `cupy`, with `auto` splitting on `BIG_ARRAY`); all backends
275
+ remain optional and fall back to numpy.
276
+ - **Remaining work for this line:** port `EEMD` / `CEEMDAN` off PyEMD
277
+ (tracked as the `0.3.x` scope above). Bug fixups are out of scope until
278
+ `0.4.0`.
279
+
280
+ ### 0.2.1
281
+
282
+ - `EMD` is now the native self-implemented sifting engine (ex-`EMD_new`,
283
+ registered as the public `EMD`; the former PyEMD wrapper was removed) —
284
+ faster than PyEMD at equal mode quality, cold start ~ms vs ~0.5 s
285
+ (`docs/EMD_vs_EMD_new_Performance_Report.md`).
286
+ - `EMD(faster=...)` two-branch stopping policy: `faster=False` (default,
287
+ quality branch) additionally requires the classic narrowband balance
288
+ `|zc - ext| <= 1` before accepting each IMF (clean signals cost nothing;
289
+ noisy / long signals trade speed for row-level purity comparable with
290
+ PyEMD); `faster=True` keeps the legacy fast branch (energy Cauchy SD
291
+ stops sifting). Full four-way comparison (MD-quality / MD-fast / PyEMD /
292
+ PySDKit) in `docs/EMD_faster_Branch_Comparison_Report.md`. Speed ratios
293
+ are always quoted same-process/same-script (median timing in the bench
294
+ scripts), never cross-day absolute timings.
295
+ - `EMD` defaults (CubicSpline envelope + `sd_thr=0.01` + `faster=False`)
296
+ chosen by the mode-level validation (`docs/EMD_Validation_and_Comparison_Report.md`)
297
+ and the mechanism/optimization analysis (`docs/EMD_Quality_Gap_and_Optimization.md`);
298
+ `spline_kind` accepts the canonical `Utils.Spline` kinds.
299
+ - Temporary memmap backing files are now cleaned up: the input-layer memmap
300
+ registry deletes its files at interpreter exit (`atexit`, handle closed
301
+ first — required on Windows), and `Utils.Chunk.exo_chunks` deletes its
302
+ files when each iteration ends; see
303
+ `docs/EMD_Large_Signal_Memory_Report.md` §5.
304
+ - Timing / quality / memory benchmarks re-run on the native engine and
305
+ reported under `docs/` (four new reports + `docs/EXPERIMENTS_INDEX.md`);
306
+ stale test files removed and legacy benchmark data archived under
307
+ `tests/comparison/results/_legacy_pyemd_wrapper/`.
308
+ - LMD defaults to the extrema (Spline) interpolation envelope; the analytic
309
+ Hilbert envelope stays as an explicit opt-in only. The Hilbert-vs-Spline
310
+ envelope concepts are separated again (`Utils.Envelope` restored as its own
311
+ module).
312
+ - New `Utils.Mirror` (endpoint mirror extension, EMD nbsym + LMD boundary
313
+ modes) shared by EMD / LMD / future consumers.
314
+
214
315
  ### 0.2.0
215
316
 
216
317
  - Unified utility layer (`Utils.Chunk` / `Peaks` / `Check` / `Cache` /