feat: overall level and level over time

doc/changelog.d/201.added.md

@@ -0,0 +1 @@
+feat: overall level and level over time

doc/source/api/index.rst

@@ -12,6 +12,7 @@ This section describes how to use Python to interact programmatically with PyAns
     signal_processing
     spectral_processing
     spectrogram_processing
+    standard_levels
     sound_composer
     sound_power
     psychoacoustics

doc/source/api/standard_levels.rst

@@ -0,0 +1,10 @@
+Standard levels
+---------------
+
+.. module:: ansys.sound.core.standard_levels
+
+.. autosummary::
+    :toctree: _autosummary
+
+    OverallLevel
+    LevelOverTime

src/ansys/sound/core/_pyansys_sound.py

@@ -26,6 +26,8 @@
 from ansys.dpf.core import FieldsContainer
 import numpy as np
 
+REFERENCE_ACOUSTIC_PRESSURE = 2e-5
+
 
 class PyAnsysSound:
     """

src/ansys/sound/core/standard_levels/__init__.py

@@ -0,0 +1,36 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Standard level classes.
+
+Helper classes related to the computation of standard levels.
+"""
+
+from ._standard_levels_parent import StandardLevelsParent
+from .level_over_time import LevelOverTime
+from .overall_level import OverallLevel
+
+__all__ = (
+    "StandardLevelsParent",
+    "OverallLevel",
+    "LevelOverTime",
+)

src/ansys/sound/core/standard_levels/_standard_levels_parent.py

@@ -0,0 +1,35 @@
+# Copyright (C) 2023 - 2025 ANSYS, Inc. and/or its affiliates.
+# SPDX-License-Identifier: MIT
+#
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Standard levels parent class."""
+from .._pyansys_sound import PyAnsysSound
+
+DICT_SCALE = {"dB": 0, "RMS": 1}
+DICT_FREQUENCY_WEIGHTING = {"": 0, "A": 1, "B": 2, "C": 3}
+
+
+class StandardLevelsParent(PyAnsysSound):
+    """
+    Abstract base class for standard level calculations.
+
+    This is the base class for all standard level classes and should not be used as is.
+    """