<fig>
Figure
Block of graphical or textual material that is identified
as a figure, usually bearing a caption and a label such
as “Figure 3.” or “Figure”.
Remarks
A <fig> is defined as an element that
would appear in the Table of Figures, if there were one.
Related Resource: For a discussion on the use of <fig>, see Figures and Graphics.
Usage: The content of a <fig> need not be graphical in nature; the content of a figure may be a graphic, a list, several paragraphs, an equation, a display quote, a table, etc., or a mixture of several of these.
Position: The @position attribute may be used to indicate whether this element must be anchored at its exact location within the text or whether it may float, for example: to the top of the next page, into the next column, to the end of a logical file, or within a separate window.
Best Practice: Tag unlabeled graphics as <graphic> elements rather than as <fig> elements. A common test to determine if an object is a <fig> versus a <graphic> is to ask, “If there were a “List of Figures” for this document, should this object appear in that list?”
Associating Supplementary Data with a Figure: When the data (such as a spreadsheet or dataset) associated with a document has been described using a
<supplementary-material> element, then a figure can use an internal <xref> to point to that <supplementary-material>. This provides a mechanism to expose the data behind the figure. For example, assume that a figure (<fig>) is associated with three pieces of supplementary material (each described in a <supplementary-material> element). Three cross references (<xref>) can be embedded in the figure tagging to associate the figure with all three supplementary items, which may be datasets, additional figures, spreadsheets, etc. Note that a figure and its three supporting data objects are described in one figure and three supplementary material objects connected by internal cross-references (<xref> elements) rather than as a figure group (<fig-group>) even if the 3 associated objects are figures.
Each figure within a <fig-group> may contain its own <xref> elements to make this internal connection. In addition, the figure group as a whole may contain internal cross-references of its own. External connections can also be made using one or more <ext-link> elements within a figure or table tagging.
Multi-language Figure/Tables: JATS provides several ways to tag tables, figures, etc. in multiple languages. The element <block-alternatives> can be used to hold two or more versions of the table or figure, each in a different language. It is also possible to place multiple <label> and <caption> elements inside a single figure or table, one label and caption for each language, differentiated by @xml:lang attributes. In the case of double labels and captions, the content of the figure is not repeated, only the labels and captions.
Attributes
Content Model
<!ELEMENT fig %fig-model; >
Expanded Content Model
((object-id)*, (label)*, (caption)*, (abstract)*, (kwd-group)*, (subj-group)*, (alt-text | long-desc | email | ext-link | uri)*, (disp-formula | disp-formula-group | chem-struct-wrap | disp-quote | speech | statement | verse-group | table-wrap | p | def-list | list | alternatives | array | code | graphic | media | preformat | xref)*, (attrib | permissions)*)
Description
The following, in order:
- <object-id> Object Identifier, zero or more
- <label> Label (of an Equation, Figure, Reference, etc.), zero or more
- <caption> Caption of a Figure, Table, etc., zero or more
- <abstract> Abstract, zero or more
- <kwd-group> Keyword Group, zero or more
- <subj-group> Subject Group, zero or more
- Any combination of:
- Accessibility Elements
- Linking Elements
- Any combination of:
- <disp-formula> Formula, Display
- <disp-formula-group> Formula, Display Group
- <chem-struct-wrap> Chemical Structure Wrapper
- <disp-quote> Quote, Displayed
- <speech> Speech
- <statement> Statement, Formal
- <verse-group> Verse Form for Poetry
- <table-wrap> Table Wrapper
- <p> Paragraph
- Lists
- <alternatives> Alternatives For Processing
- <array> Array (Simple Tabulation)
- <code> Code
- <graphic> Graphic
- <media> Media Object
- <preformat> Preformatted Text
- <xref> X (cross) Reference
- Any combination of:
- Ownership Elements
This element may be contained in:
<abstract>, <ack>, <answer>, <app>, <app-group>, <bio>, <block-alternatives>, <body>, <boxed-text>, <disp-quote>, <explanation>, <fig-group>, <floats-group>, <glossary>, <license-p>, <named-content>, <notes>, <option>, <p>, <question>, <question-preamble>, <ref-list>, <sec>, <styled-content>, <trans-abstract>
Example 1
A simple captionless figure with a graphic:
...
<fig id="f1" orientation="portrait" position="float">
<graphic xlink:href="f1"/>
<attrib>Brookhaven National Laboratory</attrib>
</fig>
...Example 2
A labeled, captioned figure with a graphic:
...
<fig id="f8" orientation="portrait" position="float">
<label>FIG. 8.</label>
<caption>
<p>Time difference between events F and A as a function of the
length of entering plug for bifurcations B to BXXX, where X stands
for 0 or 1.</p>
</caption>
<graphic orientation="portrait" position="float" xlink:href="f8"/>
</fig>
...Example 3
A more complex figure with a graphic:
...
<sec sec-type="results">
<title>Results</title>
<p>We identified 703 abstracts, of which 687 were not
relevant ... Details of randomisation procedures, treatment
schedules, and numbers of patients followed up are given
on the <italic>BMJ</italic> website.</p>
<fig id="F1">
<caption>
<title>Deaths among patients receiving day hospital care
or alternative services.</title>
<p>Odds ratios of death by end of follow up were calculated by
fixed effects model. Heterogeneity between trials is presented as
χ<sup>2</sup></p>
</caption>
<alt-text>Deaths in hospitals or with alternative services</alt-text>
<graphic xmlns:xlink="http://www.w3.org/1999/xlink"
xlink:href="fors2662.f1">
<object-id>456472</object-id>
</graphic>
</fig>
...
</sec>
...Example 4
A complex multi-graphic figure:
...
<fig id="f1" orientation="portrait" position="float">
<label>FIG. 1.</label>
<caption>
<p>(a) Schematic of the working principles of HFM, (b) a typical
application scheme for an electric bias in HFM, (c) regulation
the conformations and dynamics (trapping, concentration, and sudden
stretching) of λ-DNA molecules in HFM, and (d) schematic of the trapping location regulation (enhanced online).
[URL: <ext-link ext-link-type="uri" xlink:href="http://dx.doi.org/10.1063/1.4762852.1">
http://dx.doi.org/10.1063/1.4762852.1</ext-link>]
<alternatives>
<media id="v1" mime-subtype="avi" mimetype="video" orientation="portrait"
position="anchor" specific-use="original-format" xlink:href="v1"/>
<media mime-subtype="mpeg" mimetype="video" orientation="portrait"
position="anchor" specific-use="archival-format" xlink:href="v1"/>
<media mime-subtype="x-flv" mimetype="video" orientation="portrait"
position="anchor" specific-use="online-format" xlink:href="v1"/>
</alternatives>
</p>
</caption>
<graphic orientation="portrait" position="float" xlink:href="f1"/>
<graphic id="f1a" orientation="portrait" position="float" xlink:href="dummy1.png"/>
<graphic id="f1b" orientation="portrait" position="float" xlink:href="dummy2.png"/>
<graphic id="f1c" orientation="portrait" position="float" xlink:href="dummy3.png"/>
<graphic id="f1d" orientation="portrait" position="float" xlink:href="dummy4.png"/>
</fig>
...Example 5
A figure with alternate graphics:
...
<fig id="f3" position="float">
<label>FIG. 3.</label>
<caption>...</caption>
<alternatives>
<graphic specific-use="print" xlink:href="1.4821168.figures.highres.f3.zip"/>
<graphic specific-use="online" xlink:href="1.4821168.figures.online.f3.jpg"/>
</alternatives>
</fig>
...Example 6
A figure linked to the data from which the figure is derived:
...
<fig id="fig3">
<label>Figure 3</label>
<caption id="fig3-caption">
<title>Orthogroup clustering analysis</title>
<p id="fig3-caption-p1">Lorem ipsum dolor sit amet</p>
</caption>
<graphic id="fig3-graphic" mime-subtype="jpeg"
mimetype="image" xlink:href="fig3.jpg" />
<xref ref-type="supplementary-material" rid="source-data-2" />
</fig>
...
<supplementary-material id="source-data-2" content-type="sdata"
mimetype="text" mime-subtype="csv" xlink:href="source-data-2.csv">
<label>Supplementary File 2</label>
<caption>
<title>Orthogroup clustering analysis</title>
<p>Lorem ipsum dolor sit amet</p>
</caption>
</supplementary-material>
...
Example 7
Two figures derived from the same dataset:
... <fig id="fig1"> <label>Figure 1</label> <caption id="fig1-caption"> <title>Orthogroup clustering analysis</title> <p id="fig1-caption-p1">Lorem ipsum dolor sit amet</p> </caption> <graphic id="fig1-graphic" mime-subtype="jpeg" mimetype="image" xlink:href="fig1.jpg"/> <xref ref-type="supplementary-material" rid="source-data-1"/> </fig> <fig id="fig2"> <label>Figure 2</label> <caption id="fig2-caption"> <title>Figure 2 title</title> <p id="fig2-caption-p1">Lorem ipsum dolor sit amet</p> </caption> <graphic id="fig2-graphic" mime-subtype="jpeg" mimetype="image" xlink:href="fig2.jpg" /> <xref ref-type="supplementary-material" rid="source-data-1" /> </fig> ... <supplementary-material id="source-data-1" content-type="sdata" mimetype="text" mime-subtype="csv" xlink:href="source-data-1.csv"> <label>Supplementary File 1</label> <caption> <title>Orthogroup clustering analysis</title> </caption> </supplementary-material> ...