◇◆
<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”.
Usage/Remarks
A <fig> is defined as an element that
would appear in the Table of Figures, if there were one.
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
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, which are 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
Models and Context
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>
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
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)*)
Tagged Samples
<graphic> and <attrib>
...
<fig id="f1" orientation="portrait" position="float">
<graphic xlink:href="f1"/>
<attrib>Brookhaven National Laboratory</attrib>
</fig>
...<label>, <caption>, and <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>
...<alt-text> and <object-id>
...
<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>
...Multiple graphics
...
<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-video1-orig.avi"/>
<media mime-subtype="mpeg" mimetype="video" orientation="portrait"
position="anchor" specific-use="archival-format"
xlink:href="v1-video1-archive.mpeg"/>
<media mime-subtype="x-flv" mimetype="video" orientation="portrait"
position="anchor" specific-use="online-format"
xlink:href="v1-video1-online.xfiv"/>
</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>
...Alternative 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>
...Link to data from which the figure 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>
...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> ...