<tuplet>

A 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.
Module
Attributes
@bracket.place, @bracket.visible, @color, @dur, @endid, @label, @layer, @num, @num.format, @num.place, @num.visible, @numbase, @staff, @startid, @type, @xml:id
@bracket.place(optional)Used to state where a tuplet bracket will be placed in relation to the note heads. Value conforms to data.STAFFREL.basic.
@bracket.visible(optional)States whether a bracket should be rendered with a tuplet. Value conforms to data.BOOLEAN.
@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.
@dur(optional)When a duration cannot be represented as a single power-of-two value, multiple space-separated values that add up to the total duration may be used. One or more values from data.DURATION, separated by spaces.
@endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI.
@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.
@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.
@num.format(optional)Controls how the num:numbase ratio is to be displayed. Allowed values are: "count" (Only the num attribute is displayed, , '7'.), "ratio" (Both the num and numbase attributes are displayed, , '7:4'.)
@num.place(optional)States where the number will be placed in relation to the notational feature. Value conforms to data.STAFFREL.basic.
@num.visible(optional)Determines if the number is visible. Value conforms to data.BOOLEAN.
@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.
@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.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
@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.
@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) Attributes common to many elements.
(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 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.cmn) Logical domain attributes.
(MEI.shared) Attributes that permit total duration to be represented by multiple values.
@dur(optional)When a duration cannot be represented as a single power-of-two value, multiple space-separated values that add up to the total duration may be used. One or more values from data.DURATION, separated by spaces.
(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) Attributes that apply to all written events, e.g., note, chord, rest, etc.
(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.shared) Attributes recording the identifiers of the first and last elements of a sequence of elements to which the current element is associated.
@endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI.
(MEI.shared) Attributes that identify a relative starting point.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
(MEI.visual) Visual domain attributes.
@bracket.place(optional)Used to state where a tuplet bracket will be placed in relation to the note heads. Value conforms to data.STAFFREL.basic.
@bracket.visible(optional)States whether a bracket should be rendered with a tuplet. Value conforms to data.BOOLEAN.
@num.format(optional)Controls how the num:numbase ratio is to be displayed. Allowed values are: "count" (Only the num attribute is displayed, , '7'.), "ratio" (Both the num and numbase attributes are displayed, , '7:4'.)
(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.cmn) Attributes that record the placement and visibility of numbers that accompany a bowed notational feature.
@num.place(optional)States where the number will be placed in relation to the notational feature. Value conforms to data.STAFFREL.basic.
@num.visible(optional)Determines if the number is visible. Value conforms to data.BOOLEAN.
(MEI.gestural) Gestural domain attributes.
@num.place(optional)States where the number will be placed in relation to the notational feature. Value conforms to data.STAFFREL.basic.
@num.visible(optional)Determines if the number is visible. Value conforms to data.BOOLEAN.
@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.
@dur(optional)When a duration cannot be represented as a single power-of-two value, multiple space-separated values that add up to the total duration may be used. One or more values from data.DURATION, separated by spaces.
@endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI.
@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.
@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.
@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.
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
@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.
@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.
@bracket.place(optional)Used to state where a tuplet bracket will be placed in relation to the note heads. Value conforms to data.STAFFREL.basic.
@bracket.visible(optional)States whether a bracket should be rendered with a tuplet. Value conforms to data.BOOLEAN.
@num.format(optional)Controls how the num:numbase ratio is to be displayed. Allowed values are: "count" (Only the num attribute is displayed, , '7'.), "ratio" (Both the num and numbase attributes are displayed, , '7:4'.)
Member of
model.eventLike.cmnGroups events that appear in CMN.
Contained By
(MEI.cmn) Groups events that appear in CMN.
<beam>A container for a series of explicitly beamed events that begins and ends entirely within a measure.
<graceGrp>A container for a sequence of grace notes.
<tuplet>A 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.cmn) Groups notated events that may appear at the layer level in CMN.
(MEI.shared) Groups notated events that may appear at the layer level in all repertoires.
<layer>An independent stream of events on a staff.
<beam>A container for a series of explicitly beamed events that begins and ends entirely within a measure.
<graceGrp>A container for a sequence of grace notes.
<tuplet>A 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.
<layer>An independent stream of events on a staff.
May Contain
(MEI.cmn) Groups events that appear in CMN.
<bTrem>A rapid alternation on a single pitch or chord.
<beam>A container for a series of explicitly beamed events that begins and ends entirely within a measure.
<beatRpt>An indication that material on a preceding beat should be repeated.
<fTrem>A 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.
<graceGrp>A container for a sequence of grace notes.
<halfmRpt>A half-measure repeat in any meter.
<tuplet>A 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 event elements that occur in all notational repertoires.
<chord>A simultaneous sounding of two or more notes in the same layer *with the same duration*.
<clef>Indication of the exact location of a particular note on the staff and, therefore, the other notes as well.
<clefGrp>A set of simultaneously-occurring clefs.
<note>A single pitched event.
<rest>A non-sounding event found in the source being transcribed.
<space>A placeholder used to fill an incomplete measure, layer, etc. most often so that the combined duration of the events equals the number of beats in the measure.
<tabDurSym>A visual indication of the duration of a <tabGrp>.
<tabGrp>A 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 have the same function as a key signature.
(MEI.shared) Groups elements that represent a meter signature.
<bTrem>A rapid alternation on a single pitch or chord.
<beam>A container for a series of explicitly beamed events that begins and ends entirely within a measure.
<beatRpt>An indication that material on a preceding beat should be repeated.
<fTrem>A 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.
<graceGrp>A container for a sequence of grace notes.
<halfmRpt>A half-measure repeat in any meter.
<tuplet>A 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.
<chord>A simultaneous sounding of two or more notes in the same layer *with the same duration*.
<clef>Indication of the exact location of a particular note on the staff and, therefore, the other notes as well.
<clefGrp>A set of simultaneously-occurring clefs.
<note>A single pitched event.
<rest>A non-sounding event found in the source being transcribed.
<space>A placeholder used to fill an incomplete measure, layer, etc. most often so that the combined duration of the events equals the number of beats in the measure.
<tabDurSym>A visual indication of the duration of a <tabGrp>.
<tabGrp>A group of simultaneous tab notes, comparable to a <chord> in CMN. Rarely, may also contain rests, as in some "German" lute tablatures.
Remarks

The <beam> sub-element is allowed so that custom beaming may be indicated, e.g., a septuplet may be divided into a group of three plus a group of four notes. See Read, p. 187-215. The <tuplet> element may also used for bowed tremolo (Read, p. 394) and double, triple, or flutter tonguing (Read, p. 348-349); that is, for repetition of the same pitch. In the case of irrational durations, such as such as two quarter notes in the time of five 8th notes in a measure of 5/8 time, decimal values may be used in the @dur.ges attribute. For example, the @dur.ges attribute would take the value 2.5 if the @midi.div attribute’s value was 1. The @num and @numbase attributes may be used for explicit labelling of a tuplet, such as, '3' with an 8th-note triplet, '3:2' over a quarter-note triplet, etc. The rendering of the ratio, however, is dependent on the @num.format attribute found in the att.vis.tuplet attribute class.

Declaration
<elementSpec rend="add" ident="tuplet" module="MEI.cmn">
<desc xml:lang="en">A 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.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.tuplet.log"/>
<memberOf key="att.tuplet.vis"/>
<memberOf key="att.tuplet.ges"/>
<memberOf key="model.eventLike.cmn"/>
</classes>
<content>
<zeroOrMore>
<choice>
<ref name="model.appLike"/>
<ref name="model.editLike"/>
<ref name="model.eventLike"/>
<ref name="model.eventLike.cmn"/>
</choice>
</zeroOrMore>
</content>
<remarks xml:lang="en">
<p>The <gi scheme="MEI">beam</gi> sub-element is allowed so that custom beaming may be indicated,
<abbr>e.g.</abbr>
, a septuplet may be divided into a group of three plus a group of four notes. See Read, p. 187-215. The <gi scheme="MEI">tuplet</gi> element may also used for bowed tremolo (Read, p. 394) and double, triple, or flutter tonguing (Read, p. 348-349); that is, for repetition of the same pitch. In the case of irrational durations, such as such as two quarter notes in the time of five 8th notes in a measure of 5/8 time, decimal values may be used in the <att>dur.ges</att> attribute. For example, the <att>dur.ges</att> attribute would take the value
<val>2.5</val>
if the <att>midi.div</att> attribute’s value was
<val>1</val>
. The <att>num</att> and <att>numbase</att> attributes may be used for explicit labelling of a tuplet, such as, '3' with an 8th-note triplet, '3:2' over a quarter-note triplet, etc. The rendering of the ratio, however, is dependent on the <att>num.format</att> attribute found in the att.vis.tuplet attribute class.</p>
</remarks>
</elementSpec>