<rest>

A non-sounding event found in the source being transcribed.
1.1.2.3 Model changes in MEI, 1.3.2 Events and Controlevents, 2.2.3 Basic Music Events, 4.2.5.3 Rests, 4.3.4 Tuplets, 4.3.5.4 Fermata, 5.1 Durations, 5.6.4 Dots, 7.2.1 Basic Structure
Module
MEI.shared
Attributes
altsym, beam, breaksec, class, color, copyof, corresp, cue, dots, dots.ges, dur, dur.ges, dur.metrical, dur.ppq, dur.real, dur.recip, enclose, facs, fermata, follows, fontfam, fontname, fontsize, fontstyle, fontweight, glyph.auth, glyph.name, glyph.num, glyph.uri, ho, label, layer, letterspacing, lineheight, loc, n, next, num, numbase, oloc, ploc, precedes, prev, resp, sameas, spaces, staff, synch, to, tstamp, tstamp.ges, tstamp.real, tuplet, type, vo, when, x, xml:base, xml:id, y
altsym(optional)Provides a way of pointing to a user-defined symbol. It must contain a reference to an ID of a symbolDef element elsewhere in the document. Value conforms to data.URI.
<rest>att.rest.visatt.altSym@altsym
beam(optional)Indicates that this event is "under a beam". One or more values from data.BEAM, separated by spaces.
<rest>att.rest.anlatt.rest.anl.cmnatt.beamPresent@beam
breaksec(optional)Presence of this attribute indicates that the secondary beam should be broken following this note/chord. The value of the attribute records the number of beams which should remain unbroken. Value is a positive integer.
<rest>att.rest.visatt.rest.vis.cmnatt.beamSecondary@breaksec
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.typedatt.classed@class
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
<rest>att.rest.visatt.color@color
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<rest>att.commonatt.linking@copyof
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@corresp
cue(optional) Value conforms to data.BOOLEAN.
<rest>att.rest.logatt.cue@cue
dots(optional)Records the number of augmentation dots required by a written dotted duration. Value conforms to data.AUGMENTDOT.
<rest>att.rest.logatt.augmentDots@dots
dots.ges(optional)Number of dots required for a gestural duration when different from that of the written duration. Value conforms to data.AUGMENTDOT.
<rest>att.rest.gesatt.duration.ges@dots.ges
dur(optional)Records the duration of a rest using the relative durational values provided by the data.DURATIONRESTS datatype. Value conforms to data.DURATIONRESTS.
<rest>att.rest.logatt.restduration.log@dur
dur.ges(optional)Records performed duration information that differs from the written duration. Value conforms to data.DURATION.GESTURAL.
<rest>att.rest.gesatt.duration.ges@dur.ges
dur.metrical(optional)Duration as a count of units provided in the time signature denominator. Value is a decimal number.
<rest>att.rest.gesatt.duration.ges@dur.metrical
dur.ppq(optional)Duration recorded as pulses-per-quarter note, e.g., MIDI clicks or MusicXML divisions. Value is a positive integer, including 0.
<rest>att.rest.gesatt.duration.ges@dur.ppq
dur.real(optional)Duration in seconds, e.g., 1.732. Value is a decimal number.
<rest>att.rest.gesatt.duration.ges@dur.real
dur.recip(optional)Duration as an optionally dotted Humdrum **recip value. Value is a token.
<rest>att.rest.gesatt.duration.ges@dur.recip
enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14. Value conforms to data.ENCLOSURE.
<rest>att.rest.visatt.enclosingChars@enclose
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
<rest>att.facsimile@facs
fermata(optional)Indicates the attachment of a fermata to this element. If visual information about the fermata needs to be recorded, then a fermata element should be employed instead. Value conforms to data.STAFFREL.basic.
<rest>att.rest.anlatt.rest.anl.cmnatt.fermataPresent@fermata
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@follows
fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
<rest>att.rest.visatt.typography@fontfam
fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
<rest>att.rest.visatt.typography@fontname
fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%. Value conforms to data.FONTSIZE.
<rest>att.rest.visatt.typography@fontsize
fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
<rest>att.rest.visatt.typography@fontstyle
fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
<rest>att.rest.visatt.typography@fontweight
glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
<rest>att.rest.visatt.extSymatt.extSym.auth@glyph.auth
glyph.name(optional)Glyph name. Value is plain text.
<rest>att.rest.visatt.extSymatt.extSym.names@glyph.name
glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF. Value conforms to data.HEXNUM.
<rest>att.rest.visatt.extSymatt.extSym.names@glyph.num
glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Value conforms to data.URI.
<rest>att.rest.visatt.extSymatt.extSym.auth@glyph.uri
ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
<rest>att.rest.visatt.visualOffsetatt.visualOffset.ho@ho
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
<rest>att.commonatt.labelled@label
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
<rest>att.rest.logatt.eventatt.layerIdent@layer
letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
<rest>att.rest.visatt.typography@letterspacing
lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
<rest>att.rest.visatt.typography@lineheight
loc(optional)Holds the staff location of the feature. Value conforms to data.STAFFLOC.
<rest>att.rest.visatt.staffLoc@loc
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
<rest>att.commonatt.nNumberLike@n
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@next
num(optional)Along with numbase, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
<rest>att.rest.gesatt.rest.ges.mensuralatt.duration.ratio@num
numbase(optional)Along with num, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
<rest>att.rest.gesatt.rest.ges.mensuralatt.duration.ratio@numbase
oloc(optional)Records staff location in terms of written octave. Value conforms to data.OCTAVE.
<rest>att.rest.visatt.staffLoc.pitched@oloc
ploc(optional)Captures staff location in terms of written pitch name. Value conforms to data.PITCHNAME.
<rest>att.rest.visatt.staffLoc.pitched@ploc
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@prev
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.responsibility@resp
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@sameas
spaces(optional)States how many spaces are covered by the rest. Value is a positive integer.
<rest>att.rest.visatt.rest.vis.mensural@spaces
staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
<rest>att.rest.logatt.eventatt.staffIdent@staff
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<rest>att.commonatt.linking@synch
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
<rest>att.rest.visatt.visualOffsetatt.visualOffset.to@to
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
<rest>att.rest.logatt.eventatt.timestamp.log@tstamp
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
<rest>att.rest.logatt.eventatt.timestamp.ges@tstamp.ges
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
<rest>att.rest.logatt.eventatt.timestamp.ges@tstamp.real
tuplet(optional)Indicates that this feature participates in a tuplet. If visual information about the tuplet needs to be recorded, then a tuplet element should be employed. One or more values from data.TUPLET, separated by spaces.
<rest>att.rest.anlatt.rest.anl.cmnatt.tupletPresent@tuplet
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
<rest>att.commonatt.typed@type
vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
<rest>att.rest.visatt.visualOffsetatt.visualOffset.vo@vo
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
<rest>att.rest.logatt.eventatt.alignment@when
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
<rest>att.rest.visatt.xy@x
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
<rest>att.commonatt.basic@xml:base
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
<rest>att.commonatt.basicatt.id@xml:id
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
<rest>att.rest.visatt.xy@y
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply a number-like designation for an element.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.facsimile) Attributes that associate a feature corresponding with all or part of an image.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
(MEI.analytical) Analytical domain attributes.
(MEI.cmn) Analytical domain attributes in the CMN repertoire.
(MEI.cmn) Attributes that indicate whether an event lies under a beam.
beam(optional)Indicates that this event is "under a beam". One or more values from data.BEAM, separated by spaces.
(MEI.shared) Attributes indicating the attachment of a fermata to the feature.
fermata(optional)Indicates the attachment of a fermata to this element. If visual information about the fermata needs to be recorded, then a fermata element should be employed instead. Value conforms to data.STAFFREL.basic.
(MEI.shared) Attributes for indicating the presence of a tuplet.
tuplet(optional)Indicates that this feature participates in a tuplet. If visual information about the tuplet needs to be recorded, then a tuplet element should be employed. One or more values from data.TUPLET, separated by spaces.
(MEI.gestural) Gestural domain attributes.
(MEI.gestural) Attributes that record performed duration that differs from a feature’s written duration.
dur.ges(optional)Records performed duration information that differs from the written duration. Value conforms to data.DURATION.GESTURAL.
dots.ges(optional)Number of dots required for a gestural duration when different from that of the written duration. Value conforms to data.AUGMENTDOT.
dur.metrical(optional)Duration as a count of units provided in the time signature denominator. Value is a decimal number.
dur.ppq(optional)Duration recorded as pulses-per-quarter note, e.g., MIDI clicks or MusicXML divisions. Value is a positive integer, including 0.
dur.real(optional)Duration in seconds, e.g., 1.732. Value is a decimal number.
dur.recip(optional)Duration as an optionally dotted Humdrum **recip value. Value is a token.
(MEI.mensural) Gestural domain attributes.
(MEI.shared) Attributes that describe duration as a ratio.
num(optional)Along with numbase, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
numbase(optional)Along with num, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
(MEI.shared) Logical domain attributes.
(MEI.shared) Attributes that record the number of dots of augmentation.
dots(optional)Records the number of augmentation dots required by a written dotted duration. Value conforms to data.AUGMENTDOT.
(MEI.shared) Attributes that describe "cue-ness".
cue(optional) Value conforms to data.BOOLEAN.
(MEI.shared) Attributes that express duration of rests in musical terms.
dur(optional)Records the duration of a rest using the relative durational values provided by the data.DURATIONRESTS datatype. Value conforms to data.DURATIONRESTS.
(MEI.shared) Attributes that apply to all written events, , note, chord, rest, etc.
(MEI.performance) Temporal alignment attributes.
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
(MEI.shared) Attributes that identify the layer to which a feature applies.
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
(MEI.shared) Attributes for identifying the staff associated with the current feature.
staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
(MEI.gestural) Attributes that record a performed (as opposed to notated) time stamp.
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
(MEI.shared) Attributes that record a time stamp in terms of musical time, , beats[.fractional beat part].
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
(MEI.cmn) Logical domain attributes in the CMN repertoire.
(MEI.visual) Visual domain attributes.
(MEI.usersymbols) Attributes supplying pointers to user-defined symbols.
altsym(optional)Provides a way of pointing to a user-defined symbol. It must contain a reference to an ID of a symbolDef element elsewhere in the document. Value conforms to data.URI.
(MEI.shared) Visual color attributes.
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
(MEI.shared) Attributes that capture characters used to enclose symbols having a cautionary or editorial function.
enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14. Value conforms to data.ENCLOSURE.
(MEI.externalsymbols) Attributes used to associate MEI features with corresponding glyphs in an externally-defined standard such as SMuFL.
(MEI.externalsymbols) Attributes that point to an external symbol authority.
glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Value conforms to data.URI.
(MEI.externalsymbols) Attributes that specify names or values taken from an external symbol authority.
glyph.name(optional)Glyph name. Value is plain text.
glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF. Value conforms to data.HEXNUM.
(MEI.cmn) Visual domain attributes.
(MEI.cmn) Attributes that capture information about secondary beaming.
breaksec(optional)Presence of this attribute indicates that the secondary beam should be broken following this note/chord. The value of the attribute records the number of beams which should remain unbroken. Value is a positive integer.
(MEI.mensural) Visual domain attributes.
spaces(optional)States how many spaces are covered by the rest. Value is a positive integer.
(MEI.shared) Attributes that identify location on a staff in terms of lines and spaces.
loc(optional)Holds the staff location of the feature. Value conforms to data.STAFFLOC.
(MEI.shared) Attributes that identify location on a staff in terms of pitch and octave.
ploc(optional)Captures staff location in terms of written pitch name. Value conforms to data.PITCHNAME.
oloc(optional)Records staff location in terms of written octave. Value conforms to data.OCTAVE.
(MEI.shared) Typographical attributes.
fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%. Value conforms to data.FONTSIZE.
fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
(MEI.shared) Visual offset attributes. Some items may have their location recorded in terms of offsets from their programmatically-determined location. The ho attribute records the horizontal offset while vo records the vertical. The to attribute holds a timestamp offset, the most common use of which is as an alternative to the ho attribute.
(MEI.shared) Horizontal offset attributes.
ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
(MEI.shared) Horizontal offset attributes specified in terms of time.
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
(MEI.shared) Vertical offset attributes.
vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
(MEI.shared) Output coordinate attributes. Some elements may have their exact rendered *output* coordinates recorded. x and y attributes indicate where to place the rendered output. Recording the coordinates of a feature in a facsimile requires the use of the facs attribute.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
Common Music Notation (CMN) repertoire component declarations.
beam(optional)Indicates that this event is "under a beam". One or more values from data.BEAM, separated by spaces.
breaksec(optional)Presence of this attribute indicates that the secondary beam should be broken following this note/chord. The value of the attribute records the number of beams which should remain unbroken. Value is a positive integer.
External symbols component declarations.
glyph.auth(optional)A name or label associated with the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Suggested values are: "smufl" (Standard Music Font Layout.)
glyph.name(optional)Glyph name. Value is plain text.
glyph.num(optional)Numeric glyph reference in hexadecimal notation, e.g., "#xE000" or "U+E000". N.B. SMuFL version 1.18 uses the range U+E000 - U+ECBF. Value conforms to data.HEXNUM.
glyph.uri(optional)The web-accessible location of the controlled vocabulary from which the value of glyph.name or glyph.num is taken, or the textual content of the element. Value conforms to data.URI.
Facsimile component declarations.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
Gestural component declarations.
dots.ges(optional)Number of dots required for a gestural duration when different from that of the written duration. Value conforms to data.AUGMENTDOT.
dur.ges(optional)Records performed duration information that differs from the written duration. Value conforms to data.DURATION.GESTURAL.
dur.metrical(optional)Duration as a count of units provided in the time signature denominator. Value is a decimal number.
dur.ppq(optional)Duration recorded as pulses-per-quarter note, e.g., MIDI clicks or MusicXML divisions. Value is a positive integer, including 0.
dur.real(optional)Duration in seconds, e.g., 1.732. Value is a decimal number.
dur.recip(optional)Duration as an optionally dotted Humdrum **recip value. Value is a token.
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
Mensural repertoire component declarations.
spaces(optional)States how many spaces are covered by the rest. Value is a positive integer.
Performance component declarations.
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
Component declarations that are shared between two or more modules.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
cue(optional) Value conforms to data.BOOLEAN.
dots(optional)Records the number of augmentation dots required by a written dotted duration. Value conforms to data.AUGMENTDOT.
dur(optional)Records the duration of a rest using the relative durational values provided by the data.DURATIONRESTS datatype. Value conforms to data.DURATIONRESTS.
enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14. Value conforms to data.ENCLOSURE.
fermata(optional)Indicates the attachment of a fermata to this element. If visual information about the fermata needs to be recorded, then a fermata element should be employed instead. Value conforms to data.STAFFREL.basic.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY.
fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME.
fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., small, larger, etc., or percentage values relative to normal size, e.g., 125%. Value conforms to data.FONTSIZE.
fontstyle(optional)Records the style of a font, i.e., italic, oblique, or normal. Value conforms to data.FONTSTYLE.
fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT.
ho(optional)Records a horizontal adjustment to a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
loc(optional)Holds the staff location of the feature. Value conforms to data.STAFFLOC.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
num(optional)Along with numbase, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
numbase(optional)Along with num, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value is a positive integer.
oloc(optional)Records staff location in terms of written octave. Value conforms to data.OCTAVE.
ploc(optional)Captures staff location in terms of written pitch name. Value conforms to data.PITCHNAME.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
to(optional)Records a timestamp adjustment of a feature’s programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET.
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
tuplet(optional)Indicates that this feature participates in a tuplet. If visual information about the tuplet needs to be recorded, then a tuplet element should be employed. One or more values from data.TUPLET, separated by spaces.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
vo(optional)Records the vertical adjustment of a feature’s programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTSIGNED.
x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
y(optional)Encodes a y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value is a decimal number.
User-defined symbols component declarations.
altsym(optional)Provides a way of pointing to a user-defined symbol. It must contain a reference to an ID of a symbolDef element elsewhere in the document. Value conforms to data.URI.
Member of
model.eventLikeGroups event elements that occur in all notational repertoires.
Contained By
tabGrpA group of simultaneous tab notes, comparable to a chord in CMN. Rarely, may also contain rests, as in some "German" lute tablatures.
(MEI.shared) Groups event elements that occur in all notational repertoires.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
graceGrpA container for a sequence of grace notes.
ligatureA mensural notation symbol that combines two or more notes into a single sign.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
(MEI.shared) Groups notated events that may appear at the layer level in all repertoires.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
layerAn independent stream of events on a staff.
lemContains the lemma, or base text, of a textual variation.
oLayerA layer that contains an alternative to material in another layer.
origContains material which is marked as following the original, rather than being normalized or corrected.
rdgContains a single reading within a textual variation.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Common Music Notation (CMN) repertoire component declarations.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
graceGrpA container for a sequence of grace notes.
oLayerA layer that contains an alternative to material in another layer.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
Critical apparatus component declarations.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
Editorial and transcriptional component declarations.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Mensural repertoire component declarations.
ligatureA mensural notation symbol that combines two or more notes into a single sign.
Component declarations that are shared between two or more modules.
layerAn independent stream of events on a staff.
Tablature component declarations.
tabGrpA group of simultaneous tab notes, comparable to a chord in CMN. Rarely, may also contain rests, as in some "German" lute tablatures.
May Contain
dotDot of augmentation or division.
(MEI.critapp) Groups elements that contain a critical apparatus entry.
appContains one or more alternative encodings.
(MEI.edittrans) Groups elements for editorial interventions that may be useful both in transcribing and in authoring processes.
choiceGroups a number of alternative encodings for the same point in a text.
substGroups transcriptional elements when the combination is to be regarded as a single intervention in the text.
(MEI.edittrans) Groups elements used for editorial transcription of pre-existing source materials.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
gapIndicates a point where material has been omitted in a transcription, whether as part of sampling practice or for editorial reasons described in the MEI header.
handShiftMarks the beginning of a passage written in a new hand, or of a change in the scribe, writing style, ink or character of the document hand.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Critical apparatus component declarations.
appContains one or more alternative encodings.
Editorial and transcriptional component declarations.
addMarks an addition to the text.
choiceGroups a number of alternative encodings for the same point in a text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
gapIndicates a point where material has been omitted in a transcription, whether as part of sampling practice or for editorial reasons described in the MEI header.
handShiftMarks the beginning of a passage written in a new hand, or of a change in the scribe, writing style, ink or character of the document hand.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
substGroups transcriptional elements when the combination is to be regarded as a single intervention in the text.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Component declarations that are shared between two or more modules.
dotDot of augmentation or division.
Remarks

See (Read, p. 96-102). Do not confuse this element with the space element, which is used as an aid for visual alignment.

Constraints

The value of @line must be less than or equal to the number of lines on the staff.

Declaration
<elementSpec ident="rest" module="MEI.shared">
<desc xml:lang="en">A non-sounding event found in the source being transcribed.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.facsimile"/>
<memberOf key="att.rest.anl"/>
<memberOf key="att.rest.ges"/>
<memberOf key="att.rest.log"/>
<memberOf key="att.rest.vis"/>
<memberOf key="model.eventLike"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:choice>
<rng:ref name="dot"/>
<rng:ref name="model.appLike"/>
<rng:ref name="model.editLike"/>
<rng:ref name="model.transcriptionLike"/>
</rng:choice>
</rng:zeroOrMore>
</content>
<constraintSpec ident="Check_restline" scheme="schematron">
<constraint>
<sch:rule context="mei:rest[@line]">
<sch:let name="thisstaff" value="ancestor::mei:staff/@n"/>
<sch:assert test="number(@line) <= number(preceding::mei:staffDef[@n=$thisstaff and @lines][1]/@lines)">The value of @line must be less than or equal to the number of lines on the staff.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<remarks xml:lang="en">
<p>See (Read, p. 96-102). Do not confuse this element with the <gi scheme="MEI">space</gi> element, which is used as an aid for visual alignment.</p>
</remarks>
</elementSpec>
MEI Version: 5.1-dev(#6d3dd03)