Skip to main content

CAMAT

PyPI version Python versions License

CAMAT is a Python toolkit for symbolic music parsing, analysis, pattern search, and score rendering.

Supports Python 3.10+

Installation

pip install camat

What Is Included

  • Parsing helpers for partitura and music21 backends.
  • Timeline/rap Humdrum parsing with rhythm-only duration and onset-position summaries.
  • Pattern search and similarity utilities.
  • Piano-roll and overlay visualization helpers.
  • Verovio-based rendering utilities.

Parser Guidance

For common music notation, use the partitura backend as the primary parser. It is the most complete backend in CAMAT for current work: better MEI support, reliable xml_id extraction, explicit df_events output, and the strongest alignment with the rest of the parsing pipeline.

The music21 backend is kept as a legacy-compatible alternative. It can now emit df_pitch and df_events for common-notation files as well, but it should be treated as a fallback implementation rather than the default parser.

For MCFlow-style rap Humdrum timelines, use parse_files(..., parsing_backend="timeline"). This returns df_timeline rows with stable MEI ids and optional rhythm-analysis columns suitable for timeline MEI rendering.

Documentation

This repo includes an MkDocs project in docs/ and a Read the Docs config in .readthedocs.yaml.

Local preview:

pip install -r docs/requirements.txt
mkdocs serve

Then open http://127.0.0.1:8000/.

Repository Layout

  • camat/: package source used for PyPI distribution.
  • CAMAT_old/: legacy development notebooks and experiments.
  • CHANGELOG.md: release notes.
  • test_corpus/: test data and source links.

License

MIT (see LICENSE).

Metadata

Release files for camat 0.1.11

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

Source distribution (sdist)

Source distribution for camat 0.1.11
File Size Uploaded
camat-0.1.11.tar.gz 166.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for camat 0.1.11
File Interpreter ABI Platform
camat-0.1.11-py3-none-any.whl Python 3 none any Details

Total release size: 329.6 kB

Release files / camat-0.1.11.tar.gz

Download URL camat-0.1.11.tar.gz
Size 166.4 kB
Tags Source
SHA-256 checksum
How to use checksums
91574ffbc3a3866ec9150f040afbce84c732d0b130efdb13630785251e941138
BLAKE2b-256 checksum
How to use checksums
0a09955f60bf5003c8c97304d00a12f395f0502b92ed36d83b14a6b9e6b1a401
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 7, 2026.

Transparency log

Release files / camat-0.1.11-py3-none-any.whl

Download URL camat-0.1.11-py3-none-any.whl
Size 163.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1684fedcf33c07ddce46fc25811e3a4e43c23373eed7431fc14b13ed103c5c8
BLAKE2b-256 checksum
How to use checksums
64f35866936e9158f4a9e36a2da138b354e1bf21dc51805a3f45f3dc616bf86e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 7, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.13

2 release files

This release

0.1.11 This release

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

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