| Name | pyatsyn JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | |
| Summary | python-based implementation of Analysis-Synthesis-Transformation (ATS) spectral music system |
| upload_time | 2023-01-22 19:55:09 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.6 |
| license | BSD-3-Clause |
| keywords |
spectral
audio
dsp
synthesis
music
sound
analysis
ats
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ABOUT pyatsyn
pyatsyn is a python implementation of the Analysis-Transformation-Synthesis (ATS) spectral modeling system.
Analysis, Transformation and Synthesis (ATS) is a spectral modeling system based on a sinusoidal plus critical-band noise decomposition. The system can be used to analyze recorded sounds, transform their spectrum using a wide variety of algorithms and resynthesize them both out of time and in real time.
[pyatsyn Documentation at readthedocs.io](https://pyatsyn.readthedocs.io/)
---
pyatsyn Copyright (c) <2023>, Johnathan G Lyon
All rights reserved.
Except where otherwise noted, ATSA and ATSH is Copyright (c) <2002-2004>
Oscar Pablo Di Liscia, Pete Moss, and Juan Pampin
This source code is licensed under the BSD-style license found in the
LICENSE.rst file in the root directory of this source tree.
---
# INSTALLATION
requires python 3.6+
developed/tested on python 3.9.15 using M1 Mac running macOS 13.0.1
requires LIBSNDFILE
for Mac (assuming Homebrew is installed): ```$ brew install libsndfile```
for Debian: ```$ apt-get install libsndfile-dev```
install via the PyPi repository
```
$ pip install pyatsyn
```
# included command line utilities
```
$ pyatsyn-atsa --help
$ pyatsyn-info --help
$ pyatsyn-synth --help
```
Example command line usage to generate an ats file with residual:
```
$ pyatsyn-atsa example.wav example.ats -v -r example-residual.wav
```
Example to print information about a .ats file to stdout:
```
$ pyatsyn-info example.ats
```
Example to synthesize the result using a sine-generator bank:
```
$ pyatsyn-synth example.ats synthesized.wav
```
Example to synthesize the result a sine-generator bank and w/ band-limited noise synthesis for the residual:
```
$ pyatsyn-synth example.ats synthesized_w_noise.wav --noise 1.0
```
---
# for Developers, if using from source
```
$ git clone https://github.com/boxofbox/pyatsyn
```
i recommend running in a virtual environment from within the project base directory
```
$ cd pyatsyn
$ python -m venv .venv
$ source .venv/bin/activate
```
python libraries required:
```
$ pip install numpy
$ pip install soundfile
```
optional documentation generation requires:
```
$pip install sphinx
$pip install sphinx_rtd_theme
```
may need to be run as a package in development mode
(from within the outermost pyatsyn directory containing the pyproject.toml file)
```
$ pip install -e .
```
If you are a newcomer to ATS, we recommend you start by looking at pyatsn/atsa/tracker.py
Raw data
{
"_id": null,
"home_page": "",
"name": "pyatsyn",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "spectral,audio,dsp,synthesis,music,sound,analysis,ats",
"author": "",
"author_email": "\"Johnathan G. Lyon\" <johnathanglyon@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/9c/4f/af3830f6433b3ca904fe591424a9703c8ef2e8120e4bd468f41aa0cfb434/pyatsyn-1.0.0.tar.gz",
"platform": null,
"description": "\n\n\n# ABOUT pyatsyn\n\npyatsyn is a python implementation of the Analysis-Transformation-Synthesis (ATS) spectral modeling system.\n\nAnalysis, Transformation and Synthesis (ATS) is a spectral modeling system based on a sinusoidal plus critical-band noise decomposition. The system can be used to analyze recorded sounds, transform their spectrum using a wide variety of algorithms and resynthesize them both out of time and in real time.\n\n[pyatsyn Documentation at readthedocs.io](https://pyatsyn.readthedocs.io/)\n\n---\n\npyatsyn Copyright (c) <2023>, Johnathan G Lyon\nAll rights reserved.\n\nExcept where otherwise noted, ATSA and ATSH is Copyright (c) <2002-2004>\nOscar Pablo Di Liscia, Pete Moss, and Juan Pampin\n\nThis source code is licensed under the BSD-style license found in the\nLICENSE.rst file in the root directory of this source tree. \n\n---\n\n# INSTALLATION\n\nrequires python 3.6+\ndeveloped/tested on python 3.9.15 using M1 Mac running macOS 13.0.1\n\nrequires LIBSNDFILE\n\nfor Mac (assuming Homebrew is installed): ```$ brew install libsndfile```\nfor Debian: ```$ apt-get install libsndfile-dev```\n\ninstall via the PyPi repository\n\n```\n$ pip install pyatsyn\n```\n\n# included command line utilities\n\n```\n$ pyatsyn-atsa --help\n$ pyatsyn-info --help\n$ pyatsyn-synth --help\n```\n\nExample command line usage to generate an ats file with residual:\n\n```\n$ pyatsyn-atsa example.wav example.ats -v -r example-residual.wav\n```\n\nExample to print information about a .ats file to stdout:\n\n```\n$ pyatsyn-info example.ats\n``` \n\nExample to synthesize the result using a sine-generator bank:\n\n```\n$ pyatsyn-synth example.ats synthesized.wav\n```\n\nExample to synthesize the result a sine-generator bank and w/ band-limited noise synthesis for the residual:\n\n```\n$ pyatsyn-synth example.ats synthesized_w_noise.wav --noise 1.0\n```\n\n---\n\n# for Developers, if using from source\n\n```\n$ git clone https://github.com/boxofbox/pyatsyn\n```\n\ni recommend running in a virtual environment from within the project base directory\n\n```\n$ cd pyatsyn\n$ python -m venv .venv\n$ source .venv/bin/activate\n```\n\n\npython libraries required: \n\n```\n$ pip install numpy\n$ pip install soundfile\n```\n\noptional documentation generation requires:\n\n```\n$pip install sphinx\n$pip install sphinx_rtd_theme\n```\n\nmay need to be run as a package in development mode\n(from within the outermost pyatsyn directory containing the pyproject.toml file)\n\n```\n$ pip install -e .\n```\n\nIf you are a newcomer to ATS, we recommend you start by looking at pyatsn/atsa/tracker.py\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "python-based implementation of Analysis-Synthesis-Transformation (ATS) spectral music system",
"version": "1.0.0",
"split_keywords": [
"spectral",
"audio",
"dsp",
"synthesis",
"music",
"sound",
"analysis",
"ats"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a0b54810975fecc287ef89ddfb42a846daac336d06c1bbbe0de488775d026c44",
"md5": "0eb7b6c7aff1b21bcd874ad13b26ce4a",
"sha256": "1dd03785a3177312a768ce64a346a88b319aeba0cd01a96c037d5bd359688bf1"
},
"downloads": -1,
"filename": "pyatsyn-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0eb7b6c7aff1b21bcd874ad13b26ce4a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 39709,
"upload_time": "2023-01-22T19:55:06",
"upload_time_iso_8601": "2023-01-22T19:55:06.970370Z",
"url": "https://files.pythonhosted.org/packages/a0/b5/4810975fecc287ef89ddfb42a846daac336d06c1bbbe0de488775d026c44/pyatsyn-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9c4faf3830f6433b3ca904fe591424a9703c8ef2e8120e4bd468f41aa0cfb434",
"md5": "d44c96ebbf702b0b5311cb45d2a5a56c",
"sha256": "088191b2d8b20425926249ff548c1200e2ca324dced4d159cba6cc4a54478a5f"
},
"downloads": -1,
"filename": "pyatsyn-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d44c96ebbf702b0b5311cb45d2a5a56c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 33317,
"upload_time": "2023-01-22T19:55:09",
"upload_time_iso_8601": "2023-01-22T19:55:09.260402Z",
"url": "https://files.pythonhosted.org/packages/9c/4f/af3830f6433b3ca904fe591424a9703c8ef2e8120e4bd468f41aa0cfb434/pyatsyn-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-22 19:55:09",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "pyatsyn"
}
