acoular 24.3__py3-none-any.whl → 24.5__py3-none-any.whl

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 (139) hide show
  1. acoular/__init__.py +118 -50
  2. acoular/calib.py +29 -38
  3. acoular/configuration.py +116 -73
  4. acoular/demo/__init__.py +10 -4
  5. acoular/demo/acoular_demo.py +78 -53
  6. acoular/environments.py +265 -262
  7. acoular/fastFuncs.py +361 -191
  8. acoular/fbeamform.py +1460 -1404
  9. acoular/grids.py +501 -545
  10. acoular/h5cache.py +50 -59
  11. acoular/h5files.py +154 -137
  12. acoular/internal.py +10 -11
  13. acoular/microphones.py +57 -53
  14. acoular/sdinput.py +47 -52
  15. acoular/signals.py +167 -179
  16. acoular/sources.py +818 -693
  17. acoular/spectra.py +349 -359
  18. acoular/tbeamform.py +414 -413
  19. acoular/tfastfuncs.py +178 -101
  20. acoular/tools/__init__.py +25 -0
  21. acoular/tools/aiaa.py +186 -0
  22. acoular/tools/helpers.py +189 -0
  23. acoular/tools/metrics.py +165 -0
  24. acoular/tprocess.py +1201 -1143
  25. acoular/traitsviews.py +513 -501
  26. acoular/trajectory.py +50 -52
  27. acoular/version.py +5 -6
  28. acoular/xml/minidsp_uma-16.xml +20 -0
  29. acoular/xml/{minidsp_uma16.xml → minidsp_uma-16_mirrored.xml} +3 -0
  30. {acoular-24.3.dist-info → acoular-24.5.dist-info}/METADATA +45 -46
  31. acoular-24.5.dist-info/RECORD +50 -0
  32. {acoular-24.3.dist-info → acoular-24.5.dist-info}/WHEEL +1 -1
  33. acoular-24.5.dist-info/licenses/LICENSE +28 -0
  34. acoular/fileimport.py +0 -380
  35. acoular/nidaqimport.py +0 -273
  36. acoular/tests/reference_data/BeamformerBase.npy +0 -0
  37. acoular/tests/reference_data/BeamformerBaseFalse1.npy +0 -0
  38. acoular/tests/reference_data/BeamformerBaseFalse2.npy +0 -0
  39. acoular/tests/reference_data/BeamformerBaseFalse3.npy +0 -0
  40. acoular/tests/reference_data/BeamformerBaseFalse4.npy +0 -0
  41. acoular/tests/reference_data/BeamformerBaseTrue1.npy +0 -0
  42. acoular/tests/reference_data/BeamformerBaseTrue2.npy +0 -0
  43. acoular/tests/reference_data/BeamformerBaseTrue3.npy +0 -0
  44. acoular/tests/reference_data/BeamformerBaseTrue4.npy +0 -0
  45. acoular/tests/reference_data/BeamformerCMFLassoLarsBIC.npy +0 -0
  46. acoular/tests/reference_data/BeamformerCMFNNLS.npy +0 -0
  47. acoular/tests/reference_data/BeamformerCapon.npy +0 -0
  48. acoular/tests/reference_data/BeamformerClean.npy +0 -0
  49. acoular/tests/reference_data/BeamformerCleansc.npy +0 -0
  50. acoular/tests/reference_data/BeamformerCleant.npy +0 -0
  51. acoular/tests/reference_data/BeamformerCleantSq.npy +0 -0
  52. acoular/tests/reference_data/BeamformerCleantSqTraj.npy +0 -0
  53. acoular/tests/reference_data/BeamformerCleantTraj.npy +0 -0
  54. acoular/tests/reference_data/BeamformerDamas.npy +0 -0
  55. acoular/tests/reference_data/BeamformerDamasPlus.npy +0 -0
  56. acoular/tests/reference_data/BeamformerEig.npy +0 -0
  57. acoular/tests/reference_data/BeamformerEigFalse1.npy +0 -0
  58. acoular/tests/reference_data/BeamformerEigFalse2.npy +0 -0
  59. acoular/tests/reference_data/BeamformerEigFalse3.npy +0 -0
  60. acoular/tests/reference_data/BeamformerEigFalse4.npy +0 -0
  61. acoular/tests/reference_data/BeamformerEigTrue1.npy +0 -0
  62. acoular/tests/reference_data/BeamformerEigTrue2.npy +0 -0
  63. acoular/tests/reference_data/BeamformerEigTrue3.npy +0 -0
  64. acoular/tests/reference_data/BeamformerEigTrue4.npy +0 -0
  65. acoular/tests/reference_data/BeamformerFunctional.npy +0 -0
  66. acoular/tests/reference_data/BeamformerGIB.npy +0 -0
  67. acoular/tests/reference_data/BeamformerGridlessOrth.npy +0 -0
  68. acoular/tests/reference_data/BeamformerMusic.npy +0 -0
  69. acoular/tests/reference_data/BeamformerOrth.npy +0 -0
  70. acoular/tests/reference_data/BeamformerSODIX.npy +0 -0
  71. acoular/tests/reference_data/BeamformerTime.npy +0 -0
  72. acoular/tests/reference_data/BeamformerTimeSq.npy +0 -0
  73. acoular/tests/reference_data/BeamformerTimeSqTraj.npy +0 -0
  74. acoular/tests/reference_data/BeamformerTimeTraj.npy +0 -0
  75. acoular/tests/reference_data/Environment.npy +0 -0
  76. acoular/tests/reference_data/Example1_numerical_values_testsum.h5 +0 -0
  77. acoular/tests/reference_data/FiltFiltOctave__.npy +0 -0
  78. acoular/tests/reference_data/FiltFiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
  79. acoular/tests/reference_data/FiltFreqWeight_weight_A_.npy +0 -0
  80. acoular/tests/reference_data/FiltFreqWeight_weight_C_.npy +0 -0
  81. acoular/tests/reference_data/FiltFreqWeight_weight_Z_.npy +0 -0
  82. acoular/tests/reference_data/FiltOctave__.npy +0 -0
  83. acoular/tests/reference_data/FiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
  84. acoular/tests/reference_data/Filter__.npy +0 -0
  85. acoular/tests/reference_data/GeneralFlowEnvironment.npy +0 -0
  86. acoular/tests/reference_data/OctaveFilterBank__.npy +0 -0
  87. acoular/tests/reference_data/OpenJet.npy +0 -0
  88. acoular/tests/reference_data/PointSource.npy +0 -0
  89. acoular/tests/reference_data/PowerSpectra_csm.npy +0 -0
  90. acoular/tests/reference_data/PowerSpectra_ev.npy +0 -0
  91. acoular/tests/reference_data/RotatingFlow.npy +0 -0
  92. acoular/tests/reference_data/SlotJet.npy +0 -0
  93. acoular/tests/reference_data/TimeAverage__.npy +0 -0
  94. acoular/tests/reference_data/TimeCumAverage__.npy +0 -0
  95. acoular/tests/reference_data/TimeExpAverage_weight_F_.npy +0 -0
  96. acoular/tests/reference_data/TimeExpAverage_weight_I_.npy +0 -0
  97. acoular/tests/reference_data/TimeExpAverage_weight_S_.npy +0 -0
  98. acoular/tests/reference_data/TimeInOut__.npy +0 -0
  99. acoular/tests/reference_data/TimePower__.npy +0 -0
  100. acoular/tests/reference_data/TimeReverse__.npy +0 -0
  101. acoular/tests/reference_data/UniformFlowEnvironment.npy +0 -0
  102. acoular/tests/reference_data/beamformer_traj_time_data.h5 +0 -0
  103. acoular/tests/run_tests.sh +0 -18
  104. acoular/tests/run_tests_osx.sh +0 -16
  105. acoular/tests/test.npy +0 -0
  106. acoular/tests/test_beamformer_results.py +0 -213
  107. acoular/tests/test_classes.py +0 -60
  108. acoular/tests/test_digest.py +0 -125
  109. acoular/tests/test_environments.py +0 -73
  110. acoular/tests/test_example1.py +0 -124
  111. acoular/tests/test_grid.py +0 -92
  112. acoular/tests/test_integrate.py +0 -102
  113. acoular/tests/test_signals.py +0 -60
  114. acoular/tests/test_sources.py +0 -65
  115. acoular/tests/test_spectra.py +0 -38
  116. acoular/tests/test_timecache.py +0 -35
  117. acoular/tests/test_tprocess.py +0 -90
  118. acoular/tests/test_traj_beamformer_results.py +0 -164
  119. acoular/tests/unsupported/SpeedComparison/OvernightTestcasesBeamformer_nMics32_nGridPoints100_nFreqs4_nTrials10.png +0 -0
  120. acoular/tests/unsupported/SpeedComparison/cythonBeamformer.pyx +0 -237
  121. acoular/tests/unsupported/SpeedComparison/mainForCython.py +0 -103
  122. acoular/tests/unsupported/SpeedComparison/mainForParallelJit.py +0 -143
  123. acoular/tests/unsupported/SpeedComparison/setupCythonOpenMP.py +0 -63
  124. acoular/tests/unsupported/SpeedComparison/sharedFunctions.py +0 -153
  125. acoular/tests/unsupported/SpeedComparison/timeOverNMics_AllImportantMethods.png +0 -0
  126. acoular/tests/unsupported/SpeedComparison/timeOverNMics_faverage.png +0 -0
  127. acoular/tests/unsupported/SpeedComparison/vglOptimierungFAverage.py +0 -204
  128. acoular/tests/unsupported/SpeedComparison/vglOptimierungGaussSeidel.py +0 -182
  129. acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAMFULL_INVERSE.py +0 -764
  130. acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAM_OS.py +0 -231
  131. acoular/tests/unsupported/SpeedComparison/whatsFastestWayFor_absASquared.py +0 -48
  132. acoular/tests/unsupported/functionalBeamformer.py +0 -123
  133. acoular/tests/unsupported/precisionTest.py +0 -153
  134. acoular/tests/unsupported/validationOfBeamformerFuncsPOSTAcoularIntegration.py +0 -254
  135. acoular/tests/unsupported/validationOfBeamformerFuncsPREeAcoularIntegration.py +0 -531
  136. acoular/tools.py +0 -422
  137. acoular-24.3.dist-info/RECORD +0 -148
  138. acoular-24.3.dist-info/licenses/LICENSE +0 -29
  139. {acoular-24.3.dist-info → acoular-24.5.dist-info}/licenses/AUTHORS.rst +0 -0
acoular/trajectory.py CHANGED
@@ -1,8 +1,6 @@
1
- # -*- coding: utf-8 -*-
2
- #pylint: disable-msg=E0611, E1101, C0103, R0901, R0902, R0903, R0904, W0232
3
- #------------------------------------------------------------------------------
1
+ # ------------------------------------------------------------------------------
4
2
  # Copyright (c) Acoular Development Team.
5
- #------------------------------------------------------------------------------
3
+ # ------------------------------------------------------------------------------
6
4
  """Implements the definition of trajectories.
7
5
 
8
6
  .. autosummary::
@@ -12,106 +10,108 @@
12
10
  """
13
11
 
14
12
  # imports from other packages
15
- from numpy import array, arange, sort, r_
16
- from scipy.interpolate import splprep, splev
17
- from traits.api import HasPrivateTraits, Float, \
18
- Property, cached_property, property_depends_on, Dict, Tuple
13
+ from numpy import arange, array, r_, sort
14
+ from scipy.interpolate import splev, splprep
15
+ from traits.api import Dict, Float, HasPrivateTraits, Property, Tuple, cached_property, property_depends_on
19
16
 
20
17
  # acoular imports
21
18
  from .internal import digest
22
19
 
23
20
 
24
- class Trajectory( HasPrivateTraits ):
25
- """
26
- Describes a trajectory from sampled points.
27
-
28
- Based on a discrete number of points in space and time, a
29
- continuous trajectory is calculated using spline interpolation
21
+ class Trajectory(HasPrivateTraits):
22
+ """Describes a trajectory from sampled points.
23
+
24
+ Based on a discrete number of points in space and time, a
25
+ continuous trajectory is calculated using spline interpolation
30
26
  of positions between samples.
31
27
  """
32
- #: Dictionary that assigns discrete time instants (keys) to
28
+
29
+ #: Dictionary that assigns discrete time instants (keys) to
33
30
  #: sampled `(x, y, z)` positions along the trajectory (values).
34
- points = Dict(key_trait = Float, value_trait = Tuple(Float, Float, Float),
35
- desc = "sampled positions along the trajectory")
36
-
37
- #: Tuple of the start and end time, is set automatically
31
+ points = Dict(
32
+ key_trait=Float,
33
+ value_trait=Tuple(Float, Float, Float),
34
+ desc='sampled positions along the trajectory',
35
+ )
36
+
37
+ #: Tuple of the start and end time, is set automatically
38
38
  #: (depending on :attr:`points`).
39
39
  interval = Property()
40
- #t_min, t_max tuple
41
-
40
+ # t_min, t_max tuple
41
+
42
42
  #: Spline data, internal use.
43
43
  tck = Property()
44
-
44
+
45
45
  # internal identifier
46
- digest = Property(
47
- depends_on = ['points[]'],
48
- )
46
+ digest = Property(
47
+ depends_on=['points[]'],
48
+ )
49
49
 
50
50
  @cached_property
51
- def _get_digest( self ):
51
+ def _get_digest(self):
52
52
  return digest(self)
53
-
53
+
54
54
  @property_depends_on('points[]')
55
- def _get_interval( self ):
55
+ def _get_interval(self):
56
56
  return sort(list(self.points.keys()))[r_[0, -1]]
57
57
 
58
58
  @property_depends_on('points[]')
59
- def _get_tck( self ):
59
+ def _get_tck(self):
60
60
  t = sort(list(self.points.keys()))
61
61
  xp = array([self.points[i] for i in t]).T
62
- k = min(3, len(self.points)-1)
62
+ k = min(3, len(self.points) - 1)
63
63
  tcku = splprep(xp, u=t, s=0, k=k)
64
64
  return tcku[0]
65
-
65
+
66
66
  def location(self, t, der=0):
67
- """
68
- Returns the positions for one or more instants in time.
69
-
67
+ """Returns the positions for one or more instants in time.
68
+
70
69
  Parameters
71
70
  ----------
72
71
  t : array of floats
73
72
  Instances in time to calculate the positions at.
74
73
  der : integer
75
74
  The order of derivative of the spline to compute, defaults to 0.
76
-
75
+
77
76
  Returns
78
77
  -------
79
78
  (x, y, z) : tuple with arrays of floats
80
79
  Positions at the given times; `x`, `y` and `z` have the same shape as `t`.
80
+
81
81
  """
82
82
  return splev(t, self.tck, der)
83
-
83
+
84
84
  def traj(self, t_start, t_end=None, delta_t=None, der=0):
85
- """
86
- Python generator that yields locations along the trajectory.
87
-
85
+ """Python generator that yields locations along the trajectory.
86
+
88
87
  Parameters
89
88
  ----------
90
89
  t_start : float
91
- Starting time of the trajectory, defaults to the earliest
90
+ Starting time of the trajectory, defaults to the earliest
92
91
  time in :attr:`points`.
93
92
  t_end : float
94
- Ending time of the trajectory, defaults to the latest
93
+ Ending time of the trajectory, defaults to the latest
95
94
  time in :attr:`points`.
96
95
  delta_t : float
97
- Time interval between yielded trajectory points, defaults to earliest
96
+ Time interval between yielded trajectory points, defaults to earliest
98
97
  time in :attr:`points`.
99
-
98
+
100
99
  Returns
101
100
  -------
102
101
  (x, y, z) : tuples of floats
103
102
  Positions at the desired times are yielded.
104
-
103
+
105
104
  Examples
106
105
  --------
107
- x.traj(0.1)
108
- Yields the position every 0.1 s within the
106
+ x.traj(0.1)
107
+ Yields the position every 0.1 s within the
109
108
  given :attr:`interval`.
110
- x.traj(2.5, 4.5, 0.1)
109
+ x.traj(2.5, 4.5, 0.1)
111
110
  Yields the position every 0.1 s between 2.5 s and 4.5 s.
112
- x.traj(0.1, der=1)
113
- Yields the 1st derivative of the spline (= velocity vector) every 0.1 s
111
+ x.traj(0.1, der=1)
112
+ Yields the 1st derivative of the spline (= velocity vector) every 0.1 s
114
113
  within the given :attr:`interval`.
114
+
115
115
  """
116
116
  if not delta_t:
117
117
  delta_t = t_start
@@ -121,6 +121,4 @@ class Trajectory( HasPrivateTraits ):
121
121
  # all locations are fetched in one go because thats much faster
122
122
  # further improvement could be possible if interpolated locations are fetched
123
123
  # in blocks
124
- for l in zip(*self.location(arange(t_start, t_end, delta_t),der)):
125
- yield l
126
-
124
+ yield from zip(*self.location(arange(t_start, t_end, delta_t), der))
acoular/version.py CHANGED
@@ -1,9 +1,8 @@
1
- # coding=UTF-8
2
- #------------------------------------------------------------------------------
1
+ # ------------------------------------------------------------------------------
3
2
  # Copyright (c) Acoular Development Team.
4
- #------------------------------------------------------------------------------
3
+ # ------------------------------------------------------------------------------
5
4
 
6
5
  # separate file to find out about version without importing the acoular lib
7
- __author__ = "Acoular Development Team"
8
- __date__ = "11 March 2024"
9
- __version__ = "24.03"
6
+ __author__ = 'Acoular Development Team'
7
+ __date__ = '21 May 2024'
8
+ __version__ = '24.05'
@@ -0,0 +1,20 @@
1
+ <?xml version="1.1" encoding="utf-8"?><MicArray name="minidsp_uma16">
2
+ <!-- Contains the sensor positions for the UMA-16 MEMS microphone array from miniDSP. -->
3
+ <!-- Sensor positions were corrected in x-direction after Acoular version 24.03 due to GitHub Issue #63 -->
4
+ <pos Name="Point 1" x="0.021" y="-0.063" z="0.0"/>
5
+ <pos Name="Point 2" x="0.063" y="-0.063" z="0.0"/>
6
+ <pos Name="Point 3" x="0.021" y="-0.021" z="0.0"/>
7
+ <pos Name="Point 4" x="0.063" y="-0.021" z="0.0"/>
8
+ <pos Name="Point 5" x="0.021" y="0.021" z="0.0"/>
9
+ <pos Name="Point 6" x="0.063" y="0.021" z="0.0"/>
10
+ <pos Name="Point 7" x="0.021" y="0.063" z="0.0"/>
11
+ <pos Name="Point 8" x="0.063" y="0.063" z="0.0"/>
12
+ <pos Name="Point 9" x="-0.063" y="0.063" z="0.0"/>
13
+ <pos Name="Point 10" x="-0.021" y="0.063" z="0.0"/>
14
+ <pos Name="Point 11" x="-0.063" y="0.021" z="0.0"/>
15
+ <pos Name="Point 12" x="-0.021" y="0.021" z="0.0"/>
16
+ <pos Name="Point 13" x="-0.063" y="-0.021" z="0.0"/>
17
+ <pos Name="Point 14" x="-0.021" y="-0.021" z="0.0"/>
18
+ <pos Name="Point 15" x="-0.063" y="-0.063" z="0.0"/>
19
+ <pos Name="Point 16" x="-0.021" y="-0.063" z="0.0"/>
20
+ </MicArray>
@@ -1,4 +1,7 @@
1
1
  <?xml version="1.0" encoding="utf-8"?><MicArray name="uma16">
2
+ <!-- Contains the sensor positions for the UMA-16 MEMS microphone array from miniDSP. -->
3
+ <!-- The sensor positions are mirrored along the x-axis (see: GitHub Issue #63). -->
4
+ <!-- This file was named minidsp_uma16.xml file until Acoular version 24.03. -->
2
5
  <pos Name="Point 1" x=" -0.021000000" y=" -0.063000000" z="0" />
3
6
  <pos Name="Point 2" x=" -0.063000000" y=" -0.063000000" z="0" />
4
7
  <pos Name="Point 3" x=" -0.021000000" y=" -0.021000000" z="0" />
@@ -1,41 +1,40 @@
1
- Metadata-Version: 2.1
1
+ Metadata-Version: 2.3
2
2
  Name: acoular
3
- Version: 24.3
3
+ Version: 24.5
4
4
  Summary: Python library for acoustic beamforming
5
5
  Project-URL: homepage, https://acoular.org
6
6
  Project-URL: documentation, https://acoular.org
7
7
  Project-URL: repository, https://github.com/acoular/acoular
8
8
  Author-email: Acoular Development Team <info@acoular.org>
9
9
  Maintainer-email: Adam Kujawski <adam.kujawski@tu-berlin.de>, Art Pelling <a.pelling@tu-berlin.de>, Ennes Sarradj <ennes.sarradj@tu-berlin.de>, Gert Herold <gert.herold@tu-berlin.de>, Mikolaj Czuchaj <mikolaj.czuchaj@tu-berlin.de>, Simon Jekosch <s.jekosch@tu-berlin.de>
10
- License: Copyright (c) Acoular Development Team.
11
- All rights reserved.
10
+ License: BSD 3-Clause License
12
11
 
12
+ Copyright (c) Acoular Development Team
13
13
 
14
14
  Redistribution and use in source and binary forms, with or without
15
15
  modification, are permitted provided that the following conditions are met:
16
16
 
17
- a. Redistributions of source code must retain the above copyright notice,
18
- this list of conditions and the following disclaimer.
19
- b. Redistributions in binary form must reproduce the above copyright
20
- notice, this list of conditions and the following disclaimer in the
21
- documentation and/or other materials provided with the distribution.
22
- c. Neither the name of the acoular developers nor the names of
23
- its contributors may be used to endorse or promote products
24
- derived from this software without specific prior written
25
- permission.
17
+ 1. Redistributions of source code must retain the above copyright notice, this
18
+ list of conditions and the following disclaimer.
26
19
 
20
+ 2. Redistributions in binary form must reproduce the above copyright notice,
21
+ this list of conditions and the following disclaimer in the documentation
22
+ and/or other materials provided with the distribution.
23
+
24
+ 3. Neither the name of the copyright holder nor the names of its
25
+ contributors may be used to endorse or promote products derived from
26
+ this software without specific prior written permission.
27
27
 
28
28
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
29
29
  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30
- IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31
- ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
32
- ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
31
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
32
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33
33
  DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
34
34
  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
35
- CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
36
- LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
37
- OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
38
- DAMAGE.
35
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
36
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39
38
  License-File: AUTHORS.rst
40
39
  License-File: LICENSE
41
40
  Keywords: acoustics,beamforming,microphone array
@@ -43,39 +42,31 @@ Classifier: Development Status :: 5 - Production/Stable
43
42
  Classifier: Intended Audience :: Education
44
43
  Classifier: Intended Audience :: Science/Research
45
44
  Classifier: License :: OSI Approved :: BSD License
46
- Classifier: Programming Language :: Python :: 3.7
47
45
  Classifier: Programming Language :: Python :: 3.8
48
46
  Classifier: Programming Language :: Python :: 3.9
49
47
  Classifier: Programming Language :: Python :: 3.10
50
48
  Classifier: Programming Language :: Python :: 3.11
49
+ Classifier: Programming Language :: Python :: 3.12
51
50
  Classifier: Topic :: Scientific/Engineering :: Physics
52
- Requires-Python: <=11,>=3.7
51
+ Requires-Python: <=12,>=3.8
53
52
  Requires-Dist: numba
54
53
  Requires-Dist: numpy
55
54
  Requires-Dist: scikit-learn
56
55
  Requires-Dist: scipy>=1.1.0
57
56
  Requires-Dist: tables>=3.4.4
58
57
  Requires-Dist: traits>=6.0
59
- Provides-Extra: dev
60
- Requires-Dist: graphviz; extra == 'dev'
61
- Requires-Dist: ipython; extra == 'dev'
62
- Requires-Dist: matplotlib; extra == 'dev'
63
- Requires-Dist: nox; extra == 'dev'
64
- Requires-Dist: numpydoc; extra == 'dev'
65
- Requires-Dist: pickleshare; extra == 'dev'
66
- Requires-Dist: sounddevice; extra == 'dev'
67
- Requires-Dist: sphinx; extra == 'dev'
68
58
  Provides-Extra: full
69
59
  Requires-Dist: matplotlib; extra == 'full'
70
60
  Requires-Dist: pylops; extra == 'full'
71
61
  Requires-Dist: sounddevice; extra == 'full'
72
62
  Description-Content-Type: text/markdown
73
63
 
74
- ![Acoular Logo](./docs/source/_static/Acoular_logo.png)
64
+ ![Acoular Logo](https://github.com/acoular/acoular/blob/master/docs/source/_static/Acoular_logo.png?raw=true)
75
65
 
76
66
  [![PyPI](https://img.shields.io/pypi/pyversions/acoular.svg)](https://pypi.org/project/acoular)
77
67
  [![PyPI](https://img.shields.io/pypi/v/acoular.svg)](https://pypi.org/project/acoular)
78
- [![Github](https://github.com/acoular/acoular/actions/workflows/python-package.yml/badge.svg)](https://github.com/acoular/acoular/actions/workflows/python-package.yml)
68
+ [![Actions status](https://github.com/acoular/acoular/actions/workflows/tests.yml/badge.svg)](https://github.com/acoular/acoular/actions)
69
+ [![DOI](https://zenodo.org/badge/29729101.svg)](https://zenodo.org/doi/10.5281/zenodo.3690794)
79
70
 
80
71
  # Acoular
81
72
  Acoular is a Python module for acoustic beamforming that is distributed under the new BSD license.
@@ -87,7 +78,7 @@ It is aimed at applications in acoustic testing. Multichannel data recorded by a
87
78
  - frequency domain deconvolution algorithms: DAMAS, DAMAS+, Clean, CleanSC, orthogonal deconvolution
88
79
  - frequency domain inverse methods: CMF (covariance matrix fitting), general inverse beamforming, SODIX
89
80
  - time domain methods: delay & sum beamforming, CleanT deconvolution
90
- - time domain methods applicable for moving source with arbitrary trajectory (linear, circular, arbitrarily 3D curved),
81
+ - time domain methods applicable for moving sources with arbitrary trajectory (linear, circular, arbitrarily 3D curved),
91
82
  - frequency domain methods for rotating sources via virtual array rotation for arbitrary arrays and with different interpolation techniques
92
83
  - 1D, 2D and 3D mapping grids for all methods
93
84
  - gridless option for orthogonal deconvolution
@@ -107,18 +98,25 @@ Acoular is licensed under the BSD 3-clause. See [LICENSE](LICENSE)
107
98
 
108
99
  # Citing
109
100
 
110
- If you use Acoular for academic work, please consider citing our
101
+ If you use Acoular for academic work, please consider citing both our
111
102
  [publication](https://doi.org/10.1016/j.apacoust.2016.09.015):
112
103
 
113
- Ennes Sarradj, Gert Herold,
114
- A Python framework for microphone array data processing,
115
- Applied Acoustics, Volume 116, 2017, Pages 50-58
104
+ Sarradj, E., & Herold, G. (2017).
105
+ A Python framework for microphone array data processing.
106
+ Applied Acoustics, 116, 5058.
107
+ https://doi.org/10.1016/j.apacoust.2016.09
108
+
109
+ and our [software](https://zenodo.org/doi/10.5281/zenodo.3690794):
110
+
111
+ Sarradj, E., Herold, G., Kujawski, A., Jekosch, S., Pelling, A. J. R., Czuchaj, M., Gensch, T., & Oertwig, S..
112
+ Acoular – Acoustic testing and source mapping software.
113
+ Zenodo. https://zenodo.org/doi/10.5281/zenodo.3690794
116
114
 
117
115
  # Dependencies
118
116
  Acoular runs under Linux, Windows and MacOS and needs Numpy, Scipy, Traits, scikit-learn, pytables, Numba packages available.
119
117
  Matplotlib is needed for some of the examples.
120
118
 
121
- If you want to use input from a soundcard hardware, you will also need to install the [sounddevice](https://python-sounddevice.readthedocs.io/en/0.3.12/installation.html) package. Some solvers for the CMF method need [Pylops](https://pylops.readthedocs.io/en/stable/installation.html).
119
+ If you want to use input from a soundcard, you will also need to install the [sounddevice](https://python-sounddevice.readthedocs.io/en/0.3.12/installation.html) package. Some solvers for the CMF method need [Pylops](https://pylops.readthedocs.io/en/stable/installation.html).
122
120
 
123
121
  # Installation
124
122
 
@@ -126,22 +124,22 @@ Acoular can be installed via [conda](https://docs.conda.io/en/latest/), which is
126
124
 
127
125
  conda install -c acoular acoular
128
126
 
129
- This will install Acoular in your Anaconda Python enviroment and make the Acoular library available from Python. In addition, this will install all dependencies (those other packages mentioned above) if they are not already present on your system.
127
+ This will install Acoular in your Anaconda Python environment and make the Acoular library available from Python. In addition, this will install all dependencies (those other packages mentioned above) if they are not already present on your system.
130
128
 
131
129
  A second option is to install Acoular via [pip](https://pip.pypa.io/en/stable/). It is recommended to use a dedicated [virtual environment](https://virtualenv.pypa.io/en/latest/) and then run
132
130
 
133
131
  pip install acoular
134
132
 
135
- For more detailed install instructions see the [documentation](http://acoular.org/install/index.html).
133
+ For more detailed installation instructions, see the [documentation](https://acoular.org/install/index.html).
136
134
 
137
135
  # Documentation and help
138
- Documentation is available [here](http://acoular.org) with a
139
- [getting started](http://acoular.org/get_started/index.html) section and
140
- [examples](http://acoular.org/examples/index.html).
136
+ Documentation is available [here](https://acoular.org) with a
137
+ [getting started](https://acoular.org/get_started/index.html) section and
138
+ [examples](https://acoular.org/examples/index.html).
141
139
 
142
140
  The Acoular [blog](https://acoular.github.io/blog/) contains some tutorials.
143
141
 
144
- Problems, suggestions and success using Acoular may be reported via the [acoular-users](https://groups.google.com/forum/#!forum/acoular-users) discussion forum.
142
+ If you discover problems with the Acoular software, please report them using the [issue tracker](https://github.com/acoular/acoular/issues) on GitHub. Please use the [Acoular discussions forum](https://github.com/acoular/acoular/discussions) for practical questions, discussions, and demos.
145
143
 
146
144
  # Example
147
145
  This reads data from 64 microphone channels and computes a beamforming map for the 8kHz third octave band:
@@ -178,4 +176,5 @@ interpolation='bicubic')
178
176
  colorbar()
179
177
  ```
180
178
 
181
- ![result](./docs/source/get_started/three_source_py3_colormap.png)
179
+
180
+ ![result](https://github.com/acoular/acoular/blob/master/docs/source/get_started/three_source_py3_colormap.png?raw=true)
@@ -0,0 +1,50 @@
1
+ acoular/__init__.py,sha256=pG9Kw05i74QW0diGsZPFqrl1WI52wFl-3Oe7AyUbraE,2924
2
+ acoular/calib.py,sha256=7hyas42kn33qvvO4Is2nxkyQEnL8MTo6mIq1VZ56vOQ,2509
3
+ acoular/configuration.py,sha256=jQhd_GiEEVifFGDQgmkE9JvMmmxEINjdh0vuYCVlzLU,8352
4
+ acoular/environments.py,sha256=NSnRN20TZiff83S-zAf9DbmUiwotzFcpD0zQ_OjVyk4,22271
5
+ acoular/fastFuncs.py,sha256=P_G4phW64bVVm246RnyXWVZLAMMsk9tuEYtSsAZRQyc,38794
6
+ acoular/fbeamform.py,sha256=D0gyBjTwJnAIRC1uofwJZ3Cu-6Gu0Q99fd2ZixgY97k,113833
7
+ acoular/grids.py,sha256=suUBQxRPPKiWkhPkrDFL23JoWhfHegLitGwocmWlVsw,40017
8
+ acoular/h5cache.py,sha256=OmSgThcq2KKLABfQobLodOGOKO8Gl8_KCFJOk-lBOns,4330
9
+ acoular/h5files.py,sha256=kWNB49uODczXqStY28t8HB7P_9wuiL_5VeRrqbqAsko,7593
10
+ acoular/internal.py,sha256=4mVOCaPdQRJJ_Mn0rWwPw3rSySvGgvvVtMYW3vwTgdQ,801
11
+ acoular/microphones.py,sha256=Pn4pKZtr82LRE3TkBfLyWQZnnLyppIVhoqJjhiHhdOk,5113
12
+ acoular/sdinput.py,sha256=Z-GpO98D19FNSvygqzs1QTxF3ZePAjPKCiNu32hTqqg,4124
13
+ acoular/signals.py,sha256=94hcUfazzz5FtA5mooFIffSXL7sP_rfqKew7DnQ7M60,11351
14
+ acoular/sources.py,sha256=JY4OgwFWEztdufiHlvbOAwDTOc9b8X1fRNlUvnidjiw,52776
15
+ acoular/spectra.py,sha256=JbP7BWxdZenQZOo704AYla_c6P1QM7W8waQKtQT_Hlg,28069
16
+ acoular/tbeamform.py,sha256=FGXPVkUStHUKDtIPqlc8z3IPd03STayaanpiiBJeE6I,30274
17
+ acoular/tfastfuncs.py,sha256=HjzHmuolJLM0UrJtO9tYDWiBUFI2Hqh-eT4tpDZbxqI,7883
18
+ acoular/tprocess.py,sha256=4wU6ITN8XXZCDMGJQeW58sbp3yeb-RzAtN_Sp1phews,88682
19
+ acoular/traitsviews.py,sha256=iovxrE4LS_xUlrlf0mVCirMPc0PWInmCfihvDLX116Q,13741
20
+ acoular/trajectory.py,sha256=I3Ve08IlritHcG7iOBt-jjjRY7bCGWwOjTwD4rorTi8,3964
21
+ acoular/version.py,sha256=MTRzSy_P5khWXkNcHDwbtYJE767PpzCky_MRTESoeKI,376
22
+ acoular/demo/__init__.py,sha256=ejn5L3j0M3BwsaxQNSAAFdBNU1kr0LpVFxtONtj9dP8,332
23
+ acoular/demo/acoular_demo.py,sha256=pRr0XvPQIA9LyofwoGcfuFHXrKgbgO77DvpjHclQuvw,3072
24
+ acoular/tools/__init__.py,sha256=GaM58W_aB4YIkO5xFsndYHVYuxLVzQMVdvE6ZoAtABA,573
25
+ acoular/tools/aiaa.py,sha256=fn6QP-gpWeIi8Ad_oc5WhmDthEgVjFbiwrvQ8p92CH8,6409
26
+ acoular/tools/helpers.py,sha256=XuAEZZ7GN5bFU6gFX2f2jUdwbNcDf3FcEMt5foaifVc,6292
27
+ acoular/tools/metrics.py,sha256=828WFBYl1aoiUIxrubdk1XDodsi0tJjwp6Y_3o_a0Uo,6150
28
+ acoular/xml/HW90D240_f10.xml,sha256=WvowIe8aYJaeHSExjwaY9fjpYukLxX6A-H7fD1PW2g8,5127
29
+ acoular/xml/W90_D105_f10.xml,sha256=f8NHPoOYjEnRsstYDa_4E65EBR5m5BVzlg87jpCgckA,5283
30
+ acoular/xml/acousticam_2c.xml,sha256=xcVlKQhGbRqMQHLKuTAyXTt3SM3aLZEAfGqbuFaWx4k,1993
31
+ acoular/xml/acousticam_4c.xml,sha256=P8wAP5_GT0HS40VV3f7_88xQXwTLN1YRxI7MudnwIqw,1949
32
+ acoular/xml/array38.xml,sha256=FrbC-1yVHNfWTamEJPiJhhdPtVYVfGbPXJ3TLljBKx0,2363
33
+ acoular/xml/array92x.xml,sha256=65Wf2xbA6Dt_k98C3q4MfTtwPzceT8B2vKvK77hO9Yc,5874
34
+ acoular/xml/array_56.xml,sha256=qe8CAcRP7-3MLpPn919XKHB8hMb9G5JUPFzP1qOA4IM,3428
35
+ acoular/xml/array_56_10_9.xml,sha256=2G-KZSwvAtIuxyC6JKW2Hv2IWXVFd4Sux1tLxizJ5Z4,4432
36
+ acoular/xml/array_56_bomb.xml,sha256=tAdhLzvUrhMh7DMrbXU7skAEAlCvQ6GLbJXAU7Z2JxE,4193
37
+ acoular/xml/array_56_v2.xml,sha256=x4OTI77Fttfaqu-Kl7uWmslg8rZAuw2Y-RUa21MqzXk,3458
38
+ acoular/xml/array_64.xml,sha256=1ZHuQEHhFhz9EhBcNbXkVT-9tnAr6T9cHH5Xb1gHL7Y,4039
39
+ acoular/xml/array_84_10_9.xml,sha256=jzvMYZlQqo8y6jt3yllGOL7vk8bxMVpISexkZL0uquA,6558
40
+ acoular/xml/array_84_bomb_v3.xml,sha256=Mv8nvqSOUezrdIjrCHZt4gZpJ-Z3BzF2wIYPawHZjlA,6248
41
+ acoular/xml/calib_vw_ring32.xml,sha256=9chpz0O3e__oIs4ZuJTvUJNIuawjDqEnkdRbfyUBBxU,1341
42
+ acoular/xml/gfai_ring32.xml,sha256=liKaGpfgUn8R1psDmiw6qqpZi5SwtPWBRhwhqy7YuOc,1831
43
+ acoular/xml/minidsp_uma-16.xml,sha256=oBj7J96RTDZufsQ7S4rw0jAvLOoykJaIGgl6_2gMON4,1140
44
+ acoular/xml/minidsp_uma-16_mirrored.xml,sha256=l6LUPIsEVg7HPMbs9NbnqZyFhpCSYS70glsbyH3IUOE,1418
45
+ acoular/xml/tub_vogel64.xml,sha256=PixVMx5hMJjgBOekH46uu6D3ODqYVOLlk82zkYl4EBM,4424
46
+ acoular-24.5.dist-info/METADATA,sha256=tjgaz4ZHJ3KnK54BBWFsmpHbunnLr5fx-88TyE31_cw,10258
47
+ acoular-24.5.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87
48
+ acoular-24.5.dist-info/licenses/AUTHORS.rst,sha256=445q_Us_TnQx8s_GP2yringU2DMTk3-ycrk2REtSsx0,382
49
+ acoular-24.5.dist-info/licenses/LICENSE,sha256=tbw7-nx204gXCo8p-NwwR7w8oKvNMWB4H07FTT6V9p8,1505
50
+ acoular-24.5.dist-info/RECORD,,
@@ -1,4 +1,4 @@
1
1
  Wheel-Version: 1.0
2
- Generator: hatchling 1.21.1
2
+ Generator: hatchling 1.24.2
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
@@ -0,0 +1,28 @@
1
+ BSD 3-Clause License
2
+
3
+ Copyright (c) Acoular Development Team
4
+
5
+ Redistribution and use in source and binary forms, with or without
6
+ modification, are permitted provided that the following conditions are met:
7
+
8
+ 1. Redistributions of source code must retain the above copyright notice, this
9
+ list of conditions and the following disclaimer.
10
+
11
+ 2. Redistributions in binary form must reproduce the above copyright notice,
12
+ this list of conditions and the following disclaimer in the documentation
13
+ and/or other materials provided with the distribution.
14
+
15
+ 3. Neither the name of the copyright holder nor the names of its
16
+ contributors may be used to endorse or promote products derived from
17
+ this software without specific prior written permission.
18
+
19
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22
+ DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
23
+ FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24
+ DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
25
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
26
+ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.