<cutout>

A cutout is a section of a document sheet that has been removed and is now missing.
Module
Attributes
cert, class, copyof, corresp, decls, evidence, follows, hand, height, instant, label, n, next, precedes, prev, removed.by, removed.from, resp, sameas, seq, state, synch, type, unit, width, x, xml:base, xml:id, y
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.
height(optional)Measurement of the vertical dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
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.
removed.by(optional)Describes the method of removing the cutout. Allowed values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from verso side of folium.)
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.)
width(optional)Measurement of the horizontal dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
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.
removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from verso side of folium.)
removed.by(optional)Describes the method of removing the cutout. Allowed values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
(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 that capture the dimensions of an entity.
(MEI.shared) Attributes that describe vertical size.
height(optional)Measurement of the vertical dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
(MEI.shared) Attributes that describe horizontal size.
width(optional)Measurement of the horizontal dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
(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.
removed.by(optional)Describes the method of removing the cutout. Allowed values are: "cut" (section is cleanly cut by a knife, scissor or other sharp blade.), "rip" (section is ripped off the page, leaving a rough edge.)
removed.from(required)Describes the position of the cutout on the parent folium / bifolium. Allowed values are: "outer.recto" (removed from outer recto side of bifolium.), "inner.verso" (removed from inner verso side of bifolium.), "inner.recto" (removed from inner recto side of bifolium.), "outer.verso" (removed from outer verso side of bifolium.), "recto" (removed from recto side of folium.), "verso" (removed from 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.
height(optional)Measurement of the vertical dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
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.)
width(optional)Measurement of the horizontal dimension of an entity. Value conforms to data.MEASUREMENTUNSIGNED.
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

The dimensions (@width, @height) of the parent element (e.g., folium) indicate the size of the bounding box of the remaining part of the page. That is, if the complete lower half of a page has been cut, the @width and @height attributes describe the remaining upper half. If, in contrast, only the lower right quarter of the page has been cut, these attributes still indicate the size of the full page (assuming that the removed section was a regular rectangle).

The dimensions (@width, @height) on cutout itself are only to be used when there is a "gap" in the manuscript that allows to specify the dimensions of that missing part. In this case, the bounding box dimensions are given, together with @x and @y to indicate the upper left point on the original page. If, however, the removed section is available by itself, then a corresponding folium (or bifolium) should be placed inside the cutout element, and should provide it’s own dimensions using @width and @height there. In this case, @width and @height on cutout is expendable.

Declaration
<elementSpec ident="cutout" module="MEI.header">
<desc xml:lang="en">A cutout is a section of a document sheet that has been removed and is now missing.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.dimensions"/>
<memberOf key="att.evidence"/>
<memberOf key="att.measurement"/>
<memberOf key="att.trans"/>
<memberOf key="att.xy"/>
<memberOf key="model.paperModLike"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:choice>
<rng:ref name="model.foliumLike"/>
<rng:ref name="model.bifoliumLike"/>
</rng:choice>
</rng:zeroOrMore>
</content>
<attList>
<attDef ident="removed.from" usage="req">
<desc xml:lang="en">Describes the position of the cutout on the parent folium / bifolium.</desc>
<valList type="closed">
<valItem ident="outer.recto">
<desc xml:lang="en">removed from outer recto side of bifolium.</desc>
</valItem>
<valItem ident="inner.verso">
<desc xml:lang="en">removed from inner verso side of bifolium.</desc>
</valItem>
<valItem ident="inner.recto">
<desc xml:lang="en">removed from inner recto side of bifolium.</desc>
</valItem>
<valItem ident="outer.verso">
<desc xml:lang="en">removed from outer verso side of bifolium.</desc>
</valItem>
<valItem ident="recto">
<desc xml:lang="en">removed from recto side of folium.</desc>
</valItem>
<valItem ident="verso">
<desc xml:lang="en">removed from verso side of folium.</desc>
</valItem>
</valList>
</attDef>
<attDef ident="removed.by" usage="opt">
<desc xml:lang="en">Describes the method of removing the cutout.</desc>
<datatype>
<rng:data type="NMTOKEN"/>
</datatype>
<valList type="semi">
<valItem ident="cut">
<desc xml:lang="en">section is cleanly cut by a knife, scissor or other sharp blade.</desc>
</valItem>
<valItem ident="rip">
<desc xml:lang="en">section is ripped off the page, leaving a rough edge.</desc>
</valItem>
</valList>
</attDef>
</attList>
<remarks xml:lang="en">
<p>The dimensions (@width, @height) of the parent element (
<abbr>e.g.</abbr>
, <gi scheme="MEI">folium</gi>) indicate the size of the bounding box of the remaining part of the page. That is, if the complete lower half of a page has been cut, the @width and @height attributes describe the remaining upper half. If, in contrast, only the lower right quarter of the page has been cut, these attributes still indicate the size of the full page (assuming that the removed section was a regular rectangle).</p>
</remarks>
<remarks xml:lang="en">
<p>The dimensions (@width, @height) on <gi scheme="MEI">cutout</gi> itself are only to be used when there is a "gap" in the manuscript that allows to specify the dimensions of that missing part. In this case, the bounding box dimensions are given, together with @x and @y to indicate the upper left point on the original page. If, however, the removed section is available by itself, then a corresponding <gi scheme="MEI">folium</gi> (or <gi scheme="MEI">bifolium</gi>) should be placed inside the <gi scheme="MEI">cutout</gi> element, and should provide it’s own dimensions using @width and @height there. In this case, @width and @height on <gi scheme="MEI">cutout</gi> is expendable.</p>
</remarks>
</elementSpec>