◇◆

<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

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 Data with a Figure
It is possible to make links to the data behind a figure. For example, a figure containing a graphic of a pie chart might point to the numerical data visually summarized by the chart.
If the data resides in the article, use an internal cross-reference (<xref>) to point to the data. If the data is external to the article, for example, in a data repository (more typical), make an external connection using one or more <ext-link> elements within the figure tagging. The data behind a figure may be integral or supplementary.
Each figure within a <fig-group> may make its own external connections using one or more <ext-link> elements within the <fig>s and/or the group as a whole may use the <fig-group> <ext-link>s within the group. The <ext-link> element may be used directly within:
Note that a figure and its multiple supporting data objects are described in one figure with multiple links, rather than as a figure group (<fig-group>) even if the associated data objects are themselves figures.
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
fig-type
orientation (default = portrait)
position (default = float)
specific-use
supplemental

Multi-lang Attributes

lang-focus
lang-focus-custom
lang-group
lang-source
lang-source-custom
lang-translate
lang-variant
lang-variant-custom

Base Attributes

id
xml:base
xml:lang
Models and Context
May be contained in
<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>
Description
The following, in order:
Content Model
<!ELEMENT  fig          %fig-model;                                  >
Expanded Content Model
((object-id)*, (label)*, (caption)*, (legend)*, (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
<caption> shows use of <alternatives>. 
...
<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" mimetype="video/x-msvideo" orientation="portrait"
      position="anchor" specific-use="original-format"
      xlink:href="v1-video1-orig.avi"/>
    <media mimetype="video/mpeg4" orientation="portrait"
      position="anchor" specific-use="archival-format"
      xlink:href="v1-video1-archive.mpeg"/>
    <media mimetype="video/x-flv" 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" 
   mimetype="image/jpeg" 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/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 one 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" 
   mimetype="image/jpeg" 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">Donec et odio pellentesque diam</p>
 </caption>
 <graphic id="fig2-graphic" 
   mimetype="image/jpeg" 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/csv" xlink:href="source-data-1.csv">
 <label>Supplementary File 1</label>
 <caption>
  <title>Orthogroup clustering analysis</title>
 </caption>
</supplementary-material>
...
Captions in two languages 
...
<fig id="f1">
 <label xml:lang="pt">Figura 2</label>
 <label xml:lang="en">Figure 2</label>
 <caption xml:lang="pt">
  <title>Esquema de perfil de superfície determinado pelo 
   movimento da agulha da ponteira de varrimento do equipamento 
   Surftest SJ - 400</title>
 </caption>
 <caption xml:lang="en">
  <title>Surface profile scheme determined by the movement 
   of the needle tip of the scanning equipment Surftest SJ 
   - 400</title>
 </caption>
 <graphic id="g23s" xlink:href="..."/>
 <attrib xml:lang="pt">Fonte: adaptado de Söğütlü (2005). 
  <xref ref-type="bibr" rid="B310">Söğütlü C. (2005)</xref>.
 </attrib>
 <attrib xml:lang="en">Source: Adapted from Söğütlü (2005). 
  <xref ref-type="bibr" rid="B310">Söğütlü C. (2005)</xref>.
 </attrib>
</fig>
...
Related Resources