acoular 24.3__py3-none-any.whl → 24.7__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.
- acoular/__init__.py +119 -54
- acoular/calib.py +29 -38
- acoular/configuration.py +132 -82
- acoular/demo/__init__.py +10 -4
- acoular/demo/acoular_demo.py +73 -55
- acoular/environments.py +270 -264
- acoular/fastFuncs.py +366 -196
- acoular/fbeamform.py +1797 -1934
- acoular/grids.py +504 -548
- acoular/h5cache.py +74 -83
- acoular/h5files.py +159 -142
- acoular/internal.py +13 -14
- acoular/microphones.py +57 -53
- acoular/sdinput.py +57 -53
- acoular/signals.py +180 -178
- acoular/sources.py +920 -724
- acoular/spectra.py +353 -363
- acoular/tbeamform.py +416 -416
- acoular/tfastfuncs.py +180 -104
- acoular/tools/__init__.py +25 -0
- acoular/tools/aiaa.py +185 -0
- acoular/tools/helpers.py +189 -0
- acoular/tools/metrics.py +165 -0
- acoular/tprocess.py +1240 -1182
- acoular/traitsviews.py +513 -501
- acoular/trajectory.py +50 -52
- acoular/version.py +5 -6
- acoular/xml/minidsp_uma-16.xml +20 -0
- acoular/xml/{minidsp_uma16.xml → minidsp_uma-16_mirrored.xml} +3 -0
- {acoular-24.3.dist-info → acoular-24.7.dist-info}/METADATA +58 -39
- acoular-24.7.dist-info/RECORD +50 -0
- {acoular-24.3.dist-info → acoular-24.7.dist-info}/WHEEL +1 -1
- acoular-24.7.dist-info/licenses/LICENSE +28 -0
- acoular/fileimport.py +0 -380
- acoular/nidaqimport.py +0 -273
- acoular/tests/reference_data/BeamformerBase.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseFalse1.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseFalse2.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseFalse3.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseFalse4.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseTrue1.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseTrue2.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseTrue3.npy +0 -0
- acoular/tests/reference_data/BeamformerBaseTrue4.npy +0 -0
- acoular/tests/reference_data/BeamformerCMFLassoLarsBIC.npy +0 -0
- acoular/tests/reference_data/BeamformerCMFNNLS.npy +0 -0
- acoular/tests/reference_data/BeamformerCapon.npy +0 -0
- acoular/tests/reference_data/BeamformerClean.npy +0 -0
- acoular/tests/reference_data/BeamformerCleansc.npy +0 -0
- acoular/tests/reference_data/BeamformerCleant.npy +0 -0
- acoular/tests/reference_data/BeamformerCleantSq.npy +0 -0
- acoular/tests/reference_data/BeamformerCleantSqTraj.npy +0 -0
- acoular/tests/reference_data/BeamformerCleantTraj.npy +0 -0
- acoular/tests/reference_data/BeamformerDamas.npy +0 -0
- acoular/tests/reference_data/BeamformerDamasPlus.npy +0 -0
- acoular/tests/reference_data/BeamformerEig.npy +0 -0
- acoular/tests/reference_data/BeamformerEigFalse1.npy +0 -0
- acoular/tests/reference_data/BeamformerEigFalse2.npy +0 -0
- acoular/tests/reference_data/BeamformerEigFalse3.npy +0 -0
- acoular/tests/reference_data/BeamformerEigFalse4.npy +0 -0
- acoular/tests/reference_data/BeamformerEigTrue1.npy +0 -0
- acoular/tests/reference_data/BeamformerEigTrue2.npy +0 -0
- acoular/tests/reference_data/BeamformerEigTrue3.npy +0 -0
- acoular/tests/reference_data/BeamformerEigTrue4.npy +0 -0
- acoular/tests/reference_data/BeamformerFunctional.npy +0 -0
- acoular/tests/reference_data/BeamformerGIB.npy +0 -0
- acoular/tests/reference_data/BeamformerGridlessOrth.npy +0 -0
- acoular/tests/reference_data/BeamformerMusic.npy +0 -0
- acoular/tests/reference_data/BeamformerOrth.npy +0 -0
- acoular/tests/reference_data/BeamformerSODIX.npy +0 -0
- acoular/tests/reference_data/BeamformerTime.npy +0 -0
- acoular/tests/reference_data/BeamformerTimeSq.npy +0 -0
- acoular/tests/reference_data/BeamformerTimeSqTraj.npy +0 -0
- acoular/tests/reference_data/BeamformerTimeTraj.npy +0 -0
- acoular/tests/reference_data/Environment.npy +0 -0
- acoular/tests/reference_data/Example1_numerical_values_testsum.h5 +0 -0
- acoular/tests/reference_data/FiltFiltOctave__.npy +0 -0
- acoular/tests/reference_data/FiltFiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
- acoular/tests/reference_data/FiltFreqWeight_weight_A_.npy +0 -0
- acoular/tests/reference_data/FiltFreqWeight_weight_C_.npy +0 -0
- acoular/tests/reference_data/FiltFreqWeight_weight_Z_.npy +0 -0
- acoular/tests/reference_data/FiltOctave__.npy +0 -0
- acoular/tests/reference_data/FiltOctave_band_100_0_fraction_Thirdoctave_.npy +0 -0
- acoular/tests/reference_data/Filter__.npy +0 -0
- acoular/tests/reference_data/GeneralFlowEnvironment.npy +0 -0
- acoular/tests/reference_data/OctaveFilterBank__.npy +0 -0
- acoular/tests/reference_data/OpenJet.npy +0 -0
- acoular/tests/reference_data/PointSource.npy +0 -0
- acoular/tests/reference_data/PowerSpectra_csm.npy +0 -0
- acoular/tests/reference_data/PowerSpectra_ev.npy +0 -0
- acoular/tests/reference_data/RotatingFlow.npy +0 -0
- acoular/tests/reference_data/SlotJet.npy +0 -0
- acoular/tests/reference_data/TimeAverage__.npy +0 -0
- acoular/tests/reference_data/TimeCumAverage__.npy +0 -0
- acoular/tests/reference_data/TimeExpAverage_weight_F_.npy +0 -0
- acoular/tests/reference_data/TimeExpAverage_weight_I_.npy +0 -0
- acoular/tests/reference_data/TimeExpAverage_weight_S_.npy +0 -0
- acoular/tests/reference_data/TimeInOut__.npy +0 -0
- acoular/tests/reference_data/TimePower__.npy +0 -0
- acoular/tests/reference_data/TimeReverse__.npy +0 -0
- acoular/tests/reference_data/UniformFlowEnvironment.npy +0 -0
- acoular/tests/reference_data/beamformer_traj_time_data.h5 +0 -0
- acoular/tests/run_tests.sh +0 -18
- acoular/tests/run_tests_osx.sh +0 -16
- acoular/tests/test.npy +0 -0
- acoular/tests/test_beamformer_results.py +0 -213
- acoular/tests/test_classes.py +0 -60
- acoular/tests/test_digest.py +0 -125
- acoular/tests/test_environments.py +0 -73
- acoular/tests/test_example1.py +0 -124
- acoular/tests/test_grid.py +0 -92
- acoular/tests/test_integrate.py +0 -102
- acoular/tests/test_signals.py +0 -60
- acoular/tests/test_sources.py +0 -65
- acoular/tests/test_spectra.py +0 -38
- acoular/tests/test_timecache.py +0 -35
- acoular/tests/test_tprocess.py +0 -90
- acoular/tests/test_traj_beamformer_results.py +0 -164
- acoular/tests/unsupported/SpeedComparison/OvernightTestcasesBeamformer_nMics32_nGridPoints100_nFreqs4_nTrials10.png +0 -0
- acoular/tests/unsupported/SpeedComparison/cythonBeamformer.pyx +0 -237
- acoular/tests/unsupported/SpeedComparison/mainForCython.py +0 -103
- acoular/tests/unsupported/SpeedComparison/mainForParallelJit.py +0 -143
- acoular/tests/unsupported/SpeedComparison/setupCythonOpenMP.py +0 -63
- acoular/tests/unsupported/SpeedComparison/sharedFunctions.py +0 -153
- acoular/tests/unsupported/SpeedComparison/timeOverNMics_AllImportantMethods.png +0 -0
- acoular/tests/unsupported/SpeedComparison/timeOverNMics_faverage.png +0 -0
- acoular/tests/unsupported/SpeedComparison/vglOptimierungFAverage.py +0 -204
- acoular/tests/unsupported/SpeedComparison/vglOptimierungGaussSeidel.py +0 -182
- acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAMFULL_INVERSE.py +0 -764
- acoular/tests/unsupported/SpeedComparison/vglOptimierungR_BEAM_OS.py +0 -231
- acoular/tests/unsupported/SpeedComparison/whatsFastestWayFor_absASquared.py +0 -48
- acoular/tests/unsupported/functionalBeamformer.py +0 -123
- acoular/tests/unsupported/precisionTest.py +0 -153
- acoular/tests/unsupported/validationOfBeamformerFuncsPOSTAcoularIntegration.py +0 -254
- acoular/tests/unsupported/validationOfBeamformerFuncsPREeAcoularIntegration.py +0 -531
- acoular/tools.py +0 -422
- acoular-24.3.dist-info/RECORD +0 -148
- acoular-24.3.dist-info/licenses/LICENSE +0 -29
- {acoular-24.3.dist-info → acoular-24.7.dist-info}/licenses/AUTHORS.rst +0 -0
acoular/trajectory.py
CHANGED
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
#
|
|
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,
|
|
16
|
-
from scipy.interpolate import
|
|
17
|
-
from traits.api import
|
|
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(
|
|
25
|
-
"""
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
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
|
-
|
|
28
|
+
|
|
29
|
+
#: Dictionary that assigns discrete time instants (keys) to
|
|
33
30
|
#: sampled `(x, y, z)` positions along the trajectory (values).
|
|
34
|
-
points = Dict(
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
|
48
|
-
|
|
46
|
+
digest = Property(
|
|
47
|
+
depends_on=['points[]'],
|
|
48
|
+
)
|
|
49
49
|
|
|
50
50
|
@cached_property
|
|
51
|
-
def _get_digest(
|
|
51
|
+
def _get_digest(self):
|
|
52
52
|
return digest(self)
|
|
53
|
-
|
|
53
|
+
|
|
54
54
|
@property_depends_on('points[]')
|
|
55
|
-
def _get_interval(
|
|
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(
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
#
|
|
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__ =
|
|
8
|
-
__date__ =
|
|
9
|
-
__version__ =
|
|
6
|
+
__author__ = 'Acoular Development Team'
|
|
7
|
+
__date__ = '19 July 2024'
|
|
8
|
+
__version__ = '24.07'
|
|
@@ -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
|
+
Metadata-Version: 2.3
|
|
2
2
|
Name: acoular
|
|
3
|
-
Version: 24.
|
|
3
|
+
Version: 24.7
|
|
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:
|
|
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
|
-
|
|
18
|
-
|
|
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
|
-
|
|
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
|
-
|
|
37
|
-
|
|
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,45 @@ 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: <=
|
|
51
|
+
Requires-Python: <=12,>=3.8
|
|
53
52
|
Requires-Dist: numba
|
|
54
|
-
Requires-Dist: numpy
|
|
53
|
+
Requires-Dist: numpy<2.0
|
|
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
58
|
Provides-Extra: dev
|
|
60
59
|
Requires-Dist: graphviz; extra == 'dev'
|
|
60
|
+
Requires-Dist: hatch; extra == 'dev'
|
|
61
61
|
Requires-Dist: ipython; extra == 'dev'
|
|
62
62
|
Requires-Dist: matplotlib; extra == 'dev'
|
|
63
|
-
Requires-Dist: nox; extra == 'dev'
|
|
64
63
|
Requires-Dist: numpydoc; extra == 'dev'
|
|
65
64
|
Requires-Dist: pickleshare; extra == 'dev'
|
|
65
|
+
Requires-Dist: pylops; extra == 'dev'
|
|
66
|
+
Requires-Dist: pytest; extra == 'dev'
|
|
67
|
+
Requires-Dist: ruff==0.4.1; extra == 'dev'
|
|
66
68
|
Requires-Dist: sounddevice; extra == 'dev'
|
|
67
69
|
Requires-Dist: sphinx; extra == 'dev'
|
|
70
|
+
Requires-Dist: sphinx-gallery; extra == 'dev'
|
|
71
|
+
Requires-Dist: traitsui; extra == 'dev'
|
|
68
72
|
Provides-Extra: full
|
|
69
73
|
Requires-Dist: matplotlib; extra == 'full'
|
|
70
74
|
Requires-Dist: pylops; extra == 'full'
|
|
71
75
|
Requires-Dist: sounddevice; extra == 'full'
|
|
72
76
|
Description-Content-Type: text/markdown
|
|
73
77
|
|
|
74
|
-

|
|
75
79
|
|
|
76
80
|
[](https://pypi.org/project/acoular)
|
|
77
81
|
[](https://pypi.org/project/acoular)
|
|
78
|
-
[](https://github.com/acoular/acoular/actions)
|
|
83
|
+
[](https://zenodo.org/doi/10.5281/zenodo.3690794)
|
|
79
84
|
|
|
80
85
|
# Acoular
|
|
81
86
|
Acoular is a Python module for acoustic beamforming that is distributed under the new BSD license.
|
|
@@ -87,7 +92,7 @@ It is aimed at applications in acoustic testing. Multichannel data recorded by a
|
|
|
87
92
|
- frequency domain deconvolution algorithms: DAMAS, DAMAS+, Clean, CleanSC, orthogonal deconvolution
|
|
88
93
|
- frequency domain inverse methods: CMF (covariance matrix fitting), general inverse beamforming, SODIX
|
|
89
94
|
- time domain methods: delay & sum beamforming, CleanT deconvolution
|
|
90
|
-
- time domain methods applicable for moving
|
|
95
|
+
- time domain methods applicable for moving sources with arbitrary trajectory (linear, circular, arbitrarily 3D curved),
|
|
91
96
|
- frequency domain methods for rotating sources via virtual array rotation for arbitrary arrays and with different interpolation techniques
|
|
92
97
|
- 1D, 2D and 3D mapping grids for all methods
|
|
93
98
|
- gridless option for orthogonal deconvolution
|
|
@@ -107,18 +112,25 @@ Acoular is licensed under the BSD 3-clause. See [LICENSE](LICENSE)
|
|
|
107
112
|
|
|
108
113
|
# Citing
|
|
109
114
|
|
|
110
|
-
If you use Acoular for academic work, please consider citing our
|
|
115
|
+
If you use Acoular for academic work, please consider citing both our
|
|
111
116
|
[publication](https://doi.org/10.1016/j.apacoust.2016.09.015):
|
|
112
117
|
|
|
113
|
-
|
|
114
|
-
A Python framework for microphone array data processing
|
|
115
|
-
Applied Acoustics,
|
|
118
|
+
Sarradj, E., & Herold, G. (2017).
|
|
119
|
+
A Python framework for microphone array data processing.
|
|
120
|
+
Applied Acoustics, 116, 50–58.
|
|
121
|
+
https://doi.org/10.1016/j.apacoust.2016.09
|
|
122
|
+
|
|
123
|
+
and our [software](https://zenodo.org/doi/10.5281/zenodo.3690794):
|
|
124
|
+
|
|
125
|
+
Sarradj, E., Herold, G., Kujawski, A., Jekosch, S., Pelling, A. J. R., Czuchaj, M., Gensch, T., & Oertwig, S..
|
|
126
|
+
Acoular – Acoustic testing and source mapping software.
|
|
127
|
+
Zenodo. https://zenodo.org/doi/10.5281/zenodo.3690794
|
|
116
128
|
|
|
117
129
|
# Dependencies
|
|
118
130
|
Acoular runs under Linux, Windows and MacOS and needs Numpy, Scipy, Traits, scikit-learn, pytables, Numba packages available.
|
|
119
131
|
Matplotlib is needed for some of the examples.
|
|
120
132
|
|
|
121
|
-
If you want to use input from a soundcard
|
|
133
|
+
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
134
|
|
|
123
135
|
# Installation
|
|
124
136
|
|
|
@@ -126,22 +138,27 @@ Acoular can be installed via [conda](https://docs.conda.io/en/latest/), which is
|
|
|
126
138
|
|
|
127
139
|
conda install -c acoular acoular
|
|
128
140
|
|
|
129
|
-
This will install Acoular in your Anaconda Python
|
|
141
|
+
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
142
|
|
|
131
143
|
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
144
|
|
|
133
145
|
pip install acoular
|
|
134
146
|
|
|
135
|
-
For more detailed
|
|
147
|
+
For more detailed installation instructions, see the [documentation](https://acoular.org/install/index.html).
|
|
136
148
|
|
|
137
149
|
# Documentation and help
|
|
138
|
-
Documentation is available [here](
|
|
139
|
-
[getting started](
|
|
140
|
-
[examples](
|
|
150
|
+
Documentation is available [here](https://acoular.org) with a
|
|
151
|
+
[getting started](https://acoular.org/get_started/index.html) section and
|
|
152
|
+
[examples](https://acoular.org/auto_examples/index.html).
|
|
141
153
|
|
|
142
154
|
The Acoular [blog](https://acoular.github.io/blog/) contains some tutorials.
|
|
143
155
|
|
|
144
|
-
|
|
156
|
+
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.
|
|
157
|
+
|
|
158
|
+
# Contributing
|
|
159
|
+
|
|
160
|
+
We are always happy to welcome new contributors to the project.
|
|
161
|
+
If you are interested in contributing, have a look at the [CONTRIBUTING.md](CONTRIBUTING.md) file.
|
|
145
162
|
|
|
146
163
|
# Example
|
|
147
164
|
This reads data from 64 microphone channels and computes a beamforming map for the 8kHz third octave band:
|
|
@@ -178,4 +195,6 @@ interpolation='bicubic')
|
|
|
178
195
|
colorbar()
|
|
179
196
|
```
|
|
180
197
|
|
|
181
|
-

|
|
199
|
+
|
|
200
|
+
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
acoular/__init__.py,sha256=jLpPzpO7Y_0MpuE9VZuK8mKoL5IVTtr9nJ8LzOqn-FA,2887
|
|
2
|
+
acoular/calib.py,sha256=7hyas42kn33qvvO4Is2nxkyQEnL8MTo6mIq1VZ56vOQ,2509
|
|
3
|
+
acoular/configuration.py,sha256=fQwE-tyzzlpiEHJdTw0lorfxS_9-ZaSBqCZsk0nqni0,8493
|
|
4
|
+
acoular/environments.py,sha256=Gzow4u-0FU4zWoVtlXxZQJ7RAyMfE9bOuXEeUB-LtNQ,22468
|
|
5
|
+
acoular/fastFuncs.py,sha256=UHIVLsog5U4urV5h8_0Sh5xT8no7guE4Q6amRRZiib0,38863
|
|
6
|
+
acoular/fbeamform.py,sha256=bMTVe4gii4KXuzCMNzoPorZslNYM7Rqice1R3SAEyjk,101739
|
|
7
|
+
acoular/grids.py,sha256=g2ehACwrxaK6cUdr7_2UMNL6FFR_ZPycjjUdbVeJQNg,40081
|
|
8
|
+
acoular/h5cache.py,sha256=87OU9sVw96j5Hvj5Xtk21_k2PoqG5e3yl8FruqJqPPQ,4214
|
|
9
|
+
acoular/h5files.py,sha256=YlnHOAr3ePOs6-AJcN_eNun0XBws-cSNGCj3U2jhJP0,7653
|
|
10
|
+
acoular/internal.py,sha256=qgluN_4Br7U74keTiavbmxRMkcNkoHcL1TihKTcMEBs,829
|
|
11
|
+
acoular/microphones.py,sha256=Pn4pKZtr82LRE3TkBfLyWQZnnLyppIVhoqJjhiHhdOk,5113
|
|
12
|
+
acoular/sdinput.py,sha256=AsW2OD9sMMYhZI4qKDYgtuK7iSDbBPw5KX_HV_c4H1E,4470
|
|
13
|
+
acoular/signals.py,sha256=W3_lXE08LymzlXsN67dSyQzH6yuSWMKKy4SYOqjTKYE,11850
|
|
14
|
+
acoular/sources.py,sha256=hlyOzvol4BEpMFcqLpPaNSZEEBjSZDuZETPpLMRTywE,55908
|
|
15
|
+
acoular/spectra.py,sha256=KGAIRlSQppjiSpvYEbz8el9VSz_c0XJwrqDCmncZoMw,28077
|
|
16
|
+
acoular/tbeamform.py,sha256=nmYBXKEalBZ0WjRdNrDTkn-2V3UvugckoztikTW9lq4,30329
|
|
17
|
+
acoular/tfastfuncs.py,sha256=YtLvz-WAW9SY9zNLYBzkLTj8da9ibCsjPOGWe9ZLFEg,7880
|
|
18
|
+
acoular/tprocess.py,sha256=S-XPwwVmZxZFVzGFyV6dBsiAt3btdt4PwyrpmuHcxHU,88938
|
|
19
|
+
acoular/traitsviews.py,sha256=iovxrE4LS_xUlrlf0mVCirMPc0PWInmCfihvDLX116Q,13741
|
|
20
|
+
acoular/trajectory.py,sha256=I3Ve08IlritHcG7iOBt-jjjRY7bCGWwOjTwD4rorTi8,3964
|
|
21
|
+
acoular/version.py,sha256=D44mLRFcnPMgESgNzTVzV-XO1epX2eIsXgZFcol19j4,377
|
|
22
|
+
acoular/demo/__init__.py,sha256=ejn5L3j0M3BwsaxQNSAAFdBNU1kr0LpVFxtONtj9dP8,332
|
|
23
|
+
acoular/demo/acoular_demo.py,sha256=HAmINlkTuyD0kVlokyIN5XnViPzzZFOHAMNwpzq_dvU,3276
|
|
24
|
+
acoular/tools/__init__.py,sha256=GaM58W_aB4YIkO5xFsndYHVYuxLVzQMVdvE6ZoAtABA,573
|
|
25
|
+
acoular/tools/aiaa.py,sha256=_LKNMNrMcJ-zoBmCIDa4Tqi7uHet2Pp0uRVJmUzzAyw,6444
|
|
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.7.dist-info/METADATA,sha256=YzvBHVxQsaMT9EVrDStMQ38k58aXg79IosWVKIi9CQE,10996
|
|
47
|
+
acoular-24.7.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
|
|
48
|
+
acoular-24.7.dist-info/licenses/AUTHORS.rst,sha256=445q_Us_TnQx8s_GP2yringU2DMTk3-ycrk2REtSsx0,382
|
|
49
|
+
acoular-24.7.dist-info/licenses/LICENSE,sha256=tbw7-nx204gXCo8p-NwwR7w8oKvNMWB4H07FTT6V9p8,1505
|
|
50
|
+
acoular-24.7.dist-info/RECORD,,
|
|
@@ -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.
|