[FEATURE] RoomAnalysis class for monaural room impulse response parameters calculation.

.gitignore

@@ -3,11 +3,11 @@
 
 # Data files
 *.pkl
-*.mat
-*.pytta
-*.hdf5
-*.json
-*.wav
+#*.mat
+#*.pytta
+#*.hdf5
+#*.json
+#*.wav
 *.txt
 
 # All the python stuff

README.md

@@ -16,6 +16,7 @@
 </a>
 </p>
 
+
 ## PyTTa (Python in Technical Acoustics)
 
 The project began as an effort to create audio, acoustics, and vibration data acquiring and analysis toolbox to a free cost level, high-end results, combining the passion for programming with the expertise in Acoustics and Vibration of the Acoustics Engineers from the Federal University of Santa Maria (Southern Brazil).

examples/roomparameters.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Room Parameters.
+
+Demonstration of how to use the new RoomParameters class.
+
+@author: João Vitor Gutkoski Paes.
+"""
+import pytta
+
+
+# myMonoIR = pytta.load("SOME_SAVED_SIGNALOBJ_WITH_IR.hdf5")
+myMonoIR = pytta.read_wav("RIS/scene9_RIR_LS1_MP1_Dodecahedron.wav")
+
+
+room = pytta.RoomAnalysis(myMonoIR, nthOct=3, minFreq=50., maxFreq=16e3)
+
+
+print()
+print("Parameters from impulse response are:")
+print("\n", room.parameters, "\n")
+print("Access directly by RoomAnalysis().PNAME")
+print("Or view it in a bar plot by RoomAnalysis().plot_PNAME")
+print("where PNAME is the name of the desired parameter, as shown above.")
+print()
+print(f"{room.T20=}")
+
+
+fig = room.plot_EDT()
+fig.show()

pytta/__init__.py

@@ -66,7 +66,7 @@
     * pytta.generate:
         functions for signal synthesis and measurement configuration;
 
-    * pytta.rooms:
+    * pytta.rooms (DEPRECATED):
         room acoustics parameters calculation according to ISO 3382-1;
 
     * pytta.iso3741:
@@ -100,7 +100,7 @@
     Measurement, RecMeasure, PlayRecMeasure, FRFMeasure,\
     Streaming, Monitor,\
     OctFilter, weighting,\
-    Analysis
+    Analysis, RoomAnalysis
 
 from . import _h5utils
 from . import _plot
@@ -120,7 +120,7 @@
 
 from .apps import roomir
 
-__version__ = '0.1.0'  # package version
+__version__ = '0.1.1'  # package version
 
 # package submodules and scripts to be called as pytta.something
 __all__ = [  # Apps
@@ -163,6 +163,7 @@
            'SignalObj',
            'ImpulsiveResponse',
            'Analysis',
+           'RoomAnalysis',
            'OctFilter',
            'Monitor',
            'Streaming',

pytta/classes/__init__.py

@@ -41,12 +41,13 @@
 from .measurement import Measurement, RecMeasure, PlayRecMeasure, FRFMeasure
 from .streaming import Streaming, Monitor
 from .filter import OctFilter, weighting
-from .analysis import Analysis
+from .analysis import Analysis, RoomAnalysis
 
 __all__ = [# Classes
            'SignalObj',
            'ImpulsiveResponse',
            'Analysis',
+           'RoomAnalysis',
            'RecMeasure',
            'PlayRecMeasure',
            'FRFMeasure',

pytta/classes/_instanceinfo.py

@@ -26,7 +26,7 @@ class RememberInstanceCreationInfo:
     def __init__(self):
         for frame, _ in traceback.walk_stack(None):
             varnames = frame.f_code.co_varnames
-            if varnames is ():
+            if varnames == ():
                 break
             if frame.f_locals[varnames[0]] not in (self, self.__class__):
                 break