<beam>

A container for a series of explicitly beamed events that begins and ends entirely within a measure.
Module
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.
@cue(optional)
@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.
@layer(optional)Identifies the layer to which a feature applies.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@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.
(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.
(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.
(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.
(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.
(MEI.shared) Attributes for identifying the staff or staff group 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.
(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.
(MEI.shared) Attributes that describe "cue-ness".
@cue(optional)
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation.
@cue(optional)
@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.
@layer(optional)Identifies the layer to which a feature applies.
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable.
@type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels.
@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.
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.
<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.
<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 xmlns="http://www.tei-c.org/ns/1.0" 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>
<alternate minOccurs="0" maxOccurs="unbounded">
<classRef key="model.eventLike"/>
<classRef key="model.eventLike.cmn"/>
<classRef key="model.appLike"/>
<classRef key="model.editLike"/>
<classRef key="model.transcriptionLike"/>
</alternate>
</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>