{ "info": { "author": "Justin Kitzes", "author_email": "justin.kitzes@pitt.edu", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "Opensoundscape\n---\n\n### Installation\n\nWe recommend you run Opensoundscape into a Python 3.7 virtual environment. If\nyou don't already have Python installed you can use [the Anaconda\ndistribution](https://www.anaconda.com/distribution/#download-section). Simply\nselect your platform (Windows, macOS, or Linux) and download a Python 3.7\n64-bit installer. You will also need to run a MongoDB server which is used to\nstore data for Opensoundscape. The documentation for this process is available\n[here](https://docs.mongodb.com/manual/installation/#mongodb-community-edition).\nThe documentation also explains how to start the service on various platforms.\n\nNow, you can get Opensoundscape via\n[PyPI](https://pypi.org/project/opensoundscape/0.3.0.1). I will show the\n`conda` commands below, but we use `virtualenvwrapper` internally.\n\n1. Create the environment and install Opensoundscape: `conda create --name\n opensoundscape python=3.7 opensoundscape=0.3.0.1`\n2. Activate the environment: `conda activate opensoundscape`\n3. Check if everything worked: `opensoundscape -h`\n4. Deactivate the environment when finished: `conda deactivate`\n\n### Singularity Container\n\nCurrently, Singularity is only working on Linux. The developers recently showed\na development version which works on\n[macOS](https://www.linkedin.com/feed/update/urn:li:activity:6505987087735623680/).\nYou can pull our container from\n[here](https://cloud.sylabs.io/library/_container/5c7d4c0f5cf3490001ca7987).\n\n1. Get the container: `singularity pull\n library://barrymoo/default/opensoundscape:0.3.0.1`\n2. Check if Opensoundscape can run: `singularity run --app opensoundscape\n opensoundscape_0.3.0.1.sif -h`\n3. Check if MongoDB can run: `singularity run --app mongodb\n opensoundscape_0.3.0.1.sif -h`\n\n### Quick Start Guide\n\nGoing to run through a quick example of running Opensoundscape. First, we need\nsome data\n\n- The [CLO-43SD-AUDIO](https://datadryad.org/resource/doi:10.5061/dryad.j2t92)\n dataset:\n\n```\ncd ~/Downloads\nwget https://datadryad.org/bitstream/handle/10255/dryad.111783/CLO-43SD-AUDIO.tar.gz\ntar -xzf CLO-43SD-AUDIO.tar.gz\nrm CLO-43SD-AUDIO.tar.gz\n```\n\n- Download our training & prediction split of a subset of the CLO-43SD dataset:\n\n```\ncd ~/Downloads/CLO-43SD-AUDIO/\nwget https://raw.github.com/rhine3/opso-support/master/clo-43sd-train-small.csv\nwget https://raw.github.com/rhine3/opso-support/master/clo-43sd-predict-small.csv\n```\n\n- Make a new directory to run Opensoundscape in, using `~/clo-43sd` below\n\n```\ncd ~/clo-43sd\nwget https://raw.github.com/rhine3/opso-support/master/opso-test-small.ini\n```\n\n- Edit the `.ini` to reflect the absolute path of your `Downloads` folder, e.g.\n with `vim`: `vim opso-test-small.ini`\n- Start the MongoDB daemon in another terminal: `mongod --config\n /usr/local/etc/mongod.conf`\n- Run Opensoundscape:\n\n```\nopensoundscape init -i opso-test-small.ini\nopensoundscape spect_gen -i opso-test-small.ini > spect-gen-output-small.txt\nopensoundscape model_fit -i opso-test-small.ini > model-fit-output-small.txt\nopensoundscape predict -i opso-test-small.ini > predict-output-small.txt\n```\n\n### Contributions\n\nContributions are highly encouraged! Our development workflow is a combination\nof `virtualenvwrapper` and `poetry`. \n\n- Get [poetry](https://poetry.eustace.io/docs/#installation)\n- Get\n [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/install.html)\n- Link `poetry` and `virtualenvwrapper`, add something like the following to\n your `~/.bashrc` (don't forget to source it!)\n\n```\n# virtualenvwrapper + poetry\nexport WORKON_HOME=~/.cache/pypoetry/virtualenvs\nsource /usr/bin/virtualenvwrapper_lazy.sh\n```\n\n- Fork the github repository, and clone it\n - We use `black` pre-commit hooks for formatting\n- Build the virtual environment for opensoundscape: `poetry install`\n- Activate your opensoundscape environment: `workon opensoundscape-py3.7`\n- Check Opensoundscape runs: `opensoundscape -h`\n- To go back to your system's Python: `deactivate`\n- Running the tests: `poetry run pytest tests`\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/jkitzes/opensoundscape", "keywords": "", "license": "MIT", "maintainer": "Justin Kitzes", "maintainer_email": "justin.kitzes@pitt.edu", "name": "opensoundscape", "package_url": "https://pypi.org/project/opensoundscape/", "platform": "", "project_url": "https://pypi.org/project/opensoundscape/", "project_urls": { "Homepage": "https://github.com/jkitzes/opensoundscape", "Repository": "https://github.com/jkitzes/opensoundscape" }, "release_url": "https://pypi.org/project/opensoundscape/0.3.0.1/", "requires_dist": [ "pandas (==0.23.4)", "numpy (==1.15.4)", "matplotlib (==3.0.2)", "docopt (==0.6.2)", "scipy (==1.2.0)", "scikit-image (==0.14.1)", "pymongo (==3.7.2)", "librosa (==0.6.2)", "llvmlite (==0.27.0)", "numba (==0.42.0)", "opencv-python-headless (==4.0.0.21)", "pyqt5 (>=5.12,<6.0)", "toolz (>=0.9.0,<0.10.0)", "Pillow (>=5.4,<6.0)" ], "requires_python": ">=3.6,<4.0", "summary": "Open source, scalable acoustic classification for ecology and conservation", "version": "0.3.0.1" }, "last_serial": 4935637, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "4f3f6a8a8589165d6f9174ebd1545321", "sha256": "fb1574ca5349b508549a38a52131af68252b4a5df4d97b2c747d6991817e518a" }, "downloads": -1, "filename": "opensoundscape-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "4f3f6a8a8589165d6f9174ebd1545321", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.7,<4.0", "size": 2136, "upload_time": "2019-01-14T15:56:34", "url": "https://files.pythonhosted.org/packages/39/82/0bc5ce9b8d1c5593fef085062ef2f1ac7199723327b536171c06251e415a/opensoundscape-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f139528acaa9b452a1cae3c7f59752ba", "sha256": "b1a1b93c8b8cba551d8d315c9ca0377e5505f5cc8db475d195fa16f6d03c7b90" }, "downloads": -1, "filename": "opensoundscape-0.1.0.tar.gz", "has_sig": false, "md5_digest": "f139528acaa9b452a1cae3c7f59752ba", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.7,<4.0", "size": 1355, "upload_time": "2019-01-14T15:56:36", "url": "https://files.pythonhosted.org/packages/ad/08/bc3d97f7e40ec7101bdb10e619fb55116d6ff379bf10c744b0c91ef426b7/opensoundscape-0.1.0.tar.gz" } ], "0.2.2.dev0": [ { "comment_text": "", "digests": { "md5": "6e9d151720bb53ad6707e0e88c2a859c", "sha256": "8ecad54562fc5679745e72e552caade8fd9d6b6c1c960e55eac769faff8e24f0" }, "downloads": -1, "filename": "opensoundscape-0.2.2.dev0-py3-none-any.whl", "has_sig": false, "md5_digest": "6e9d151720bb53ad6707e0e88c2a859c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 104593, "upload_time": "2019-03-04T16:08:00", "url": "https://files.pythonhosted.org/packages/0a/51/a6dc4b315f59c6b9e352daeca0a324f5f08bb1284002c85b21ba98e89ecf/opensoundscape-0.2.2.dev0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c9ad4b6fa3944081db3bf4b9f392b8b8", "sha256": "f1fbef878fbd1f3b2ab7fb055d6aa3a23475f189a689b47e5dabdf9cabea22f3" }, "downloads": -1, "filename": "opensoundscape-0.2.2.dev0.tar.gz", "has_sig": false, "md5_digest": "c9ad4b6fa3944081db3bf4b9f392b8b8", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 26363, "upload_time": "2019-03-04T16:08:01", "url": "https://files.pythonhosted.org/packages/62/1e/34af2c2f650cc003ee1a6829cb4719413c63627ab2681c817533ab249cdc/opensoundscape-0.2.2.dev0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "2aacd8d5bb2688a25de74432ecd7bc6f", "sha256": "47e37790534265cfbcdfd564c62c9bb23966a85a49470085f3e82f9df1f81a97" }, "downloads": -1, "filename": "opensoundscape-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2aacd8d5bb2688a25de74432ecd7bc6f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 105249, "upload_time": "2019-03-06T18:07:20", "url": "https://files.pythonhosted.org/packages/7e/16/f50e757dca2d39ec772c65f74327f431f6739cbab0c3925a0e0139dc8b7a/opensoundscape-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e6ca1966a8344a557af87ec998fbd342", "sha256": "006147bb37f880332c3299598990b70eddf2b36d64d56ec197e76ccbb8467bfb" }, "downloads": -1, "filename": "opensoundscape-0.3.0.tar.gz", "has_sig": false, "md5_digest": "e6ca1966a8344a557af87ec998fbd342", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 27583, "upload_time": "2019-03-06T18:07:21", "url": "https://files.pythonhosted.org/packages/9b/6b/15aa1d1204d6d301270df08db2f1c643b6e7a6c5f2cc78e69c519548d484/opensoundscape-0.3.0.tar.gz" } ], "0.3.0.1": [ { "comment_text": "", "digests": { "md5": "65edf4fc639915496a3bc6e743379f5d", "sha256": "7269bfadc7d80212f775ae960c07ef6ca6e23f3c8854c5a015af423b58f9ccec" }, "downloads": -1, "filename": "opensoundscape-0.3.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "65edf4fc639915496a3bc6e743379f5d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 106911, "upload_time": "2019-03-13T17:00:41", "url": "https://files.pythonhosted.org/packages/5d/1c/1752e785a41e050222872fc0de7c588581cbb16d924b40a9922ac1de1708/opensoundscape-0.3.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09f31bf321a60334107002706feb2cfe", "sha256": "c3314d3904471f32973980c7425efc341b2e5cf439418b2d11bfb59d713cb5d3" }, "downloads": -1, "filename": "opensoundscape-0.3.0.1.tar.gz", "has_sig": false, "md5_digest": "09f31bf321a60334107002706feb2cfe", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 28057, "upload_time": "2019-03-13T17:00:42", "url": "https://files.pythonhosted.org/packages/69/be/8b5a596ad347d4a4e8ae951ed148c8623d6ee4f53a084b9f10937770e7dc/opensoundscape-0.3.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "65edf4fc639915496a3bc6e743379f5d", "sha256": "7269bfadc7d80212f775ae960c07ef6ca6e23f3c8854c5a015af423b58f9ccec" }, "downloads": -1, "filename": "opensoundscape-0.3.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "65edf4fc639915496a3bc6e743379f5d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6,<4.0", "size": 106911, "upload_time": "2019-03-13T17:00:41", "url": "https://files.pythonhosted.org/packages/5d/1c/1752e785a41e050222872fc0de7c588581cbb16d924b40a9922ac1de1708/opensoundscape-0.3.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "09f31bf321a60334107002706feb2cfe", "sha256": "c3314d3904471f32973980c7425efc341b2e5cf439418b2d11bfb59d713cb5d3" }, "downloads": -1, "filename": "opensoundscape-0.3.0.1.tar.gz", "has_sig": false, "md5_digest": "09f31bf321a60334107002706feb2cfe", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6,<4.0", "size": 28057, "upload_time": "2019-03-13T17:00:42", "url": "https://files.pythonhosted.org/packages/69/be/8b5a596ad347d4a4e8ae951ed148c8623d6ee4f53a084b9f10937770e7dc/opensoundscape-0.3.0.1.tar.gz" } ] }