sofar


Namesofar JSON
Version 1.2.1 PyPI version JSON
download
home_pageNone
SummaryMaybe the most complete python package for SOFA files so far.
upload_time2024-12-12 16:06:53
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT License Copyright (c) 2021, The pyfar developers 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.
keywords acoustics pyfar
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1 align="center">
<img src="https://github.com/pyfar/gallery/raw/main/docs/resources/logos/pyfar_logos_fixed_size_sofar.png" width="300">
</h1><br>

[![PyPI version](https://badge.fury.io/py/sofar.svg)](https://badge.fury.io/py/sofar)
[![Documentation Status](https://readthedocs.org/projects/sofar/badge/?version=latest)](https://sofar.readthedocs.io/en/latest/?badge=latest)
[![CircleCI](https://circleci.com/gh/pyfar/sofar.svg?style=shield)](https://circleci.com/gh/pyfar/sofar)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/pyfar/gallery/main?labpath=docs/gallery/interactive/sofar_introduction.ipynb)

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

- 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
- Uses a complete definition of the AES69-2022 standard (see references) maintained at [sofa_conventions](https://github.com/pyfar/sofa_conventions)

Getting Started
===============

The [sofar and SOFA notebook](https://pyfar-gallery.readthedocs.io/en/latest/gallery/interactive/sofar_introduction.html)
gives an overview of the most important sofar functionality and is a good starting point. For processing and visualizing data
inside SOFA files, we recommend the [pyfar package](https://pyfar.readthedocs.io) that can read SOFA files through
`pyfar.io.read_sofa` and the in-depth examples contained in the
[pyfar example gallery](https://pyfar-gallery.readthedocs.io/en/latest/examples_gallery.html). Check out
[read the docs](https://sofar.readthedocs.io) for a complete documentation of sofar. A more detailed introduction to the SOFA
file format is given by Majdak et. al. 2022 (see references below). All information is also bundled at [pyfar.org](https://pyfar.org).

Installation
============

Use pip to install sofar

    pip install sofar


(Requires Python >= 3.8)

If the installation fails, please check out the [help section](https://pyfar-gallery.readthedocs.io/en/latest/help).

Contributing
============

Refer to the [contribution guidelines](https://sofar.readthedocs.io/en/stable/contributing.html) for more information.

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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sofar",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "acoustics, pyfar",
    "author": null,
    "author_email": "The pyfar developers <info@pyfar.org>",
    "download_url": "https://files.pythonhosted.org/packages/5c/b1/62ee2f24e99e2b0f26f0a0eb78950053f5513624e2948433a6fa8ed32170/sofar-1.2.1.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\">\n<img src=\"https://github.com/pyfar/gallery/raw/main/docs/resources/logos/pyfar_logos_fixed_size_sofar.png\" width=\"300\">\n</h1><br>\n\n[![PyPI version](https://badge.fury.io/py/sofar.svg)](https://badge.fury.io/py/sofar)\n[![Documentation Status](https://readthedocs.org/projects/sofar/badge/?version=latest)](https://sofar.readthedocs.io/en/latest/?badge=latest)\n[![CircleCI](https://circleci.com/gh/pyfar/sofar.svg?style=shield)](https://circleci.com/gh/pyfar/sofar)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/pyfar/gallery/main?labpath=docs/gallery/interactive/sofar_introduction.ipynb)\n\nSofar is maybe the most complete Python package for the SOFA file format so\nfar. SOFA files store spatially distributed acoustic data such as impulse\nresponses or transfer functions. They are defined by the AES69-2022 standard\n(see references). These are the key features of sofar\n\n- Read, edit, and write SOFA files\n- Add custom attributes to SOFA files\n- Full Verification of the content of a SOFA files against AES69-2022\n- Upgrade data that uses outdated SOFA conventions\n- Open license allows unrestricted use\n- sofar is tested using continuous integration on\n- Uses a complete definition of the AES69-2022 standard (see references) maintained at [sofa_conventions](https://github.com/pyfar/sofa_conventions)\n\nGetting Started\n===============\n\nThe [sofar and SOFA notebook](https://pyfar-gallery.readthedocs.io/en/latest/gallery/interactive/sofar_introduction.html)\ngives an overview of the most important sofar functionality and is a good starting point. For processing and visualizing data\ninside SOFA files, we recommend the [pyfar package](https://pyfar.readthedocs.io) that can read SOFA files through\n`pyfar.io.read_sofa` and the in-depth examples contained in the\n[pyfar example gallery](https://pyfar-gallery.readthedocs.io/en/latest/examples_gallery.html). Check out\n[read the docs](https://sofar.readthedocs.io) for a complete documentation of sofar. A more detailed introduction to the SOFA\nfile format is given by Majdak et. al. 2022 (see references below). All information is also bundled at [pyfar.org](https://pyfar.org).\n\nInstallation\n============\n\nUse pip to install sofar\n\n    pip install sofar\n\n\n(Requires Python >= 3.8)\n\nIf the installation fails, please check out the [help section](https://pyfar-gallery.readthedocs.io/en/latest/help).\n\nContributing\n============\n\nRefer to the [contribution guidelines](https://sofar.readthedocs.io/en/stable/contributing.html) for more information.\n\nReferences\n==========\n\nAES69-2022: *AES standard for file exchange - Spatial acoustic data file\nformat*, Audio Engineering Society, Inc., New York, NY, USA.\n(https://www.aes.org/publications/standards/search.cfm?docID=99)\n\nP. Majdak, F. Zotter, F. Brinkmann, J. De Muynke, M. Mihocic, and M.\nNoisternig, \"Spatially Oriented Format for Acoustics 2.1: Introduction and\nRecent Advances\", *J. Audio Eng. Soc.*, vol. 70, no. 7/8, pp. 565-584,\nJul. 2022. DOI: https://doi.org/10.17743/jaes.2022.0026\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2021, The pyfar developers  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.  ",
    "summary": "Maybe the most complete python package for SOFA files so far.",
    "version": "1.2.1",
    "project_urls": {
        "Changelog": "https://github.com/pyfar/sofar/blob/main/HISTORY.rst",
        "Documentation": "https://sofar.readthedocs.io/",
        "Download": "https://pypi.org/project/sofar/",
        "Homepage": "https://pyfar.org/",
        "Source": "https://github.com/pyfar/sofar",
        "Tracker": "https://github.com/pyfar/sofar/issues"
    },
    "split_keywords": [
        "acoustics",
        " pyfar"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "21811aa5e415352b596868c9b64624cebcc1748121d7832438ebb4d3fc84cba0",
                "md5": "9d25ab8a3400c510d30ac73d8089bffb",
                "sha256": "dc2b7ba8be077a45001d02c4515dd61dc702ecd42aabd2db6428992d31622e30"
            },
            "downloads": -1,
            "filename": "sofar-1.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9d25ab8a3400c510d30ac73d8089bffb",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 439643,
            "upload_time": "2024-12-12T16:06:49",
            "upload_time_iso_8601": "2024-12-12T16:06:49.567907Z",
            "url": "https://files.pythonhosted.org/packages/21/81/1aa5e415352b596868c9b64624cebcc1748121d7832438ebb4d3fc84cba0/sofar-1.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5cb162ee2f24e99e2b0f26f0a0eb78950053f5513624e2948433a6fa8ed32170",
                "md5": "e7cf6f5e29e776a3884fb0b422adecf1",
                "sha256": "4450a34588500815f726e153c74c0edfab4773db5ff4d9e4eace23c4556ada90"
            },
            "downloads": -1,
            "filename": "sofar-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "e7cf6f5e29e776a3884fb0b422adecf1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 382643,
            "upload_time": "2024-12-12T16:06:53",
            "upload_time_iso_8601": "2024-12-12T16:06:53.058125Z",
            "url": "https://files.pythonhosted.org/packages/5c/b1/62ee2f24e99e2b0f26f0a0eb78950053f5513624e2948433a6fa8ed32170/sofar-1.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-12 16:06:53",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "pyfar",
    "github_project": "sofar",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "circle": true,
    "lcname": "sofar"
}
        
Elapsed time: 4.82643s