Roll Edition Ontology

Metadata

IRI
https://w3id.org/reo/
Title

Roll Edition Ontology

Creator

Niels Pfeffer

Date Created

2026-09-04

License
https://creativecommons.org/licenses/by/4.0/
Version Info

1.0-draft

Preferred Namespace Prefix

reo

Preferred Namespace Uri
reo:
Description

A small extension of CIDOC CRM and LRMoo for digital editions of piano rolls. It adds what those ontologies do not cover: the symbols a reproducing piano reads from a roll (notes and expression commands), the relations between such symbols that an editor states, and the edits by which one version of a roll becomes another. Everything else, from the physical copies and their holes to the recording, the versions and the editorial beliefs, is expressed with CIDOC CRM, LRMoo and CRMinf directly. The closed value lists of the format are the types at https://w3id.org/reo/type/.

See Also
Has Part
reot:
References

Classes

Class Hierarchy

Class Definitions

Edit c

IRI https://w3id.org/reo/Edit
Is Defined By Roll Edition Ontology
Description

This class comprises the single changes by which one version of a roll is turned into another: adding symbols, removing them, or both, which amounts to replacing. The creation of the new version, an instance of F28 Expression Creation, consists of its edits (P9 consists of). The kind of change is given by P2 has type, the reason by P17 was motivated by. Uncertainty about an edit, for instance whether a pencil mark on a copy was meant as an instruction to punch, is expressed with CRMinf on the statement, not by a property of this class.

Example
the prolongation of a crescendo perforation between versions A and B of WM 225, motivated by 'Verlängerter Bereich ohne Verschiebung'
Sub Class Of crm:E7_Activity
In Domain Of
In Range Of involved edit op

Expression c

IRI https://w3id.org/reo/Expression
Is Defined By Roll Edition Ontology
Description

This class comprises perforations that act on the reproducing mechanism rather than sound a note: dynamic commands such as crescendo, forzando and mezzoforte, the pedals, and motor functions such as rewind. The kind of command is given by P2 has type with one of the expression types at https://w3id.org/reo/type/; the half of the keyboard it acts on by scope. The name follows the vocabulary of the reproducing piano, where these are the expression perforations read by the expression box. It is unrelated to F2 Expression in LRMoo, which is the class of the roll's versions.

Example
  • a 'slow crescendo off' on a Welte-Mignon T-100 roll, aligned with the note it belongs to
  • the 'forzando on' and 'forzando off' pair that accents a single chord
Sub Class Of Perforation c
In Domain Of scope op

Note c

IRI https://w3id.org/reo/Note
Is Defined By Roll Edition Ontology
Description

This class comprises perforations that sound a pitch. The pitch is stated as a MIDI note number (pitch). Its duration follows from the extent of the carrying hole along the roll and is not stated separately.

Example
the note c′ (MIDI 60) with which Grünfeld's Träumerei begins on WM 225
Sub Class Of Perforation c
In Domain Of pitch dp

Perforation c

IRI https://w3id.org/reo/Perforation
Is Defined By Roll Edition Ontology
Description

This class comprises the symbols a reproducing piano reads from a roll: the notes it sounds and the commands that govern its mechanism. A perforation is what a hole or a group of holes means once it is read against a tracker bar. The hole itself is an instance of E26 Physical Feature borne by a copy of the roll (P56 bears feature) and carrying the perforation (P128 carries). One perforation may be carried by holes on several copies of the same roll. A version of the roll, an instance of F2 Expression, is composed of its perforations (P106 is composed of). The measured position of a perforation is that of the holes carrying it; the properties aligned with and paired with let an editor state where that measurement should give way.

Example
  • the first note of Grünfeld's Träumerei on the Welte-Mignon roll WM 225, recorded in Wien in 1905
  • the sustain pedal command that opens the same roll
Sub Class Of crm:E90_Symbolic_Object
In Domain Of
In Range Of
Super Class Of

Object Properties

Object Property Hierarchy

Object Property Definitions

added op

IRI https://w3id.org/reo/added
Is Defined By Roll Edition Ontology
Description

This property associates an edit with a symbol it adds to the version being created: a perforation, or a text written onto the roll.

Domain Edit c
Range crm:E90_Symbolic_Object

aligned with op

IRI https://w3id.org/reo/alignedWith
Is Defined By Roll Edition Ontology
Description

This property associates a perforation with another perforation whose onset it takes when the roll is performed. It records the editorial statement that the measured offset between the two is not meant: a 'crescendo off' falls on the note it belongs to. The property is not symmetric. The aligned perforation follows, the one it is aligned with keeps its measured place.

Domain Perforation c
Range Perforation c

dimensions op

IRI https://w3id.org/reo/dimensions
Is Defined By Roll Edition Ontology
Description

This property associates the measurement of a copy with its measured extent: the width across the roll (width) and the length along it (height), in the unit given by P91 has unit.

Sub Property Of crm:P40_observed_dimension
Domain crm:E16_Measurement
Range crm:E54_Dimension

hole separation op

IRI https://w3id.org/reo/holeSeparation
Is Defined By Roll Edition Ontology
Description

This property associates the measurement of a copy with the distance between adjacent tracks as found on it, stated with P90 has value and P91 has unit.

Sub Property Of crm:P40_observed_dimension
Domain crm:E16_Measurement
Range crm:E54_Dimension

involved edit op

IRI https://w3id.org/reo/involvedEdit
Is Defined By Roll Edition Ontology
Description

This property associates a version of a roll with an edit by which it was made from the version it is based on. It is a shortcut of the path R17i was created by, F28 Expression Creation, P9 consists of.

Domain lrmoo:F2_Expression
Range Edit c
Property Chain Axiom

paired with op

IRI https://w3id.org/reo/pairedWith
Is Defined By Roll Edition Ontology
Description

This property associates two perforations whose distance from one another is fixed: whatever displaces the one displaces the other, as a 'forzando on' belongs with its 'forzando off'. Any two perforations may be paired. The property is symmetric and is stated on one side only. A perforation belongs to at most one pair, and the members of a pair are not themselves aligned with anything.

Domain Perforation c
Range Perforation c

pattern op

IRI https://w3id.org/reo/pattern
Is Defined By Roll Edition Ontology
Description

This property states the punching pattern of a hole: how a long perforation is broken into a chain of holes by bridges of paper, and whether the rows of holes align across the tracks. The values are the types regular, accelerating and staggering at https://w3id.org/reo/type/, following the distinction drawn by Phillips (2016).

Sub Property Of crm:P2_has_type
Domain crm:E26_Physical_Feature
Range crm:E55_Type
Bibliographic Citation

Phillips, Peter: Piano Rolls and Contemporary Player Pianos. The Catalogues, Technologies, Archiving and Accessibility. PhD thesis, Sydney Conservatorium of Music, University of Sydney, 2016.

punch diameter op

IRI https://w3id.org/reo/punchDiameter
Is Defined By Roll Edition Ontology
Description

This property associates the measurement of a copy with the mean diameter of its punched holes, stated with P90 has value and P91 has unit.

Sub Property Of crm:P40_observed_dimension
Domain crm:E16_Measurement
Range crm:E54_Dimension

removed op

IRI https://w3id.org/reo/removed
Is Defined By Roll Edition Ontology
Description

This property associates an edit with a symbol of the version it is based on that is absent from the version being created.

Domain Edit c
Range crm:E90_Symbolic_Object

scope op

IRI https://w3id.org/reo/scope
Is Defined By Roll Edition Ontology
Description

This property states which half of the keyboard an expression perforation acts on. On rolls for the Welte-Mignon and most other reproducing systems the expression is split at a fixed point into a bass and a treble half, each with its own set of commands. The values are the types bass and treble at https://w3id.org/reo/type/.

Sub Property Of crm:P2_has_type
Domain Expression c
Range crm:E55_Type

tempo op

IRI https://w3id.org/reo/tempo
Is Defined By Roll Edition Ontology
Description

This property associates an edition with the speed at which it lets the roll run. Since the take-up spool accelerates as paper winds onto it, the speed is an interval from the beginning of the roll (from) to its end (to), in the unit given by P91 has unit, as feet or metres per minute.

Sub Property Of crm:P43_has_dimension
Domain lrmoo:F2_Expression
Range crm:E54_Dimension

witness op

IRI https://w3id.org/reo/witness
Is Defined By Roll Edition Ontology
Description

This property associates a digital edition with a physical copy of the roll on which it is based. It is a shortcut of the path R17i was created by, F28 Expression Creation, P16 used specific object.

Domain lrmoo:F2_Expression
Range lrmoo:F5_Item
Property Chain Axiom
, ,

Datatype Properties

from dp

IRI https://w3id.org/reo/from
Is Defined By Roll Edition Ontology
Description

This property states the lower bound of a dimension that is an interval, as the extent of a hole along the roll (in millimetres from its beginning) or across it (in tracks of the tracker bar), or the speed at the beginning of a roll. The unit is given by P91 has unit.

Sub Property Of crm:P90_has_value
Domain crm:E54_Dimension
Range xsd:decimal

height dp

IRI https://w3id.org/reo/height
Is Defined By Roll Edition Ontology
Description

This property states the extent of a copy along the roll, from its beginning to its end.

Sub Property Of crm:P90_has_value
Domain crm:E54_Dimension
Range xsd:decimal

pitch dp

IRI https://w3id.org/reo/pitch
Is Defined By Roll Edition Ontology
Description

This property states the pitch of a note as a MIDI note number, 60 for middle C. It is a shortcut of the path P43 has dimension, E54 Dimension typed 'pitch', P90 has value.

Domain Note c
Range xsd:integer

siglum dp

IRI https://w3id.org/reo/siglum
Is Defined By Roll Edition Ontology
Description

This property states the short label by which an edition refers to a version of the roll, such as A, B1 or B2. It is a shortcut of the path P1 is identified by, E42 Identifier typed 'siglum', P190 has symbolic content.

Domain lrmoo:F2_Expression
Range xsd:string

to dp

IRI https://w3id.org/reo/to
Is Defined By Roll Edition Ontology
Description

This property states the upper bound of a dimension that is an interval. A hole that occupies a single track has no upper bound across the roll.

Sub Property Of crm:P90_has_value
Domain crm:E54_Dimension
Range xsd:decimal

width dp

IRI https://w3id.org/reo/width
Is Defined By Roll Edition Ontology
Description

This property states the extent of a copy across the roll.

Sub Property Of crm:P90_has_value
Domain crm:E54_Dimension
Range xsd:decimal

Namespaces

crm
http://www.cidoc-crm.org/cidoc-crm/
dcterms
http://purl.org/dc/terms/
lrmoo
http://iflastandards.info/ns/lrm/lrmoo/
owl
http://www.w3.org/2002/07/owl#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
reo
https://w3id.org/reo/
reot
https://w3id.org/reo/type/
skos
http://www.w3.org/2004/02/skos/core#
vann
http://purl.org/vocab/vann/
xsd
http://www.w3.org/2001/XMLSchema#

Legend

c Classes
op Object Properties
dp Datatype Properties

made by p y LODE 3.6.0 with the OntPub profile

Table of Contents