Element: grouping [group music-data]
Description
The grouping type is used for musical analysis. When the type attribute is "start" or "single", it usually contains one or more feature elements. The number attribute is used for distinguishing between overlapping and hierarchical groupings. The member-of attribute allows for easy distinguishing of what grouping elements are in what hierarchy. Feature elements contained within a "stop" type of grouping may be ignored.
This element is flexible to allow for different types of analyses. Future versions of the MusicXML format may add elements that can represent more standardized categories of analysis data, allowing for easier data sharing.
Derived By
Type grouping
Attributes
| Name | Type | Required? | Default | Description |
|---|---|---|---|---|
| type | start-stop-single | Yes |
|
|
| number | xs:token | No | 1 | The number attribute is used for distinguishing between overlapping and hierarchical groupings. |
| member-of | xs:token | No | The member-of attribute allows for easy distinguishing of what grouping elements are in what hierarchy. |
Content Model
Contains elements as defined in the following table.
| Component | Type | Occurs | Default | Description |
|---|---|---|---|---|
 |
1..1 |
|
||
| feature | feature | 0..* |
The feature type is a part of the grouping element used for musical analysis. The type attribute represents the type of the feature and the element content represents its value. This type is flexible to allow for different analyses. |
|
Referenced By
Example
<grouping type="start">
<feature/>
</grouping>
<note default-x="129">
<rest/>
<duration>4</duration>
<voice>1</voice>
<type>eighth</type>
</note>
<note default-x="229">
<pitch>
<step>G</step>
<octave>4</octave>
</pitch>
<duration>4</duration>
<voice>1</voice>
<type>eighth</type>
<stem default-y="5">up</stem>
<beam number="1">begin</beam>
</note>
<note default-x="330">
<pitch>
<step>G</step>
<octave>4</octave>
</pitch>
<duration>4</duration>
<voice>1</voice>
<type>eighth</type>
<stem default-y="5">up</stem>
<beam number="1">continue</beam>
</note>
<note default-x="430">
<pitch>
<step>G</step>
<octave>4</octave>
</pitch>
<duration>4</duration>
<voice>1</voice>
<type>eighth</type>
<stem default-y="5">up</stem>
<beam number="1">end</beam>
</note>
</measure>
<!--=======================================================-->
<measure number="2" width="343">
<note default-x="97">
<pitch>
<step>E</step>
<alter>-1</alter>
<octave>4</octave>
</pitch>
<duration>16</duration>
<voice>1</voice>
<type>half</type>
<stem default-y="-4.5">up</stem>
</note>
<grouping type="stop">
<feature/>
</grouping>
</measure>
