Skip to content
/ jams-x Public
forked from marl/jams

An experimental extension of JAMS for handling hybrid annotations.

License

Notifications You must be signed in to change notification settings

smashub/jams-x

 
 

Repository files navigation

jams

An experimental extension of the popular JAMS annotation format.

Not familiar with JAMS? Please, refer to documentation for a comprehensive description of this standard.

What is different to JAMS?

We are extending JAMS to support hybrid annotations for analysing audio and symbolic music.

We provide:

  • A formal JSON schema for generic annotations
  • Additional schema definitions for a wide range of annotation types (chords, segments, tags, etc.)
  • Error detection and validation for annotations

Why

Music annotations are traditionally provided as plain-text files employing simple formatting schema (comma or tab separated) when possible. However, as the field of MIR has continued to evolve, such annotations have become increasingly complex, and more often custom conventions are employed to represent this information. And, as a result, these custom conventions can be unwieldy and non-trivial to parse and use.

Therefore, JAMS provides a simple, structured, and sustainable approach to representing rich information in a human-readable, language agnostic format. Importantly, JAMS supports the following use-cases:

  • multiple types annotations
  • multiple annotations for a given task
  • rich file level and annotation level metadata

References

JAMS is fully documented at this link and proposed in the following publication:

[1] Eric J. Humphrey, Justin Salamon, Oriol Nieto, Jon Forsyth, Rachel M. Bittner, and Juan P. Bello, "JAMS: A JSON Annotated Music Specification for Reproducible MIR Research", Proceedings of the 15th International Conference on Music Information Retrieval, 2014.

The JAMS schema and data representation used in the API were overhauled significantly between versions 0.1 (initial proposal) and 0.2 (overhauled), see the following technical report for details:

[2] B. McFee, E. J. Humphrey, O. Nieto, J. Salamon, R. Bittner, J. Forsyth, J. P. Bello, "Pump Up The JAMS: V0.2 And Beyond", Technical report, October 2015.

About

An experimental extension of JAMS for handling hybrid annotations.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.3%
  • Other 0.7%