REVTEX 4.1 Author's Guide: 1 Research Road, Ridge, NY 11961 (Dated: March 2010)
REVTEX 4.1 Author's Guide: 1 Research Road, Ridge, NY 11961 (Dated: March 2010)
REVTEX 4.1 Author's Guide: 1 Research Road, Ridge, NY 11961 (Dated: March 2010)
1 Author’s Guide
• APS Author Guide for REVTEX 4.1 • Figures referring to videos now supported. A
“figure” may now be labeled as a Video by using the
• Author’s Guide to AIP Substyles for REVTEX 4.1 video environment. A frame from the video may be
included in the figure and a URL to link the caption’s
• REVTEX 4.1 Command and Options Summary label to the online video also may be included. There
is also a \listofvideos command.
• What’s New in REVTEX 4.1
• Better support for arXiv.org in BibTEX Three
This guide assumes a working REVTEX 4.1 installation.
more BibTEX fields have been added: SLACcitation,
Please see the installation instructions included with the
archivePrefix, and primaryClass in addition to the
distribution.
existing field eprint.
• Added support for APS journal Physical Re- • Email addresses no longer print twice on papers
view Special Topics – Physics Education Re- less than one page long.
search.
• eqnarray alignment improved.
• Added support for AIP journals. There is now
an explicit aip society option along with support for • \collaboration can be used with the
AIP journals. Please see the Author’s Guide to AIP groupedaddress option now.
Substyles for REVTEX 4.1. In addition, REVTEX 4.1 • letterpaper now ensured as default paper size.
provides an extensible system for the easy addition of
new collections of journals. • Table of Contents formatting improved.
• Endnotes now ordered correctly. Endnotes in the • Support for the longtable package improved.
bibliography now appear in the correct order, inter-
leaved with citations. • reftest restored.
• Multiple references in a single citation sup- • Compatibility with the geometry, lineno,
ported using a special starred (*) argument to lscape and colortbl packages improved. For line
the \cite command. One of the major new features numbering, rather than using lineno.sty directly,
in 4.1 made possible by the joint work on natbib 8.3. the linenumbers class option should be used (this
Multiple BibTEX entries can be combined into a single will call in lineno.sty with a proper set of default
\bibitem command. parameters).
3
• hyperref fixes. Improvements were to make footnotes I.4. Submitting to AIP Journals
work better with the hyperref package. In particular,
table footnotes were fixed. More anchors for hyperref REVTEX 4.1 includes support for the journals of the
were also added (titlepage, abstract, and acknowledge- American Institute of Physics. The style files and au-
ments). thoring guides for these journals are distributed as part
REVTEX 4.1 distribution. The distribution includes both
• Documents can have more than 256 \cite com- a template (aiptemplate.tex) and a sample document
mands now. (aipsamp.tex). The template is a good starting point
for a manuscript. In the following sections are instruc-
• \listoffigures and \listoftables fixed. tions that should be sufficient for creating a paper using
REVTEX 4.1.
• Figure and table labels in captions now reflect More information may be found at http://www.aip.
proper APS style. org/pubservs/compuscript.html. Please consult the
Author’s Guide to AIP Substyles for REVTEX 4.1 for
more information about submissions to AIP journals,
• RMP style files conform better to RMP style
AIP styles files, and other AIP-specific information.
guidelines.
Documents prepared under REVTEX 4 should process REVTEX 4.1 must sometimes patch the underlying
correctly under REVTEX 4.1. However, the formatting LATEX kernel. This means that REVTEX 4.1 requires
of the pages and, if using BibTEX, the references may a fairly recent version of LATEX 2ε . Versions prior to
change. 2005/12/01 may not work correctly. REVTEX 4.1 will
be maintained to be compatible with future versions of
LATEX 2ε .
I.3. Submitting to APS Journals
TABLE I. LATEX 2ε font commands TABLE II. LATEX 2ε commands for special symbols and effects
Symbols
as better italic correction and scaling in super- and sub-
scripts for example. Table I summarizes the font selection
commands in LATEX 2ε . LATEX 2ε has added some convenient commands for
some special symbols and effects. These are summarized
in Table II. See [3] for details.
User-defined macros LATEX 2ε provides additional symbols in a separate
package called latexsym. To use these symbols, include
LATEX 2ε provides several macros that enable users to the package using:
easily create new macros for use in their manuscripts:
\usepackage{latexsym}
• \newcommand{hcommandi}[hnargi][hopti]{hdef i}
• \newcommand*{hcommandi}[hnargi][hopti]{hdef i}
II.2. Using LATEX 2ε packages with REVTEX
• \renewcommand{hcommandi}[hnargi][hopti]{hdef i}
Required packages are automatically loaded by multicol multicol.sty is a package by Frank Mittel-
REVTEX on an as-needed basis. Other packages should bach that adds support for multiple columns. In fact,
be loaded using the \usepackage command. To load the early versions of REVTEX 4.1 used multicol.sty for
hyperref package, the document preamble might look precisely this. REVTEX 4.1 incorporates its own sup-
like: port for multiple-column typesetting.
\documentclass{revtex} cite Donald Arseneau’s cite.sty is often used to pro-
\usepackage{hyperref} vide support for sorting a \cite command’s arguments
into numerical order and to collapse consecutive runs
Some common (and very useful) LATEX 2ε packages are
of reference numbers. REVTEX 4.1 has this function-
a priori important enough that REVTEX 4.1 has been
ality built-in already via the natbib package.
designed to be specifically compatible with them. A bug
stemming from the use of one of these packages in con- mcite REVTEX 4.1 already contains a lot of this func-
junction with any of the APS journals may be reported tionality through its updated syntax for the \cite
by contacting REVTEX support. command and the latest natbib package.
AMS packages REVTEX 4.1 is compatible with and endfloat The same functionality can be accomplished
depends upon the AMS packages amsfonts, amssymb, using the endfloats class option.
and amsmath. In fact, REVTEX 4.1 requires use of
these packages to accomplish some common tasks. See float float.sty provides a mechanism for creating new
Section VI for more. REVTEX 4.1 requires version 2.0 float classes with just a few commands. REVTEX 4.1
or higher of the AMS-LATEX package. has limited compatible with float.sty. If attempting to
use this package, be sure to put any \newfloat com-
array and dcolumn The array and dcolumn packages mands after the \begin{document} line.
are part of LATEX’s required suite of packages. dcolumn
is required to align table columns on decimal points
III. THE DOCUMENT PREAMBLE
(and it in turn depends upon the array package).
longtable longtable.sty may be used for large tables The preamble of a LATEX document is the set of com-
that will span more than one page. REVTEX 4.1 dy- mands that precede the \begin{document} line. It con-
namically applies patches to longtable.sty so that it tains a \documentclass line to load the REVTEX 4.1
will work in two-column mode. class (i.e., all of the REVTEX 4.1 macro definitions),
\usepackage macros to load other macro packages, and
hyperref hyperref.sty is a package by Sebastian other macro definitions.
Rahtz that is used for putting hypertext links into
LATEX 2ε documents. REVTEX 4.1 has hooks to al-
low e-mail addresses and URL’s to become hyperlinks III.1. The documentclass line
if hyperref is loaded.
The basic formatting of the manuscript
lineno REVTEX 4.1 improves compatibility with is controlled by setting class options using
lineno.sty. This package should only be loaded via \documentclass[hoptionsi]{revtex4-1}. The op-
the new linenumbers class option. See Section V.7 tional arguments that appear in the square brackets
for more information. control the layout of the document. At this point, one
only needs to choose:
lscape REVTEX 4.1 improves compatibility with
lscape.sty. • Either the aps (default) or aip society option
• One of the chosen society’s journal styles such as prl
geometry REVTEX 4.1 improves compatibility with
or apl
geometry.sty.
• A layout option such as preprint (single-column for-
colortbl REVTEX 4.1 improves compatibility with matting), reprint (an approximation to the selected
colortbl.sty. journal’s actual layout which may be one- or two-
column depending on the journal), or twocolumn
Other packages will conflict with REVTEX 4.1 and
should be avoided. Usually such a conflict arises because Usually, one would want to use preprint for draft pa-
the package adds enhancements that REVTEX 4.1 al- pers. Paper size options are also available as well. In
ready includes. Here are some common packages that particular, a4paper is available as well as the rest of the
clash with REVTEX 4.1: standard LATEX paper sizes. A full list of class options is
6
given in the REVTEX 4.1 Command and Options Sum- For example, if Bugs Bunny and Roger Rabbit are both
mary. at Looney Tune Studios, while Mickey Mouse is at Disney
World, the markup would be:
The title of the manuscript is simply specified by using one would use the markup
the \title{title} macro. A \\ may be used to put a line
break in a long title. \author{Bugs Bunny}
\affiliation{Looney Tune Studios}
\author{Roger Rabbit}
IV.2. Specifying a date \affiliation{Looney Tune Studios}
\affiliation{Disney World}
\author{Mickey Mouse}
The \date{hdatei} command outputs the date on the
\affiliation{Disney World}
manuscript. Using \today will cause LATEX to insert the
current date whenever the file is run: Note that REVTEX 4.1 takes care of any commas and
and ’s that join the author names together and font se-
\date{\today}
lection, as well as any superscript numbering. Only the
author names and affiliations should be given within their
respective macros. See below for further information re-
IV.3. Specifying authors and affiliations
garding the proper way to add footnotes to author names
and affiliations.
The REVTEX 4.1 macros for specifying authors and There is a third class option, unsortedaddress,
their affiliations are designed to save labor for authors for controlling author/affiliation display. The default
and during production. Authors and affiliations are ar- groupedaddress will actually sort authors into the ap-
ranged into groupings called, appropriately enough, au- proriate author groups if one chooses to specify an affili-
thor groups. Each author group is a set of authors who ation for each author. The markup:
share the same set of affiliations. Author names are spec-
ified with the \author macro while affiliations (or ad- \author{Bugs Bunny}
dresses) are specified with the \affiliation macro. Au- \affiliation{Looney Tune Studios}
thor groups are specified by sequences of \author macros \author{Mickey Mouse}
followed by \affiliation macros. An \affiliation \affiliation{Disney World}
macro applies to all previously specified \author macros \author{Roger Rabbit}
which don’t already have an affiliation supplied. \affiliation{Looney Tune Studios}
7
will result in the same display as for the first case the AIP styles, each have a default text for their op-
given above even though Roger Rabbit is specified af- tional arguments (‘Electronic address:’ and ‘URL:’ re-
ter Mickey Mouse. To avoid Roger Rabbit being moved spectively). The \thanks macro should only be used
into the same author group as Bugs Bunny, use the if one of the other three do not apply. Any author
unsortedaddress option instead. In general, it is safest name can have multiple occurences of these four macros.
to list authors in the order they should appear and spec- Note that unlike the \affiliation macro, these macros
ify affiliations for multiple authors rather than one at a only apply to the \author that directly precedes it.
time. This will afford the most independence for choos- Any \affiliation must follow the other author-specific
ing the display option. Finally, it should be mentioned macros. A typical usage might be as follows:
that the affiliations for the superscriptaddress are pre-
\author{Bugs Bunny}
sented and numbered in the order that they are encoun-
\email[E-mail me at: ]{[email protected]}
tered. These means that the order will usually follow
\homepage[Visit: ]{http://looney.com/}
the order of the authors. An alternative ordering can
\altaffiliation[Permanent address: ]
be forced by including a list of \affiliation commands
{Warner Brothers}
before the first \author in the desired order. Then use
\affiliation{Looney Tunes}
the exact same text for each affilation when specifying
them for each author. This would result in the footnote “E-mail me at:
If an author doesn’t have an affiliation, the [email protected], Visit: http://looney.com/, Perma-
\noaffiliation macro may be used in the place of an nent address: Warner Brothers” being attached to Bugs
\affiliation macro. Bunny. Note that:
If affiliations have been listed before the first \author be accomplished by using the description environment
macro to ensure a particular ordering, be sure that any within the abstract environment. For example:
later \affiliation command for the given institution
\begin{abstract}
is an exact copy of the first, and also ensure that no
\begin{description}
ancillary data is given in these later instances.
\item[Background] This part would describe the
Each journal class option has a default behavior for
context needed to understand what the paper
the placement of these ancillary information footnotes.
is about.
For instance, the prb option puts all such footnotes at
\item[Purpose] This part would state the purpose
the start of the bibliography while the prl journal styles
of the present paper.
displays them on the first page. One can override a jour-
\item[Method] This part describe the methods
nal style’s default behavior by specifying explicitly the
used in the paper.
class option bibnotes (puts the footnotes at the start of
\item[Results] This part would summarize the
the bibliography) or nobibnotes (puts them on the first
results.
page). Please consult the documentation for the various
\item[Conclusions] This part would state the
journal style files for further information.
conclusions of the paper.
\end{description}
Specifying first names and surnames
\end{abstract}
Many authors have names in which either the surname IV.5. PACS codes
appears first or in which the surname is made up of more
than one name. To ensure that such names are accurately
APS and AIP authors are asked to supply suggested
captured for indexing and other purposes, the \surname
PACS codes with their submissions. The \pacs macro is
macro should be used to indicate which portion of a name
provided as a way to do this:
is the surname. Similarly, there is a \firstname macro
as well, although usage of \surname should be sufficient. \pacs{23.23.+x, 56.65.Dy}
If an author’s surname is a single name and written last,
it is not necessary to use these macros. These macros The actual display of the PACS numbers below the ab-
do nothing but indicate how a name should be indexed. stract is controlled by two class options: showpacs and
Here are some examples: noshowpacs. In particular, this is now independent of the
preprint option. showpacs must be explicitly included
\author{Andrew \surname{Lloyd Weber}} in the class options to display the PACS codes.
\author{\surname{Mao} Tse-Tung}
IV.6. Keywords
IV.4. The abstract
A \keywords macro may also be used to indicate key-
An abstract for a paper is specified by using the words for the article.
abstract environment:
\keywords{nuclear form; yrast level}
\begin{abstract}
This will be displayed below the abstract and PACS (if
Text of abstract
supplied). Like PACS codes, the actual display of the the
\end{abstract}
keywords is controlled by two classoptions: showkeys and
Note that in REVTEX 4.1 the abstract must be specified noshowkeys. An explicit showkeys must be included in
before the \maketitle command and there is no need to the \documentclass line to display the keywords.
embed it in an explicit minipage environment.
After specifying the title, authors, affiliations, ab- Paragraphs always end with a blank input line. Be-
stract, PACS codes, and report numbers, the final step cause TEX automatically calculates linebreaks and word
for formatting the front matter of the manuscript is to hyphenation in a paragraph, it is not necessary to
execute the \maketitle macro by simply including it: force linebreaks or hyphenation. Of course, compound
words should still be explicitly hyphenated, e.g., “author-
\maketitle prepared copy.”
The \maketitle macro must follow all of the macros Use directional quotes for quotation marks around
listed above. The macro will format the front matter quoted text (‘‘xxx’’), not straight double quotes
in accordance with the various class options that were ("xxx"). For opening quotes, use one or two backquotes;
specified in the \documentclass line (either implicitly for closing quotes, use one or two forward quotes (apos-
through defaults or explicitly). trophes).
will also add horizontal rules to guide the reader’s eye Note that with footnotes appearing in the bibliogra-
through what may otherwise be a confusing break in the phy, extra passes of LATEX may be needed to resolve all
flow of text. The widetext environment has no effect on cross-references. For instance, putting a \cite inside a
the output under the preprint class option because this \footnote will require at least three passes.
already uses one-column formatting. Using the hyperref package to create hyperlinked
Use of the widetext environment should be restricted PDF files will cause reference ranges to be expanded to
to the bare minimum of text that needs to be typeset list every reference in the range. This behavior can be
this way. However, short pieces of paragraph text and/or avoided by using the hypernat package available from
math between nearly contiguous wide equations should www.ctan.org.
be incorporated into the surrounding wide sections.
Low-level control over the column grid can be accom-
plished with the \onecolumngrid and \twocolumngrid V.5. Acknowledgments
commands. Using these, one can avoid the horizontal
rules added by widetext. These commands should only Use the acknowledgments environment for an ac-
be used if absolutely necessary. Wide figures and ta- knowledgments section. Depending on the journal sub-
bles should be accommodated using the proper * envi- style, this element may be formatted as an unnumbered
ronments. section title Acknowledgments or simply as a paragraph.
Please note the spelling of “acknowledgments.”
\begin{acknowledgments}
V.4. Cross-referencing
The authors would like to thank...
\end{acknowledgments}
REVTEX inherits the LATEX 2ε features for labeling
and cross-referencing section headings, equations, tables,
and figures. This section contains a simplified explana- V.6. Appendices
tion of these cross-referencing features. The proper usage
in the context of section headings, equations, tables, and
figures is discussed in the appropriate sections. The \appendix command signals that all following
sections are appendices, so \section{htitle texti} af-
Cross-referencing depends upon the use of “tags,”
ter \appendix will set {htitle texti} as an appendix
which are defined by the user. The \label{hkeyi} com-
heading (an empty {htitle texti} is permitted). For
mand is used to identify tags for REVTEX. Tags are
a single appendix, use a \appendix* followed by
strings of characters that serve to label section headings,
\section{htitle texti} command to suppress the ap-
equations, tables, and figures that replace explicit, by-
pendix letter in the section heading.
hand numbering.
Files that use cross-referencing (and almost all
manuscripts do) need to be processed through REVTEX
V.7. Line numbering
at least twice to ensure that the tags have been prop-
erly linked to appropriate numbers. If any tags are
added in subsequent editing sessions, LATEX will display REVTEX 4.1 provides the linenumbers class option to
a warning message in the log file that ends with ... enable line numbering. While it is possible to directly call
Rerun to get cross-references right. Running the in the lineno.sty, using the class option ensures that
file through REVTEX again (possibly more than once) the default parameters needed to properly typeset the
will resolve the cross-references. If the error message per- line numbers are set up correctly. It is still possible for
sists, check the labels; the same {hkeyi} may have been authors to override parameters such as \linenumbersep
used to label more than one object. as usual, however.
Another LATEX warning is There were undefined
references, which indicates the use of a key in a \ref
without ever using it in a \label statement. VI. MATH AND EQUATIONS
REVTEX performs autonumbering exactly as in stan-
dard LATEX. When the file is processed for the first time, VI.1. Math in text
LATEX creates an auxiliary file (with the .aux extension)
that records the value of each hkeyi. Each subsequent run Not surprisingly, REVTEX uses the TEX math $ delim-
retrieves the proper number from the auxiliary file and iters for math embedded in text. For example, $a^{z}$
updates the auxiliary file. At the end of each run, any give az . Within math mode, use ^{hmathi} for super-
change in the value of a hkeyi produces a LATEX warning scripts and _{hmathi} for subscripts. If the braces after
message. the ^ are omitted, TEX will superscript the next token
11
(generally a single character or command). Thus it is For a continued equation, align each row on the rela-
safest to use explicit braces {}. tion operator just as with multiple equations, and use
As with text, math should not require extensive ex- the \nonumber command to suppress auto-numbering on
plicit vertical or horzontal motion commands, because broken lines. Also, use the starred form of the row end
TEX calculates math spacing itself automatically. In (\\*) to prevent a pagebreak at that juncture.
particular, explicit spacing around relations (e.g., =) Short displayed equations that can appear together on
or operators (e.g., +) should be unnecessary. These a single line separated by \qquad space may be placed in
suggestions notwithstanding, some fine-tuning of math a single equation environment.
is required in specific cases, see Chapter 18 in the As explained in Section V.3, occasionally in two-
TEXbook[1]. column mode a long equation, in order to fit it in the
narrow column width, would need to be broken into so
many lines that it would affect readibility. Set it in a wide
VI.2. Text in math column using the widetext environment. Then return to
the normal text width as soon as possible.
There are times when normal, non-italic text needs to The sample file apssamp.tex illustrates how to obtain
be inserted into a math expression. The \text{htexti} each of the above effects.
command is the preferred method of accomplishing
this. It produces regular text and scales correctly
in superscripts: $y=x \text{ for } x_{\text{e-p}}$ VI.4. Numbering displayed equations
gives “y = x for xe-p ”. To use the \text com-
mand, the amsmath package must be loaded: include REVTEX 4.1 automatically numbers equations. For
a \usepackage{amsmath} command in the document single-line and multi-line equations, use the equation
preamble or use the class option amsmath. Please note and eqnarray environments as described above. For
that REVTEX 4.1 requires version 2.0 or higher of unnumbered single-line equations, use the \[. . . \] con-
amsmath. struction. The command \nonumber will suppress the
Other common alternatives may be less desirable. Us- numbering on a single line of an eqnarray. For a multi-
ing the standard LATEX 2ε \mbox{htexti} will give nor- line equation with no equation numbers at all, use the
mal text, including a hyphen, but will not scale correctly eqnarray* environment.
in superscripts: $x_{\mbox{e-p}}$ gives “xe-p ”. The A series of equations can be a labeled with a lettered
\rm command only switches to Roman font for math let- sequence, e.g., (3a), (3b), and (3c), by putting the re-
ters. It does not, for example, handle hyphens correctly: spective equation or eqnarray environment within a
$$x_{\rm{e-p}}$ gives “xe−p ”. But note that \textrm, subequations environment. The amsmath package (can
it does work: $x_{\textrm{e-p}}$ gives “xe-p ”. be loaded with the amsmath class option) is required for
this.
Use the command \tag{hnumber i} to produce an id-
VI.3. Displayed equations iosyncratic equation number: (10 ), for example. Num-
bers assigned by \tag are completely independent of
Equations are set centered in the column width or flush REVTEX’s automatic numbering. The package amsmath
left depending on the selected journal substyle. is required for using the \tag command. Please note that
For the simplest type of displayed equation, a num- the use of the tag command may conflict with the use
bered, one-line equation, use the equation environment. of the hyperref package due an incompatibility between
REVTEX takes care of the equation number—the number amsmath and hyperref.
will be set below the equation if necessary. Use \[. . . \] To have REVTEX reset the equation numbers at the
for a single, one-line unnumbered display equation. start of each section, use the eqsecnum class option in
Use the eqnarray environment when more than one the document preamble.
consecutive equation occurs, putting each equation in a See the sample file apssamp.tex for some examples.
separate row of the environment, and using \nonumber
before the row end (\\) to suppress the equation number
where necessary. If the equations are related to each VI.5. Cross-referencing displayed equations
other, align each on the respective relation operator (such
as =). To refer to a numbered equation, use the
When an equation is broken over lines or is continued \label{hkeyi} and \ref{hkeyi} commands. The
over multiple relation operators, it is called a multi-line \label{hkeyi} command is used within the referenced
or continued equation, respectively; here, too, use the equation (on the desired line of the eqnarray, if a
eqnarray environment. multi-line equation):
12
manuscript is called paper.tex, the command would be (*). For example \cite{bethe, *feynman, *bohr} will
bibtex paper. This will produce a .bbl file contain- combine the \bibitems with keys bethe, feynman, and
ing all of the \bibitem’s for the manuscript. Subsequent bohr into a single entry in the bibliography separated by
runs of LATEX 2ε will call this file in to resolve the refer- semicolons.
ences. LATEX 2ε should be run repeatedly until all refer-
ences are resolved.
The BibTEX-produced \bibitem’s created using the VIII.6. Prepending and/or appending text to a
REVTEX style files appear considerably more complex citation
than the example given above. This is because the style
files add in \bibinfo, \bibnamefont, \eprint, and \url The expanded syntax for the \cite command argu-
macros for specifying additional formatting and tagging. ment can also be used to specify text before and/or after
The \bibinfo macro is mostly a do-nothing macro that a citation. For instance, a citation such as:
serves merely to tag the information with the field infor-
mation from the original entry in the BibTEX database. [19] A similar expression was derived in
The \eprint and \url macros can be used to create the A. V. Andreev, Phys. Rev. Lett. 99, 247204
appropriate hyperlinks in target formats such as PDF. (2007) in the context of carbon nanotube
For more information on using BibTEX with LATEX, see p-n junctions. The only difference is that no
Sections 4.3.1 and C.11.3 of the LATEX User’s Guide & integration over ky is present there.
Reference Manual [2], Section 13.2 of [4], or the online may be created by the following \cite command:
BibTEX manual btxdoc.tex from http://www.ctan.
org/tex-archive/biblio/bibtex/distribs/doc/. \cite{*[{A similar expression was derived
in }] [{ in the context of carbon nanotube
p-n junctions. The only difference is that
arXiv.org support in BibTEX no integration over ky is present
there.}]andreev2007]
REVTEX 4.1 has better support for citing e-prints from Please note the use of curly braces to enclose the text
arXiv.org For instance, the .bib entry within the square brackets.
@Unpublished{Ginsparg:1988ui,
author = "Ginsparg, Paul H.",
IX. FIGURES AND ARTWORK
title = "{Applied Conformal Field Theory}",
year = "1988",
eprint = "hep-th/9108028", IX.1. figure environment
archivePrefix = "arXiv",
SLACcitation = "%%CITATION=HEP-TH/9108028;%%" Figures may be included into a REVTEX 4.1
} manuscript by using the standard LATEX 2ε macros.
It should be noted that LATEX 2ε includes sev-
will include the arXiv.org e-print identifier as eral powerful packages for including the files in
arXiv:hep-th/9108028 and hyperlink it (if using various formats. The two main packages are
hyperref). The newer format for arXiv identifiers with graphics and graphicx. Both offer a macro called
primary classificiations will produce output such as \includegraphics[hargsi]{hfilenamei}; they mainly
arXiv:0905.1949 [hep-ph]. differ in how arguments for controlling figure scal-
ing, translation, and orientation are specified. For
more information on the enhancements of the graphicx
VIII.5. Multiple references in a single bibliography
entry
package, see [5] or the guide grfguide.pdf avail-
able at http://www.ctan.org/tex-archive/macros/
latex/required/graphics/. REVTEX 4.1 no longer
One of the most frequently requested features since the has the epsf class option, though the epsfig package
release of REVTEX 4 has been to allow more than one provides a similar interface.
reference to appear in a single bibliography entry when
The figure environment should be used to add a cap-
using BibTEX. This can now be done in REVTEX 4.1
tion to the figure and to allow LATEX to number and place
by using a starred (*) argument to the \cite command.
the figures where they fit best. LATEX will label and au-
This requires the latest version of natbib, developed in
tomatically number the captions FIG. 1, FIG. 2, etc. For
conjunction with REVTEX 4.1, and the new bst files
example:
that come with REVTEX 4.1. To combine multiple refer-
ences into a single \bibitem, precede the second, third, \begin{figure}
etc. citation keys in the \cite command with an asterisk \includegraphics{fig1.eps}
16
\caption{\label{fig1}Text of first caption.} the width of the figure. To refer to the table via cross-
\end{figure} referencing, a \label{hkeyi} command should appear
within the \caption. Use the \ref{hkeyi} command to
Note how the \label{hkeyi} command is used to cross- cite tables in text. The table environment will set the
reference figures in text. The \label{hkeyi} command table to the width of the column. Thus, in two-column
should be inserted inside the figure caption. As usual, mode, the table will be confined to a single column. To
the \ref{hkeyi} macro can then by used to refer to the set a table to the full width of the page, rather than the
label: “As depicted in FIG.~\ref{fig1}. . . ”. column, use the table* environment.
Figures are normally set to the width of the column in The heart of the table is the tabular environment.
which they are placed. This means that in two-column This will behave for the most part as in standard LATEX 2ε
mode, the figure will be placed in a single, narrow col- (please refer to Section 3.6.3 and Appendix C.10.2
umn. For wide figures, the \figure* environment should of the LATEX User’s Guide & Reference Manual for
be used instead. This will place the figure across both more details about the tabular environment). Note
columns (the figure usually will appear either at the top that REVTEX 4.1 no longer automatically adds double
or the bottom of the following page). (Scotch) rules around tables. Nor does the tabular en-
Captions less than one line long are centered under the vironment set various table parameters for column spac-
figure, otherwise they span the width of the figure. ing as before. Instead, a new environment ruledtabular
Note that is unnecessary (and undesirable) to use ex- provides this functionality. This environment should sur-
plicit centering commands inside the float environments. round the tabular environment:
\begin{table}
\caption{\label{<key>}....}
IX.2. video environment
\begin{ruledtabular}
\begin{tabular}
Papers often refer to multimedia material such as ...
videos. The video environment is identical to the figure \end{tabular}
environment, but the caption will be labeled as a Video \end{ruledtabular}
(with its own counter independent of figures). A URL \end{table}
can also be specified so that the caption label can be
linked to the online video (if using the hyperref pack- A basic table looks as follows:
age). The included graphic (using \includegraphics \begin{table}
from the graphics or graphicx package) would be a rep- \caption{\label{tab:example}Text of table caption.}
resentation frame from the video. A \listofvideos is \begin{ruledtabular}
also provided. For example: \begin{tabular}{ll}
Heading 1 & Heading 2\\
\begin{video}
Cell 1 & Cell 2\\
\includegraphics{videoframe.jpg}
\end{tabular}
\setfloatlink{http://some.video.com/fun.mov}
\end{ruledtabular}
\caption{\label{vid:interest}This is a video
\end{table}
of something fun.}
\end{video} The quasitable environment is no longer in
REVTEX 4.1. The standard tabular environment can
There is also a corresponding \listofvideos command.
be used instead because it no longer puts in the double
rules.
X. TABLES
X.1. Aligning on a decimal point
Tables are very similar to figures. They should be in-
put using the table environment as detailed below, and Numerical columns should align on the decimal point
LATEX will label and number the captions TABLE 1, TA- (or decimal points if more than one is is present). This is
BLE 2, etc. (or in whatever format required by the cho- accomplished by again using a standard LATEX 2ε pack-
sen journal substyle). Tables without captions won’t be age, dcolumn which must be loaded in the manuscript’s
numbered. preamble:
Each table must begin with \begin{table}, end with
\usepackage{dcolumn}
\end{table}. A caption can be specified using the
\caption{htexti} command. Captions less than one line Once this package is loaded, the column specifier ‘d’ can
long are centered under the figure, otherwise they span be used in the table’s tabular{hpreamblei} enviroment
17
preamble. The ‘d’ should be used for simple numeric \\* and \samepage can be used to control where the page
data with a single decimal point. The entry of a d col- breaks occur (these are the same as for the eqnarray en-
umn is typeset in math mode; do not insert any $ math vironment).
delimiters into a ‘d’ column. Items without a decimal Long tables are more robustly handled by using the
point are simply set in math mode, centered. If text is longtable.sty package included with the standard
required in the column, use \text or \mbox as appropri- LATEX 2ε distribution (put \usepackage{longtable} in
ate. If multiple decimal points are present then the last the preamble). This package gives precise control over
is used for alignment. To escape from the ‘d’ column use the layout of the table. The REVTEX 4.1 package
\multicolumn as usual. See the sample file apssamp.tex contains patches that enable the longtable package
for examples. to work in two-column mode. Of course, a table set
in two-column mode needs to be narrow enough to
fit within the column. Otherwise, the columns may
X.2. Footnotes in Tables overlap. REVTEX 4.1 provides an additional environ-
ment longtable* which allows a longtable to span the
Footnotes in a table are labeled a, b, c, etc. They can whole page width. Currently, the longtable* and
be specified by using the LATEX \footnote command. ruledtabular environments are incompatible. In order
Furthermore, \footnotemark and \footnotetext can to get the double (Scotch) rule, it is necessary to add
be used so that multiple entries can to refer to the same the \hline\hline manually (or define \endfirsthead
footnote. The footnotes for a table are typeset at the and \endlastfoot appropriately). For more documen-
bottom of the table, rather than at the bottom of the tation on the longtable environment and on the package
page or at the end of the references. The arguments for options of the longtable package, please see the docu-
\footnotemark and \footnotetext should be numbers mentation available at http://www.ctan.org/macros/
1, 2, . . . . The journal style will convert these to letters. latex/required/tools/longtable.dtx or refer to [4].
See sample file apssamp.tex for examples and explana-
tions of use.
XI. PLACEMENT OF FIGURES, TABLES, AND
OTHER FLOATS
X.3. Dealing with Long Tables
By default, figures and tables (and any other “floating”
By default, tables are set in a smaller size than the text environments defined by other packages) float to the top
body (\small). The \squeezetable declaration makes or bottom of the page using the standard LATEX float
the table font smaller still (\scriptsize). Thus, putting placement mechanism. Initially, each figure or table
the \squeezetable command before the \begin{table} environment should be put immediately following its first
line in a table will reduce the font size. If this isn’t suffi- reference in the text; this will usually result in satisfac-
cient to fit the table on a page, the standard LATEX 2ε tory placement on the page. An optional argument for
longtable package may be used. The scope of the either environment adjusts the float placement. For ex-
\squeezetable command must be limited by enclosing ample:
it with a group:
\begingroup \begin{figure}[hplacementi]
\squeezetable ...
\begin{table} \end{figure}
[...]
where hplacementi can be any combination of htbp!, sig-
\end{table}
nifying “here”, “top”, “bottom”, “page”, and “as soon as
\endgroup
possible”, respectively. The same placement argument
Tables are normally set to the width of the column in may be added to a \begin{table}. For more details
which they are placed. This means that in two-column about float placement, see the instructions in the LATEX
mode, the table will be placed in a single, narrow column. User’s Guide & Reference Manual, Appendix C.9.1.
For wide tables, the \table* environment should be used In two-column mode, a page may contain both a
instead. This will place the table across both columns widetext environment and a float. REVTEX 4.1 may
(the table usually will appear either at the top or the not always be able to automatically put the float in the
bottom of the following page). optimal place. For instance, a float may be placed at
To break tables across pages, REVTEX 4.1requires the bottom of a column just before the widetext begins.
adding to the table a float placement option of [H] (mean- To workaround this, try moving the float environment be-
ing put the table “here” and effectively “unfloating” the low the widetext environment. Alternative hplacementsi
table) to the \begin{table} command. The commands may also alleviate the problem.
18
figure and table environments should not be en- XII. ROTATING FLOATS
closed in a widetext environment to make them span
the page to accommodate wide figures or tables. Rather, Often a figure or table is too wide to be typeset in
the figure* or table* environments should be used in- the standard orientation and it is necessary to rotate
stead. the float 90 degrees. REVTEX 4.1 provides a new en-
vironment turnpage as an easy means to accomplish
Sometimes in LATEX the float placement mechanism
this. The turnpage environment depends on one of the
breaks down and a float can’t be placed. Such a “stuck”
packages graphics or graphicx being loaded. To use
float may mean that it and all floats that follow are moved
the turnpage environment, simply enclose the figure or
to the end of the job (and if there are too many of floats,
table environment with the turnpage environment:
the fatal error Too many unprocessed floats will oc-
cur). REVTEX 4.1 provides the class option floatfix \documentclass[...]{revtex4}
which attempts to invoke emergency float processing to \usepackage{graphicx}
avoid creating a “stuck” float. REVTEX 4.1 will provide [...]
a message suggesting the use of floatfix. If floatfix \begin{turnpage}
doesn’t work or if the resulting positioning of the float is \begin{figure} or \begin{table}
poor, the float should be repositioned by hand. [...]
\end{figure} or \end{table}
REVTEX 4.1 offers an additional possibility for plac- \end{turnpage}
ing the floats. By using the either the endfloats or
the endfloats* class option all floats may be held back A turnpage float will be typeset on a page by itself. Cur-
(using an external file) and then set elsewhere in the rently, there is no mechanism for breaking such a float
document using the the commands \printtables and across multiple pages.
\printfigures, placed where the tables and figures are
to be printed (usually at the end of the document). (This
XIII. REVTEX 4.1 SYMBOLS AND THE
is similar to the standard \printindex command). Us-
REVSYMB4-1 PACKAGE
ing a *-form of the commands (\printfigures* and
\printtables*) will begin the figures or tables on a new
page. Alternatively, the option endfloats* may be used Symbols made available in earlier versions of REVTEX
to change the behavior of the non-*-forms so that every are defined in a separate package, revsymb4-1, so that
float will appear on a separate page at the end. they may be used with other classes. This might be use-
ful if, say, copying text from a REVTEX document to a
Without one of the endfloats class options, these float non-REVTEX document. REVTEX 4.1 automatically in-
placement commands are silently ignored, so it is always cludes these symbols so it is not necessary to explicitly
safe to use them. If one of the endfloats class options is call them in with a \usepackage statement.
given, but the \printtables command is missing, the ta- Table III summarizes the symbols defined in this
bles will be printed at the end of the document. Likewise, package. Note that \overcirc, \overdots, and
if \printfigures is missing, the figures will be printed at \corresponds are no longer in REVTEX 4.1. Use
the end of the document. Therefore it is also safe to omit \mathring (standard in LATEX 2ε ), \dddot (with the
these commands as long as REVTEX’s default choices for amsmath package loaded), and \triangleq (with the
ordering figures and tables are satisfactory. amssymb class option) respectively. \succsim, \precsim,
\lesssim, and \gtrsim are also defined either in
The endfloats option (or perhaps some journal sub- amsmath or amssymb. The AMS versions of these com-
style that invokes it), requires explicit \begin{figure}, mands will be used if the appropriate AMS package is
\end{figure}, \begin{table}, and \end{table} lines. loaded.
In particular, do not define typing shortcuts for table and
figure environments, such as
XIV. OTHER REVTEX 4.1 FEATURES
\lambdabar λ \openone 11
\altsuccsim
∼ \altprecsim ≺
∼
\alt . \agt &
↔ ∗ [1] D.E. Knuth, The TEXbook, (Addison-Wesley, Reading,
\tensor x x \overstar x x MA, 1986).
← →
\loarrow x x \roarrow x “x” [2] L. Lamport, LATEX, a Document Preparation System,
(Addison-Wesley, Reading, MA, 1996).
`´
\biglb ( \bigrb) \Biglb ( \Bigrb)
[3] H. Kopka and P. Daly, A Guide to LATEX 2ε , (Addison-
„« ! Wesley, Reading, MA, 1995).
[4] M. Goossens, F. Mittelbach, and A. Samarin, The LATEX
\bigglb ( \biggrb) \Bigglb ( \Biggrb )
Companion, (Addison-Wesley, Reading, MA, 1994).
[5] M. Goossens, S. Rahtz, and F. Mittelbach, The LATEX
Graphics Companion, (Addison-Wesley, Reading, MA,
1997).
[6] S. Rahtz, M. Goossens, et al.,The LATEX Web Companion,
directory as the TEX file. APS authors should follow the (Addison-Wesley, Reading, MA, 1999).
guidelines in the APS Author Guide for REVTEX 4.1