{ "info": { "author": "Chris Cannam, George Fazekas", "author_email": "cannam@all-day-breakfast.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Operating System :: MacOS :: MacOS X", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3", "Topic :: Multimedia :: Sound/Audio :: Analysis" ], "description": "Python Vamp plugin host\n=======================\n\nThis module allows Python code to load and use native-code Vamp\nplugins (http://vamp-plugins.org) for audio feature analysis.\n\nThe module consists of a native-code extension (\"vampyhost\") that\nprovides a low-level wrapper for the Vamp plugin SDK, along with a\nPython wrapper (\"vamp\") that provides a higher-level abstraction.\n\nNo code for loading audio files is included; you'll need to use some\nother module for that. This code expects to receive decoded audio data\nof one or more channels, either as a series of frames or as a single\nwhole buffer.\n\nWritten by Chris Cannam and George Fazekas at the Centre for Digital\nMusic, Queen Mary University of London. Copyright 2008-2015 Queen\nMary, University of London. Refer to COPYING.rst for licence details.\n\nSee home page at https://code.soundsoftware.ac.uk/projects/vampy-host\nfor more details.\n\n\nA simple example\n----------------\n\nUsing librosa (http://bmcfee.github.io/librosa/) to read an audio\nfile, and the NNLS Chroma Vamp plugin\n(https://code.soundsoftware.ac.uk/projects/nnls-chroma/) for\nanalysis::\n\n >>> import vamp\n >>> import librosa\n >>> data, rate = librosa.load(\"example.wav\")\n >>> chroma = vamp.collect(data, rate, \"nnls-chroma:nnls-chroma\")\n >>> chroma\n {'matrix': ( 0.092879819, array([[ 61.0532608 , 60.27478409, 59.3938446 , ..., 182.13394165,\n 42.40084457, 116.55457306],\n [ 68.8901825 , 63.98115921, 60.77633667, ..., 245.88218689,\n 68.51251984, 164.70120239],\n [ 58.59794617, 50.3429184 , 45.44804764, ..., 258.02362061,\n 83.95749664, 179.91200256],\n ..., \n [ 0. , 0. , 0. , ..., 0. ,\n 0. , 0. ],\n [ 0. , 0. , 0. , ..., 0. ,\n 0. , 0. ],\n [ 0. , 0. , 0. , ..., 0. ,\n 0. , 0. ]], dtype=float32))}\n >>> stepsize, chromadata = chroma[\"matrix\"]\n >>> import matplotlib.pyplot as plt\n >>> plt.imshow(chromadata)\n \n >>> plt.show()\n\nAnd a pitch-chroma plot appears.\n\n\nHigh-level interface (vamp)\n---------------------------\n\nThis module contains three sorts of function:\n\n1. Basic info and lookup functions\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\n * ``vamp.list_plugins``\n * ``vamp.get_outputs_of``\n * ``vamp.get_category_of``\n\n These retrieve the installed plugin keys and get basic information\n about each plugin. (For more detailed information, load a plugin\n and inspect it using the low-level interface described below.)\n\n2. Process functions\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n\n * ``vamp.process_audio``\n * ``vamp.process_frames``\n * ``vamp.process_audio_multiple_outputs``\n * ``vamp.process_frames_multiple_outputs``\n\n These accept audio input, and produce output in the form of a list\n of feature sets structured similarly to those in the C++ Vamp\n plugin SDK. The plugin to be used is specified by its key (the\n identifier as returned by ``vamp.list_plugins``). A dictionary of\n plugin parameter settings may optionally be supplied.\n\n The ``_audio`` versions take a single (presumably long) array of\n audio samples as input, and chop it into frames according to the\n plugin's preferred step and block sizes. The ``_frames`` versions\n instead accept an enumerable sequence of audio frame arrays.\n\n3. The process-and-collect function\n\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\n \n * ``vamp.collect``\n\n This accepts a single array of audio samples as input, and returns\n an output structure that reflects the underlying structure of the\n feature output (depending on whether it is a curve, grid, etc). The\n plugin to be used is specified by its key. A dictionary of plugin\n parameter settings may optionally be supplied.\n\n The ``collect`` function processes the whole input before returning\n anything; if you need to supply a streamed input, or retrieve\n results as they are calculated, then you must use one of the\n ``process`` functions (above) or else the low-level interface\n (below).\n\n\nLow-level interface (vampyhost)\n-------------------------------\n\nThis extension contains facilities that operate on Vamp plugins in a\nway analogous to the existing C++ Vamp Host SDK: ``list_plugins``,\n``get_plugin_path``, ``get_category_of``, ``get_library_for``,\n``get_outputs_of``, ``load_plugin``, and a utility function\n``frame_to_realtime``.\n\nCalling ``load_plugin`` gets you a ``vampyhost.Plugin`` object, which\nthen exposes all of the methods found in the Vamp SDK Plugin class.\n\n(Note that methods wrapped directly from the Vamp SDK are named using\ncamelCase, so as to match the names found in the C++ SDK. Elsewhere\nthis module follows Python PEP8 naming.)\n\nSee the individual module and function documentation for further\ndetails.\n\n\n\n\n Python Vamp Host\n Copyright (c) 2008-2015 Queen Mary, University of London\n\n Permission is hereby granted, free of charge, to any person\n obtaining a copy of this software and associated documentation\n files (the \"Software\"), to deal in the Software without\n restriction, including without limitation the rights to use, copy,\n modify, merge, publish, distribute, sublicense, and/or sell copies\n of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n\n The above copyright notice and this permission notice shall be\n included in all copies or substantial portions of the Software.\n\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\n EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\n MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND\n NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY\n CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF\n CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION\n WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n Except as contained in this notice, the names of the Centre for\n Digital Music and Queen Mary, University of London shall not be\n used in advertising or otherwise to promote the sale, use or other\n dealings in this Software without prior written authorization.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://code.soundsoftware.ac.uk/projects/vampy-host", "keywords": null, "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "vamp", "package_url": "https://pypi.org/project/vamp/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/vamp/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://code.soundsoftware.ac.uk/projects/vampy-host" }, "release_url": "https://pypi.org/project/vamp/1.1.0/", "requires_dist": null, "requires_python": null, "summary": "Use Vamp plugins for audio feature analysis.", "version": "1.1.0" }, "last_serial": 1625104, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "65faf6606cde977f2a701be8cac718d1", "sha256": "5c20fe3e280605ac1a87f0c1d3d67fa56311ae43d44832163cd524d44c7c39fd" }, "downloads": -1, "filename": "vamp-1.0.0-cp27-none-macosx_10_10_x86_64.whl", "has_sig": false, "md5_digest": "65faf6606cde977f2a701be8cac718d1", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 130534, "upload_time": "2015-06-24T14:16:44", "url": "https://files.pythonhosted.org/packages/89/16/2f585f3641ce627328ad4a02c115e2d42be5814ce88980190c393d99126b/vamp-1.0.0-cp27-none-macosx_10_10_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "030e39ef4a3c41cce3115bbfd0b3d52c", "sha256": "a5e07369ae84b5fedea4f74df77a1f889ef41b9f7fa3ab5d2172f4eedd64431d" }, "downloads": -1, "filename": "vamp-1.0.0-cp27-none-win32.whl", "has_sig": false, "md5_digest": "030e39ef4a3c41cce3115bbfd0b3d52c", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 102962, "upload_time": "2015-06-24T14:21:47", "url": "https://files.pythonhosted.org/packages/a4/60/3fec29bbf0d70fd9f9bc7a35cb5c226412e931d9d90e71f0ac4d0527428d/vamp-1.0.0-cp27-none-win32.whl" }, { "comment_text": "", "digests": { "md5": "3dc1fe4d6304ef99caa6f967d85736c6", "sha256": "916b72519432566079103670d965ab0017e484086cb4e0e085c9fda131374922" }, "downloads": -1, "filename": "vamp-1.0.0.tar.gz", "has_sig": false, "md5_digest": "3dc1fe4d6304ef99caa6f967d85736c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 102693, "upload_time": "2015-06-24T14:13:00", "url": "https://files.pythonhosted.org/packages/38/2d/ec94cc7ddee5498baeade734a7457121c16528bc3521085f272eee32d3b8/vamp-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "b0c32d0dc27f3e0d9db1669ab1277060", "sha256": "b6b1d867d8ddb9d7a60b313e855d7799eaebbb366890a59eda3b1f87ce4e3428" }, "downloads": -1, "filename": "vamp-1.0.1-cp27-none-macosx_10_10_x86_64.whl", "has_sig": false, "md5_digest": "b0c32d0dc27f3e0d9db1669ab1277060", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 132437, "upload_time": "2015-06-24T15:19:49", "url": "https://files.pythonhosted.org/packages/6f/1e/f4f05bc95caac161a5d03883584e07a48aa4e81a48975db95567d104150f/vamp-1.0.1-cp27-none-macosx_10_10_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "66f1b3dd1a1c868ecfef64150ef3e80f", "sha256": "28c7952496845bb5af1b1e4cd3ab52a2c5f2663ab905b28b110006e51aa20a5b" }, "downloads": -1, "filename": "vamp-1.0.1-cp27-none-win32.whl", "has_sig": false, "md5_digest": "66f1b3dd1a1c868ecfef64150ef3e80f", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 104868, "upload_time": "2015-06-24T15:19:11", "url": "https://files.pythonhosted.org/packages/be/41/e127d9577fb392070ddca2f7a15fbeec74c61f0d19e8801833743d1f9642/vamp-1.0.1-cp27-none-win32.whl" }, { "comment_text": "", "digests": { "md5": "a980297db3b09db0d6d5ef47cf4d90cc", "sha256": "56e89eb9749353a5a02d0119694bb71aab6f50eb5a9ab9341410da7374179a1b" }, "downloads": -1, "filename": "vamp-1.0.1.tar.gz", "has_sig": false, "md5_digest": "a980297db3b09db0d6d5ef47cf4d90cc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104445, "upload_time": "2015-06-24T15:16:56", "url": "https://files.pythonhosted.org/packages/4a/d2/d5ceaba2d16c129d2a9287f62421aca91aa34e0f6419467827a8af80b2a4/vamp-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "7dad3ad45e37b81a65548c8440e0ca05", "sha256": "a5e04b0ddcf6b4e0b87cdce19f2cd9cbf92f676850eda1e8fc6701b9a93c3f1e" }, "downloads": -1, "filename": "vamp-1.0.2-cp27-none-macosx_10_10_x86_64.whl", "has_sig": false, "md5_digest": "7dad3ad45e37b81a65548c8440e0ca05", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 133031, "upload_time": "2015-06-29T10:04:58", "url": "https://files.pythonhosted.org/packages/c5/c2/bb9b696a2cdc435e2e634ac639ed382820553dac64d987bf4303766f13b2/vamp-1.0.2-cp27-none-macosx_10_10_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "5937cb18345bbd051569f06174916626", "sha256": "d66ebcf14ca03c7ac5c5e729c0d30efc8ee1874dcd1bec66d6b5714c2f273e40" }, "downloads": -1, "filename": "vamp-1.0.2-cp27-none-win32.whl", "has_sig": false, "md5_digest": "5937cb18345bbd051569f06174916626", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 105375, "upload_time": "2015-06-29T10:07:06", "url": "https://files.pythonhosted.org/packages/92/32/bb6a465ab90ea857a507379979fd20fd6d4b00be23229969a9d9956b7704/vamp-1.0.2-cp27-none-win32.whl" }, { "comment_text": "", "digests": { "md5": "a11309a4e9668f2d02421a8132b109ef", "sha256": "2e9a10a55b5b871194be14e9113141c8fd770a284faaf211996b87947b32ba39" }, "downloads": -1, "filename": "vamp-1.0.2.tar.gz", "has_sig": false, "md5_digest": "a11309a4e9668f2d02421a8132b109ef", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 104656, "upload_time": "2015-06-29T10:03:52", "url": "https://files.pythonhosted.org/packages/fb/6a/80309b83da76d21c84db981b0d6ec5567961e3d7b79836d60d89d521b6c5/vamp-1.0.2.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "aa5c76a9078f88f027d3dd447f7826c1", "sha256": "fadca706892260c283729be2ce714848bca9ee575fde46e4c1190e8d04cc13c6" }, "downloads": -1, "filename": "vamp-1.1.0-cp27-none-macosx_10_10_x86_64.whl", "has_sig": false, "md5_digest": "aa5c76a9078f88f027d3dd447f7826c1", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 132394, "upload_time": "2015-07-08T19:14:56", "url": "https://files.pythonhosted.org/packages/bc/dc/4f5f9202cef7129dd79175faeb57d48cb56467add50e4f6bfb83b67bad67/vamp-1.1.0-cp27-none-macosx_10_10_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "4b7382ba866f1f533c17144f1cfd55c3", "sha256": "e6c0a1dd325f934f26ea7b2c5dc2d3759cd08d295004a8951a4ddc32955b9e35" }, "downloads": -1, "filename": "vamp-1.1.0-cp27-none-win32.whl", "has_sig": false, "md5_digest": "4b7382ba866f1f533c17144f1cfd55c3", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 106693, "upload_time": "2015-07-08T19:14:36", "url": "https://files.pythonhosted.org/packages/f6/0b/2d3e4c1a05797bf28fc69aec15dfe6bf7f87a05c2b268693c42a2012d871/vamp-1.1.0-cp27-none-win32.whl" }, { "comment_text": "", "digests": { "md5": "376ce0d17d18060c55ae6ebfdeb219e9", "sha256": "d40e0916e958e2806d37920f903c2518cc46959a4f21e020737b6a48f6e7e82d" }, "downloads": -1, "filename": "vamp-1.1.0.tar.gz", "has_sig": false, "md5_digest": "376ce0d17d18060c55ae6ebfdeb219e9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 107848, "upload_time": "2015-07-08T19:14:21", "url": "https://files.pythonhosted.org/packages/66/65/a54958777fa667ef881ceec18dd0b423b2ba2c77543060b21aff0e1dbcb6/vamp-1.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "aa5c76a9078f88f027d3dd447f7826c1", "sha256": "fadca706892260c283729be2ce714848bca9ee575fde46e4c1190e8d04cc13c6" }, "downloads": -1, "filename": "vamp-1.1.0-cp27-none-macosx_10_10_x86_64.whl", "has_sig": false, "md5_digest": "aa5c76a9078f88f027d3dd447f7826c1", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 132394, "upload_time": "2015-07-08T19:14:56", "url": "https://files.pythonhosted.org/packages/bc/dc/4f5f9202cef7129dd79175faeb57d48cb56467add50e4f6bfb83b67bad67/vamp-1.1.0-cp27-none-macosx_10_10_x86_64.whl" }, { "comment_text": "", "digests": { "md5": "4b7382ba866f1f533c17144f1cfd55c3", "sha256": "e6c0a1dd325f934f26ea7b2c5dc2d3759cd08d295004a8951a4ddc32955b9e35" }, "downloads": -1, "filename": "vamp-1.1.0-cp27-none-win32.whl", "has_sig": false, "md5_digest": "4b7382ba866f1f533c17144f1cfd55c3", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 106693, "upload_time": "2015-07-08T19:14:36", "url": "https://files.pythonhosted.org/packages/f6/0b/2d3e4c1a05797bf28fc69aec15dfe6bf7f87a05c2b268693c42a2012d871/vamp-1.1.0-cp27-none-win32.whl" }, { "comment_text": "", "digests": { "md5": "376ce0d17d18060c55ae6ebfdeb219e9", "sha256": "d40e0916e958e2806d37920f903c2518cc46959a4f21e020737b6a48f6e7e82d" }, "downloads": -1, "filename": "vamp-1.1.0.tar.gz", "has_sig": false, "md5_digest": "376ce0d17d18060c55ae6ebfdeb219e9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 107848, "upload_time": "2015-07-08T19:14:21", "url": "https://files.pythonhosted.org/packages/66/65/a54958777fa667ef881ceec18dd0b423b2ba2c77543060b21aff0e1dbcb6/vamp-1.1.0.tar.gz" } ] }