Pereval documentation

Welcome to the official documentation of Pereval!

Pereval is a toolkit for evaluating MIDI piano performances. It supports the recently proposed deep feature metrics described in the paper “Integrating Contextual Embeddings into Evaluation of Expressive MIDI Piano Performances” (Dmitrii Gavrilev, Ilya Borovik, and Vladimir Viro, Accepted at ISMIR 2026).

Contents:

• Introduction
• Features
• Installation
• Command-line usage
  • MIDI path convention
  • Extracting Aria embeddings
  • Aligning scores and performances
  • Attribute-scoped correlations
  • Density estimation for KL-divergence calcualtion
  • Shift notes
  • Transferring velocities
• API Reference
  • pereval package