carat

computer-aided rhythm analysis toolbox

https://github.com/mrocamora/carat

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    3 of 4 committers (75.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

computer-aided rhythm analysis toolbox

Basic Info
  • Host: GitHub
  • Owner: mrocamora
  • License: mit
  • Language: Python
  • Default Branch: master
  • Size: 223 MB
Statistics
  • Stars: 35
  • Watchers: 4
  • Forks: 4
  • Open Issues: 20
  • Releases: 5
Created about 7 years ago · Last pushed about 2 years ago
Metadata Files
Readme License Authors

README.md

carat

 _  _  __ _ _|_
(_ (_| | (_| |_   computer-aided rhythm analysis toolbox

PyPI License

Documentation

See https://carat.readthedocs.io for a complete reference manual and introductory tutorials.

Demonstration notebooks

Some demonstrations of what you can do with carat:

Installation

The latest stable release is available on PyPI, and you can install it by pip install carat

To build carat from source, use python setup.py build. Then, to install carat, say python setup.py install. If all went well, you should be able to execute the demo scripts under examples/ (OS X users should follow the installation guide given below).

Alternatively, you can download or clone the repository and use pip to handle dependencies:

unzip carat.zip pip install -e carat or git clone https://github.com/mrocamora/carat.git pip install -e carat

By calling pip list you should see carat now as an installed pacakge: carat (0.x.x, /path/to/carat)

Hints for the Installation

carat uses librosa to load audio files. The following are the installation hints provided by librosa in order to install the needed dependencies to load audio files.

librosa uses soundfile and audioread to load audio files. Note that soundfile does not currently support MP3, which will cause librosa to fall back on the audioread library.

soundfile

If you're using pip on a Linux environment, you may need to install libsndfile manually. Please refer to the SoundFile installation documentation for details.

audioread and MP3 support

To fuel audioread with more audio-decoding power (e.g., for reading MP3 files), you may need to install either ffmpeg or GStreamer.

Note that on some platforms, audioread needs at least one of the programs to work properly.

Here are some common commands for different operating systems:

  • Linux (apt-get): apt-get install ffmpeg or apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Linux (yum): yum install ffmpeg or yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Mac: brew install ffmpeg or brew install gstreamer
  • Windows: download binaries from the website

For GStreamer, you also need to install the Python bindings with pip install pygobject

Citing

If you want to cite carat please cite the paper published at AAWM 2019:

Rocamora, and Jure. "carat: Computer-Aided Rhythmic Analysis Toolbox." In Proceedings of Analytical Approaches to World Music. 2019.

Owner

  • Name: Martín Rocamora
  • Login: mrocamora
  • Kind: user
  • Location: Montevideo, Uruguay

GitHub Events

Total
  • Watch event: 4
  • Pull request event: 1
  • Fork event: 1
Last Year
  • Watch event: 4
  • Pull request event: 1
  • Fork event: 1

Committers

Last synced: 12 months ago

All Time
  • Total Commits: 131
  • Total Committers: 4
  • Avg Commits per committer: 32.75
  • Development Distribution Score (DDS): 0.321
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Martin Rocamora r****a@f****y 89
Jimena Arruti j****i@e****y 29
ivanlmh i****n@g****m 7
luis jure lj@e****y 6
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 40
  • Total pull requests: 38
  • Average time to close issues: about 1 month
  • Average time to close pull requests: 3 days
  • Total issue authors: 4
  • Total pull request authors: 7
  • Average comments per issue: 0.28
  • Average comments per pull request: 0.18
  • Merged pull requests: 32
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: 8 minutes
  • Issue authors: 0
  • Pull request authors: 2
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • mrocamora (26)
  • jimearruti (11)
  • ivanlmh (2)
  • luisjure (1)
Pull Request Authors
  • jimearruti (18)
  • mrocamora (8)
  • luisjure (5)
  • ivanlmh (4)
  • dhunstack (2)
  • satyajeetprabhu (2)
  • luis-j (1)
Top Labels
Issue Labels
enhancement (11) documentation (10) bug (7) question (2)
Pull Request Labels
enhancement (2)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 57 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 7
  • Total maintainers: 2
pypi.org: carat

Computer-Aided Rhythm Analysis Toolbox

  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 57 Last month
Rankings
Dependent packages count: 10.0%
Stargazers count: 13.1%
Average: 17.8%
Dependent repos count: 21.7%
Downloads: 21.7%
Forks count: 22.6%
Maintainers (2)
Last synced: 10 months ago

Dependencies

docs/requirements.txt pypi
  • librosa >=0.8.0
  • matplotlib >=2.0.0
  • numpy >=1.8.0
  • numpydoc >=1.1.0
  • numpydoc >=0.9.1
  • scikit-learn >=0.14.0
  • scipy >=1.0.0
  • soundfile >=0.10.2
  • sphinx ==3.4.0
  • sphinx-gallery >=0.4.0
setup.py pypi
  • audioread *
  • librosa *
  • matplotlib *
  • numpy *
  • scikit-learn *
  • scipy *
  • sounddevice *
  • soundfile *