summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/revtex/aip/aipguide4-2.tex
blob: 039bfe037249b1aef8bd61e853ab84bcc66db023 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
%% ****** Start of file auguide.tex ****** %
%%
%%   This file is part of the AIPP distribution of substyles for REVTeX 4.2
%%   For version 4.2a of REVTeX, December 2014
%%
%%   Copyright (c) 2014 American Institute of Physics Publishing
%%
\listfiles
\documentclass[%
 reprint,%
%secnumarabic,%
 amssymb, amsmath,%
 aip,cha,%
%groupedaddress,%
%frontmatterverbose,
]{revtex4-2}

\usepackage{docs}%
\usepackage{bm}%
\usepackage[colorlinks=true,linkcolor=blue]{hyperref}%
%\nofiles
\expandafter\ifx\csname package@font\endcsname\relax\else
 \expandafter\expandafter
 \expandafter\usepackage
 \expandafter\expandafter
 \expandafter{\csname package@font\endcsname}%
\fi
\hyphenation{title}

\begin{document}

\title{Author's Guide to AIP Substyles for \revtex~4.2}%

\author{AIP Journal Program}%
\email{tex@aip.org}
\affiliation{American Institute of Physics Publishing Suite 300, 1305 Walk Whitman Road\\Melville, New York 11747-4300, USA}%

\date{November 2014}%
\revised{December 2014}%

\maketitle

\tableofcontents

\section{Introduction}

This is the author's guide to the AIP substyles for \revtex~4.2, 
providing a useful formatting tool 
for \LaTeX\ users submitting papers to journals 
published by the American Institute of Physics.
This guide is intended as an adjunct to the documentation for \revtex\ itself 
(published by the American Physical Society), 
so information contained therein is not repeated here, 
except as it bears on the specific features of the AIP substyles.


\subsection{Prerequisite Documentation}

The following documentation should be considered your first source of information 
on how to prepare your document for use with this format; 
they are to be found within the APS \revtex~4.2 distribution. 
Updated versions of these are maintained at
the \revtex~4.2 homepage located at \url{http://journals.aps.org/revtex/},
are also available at the Comprehensive \TeX\ Archive Network (CTAN, see \url{http://www.ctan.org/}), 
and form part of the \TeX Live distribution of \TeX.
\begin{itemize}
\item \textit{Author's Guide to \revtex~4.2}
\item \textit{\revtex~4.2 Command and Options Summary}
\end{itemize}
The present guide builds upon these documents, with which you should already be familiar.

The AIP substyles distribution for \revtex~4.2 includes 
a sample document (\file{aipsamp.tex}), 
a good starting point for 
the manuscript you are preparing for submission to an AIP journal.

By using \revtex's \textit{Author's Guide to \revtex~4.2}, you can develop your
document until it contains all of the content you desire.
This guide informs you on document class options, commands, and 
markup guidelines specific to AIP journals. 

\subsection{Software Requirements}

This guide assumes a working \revtex~4.2 installation including the AIP substyles. 
Please see the installation guide included with the distribution.\cite{Note1}

Please note that the AIP substyles work {\it only} with \revtex~4.2: 
the original \revtex~4.0 release does {\it not} make the AIP substyle available, nor is it compatible with them. 

For your computer to run \revtex~4.2 with the AIP substyles, the following are required:
\begin{itemize}
\item
a working installation of \LaTeX\,
\item
\revtex~4.2 and all packages it requires,
\item
the AIP substyles for \revtex~4.2, and
\item
any further \LaTeX\ packages used in your document. 
\end{itemize}

The easiest way to obtain all of the needed software is to install an up-to-date distribution of \TeX,
like \TeX Live, available on CTAN.

To obtain the most up-to-date version of this software, please see \url{http://publishing.aip.org/authors/preparing-your-manuscript}.


\subsection{Submitting to AIP Journals}

Authors preparing a manuscript for submission to
AIP journals should consult the Information for Contributors for the applicable journal,
available through links at \url{http://scitation.aip.org/authors}. 
These requirements are not covered systematically in this author's guide; 
you are responsible for understanding the requirements of the particular journal to which
you will submit your article.

For further information about journal requirements, contact the Editorial
Office of the appropriate journal. (Follow links at \url{http://scitation.aip.org/authors}.)

\subsection{Contact Information}\label{sec:resources}%
Any bugs, problems, or inconsistencies concerning the AIP journal substyles
should be reported to AIP support at \href{mailto:tex@aip.org}{tex@aip.org}. 
Reports should include information on the error and a 
\textit{small} sample document that manifests the problem, if possible. 
(Please don't send large files!) 

Feedback concerning \revtex~4.2 itself should be sent, as usual, 
to the American Physical Society at\\ \href{mailto:revtex@aps.org}{revtex@aps.org}. 

To determine if the problem you are experiencing belongs to \revtex\ or is specific to the
AIP substyles, simply remove \texttt{aip} from your document class options and rerun 
your document. If the problem goes away, you may assume that it is due to the AIP substyles;
if not, it belongs to \revtex.

\section{Sample \LaTeXe\ Document}
As the \revtex\ documentation makes clear, your document employs a \LaTeXe\ document class
(specifically \texttt{revtex4-2.cls}), so you should use 
the \LaTeXe\ commands and environments familiar to you with, say, the
standard article class \texttt{revtex4-2.cls}, and you will be able to 
employ many of the packages you are used to using with \LaTeXe.

Using \texttt{aipsamp.tex} as an example, 
your document will start with the usual \revtex\ \cmd\documentclass\ statement, but with
a particular document class option \texttt{aip} that specifies the AIP substyle:
\begin{verbatim}
\documentclass[aip]{revtex4-2}
\end{verbatim}
You will then invoke the \LaTeXe\-compatible packages your document requires, say:
\begin{verbatim}
\usepackage{graphicx}%
\usepackage{dcolumn}%
\usepackage{bm}%
\end{verbatim}
follow up with your document content:
\begin{verbatim}
\begin{document}
...
\end{verbatim}
and finish with a statement specifying your Bib\TeX\ database:
\begin{verbatim}
\bibliography{aipsamp}
\end{document}
\end{verbatim}

The books
in the bibliography of this guide provide extensive coverage of all topics
pertaining to preparing documents under \LaTeXe\; they are highly recommended. 

\section{\revtex\ Class Options Specific to AIP}

\subsection{Journal Substyle}
To access particular features of the AIP substyle, you will specify an additional document class option: the journal substyle, e.g.,
\begin{verbatim}
\documentclass[aip,jcp]{revtex4-2}
\end{verbatim}
in this case, \textit{J. Chem. Phys.}, the default. 
A complete list of AIP journals with the corresponding journal substyle appears in Table~\ref{tab:journals}.
\begin{table}
\caption{\label{tab:journals}AIP journal substyles}
\begin{ruledtabular}
\begin{tabular}{ll}
\textbf{Journal} & \textbf{class option} \\
\itshape AIP Advances            &\texttt{adv}\\
\itshape Appl. Phys. Lett. &\texttt{apl}\\
\itshape Appl. Phys. Lett. Mater.&\texttt{apm}\\
\itshape Biomicrofluidics  &\texttt{bmf}\\
\itshape Chaos             &\texttt{cha}\\
\itshape J. Appl. Phys.    &\texttt{jap}\\
\itshape J. Chem. Phys.    &\texttt{jcp}\footnotemark[1]\\
\itshape J. Math. Phys.    &\texttt{jmp}\\
\itshape J. Renewable Sustainable Energy&\texttt{rse}\\
\itshape Phys. Fluids      &\texttt{pof}\\
\itshape Phys. Plasmas     &\texttt{pop}\\
\itshape Rev. Sci. Instrum.&\texttt{rsi}\\
\itshape Structural Dynamics     &\texttt{sd}\\
\end{tabular}
\end{ruledtabular}
\footnotetext[1]{Default journal substyle.}
\end{table}

\subsection{Options for Citations and Bibliography}
The citation style for AIP journals is:
\begin{itemize}
\item 
numerical (default style), 
\item
author-year, and
\item
numerical author-year,
\end{itemize}
the latter two styles being only allowed for \textit{Chaos} or \textit{J. Math. Phys.}

The familiar numerical citations and numbered bibliography are the default for most journals: 
citations are superscript numbers, and the (numbered) bibliographic entries appear in the order cited. 

Author-year citations are only allowed for 
\textit{Chaos} or \textit{J. Math. Phys.}, with citations given in author-and-year format. 
Bibliographic entries are sorted by alphabetical order of first author's surname, then by year. 

Numerical author-year citations 
(only allowed for \textit{Chaos} or \textit{J. Math. Phys.}) 
are superscript numbers, just like numerical citations, 
but the bibliographic entries are sorted like the author-year entries and are numbered. 
This means that the first citation will not necessarily be~1.

To obtain the numerical style, simply accept the default, or supply a class option of \texttt{numerical}:
\begin{verbatim}
\documentclass[aip,numerical]{revtex4-2}
\end{verbatim}
For author-year citations for \textit{Chaos} or \textit{J. Math. Phys.}, 
you may specify the \texttt{author-year} option:
\begin{verbatim}
\documentclass[aip,author-year]{revtex4-2}
\end{verbatim}
Each of the above two options are part of standard \revtex.

To obtain numerical author-year citations 
for \textit{Chaos} or \textit{J. Math. Phys.}, 
give the author-numerical option:
\begin{verbatim}
\documentclass[aip,author-numerical]{revtex4-2}
\end{verbatim}
Note that the \texttt{author-numerical} option is not part of standard \revtex\, so use of it
outside of the AIP substyles may not have any effect. 

\subsection{Formatting Options}
There are two commonly used formats for an article you may write. 
One will comply with the manuscript submission formatting requirements of the editorial office of the journal you are submitting to.
The other will emulate the format of your article in the published journal itself. 

For journal submission, accept the default, or you may specify the \texttt{preprint} option:
\begin{verbatim}
\documentclass[aip,preprint]{revtex4-2}
\end{verbatim}
To emulate the formatting of the journal, specify the \texttt{reprint} option:
\begin{verbatim}
\documentclass[aip,reprint]{revtex4-2}
\end{verbatim}
Note that emulation is not by any means complete: the fonts used will differ, and therefore
the length of the article will not represent an accurate estimate. 
Other details may also differ. 

A summary of class options of interest to AIP authors appears in Table~\ref{tab:options}.
\begin{table}
\caption{\label{tab:options}Other class options}
\begin{ruledtabular}
\begin{tabular}{ll}
\textbf{Function} & \textbf{class option} \\
\multicolumn{2}{l}{\textit{Citation and References}}\\
superscript numbered&\texttt{numerical}\footnotemark[1]\textsuperscript{,}\footnotemark[2]\\
author-year&\texttt{author-year}\footnotemark[3]\\
numbered author-year&\texttt{author-numerical}\footnotemark[3]\\
%
\multicolumn{2}{l}{\textit{Format}}\\
journal submission&\texttt{preprint}\footnotemark[1]\\
journal emulation&\texttt{reprint}\\
\end{tabular}
\end{ruledtabular}
\footnotetext[1]{Default option.}%
\footnotetext[2]{Standard}%
\footnotetext[3]{Only allowed for \textit{Chaos} or \textit{J. Math. Phys.}}%
\end{table}

\section{Useful \LaTeXe\ Markup}
\LaTeXe\ markup is the preferred way to structure your file. 
In general, the use of low-level commands like \TeX\ primitives or Plain \TeX\ macros 
is less preferable. 
Please see the \revtex\ User's Guide,\cite{Note2} 
the \LaTeX\ manual,\cite{LaTeXman} 
and the \LaTeXe\ book\cite{Compan} 
for further details. 

\subsection{Title and Front Matter}\label{sec:front}

The \revtex\ User's Guide has complete information on using \revtex's special markup for your
article's title, author list, abstract, and other front matter elements. 
Note that class option \texttt{superscriptaddress} is the default for the AIP substyles, 
as required by all AIP journals. 

\subsection{Lead Paragraph}
One AIP journal, \textit{Chaos}, requires a paragraph of text to precede the first
\cmd\section\ of the article; 
this is known as a lead paragraph and is formatted boldface. 
To give your article a lead paragraph, 
include a quotation environment ahead of the first \cmd\section\ command:
\begin{verbatim}
\documentclass[aip]{revtex4-2}
\begin{document}
 \begin{quotation}
  Here is my lead paragraph!
 \end{quotation}
 \section{Introduction}
...
\end{verbatim}

The \texttt{quotation} environment functions normally after the first \cmd\section\ command in the document.

\section{Body}

For general information on commands used in the body of the document, see the \revtex\ User's Guide.
Herein are some features specific to the AIP author.

\subsection{Footnotes}

If you are using numbered citations (numerical or numbered author-year), 
footnotes are by default incorporated into the reference section 
along with your bibliographic entries. 
This automated feature is only effective if you use Bib\TeX\ to prepare your
bibliography. 

Author-year style bibliography does not lend itself to such a treatment, 
so by default footnotes appear in text as is usual. 
However, be advised that, if your article is accepted for publication,
footnotes may be incorporated into text during the production process.

\section{Citations and References}\label{sec:endnotes}

The preparation of your bibliography ``by hand'' is possible; 
however, if you do so, 
you will be entirely responsible 
for compliance with submission requirements for your bibliographic entries, 
for incorporating any text footnotes into the references, 
and for checking bibliographic entries. 
(In this connection, you may find useful the file \texttt{reftest.tex}, distributed with \revtex.)

There are numerous reasons to use Bib\TeX, not least because it automates the first and second of the above checks. 

\subsection{\label{sec:use-bib}Using Bib\protect\TeX}

Refer to the \revtex\ User's Guide, the \LaTeX\ manual, and the Bib\TeX\ manual
for full information about using Bib\TeX. 

When using Bib\TeX\, keep in mind that changing your bibliography style or citation style
(via the document class options described above) will require you to rerun Bib\TeX.
The standard litany (using \texttt{aipsamp.tex} as an example) for this is:
\begin{verbatim}
> latex aipsamp
> bibtex aipsamp
> latex aipsamp
> latex aipsamp
\end{verbatim}
Here, the first invocation of \texttt{latex} has the effect of rewriting the
\texttt{aipsamp.aux} file,
and the invocation of \texttt{bibtex} creates a new \texttt{aipsamp.bbl} file. 
The next two runs of \texttt{latex} are then required: 
the first to update the \texttt{aipsamp.aux} file reflecting the new values of your citations
and the second to employ those citations correctly. 
Be sure to check the end of the \texttt{aipsamp.log} file for any message advising you to 
rerun \texttt{latex}. 

\subsection{Multiple References per Citation}
In an article using numerical citations, 
it is not uncommon to encounter the need for a citation 
that refers to more than one article or other reference. 
To accommodate such a case, \revtex~4.2 implements markup similar to that of the 
\texttt{mcite} package for \LaTeXe. 

Let's say that two citation keys \texttt{able} and \texttt{baker} 
need to be combined into a single reference.
The syntax for the \cmd\cite\ command is:
\begin{verbatim}
word\cite{able,*baker} further text
\end{verbatim}
When you run Bib\TeX\, the resulting bibliography will contain the two entries, but run together
as a single numbered reference.
In the \cmd\cite\ command argument, any cite key that starts with the * character
signifies that its bibliographic entry is to be joined together with the one preceding it;
the \texttt{*} may join together any number of entries into a single reference.

\begin{thebibliography}{9}\label{sec:TeXbooks}%
\bibitem{Note1}
For help regarding the installation of this software and its use, please send email to \href{mailto:tex@aip.org}{tex@aip.org}.
%
\bibitem{Note2}
Available with the \revtex\ distribution, see \url{http://journals.aps.org/revtex/}.
%
\bibitem[Lamport(1996)]{LaTeXman} 
L. Lamport, 
\emph{\LaTeX\, a Document Preparation System} 
(Addison-Wesley, Reading, MA, 1996).
%
\bibitem[Goossens(1994)]{Compan} 
M. Goosens, F. Mittelbach, and A. Samarin, 
\emph{The \LaTeX\ Companion} 
(Addison-Wesley, Reading, MA, 1994).
%
\bibitem[Knuth(1986)]{TeXbook} 
D. E. Knuth, 
\emph{The \TeX book} 
(Addison-Wesley, Reading, MA, 1986). 
%
\bibitem[Kopka(1995)]{Guide} 
H. Kopka and P. Daly, 
\emph{A Guide to \LaTeXe} 
(Addison-Wesley, Reading, MA, 1995).
%
\bibitem[Goossens(1997)]{CompanG} 
M. Goossens, S. Rahtz, and F. Mittelbach, 
\emph{The \LaTeX\ Graphics Companion} 
(Addison-Wesley, Reading, MA, 1997).
%
\bibitem[Rahtz(1999)]{CompanW} 
S. Rahtz, M. Goossens \emph{et al.},
\emph{The \LaTeX\ Web Companion} 
(Addison-Wesley, Reading, MA, 1999).
%
\end{thebibliography}

\end{document}