Skip to main content

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.

Metadata

Release files for carat 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for carat 0.1.6
File Size Uploaded Provenance Actions
carat-0.1.6.tar.gz 31.6 kB Without provenance Details for carat-0.1.6.tar.gz

Release files / carat-0.1.6.tar.gz

Download URL carat-0.1.6.tar.gz
Size 31.6 kB
Tags Source
SHA-256 checksum
How to use checksums
49d4088fe45eb0407ad8dd833c6b55a768b8db4e0e479532162382bb045b4cb8
BLAKE2b-256 checksum
How to use checksums
9528925b90f8490809b354bfc6f8bea8d132e9aedf2d6299b112fef4afaa1082
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.8.10

Security for carat 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page