Instructions for Authors Using LATEX Markup
Abstract:
template.tex file, and the examples here and in the sample documents
to prepare your paper.
Introduction
In order to ensure that papers received for publication from different authors are consistent in format, style, and quality, authors are required to type their manuscripts in LATEX format exactly according to the following instructions. The editors will modify the electronic manuscripts as necessary to insure that they conform to these standards.
Papers by invited speakers are allotted a maximum of ten (10) pages in the Proceedings. Regular oral presentations, posters, and demos are limited a maximum of four (4) pages each; BoF summaries are limited to one (1) page. Presenters of multiple papers will be permitted to submit a manuscript for each for inclusion in the Proceedings, although it is necessary that we receive a completed Publication Agreement and Copyright Assignment form for each submission. Because of the extremely high cost, color illustrations will not be published in the paper version of the proceedings, but may be included in the electronic version of the proceedings. All authors should send black-and-white figures, plus the color versions of their figures if they wish to. Any figure sent in color version only will be reproduced in black and white in the Proceedings book.
LATEX Markup Commands
Authors should use the adassconf style file, and declare it as
a substyle to the standard LATEX article style. A copy of
the style file, two sample papers, a template file, and further instructions are available at the ADASS XVI web site. See the
§6 file for instructions for manuscript submissions.
You should use only those markup commands from LATEX
plus the several extensions provided by this style file. Do not define any
commands of your own for any reason (no \def or \newcommand
statements).
Preamble
The first piece of markup in the manuscript must declare the overall style of the document.
\documentstyle[11pt,adassconf]{article}
The \documentstyle command must appear first in any
LATEX file, and this one specifies the main style to be
the LATEX article style using eleven point fonts,
with modifications and additions for the adassconf substyle.
The author must include a
\begin{document}
command to identify the beginning of the main portion of the manuscript.
Paper ID Code
Authors must include their proper paper identification code using the\paperID command. The ID code for your paper is the session number
associated with your presentation as published in the official ADASS XVI conference program.
You can find this number locating your abstract in the printed program that you received at the
meeting or via
the on-line program (click on the link to your abstract);
the ID codeis the letter-number sequence proceeding the title of your presentation.
The paper ID code will not appear in your paper; however, it allows
different papers in the proceedings to cross-reference each other.
You should only have one \paperID per submission, and it
should not include a trailing period.
Contact Information
Authors should include a contact person and email address using the
\contact and \email macros. This information will not
appear in the paper but will be used by the editors in case you need to be
contacted concerning your submission. Enter your name as the contact along
with your email address.
Author Index Specification
Use the \paindex and \aindex macros to indicate how each
author name should appear in the author index. The \paindex should
be used to indicate the primary (first) author, and the \aindex
for all other co-authors. You MUST use the following syntax:
where F is the first initial and M is the second initial (if used). This guarantees that authors on multiple papers will appear only once in the author index.\aindex{LASTNAME, F. M.}
Subject Index Keywords
You must use the \keywords macro to enter up to 6 keywords
describing your submission. These will NOT be printed as part of your
paper; however, they will be used to generate the subject index for the
proceedings. There is no standard list; however, you can consult the
indices for past ADASS proceedings.
Title, Byline, Abstract, etc.
Title and author identification are by way of the standard LATEX
commands \title and \author. An author's principal
affiliation is specified with a separate macro \affil. Each
\author command should be followed by a corresponding \affil
(address). If possible, authors should limit the number of \author
commands by grouping authors by affiliations.
The\title{lucid text}
\author{name(s)}
\affil{address}
\affil command should be used to give the author's full postal
address. The address will be broken over several lines automatically;
do not use LATEX 's \\ command to indicate the line
breaks. Please use mixed case text for all these fields
rather than supplying all capitals; the style file will convert to upper
case as necessary.
The article must contain an abstract enclosed in an abstract
environment:
Do not include the word ``Abstract'' in your text; it is inserted automatically. And do not leave a blank line between\begin{abstract}
abstract text
\end{abstract}
\begin{abstract}
and the start of the text of the abstract.
Sections
The LATEX article environment supports two levels of sectioning.
(Actually, it supports more, but these are the relevant ones.)
Please use mixed case text for the section heads:\section{heading}
\subsection{heading}
``Conclusions and Future Work'' instead of
``Conclusions and future work''
If one wishes to have an acknowledgments section, it should be set off simply with the command
\acknowledgments
Hypertext Links and URLs
Since the proceedings will be published in both paper and electronic form, you are encouraged to specify URLs to other relevant electronic documents when appropriate. Avoid links to personal files that may disappear after a few months, making the links obsolete.
The ADASS conference style provides several macros to ensure hypertext
links and URLs are formatted properly in each version. The most
used commands are \htmladdnormallink and
\htmladdnormallinkfoot. These commands are analogous to the
<a ...> tag in HTML, allowing you to link a piece
of text to a URL. Both commands take two arguments: the link text and
the associated URL. For example:
\htmladdnormallink{ADS}{http://adswww.harvard.edu/}
Using \htmladdnormallinkfoot will cause the URL to appear in
the printed copy of you paper as a footnote to that text (for example,
when one refers to the
ADS). In the
on-line version, the text will be an actual HTML link to that URL.
\htmladdnormallink is just like \htmladdnormallinkfoot
except that the URL does not appear in the printed version.
If you wish to have the URL explicitly appear within the body of your
paper (rather than as a footnote) you can use the \makeURL or
\htmladdURL command to format it:
\makeURL{URL}
\htmladdURL{URL}
\htmladdURL will cause the URL to be a link to itself in the
on-line version; with \makeURL, the URL will appear as plain
text.
Note that it is not necessary to escape special characters like tilde
(~) and underscore (_) within your URLs when you enter
them as arguments to any of these four commands. These special
characters will be properly formatted in both the on-line and printed
versions:
\htmladdnormallink{my document}%
{http://www.cfht.hawaii.edu/~crabtree/my_doc.html}
Equations
Displayed equations can be typeset in many ways using the standard displayed math environments of LATEX ; these three are probably of greatest use:
The\begin{displaymath}
\end{displaymath}
\begin{equation}
\end{equation}
\begin{eqnarray}
\end{eqnarray}
displaymath environment will break out a single, unnumbered
formula. The equation will appear the same if it is set in an
equation environment, and it will be autonumbered by LATEX .
In order to set several formulæ in which vertical alignment is
required, use the eqnarray environment.
Tables
Tables may be formatted using the deluxetable environment. Details
about this table environment can be found in the AASTEX user guide
found online at the URL: http://www.ferberts.com/AAS/aastex.html.
\begin{deluxetable}{cols}
\tablecaption{text}
\tablehead{column headings}
\colhead{text}
\startdata
data
\enddata
\end{deluxetable}
The cols specifies the justification for each column. One of
the letters `l', `c', or `r' is given for each column, indicating left,
center, or right justification. The font size of the table information
can be adjusted using the \small, \footnotesize, or
\scriptsize commands right after \begin{deluxetable}.
(Reducing the size of the text will reduce the readability
of the table, however.) The table width can be explicitly set with the
\tablewidth{ width} command.
Tables may also appear in table environments, although the
deluxetable environment is preferred.
There should be only one table per environment. The\begin{table}
\caption{text}
\begin{tabular}{cols}
\end{tabular}
\end{table}
table
environment encloses not only the tabular material but also any title
(caption) or footnote information associated with the table. Tabular
information is typeset within LATEX 's tabular environment;
the cols argument specifies the formatting for each column.
Tables and figures will be identified with arabic numerals, e.g.,
``Table 2.''; the identifying text, including the number, is generated
automatically by the \caption command.
The table environment provides more control over column spacing than the deluxetable environment. Instead of reducing the font size when a table is too wide, it may be possible to use this control to make it fit. An example is given in the sample2.tex document (Table 3).
There is a \tableline command for use in tabular
environments. This command produces a single horizontal rule.
There should be two \tableline's above and one below between
the column headings, and one at the end of the table. Authors should
not use additional \tablelines, and are discouraged from using
vertical rules unless essential.
Figures as EPS Files
Authors who can prepare computer graphics in Encapsulated PostScript (EPS) format may use one of two additional markup commands to mark the point of inclusion, both of which should be used inside a LATEX figure environment. If the DVI translator :!:}dvips (by Tom Rokicki) is available on your computer, it is also possible to prepare the final copy with such figures in place.
Before including the EPS figures in your text, be sure to rename the EPS files to conform to the name of your LATEX file: O4.1_1.eps, O4.1_2.eps, etc. You will use these names in the markup commands for including EPS figures.
These markup commands are:
\plotone{file}
\plottwo{file}{file}
The file argument is used to name the file(s) to be included. The
\plotone command includes one figure that is scaled to the width of
the current text column; \plottwo inserts two figures side by side,
and the pair is scaled to fit the text width. If one uses these
macros, the necessary vertical space is provided automatically.
or\begin{figure}
\plotone{O4.1_1.eps}
\caption{My EPS graphic.}
\end{figure}
Please note that the caption will be centered under the pair of graphics when\begin{figure}
\plottwo{O4.1_1.eps}{O4.1_2.eps}
\caption{Two related graphics.}
\end{figure}
\plottwo is used. It is not possible to caption the two
plots individually with this package at this time. As with tables, figures
will be identified with arabic numerals, e.g., ``Figure 1.''
The scaling of the EPS plot may be adjusted with the
\epsscale{ scale} command, i.e., \epsscale{0.8}.
Specifying \epsscale{0.8} should make the figure 80% as wide as
the text on the page.
The reason that EPS figures refuse to be positioned properly with
\plotone and \plottwo is usually a bad BoundingBox
comment in the PostScript. The bounding box is supposed to be the
smallest rectangle, with sides parallel to the edges of the paper, that
surrounds all of the marks on the page. Extra white space can make a
figure off-centered or hard to scale. If you can print the figure, the
problem can be fixed by editing the EPS file and changing the BoundingBox
comment, which contains four numbers: lower-left
, lower-left
,
upper-right
, and upper-right
coordinates, measured from the
lower-left hand corner of the paper in units of 72 per inch. If you use
a PostScript preview program like gs or gv, you can position
the cursor at the corners of the figure and read off the coordinates.
As a last resort, if further fussing with the positioning of plot on the printed page is necessary, you can try using this command:
\plotfiddle{file}{vsize}{rot}{hsf}{vsf}{htrans}{vtrans}
vsize vertical white space to allow for plot, any valid LATEX dimension rot rotation angle, in degrees, counter-clockwise hsf horiz scale factor, percent vsf vert scale factor, percent htrans horiz translation, in PS points 72/in vtrans vert translation, in PS points 72/in
If you can produce EPS but you do not have :!:}dvips,
you can still put the \plotone or \plottwo commands in the
the appropriate places, but you will have to comment them out and put
in a \vspace{ dimen} command to open up the text.
The :!:}dvips program is in the public domain and is available from
labrea.stanford.edu.
A special note to authors: Since it is sometimes necessary to edit EPS files to make them printable, authors should try to avoid EPS files with lines longer than 1024 characters.
Pasted in Illustrations
Illustrations must be inserted in the text at the appropriate places, with the relevant caption underneath each. The finished pages are reduced by 10% before printing. Thus, illustrations will appear somewhat smaller in print.
These illustrations should appear in figure environments.
There should be only one figure per environment. Space for the figure is created with the\begin{figure}
\vspace{dimen}
\caption{text}
\end{figure}
\vspace command;
dimen should be a valid LATEX
dimension, e.g., ``2.5in''.
Size of Illustrations
The maximum width of an illustration is normally 13.4cm (5.25in) so that it will fit within the width of the text area. Of course an illustration may be smaller if appropriate. A large illustration may be placed sideways (``landscape'') on the paper if necessary.
Halftone Illustrations (Photographs)
Good glossy original prints are required, black and white only; color plates cannot be reproduced. Photographs cut from other publications will not reproduce well, and usually infringe copyright. reduced the and a reduced version pasted in the text. The pasted-in version will be used for size and placement only; a copy machine can be used for this reduction. If a reduction is not supplied, leave appropriate space in text above the figure caption. The publisher will take care of the photographic reduction and mounting of the original glossy print in the space provided by your pasted-in version.
References
In the Text
The reference system to be followed is the standard system: author name(s) followed by the year in parentheses, as in Abt (1990), or author and year both in parentheses (Abt 1990). Multiple authors would be cited as (Groth & Pebbles 1971) or (Kron, Hewitt, & Wasserman 1984). For more that three authors use ``et al.,'' e.g., (Press et al. 1994).
Reference List
There is a references environment that sets off the list of references and adjusts spacing parameters.
The bibliographic information should be in the order directed by Abt (1990): author, year, journal, volume, and page. For instance, the reference for this editorial would be typed in as\begin{references}
\referencebibliographic information
.
.
\end{references}
Abt, H. 1990, ApJ, 357, 1
Note that there is no comma following the author name(s), there is no
trailing period at the end of the reference, and the entire line is set
in the body typeface (no font changes). See sample2.tex for more
complex examples.
To refer to a paper from this conference, use the \adassxii and
\paperref macros, and 2003 for the year. For example,
will appear as\reference Zacharias, N.\ \& Zacharias, M.\ 2003,
\adassxii, \paperref{O4.1}
Zacharias, N. & Zacharias, M. 2003, , O4.1in your preprint version of the paper; in the proceedings volume, the ``[O4.1]'' will be replaced with the actual page number of the paper.
Care should be taken that each literature citation in the manuscript has its counterpart in the reference list and vice versa. Care should also be given to checking the accuracy of the references--author(s), date, volume, and page number. The accuracy of the references is the sole responsibility of the author.
Abbreviations for Journals
There are macros for many of the oft-referenced journals so that authors may use the LATEX names rather than having to look up a particular journal's specific abbreviation. Any stylistic requirements of the editors are taken care of by the macros, so authors need not be concerned about such editorial preferences.
\aj |
Astronomical Journal |
\araa |
Annual Review of Astronomy and Astrophysics |
\apj |
Astrophysical Journal |
\apjl |
, Letters to the Editor |
\apjs |
, Supplement Series |
\ao |
Applied Optics |
\apss |
Astrophysics and Space Science |
\aap |
Astronomy and Astrophysics |
\aaps |
, Supplement Series |
\azh |
Astronomicheskii Zhurnal |
\baas |
Bulletin of the AAS |
\jrasc |
Journal of the RAS of Canada |
\memras |
Memoirs of the RAS |
\mnras |
Monthly Notices of the RAS |
\pra |
Physical Review A: General Physics |
\prb |
Physical Review B: Solid State |
\prc |
Physical Review C: |
\prd |
Physical Review D: |
\prl |
Physical Review Letters |
\pasp |
Publications of the ASP |
\pasj |
Publications of the ASJ |
\qjras |
Quarterly Journal of the RAS |
\skytel |
Sky and Telescope |
\sovast |
Soviet Astronomy |
\ssr |
Space Science Reviews |
\zap |
Zeitschrift für Astrophysik |
\adassi |
ADASS I |
\adassii |
ADASS II |
\adassiii |
ADASS III |
\adassiv |
ADASS IV |
\adassv |
ADASS V |
\adassvi |
ADASS VI |
\adassvii |
ADASS VII |
\adassviii |
ADASS VIII |
\adassix |
ADASS IX |
\adassx |
ADASS X |
\adassxi |
ADASS XI |
Examples
These instructions give an overview of the basic markup commands that
need to be entered in a paper. Authors are encouraged to examine the
sample papers that are included with the style file; these examples
are named sample1.tex and sample2.tex. The file
sample1.tex is a paper prepared with the ADASSCONF macros
utilizing a minimal amount of markup. A more ``complete''
paper requiring most of the capabilities of the package is provided as
sample2.tex; this file is annotated with comments that describe
the purpose of the markup.
Reprints
Reprints of papers for these Proceedings are not available. Articles may be copied from the published volume.
Submission of Manuscripts
Completed manuscripts should submitted via anonymous FTP using the following procedure:
- Anonymous-FTP to
adass.org. Give ``anonymous'' as the login name and your email address as the password. - Change into the outside-access/in.coming/adass2002 directory:
cd pub/adassxvi - Create a subdirectory whose name is the paper identification code.
Use upper case for letters. Change directory to this new directory.
For example:
mkdir O4.1
cd O4.1 - Upload your files using the
putcommand. Identify the LATEX manuscript giving it a name using the paper identification code (e.g., ``O4.1.tex''). Any EPS files should be identified in a similar way (e.g., ``O4.1_1.eps'', ``O4.1_2.eps''; see also §2.11 ). Note that you will be able to see a listing of the files you upload usingls; however, you will not be able download, delete, or overwrite them after the upload. If you wish to upload any other files please name them using the same convention, i.e., starting with your paper identifier (e.g., O4.1.junk). - Disconnect by typing
bye.
Here is how a sample session might look:
% ftp adass.org
Name (cadcftp.hia.nrc.ca:bohlendr): anonymous
Password: shaw@noao.edu
ftp> cd pub/adassxvi
ftp> mkdir P4.48
ftp> cd P4.50
ftp> put O4.50.tex
ftp> put O4.50_1.eps
ftp> put O4.50_2.eps
ftp> bye
If you have figures that cannot be sent in PostScript form, you can mail them to the editors:
The ADASS XVI editors would like to acknowledge the other previous editors
for their work on this manual and the associated style files upon which
this manual and adassconf.sty are built.