acoular 24.10__tar.gz → 25.3__tar.gz

{acoular-24.10 → acoular-25.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: acoular
-Version: 24.10
+Version: 25.3
 Summary: Python library for acoustic beamforming
 Project-URL: homepage, https://acoular.org
 Project-URL: documentation, https://acoular.org
@@ -45,8 +45,9 @@ Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: Physics
-Requires-Python: <=12,>=3.10
+Requires-Python: <3.14,>=3.10
 Requires-Dist: numba
 Requires-Dist: numpy
 Requires-Dist: scikit-learn
@@ -63,9 +64,14 @@ Requires-Dist: numpydoc; extra == 'dev'
 Requires-Dist: pickleshare; extra == 'dev'
 Requires-Dist: pylops; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cases; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest-env; extra == 'dev'
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: pytest-profiling; extra == 'dev'
+Requires-Dist: pytest-regtest; extra == 'dev'
 Requires-Dist: pyyaml; extra == 'dev'
-Requires-Dist: ruff==0.4.1; extra == 'dev'
+Requires-Dist: ruff==0.8.1; extra == 'dev'
 Requires-Dist: setuptools; extra == 'dev'
 Requires-Dist: sounddevice; extra == 'dev'
 Requires-Dist: sphinx; extra == 'dev'
@@ -89,8 +95,14 @@ Requires-Dist: pylops; extra == 'full'
 Requires-Dist: sounddevice; extra == 'full'
 Provides-Extra: tests
 Requires-Dist: h5py; extra == 'tests'
+Requires-Dist: pylops; extra == 'tests'
 Requires-Dist: pytest; extra == 'tests'
+Requires-Dist: pytest-cases; extra == 'tests'
 Requires-Dist: pytest-cov; extra == 'tests'
+Requires-Dist: pytest-env; extra == 'tests'
+Requires-Dist: pytest-mock; extra == 'tests'
+Requires-Dist: pytest-profiling; extra == 'tests'
+Requires-Dist: pytest-regtest; extra == 'tests'
 Requires-Dist: pyyaml; extra == 'tests'
 Requires-Dist: sounddevice; extra == 'tests'
 Requires-Dist: traitsui; extra == 'tests'
@@ -185,35 +197,45 @@ If you are interested in contributing, have a look at the [CONTRIBUTING.md](CONT
 This reads data from 64 microphone channels and computes a beamforming map for the 8kHz third octave band:
 
 ```python
-from os import path
-import acoular
-from matplotlib.pylab import figure, plot, axis, imshow, colorbar, show
+from pathlib import Path
+
+import acoular as ac
+import matplotlib.pylab as plt
 
 # this file contains the microphone coordinates
-micgeofile = path.join(path.split(acoular.__file__)[0],'xml','array_64.xml')
+micgeofile = Path(ac.__file__).parent / 'xml' / 'array_64.xml'
 # set up object managing the microphone coordinates
-mg = acoular.MicGeom( from_file=micgeofile )
+mg = ac.MicGeom( file=micgeofile )
+# generate test data, in real life this would come from an array measurement
+p = ac.demo.create_three_sources(mg, h5savefile='three_sources.h5')
 # set up object managing the microphone array data (usually from measurement)
-ts = acoular.TimeSamples( name='three_sources.h5' )
+ts = ac.TimeSamples( file='three_sources.h5')
 # set up object managing the cross spectral matrix computation
-ps = acoular.PowerSpectra( source=ts, block_size=128, window='Hanning' )
+ps = ac.PowerSpectra( source=ts, block_size=128, window='Hanning' )
+# alternatively, you can use the in-memory Mixer object directly:
+# ps = ac.PowerSpectra( source=p, block_size=128, window='Hanning' )
 # set up object managing the mapping grid
-rg = acoular.RectGrid( x_min=-0.2, x_max=0.2, y_min=-0.2, y_max=0.2, z=0.3, \
+rg = ac.RectGrid( x_min=-0.2, x_max=0.2, y_min=-0.2, y_max=0.2, z=-0.3, \
 increment=0.01 )
 # set up steering vector, implicitely contains also the standard quiescent 
 # environment with standard speed of sound
-st = acoular.SteeringVector( grid = rg, mics=mg )
+st = ac.SteeringVector( grid = rg, mics=mg )
 # set up the object managing the delay & sum beamformer
-bb = acoular.BeamformerBase( freq_data=ps, steer=st )
+bb = ac.BeamformerBase( freq_data=ps, steer=st )
 # request the result in the 8kHz third octave band from approriate FFT-Lines
 # this starts the actual computation (data intake, FFT, Welch CSM, beamforming)
 pm = bb.synthetic( 8000, 3 )
 # compute the sound pressure level
-Lm = acoular.L_p( pm )
+Lm = ac.L_p( pm )
 # plot the map
-imshow( Lm.T, origin='lower', vmin=Lm.max()-10, extent=rg.extend(), \
+plt.imshow( Lm.T, origin='lower', vmin=Lm.max()-10, extent=rg.extend(), \
 interpolation='bicubic')
-colorbar()
+plt.title('Beamformer (base) for 3 sources measured for 8000 Hz')
+plt.xlabel('x in m')
+plt.ylabel('y in m')
+plt.colorbar(label=r'$L_p$')
+plt.savefig('three_sources.png', dpi=300, bbox_inches='tight')
+plt.show()
 ```
 
 ![result](https://github.com/acoular/acoular/blob/master/docs/source/get_started/three_source_py3_colormap.png?raw=true)

{acoular-24.10 → acoular-25.3}/README.md

@@ -87,35 +87,45 @@ If you are interested in contributing, have a look at the [CONTRIBUTING.md](CONT
 This reads data from 64 microphone channels and computes a beamforming map for the 8kHz third octave band:
 
 ```python
-from os import path
-import acoular
-from matplotlib.pylab import figure, plot, axis, imshow, colorbar, show
+from pathlib import Path
+
+import acoular as ac
+import matplotlib.pylab as plt
 
 # this file contains the microphone coordinates
-micgeofile = path.join(path.split(acoular.__file__)[0],'xml','array_64.xml')
+micgeofile = Path(ac.__file__).parent / 'xml' / 'array_64.xml'
 # set up object managing the microphone coordinates
-mg = acoular.MicGeom( from_file=micgeofile )
+mg = ac.MicGeom( file=micgeofile )
+# generate test data, in real life this would come from an array measurement
+p = ac.demo.create_three_sources(mg, h5savefile='three_sources.h5')
 # set up object managing the microphone array data (usually from measurement)
-ts = acoular.TimeSamples( name='three_sources.h5' )
+ts = ac.TimeSamples( file='three_sources.h5')
 # set up object managing the cross spectral matrix computation
-ps = acoular.PowerSpectra( source=ts, block_size=128, window='Hanning' )
+ps = ac.PowerSpectra( source=ts, block_size=128, window='Hanning' )
+# alternatively, you can use the in-memory Mixer object directly:
+# ps = ac.PowerSpectra( source=p, block_size=128, window='Hanning' )
 # set up object managing the mapping grid
-rg = acoular.RectGrid( x_min=-0.2, x_max=0.2, y_min=-0.2, y_max=0.2, z=0.3, \
+rg = ac.RectGrid( x_min=-0.2, x_max=0.2, y_min=-0.2, y_max=0.2, z=-0.3, \
 increment=0.01 )
 # set up steering vector, implicitely contains also the standard quiescent 
 # environment with standard speed of sound
-st = acoular.SteeringVector( grid = rg, mics=mg )
+st = ac.SteeringVector( grid = rg, mics=mg )
 # set up the object managing the delay & sum beamformer
-bb = acoular.BeamformerBase( freq_data=ps, steer=st )
+bb = ac.BeamformerBase( freq_data=ps, steer=st )
 # request the result in the 8kHz third octave band from approriate FFT-Lines
 # this starts the actual computation (data intake, FFT, Welch CSM, beamforming)
 pm = bb.synthetic( 8000, 3 )
 # compute the sound pressure level
-Lm = acoular.L_p( pm )
+Lm = ac.L_p( pm )
 # plot the map
-imshow( Lm.T, origin='lower', vmin=Lm.max()-10, extent=rg.extend(), \
+plt.imshow( Lm.T, origin='lower', vmin=Lm.max()-10, extent=rg.extend(), \
 interpolation='bicubic')
-colorbar()
+plt.title('Beamformer (base) for 3 sources measured for 8000 Hz')
+plt.xlabel('x in m')
+plt.ylabel('y in m')
+plt.colorbar(label=r'$L_p$')
+plt.savefig('three_sources.png', dpi=300, bbox_inches='tight')
+plt.show()
 ```
 
 ![result](https://github.com/acoular/acoular/blob/master/docs/source/get_started/three_source_py3_colormap.png?raw=true)

{acoular-24.10 → acoular-25.3}/acoular/__init__.py

@@ -9,7 +9,7 @@ import os  # noqa: I001
 # config must be imported before any submodules containing numpy, see #322.
 from .configuration import config
 
-from . import demo, tools
+from . import demo, tools, aiaa
 from .base import (
     Generator,
     InOut,
@@ -74,6 +74,8 @@ from .sdinput import SoundDeviceSamplesGenerator
 from .signals import (
     FiltWNoiseGenerator,
     GenericSignalGenerator,
+    NoiseGenerator,
+    PeriodicSignalGenerator,
     PNoiseGenerator,
     SignalGenerator,
     SineGenerator,
@@ -93,7 +95,8 @@ from .sources import (
     TimeSamples,
     UncorrelatedNoiseSource,
 )
-from .spectra import BaseSpectra, PowerSpectra, PowerSpectraImport, synthetic
+from .tools.helpers import synthetic
+from .spectra import BaseSpectra, PowerSpectra, PowerSpectraImport
 from .spectra import PowerSpectra as EigSpectra
 from .tbeamform import (
     BeamformerCleant,

acoular-25.3/acoular/aiaa/__init__.py

@@ -0,0 +1,12 @@
+# ------------------------------------------------------------------------------
+# Copyright (c) Acoular Development Team.
+# ------------------------------------------------------------------------------
+"""Provides classes for importing AIAA Array Benchmarks.
+
+.. autosummary::
+    :toctree: generated/
+
+    aiaa
+"""
+
+from .aiaa import CsmAIAABenchmark, MicAIAABenchmark, TimeSamplesAIAABenchmark, TriggerAIAABenchmark

{acoular-24.10/acoular/tools → acoular-25.3/acoular/aiaa}/aiaa.py

@@ -1,8 +1,8 @@
 # ------------------------------------------------------------------------------
 # Copyright (c) Acoular Development Team.
 # ------------------------------------------------------------------------------
-"""Classes for importing AIAA Array Benchmarks
-from . import aiaa
+"""Classes for importing AIAA Array Benchmarks.
+
 These classes allow importing data from HDF5 files following the specifications of
 the AIAA microphone array methods benchmarking effort:
 https://www-docs.b-tu.de/fg-akustik/public/veroeffentlichungen/ArrayMethodsFileFormatsR2P4Release.pdf .
@@ -12,8 +12,8 @@ the framework.
 
 Examples
 --------
->>> micgeom = MicAIAABenchmark(name='some_benchmarkdata.h5')  # doctest: +SKIP
->>> timedata = TimeSamplesAIAABenchmark(name='some_benchmarkdata.h5')  # doctest: +SKIP
+>>> micgeom = MicAIAABenchmark(file='some_benchmarkdata.h5')  # doctest: +SKIP
+>>> timedata = TimeSamplesAIAABenchmark(file='some_benchmarkdata.h5')  # doctest: +SKIP
 
 
 .. autosummary::
@@ -23,10 +23,9 @@ Examples
     TriggerAIAABenchmark
     CsmAIAABenchmark
     MicAIAABenchmark
-"""
+"""  # noqa: W505
 
 import contextlib
-from os import path
 
 from numpy import array
 from traits.api import (
@@ -38,11 +37,13 @@ from traits.api import (
     property_depends_on,
 )
 
+from acoular.deprecation import deprecated_alias
 from acoular.h5files import H5FileBase, _get_h5file_class
 from acoular.internal import digest
 from acoular.microphones import MicGeom
 from acoular.sources import TimeSamples
 from acoular.spectra import PowerSpectraImport
+from acoular.tools.utils import get_file_basename
 
 
 class TimeSamplesAIAABenchmark(TimeSamples):
@@ -58,7 +59,7 @@ class TimeSamplesAIAABenchmark(TimeSamples):
         """Loads timedata from .h5 file. Only for internal use."""
         self.data = self.h5f.get_data_by_reference('MicrophoneData/microphoneDataPa')
         self.sample_freq = self.h5f.get_node_attribute(self.data, 'sampleRateHz')
-        (self.numsamples, self.numchannels) = self.data.shape
+        (self.num_samples, self.num_channels) = self.data.shape
 
     def _load_metadata(self):
         """Loads metadata from .h5 file. Only for internal use."""
@@ -80,23 +81,24 @@ class TriggerAIAABenchmark(TimeSamplesAIAABenchmark):
         """Loads timedata from .h5 file. Only for internal use."""
         self.data = self.h5f.get_data_by_reference('TachoData/tachoDataV')
         self.sample_freq = self.h5f.get_node_attribute(self.data, 'sampleRateHz')
-        (self.numsamples, self.numchannels) = self.data.shape
+        (self.num_samples, self.num_channels) = self.data.shape
 
 
+@deprecated_alias({'name': 'file'})
 class CsmAIAABenchmark(PowerSpectraImport):
     """Class to load the CSM that is stored in AIAA Benchmark HDF5 file."""
 
     #: Full name of the .h5 file with data
-    name = File(filter=['*.h5'], desc='name of data file')
+    file = File(filter=['*.h5'], exists=True, desc='name of data file')
 
     #: Basename of the .h5 file with data, is set automatically.
     basename = Property(
-        depends_on='name',
+        depends_on=['file'],
         desc='basename of data file',
     )
 
     #: number of channels
-    numchannels = Property()
+    num_channels = Property()
 
     #: HDF5 file object
     h5f = Instance(H5FileBase, transient=True)
@@ -110,19 +112,16 @@ class CsmAIAABenchmark(PowerSpectraImport):
 
     @cached_property
     def _get_basename(self):
-        return path.splitext(path.basename(self.name))[0]
+        return get_file_basename(self.file)
 
     @on_trait_change('basename')
     def load_data(self):
         """Open the .h5 file and set attributes."""
-        if not path.isfile(self.name):
-            # no file there
-            raise OSError('No such file: %s' % self.name)
         if self.h5f is not None:
             with contextlib.suppress(OSError):
                 self.h5f.close()
         file = _get_h5file_class()
-        self.h5f = file(self.name)
+        self.h5f = file(self.file)
 
     # @property_depends_on( 'block_size, ind_low, ind_high' )
     def _get_indices(self):
@@ -131,15 +130,15 @@ class CsmAIAABenchmark(PowerSpectraImport):
         except IndexError:
             return range(0)
 
-    @property_depends_on('digest')
-    def _get_numchannels(self):
+    @property_depends_on(['digest'])
+    def _get_num_channels(self):
         try:
             attrs = self.h5f.get_data_by_reference('MetaData/ArrayAttributes')
             return self.h5f.get_node_attribute(attrs, 'microphoneCount')
         except IndexError:
             return 0
 
-    @property_depends_on('digest')
+    @property_depends_on(['digest'])
     def _get_csm(self):
         """Loads cross spectral matrix from file."""
         csmre = self.h5f.get_data_by_reference('/CsmData/csmReal')[:].transpose((2, 0, 1))
@@ -167,19 +166,15 @@ class MicAIAABenchmark(MicGeom):
     file containing the measurement data.
     """
 
-    #: Name of the .h5-file from wich to read the data.
-    from_file = File(filter=['*.h5'], desc='name of the h5 file containing the microphone geometry')
+    #: Name of the .h5-file from which to read the data.
+    file = File(filter=['*.h5'], exists=True, desc='name of the h5 file containing the microphone geometry')
 
-    @on_trait_change('basename')
+    @on_trait_change('file')
     def import_mpos(self):
         """Import the microphone positions from .h5 file.
         Called when :attr:`basename` changes.
         """
-        if not path.isfile(self.from_file):
-            # no file there
-            raise OSError('No such file: %s' % self.from_file)
-
         file = _get_h5file_class()
-        h5f = file(self.from_file, mode='r')
-        self.mpos_tot = h5f.get_data_by_reference('MetaData/ArrayAttributes/microphonePositionsM')[:].swapaxes(0, 1)
+        h5f = file(self.file, mode='r')
+        self.pos_total = h5f.get_data_by_reference('MetaData/ArrayAttributes/microphonePositionsM')[:].swapaxes(0, 1)
         h5f.close()

{acoular-24.10 → acoular-25.3}/acoular/base.py

@@ -3,9 +3,9 @@
 # ------------------------------------------------------------------------------
 """Implements base classes for signal processing blocks in Acoular.
 
-The classes in this module are abstract base classes that provide a common interface for all classes that generate an
-output via the generator :meth:`result` in block-wise manner. They are not intended to be used directly, but to be
-subclassed by classes that implement the actual signal processing.
+The classes in this module are abstract base classes that provide a common interface for all classes
+that generate an output via the generator :meth:`result` in block-wise manner. They are not intended
+to be used directly, but to be subclassed by classes that implement the actual signal processing.
 
 .. autosummary::
     :toctree: generated/
@@ -19,42 +19,54 @@ subclassed by classes that implement the actual signal processing.
     TimeInOut
 """
 
+from abc import abstractmethod
+
 from traits.api import (
+    ABCHasStrictTraits,
     CArray,
-    CLong,
+    CInt,
     Delegate,
     Float,
-    HasPrivateTraits,
     Instance,
     Property,
     cached_property,
 )
 
-from acoular.internal import digest
+# acoular imports
+from .deprecation import deprecated_alias
+from .internal import digest
 
 
-class Generator(HasPrivateTraits):
+@deprecated_alias({'numchannels': 'num_channels', 'numsamples': 'num_samples'})
+class Generator(ABCHasStrictTraits):
     """Interface for any generating signal processing block.
 
-    It provides a common interface for all classes, which generate an output via the generator :meth:`result`
-    in block-wise manner. It has a common set of traits that are used by all classes that implement this interface.
-    This includes the sampling frequency of the signal (:attr:`sample_freq`) and the number of samples (:attr:`numsamples`).
-    A private trait :attr:`digest` is used to store the internal identifier of the object, which is a hash of the object's
-    attributes. This is used to check if the object's internal state has changed.
+    It provides a common interface for all classes, which generate an output via the generator
+    :meth:`result` in block-wise manner. It has a common set of traits that are used by all classes
+    that implement this interface. This includes the sampling frequency of the signal
+    (:attr:`sample_freq`), the number of samples (:attr:`num_samples`), and the number of channels
+    (:attr:`num_channels`). A private trait :attr:`digest` is used to store the internal identifier
+    of the object, which is a hash of the object's attributes.
+    This is used to check if the object's internal state has changed.
+
     """
 
     #: Sampling frequency of the signal, defaults to 1.0
     sample_freq = Float(1.0, desc='sampling frequency')
 
     #: Number of signal samples
-    numsamples = CLong
+    num_samples = CInt
+
+    #: Number of channels
+    num_channels = CInt
 
     # internal identifier
-    digest = Property(depends_on=['sample_freq', 'numsamples'])
+    digest = Property(depends_on=['sample_freq', 'num_samples', 'num_channels'])
 
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num):
         """Python generator that yields the output block-wise.
 
@@ -75,19 +87,19 @@ class Generator(HasPrivateTraits):
 class SamplesGenerator(Generator):
     """Interface for any generating multi-channel time domain signal processing block.
 
-    It provides a common interface for all SamplesGenerator classes, which generate an output via the generator :meth:`result`
-    in block-wise manner. This class has no real functionality on its own and should not be used directly.
-    """
+    It provides a common interface for all SamplesGenerator classes, which generate an output via
+    the generator :meth:`result` in block-wise manner. This class has no real functionality on its
+    own and should not be used directly.
 
-    #: Number of channels
-    numchannels = CLong
+    """
 
     # internal identifier
-    digest = Property(depends_on=['sample_freq', 'numchannels', 'numsamples'])
+    digest = Property(depends_on=['sample_freq', 'num_samples', 'num_channels'])
 
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num):
         """Python generator that yields the output block-wise.
 
@@ -100,35 +112,35 @@ class SamplesGenerator(Generator):
         Yields
         ------
         numpy.ndarray
-            The two-dimensional time-data block of shape (num, numchannels).
+            The two-dimensional time-data block of shape (num, num_channels).
         """
 
 
 class SpectraGenerator(Generator):
     """Interface for any generating multi-channel signal frequency domain processing block.
 
-    It provides a common interface for all SpectraGenerator classes, which generate an output via the generator :meth:`result`
-    in block-wise manner. This class has no real functionality on its own and should not be used directly.
-    """
+    It provides a common interface for all SpectraGenerator classes, which generate an output via
+    the generator :meth:`result` in block-wise manner. This class has no real functionality on its
+    own and should not be used directly.
 
-    #: Number of channels
-    numchannels = CLong
+    """
 
     #: Number of frequencies
-    numfreqs = CLong
+    num_freqs = CInt
 
     #: 1-D array of frequencies
     freqs = CArray
 
     #: The length of the block used to calculate the spectra
-    block_size = CLong
+    block_size = CInt
 
     # internal identifier
-    digest = Property(depends_on=['sample_freq', 'numchannels', 'numsamples', 'numfreqs', 'block_size'])
+    digest = Property(depends_on=['sample_freq', 'num_samples', 'num_channels', 'num_freqs', 'block_size'])
 
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num=1):
         """Python generator that yields the output block-wise.
 
@@ -141,16 +153,18 @@ class SpectraGenerator(Generator):
         Yields
         ------
         numpy.ndarray
-            A two-dimensional block of shape (num, numchannels*numfreqs).
+            A two-dimensional block of shape (num, num_channels * num_freqs).
         """
 
 
+@deprecated_alias({'numchannels': 'num_channels', 'numsamples': 'num_samples'}, read_only=True)
 class TimeOut(SamplesGenerator):
-    """Abstract base class for any signal processing block that receives data from any :attr:`source` domain and returns
-    time domain signals.
+    """Abstract base class for any signal processing block that receives data from any
+    :attr:`source` domain and returns time domain signals.
 
-    It provides a base class that can be used to create signal processing blocks that receive data from any
-    generating :attr:`source` and generates a time signal output via the generator :meth:`result` in block-wise manner.
+    It provides a base class that can be used to create signal processing blocks that receive data
+    from any generating :attr:`source` and generates a time signal output via the generator
+    :meth:`result` in block-wise manner.
     """
 
     #: Data source; :class:`~acoular.base.Generator` or derived object.
@@ -160,10 +174,10 @@ class TimeOut(SamplesGenerator):
     sample_freq = Delegate('source')
 
     #: Number of channels in output, as given by :attr:`source`.
-    numchannels = Delegate('source')
+    num_channels = Delegate('source')
 
     #: Number of samples in output, as given by :attr:`source`.
-    numsamples = Delegate('source')
+    num_samples = Delegate('source')
 
     # internal identifier
     digest = Property(depends_on=['source.digest'])
@@ -172,6 +186,7 @@ class TimeOut(SamplesGenerator):
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num):
         """Python generator that processes the source data and yields the time-signal block-wise.
 
@@ -186,18 +201,18 @@ class TimeOut(SamplesGenerator):
         Yields
         ------
         numpy.ndarray
-            Two-dimensional output data block of shape (num, numchannels)
+            Two-dimensional output data block of shape (num, num_channels)
         """
-        yield from self.source.result(num)
 
 
+@deprecated_alias({'numchannels': 'num_channels', 'numsamples': 'num_samples', 'numfreqs': 'num_freqs'}, read_only=True)
 class SpectraOut(SpectraGenerator):
-    """Abstract base class for any signal processing block that receives data from any :attr:`source` domain and
-    returns frequency domain signals.
+    """Abstract base class for any signal processing block that receives data from any
+    :attr:`source` domain and returns frequency domain signals.
 
-    It provides a base class that can be used to create signal processing blocks that receive data from any
-    generating :attr:`source` domain and generates a frequency domain output via the generator :meth:`result`
-    in block-wise manner.
+    It provides a base class that can be used to create signal processing blocks that receive data
+    from any generating :attr:`source` domain and generates a frequency domain output via the
+    generator :meth:`result` in block-wise manner.
     """
 
     #: Data source; :class:`~acoular.base.Generator` or derived object.
@@ -207,13 +222,13 @@ class SpectraOut(SpectraGenerator):
     sample_freq = Delegate('source')
 
     #: Number of channels in output, as given by :attr:`source`.
-    numchannels = Delegate('source')
+    num_channels = Delegate('source')
 
     #: Number of snapshots in output, as given by :attr:`source`.
-    numsamples = Delegate('source')
+    num_samples = Delegate('source')
 
     #: Number of frequencies in output, as given by :attr:`source`.
-    numfreqs = Delegate('source')
+    num_freqs = Delegate('source')
 
     #: 1-D array of frequencies, as given by :attr:`source`.
     freqs = Delegate('source')
@@ -228,6 +243,7 @@ class SpectraOut(SpectraGenerator):
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num=1):
         """Python generator that processes the source data and yields the output block-wise.
 
@@ -240,17 +256,18 @@ class SpectraOut(SpectraGenerator):
         Yields
         ------
         numpy.ndarray
-            A two-dimensional block of shape (num, numchannels*numfreqs).
+            A two-dimensional block of shape (num, num_channels * num_freqs).
         """
-        yield from self.source.result(num)
 
 
+@deprecated_alias({'numchannels': 'num_channels', 'numsamples': 'num_samples'}, read_only=True)
 class InOut(SamplesGenerator, SpectraGenerator):
-    """Abstract base class for any signal processing block that receives data from any :attr:`source` domain and returns
-    signals in the same domain.
+    """Abstract base class for any signal processing block that receives data from any
+    :attr:`source` domain and returns signals in the same domain.
 
-    It provides a base class that can be used to create signal processing blocks that receive data from any
-    generating :attr:`source` and generates an output via the generator :meth:`result` in block-wise manner.
+    It provides a base class that can be used to create signal processing blocks that receive data
+    from any generating :attr:`source` and generates an output via the generator :meth:`result` in
+    block-wise manner.
     """
 
     #: Data source; :class:`~acoular.base.Generator` or derived object.
@@ -260,10 +277,13 @@ class InOut(SamplesGenerator, SpectraGenerator):
     sample_freq = Delegate('source')
 
     #: Number of channels in output, as given by :attr:`source`.
-    numchannels = Delegate('source')
+    num_channels = Delegate('source')
+
+    #: Number of frequencies in output, as given by :attr:`source`.
+    num_freqs = Delegate('source')
 
     #: Number of samples / snapshots in output, as given by :attr:`source`.
-    numsamples = Delegate('source')
+    num_samples = Delegate('source')
 
     # internal identifier
     digest = Property(depends_on=['source.digest'])
@@ -272,6 +292,7 @@ class InOut(SamplesGenerator, SpectraGenerator):
     def _get_digest(self):
         return digest(self)
 
+    @abstractmethod
     def result(self, num):
         """Python generator that processes the source data and yields the output block-wise.
 
@@ -287,7 +308,6 @@ class InOut(SamplesGenerator, SpectraGenerator):
         numpy.ndarray
             Two-dimensional output data block of shape (num, ...)
         """
-        yield from self.source.result(num)
 
 
 class TimeInOut(TimeOut):