<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
orientation (default = portrait)
position (default = float)

Base Attributes

Models and Context
May be contained in
Description
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
...
<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.xflv"/>
   </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 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" 
   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>
...
Alternative Spanish and English Variants of a Figure
...
<fig id="f0001" lang-group="f0001"
  position="float" fig-type="scatter-graph" 
  xml:lang="en" lang-variant="translation" 
  lang-source="translator" lang-focus="secondary">
 <label>Figure 1.</label>
 <caption><p>Evolution of the repetition rate in all sequences</p></caption>
 <graphic xlink:href="RIYA_A_1889289_F0001_OC-en.jpg" 
    content-type="color" specific-use="web-only"/>
</fig>

<fig id="f0005" lang-group="f0001"  
  position="float" fig-type="scatter-graph" 
  xml:lang="es" lang-variant="original" 
  lang-source="author" lang-focus="primary">
 <label>Figura 1.</label>
 <caption><p>Evolución de la tasa de repetición en  
  todas las secuencias</p></caption>
  <graphic xlink:href="RIYA_A_1889289_F0005_OC-es.jpg" 
    content-type="color" specific-use="web-only"/> 
</fig>
...
Related Resources