acoular 23.11__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 (137) 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 +1478 -1407
  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-23.11.dist-info → acoular-24.5.dist-info}/METADATA +47 -40
  31. acoular-24.5.dist-info/RECORD +50 -0
  32. {acoular-23.11.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/BeamformerCMF.npy +0 -0
  46. acoular/tests/reference_data/BeamformerCapon.npy +0 -0
  47. acoular/tests/reference_data/BeamformerClean.npy +0 -0
  48. acoular/tests/reference_data/BeamformerCleansc.npy +0 -0
  49. acoular/tests/reference_data/BeamformerCleant.npy +0 -0
  50. acoular/tests/reference_data/BeamformerCleantSq.npy +0 -0
  51. acoular/tests/reference_data/BeamformerCleantSqTraj.npy +0 -0
  52. acoular/tests/reference_data/BeamformerCleantTraj.npy +0 -0
  53. acoular/tests/reference_data/BeamformerDamas.npy +0 -0
  54. acoular/tests/reference_data/BeamformerDamasPlus.npy +0 -0
  55. acoular/tests/reference_data/BeamformerEig.npy +0 -0
  56. acoular/tests/reference_data/BeamformerEigFalse1.npy +0 -0
  57. acoular/tests/reference_data/BeamformerEigFalse2.npy +0 -0
  58. acoular/tests/reference_data/BeamformerEigFalse3.npy +0 -0
  59. acoular/tests/reference_data/BeamformerEigFalse4.npy +0 -0
  60. acoular/tests/reference_data/BeamformerEigTrue1.npy +0 -0
  61. acoular/tests/reference_data/BeamformerEigTrue2.npy +0 -0
  62. acoular/tests/reference_data/BeamformerEigTrue3.npy +0 -0
  63. acoular/tests/reference_data/BeamformerEigTrue4.npy +0 -0
  64. acoular/tests/reference_data/BeamformerFunctional.npy +0 -0
  65. acoular/tests/reference_data/BeamformerGIB.npy +0 -0
  66. acoular/tests/reference_data/BeamformerGridlessOrth.npy +0 -0
  67. acoular/tests/reference_data/BeamformerMusic.npy +0 -0
  68. acoular/tests/reference_data/BeamformerOrth.npy +0 -0
  69. acoular/tests/reference_data/BeamformerTime.npy +0 -0
  70. acoular/tests/reference_data/BeamformerTimeSq.npy +0 -0
  71. acoular/tests/reference_data/BeamformerTimeSqTraj.npy +0 -0
  72. acoular/tests/reference_data/BeamformerTimeTraj.npy +0 -0
  73. acoular/tests/reference_data/Environment.npy +0 -0
  74. acoular/tests/reference_data/Example1_numerical_values_testsum.h5 +0 -0
  75. acoular/tests/reference_data/FiltFiltOctave__.npy +0 -0
  76. acoular/tests/reference_data/FiltFiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
  77. acoular/tests/reference_data/FiltFreqWeight_weight_A_.npy +0 -0
  78. acoular/tests/reference_data/FiltFreqWeight_weight_C_.npy +0 -0
  79. acoular/tests/reference_data/FiltFreqWeight_weight_Z_.npy +0 -0
  80. acoular/tests/reference_data/FiltOctave__.npy +0 -0
  81. acoular/tests/reference_data/FiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
  82. acoular/tests/reference_data/Filter__.npy +0 -0
  83. acoular/tests/reference_data/GeneralFlowEnvironment.npy +0 -0
  84. acoular/tests/reference_data/OctaveFilterBank__.npy +0 -0
  85. acoular/tests/reference_data/OpenJet.npy +0 -0
  86. acoular/tests/reference_data/PointSource.npy +0 -0
  87. acoular/tests/reference_data/PowerSpectra_csm.npy +0 -0
  88. acoular/tests/reference_data/PowerSpectra_ev.npy +0 -0
  89. acoular/tests/reference_data/RotatingFlow.npy +0 -0
  90. acoular/tests/reference_data/SlotJet.npy +0 -0
  91. acoular/tests/reference_data/TimeAverage__.npy +0 -0
  92. acoular/tests/reference_data/TimeCumAverage__.npy +0 -0
  93. acoular/tests/reference_data/TimeExpAverage_weight_F_.npy +0 -0
  94. acoular/tests/reference_data/TimeExpAverage_weight_I_.npy +0 -0
  95. acoular/tests/reference_data/TimeExpAverage_weight_S_.npy +0 -0
  96. acoular/tests/reference_data/TimeInOut__.npy +0 -0
  97. acoular/tests/reference_data/TimePower__.npy +0 -0
  98. acoular/tests/reference_data/TimeReverse__.npy +0 -0
  99. acoular/tests/reference_data/UniformFlowEnvironment.npy +0 -0
  100. acoular/tests/reference_data/beamformer_traj_time_data.h5 +0 -0
  101. acoular/tests/run_tests.sh +0 -18
  102. acoular/tests/run_tests_osx.sh +0 -16
  103. acoular/tests/test.npy +0 -0
  104. acoular/tests/test_beamformer_results.py +0 -204
  105. acoular/tests/test_classes.py +0 -60
  106. acoular/tests/test_digest.py +0 -125
  107. acoular/tests/test_environments.py +0 -73
  108. acoular/tests/test_example1.py +0 -124
  109. acoular/tests/test_grid.py +0 -92
  110. acoular/tests/test_integrate.py +0 -102
  111. acoular/tests/test_signals.py +0 -60
  112. acoular/tests/test_sources.py +0 -65
  113. acoular/tests/test_spectra.py +0 -38
  114. acoular/tests/test_timecache.py +0 -35
  115. acoular/tests/test_tprocess.py +0 -90
  116. acoular/tests/test_traj_beamformer_results.py +0 -164
  117. acoular/tests/unsupported/SpeedComparison/OvernightTestcasesBeamformer_nMics32_nGridPoints100_nFreqs4_nTrials10.png +0 -0
  118. acoular/tests/unsupported/SpeedComparison/cythonBeamformer.pyx +0 -237
  119. acoular/tests/unsupported/SpeedComparison/mainForCython.py +0 -103
  120. acoular/tests/unsupported/SpeedComparison/mainForParallelJit.py +0 -143
  121. acoular/tests/unsupported/SpeedComparison/setupCythonOpenMP.py +0 -63
  122. acoular/tests/unsupported/SpeedComparison/sharedFunctions.py +0 -153
  123. acoular/tests/unsupported/SpeedComparison/timeOverNMics_AllImportantMethods.png +0 -0
  124. acoular/tests/unsupported/SpeedComparison/timeOverNMics_faverage.png +0 -0
  125. acoular/tests/unsupported/SpeedComparison/vglOptimierungFAverage.py +0 -204
  126. acoular/tests/unsupported/SpeedComparison/vglOptimierungGaussSeidel.py +0 -182
  127. acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAMFULL_INVERSE.py +0 -764
  128. acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAM_OS.py +0 -231
  129. acoular/tests/unsupported/SpeedComparison/whatsFastestWayFor_absASquared.py +0 -48
  130. acoular/tests/unsupported/functionalBeamformer.py +0 -123
  131. acoular/tests/unsupported/precisionTest.py +0 -153
  132. acoular/tests/unsupported/validationOfBeamformerFuncsPOSTAcoularIntegration.py +0 -254
  133. acoular/tests/unsupported/validationOfBeamformerFuncsPREeAcoularIntegration.py +0 -531
  134. acoular/tools.py +0 -418
  135. acoular-23.11.dist-info/RECORD +0 -146
  136. acoular-23.11.dist-info/licenses/LICENSE +0 -29
  137. {acoular-23.11.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__ = "20 November 2023"
9
- __version__ = "23.11"
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: 23.11
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
- Maintainer-email: Adam Kujawski <adam.kujawski@tu-berlin.de>, Art Pelling <a.pelling@tu-berlin.de>, Ennes Sarradj <ennes.sarradj@tu-berlin.de>, Gert Herlod <gert.herold@tu-berlin.de>, Mikolaj Czuchaj <mikolaj.czuchaj@tu-berlin.de>, Simon Jekosch <s.jekosch@tu-berlin.de>
10
- License: Copyright (c) 2006-2023 The acoular developers.
11
- All rights reserved.
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: 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,31 +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: nox; extra == 'dev'
61
58
  Provides-Extra: full
62
59
  Requires-Dist: matplotlib; extra == 'full'
63
60
  Requires-Dist: pylops; extra == 'full'
61
+ Requires-Dist: sounddevice; extra == 'full'
64
62
  Description-Content-Type: text/markdown
65
63
 
66
- ![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)
67
65
 
68
66
  [![PyPI](https://img.shields.io/pypi/pyversions/acoular.svg)](https://pypi.org/project/acoular)
69
67
  [![PyPI](https://img.shields.io/pypi/v/acoular.svg)](https://pypi.org/project/acoular)
70
- [![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)
71
70
 
72
71
  # Acoular
73
72
  Acoular is a Python module for acoustic beamforming that is distributed under the new BSD license.
@@ -79,7 +78,7 @@ It is aimed at applications in acoustic testing. Multichannel data recorded by a
79
78
  - frequency domain deconvolution algorithms: DAMAS, DAMAS+, Clean, CleanSC, orthogonal deconvolution
80
79
  - frequency domain inverse methods: CMF (covariance matrix fitting), general inverse beamforming, SODIX
81
80
  - time domain methods: delay & sum beamforming, CleanT deconvolution
82
- - 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),
83
82
  - frequency domain methods for rotating sources via virtual array rotation for arbitrary arrays and with different interpolation techniques
84
83
  - 1D, 2D and 3D mapping grids for all methods
85
84
  - gridless option for orthogonal deconvolution
@@ -99,18 +98,25 @@ Acoular is licensed under the BSD 3-clause. See [LICENSE](LICENSE)
99
98
 
100
99
  # Citing
101
100
 
102
- If you use Acoular for academic work, please consider citing our
101
+ If you use Acoular for academic work, please consider citing both our
103
102
  [publication](https://doi.org/10.1016/j.apacoust.2016.09.015):
104
103
 
105
- Ennes Sarradj, Gert Herold,
106
- A Python framework for microphone array data processing,
107
- 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
108
114
 
109
115
  # Dependencies
110
116
  Acoular runs under Linux, Windows and MacOS and needs Numpy, Scipy, Traits, scikit-learn, pytables, Numba packages available.
111
117
  Matplotlib is needed for some of the examples.
112
118
 
113
- 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).
114
120
 
115
121
  # Installation
116
122
 
@@ -118,22 +124,22 @@ Acoular can be installed via [conda](https://docs.conda.io/en/latest/), which is
118
124
 
119
125
  conda install -c acoular acoular
120
126
 
121
- 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.
122
128
 
123
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
124
130
 
125
131
  pip install acoular
126
132
 
127
- 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).
128
134
 
129
135
  # Documentation and help
130
- Documentation is available [here](http://acoular.org) with a
131
- [getting started](http://acoular.org/get_started/index.html) section and
132
- [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).
133
139
 
134
140
  The Acoular [blog](https://acoular.github.io/blog/) contains some tutorials.
135
141
 
136
- 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.
137
143
 
138
144
  # Example
139
145
  This reads data from 64 microphone channels and computes a beamforming map for the 8kHz third octave band:
@@ -170,4 +176,5 @@ interpolation='bicubic')
170
176
  colorbar()
171
177
  ```
172
178
 
173
- ![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.18.0
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.