<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 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
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)*, (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
    &#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>
...
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>
...
Related Resources