<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

This element may be contained in:

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
&#x03C7;<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>
...