<patch>

Describes a physical writing surface attached to the original document.
Module
MEI.header
Attributes
attached.by, attached.to, cert, class, copyof, corresp, decls, evidence, follows, hand, instant, label, n, next, precedes, prev, resp, sameas, seq, state, synch, type, unit, x, xml:base, xml:id, y
attached.by(optional)Describes the method of attachment of the patch. Allowed values are: "glue" (patch is glued on surface beneath.), "thread" (patch is sewn on surface beneath.), "needle" (patch is pinned to the surface beneath.), "tape" (patch is taped on surface beneath using an adhesive strip.), "staple" (patch is attached on surface beneath using a staple.)
attached.to(required)Describes the position of the patch on the parent folium / bifolium. Allowed values are: "outer.recto" (patch attached to outer recto side of bifolium.), "inner.verso" (patch attached to inner verso side of bifolium.), "inner.recto" (patch attached to inner recto side of bifolium.), "outer.verso" (patch attached to outer verso side of bifolium.), "recto" (patch attached to recto side of folium.), "verso" (patch attached to verso side of folium.)
cert(optional)Signifies the degree of certainty or precision associated with a feature. Value conforms to data.CERTAINTY.
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.
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.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Allowed values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
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.
hand(optional)Signifies the hand responsible for an action. The value must be the ID of a hand element declared in the header. Value conforms to data.URI.
instantThe @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process. Value must conform to data.BOOLEAN or unknown.
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.
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.
seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred. Value is a positive integer.
statePoints to the genetic state that results from this modification. 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.
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.
unit(optional)Indicates the unit of measurement. Allowed values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
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.
attached.to(required)Describes the position of the patch on the parent folium / bifolium. Allowed values are: "outer.recto" (patch attached to outer recto side of bifolium.), "inner.verso" (patch attached to inner verso side of bifolium.), "inner.recto" (patch attached to inner recto side of bifolium.), "outer.verso" (patch attached to outer verso side of bifolium.), "recto" (patch attached to recto side of folium.), "verso" (patch attached to verso side of folium.)
attached.by(optional)Describes the method of attachment of the patch. Allowed values are: "glue" (patch is glued on surface beneath.), "thread" (patch is sewn on surface beneath.), "needle" (patch is pinned to the surface beneath.), "tape" (patch is taped on surface beneath using an adhesive strip.), "staple" (patch is attached on surface beneath using a staple.)
(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.shared) Attributes describing the support for and the certainty of an assertion.
cert(optional)Signifies the degree of certainty or precision associated with a feature. Value conforms to data.CERTAINTY.
evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Allowed values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
(MEI.shared) Attributes that record the unit of measurement in which a value is expressed.
unit(optional)Indicates the unit of measurement. Allowed values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
(MEI.edittrans) Attributes for elements encoding authorial or scribal intervention when transcribing manuscript or similar sources.
(MEI.genetic) Attributes that pertain to a genetic state.
instantThe @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process. Value must conform to data.BOOLEAN or unknown.
statePoints to the genetic state that results from this modification. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which identify a document hand.
hand(optional)Signifies the hand responsible for an action. The value must be the ID of a hand element declared in the header. Value conforms to data.URI.
(MEI.shared) Provides attributes for elements which may be associated with particular contextual elements within the header.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes that describe order within a collection of features.
seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred. Value is a positive integer.
(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.
Genetic encoding component declarations.
instantThe @instant attribute is syntactic sugar for classifying a scribal intervention as an ad-hoc modification; that is, one which does not interrupt the writing process. Value must conform to data.BOOLEAN or unknown.
statePoints to the genetic state that results from this modification. One or more values from data.URI, separated by spaces.
Metadata header component declarations.
attached.by(optional)Describes the method of attachment of the patch. Allowed values are: "glue" (patch is glued on surface beneath.), "thread" (patch is sewn on surface beneath.), "needle" (patch is pinned to the surface beneath.), "tape" (patch is taped on surface beneath using an adhesive strip.), "staple" (patch is attached on surface beneath using a staple.)
attached.to(required)Describes the position of the patch on the parent folium / bifolium. Allowed values are: "outer.recto" (patch attached to outer recto side of bifolium.), "inner.verso" (patch attached to inner verso side of bifolium.), "inner.recto" (patch attached to inner recto side of bifolium.), "outer.verso" (patch attached to outer verso side of bifolium.), "recto" (patch attached to recto side of folium.), "verso" (patch attached to verso side of folium.)
Component declarations that are shared between two or more modules.
cert(optional)Signifies the degree of certainty or precision associated with a feature. Value conforms to data.CERTAINTY.
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.
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.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
evidence(optional)Indicates the nature of the evidence supporting the reliability or accuracy of the intervention or interpretation. Allowed values are: "internal" (There is evidence within the document to support the intervention.), "external" (There is evidence outside the document to support the intervention.), "conjecture" (The assertion has been made by the editor, cataloguer, or scholar on the basis of their expertise.)
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.
hand(optional)Signifies the hand responsible for an action. The value must be the ID of a hand element declared in the header. 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.
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.
seq(optional)Used to assign a sequence number related to the order in which the encoded features carrying this attribute are believed to have occurred. Value is a positive integer.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, 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.
unit(optional)Indicates the unit of measurement. Allowed values are: "byte" (Byte.), "char" (Character.), "cm" (Centimeter.), "deg" (Degree.), "in" (Inch.), "issue" (Serial issue.), "ft" (Foot.), "m" (Meter.), "mm" (Millimeter.), "page" (Page.), "pc" (Pica.), "pt" (Point.), "px" (Pixel.), "rad" (Radian.), "record" (Record.), "vol" (Serial volume.), "vu" (MEI virtual unit.)
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.
Member of
model.paperModLikeGroups elements dealing with modifications of document pages.
Contained By
(MEI.header) Groups elements dealing with modifications of document pages.
bifoliumDescribes a folded sheet of paper.
foliumDescribes a single leaf of paper.
Metadata header component declarations.
bifoliumDescribes a folded sheet of paper.
foliumDescribes a single leaf of paper.
May Contain
(MEI.header) Collects bifoliumlike elements.
bifoliumDescribes a folded sheet of paper.
(MEI.header) Collects foliumlike elements.
foliumDescribes a single leaf of paper.
Metadata header component declarations.
bifoliumDescribes a folded sheet of paper.
foliumDescribes a single leaf of paper.
Remarks

A patch must always contain a folium or bifolium element. The @x and @y attributes are used to position the patch on its parent surface by indicating the upper left corner of the patch. The size of the patch is encoded using the @height and @width attributes on the child folium (or bifolium).

Constraints

The allowed positions of a patch depend on its parent element.
A patch element must contain either a folium or a bifolium element.

Declaration
<elementSpec ident="patch" module="MEI.header">
<desc>Describes a physical writing surface attached to the original document.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.evidence"/>
<memberOf key="att.measurement"/>
<memberOf key="att.trans"/>
<memberOf key="att.xy"/>
<memberOf key="model.paperModLike"/>
</classes>
<content>
<rng:choice>
<rng:ref name="model.foliumLike"/>
<rng:ref name="model.bifoliumLike"/>
</rng:choice>
</content>
<constraintSpec ident="check_attached_position" scheme="schematron">
<constraint>
<sch:rule context="mei:patch">
<sch:assert test="(parent::mei:folium and @attached.to = ('recto','verso')) or (parent::mei:bifolium and @attached.to = ('outer.recto','inner.verso','inner.recto','outer.verso'))">The allowed positions of a patch depend on its parent element.</sch:assert>
<sch:assert test="count(child::node()) gt 0">A patch element must contain either a folium or a bifolium element.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<attList>
<attDef ident="attached.to" usage="req">
<desc>Describes the position of the patch on the parent folium / bifolium.</desc>
<valList type="closed">
<valItem ident="outer.recto">
<desc>patch attached to outer recto side of bifolium.</desc>
</valItem>
<valItem ident="inner.verso">
<desc>patch attached to inner verso side of bifolium.</desc>
</valItem>
<valItem ident="inner.recto">
<desc>patch attached to inner recto side of bifolium.</desc>
</valItem>
<valItem ident="outer.verso">
<desc>patch attached to outer verso side of bifolium.</desc>
</valItem>
<valItem ident="recto">
<desc>patch attached to recto side of folium.</desc>
</valItem>
<valItem ident="verso">
<desc>patch attached to verso side of folium.</desc>
</valItem>
</valList>
</attDef>
<attDef ident="attached.by" usage="opt">
<desc>Describes the method of attachment of the patch.</desc>
<datatype>
<rng:data type="NMTOKEN"/>
</datatype>
<valList type="semi">
<valItem ident="glue">
<desc>patch is glued on surface beneath.</desc>
</valItem>
<valItem ident="thread">
<desc>patch is sewn on surface beneath.</desc>
</valItem>
<valItem ident="needle">
<desc>patch is pinned to the surface beneath.</desc>
</valItem>
<valItem ident="tape">
<desc>patch is taped on surface beneath using an adhesive strip.</desc>
</valItem>
<valItem ident="staple">
<desc>patch is attached on surface beneath using a staple.</desc>
</valItem>
</valList>
</attDef>
</attList>
<remarks>
<p>A patch must always contain a <gi scheme="MEI">folium</gi> or <gi scheme="MEI">bifolium</gi> element. The @x and @y attributes are used to position the patch on its parent surface by indicating the upper left corner of the patch. The size of the patch is encoded using the @height and @width attributes on the child folium (or bifolium).</p>
</remarks>
<!--<remarks> <p>TODO: It remains unclear how to specify which part of the patch is attached to the underlying surface. Right now, the assumption is that it is always attached with the patch's verso (or outer.verso) side, but what about patches that can be folded up or down?</p> </remarks>-->
</elementSpec>