<beam>

A container for a series of explicitly beamed events that begins and ends entirely within a measure.
2.3.1 Beams, 2.3.4 Tuplets
Module
MEI.cmn
Attributes
@color, @cue, @label, @layer, @staff, @type, @xml:id
@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.
<beam>att.beam.visatt.color@color
@cue(optional) Value conforms to data.BOOLEAN.
<beam>att.beam.visatt.cue@cue
@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.
<beam>att.commonatt.labelled@label
@layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
<beam>att.beam.logatt.eventatt.layerIdent@layer
@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.
<beam>att.beam.logatt.eventatt.staffIdent@staff
@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.
<beam>att.commonatt.typed@type
@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.
<beam>att.commonatt.id@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 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.visual) Visual domain attributes.
(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 describe "cue-ness".
@cue(optional) 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.
@cue(optional) Value conforms to data.BOOLEAN.
@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.
@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.
@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.
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

For beams that cross the bar line, use the beamSpan [not available in this MEI customization] element. Secondary beams may be broken explicitly using the @breaksec attribute on the notes or chords under the beam. Automated beaming, as opposed to explicitly marked beams, may be indicated for an entire score, part or section by using the @beam.group and @beam.rests attributes on these elements.

Constraints

A beam that contains neither a copyof nor sameas attribute must have at least 2 note, rest, chord, or space descendants.

Declaration
<elementSpec rend="add" ident="beam" module="MEI.cmn">
<desc xml:lang="en">A container for a series of explicitly beamed events that begins and ends entirely within a measure.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.beam.log"/>
<memberOf key="att.beam.vis"/>
<memberOf key="model.eventLike.cmn"/>
</classes>
<content>
<zeroOrMore>
<choice>
<ref name="model.eventLike"/>
<ref name="model.eventLike.cmn"/>
<ref name="model.appLike"/>
<ref name="model.editLike"/>
<ref name="model.transcriptionLike"/>
</choice>
</zeroOrMore>
</content>
<constraintSpec ident="When_not_copyof_beam_content" scheme="schematron">
<constraint>
<sch:rule context="mei:beam[not(@copyof or @sameas)]">
<sch:assert test="count(descendant::*[local-name()='note' or local-name()='rest' or local-name()='chord' or local-name()='space']) > 1">A beam that contains neither a copyof nor sameas attribute must have at least 2 note, rest, chord, or space descendants.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<remarks xml:lang="en">
<p>For beams that cross the bar line, use the <gi scheme="MEI">beamSpan</gi> element. Secondary beams may be broken explicitly using the <att>breaksec</att> attribute on the notes or chords under the beam. Automated beaming, as opposed to explicitly marked beams, may be indicated for an entire score, part or section by using the <att>beam.group</att> and <att>beam.rests</att> attributes on these elements.</p>
</remarks>
</elementSpec>
MEI Version: 6.0-dev+basic(#cd58552)