Modal-Decomposition 0.5.0__tar.gz → 0.5.1__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 (72) hide show
  1. {modal_decomposition-0.5.0/src/Modal_Decomposition.egg-info → modal_decomposition-0.5.1}/PKG-INFO +1 -1
  2. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/pyproject.toml +2 -2
  3. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/CEEFD.py +3 -0
  4. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/ClassDefine.py +2 -0
  5. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/ConstDefine.py +2 -2
  6. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/__init__.py +30 -5
  7. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1/src/Modal_Decomposition.egg-info}/PKG-INFO +1 -1
  8. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition.egg-info/SOURCES.txt +1 -6
  9. modal_decomposition-0.5.0/MANIFEST.in +0 -21
  10. modal_decomposition-0.5.0/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.h +0 -54
  11. modal_decomposition-0.5.0/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/math_const.h +0 -35
  12. modal_decomposition-0.5.0/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.h +0 -38
  13. modal_decomposition-0.5.0/src/Modal_Decomposition/Utils/_Slepian/_C/slepian_dpss.h +0 -67
  14. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/LICENSE +0 -0
  15. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/README.md +0 -0
  16. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/setup.cfg +0 -0
  17. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/setup.py +0 -0
  18. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/CPU.py +0 -0
  19. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/Cache.py +0 -0
  20. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/Chunk.py +0 -0
  21. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/Memory.py +0 -0
  22. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/Seed.py +0 -0
  23. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Base/__init__.py +0 -0
  24. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/CEEMD.py +0 -0
  25. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/CEEMDAN.py +0 -0
  26. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/ConfigDefine.py +0 -0
  27. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/PathDefine.py +0 -0
  28. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/TextDefine.py +0 -0
  29. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Define/__init__.py +0 -0
  30. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/EEMD.py +0 -0
  31. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/EFD.py +0 -0
  32. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/EMD.py +0 -0
  33. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/EWT.py +0 -0
  34. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Error/__init__.py +0 -0
  35. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/FMD.py +0 -0
  36. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/ICEEMDAN.py +0 -0
  37. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/LMD.py +0 -0
  38. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/MEMD.py +0 -0
  39. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Operator/Daubechies_polynomial.py +0 -0
  40. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Operator/Empirical_wavelet.py +0 -0
  41. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Operator/__init__.py +0 -0
  42. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/RPSEMD.py +0 -0
  43. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/SSA.py +0 -0
  44. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/SVMD.py +0 -0
  45. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Check.py +0 -0
  46. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Envelope.py +0 -0
  47. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Hilbert.py +0 -0
  48. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Mirror.py +0 -0
  49. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Monotonicity.py +0 -0
  50. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Peaks.py +0 -0
  51. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Poly.py +0 -0
  52. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/Slepian.py +0 -0
  53. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.c +0 -0
  54. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.c +0 -0
  55. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/__init__.py +0 -0
  56. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_fft.py +0 -0
  57. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_fht.py +0 -0
  58. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_fht_native.pyx +0 -0
  59. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_fir.py +0 -0
  60. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_forth_order_wave.py +0 -0
  61. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_kramers_kronig.py +0 -0
  62. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_scipy_backend.py +0 -0
  63. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Hilbert/_wave.py +0 -0
  64. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Slepian/C.py +0 -0
  65. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Slepian/_C/slepian_core.c +0 -0
  66. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Slepian/__init__.py +0 -0
  67. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/_Slepian/numpy_slepian.py +0 -0
  68. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/Utils/__init__.py +0 -0
  69. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition/VMD.py +0 -0
  70. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition.egg-info/dependency_links.txt +0 -0
  71. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition.egg-info/requires.txt +0 -0
  72. {modal_decomposition-0.5.0 → modal_decomposition-0.5.1}/src/Modal_Decomposition.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Modal-Decomposition
3
- Version: 0.5.0
3
+ Version: 0.5.1
4
4
  Summary: a package for modal decomposition
5
5
  Author-email: Mao_HaoChuan <2215269365@qq.com>
6
6
  License: Apache-2.0
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "Modal-Decomposition"
7
- version = "0.5.0"
7
+ version = "0.5.1"
8
8
  requires-python = ">=3.10"
9
9
 
10
10
  authors = [
@@ -40,5 +40,5 @@ repository = "https://github.com/a-raining-day/Modal-Decomposition.git"
40
40
  package-dir = {"" = "src"}
41
41
 
42
42
  [tool.cibuildwheel]
43
- build = "cp310-* cp311-* cp312-* cp313-*"
43
+ build = "cp310-* cp311-* cp312-* cp313-* cp314"
44
44
  skip = "*-musllinux*"
@@ -55,8 +55,11 @@ class CEEFDConfig(Config):
55
55
  分解器
56
56
  """
57
57
  class CEEFD(Decomposer):
58
+
58
59
  name: ClassVar[str] = "CEEFD"
59
60
 
61
+ # __slots__ = ("fs", "min_peak_distance", "envelop_iter", "dtype", "safe", "copy", "imfs", "res")
62
+
60
63
  def __init__(
61
64
  self,
62
65
  fs: int | float = 1.0,
@@ -125,6 +125,8 @@ class Decomposer(ABC):
125
125
 
126
126
  name: ClassVar[str]
127
127
 
128
+ __slots__ = () # avoid __dict__
129
+
128
130
  @abstractmethod
129
131
  def decompose(self, S) -> DecompositionResult:
130
132
  """
@@ -37,7 +37,7 @@ DEFAULT_ALLOCABLE_CPU_RATIO = 2.0 / 3.0
37
37
  definition: big array
38
38
  """
39
39
  #: 大数组分界 (字节)
40
- BIG_ARRAY = 300 * SIZE["1MB"] # 314572800 bytes
40
+ BIG_ARRAY = 100 * SIZE["1MB"] # 314572800 bytes
41
41
 
42
42
  """
43
43
  definition: Python Version
@@ -146,4 +146,4 @@ SLEPIAN_CACHE_MAX_BYTES = 256 * SIZE["1MB"]
146
146
  """
147
147
  definition: default type of numpy type
148
148
  """
149
- DEFAULT_NUMPY_TYPE = np.float64
149
+ DEFAULT_NUMPY_TYPE = np.float64
@@ -15,8 +15,6 @@ Public interface
15
15
  Every method returns a ``DecompositionResult`` with ``.IMFs``, ``.Res``,
16
16
  ``.info`` and ``.config``. ``Res`` is None for methods without a residual
17
17
  concept (SSA, VMD).
18
-
19
- ``EWT`` 是本库自研实现(不依赖 ewtpy)。
20
18
  """
21
19
 
22
20
  from .Base import *
@@ -42,6 +40,9 @@ from .VMD import VMD, f_VMD, VMDConfig
42
40
  from .EWT import EWT, f_EWT, EWTConfig
43
41
  from .SVMD import SVMD, f_SVMD, SVMDConfig
44
42
 
43
+ import warnings
44
+ import numpy as np
45
+
45
46
  __all__ = [
46
47
  "Class",
47
48
  "Function",
@@ -55,7 +56,7 @@ __all__ = [
55
56
  "__description__",
56
57
  ]
57
58
 
58
- __version__ = "0.4.0"
59
+ __version__ = "0.5.1"
59
60
  __author__ = "a-raining-day(Mao)"
60
61
  __email__ = "2215269365@qq.com"
61
62
  __license__ = "Apache 2.0"
@@ -81,11 +82,33 @@ def set_seed(seed: int, lock: bool = False, verbose: bool = True) -> int:
81
82
  np.random.seed(int(seed))
82
83
  return Seed.set(seed, lock=lock, verbose=verbose)
83
84
 
84
-
85
85
  def get_seed() -> int:
86
86
  """读取当前进程级全局随机种子。"""
87
87
  return Seed.get()
88
88
 
89
+ def set_allocable_cpu_ratio(cpu_ratio: float) -> None:
90
+ """设置并行时可用 cpu 数量, 默认为 2/3"""
91
+ if isinstance(cpu_ratio, float):
92
+ if 0 < cpu_ratio <= 1:
93
+ if cpu_ratio == 1:
94
+ warnings.warn("the `cpu ratio` is 1! means all cpu will be used!")
95
+ else:
96
+ pass
97
+ else:
98
+ raise ValueError("the `cpu ratio` must be between 0 and 1!")
99
+ else:
100
+ raise ValueError("the `cpu ratio` must be float!")
101
+
102
+ global DEFAULT_ALLOCABLE_CPU_RATIO
103
+ DEFAULT_ALLOCABLE_CPU_RATIO = cpu_ratio
104
+
105
+ def set_numpy_default_type(dtype: float | np.floating) -> None:
106
+ if not isinstance(dtype, float) and not isinstance(dtype, np.floating):
107
+ raise ValueError("the `dtype` must be float or np.floating!")
108
+
109
+ global DEFAULT_NUMPY_TYPE
110
+ DEFAULT_NUMPY_TYPE = dtype
111
+
89
112
  class Class:
90
113
  EMD = EMD
91
114
  EEMD = EEMD
@@ -118,4 +141,6 @@ class Function:
118
141
  LMD = f_LMD
119
142
  VMD = f_VMD
120
143
  EWT = f_EWT
121
- SVMD = f_SVMD
144
+ SVMD = f_SVMD
145
+
146
+
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Modal-Decomposition
3
- Version: 0.5.0
3
+ Version: 0.5.1
4
4
  Summary: a package for modal decomposition
5
5
  Author-email: Mao_HaoChuan <2215269365@qq.com>
6
6
  License: Apache-2.0
@@ -1,5 +1,4 @@
1
1
  LICENSE
2
- MANIFEST.in
3
2
  README.md
4
3
  pyproject.toml
5
4
  setup.py
@@ -63,12 +62,8 @@ src/Modal_Decomposition/Utils/_Hilbert/_kramers_kronig.py
63
62
  src/Modal_Decomposition/Utils/_Hilbert/_scipy_backend.py
64
63
  src/Modal_Decomposition/Utils/_Hilbert/_wave.py
65
64
  src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.c
66
- src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/am_sysdep.h
67
- src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/math_const.h
68
65
  src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.c
69
- src/Modal_Decomposition/Utils/_Hilbert/_C/_fht/transforms.h
70
66
  src/Modal_Decomposition/Utils/_Slepian/C.py
71
67
  src/Modal_Decomposition/Utils/_Slepian/__init__.py
72
68
  src/Modal_Decomposition/Utils/_Slepian/numpy_slepian.py
73
- src/Modal_Decomposition/Utils/_Slepian/_C/slepian_core.c
74
- src/Modal_Decomposition/Utils/_Slepian/_C/slepian_dpss.h
69
+ src/Modal_Decomposition/Utils/_Slepian/_C/slepian_core.c
@@ -1,21 +0,0 @@
1
- # Files to include in the source distribution (sdist) so that
2
- # `pip install <sdist>` can compile the _fht_native extension on the fly.
3
- # NOTE: keep this file pure ASCII - setuptools reads it with the locale
4
- # encoding on some platforms (e.g. GBK on Windows).
5
- include LICENSE
6
- include README.md
7
- recursive-include src/Modal_Decomposition/Utils/_Hilbert/_C *
8
- include src/Modal_Decomposition/Utils/_Hilbert/_fht_native.pyx
9
- recursive-include src/Modal_Decomposition/Utils/_Slepian/_C *.c *.h
10
-
11
- # ??????????: ??/??/??/??/???????? sdist
12
- prune tests
13
- prune docs
14
- prune table
15
- prune fig
16
- prune explore
17
- prune ref
18
- prune .scratch
19
- prune .github
20
- prune .vscode
21
- global-exclude *.py[cod] __pycache__ *.ipynb
@@ -1,54 +0,0 @@
1
- /***********************************************************
2
- * Smithsonian Astrophysical Observatory
3
- * Submillimeter Receiver Laboratory
4
- * am
5
- *
6
- * am_sysdep.h S. Paine rev. 2018 August 23
7
- *
8
- * Constants and declarations for am_sysdep.c
9
- ************************************************************/
10
-
11
- /***********************************************************
12
- * Third-party notice: this file originates from the Smithsonian
13
- * Astrophysical Observatory (SAO), Submillimeter Receiver
14
- * Laboratory, "am" project (S. Paine), and was acquired via
15
- * https://github.com/waddafunk/Smithsonians_Discrete_Hilbert_Fourier_Hartley_Transforms
16
- * Free to use, with attribution and credit to the Smithsonian
17
- * Astrophysical Observatory (see the full license notice in the
18
- * project README "Acknowledgement" section).
19
- ************************************************************/
20
-
21
- #ifndef AM_AM_SYSDEP_H
22
- #define AM_AM_SYSDEP_H
23
-
24
- /*
25
- * For optimum performance, the default processor data cache size
26
- * settings here can be overridden by target-specific definitions
27
- * supplied at compile time.
28
- *
29
- * Line-by-line and CIA computations are blocked to fit in L1
30
- * cache. If the cache size is set to 0, cache blocking is
31
- * turned off.
32
- *
33
- * For FFTs and FHTs, the L1 cache size setting controls the
34
- * point at which the computation switches over from recursive
35
- * to iterative.
36
- *
37
- * The L2 cache size is used for sizing internal benchmarks.
38
- */
39
- #ifndef L1_CACHE_BYTES
40
- #define L1_CACHE_BYTES 0x8000
41
- #endif
42
-
43
- #ifndef L1_CACHE_WAYS
44
- #define L1_CACHE_WAYS 8
45
- #endif
46
-
47
- #ifndef L2_CACHE_BYTES
48
- #define L2_CACHE_BYTES 0x100000
49
- #endif
50
-
51
- void am_sleep(unsigned int);
52
- double am_timer(double);
53
-
54
- #endif /* AM_AM_SYSDEP_H */
@@ -1,35 +0,0 @@
1
- /***********************************************************
2
- * Smithsonian Astromathical Observatory
3
- * Submillimeter Receiver Laboratory
4
- * am
5
- *
6
- * math_const.h S. Paine rev. 2017 January 30
7
- *
8
- * Mathematical constants
9
- ************************************************************/
10
-
11
- /***********************************************************
12
- * Third-party notice: this file originates from the Smithsonian
13
- * Astrophysical Observatory (SAO), Submillimeter Receiver
14
- * Laboratory, "am" project (S. Paine), and was acquired via
15
- * https://github.com/waddafunk/Smithsonians_Discrete_Hilbert_Fourier_Hartley_Transforms
16
- * Free to use, with attribution and credit to the Smithsonian
17
- * Astrophysical Observatory (see the full license notice in the
18
- * project README "Acknowledgement" section).
19
- ************************************************************/
20
-
21
- #ifndef AM_MATH_CONST_H
22
- #define AM_MATH_CONST_H
23
-
24
- #define PI 3.141592653589793
25
- #define TWOPI 6.283185307179586
26
- #define ONE_ON_PI 0.3183098861837907
27
- #define TWO_ON_PI 0.6366197723675814
28
- #define FOUR_ON_PI 1.273239544735163
29
- #define PI_ON_TWO 1.570796326794897
30
- #define SQRT_PI 1.772453850905516
31
- #define ONE_ON_SQRT_PI 0.5641895835477563
32
- #define LOG_10 2.302585092994046
33
-
34
- #endif /* AM_MATH_CONST_H */
35
-
@@ -1,38 +0,0 @@
1
- /***********************************************************
2
- * Smithsonian Astrophysical Observatory
3
- * Submillimeter Receiver Laboratory
4
- * am
5
- *
6
- * transform.h S. Paine rev. 2014 August 26
7
- *
8
- * Declarations for transform.c
9
- ************************************************************/
10
-
11
- /***********************************************************
12
- * Third-party notice: these transform routines originate from
13
- * the Smithsonian Astrophysical Observatory (SAO), Submillimeter
14
- * Receiver Laboratory, "am" project (S. Paine), and were
15
- * acquired via
16
- * https://github.com/waddafunk/Smithsonians_Discrete_Hilbert_Fourier_Hartley_Transforms
17
- * Free to use, with attribution and credit to the Smithsonian
18
- * Astrophysical Observatory (see the full license notice in the
19
- * project README "Acknowledgement" section).
20
- * Hilbert-transform phase convention: +90 deg, NOT the -90 deg
21
- * of MATLAB/SciPy. To get the MATLAB-compatible result multiply
22
- * the orthogonal component by exp(j*PI) = -1, i.e. multiply the
23
- * imaginary part by -1 for a real input (matlab_phase=True).
24
- ************************************************************/
25
-
26
- #ifndef AM_TRANSFORM_H
27
- #define AM_TRANSFORM_H
28
-
29
- void fft_dif(double*, unsigned long);
30
- void ifft_dit(double*, unsigned long);
31
- void fht_dif(double*, unsigned long);
32
- void fht_dit(double*, unsigned long);
33
- void hilbert(double*, unsigned long);
34
- void bitrev_permute(double*, unsigned long);
35
- void bitrev_permute_real(double*, unsigned long);
36
- void ft_benchmarks(void);
37
-
38
- #endif /* AM_TRANSFORM_H */
@@ -1,67 +0,0 @@
1
- /*
2
- * Slepian (DPSS) generation — C core, public API.
3
- *
4
- * 设计要点 (与 Python 端 ctypes 封装配合):
5
- * - 不分配内存: 输出写进调用方预分配的 `out` (k*n 行主序 double), 工作区由调用方
6
- * 按 md_slepian_worklen() 预分配后传入 `work`;
7
- * - 无全局状态: 纯函数, 可重入;
8
- * - 算法: 三对角矩阵特征问题 + 中心对称性折半 + 二分(Sturm)定位特征值 +
9
- * 反迭代求特征向量; 复杂度 O(k*n) 量级, 内存 O(n) (不含调用方输出缓冲);
10
- * - 集中比 (return_ratios) 用 FFT 自相关法, 与 scipy/Percival-Walden 同式。
11
- *
12
- * Python version: 3.10
13
- *
14
- * Lib and Version:
15
- * (无第三方依赖; 仅 C99 标准库)
16
- *
17
- * Only accessed by: Utils/_Slepian/C.py (ctypes)
18
- *
19
- * Modify:
20
- * 2026.9.15
21
- */
22
-
23
- #ifndef MD_SLEPIAN_DPSS_H
24
- #define MD_SLEPIAN_DPSS_H
25
-
26
- #ifdef _WIN32
27
- # define MD_SLEPIAN_API __declspec(dllexport)
28
- #else
29
- # define MD_SLEPIAN_API __attribute__((visibility("default")))
30
- #endif
31
-
32
- #ifdef __cplusplus
33
- extern "C" {
34
- #endif
35
-
36
- /* 版本字符串 (供 Python 端校验装载的确实是本库)。 */
37
- MD_SLEPIAN_API const char *md_slepian_version(void);
38
-
39
- /*
40
- * 生成前 k 阶 DPSS。
41
- *
42
- * n : 序列长度 (>= 1)
43
- * nw : 时间-带宽积 NW (> 0)
44
- * k : 需要返回的阶数 (1 .. solve_n)
45
- * sym : 1 = 长度 n 的对称序列; 0 = 周期性 (DFT-even: 内部按 n+1 求解,
46
- * 调用方取每行前 n 个样本即得结果, 本函数不做就地截断)
47
- * out : 输出缓冲, 长度 k*solve_n (solve_n = sym ? n : n+1), 行主序
48
- * (行 = 阶数, 集中比降序), 由调用方分配
49
- * ratios : 集中比输出 (长度 k), 可为 NULL 表示不需要
50
- * norm : 0 = 单位能量 (L2); 1 = 峰值 1 并按 M^2/(M^2+NW) 修正 (scipy "approximate")
51
- * work : 工作区, 长度 >= md_slepian_worklen(n, k, sym, ratios != NULL)
52
- * worklen: work 的元素个数
53
- *
54
- * 返回 0 成功; 负数表示参数错误 (见 .c 中的错误码)。
55
- */
56
- MD_SLEPIAN_API int md_slepian_dpss(int n, double nw, int k, int sym,
57
- double *out, double *ratios, int norm,
58
- double *work, long worklen);
59
-
60
- /* 所需工作区元素个数 (double 计)。 */
61
- MD_SLEPIAN_API long md_slepian_worklen(int n, int k, int sym, int want_ratios);
62
-
63
- #ifdef __cplusplus
64
- }
65
- #endif
66
-
67
- #endif /* MD_SLEPIAN_DPSS_H */