My AGU Latex Instructions

User Manual:

Open the PDF directly: View PDF .
Page Count: 18

Download
Open PDF In Browser	View PDF

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
LineNumbers
Numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

(Click on the tabs above for more information on each topic. Some tabs also have tabbed subtopics.)

Welcome to the AGU Journal Style File
Welcome to the use of the new AGUJournal.cls file. We’ve made the process of preparing your article for submission to
AGU as simple as possible, and hope you’ll enjoy the process.
Tech Support
If you need help after you read this documentation, you may send
email to latex@agu.org. If possible please send a small file demonstrating the problem.

AGU Requests
1. Please do not use your own macros
Do not use \newcommand, \renewcommand, or \def or \providecommand.
2. When making itemized lists, please use only ‘enumerate’, not ‘itemize’.

Files in this package, and what they do
Basic Macro File

AGUJournal.cls

Use: \documentclass{AGUJournal}

Documentation

docs.pdf

This file

Sample File

AGUJournalSample.tex/.pdf Sample file to see the LaTeX commands in use, and to compare with the
resulting typeset document.
Sample figures

figsamp.eps/.pdf

For use in AGUJournalSample. Figure sample file in .eps form for dvips,
and .pdf form for pdflatex.

Template file

AGUJournalTemplate.tex

Template file, for authors to copy and rename when making their own
article.

Sample Supplementary Information

AGUSuppInfoSample.tex/pdf Sample for making Supplementary Information file, with resulting pdf.

You’ll find many comments and useful tips in both the sample and template files.
Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

1

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Title
TitlePage
Page Key
KeyPoints
Points Article
ArticleBody
Body
Using the Template file
The easiest way to start your article is to copy and rename the template file, AGUJournalTemplate.tex,
and use it to start your own article.

Setting Documentclass Options
You’ll see this near the top of the AGUJournalTemplate.tex file:

Step 1: Set the \documentclass
There are two options for article format:
1) PLEASE USE THE DRAFT OPTION TO SUBMIT YOUR PAPERS.
The draft option produces double spaced output.
2) numberline will give you line numbers.

To submit your paper
Please use \documentclass[draft,linenumbers]{AGUJournal}
The draft option will give more vertical space between lines, and will also allow suggested editorial changes
to appear in color.

For Final Version
Please use \documentclass{AGUJournal}
The final version will have less space between lines, and will not allow colored editorial changes. At this point
any changes that have been made and not revised will be finalized.
Numbered lines are not appropriate for the final version, so no options should be set when the article is in its
final stage.

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

2

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Title
TitlePage
Page Key
KeyPoints
Points Article
ArticleBody
Body

Making the Title Page
The title page will have these elements:

\journalname{}
\title{}
\authors{}
\affiliation{}{}
\correspondingauthor{}
\begin{keypoints}
\item Point 1
\item Point 2
\item Point 3
...
\end{keypoints}
Journal Name Type in name of the journal you are submitting your article to:
\journalname{}. There is a list of journal names in AGUJournalTemplate.tex.
Title A title should be specific, informative, and brief. Use abbreviations only if they are defined in the
abstract. Titles that start with general terms then specific results are optimized in searches.
Type in article title: {
}.
Authors Authors are entered with the \author command: \author{}}. List authors
by first name or initial followed by last name and separated by commas.
Authors are individuals who have significantly contributed to the research and preparation of the article.
Group authors are allowed, if each author in the group is separately identified in an appendix.
1. Each author should be given one or more affiliation number with the \affil{} command.
2. \thanks{} may also be used to enter additional author notes, for example, to list current
addresses.
Here is a sample author entry:

\authors{A. B. Author\affil{1}\thanks{Current address, Antartica},
B. C. Author\affil{2,3}, and
D. E. Author\affil{3,4}\thanks{Also funded by Monsanto.}}
Affiliation List The list is made with the \affiliation{}{} command, as you see below. Each
\affil{} number given in the \author{} field will need a matching {affiliation}{}{} listing.

\affiliation{1}{Department of Hydrology and Water Resources,
University of Arizona, Tucson, Arizona, USA.}
\affiliation{2}{}...
Corresponding Author Include name and email addresses of the corresponding author. More than one
corresponding author is allowed in this .tex file and for publication; but only one corresponding author is
allowed in our editorial system.

\correspondingauthor{A. B. Smith}{email@address.edu}
Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

3

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Title
Keypoints Article
TitlePage
Page Keypoints
ArticleBody
Body
Keypoints are final entry on title page.
1. List up to three key points (at least one is required)
2. Key Points summarize the main points and conclusions of the article
3. Each must be 100 characters or less with no special characters or punctuation
Sample:

\begin{keypoints}
\item Evolution of raw ensemble forecast skill
\item Future benefits from statistical post-processing
\item Global distribution of forecast skill development
\end{keypoints}

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

4

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Title
ArticleBody
Body
TitlePage
Page Key
KeyPoints
Points Article

Article Body
The body of the article starts with the abstract.

\begin{abstract}

\end{abstract}
The abstract starts a new page, ending the title page.

Section heads
The main text should start with an introduction. Except for short manuscripts (such as comments and
replies), the text should be divided into sections, each with its own heading.
Headings should be sentence fragments and do not begin with a lowercase letter or number. Examples of
good headings are:

\section{Materials and Methods}
Here is text on Materials and Methods.
\subsection{A descriptive heading about methods}
More about Methods.
\section{Data} (Or section title might be a descriptive heading about data)
\section{Results} (Or section title might be a descriptive heading about the
results)
\section{Conclusions}

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

5

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Numbered Lines
When you use the linenumbers option: \documentclass[linenumbers]{AGUJournal}, the
lines in the complete article will be numbered.
The only additional step you need to take is to make sure that equations are also numbered. To accomplish
this, you need to add \begin{linenomath*} before the equation, and \end{linenomath*}
afterwards:

\begin{linenomath*}
\begin{equation}
123
\end{equation}
\end{linenomath*}
The numbering will continue sequentially.

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

6

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Track Changes
Revisions made to the text may be tracked by using the following commands:
To add words, \added{}
To delete words, \deleted{}
To replace words, \replace{}{}
To explain why change was made: \explain{}; This will put a comment into the right margin.
An optional argument may be used to send date/time/initials etc. to the list of changes: ie,

\added[date/time etc.]{}
List of Changes
At the end of the document, type \listofchanges, which will list the changes and the page and line
number where the change was made.
Confidential manuscript submitted to Journal of Geophysical Research

Sample
1

The (Added: current) abstract should be a single-paragraph of less than 250 words, or

2

for Geophysical Research Letters, less than 150 words. A (Added: really!) good abstract sets

3

the (Deleted: general) question or topic that you are studying for the general reader, provides

4

background on the specific question or problem, briefly describes key data or analyses, and

5

describes the key results and (Replaced: certainties with uncertainties). (Deleted: In other

6

words, probabilistic biases, which can be reduced by statistical post-processing methods,

7

decrease over time.)

← Redundant
sentence,
better without it

List of Changes
Added: current, on page 1, line 1.
Added: really!, on page 1, line 2.
Deleted: general, on page 1, line 3.
Replaced: certainties with uncertainties, on page 1, line 5.
Deleted: In other words, probabilistic biases, which can be reduced by statistical post-processing
methods, decrease over time., on page 1, line 7.

In final version
When the draft option is not on, \listofchanges will not produce anything,

\added{} word will be printed,
\deleted{}{} will print only the
replacement word.
In the final version, \explain{} will not print anything.
Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

7

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Graphics Files
Insert graphics file with the command

\includegraphics[height=, width=]{}
Generally, you should supply Either height or width, and the other dimension will accomodate, and your aspect
ratio will be correct. (The aspect ratio describes the proportional relationship between the width of an image and its
height.)

Tip
You can call for the width of the graphic in terms of the width of the page.
Often this combination is used:

\centerline{\includegraphics[width=.8\textwidth]{}}

Use the right filename extension
You must use the correct extension depending on which program you use to turn your .tex file to .pdf.
If you are using xelatex, or pdflatex, you must supply .pdf, .jpg or .png files
if you are using dvips you must use .eps or .tif files.

Conversion
EPS files can be converted to PDF using the epstopdf utility, included in most LaTeX distributions. On the command
line, you can use epstopdf .eps and a .pdf will be produced.
Another possibility is translating .eps files to .pdf with the Acrobat program, or with Photoshop.

Notes on Graphics Choices
JPG: widely used on Internet, digital cameras, etc. They are the best choice if you want to insert photos.
PNG: a very common format (even if not as much as JPG); it’s a lossless format and it’s the best choice for diagrams
(if you were not able to generate a vector version) and screenshots.
PDF: is widely used for documents but can be used to store images as well. It supports both vector and bit-map
images, but it’s not recommended for the latter, as JPG or PNG will provide the same result using less disk
space (if this is an issue).

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

8

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Figures
Figuresand
andTables
Tables Tables
Tables Figure
Figureand
andTable
TableTips
Tips

Figures and Tables, AGU Requests
1. Enter Figures and Tables near as possible to where they are first mentioned.
2. Do not use \psfrag or \subfigure commands.
3. Remember that a cross-referencing label should be used within or after the caption, but not before it, in
order to reference the correct figure or table number.
4. Figure captions go below the figure.
Table titles go above tables.
Example figure:

\begin{figure}

\caption{}
\label{}
\end{figure}

Tables: AGU requests
1. Start the caption with a short description of your table.
2. Large tables especially presenting rich data should be presented as separate excel or .cvs files, not as part
of the main text.

Example Table

\begin{table}
\caption{}
\label{}
\begin{tabular}{}
table&line\\
\end{tabular}
\end{table}

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

9

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Figures
Figuresand
andTables
Tables Tables
Figureand
andTable
TableTips
Tips
Tables Figure

Making the table
1. Caption goes on top of table.
2. For visual clarity, try to avoid vertical lines in the table.
3. Your table will look better if you use horizontal lines only at the top, underneath the column headers, and at
the bottom of table.
4. To make more vertical space between lines in tables you can use \vrule height 10pt depth 3pt
width 0pt, called a ‘strut’. You can choose the height and depth dimensions, remembering to always
make the ‘width’ = 0pt, so that it won’t print.
For example, to make more vertical space between lines:

\vrule depth12pt width 0pt
5. Use \centering to make table center horizontally, ie,

\centering
\begin{tabular}{cc}
line one& here\\
line two&here
\end{tabular}

Table Notes
Table notes should be placed in last line of the table, using

\multicolumn{}{}{} ie,
\multicolumn{2}{l}{$ˆa$ This is a table note.} Notice that the ‘a’ is raised by going into
math mode and using the superscript symbol ‘ˆ’.
Here is an example:
\begin{table}
\caption{Time of the Transition Between Phase 1 and Phase 2$ˆ{a}$}
\centering
\begin{tabular}{lc}
\hline
Run & Time (min) \\
\hline
$l1$ & 260
\\
...
\hline
\multicolumn{2}{l}{$ˆ{a}$Table note text here.}
\end{tabular}
\end{table}

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

10

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Figures
Figureand
andTable
TableTips
Tips
Figuresand
andTables
Tables Tables
Tables Figure

Sideways figure or table
See below for how to make sideways figures or tables. AGU prefers the use of
{sidewaystable} over {landscapetable} as it causes fewer problems.

\begin{sidewaysfigure}
\includegraphics[width=20pc]{figsamp}
\caption{caption here}
\end{sidewaysfigure}
\begin{sidewaystable}
\caption{Caption here}
\begin{tabular}{ccc}
one&two&three\\
\end{tabular}
\end{sidewaystable}

To make table fit in width of page
\tabcolsep The default distance between columns in a table is 6 pt, added on both sides of
the &, ...\tabcolsep&\tabcolsep... so normally there is 12 points space
between columns. You can reduce the width of your table by changing the size of
\tabcolsep. For instance, advance\tabcolsep-4pt will subtract 8 points
between table columns.

Tip: Page Placement for Figures and Tables
Often authors have problems with keeping tables or figures close to their first mention in
the text. A tool to help with this problem is putting more than one illustration and caption in
the same figure; or caption and table in one table environment.
This may help position your illustrations closer to where they are mentioned in the text.

\begin{figure}
\includegraphics{figone}
\caption{here is caption}
\vskip12pt
\includegraphics{figtwo}
\caption{here is a caption for figtwo}
...
(repeat for more figures if desired)
\end{figure}
This works with tables as well, where you can put a group of captions and tables within
one \begin{table}...\end{table}.
Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

11

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Appendices
Glossary,Acronyms,
Acronyms,and
andNotation
Notation Acknowledgments
Citations References
References BibTeX
Appendices Glossary,
Acknowledgments Citations
BibTeX

End of Article
Optional Appendix; Optional Glossary, Notation or Acronym sections; and Acknowledgments go at the end of the article,
before References.

Title Page
Body of Paper
Appendix
Optional Glossary, Notation, or Acronyms
Acknowledgments
References

Appendices
The command \appendix resets counters and redefines section heads but doesn’t print anything.
After typing \appendix

\section{Here Is Appendix Title}
Text...
\section{Second Appendix Title}
will make

A.1 Here Is Appendix Title
B.1 Second Appendix Title
Equations, table and figure captions will all include the appendix letter in their numbering.

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

12

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Appendices
Glossary,Acronyms,
Acronyms,and
andNotation
Notation Acknowledgments
Citations References
References BibTeX
Appendices Glossary,
BibTeX
Acknowledgments Citations

Acknowledgments and Data
The text ends with an acknowledgment section and statement that includes:
All funding sources related to this work from all authors (funder and grant number)
Any real or perceived financial conflicts of interests for any author
Other affiliations for any author that may be perceived as having a conflict of interest with respect to the results of this
paper.
A statement that indicates to the reader where the data supporting the conclusions can be obtained (for example, in the
references, tables, supporting information, and other databases).
It is also the appropriate place to thank colleagues and other contributors. AGU does not normally allow dedications.
To format acknowledgments, you need only to enter \acknowledgments, for example:

\acknowledgments
The forecast data used in this study can be made available subject to
a handling charge. SYNOP observations are not available through ECMWF.
We are grateful to F. Rabier, D. S. Richardson, D. Lavers, and other
colleagues at ECMWF for helpful discussions and inputs. We thank David
M\"{o}ller of the University of Heidelberg for his contribution.
Furthermore, we like to thank T. Gneiting of the Heidelberg Institute
...
The Editor thanks Pierre Pinson and an anonymous reviewer for their
assistance in evaluating this paper.

Using LATEX for Typesetting AGU Journal Articles / by Amy Hendrickson, TEXnology Inc. / www.texnology.com / amyh@texnology.com

13

How to Prepare AGU Journal Articles in LATEX
Welcome
Welcome

Getting
GettingStarted
Started

Line
Linenumbers
numbers

Track
TrackChanges
Changes

Graphics
Graphics

Figs/Tables
Figs/Tables

Ending
EndingArticle
Article

Supporting
SupportingInfo
Info

Appendices
Citations References
References BibTeX
Glossary,Acronyms,
Acronyms,and
andNotation
Notation Acknowledgments
Appendices Glossary,
Acknowledgments Citations
BibTeX
Glossary
Glossary is only allowed in Reviews of Geophysics. Make it like this:

\begin{glossary}
\term{Term}
Term Definition here
...
\end{glossary}

Acronyms

\begin{acronyms}
\acro{Acronym} Definition here
...
\end{acronyms}

Notation

\begin{notation}
\notation{

---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.5
Linearized                      : No
Page Count                      : 18
Page Mode                       : UseNone
Author                          : Author
Title                           : My title
Subject                         : Subject
Creator                         : Creator
Producer                        : Producer
Keywords                        : keywords
Create Date                     : 2016:02:18 17:33:48-05:00
Modify Date                     : 2016:02:18 17:33:48-05:00
Trapped                         : False
PTEX Fullbanner                 : This is MiKTeX-pdfTeX 2.9.4902 (1.40.14)

EXIF Metadata provided by EXIF.tools