sofar 0.3.1__py2.py3-none-any.whl → 1.1.0__py2.py3-none-any.whl

sofar/utils.py

@@ -0,0 +1,315 @@
+import os
+import glob
+import numpy as np
+import numpy.testing as npt
+import warnings
+import sofar as sf
+
+
+def version():
+    """Return version of sofar and SOFA conventions"""
+
+    sofa_conventions = os.path.join(
+        os.path.dirname(__file__), "sofa_conventions", 'VERSION')
+    with open(sofa_conventions) as file:
+        sofa_conventions = file.readline().strip()
+
+    return (f"sofar v{sf.__version__} implementing "
+            f"SOFA standard {sofa_conventions}")
+
+
+def _verify_convention_and_version(version, convention):
+    """
+    Verify if convention and version exist. Raise a Value error if it does not.
+
+    Parameters
+    ----------
+    version : str
+        The version to be checked
+    convention : str
+        The name of the convention to be checked
+    """
+
+    # check if the convention exists
+    if convention not in _get_conventions("name"):
+        raise ValueError(
+            f"Convention '{convention}' does not exist")
+
+    name_version = _get_conventions("name_version")
+
+    # check which version is wanted
+    version_exists = False
+    for versions in name_version:
+        # check if convention and version match
+        if versions[0] == convention \
+                and str(float(versions[1])) == version:
+            version_exists = True
+
+    if not version_exists:
+        raise ValueError((
+            f"{convention} v{version} is not a valid SOFA Convention."
+            "If you are trying to read the data use "
+            "sofar.read_sofa_as_netcdf(). Call sofar.list_conventions() for a "
+            "list of valid Conventions"))
+
+
+def list_conventions():
+    """
+    List available SOFA conventions by printing to the console.
+    """
+    print(_get_conventions("string"))
+
+
+def _get_conventions(return_type, conventions_path=None):
+    """
+    Get available SOFA conventions.
+
+    Parameters
+    ----------
+    return_type : string, optional
+        ``'path'``
+            Return a list with the full paths and filenames of the convention
+            files (json files)
+        ``'path_source'``
+            Return a list with the full paths and filenames of the source
+            convention files from API_MO (csv files)
+        ``'name'``
+            Return a list of the convention names without version
+        ``'name_version'``
+            Return a list of tuples containing the convention name and version.
+        ``'string'``
+            Returns a string that lists the names and versions of all
+            conventions.
+    conventions_path : str, optional
+        The path to the the `conventions` folder containing the csv and json
+        files.
+
+    Returns
+    -------
+    See parameter `return_type`.
+    """
+    # directory containing the SOFA conventions
+    if conventions_path is None:
+        conventions_path = os.path.join(
+            os.path.dirname(__file__), "sofa_conventions", 'conventions')
+
+    reg_str = "*.csv" if return_type == "path_source" else "*.json"
+
+    # SOFA convention files
+    standardized = list(glob.glob(os.path.join(conventions_path, reg_str)))
+    deprecated = list(
+        glob.glob(os.path.join(conventions_path, "deprecated", reg_str)))
+    paths = standardized + deprecated
+
+    conventions_str = "Available SOFA conventions:\n"
+
+    conventions = []
+    versions = []
+    for path in paths:
+        fileparts = os.path.basename(path).split(sep="_")
+        conventions += [fileparts[0]]
+        versions += [fileparts[1][:-5]]
+        conventions_str += f"{conventions[-1]} (Version {versions[-1]})\n"
+
+    if return_type is None:
+        return
+    elif return_type.startswith("path"):
+        return paths
+    elif return_type == "name":
+        return conventions
+    elif return_type == "name_version":
+        return list(zip(conventions, versions))
+    elif return_type == "string":
+        return conventions_str
+    else:
+        raise ValueError(f"return_type {return_type} is invalid")
+
+
+def equals(sofa_a, sofa_b, verbose=True, exclude=None):
+    """
+    Compare two SOFA objects against each other.
+
+    Parameters
+    ----------
+    sofa_a : Sofa
+        SOFA object
+    sofa_b : Sofa
+        SOFA object
+    verbose : bool, optional
+        Print differences to the console. The default is True.
+    exclude : str, optional
+        Specify what fields should be excluded from the comparison
+
+        ``'GLOBAL'``
+            Exclude all global attributes, i.e., fields starting with 'GLOBAL:'
+        ``'DATE'``
+            Exclude date attributs, i.e., fields that contain 'Date'
+        ``'ATTR'``
+            Exclude all attributes, i.e., fields that contain ':'
+
+        The default is None, which does not exclude anything.
+
+    Returns
+    -------
+    is_identical : bool
+        ``True`` if sofa_a and sofa_b are identical, ``False`` otherwise.
+    """
+
+    is_identical = True
+
+    # get and filter keys
+    # ('_*' are SOFA object private variables, '__' are netCDF attributes)
+    keys_a = [k for k in sofa_a.__dict__.keys() if not k.startswith("_")]
+    keys_b = [k for k in sofa_b.__dict__.keys() if not k.startswith("_")]
+
+    if exclude is not None:
+        if exclude.upper() == "GLOBAL":
+            keys_a = [k for k in keys_a if not k.startswith("GLOBAL_")]
+            keys_b = [k for k in keys_b if not k.startswith("GLOBAL_")]
+        elif exclude.upper() == "ATTR":
+            keys_a = [k for k in keys_a if
+                      sofa_a._convention[k]["type"] != "attribute"]
+            keys_b = [k for k in keys_b if
+                      sofa_b._convention[k]["type"] != "attribute"]
+        elif exclude.upper() == "DATE":
+            keys_a = [k for k in keys_a if "Date" not in k]
+            keys_b = [k for k in keys_b if "Date" not in k]
+        else:
+            raise ValueError(
+                f"exclude is {exclude} but must be GLOBAL, DATE, or ATTR")
+
+    # check for equal length
+    if len(keys_a) != len(keys_b):
+        return _equals_raise_warning((
+            f"not identical: sofa_a has {len(keys_a)} attributes for "
+            f"comparison and sofa_b has {len(keys_b)}."), verbose)
+
+    # check if the keys match
+    if set(keys_a) != set(keys_b):
+        return _equals_raise_warning(
+            "not identical: sofa_a and sofa_b do not have the ame attributes",
+            verbose)
+
+    # compare the data inside the SOFA object
+    for key in keys_a:
+
+        # get data and types
+        a = getattr(sofa_a, key)
+        b = getattr(sofa_b, key)
+        type_a = sofa_a._convention[key]["type"]
+        type_b = sofa_b._convention[key]["type"]
+
+        # compare attributes
+        if type_a == "attribute" and type_b == "attribute":
+
+            # compare
+            if a != b:
+                is_identical = _equals_raise_warning(
+                    f"not identical: different values for {key}", verbose)
+
+        # compare double variables
+        elif type_a == "double" and type_b == "double":
+
+            try:
+                npt.assert_allclose(np.squeeze(a), np.squeeze(b))
+            except AssertionError:
+                is_identical = _equals_raise_warning(
+                    "not identical: different values for {key}", verbose)
+
+        # compare string variables
+        elif type_a == "string" and type_b == "string":
+            try:
+                assert np.all(
+                    np.squeeze(a).astype("S") == np.squeeze(b).astype("S"))
+            except AssertionError:
+                is_identical = _equals_raise_warning(
+                    "not identical: different values for {key}", verbose)
+        else:
+            is_identical = _equals_raise_warning(
+                (f"not identical: {key} has different data types "
+                 f"({type_a}, {type_b})"), verbose)
+
+    return is_identical
+
+
+def _equals_raise_warning(message, verbose):
+    if verbose:
+        warnings.warn(message)
+    return False
+
+
+def _atleast_nd(array, ndim):
+    """
+    Get numpy array with specified number of dimensions. Dimensions are
+    appended at the end if ndim > 3.
+    """
+    try:
+        array = array.copy()
+    except AttributeError:
+        array = array
+
+    if ndim == 1:
+        array = np.atleast_1d(array)
+    if ndim == 2:
+        array = np.atleast_2d(array)
+    if ndim >= 3:
+        array = np.atleast_3d(array)
+    for _ in range(ndim - array.ndim):
+        array = array[..., np.newaxis]
+    return array
+
+
+def _nd_newaxis(array, ndim):
+    """Append dimensions to the end of an array until array.ndim == ndim"""
+    array = np.array(array)
+
+    for _ in range(ndim - array.ndim):
+        array = array[..., np.newaxis]
+    return array
+
+
+def _complete_sofa(convention="GeneralTF"):
+    """
+    Generate SOFA file with all required data for testing verification rules.
+    """
+
+    sofa = sf.Sofa(convention)
+    # Listener meta data
+    sofa.add_variable("ListenerView", [1, 0, 0], "double", "IC")
+    sofa.add_attribute("ListenerView_Type", "cartesian")
+    sofa.add_attribute("ListenerView_Units", "metre")
+    sofa.add_variable("ListenerUp", [0, 0, 1], "double", "IC")
+    # Receiver meta data
+    sofa.add_variable("ReceiverView", [1, 0, 0], "double", "IC")
+    sofa.add_attribute("ReceiverView_Type", "cartesian")
+    sofa.add_attribute("ReceiverView_Units", "metre")
+    sofa.add_variable("ReceiverUp", [0, 0, 1], "double", "IC")
+    # Source meta data
+    sofa.add_variable("SourceView", [1, 0, 0], "double", "IC")
+    sofa.add_attribute("SourceView_Type", "cartesian")
+    sofa.add_attribute("SourceView_Units", "metre")
+    sofa.add_variable("SourceUp", [0, 0, 1], "double", "IC")
+    # Emitter meta data
+    sofa.add_variable("EmitterView", [1, 0, 0], "double", "IC")
+    sofa.add_attribute("EmitterView_Type", "cartesian")
+    sofa.add_attribute("EmitterView_Units", "metre")
+    sofa.add_variable("EmitterUp", [0, 0, 1], "double", "IC")
+    sofa.add_attribute("GLOBAL_EmitterDescription", "what an emitter")
+    sofa.add_variable("EmitterDescriptions", ["emitter array"], "string", "MS")
+    # Room meta data
+    sofa.add_attribute("GLOBAL_RoomShortName", "Hall")
+    sofa.add_attribute("GLOBAL_RoomDescription", "Wooden floor")
+    sofa.add_attribute("GLOBAL_RoomLocation", "some where nice")
+    sofa.add_variable("RoomTemperature", 0, "double", "I")
+    sofa.add_attribute("RoomTemperature_Units", "kelvin")
+    sofa.add_attribute("GLOBAL_RoomGeometry", "some/file")
+    sofa.add_variable("RoomVolume", 200, "double", "I")
+    sofa.add_attribute("RoomVolume_Units", "cubic metre")
+    sofa.add_variable("RoomCornerA", [0, 0, 0], "double", "IC")
+    sofa.add_variable("RoomCornerB", [1, 1, 1], "double", "IC")
+    sofa.add_variable("RoomCorners", 0, "double", "I")
+    sofa.add_attribute("RoomCorners_Type", "cartesian")
+    sofa.add_attribute("RoomCorners_Units", "metre")
+
+    sofa.verify()
+    return sofa

{sofar-0.3.1.dist-info → sofar-1.1.0.dist-info}/AUTHORS.rst

@@ -6,6 +6,7 @@ The sofar developers
 --------------------
 
 - Fabian Brinkmann
+- Marco Berzborn
 
 
 Funding

sofar-1.1.0.dist-info/METADATA

@@ -0,0 +1,89 @@
+Metadata-Version: 2.1
+Name: sofar
+Version: 1.1.0
+Summary: Maybe the most complete python package for SOFA files so far
+Home-page: https://pyfar.org/
+Download-URL: https://pypi.org/project/sofar/
+Author: The pyfar developers
+Author-email: info@pyfar.org
+License: MIT license
+Project-URL: Bug Tracker, https://github.com/pyfar/sofar/issues
+Project-URL: Documentation, https://sofar.readthedocs.io/
+Project-URL: Source Code, https://github.com/pyfar/sofar
+Keywords: sofar
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+License-File: LICENSE
+License-File: AUTHORS.rst
+Requires-Dist: netCDF4
+Requires-Dist: numpy (>=1.14.0)
+Requires-Dist: beautifulsoup4
+Requires-Dist: requests
+
+======
+Readme
+======
+
+Sofar is maybe the most complete Python package for the SOFA file format so
+far. SOFA files store spatially distributed acoustic data such as impulse
+responses or transfer functions. They are defined by the AES69-2022 standard
+(see references). These are the key features of sofar
+
+* Uses a complete definition of the AES69-2022 standard (see references) maintained at `sofa_conventions`_
+* Read, edit, and write SOFA files
+* Add custom attributes to SOFA files
+* Full Verification of the content of a SOFA files against AES69-2022
+* Upgrade data that uses outdated SOFA conventions
+* Open license allows unrestricted use
+* sofar is tested using continuous integration on
+
+Installation
+============
+
+Use pip to install sofar
+
+.. code-block:: console
+
+    $ pip install sofar
+
+(Requires Python >= 3.8)
+
+Getting Started
+===============
+
+Check out `read the docs`_ for example use cases a quick introduction to SOFA
+and sofar, and the complete documentation. A more detailed introduction to SOFA
+is given by Majdak et. al. 2022 (see references below) Packages related to
+sofar are listed at `pyfar.org`_. For more information on the SOFA file format
+visit `sofaconventions.org`_.
+
+Contributing
+============
+
+Refer to the `contribution guidelines`_ for more information.
+
+.. _sofa_conventions : https://github.com/pyfar/sofa_conventions
+.. _contribution guidelines: https://github.com/pyfar/sofar/blob/develop/CONTRIBUTING.rst
+.. _pyfar.org: https://pyfar.org
+.. _read the docs: https://sofar.readthedocs.io/en/latest
+.. _sofaconventions.org: https://sofaconventions.org
+
+References
+==========
+
+AES69-2022: *AES standard for file exchange - Spatial acoustic data file
+format*, Audio Engineering Society, Inc., New York, NY, USA.
+(https://www.aes.org/publications/standards/search.cfm?docID=99)
+
+P. Majdak, F. Zotter, F. Brinkmann, J. De Muynke, M. Mihocic, and M.
+Noisternig, "Spatially Oriented Format for Acoustics 2.1: Introduction and
+Recent Advances", *J. Audio Eng. Soc.*, vol. 70, no. 7/8, pp. 565-584,
+Jul. 2022. DOI: https://doi.org/10.17743/jaes.2022.0026

sofar-1.1.0.dist-info/RECORD

@@ -0,0 +1,75 @@
+sofar/__init__.py,sha256=aCj2m61sjgjlh0_kcGsZXm_cnKmlx5c-tQ5iEGvDjE4,595
+sofar/io.py,sha256=XdkfG6jo4RI8JqUgXEfx2ka06_CfffPJXs0HqeMSri0,15761
+sofar/sofa.py,sha256=QVr0UKr-aqo2K7_PEHtXk9VuvrjE36QgcYIqFJ6KBrc,68255
+sofar/update_conventions.py,sha256=36ba0cAVtKppJCrsEhP2aiv1DGEtxNx06hsUAERDlwM,16753
+sofar/utils.py,sha256=0JwYLLyVu1ZcAfUQKSucywcQPlHB2Ojez7fxIXhuaFw,10754
+sofar/sofa_conventions/VERSION,sha256=IuQRql5P3qfPUQuJwuh-RX5TvI_Wd4bDdSm8VLNQqds,34
+sofar/sofa_conventions/conventions/FreeFieldDirectivityTF_1.1.csv,sha256=Wait37FTh6ROKgpX7-JsVM-ohtKfsdHjxVL5vN7uTTs,5510
+sofar/sofa_conventions/conventions/FreeFieldDirectivityTF_1.1.json,sha256=sm8Pj_Z1n1tW2jYlu00eikR3yCcANEm_Kw5Eq9jrbw4,13138
+sofar/sofa_conventions/conventions/FreeFieldHRIR_1.0.csv,sha256=C_fc7wHjBLc2krPja33sQaDSZDvlr80GSsgOj904GBY,2479
+sofar/sofa_conventions/conventions/FreeFieldHRIR_1.0.json,sha256=-777Wo-fgKq844AwxIlompmIF9rHLRXWIAJjgaqADdU,8127
+sofar/sofa_conventions/conventions/FreeFieldHRTF_1.0.csv,sha256=BbE417cDQ6eQ8UFl3MVWv9SatQ2OHZ7UF7u_ZCfCoBk,2222
+sofar/sofa_conventions/conventions/FreeFieldHRTF_1.0.json,sha256=aN7x7UU-HkT5a-cVmJ29IXP1h_8DFsyInsbWFm65oVk,7996
+sofar/sofa_conventions/conventions/GeneralFIR-E_2.0.csv,sha256=daSPbImANSYn5rIHQkn6fdD3kE0Z-wq9iyCGfMEroGY,1998
+sofar/sofa_conventions/conventions/GeneralFIR-E_2.0.json,sha256=ERs0oQrZL2JLQOcFE7umPIOIMqm2pQy_lOA8UPtLg18,6615
+sofar/sofa_conventions/conventions/GeneralFIR_1.0.csv,sha256=HInvJ980U9wtu2QUT9JZ3rUlR7Qfi2yzgZb4j3q6n58,2011
+sofar/sofa_conventions/conventions/GeneralFIR_1.0.json,sha256=dmVz1aTMv-9EKO9NwzTbWq-QU-uOa9d-zhS4ScKhDLU,7054
+sofar/sofa_conventions/conventions/GeneralSOS_1.0.csv,sha256=3JzYYRULpd8WmCC0Mze6wTzr7PluwEjy6lxt74VDsow,2130
+sofar/sofa_conventions/conventions/GeneralSOS_1.0.json,sha256=3FYXzhcb2jJFjlKFlF60Uv_82boZUNbfSVlS54It8xM,7357
+sofar/sofa_conventions/conventions/GeneralTF-E_1.0.csv,sha256=lztME1Skiac-Bj1OctWuQ05_THozrPzil6a01F9PufI,2015
+sofar/sofa_conventions/conventions/GeneralTF-E_1.0.json,sha256=bQZn8O67anSvZJgo7PkIP9TaPprBlhqPmzpp6dy8LQY,6757
+sofar/sofa_conventions/conventions/GeneralTF_1.0.csv,sha256=RD1aXHuRIECKkHDZm0cLyRp-m32-hg_hRxNegdJnttc,1956
+sofar/sofa_conventions/conventions/GeneralTF_1.0.json,sha256=mPbpQcfEeJt2lKJODGgEgusDOzLU3HbmD3Fr6LbXnt0,6696
+sofar/sofa_conventions/conventions/GeneralTF_2.0.csv,sha256=8fpM1wnY4YL9DbIwstrU5UCokh9rheiookSJYSMqKR8,1957
+sofar/sofa_conventions/conventions/GeneralTF_2.0.json,sha256=pn6V2AVJum8y0L0cpn3Kt5ostsmErjcF41_XeiPdk88,6699
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRIR_1.0.csv,sha256=gZ_jA2hAdetCxgV3P-I9T3QTG7hNwogon0r1pKpv8iM,2239
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRIR_1.0.json,sha256=ScZn_Jf9AI1o6gyFcdl5xFzdnvSfuMcdyG9GH5eOdDc,8446
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRSOS_1.0.csv,sha256=YXI6K_HiGH6wVTr3QIUhhtKQRKD3uUaj56D6xzCYUzE,2303
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRSOS_1.0.json,sha256=dG_O9QiWYrB8IkZD-z3W1GUJw8E_c7NT5CN4xOmhhwk,8254
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRTF_1.0.csv,sha256=x7fyeLrub2clGMszUtv6v9lg2cF8hI-FzeAqJEimXyc,2015
+sofar/sofa_conventions/conventions/SimpleFreeFieldHRTF_1.0.json,sha256=HFNW4_1A3t1M6geUTUVLZrf7sAmhy59T47d__YXdylM,7791
+sofar/sofa_conventions/conventions/SimpleFreeFieldSOS_1.0.csv,sha256=YphFfFEwTSosaYOTbUv2gz-Pb5yrQv7AFVZuXh-WUjM,2298
+sofar/sofa_conventions/conventions/SimpleFreeFieldSOS_1.0.json,sha256=SILNWPWs3JFVtnDvKDpyZ3RBGboD8SWaqmaT83EUb7w,8249
+sofar/sofa_conventions/conventions/SimpleHeadphoneIR_1.0.csv,sha256=7B_ijKN7AVftugYTvCCM8n76ofs8gCWkBvFc_9D-STk,3103
+sofar/sofa_conventions/conventions/SimpleHeadphoneIR_1.0.json,sha256=pUUme-CuoipR06Yi26yfntWwMMWs7wrriqseg6NPK2M,9863
+sofar/sofa_conventions/conventions/SingleRoomMIMOSRIR_1.0.csv,sha256=2OzG5t9rYzDrywP__99ylHmyAM9Mjx758jO5dudv0Jc,4053
+sofar/sofa_conventions/conventions/SingleRoomMIMOSRIR_1.0.json,sha256=5tjPriXZk8WEIr15i41L7hQRwAxzw_gA0nxWkZfe_7g,14346
+sofar/sofa_conventions/conventions/SingleRoomSRIR_1.0.csv,sha256=l7aeLNxbOyXgfQIjCo3QzpRpBonMp9ssfhps4fejHxc,4199
+sofar/sofa_conventions/conventions/SingleRoomSRIR_1.0.json,sha256=gVwyzGni9e3w5wehnxe6Oe5knO2Np5doHYLzRsfrlfc,14491
+sofar/sofa_conventions/conventions/deprecated/FreeFieldDirectivityTF_1.0.csv,sha256=Ha6178_LxRod-L2UcI7SX3o6Cf1YRFs1zgIpn0kd0rA,5125
+sofar/sofa_conventions/conventions/deprecated/FreeFieldDirectivityTF_1.0.json,sha256=GcOb3cbv63C7S4cJ7IVvU7NAAd1h8mA7RHaAFQ_jqz8,12627
+sofar/sofa_conventions/conventions/deprecated/GeneralFIRE_1.0.csv,sha256=2_ed7Y0CGJmCx9V3X7L4gipJ94nLzH7Jl9fXXtI7rLQ,1988
+sofar/sofa_conventions/conventions/deprecated/GeneralFIRE_1.0.json,sha256=y3A1fhyS4XUAIbEGv92pwrYp01HutgIKajI4WmJYYKQ,6603
+sofar/sofa_conventions/conventions/deprecated/MultiSpeakerBRIR_0.3.csv,sha256=E_jW15CNWUsp5W9Uw2EbNNyvDxDMFvs-CAELDmYtp0I,2560
+sofar/sofa_conventions/conventions/deprecated/MultiSpeakerBRIR_0.3.json,sha256=PBC2SOliEORqJpuSweO77_tePFBVVoJ6zZ_COUNrZME,8884
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldHRIR_0.4.csv,sha256=WQRiDw51jZK9yGyfCtUVGpKbi0FMl-BtG2yn-5s5AME,2093
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldHRIR_0.4.json,sha256=sGWA33puXRpPmoMOZfBT0SgbLGIJIACNcxsJdACmKKY,7704
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldTF_0.4.csv,sha256=lHINbpcuvHBNsAOL6KGWPy3SMEHorFcovgafXivBt0w,1989
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldTF_0.4.json,sha256=RIAUjtb5QvLn3dny_b4uxdsHXD0nkxbK49w4RiJslJI,7770
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldTF_1.0.csv,sha256=nzm1DDWj3blCljLFQZ1K2OU_GKgkW9x0Ow638aL_cys,2028
+sofar/sofa_conventions/conventions/deprecated/SimpleFreeFieldTF_1.0.json,sha256=aXc5prNxJslNt6ESYACRHhzUxMWa80rDhvChRxGSoDM,7770
+sofar/sofa_conventions/conventions/deprecated/SimpleHeadphoneIR_0.1.csv,sha256=eADQZ2qv5odeUMQsgc8YZQQA5sRN-2M3Ym5LnGrbI_E,3153
+sofar/sofa_conventions/conventions/deprecated/SimpleHeadphoneIR_0.1.json,sha256=5AUrkT4s-FMFkqbVEiak7YKugtzwb0iU7o3XuYbNtYs,9870
+sofar/sofa_conventions/conventions/deprecated/SimpleHeadphoneIR_0.2.csv,sha256=sBlw9J3Clix0b7aPRo-uQntM43pqBlqSG00OHJ_i7OM,3153
+sofar/sofa_conventions/conventions/deprecated/SimpleHeadphoneIR_0.2.json,sha256=fHK0c3DUTvAUxOAKC1LuJZlxSyKoSjF0HpJkkpUYCyA,9870
+sofar/sofa_conventions/conventions/deprecated/SingleRoomDRIR_0.2.csv,sha256=JsPEm-KgQ_b_2nGzVys4jnJTSedSQtcoOk1x31ycqLE,2045
+sofar/sofa_conventions/conventions/deprecated/SingleRoomDRIR_0.2.json,sha256=oR-qubagKs28ICI7243Ep2zX0AFn_8lvYPNPseg16O8,8097
+sofar/sofa_conventions/conventions/deprecated/SingleRoomDRIR_0.3.csv,sha256=l6PAKjsNuaFHVUlT4rVdZY9Pj7nh_jF8d82i5YSbkss,1999
+sofar/sofa_conventions/conventions/deprecated/SingleRoomDRIR_0.3.json,sha256=ccCvFNWYwATIRCPxQke73ckogc2Y3hBP97_JOtPusns,8097
+sofar/sofa_conventions/rules/deprecations.json,sha256=hyq112XNfojROZsAEbcV7EOLin-xaTiNi4o4WdplS74,453
+sofar/sofa_conventions/rules/rules.json,sha256=iH8e5UUVRQcGZ_AoULk4A2IiAT1yK7R2CvRQyCMYhYA,22501
+sofar/sofa_conventions/rules/unit_aliases.json,sha256=QXgOfpe8bnmUybVhSSj3nIUYw50CAVehh7sdFNPFl0k,212
+sofar/sofa_conventions/rules/upgrade.json,sha256=viHPPqBaPblE-fY8BOuVUraQYrBhckrS3w5XKqHCTIE,5167
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/test_deprecations.py,sha256=coHOEq5XUquYxRge8XKeg005M84wcgSHTEE--CoEar4,584
+tests/test_io.py,sha256=xMBdWP3vdnk_6aYAhg30nEgGvPfYm30a1qouGHIwRNo,11808
+tests/test_sofa.py,sha256=DpiI517T-gLoajy9nQCHT7ouxM40JwirsqkVMFT5cWo,11314
+tests/test_sofa_upgrade_conventions.py,sha256=HqIuvFFub1_HCH6qHTLPcPyBZ2ayDKzmZR7RwnTxo_o,3377
+tests/test_sofa_verify.py,sha256=cleTkFJurJfDEZrnSTfBYe2VqsCZ1VxWr9efNGjWr88,15631
+tests/test_utils.py,sha256=yT290xCaeDW4l3DHUeFGiVmLe9xMguETN1NAGRTJ-X4,8307
+sofar-1.1.0.dist-info/AUTHORS.rst,sha256=JGcf9PJwl0w14PgTRjI3HXpcwDbkGbUN4mkYoZ8smL8,164
+sofar-1.1.0.dist-info/LICENSE,sha256=qdGH_RUPveBBfGYShm6OIBd6bRJdwp3fDCpjMsowmqA,1068
+sofar-1.1.0.dist-info/METADATA,sha256=brotqjwBrvQqE3_i4ncZSatGgM0B5IOx49trmGmqH-c,3168
+sofar-1.1.0.dist-info/WHEEL,sha256=a-zpFRIJzOq5QfuhBzbhiA1eHTzNCJn8OdRvhdNX0Rk,110
+sofar-1.1.0.dist-info/top_level.txt,sha256=2JSMmeQ5zeMumFynTJU1oODh09wxSiN3gFpsY-bNsSo,12
+sofar-1.1.0.dist-info/RECORD,,

{sofar-0.3.1.dist-info → sofar-1.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.33.6)
+Generator: bdist_wheel (0.40.0)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any

{sofar-0.3.1.dist-info → sofar-1.1.0.dist-info}/top_level.txt

@@ -1 +1,2 @@
 sofar
+tests

tests/test_deprecations.py

@@ -0,0 +1,19 @@
+import pytest
+from packaging import version
+import re
+import sofar as sf
+
+
+# deprecate in 1.3.0 ----------------------------------------------------------
+def test_pad_zero_modi():
+    with pytest.warns(
+            UserWarning,
+            match=re.escape('Sofa.info() will be deprecated in sofar 1.3.0')):
+        sofa = sf.Sofa('GeneralTF')
+        sofa.info()
+
+    if version.parse(sf.__version__) >= version.parse('1.3.0'):
+        with pytest.raises(ValueError):
+            # remove Sofa.info() from pyfar 1.3.0!
+            sofa = sf.Sofa('GeneralTF')
+            sofa.info()