<grpSym>

(group symbol) – A brace or bracket used to group two or more staves of a score or part.
Module
Attributes
altsym, class, color, copyof, corresp, endid, facs, follows, fontfam, fontname, fontsize, fontstyle, fontweight, glyph.auth, glyph.name, glyph.num, glyph.uri, ho, label, letterspacing, level, lineheight, n, next, precedes, prev, resp, sameas, startid, symbol, synch, to, type, vo, x, xml:base, xml:id, y
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.
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.
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.
endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI.
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.
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.
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.
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.
letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
level(optional)Indicates the nesting level of staff grouping symbols. Value is a positive integer.
lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
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.
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.
startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
symbol(optional)Specifies the symbol used to group a set of staves. Allowed values are: "brace" (Curved symbol, , {.), "bracket" (Square symbol, , [, but with curved/angled top and bottom segments.), "bracketsq" (Square symbol, , [, with horizontal top and bottom segments.), "line" (Line symbol, , |, (wide) line without top and bottom curved/horizontal segments.), "none" (Grouping symbol missing.)
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, 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.
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.
vo(optional)Records the vertical adjustment of 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.
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.shared) Logical domain attributes.
level(optional)Indicates the nesting level of staff grouping symbols. Value is a positive integer.
(MEI.shared) Attributes that describe the symbol used to group a set of staves.
symbol(optional)Specifies the symbol used to group a set of staves. Allowed values are: "brace" (Curved symbol, , {.), "bracket" (Square symbol, , [, but with curved/angled top and bottom segments.), "bracketsq" (Square symbol, , [, with horizontal top and bottom segments.), "line" (Line symbol, , |, (wide) line without top and bottom curved/horizontal segments.), "none" (Grouping symbol missing.)
(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.
(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.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) 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) Visual offset attributes. Some items may have their location recorded in terms of offsets from their programmatically-determined location. The ho attribute records the horizontal offset while vo records the vertical. The to attribute holds a timestamp offset, the most common use of which is as an alternative to the ho attribute.
(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) Vertical offset attributes.
vo(optional)Records the vertical adjustment of 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) 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.gestural) Gestural domain attributes.
(MEI.analytical) Analytical domain attributes.
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.
Component declarations that are shared between two or more modules.
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.
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.
endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI.
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.
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.
letterspacing(optional)Indicates letter spacing (aka tracking) in analogy to the CSS letter-spacing property. Value conforms to data.MEASUREMENTTYPOGRAPHYSIGNED.
level(optional)Indicates the nesting level of staff grouping symbols. Value is a positive integer.
lineheight(optional)Indicates line height in analogy to the CSS line-height property. Value conforms to either data.MEASUREMENTTYPOGRAPHYUNSIGNED or data.PERCENT.
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.
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.
startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI.
symbol(optional)Specifies the symbol used to group a set of staves. Allowed values are: "brace" (Curved symbol, , {.), "bracket" (Square symbol, , [, but with curved/angled top and bottom segments.), "bracketsq" (Square symbol, , [, with horizontal top and bottom segments.), "line" (Line symbol, , |, (wide) line without top and bottom curved/horizontal segments.), "none" (Grouping symbol missing.)
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, 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.
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.
vo(optional)Records the vertical adjustment of 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.
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.
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
(grpSym isn't member of any model class)
Contained By
scoreDefContainer for score meta-information.
staffGrpA group of bracketed or braced staves.
Component declarations that are shared between two or more modules.
scoreDefContainer for score meta-information.
staffGrpA group of bracketed or braced staves.
May Contain
(MEI.shared) Groups elements used to assign a label to other parts of a document.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
labelAbbrA label on the pages following the first.
Component declarations that are shared between two or more modules.
labelA container for document text that identifies the feature to which it is attached. For a "tool tip" or other generated label, use the label attribute.
labelAbbrA label on the pages following the first.
Remarks

This element provides an alternative to the staffGrp element's symbol attribute. It may be used when exact placement or editorial details for the grouping symbol must be recorded.

Constraints

In scoreDef, grpSym must have startid, endid, and level attributes.
In staffGrp, grpSym must not have startid, endid, or level attributes.

Declaration
<elementSpec ident="grpSym" module="MEI.shared">
<gloss versionDate="2022-05-18" xml:lang="en">group symbol</gloss>
<desc xml:lang="en">A brace or bracket used to group two or more staves of a score or part.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.facsimile"/>
<memberOf key="att.grpSym.log"/>
<memberOf key="att.grpSym.vis"/>
<memberOf key="att.grpSym.ges"/>
<memberOf key="att.grpSym.anl"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:ref name="model.labelLike"/>
</rng:zeroOrMore>
</content>
<constraintSpec ident="check_grpSym_attributes_scoreDef" scheme="schematron">
<constraint>
<sch:rule context="mei:grpSym[parent::mei:scoreDef]">
<sch:assert test="@startid and @endid and @level">In scoreDef, grpSym must have startid, endid, and level attributes.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<constraintSpec ident="check_grpSym_attributes_staffDef" scheme="schematron">
<constraint>
<sch:rule context="mei:grpSym[parent::mei:staffGrp]">
<sch:assert test="not(@startid or @endid or @level)">In staffGrp, grpSym must not have startid, endid, or level attributes.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<remarks xml:lang="en">
<p>This element provides an alternative to the <gi scheme="MEI">staffGrp</gi> element's <att>symbol</att> attribute. It may be used when exact placement or editorial details for the grouping symbol must be recorded.</p>
</remarks>
</elementSpec>