<note>

Module
Attributes
accid, accid.ges, altsym, artic, artic.ges, beam, breaksec, class, color, colored, copyof, corresp, cue, deg, dots, dots.ges, dur, dur.ges, dur.metrical, dur.ppq, dur.quality, dur.real, dur.recip, enclose, extremis, facs, fermata, follows, fontfam, fontname, fontsize, fontstyle, fontweight, gliss, glyph.auth, glyph.name, glyph.num, glyph.uri, grace, grace.time, head.altsym, head.auth, head.color, head.fill, head.fillcolor, head.mod, head.rotation, head.shape, head.visible, ho, instr, intm, label, layer, letterspacing, lig, lineheight, loc, lv, mfunc, n, next, num, numbase, oct, oct.ges, ornam, pclass, pname, pname.ges, pnum, precedes, prev, psolfa, resp, sameas, slur, staff, stem.dir, stem.form, stem.len, stem.mod, stem.pos, stem.sameas, stem.visible, stem.with, stem.x, stem.y, syl, synch, tab.align, tab.anchorline, tab.course, tab.fing, tab.fret, tab.line, tab.string, tie, to, tstamp, tstamp.ges, tstamp.real, tuplet, type, vel, visible, when, x, xml:base, xml:id, y
accid(optional)Captures a written accidental. Value conforms to data.ACCIDENTAL.WRITTEN.
accid.ges(optional)Records the performed pitch inflection. Value conforms to data.ACCIDENTAL.GESTURAL.
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.
artic(optional)Encodes the written articulation(s). Articulations are normally encoded in order from the note head outward; that is, away from the stem. See additional notes at att.vis.note. Only articulations should be encoded in the artic attribute; for example, fingerings should be encoded using the fing element. One or more values from data.ARTICULATION, separated by spaces.
artic.ges(optional)Records performed articulation that differs from the written value. One or more values from data.ARTICULATION, separated by spaces.
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.
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.
colored(optional)Indicates this feature is 'colored'; that is, it is a participant in a change in rhythmic values. In mensural notation, coloration is indicated by colored notes (red, black, etc.) where void notes would otherwise occur. In CMN, coloration is indicated by an inverse color; that is, the note head is void when it would otherwise be filled and vice versa. Value conforms to data.BOOLEAN.
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.
deg(optional)Captures scale degree information using Humdrum **deg syntax -- an optional indicator of melodic approach (^ = ascending approach, v = descending approach), a scale degree value (1 = tonic ... 7 = leading tone), and an optional indication of chromatic alteration, 1, v7, ^1, or v5+, for example. The amount of chromatic alternation is not indicated. Value conforms to data.SCALEDEGREE.
dots(optional)Records the number of augmentation dots required by a written dotted duration. Value conforms to data.AUGMENTDOT.
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(optional)Records the duration of a feature using the relative durational values provided by the data.DURATION datatype. Value conforms to data.DURATION.
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.quality(recommended)Encodes the durational quality of a mensural note using the values provided by the data.DURQUALITY.mensural datatype (i.e., the perfect / imperfect / altered / major / minor / duplex quality of a note). Value conforms to data.DURQUALITY.mensural.
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.
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.
extremis(optional)Indicates an extreme, indefinite performed pitch. Allowed values are: "highest" (Highest note the performer can play.), "lowest" (Lowest note the performer can play.)
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.
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.
gliss(optional)Indicates that this element participates in a glissando. If visual information about the glissando needs to be recorded, then a gliss element should be employed instead. Value conforms to data.GLISSANDO.
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.
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
head.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.
head.auth(optional)A name or label associated with the controlled vocabulary from which a numerical value of head.shape is taken. Suggested values are: "smufl" (Standard Music Font Layout.)
head.color(optional)Captures the overall color of a notehead. Value conforms to data.COLOR.
head.fill(optional)Describes how/if the notehead is filled. Value conforms to data.FILL.
head.fillcolor(optional)Captures the fill color of a notehead if different from the overall note color. Value conforms to data.COLOR.
head.mod(optional)Records any additional symbols applied to the notehead. One or more values from data.NOTEHEADMODIFIER, separated by spaces.
head.rotation(optional)Describes rotation applied to the basic notehead shape. A positive value rotates the notehead in a counter-clockwise fashion, while negative values produce clockwise rotation. Value conforms to data.ROTATION.
head.shape(optional)Used to override the head shape normally used for the given duration. Value conforms to data.HEADSHAPE.
head.visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
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.
instr(optional)Provides a way of pointing to a MIDI instrument definition. It must contain the ID of an instrDef element elsewhere in the document. Value conforms to data.URI.
intm(optional)Encodes the melodic interval from the previous pitch. The value may be a general directional indication (u, d, s, etc.), an indication of diatonic interval direction, quality, and size, or a precise numeric value in half steps. Value conforms to data.INTERVAL.MELODIC.
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.
lig(optional)Indicates this element’s participation in a ligature. Value conforms to data.LIGATUREFORM.
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.
lv(optional)Indicates the attachment of an l.v. (laissez vibrer) sign to this element. Value conforms to data.BOOLEAN.
mfunc(optional)Describes melodic function using Humdrum **embel syntax. Value conforms to data.MELODICFUNCTION.
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.
oct(optional)Captures written octave information. Value conforms to data.OCTAVE.
oct.ges(optional)Records performed octave information that differs from the written value. Value conforms to data.OCTAVE.
ornam(optional)Indicates that this element has an attached ornament. If visual information about the ornament is needed, then one of the elements that represents an ornament (mordent, trill, or turn) should be employed. One or more values from data.ORNAM.cmn, separated by spaces.
pclass(optional)Holds pitch class information. Value conforms to data.PITCHCLASS.
pname(optional)Contains a written pitch name. Value conforms to data.PITCHNAME.
pname.ges(optional)Contains a performed pitch name that differs from the written value. Value conforms to data.PITCHNAME.GESTURAL.
pnum(optional)Holds a pitch-to-number mapping, a base-40 or MIDI note number, for example. Value conforms to data.PITCHNUMBER.
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.
psolfa(optional)Contains sol-fa designation, e.g., do, re, mi, etc., in either a fixed or movable Do system. Value is a NMTOKEN.
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.
slur(optional)Indicates that this element participates in a slur. If visual information about the slur needs to be recorded, then a slur element should be employed. One or more values from data.SLUR, 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.
stem.dir(optional)Describes the direction of a stem. Value conforms to data.STEMDIRECTION.
stem.form(optional)Records the form of the stem. Value conforms to data.STEMFORM.mensural.
stem.len(optional)Encodes the stem length. Value conforms to data.MEASUREMENTUNSIGNED.
stem.mod(optional)Encodes any stem "modifiers"; that is, symbols rendered on the stem, such as tremolo or Sprechstimme indicators. Value conforms to data.STEMMODIFIER.
stem.pos(optional)Records the position of the stem in relation to the note head(s). Value conforms to data.STEMPOSITION.
stem.sameas(optional)Points to a note element in a different layer whose stem is shared. The linked notes should be rendered like a chord though they are part of different layers. Value conforms to data.URI.
stem.visible(optional)Determines whether a stem should be displayed. Value conforms to data.BOOLEAN.
stem.with(optional)Contains an indication of which staff a note or chord that logically belongs to the current staff should be visually placed on; that is, the one above or the one below. Value conforms to data.NEIGHBORINGLAYER.
stem.x(optional)Records the output x coordinate of the stem’s attachment point. Value is a decimal number.
stem.y(optional)Records the output y coordinate of the stem’s attachment point. Value is a decimal number.
syl(optional)Holds an associated sung text syllable. Value is plain text.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
tab.align(optional)Attribute that describes the vertical alignment of tablature symbols. Only applicable in cases where the symbols' vertical position does not communicate other information, such as courses (i.e., only in German lute tablature). Typical values are top and bottom. Value conforms to data.VERTICALALIGNMENT.
tab.anchorline(optional)Used in German lute tablature where the vertical alignment of tab notes is consistent but cannot be identified using a typical value of tab.align (i.e., top or bottom). Specifies the horizontal strand corresponding to the lines attribute on staffDef that anchors the vertical position of tab notes. This anchorline is used as the vertical starting position when stacking tab notes into chords. Single tab notes simply occupy this position. Chords "grow upwards" from this position. If the chord extends further than the number of available horizontal strands ("lines") above the anchorline, the entire chord is shifted downward until its top tab note is positioned on the top-most line. (Note that in German lute tablature, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.course(optional)Records which course is to be played. Value conforms to data.COURSENUMBER.
tab.fing(optional)This attribute is deprecated and will be removed in a future version. Indicates which finger, if any, should be used to play an individual string. The index, middle, ring, and little fingers are represented by the values 1-4, while t is for the thumb. The values x and o indicate muffled and open strings, respectively. Value conforms to data.FINGER.FRET.
tab.fret(optional)Records the location at which a string should be stopped against a fret. Value conforms to data.FRETNUMBER.
tab.line(optional)Used in German lute tablature in cases where vertical positioning deviates from the norm which can be specified by tab.align. Indicates the position of the tab note on one of the horizontal strands corresponding to the lines attribute on staffDef. (Note that in this case, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.string(optional)This attribute is deprecated in favor of tab.course and will be removed in a future version. Records which string is to be played. Value conforms to data.STRINGNUMBER.
tie(optional)Indicates that this element participates in a tie. If visual information about the tie needs to be recorded, then a tie element should be employed. One or more values from data.TIE, 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.
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.
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.
vel(optional)MIDI Note-on/off velocity. Value conforms to data.MIDIVALUE.
visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
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.
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.
(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.shared) Attributes for capturing momentary pitch inflection.
accid(optional)Captures a written accidental. Value conforms to data.ACCIDENTAL.WRITTEN.
(MEI.shared) Attributes for capturing the written signs that describe the method of performance.
artic(optional)Encodes the written articulation(s). Articulations are normally encoded in order from the note head outward; that is, away from the stem. See additional notes at att.vis.note. Only articulations should be encoded in the artic attribute; for example, fingerings should be encoded using the fing element. One or more values from data.ARTICULATION, separated by spaces.
(MEI.analytical) Attributes describing the harmonic function of a single pitch.
deg(optional)Captures scale degree information using Humdrum **deg syntax -- an optional indicator of melodic approach (^ = ascending approach, v = descending approach), a scale degree value (1 = tonic ... 7 = leading tone), and an optional indication of chromatic alteration, 1, v7, ^1, or v5+, for example. The amount of chromatic alternation is not indicated. Value conforms to data.SCALEDEGREE.
(MEI.analytical) Attributes that provide for description of intervallic content.
intm(optional)Encodes the melodic interval from the previous pitch. The value may be a general directional indication (u, d, s, etc.), an indication of diatonic interval direction, quality, and size, or a precise numeric value in half steps. Value conforms to data.INTERVAL.MELODIC.
(MEI.analytical) Attributes describing melodic function.
mfunc(optional)Describes melodic function using Humdrum **embel syntax. Value conforms to data.MELODICFUNCTION.
(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.cmn) Attributes that indicate whether an event participates in a glissando.
gliss(optional)Indicates that this element participates in a glissando. If visual information about the glissando needs to be recorded, then a gliss element should be employed instead. Value conforms to data.GLISSANDO.
(MEI.cmn) Attributes that indicate the presence of an l.v. (laissez vibrer) marking attached to a feature. If visual information about the lv sign needs to be recorded, then an element should be employed.
lv(optional)Indicates the attachment of an l.v. (laissez vibrer) sign to this element. Value conforms to data.BOOLEAN.
(MEI.cmnOrnaments) Attributes for marking the presence of an ornament.
ornam(optional)Indicates that this element has an attached ornament. If visual information about the ornament is needed, then one of the elements that represents an ornament (mordent, trill, or turn) should be employed. One or more values from data.ORNAM.cmn, separated by spaces.
(MEI.shared) Attributes for marking the presence of a slur.
slur(optional)Indicates that this element participates in a slur. If visual information about the slur needs to be recorded, then a slur element should be employed. One or more values from data.SLUR, separated by spaces.
(MEI.shared) Attributes that hold associated sung text syllables.
syl(optional)Holds an associated sung text syllable. Value is plain text.
(MEI.shared) Attributes that indicate the presence of a tie.
tie(optional)Indicates that this element participates in a tie. If visual information about the tie needs to be recorded, then a tie element should be employed. One or more values from data.TIE, separated by spaces.
(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.mensural) Analytical domain attributes in the Mensural repertoire.
(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.analytical) Attributes that describe pitch class.
pclass(optional)Holds pitch class information. Value conforms to data.PITCHCLASS.
(MEI.analytical) Attributes that specify pitch using sol-fa.
psolfa(optional)Contains sol-fa designation, e.g., do, re, mi, etc., in either a fixed or movable Do system. Value is a NMTOKEN.
(MEI.gestural) Gestural domain attributes.
extremis(optional)Indicates an extreme, indefinite performed pitch. Allowed values are: "highest" (Highest note the performer can play.), "lowest" (Lowest note the performer can play.)
(MEI.gestural) Attributes for capturing momentary pitch inflection in the gestural domain.
accid.ges(optional)Records the performed pitch inflection. Value conforms to data.ACCIDENTAL.GESTURAL.
(MEI.gestural) Attributes describing the method of performance.
artic.ges(optional)Records performed articulation that differs from the written value. One or more values from data.ARTICULATION, separated by spaces.
(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.midi) Attributes which identify a MIDI instrument.
instr(optional)Provides a way of pointing to a MIDI instrument definition. It must contain the ID of an instrDef element elsewhere in the document. Value conforms to data.URI.
(MEI.midi) MIDI attributes pertaining to key velocity.
vel(optional)MIDI Note-on/off velocity. Value conforms to data.MIDIVALUE.
(MEI.mensural) Gestural domain attributes in the Mensural repertoire.
(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.gestural) Gestural attributes about pitch.
oct.ges(optional)Records performed octave information that differs from the written value. Value conforms to data.OCTAVE.
pname.ges(optional)Contains a performed pitch name that differs from the written value. Value conforms to data.PITCHNAME.GESTURAL.
pnum(optional)Holds a pitch-to-number mapping, a base-40 or MIDI note number, for example. Value conforms to data.PITCHNUMBER.
(MEI.stringtab) String tablature string and fret information.
tab.align(optional)Attribute that describes the vertical alignment of tablature symbols. Only applicable in cases where the symbols' vertical position does not communicate other information, such as courses (i.e., only in German lute tablature). Typical values are top and bottom. Value conforms to data.VERTICALALIGNMENT.
tab.anchorline(optional)Used in German lute tablature where the vertical alignment of tab notes is consistent but cannot be identified using a typical value of tab.align (i.e., top or bottom). Specifies the horizontal strand corresponding to the lines attribute on staffDef that anchors the vertical position of tab notes. This anchorline is used as the vertical starting position when stacking tab notes into chords. Single tab notes simply occupy this position. Chords "grow upwards" from this position. If the chord extends further than the number of available horizontal strands ("lines") above the anchorline, the entire chord is shifted downward until its top tab note is positioned on the top-most line. (Note that in German lute tablature, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.fing(optional)This attribute is deprecated and will be removed in a future version. Indicates which finger, if any, should be used to play an individual string. The index, middle, ring, and little fingers are represented by the values 1-4, while t is for the thumb. The values x and o indicate muffled and open strings, respectively. Value conforms to data.FINGER.FRET.
tab.fret(optional)Records the location at which a string should be stopped against a fret. Value conforms to data.FRETNUMBER.
tab.line(optional)Used in German lute tablature in cases where vertical positioning deviates from the norm which can be specified by tab.align. Indicates the position of the tab note on one of the horizontal strands corresponding to the lines attribute on staffDef. (Note that in this case, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.string(optional)This attribute is deprecated in favor of tab.course and will be removed in a future version. Records which string is to be played. Value conforms to data.STRINGNUMBER.
tab.course(optional)Records which course is to be played. Value conforms to data.COURSENUMBER.
(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) Indication of coloration.
colored(optional)Indicates this feature is 'colored'; that is, it is a participant in a change in rhythmic values. In mensural notation, coloration is indicated by colored notes (red, black, etc.) where void notes would otherwise occur. In CMN, coloration is indicated by an inverse color; that is, the note head is void when it would otherwise be filled and vice versa. Value conforms to data.BOOLEAN.
(MEI.shared) Attributes that describe "cue-ness".
cue(optional) Value conforms to data.BOOLEAN.
(MEI.shared) Attributes that express duration in musical terms.
dur(optional)Records the duration of a feature using the relative durational values provided by the data.DURATION datatype. Value conforms to data.DURATION.
(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.
(MEI.cmn) Attributes that mark a note or chord as a "grace", how it should "steal" time, and how much time should be allotted to the grace note/chord.
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
(MEI.mensural) Logical domain attributes in the Mensural repertoire.
(MEI.shared) Attributes that record written pitch name and octave number.
(MEI.shared) Attributes that record written pitch name.
pname(optional)Contains a written pitch name. Value conforms to data.PITCHNAME.
(MEI.shared) Attributes that record written octave.
oct(optional)Captures written octave information. Value conforms to data.OCTAVE.
(MEI.mensural) Attribute that expresses duration for a given mensural note symbol.
dur.quality(recommended)Encodes the durational quality of a mensural note using the values provided by the data.DURQUALITY.mensural datatype (i.e., the perfect / imperfect / altered / major / minor / duplex quality of a note). Value conforms to data.DURQUALITY.mensural.
(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.shared) Attributes pertaining to the notehead part of a note.
head.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.
head.auth(optional)A name or label associated with the controlled vocabulary from which a numerical value of head.shape is taken. Suggested values are: "smufl" (Standard Music Font Layout.)
head.color(optional)Captures the overall color of a notehead. Value conforms to data.COLOR.
head.fill(optional)Describes how/if the notehead is filled. Value conforms to data.FILL.
head.fillcolor(optional)Captures the fill color of a notehead if different from the overall note color. Value conforms to data.COLOR.
head.mod(optional)Records any additional symbols applied to the notehead. One or more values from data.NOTEHEADMODIFIER, separated by spaces.
head.rotation(optional)Describes rotation applied to the basic notehead shape. A positive value rotates the notehead in a counter-clockwise fashion, while negative values produce clockwise rotation. Value conforms to data.ROTATION.
head.shape(optional)Used to override the head shape normally used for the given duration. Value conforms to data.HEADSHAPE.
head.visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
(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 describe the properties of stemmed features; that is, chords and notes.
stem.dir(optional)Describes the direction of a stem. Value conforms to data.STEMDIRECTION.
stem.len(optional)Encodes the stem length. Value conforms to data.MEASUREMENTUNSIGNED.
stem.mod(optional)Encodes any stem "modifiers"; that is, symbols rendered on the stem, such as tremolo or Sprechstimme indicators. Value conforms to data.STEMMODIFIER.
stem.pos(optional)Records the position of the stem in relation to the note head(s). Value conforms to data.STEMPOSITION.
stem.sameas(optional)Points to a note element in a different layer whose stem is shared. The linked notes should be rendered like a chord though they are part of different layers. Value conforms to data.URI.
stem.visible(optional)Determines whether a stem should be displayed. Value conforms to data.BOOLEAN.
stem.x(optional)Records the output x coordinate of the stem’s attachment point. Value is a decimal number.
stem.y(optional)Records the output y coordinate of the stem’s attachment point. Value is a decimal number.
(MEI.cmn) Attributes that describe the properties of stemmed features; that is, chords and notes.
stem.with(optional)Contains an indication of which staff a note or chord that logically belongs to the current staff should be visually placed on; that is, the one above or the one below. Value conforms to data.NEIGHBORINGLAYER.
(MEI.mensural) Attributes that describe the properties of stemmed features specific to mensural repertoires.
stem.form(optional)Records the form of the stem. Value conforms to data.STEMFORM.mensural.
(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) Attributes describing whether a feature should be displayed.
visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
(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) 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.
(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 in the Mensural repertoire.
lig(optional)Indicates this element’s participation in a ligature. Value conforms to data.LIGATUREFORM.
Analytical component declarations.
deg(optional)Captures scale degree information using Humdrum **deg syntax -- an optional indicator of melodic approach (^ = ascending approach, v = descending approach), a scale degree value (1 = tonic ... 7 = leading tone), and an optional indication of chromatic alteration, 1, v7, ^1, or v5+, for example. The amount of chromatic alternation is not indicated. Value conforms to data.SCALEDEGREE.
intm(optional)Encodes the melodic interval from the previous pitch. The value may be a general directional indication (u, d, s, etc.), an indication of diatonic interval direction, quality, and size, or a precise numeric value in half steps. Value conforms to data.INTERVAL.MELODIC.
mfunc(optional)Describes melodic function using Humdrum **embel syntax. Value conforms to data.MELODICFUNCTION.
pclass(optional)Holds pitch class information. Value conforms to data.PITCHCLASS.
psolfa(optional)Contains sol-fa designation, e.g., do, re, mi, etc., in either a fixed or movable Do system. Value is a NMTOKEN.
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.
gliss(optional)Indicates that this element participates in a glissando. If visual information about the glissando needs to be recorded, then a gliss element should be employed instead. Value conforms to data.GLISSANDO.
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
lv(optional)Indicates the attachment of an l.v. (laissez vibrer) sign to this element. Value conforms to data.BOOLEAN.
stem.with(optional)Contains an indication of which staff a note or chord that logically belongs to the current staff should be visually placed on; that is, the one above or the one below. Value conforms to data.NEIGHBORINGLAYER.
CMN ornament component declarations.
ornam(optional)Indicates that this element has an attached ornament. If visual information about the ornament is needed, then one of the elements that represents an ornament (mordent, trill, or turn) should be employed. One or more values from data.ORNAM.cmn, separated by spaces.
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.
accid.ges(optional)Records the performed pitch inflection. Value conforms to data.ACCIDENTAL.GESTURAL.
artic.ges(optional)Records performed articulation that differs from the written value. One or more values from data.ARTICULATION, separated by spaces.
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.
extremis(optional)Indicates an extreme, indefinite performed pitch. Allowed values are: "highest" (Highest note the performer can play.), "lowest" (Lowest note the performer can play.)
oct.ges(optional)Records performed octave information that differs from the written value. Value conforms to data.OCTAVE.
pname.ges(optional)Contains a performed pitch name that differs from the written value. Value conforms to data.PITCHNAME.GESTURAL.
pnum(optional)Holds a pitch-to-number mapping, a base-40 or MIDI note number, for example. Value conforms to data.PITCHNUMBER.
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.
dur.quality(recommended)Encodes the durational quality of a mensural note using the values provided by the data.DURQUALITY.mensural datatype (i.e., the perfect / imperfect / altered / major / minor / duplex quality of a note). Value conforms to data.DURQUALITY.mensural.
lig(optional)Indicates this element’s participation in a ligature. Value conforms to data.LIGATUREFORM.
stem.form(optional)Records the form of the stem. Value conforms to data.STEMFORM.mensural.
MIDI component declarations.
instr(optional)Provides a way of pointing to a MIDI instrument definition. It must contain the ID of an instrDef element elsewhere in the document. Value conforms to data.URI.
vel(optional)MIDI Note-on/off velocity. Value conforms to data.MIDIVALUE.
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.
accid(optional)Captures a written accidental. Value conforms to data.ACCIDENTAL.WRITTEN.
artic(optional)Encodes the written articulation(s). Articulations are normally encoded in order from the note head outward; that is, away from the stem. See additional notes at att.vis.note. Only articulations should be encoded in the artic attribute; for example, fingerings should be encoded using the fing element. One or more values from data.ARTICULATION, separated by spaces.
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.
colored(optional)Indicates this feature is 'colored'; that is, it is a participant in a change in rhythmic values. In mensural notation, coloration is indicated by colored notes (red, black, etc.) where void notes would otherwise occur. In CMN, coloration is indicated by an inverse color; that is, the note head is void when it would otherwise be filled and vice versa. Value conforms to data.BOOLEAN.
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 feature using the relative durational values provided by the data.DURATION datatype. Value conforms to data.DURATION.
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.
head.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.
head.auth(optional)A name or label associated with the controlled vocabulary from which a numerical value of head.shape is taken. Suggested values are: "smufl" (Standard Music Font Layout.)
head.color(optional)Captures the overall color of a notehead. Value conforms to data.COLOR.
head.fill(optional)Describes how/if the notehead is filled. Value conforms to data.FILL.
head.fillcolor(optional)Captures the fill color of a notehead if different from the overall note color. Value conforms to data.COLOR.
head.mod(optional)Records any additional symbols applied to the notehead. One or more values from data.NOTEHEADMODIFIER, separated by spaces.
head.rotation(optional)Describes rotation applied to the basic notehead shape. A positive value rotates the notehead in a counter-clockwise fashion, while negative values produce clockwise rotation. Value conforms to data.ROTATION.
head.shape(optional)Used to override the head shape normally used for the given duration. Value conforms to data.HEADSHAPE.
head.visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
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.
oct(optional)Captures written octave information. Value conforms to data.OCTAVE.
pname(optional)Contains a 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.
slur(optional)Indicates that this element participates in a slur. If visual information about the slur needs to be recorded, then a slur element should be employed. One or more values from data.SLUR, 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.
stem.dir(optional)Describes the direction of a stem. Value conforms to data.STEMDIRECTION.
stem.len(optional)Encodes the stem length. Value conforms to data.MEASUREMENTUNSIGNED.
stem.mod(optional)Encodes any stem "modifiers"; that is, symbols rendered on the stem, such as tremolo or Sprechstimme indicators. Value conforms to data.STEMMODIFIER.
stem.pos(optional)Records the position of the stem in relation to the note head(s). Value conforms to data.STEMPOSITION.
stem.sameas(optional)Points to a note element in a different layer whose stem is shared. The linked notes should be rendered like a chord though they are part of different layers. Value conforms to data.URI.
stem.visible(optional)Determines whether a stem should be displayed. Value conforms to data.BOOLEAN.
stem.x(optional)Records the output x coordinate of the stem’s attachment point. Value is a decimal number.
stem.y(optional)Records the output y coordinate of the stem’s attachment point. Value is a decimal number.
syl(optional)Holds an associated sung text syllable. Value is plain text.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
tie(optional)Indicates that this element participates in a tie. If visual information about the tie needs to be recorded, then a tie element should be employed. One or more values from data.TIE, 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.
visible(optional)Indicates if a feature should be rendered when the notation is presented graphically or sounded when it is presented in an aural form. Value conforms to data.BOOLEAN.
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.
Tablature component declarations.
tab.align(optional)Attribute that describes the vertical alignment of tablature symbols. Only applicable in cases where the symbols' vertical position does not communicate other information, such as courses (i.e., only in German lute tablature). Typical values are top and bottom. Value conforms to data.VERTICALALIGNMENT.
tab.anchorline(optional)Used in German lute tablature where the vertical alignment of tab notes is consistent but cannot be identified using a typical value of tab.align (i.e., top or bottom). Specifies the horizontal strand corresponding to the lines attribute on staffDef that anchors the vertical position of tab notes. This anchorline is used as the vertical starting position when stacking tab notes into chords. Single tab notes simply occupy this position. Chords "grow upwards" from this position. If the chord extends further than the number of available horizontal strands ("lines") above the anchorline, the entire chord is shifted downward until its top tab note is positioned on the top-most line. (Note that in German lute tablature, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.course(optional)Records which course is to be played. Value conforms to data.COURSENUMBER.
tab.fing(optional)This attribute is deprecated and will be removed in a future version. Indicates which finger, if any, should be used to play an individual string. The index, middle, ring, and little fingers are represented by the values 1-4, while t is for the thumb. The values x and o indicate muffled and open strings, respectively. Value conforms to data.FINGER.FRET.
tab.fret(optional)Records the location at which a string should be stopped against a fret. Value conforms to data.FRETNUMBER.
tab.line(optional)Used in German lute tablature in cases where vertical positioning deviates from the norm which can be specified by tab.align. Indicates the position of the tab note on one of the horizontal strands corresponding to the lines attribute on staffDef. (Note that in this case, the lines are conceptual rather than visible). Value conforms to data.CLEFLINE.
tab.string(optional)This attribute is deprecated in favor of tab.course and will be removed in a future version. Records which string is to be played. Value conforms to data.STRINGNUMBER.
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.chordPartGroups elements that may appear as part of the content of a chord element.
model.eventLikeGroups event elements that occur in all notational repertoires.
Contained By
bTremA rapid alternation on a single pitch or chord.
fTremA rapid alternation between a pair of notes (or chords or perhaps between a note and a chord) that are (usually) farther apart than a major second.
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 elements that may appear as part of the content of a chord element.
chordA simultaneous sounding of two or more notes in the same layer *with the same duration*.
(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.
bTremA rapid alternation on a single pitch or chord.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
fTremA rapid alternation between a pair of notes (or chords or perhaps between a note and a chord) that are (usually) farther apart than a major second.
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.
chordA simultaneous sounding of two or more notes in the same layer *with the same duration*.
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
plicaPlica
stemA stem element.
(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.
(MEI.lyrics) Groups elements that contain a lyric verse.
refrainRecurring lyrics, especially at the end of each verse or stanza of a poem or song lyrics; a chorus.
verseDivision of a poem or song lyrics, sometimes having a fixed length, meter or rhyme scheme; a stanza.
(MEI.shared) Groups elements that modify note-like features.
accidRecords a temporary alteration to the pitch of a note.
articAn indication of how to play a note or chord.
dotDot of augmentation or division.
(MEI.shared) Groups elements that contain a lyric syllable.
sylIndividual lyric syllable.
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.
Lyrics component declarations.
refrainRecurring lyrics, especially at the end of each verse or stanza of a poem or song lyrics; a chorus.
verseDivision of a poem or song lyrics, sometimes having a fixed length, meter or rhyme scheme; a stanza.
Mensural repertoire component declarations.
plicaPlica
stemA stem element.
Component declarations that are shared between two or more modules.
accidRecords a temporary alteration to the pitch of a note.
articAn indication of how to play a note or chord.
dotDot of augmentation or division.
sylIndividual lyric syllable.
Remarks

The accid and artic sub-elements may be used instead of the note element’s attributes when accid and artic represent first-class objects, e.g., when they require attributes, such as x and y location attributes. Similarly, the syl sub-element may be used instead of the syl attribute. The verse sub-element may be used to group text syllables by verse. The colored attribute may be used to indicate coloration. In the mensural repertoire, coloration is a temporary change in the underlying mensuration from perfect to imperfect. In the CMN repertoire, coloration is an inversion of the note head’s normal rendition, that is, the note head is void when it would otherwise be filled and vice versa. Do not confuse this with visual color.

Declaration
<elementSpec ident="note" module="MEI.shared">
<desc xml:lang="en">A single pitched event.
<!-- (Read, p. 63) -->
</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.facsimile"/>
<memberOf key="att.note.anl"/>
<memberOf key="att.note.ges"/>
<memberOf key="att.note.log"/>
<memberOf key="att.note.vis"/>
<memberOf key="model.chordPart"/>
<memberOf key="model.eventLike"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:choice>
<rng:ref name="model.noteModifierLike"/>
<rng:ref name="model.verseLike"/>
<rng:ref name="model.sylLike"/>
<rng:ref name="model.appLike"/>
<rng:ref name="model.editLike"/>
<rng:ref name="model.transcriptionLike"/>
<rng:ref name="plica"/>
<rng:ref name="stem"/>
</rng:choice>
</rng:zeroOrMore>
</content>
<remarks xml:lang="en">
<p>The <gi scheme="MEI">accid</gi> and <gi scheme="MEI">artic</gi> sub-elements may be used instead of the note element’s attributes when accid and artic represent first-class objects,
<abbr>e.g.</abbr>
, when they require attributes, such as <att>x</att> and <att>y</att> location attributes. Similarly, the <gi scheme="MEI">syl</gi> sub-element may be used instead of the <att>syl</att> attribute. The verse sub-element may be used to group text syllables by verse. The <att>colored</att> attribute may be used to indicate coloration. In the mensural repertoire, coloration is a temporary change in the underlying mensuration from perfect to imperfect. In the CMN repertoire, coloration is an inversion of the note head’s normal rendition, that is, the note head is void when it would otherwise be filled and vice versa. Do not confuse this with visual color.</p>
</remarks>
</elementSpec>