# Apj Bibliography Style Citation

## Usage

This section describes how to use the software. First make sure you have the necessary files in the right place, or have environment variables set appropriately (see section Installation).

## Bibliography Files

Now we describe how to set up your BibTeX files. If you are familiar with BibTeX already you can probably skip this section.

### Bibliography database files

Using BibTeX, your references are stored in a file, for example (the suffix is important). These need not (indeed, should not) be limited to the articles you are citing in the document you are preparing; BibTeX picks out the ones you actually cite and only includes those in your bibliography.

A typical entry in a file looks like this:

@Book{Peebles:94, author = {P.~J.~E.~Peebles}, title = "Physical Cosmology", publisher = "Princeton University Press", year = 1994, address = "Princeton, NJ" }

or like this:

@Article{1997ApJ...485....1M, author = {Myers, S.~T. and Jonathan E.~Baker and Readhead, A.~C.~S. and Erik M.~Leitch and Herbig, T.}, title = "Measurements of the Sunyaev-Zeldovich Effect...", journal = apj, year = 1997, month = aug, volume = 485, pages = "1--8", }

Other types include , , , , , , , , , and . The type is a catch-all which allows you to do the formatting yourself if necessary. Most of these types should give correct results for the journals using the files included here for AAS and MNRAS.

The first thing after the { is the cite key, which you use to cite the reference in your document. Note that author names can have either first or last name first, and they are separated with . Very long lists can be truncated with . Natbib's automatic lettering will get confused if the author last names are not punctuated consistently (e.g., if some of them have extra braces as in ADS style and others don't).

Emacs (see section Useful Emacs modes) has a very nice set of commands for automatically generating a bibliographic entry in a file.

### Using String Abbreviations for Journals (optional)

BibTeX will complain if it does not know the definition of a string which is not enclosed in quotes, such as the strings and in the example above. References downloaded from ADS will have instead of ; this tells BibTeX to write in the bibliographic entry. This is fine for AASTeX macros, where the command is defined in the style file. But if you are using a style file which does not define this command, you will get errors from LaTeX unless you define it yourself.

One way to handle this is to use the journal abbreviation files such as the ones included here, or . These contain commands such as

@STRING{apj = "\apj"}

in and

@STRING{apj = "ApJ"}

in which define the strings if you use a command like or in your document (see section Preparing the LaTeX Document) to include the files. This way you don't have to change your database for different journals, and you don't have to define a lot of new journal commands in your LaTeX document. Look at the files to see all the defined abbreviations. The very short abbreviations such as "ApJ" for frequently cited journals are included, along with many others following the IAU convention.

The three-letter month abbreviation strings and strings for a few mathematics journals are defined in the bibliography style () files.

## Preparing the LaTeX Document

First include the natbib style file. For LaTeX 2e,

\documentclass{ ... } \usepackage{ ... ,natbib}

or for LaTeX 2.09 (required by the journals),

\documentstyle[ ... ,natbib209]{ ... }

Place the natbib package last in your list of packages to make sure it doesn't get over-written. It works with the AASTeX styles as well as the style, and with the style (mostly, but see section MNRAS style).

Second, somewhere in the preamble (before ), use the command

\citestyle{aa}

This simply insures that natbib gives you citations which look like (Bester 1998) and not like (Bester, 1998). The stands for Astronomy & Astrophysics, but this citation style is appropriate for all the journals. (Actually, the code , which prepares files for electronic submission, produces citations like this regardless of the command, so this does not matter for the final output.)

Next, at the point where you want the bibliography to appear, use

\bibliographystyle{STYLE} \bibliography{REFS}

where is the name of the bibliography style you want to use (e.g., to use -- leave off the suffix). is a list of bibliography files to use (leave off the ). So if you wanted to use the ApJ journal abbreviations (see section Using String Abbreviations for Journals (optional)) and a database called ,

\bibliography{apj-jour,myrefs}

This loads the journal definitions from , so you can use things like in .

## Citation commands

The natbib package defines a number of very useful citation commands which replace the usual . These are really necessary in any author-year citation system, where you don't always cite a reference using the same format for the citation. These commands and their output are illustrated below. The most frequently used are (textual cite) and (parenthetical cite). is equivalent to , but this shouldn't be used because it is often defined by other style files.

Bester et al. (1998)
(Bester et al. 1998)

Multiple citations work within a single cite, for example

(Bester et al. 1998; Garibaldi et al. 1997, 1998a,b; ...)

The lettering of the citations and references is done automatically.

You can use optional arguments to get text before and after the citation(s):

(Bester et al. 1998, hereafter B98)
(e.g., Bester et al. 1998)
(see Bester et al. 1998, p. 68)

Any of these can have a affixed to make a full author list when "et al." would normally be used, e.g.,

Bester, Winters, & Alexander (1998)

Note that the script takes care of the bizarre practice of listing three names on the first citation and using "et al." thereafter, so you don't need to worry about that, although the intermediate file will come out "wrong".

Bester et al.
1998
(1998)

and are the sames as and , respectively, except that they do not produce any parentheses at all:

Bester et al. 1998

Finally, can be used to place arbitrary text around a citation. Look at the comments in the natbib style files for more information.

## Processing LaTeX/BibTeX files

When you process a document for the first time, or when you add citations to new references, you have to go through four steps. For a file called with a bibliography :

1.
Stores the citation keys in the file
2.
Creates a bibliography () file
3.
Incorporates the information
4.
Gets all the citations and cross-refs right

The file is a normal-looking LaTeX file containing the environment; it is inserted into the document at the point where the command is issued.

If you are producing an article for electronic submission, you can stop after step #2, run (see section Generating a Copy for Electronic Submission) and then run LaTeX (twice) on the output.

It's not too difficult to automate this process (see section Makefiles) and speed things up.

## Generating a Copy for Electronic Submission

Your article looks great now, but in the shape it's in as of the last section, you'll have to use a decidedly low-tech method of submitting it to the journal: print it out and snail-mail it in! This is because you cannot include complex style files like with your submission, and the journals don't provide bibliographic style files.

(As of AASTeX version 5.0, this is no longer true! You can stop here and simply submit your and files. But the `minor tweaks' mentioned below won't be performed, so you'll have to do them by hand. For instance, use the commands rather than commands the first time you cite a reference with three authors, to get all the names.)

Fortunately, there is a Perl script, , which comes to the rescue. It takes the and files you have made (see section Processing LaTeX/BibTeX files) and makes new ones which you can actually submit. This is accomplished by

• inlining all the citation commands properly
• removing all dependencies on natbib
• spitting out 's with the right format

A few other minor tweaks are also performed; you may notice some small style errors in the document before processing it. For input files and , invoke it by typing

(make sure it is executable and in your ). By default it will make new output files and , but you can name them something different by specifying a second argument.

The new files can be processed completely independently of the natbib files, the files, and your files. The bibliography is simply pasted in from the file, so all you need are the and , with the usual one or two passes with to process them.

The code has two options:

Inlines the bibliography so you end up with a single, stand-alone file. The default leaves the bibliography in a separate file.
Change the maximum number of authors before is used; default is 8. Set to zero for no limit.
Rather than generating the default environment with 's, generate a environment. This also leaves off the or commands. I found it was necessary for preparing a PASP conference proceeding.

The code looks for a containing "mn". If it finds it, it adds commands next to the inlined references; otherwise it adds the AASTeX command (unless the flag is set).

The code also ensures that three-author papers are cited as Bester, Winters, & Alexander (1998) on the first citation and as Bester et al. (1998) thereafter. This will not be the case in the input files because natbib does not do this. In addition, it truncates long author lists at the right point (8 authors, natbib doesn't do this).

Finally, the code may alter the appearance of the typeset bibliography, because natbib may redefine the environment in the input files. The output files will conform to the other style files (such as AASTeX) you are using.

Note that the script should work on files produced with any bibliography style, as long as it produces commands which exactly follow this format:

{ }

The may be omitted when it is the same as the (usually, <3 authors). This is the "extended natbib" format used by natbib versions 5.3 and later. The script will become confused in the unlikely event that there are square brackets in the author lists. The entries must be separated by blank lines.

Examples are given here of some of the most common citation formats. Except in rare instances (e.g., Icarus) ADS bibliographic codes on the ADS site should be used for the appropriate refereed journal abbreviations. A list of codes for non-refereed publications is also available and should be followed.

Note that many of the electronic resource references are not persistent. The links provided here point to cached versions of the pages by the internet archive.

Journal Article

Martín, E. L., Rebolo, R., & Zapatero Osorio, M. R. 1996, ApJ, 469, 706
Aguirre, J. E., Ginsburg, A. G., Dunham, M. K., et al. 2011, ApJS, 192, 4

Digital Objects

Corrales, L. 2015, dust: Calculate the intensity of dust scattering halos in the X-ray, v1.0, Zenodo, doi:10.5281/zenodo.15991

Software and citable data objects in persistent repositories should include the repository name in addition to the DOI, and the version if appropriate.

Book

Donat, W., III, & Boksenberg, A. J. 1993, The Astronomical Almanac for the Year 1994, Vol. 2 (2nd ed.; Washington, DC: GPO)

Where specific pages of a book are cited, these should be given at the text citation, not in the reference list.

Article or Chapter in an Edited Collection

Huchra, J. P. 1986, in Inner Space/Outer Space, ed. E. W. Kolb et al. (Chicago, IL: Univ. Chicago Press), 65

Conference Proceedings

Salpeter, E. E., & Wasserman, I. M. 1993, ASPC 36, Planets around Pulsars, ed. J. A. Phillips, S. E. Thorsett, & S. R. Kulkarni (San Francisco, CA: ASP), 345

Electronic Conference Proceedings (published only online)

Gomez, M. 2000, in Cosmology 2000, ed. M.C. Bento, O. Bertolami, & L. Teodoro (Lisbon: Inst. Superio Tecnico), 57, http://alfa.ist.utl.pt/~bento/cosmo2000/proc/proceedings.html

Star Catalogs

Hoffleit, D. 1982, The Bright Star Catalogue (New Haven, CT: Yale Univ. Obs.)

Hermoso, D. 1996, ESA IUE Electron. Newsl. 46, http://www.vilspa.esa.es/iue/nl/newsl_46.html
Bersier, D., et al. 2004, GCN Circ. 2544, http://gcn.gsfc.nasa.gov/gcn/gcn3/2544.gcn3

Instrument Documentation

Gussenhoven, M. S., Mullen, E. G., & Sagalyn, R. C. 1985, CRRES/SPACERAD Instrument Description, Document AFGL-TR-85-0017 (Hanscom, MA: Air Force Geophys. Lab.)
Spitzer Science Center. 2004, Spitzer Observers' Manual (Pasadena, CA: SSC), http://sirtf.caltech.edu/SSC/obs/

Preprints

Tobin, J. J., et al. 2015, arXiv: 1501.03172, AJ in press
Lockwood, G. W., & Skiff, B. A. 1988, Air Force Geophys. Lab. preprint (AFGL-TR-88-0221)

References to preprints are acceptable only for manuscripts not yet published. Please check the arXiv references in case any of these have been formally published since the manuscript was prepared; if the preprints have not been published, please give the arXiv reference number and the journal to which the work has been submitted or is currently in press.

Manuscripts Submitted or In Press

Wolk, S. J., & Walter, F. M. 1999, AJ, submitted
Wolk, S. J., & Walter, F. M. 1999, AJ, in press

"Submitted" should be used for manuscripts not yet accepted for publication, and "in press" for manuscripts accepted but not yet published.