AASTeX v7 Author Guide

https://journals.aas.org/aastexguide
Admin
Comprehensive guide for preparing manuscripts using the AASTeX v7 LaTeX classfile for American...
Tokens:18,898
Snippets:238
Trust Score:9.9
Update:5 months ago
Show doc for...
Tokens:
Raw
### Full Author and Affiliation Setup Example

Source: https://journals.aas.org/aastexguide

Demonstrates the comprehensive use of AASTeX v7 commands for setting up author details, affiliations, emails, and collaborations. This example covers multiple authors, affiliations, and collaboration groups.

```latex
\title{How superheroes use AASTeX v7 author, email, 
and affiliation style}

`\correspondingauthor{Superman}` 

\author{Superman}
\altaffiliation{aka Clark Kent}
\affiliation{Daily Planet}
\affiliation{Justice League, Metropolis}
\email[show]{clark.kent@dailyplanet.com}

\author{Batman}
\affiliation{Wayne Enterprises}
\affiliation{Justice League, Metropolis}
\email{CEO@wayne.com}

\author{Wonder Woman}
\affiliation{Themyscira}
\affiliation{Justice League, Metropolis}
\email{ww@gmail.com}

\collaboration{all}{(The DC superheros group)}

\author{Spider-Man} 
\affiliation{Daily Bugle}
\affiliation{The Avengers}
\email{Peter.parker@hotmail.com}

\author{Wolverine}
\affiliation{X-Men}
\email{madcanadian@xmen.com}

\author{Captain America}
\affiliation{The Avengers}
\email{firstavenger@starkindustries.com}

\collaboration{1}{(The Marvel superhero Team)}

\author{Lois Lane}
\affiliation{Daily Planet}
\email{lois.lane@dailyplanet.com}

\author{Jimmy Olsen}
\affiliation{Daily Planet}
\email{Jim.olsen@dailyplanet.com}

\nocollaboration{0}

\author{Lex Luthor}
\affiliation{LexCorp}
\email{lex@lex.com}

\author{Magneto}
\affiliation{Brotherhood of Mutants}
\affiliation{X-Men}
\email{magnetman@xmen.com}

\author{Mystique}
\affiliation{Brotherhood of Mutants}
\email{mystique@bom.com}

\collaboration{0}{and the Super Villians collaboration}
```

--------------------------------

### Example of Collaboration Display

Source: https://journals.aas.org/aastexguide

Illustrates how \author and \collaboration commands are processed to display a limited number of authors followed by a collaboration name. This example shows the output for a large author list.

```latex
\author{1}
...
\author{1000}
\collaboration{2}{The BIG collaboration}
```

--------------------------------

### Start Multi-Page Table

Source: https://journals.aas.org/aastexguide

Use `\startlongtable` before `\begin{deluxetable}` to enable multi-page tables. Omitting this will cause the table to flow off the page.

```latex
\startlongtable
\begin{deluxetable}
...
\end{deluxetable}
```

--------------------------------

### Begin Main Document Body

Source: https://journals.aas.org/aastexguide

The \begin{document} command marks the start of the main, typeset content of the manuscript. All preceding markup is part of the preamble and is not typeset.

```latex
\begin{document}
```

--------------------------------

### Author Examples with ORCID and Name Variants

Source: https://journals.aas.org/aastexguide

Illustrates various ways to use the \\author command with different combinations of ORCID, given name, surname, and suffix. Pay attention to name casing and the use of single quotes for string values.

```latex
\author[gname=Gerard,sname='de Vaucouleurs']{Gerard de Vaucouleurs}
```

```latex
\author[0000-0002-6937-9034,sname=Wang,gname=Xuesong]{Sharon X. Wang}
```

```latex
\author[0000-0001-7827-7825,sname='van der Marel',gnane=Roeland]{Roeland P. van der Marel}
```

```latex
\author[sname=Moutain,gname=Charles]{C. Matt Mountain}
```

```latex
\author[0000-0001-5448-1821,gname=Robert,sname=Kennicutt,suffix=Jr]{R.C. Kennicutt}
```

```latex
\author[0000-0002-2598-0514,gname='Andr\"es\u00a0A.',sname='Plazas\u00a0Malag\"on']{Andr\'es~A.~Plazas~Malag\'on}
```

--------------------------------

### Define the deluxetable environment in AASTeX

Source: https://journals.aas.org/aastexguide

Use the \begin{deluxetable}{_cols_} command to start a table, specifying column justifications. The table content is then defined between \startdata and \enddata.

```latex
\begin{deluxetable}{_cols_}
```

```latex
_preamble commands_
```

```latex
\startdata
```

```latex
_table data_
```

```latex
\enddata
```

```latex
\end{deluxetable}
```

--------------------------------

### Link to Zenodo Dataset with DOI

Source: https://journals.aas.org/aastexguide

Example of linking to a dataset hosted on Zenodo using its DOI and providing the full URL as display text. Ensures proper attribution and accessibility.

```latex
The data is available on Zenodo under an open-source 
Creative Commons Attribution license: 
\dataset[doi:10.5281/zenodo.3938720]{https://doi.org/10.5281/zenodo.3938720}.
```

--------------------------------

### Format References with the references Environment

Source: https://journals.aas.org/aastexguide

The references environment is used to format a reference list directly within the document body. Each entry starts with \reference, followed by the key and bibliographic data.

```latex
\begin{references}
\reference{_key_} _bibliographic data_
   .
   .
\end{references}
```

--------------------------------

### Figure Set Caption Example

Source: https://journals.aas.org/aastexguide

When using figure sets, indicate in the caption that additional images are available in the figure set, especially for the PDF version.

```text
The complete figure set (11 images) is available in the online journal.
```

--------------------------------

### Single Page deluxetable (Single Column)

Source: https://journals.aas.org/aastexguide

Use for single-page tables in a single-column manuscript. No special setup required beyond the basic environment.

```latex
\begin{deluxetable}
...
\end{deluxetable}
```

--------------------------------

### Standard LaTeX Bibliography Environment

Source: https://journals.aas.org/aastexguide

Use the `thebibliography` environment for managing references, marking citations with `\citep` or `\citet` and associating them with `\bibitem`. The argument to `\begin{thebibliography}` is a dummy for standard LaTeX compatibility.

```latex
   \begin{thebibliography}{_dummy_}
```

```latex
   \bibitem[_cite data_]{_key_} _bibliographic data_
```

```latex
   .
```

```latex
   .
```

```latex
  \end{thebibliography}
```

--------------------------------

### Figure Set Markup

Source: https://journals.aas.org/aastexguide

Use this markup to define a set of related figures. Each figure in the set requires its own group start, number, title, plot, and note.

```latex
\figsetstart
```

```latex
\figsetnum{_figurenumber_}
```

```latex
\figsettitle{_figure set title_}
```

```latex
\figsetgrpstart
```

```latex
\figsetgrpnum{_figurenumber.1_}
```

```latex
\figsetgrptitle{_short image 1 title_}
```

```latex
\figsetplot{_figure set file_}
```

```latex
\figsetgrpnote{_image 1 caption_}
```

```latex
\figsetgrpend
```

```latex
_Repeat the block above for each figure in the set_
```

```latex
\figsetend
```

--------------------------------

### Set Hyperlink Colors

Source: https://journals.aas.org/aastexguide

Use the \hypersetup command in the preamble to customize the colors of different types of hyperlinks (links, citations, files, URLs).

```latex
\hypersetup{linkcolor=red,citecolor=green,filecolor=cyan,urlcolor=magenta}
```

--------------------------------

### Enable Revision Tracking with trackchanges

Source: https://journals.aas.org/aastexguide

Use the \added command with the trackchanges style option to highlight revisions in bold. Removing the option hides these changes.

```latex
\documentclass[trackchanges]{aastex7}
```

--------------------------------

### Basic Table Environment

Source: https://journals.aas.org/aastexguide

Enclose tabular material, titles, and footnotes within the `table` environment. It requires a `\begin{table}` and `\end{table}` pair.

```latex
\begin{table}
...
\end{table}
```

--------------------------------

### Rotate Tables with `rotatetable`

Source: https://journals.aas.org/aastexguide

Use the `rotatetable` environment to rotate short tables. This environment should surround the `deluxetable` or `tabular` environment requiring rotation. The `\rotate` command is only recommended for splittables.

```latex
\begin{rotatetable}
\begin{deluxetable}
...
\end{deluxetable}
\end{rotatetable}
```

--------------------------------

### Define Bibliographic Entry with \bibitem

Source: https://journals.aas.org/aastexguide

Use the \bibitem command to define bibliographic entries. The square-bracketed argument contains the author and year, and the curly-braced argument is the citation key. Ensure parentheses are used for the year.

```latex
\bibitem[_author_(_year_)]{_key_}
     _bibliographic data_
```

--------------------------------

### AASTeX Software Citation

Source: https://journals.aas.org/aastexguide

Use a single \software command to list software packages and their versions or citations, separated by commas. This aids reproducibility and gives credit to community projects. It should appear after the acknowledgments section.

```latex
\software{CASA (CASA Team et al. 2022), 
XSPEC (Arnaud 1996),
astropy (The Astropy Collaboration 2013, 2018, 2022), 
... }
```

--------------------------------

### Link to External Dataset with Text

Source: https://journals.aas.org/aastexguide

Use this command to link to an external dataset, providing custom display text for the hyperlink. The URL is required.

```latex
\dataset[_text_]{_url_}
```

--------------------------------

### Link to Dataset using DOI and Text

Source: https://journals.aas.org/aastexguide

Combines linking to a dataset with a DOI and providing custom display text. The \doi command automatically prepends 'https://doi.org/' to the argument.

```latex
The data is available at MAST: \dataset[doi: 10.17909/T9XG63]{\doi{10.17909/T9XG63}.
```

--------------------------------

### Link Celestial Objects with `object` Macro

Source: https://journals.aas.org/aastexguide

Use the `object` macro to link celestial objects to CDS/Simbad or NED. The text in the argument serves as the link anchor. An optional argument can supply a known name for CDS resolution.

```latex
\object{_text_}
```

```latex
\object[SDSS J000004.21+000122.4]{J0000+0001}
```

--------------------------------

### Create Case Fractions

Source: https://journals.aas.org/aastexguide

Use \case instead of \frac for case fractions in displayed equations when a non-built-up format is desired. Standard \frac is generally sufficient.

```latex
\case{1}{2}
```

```latex
\case12
```

--------------------------------

### Animation Environment Markup

Source: https://journals.aas.org/aastexguide

Embed animations using the 'interactive' environment. Provide a static image and specify the video file for HTML display. The 'interactive' environment adds a visual indicator for animations.

```latex
\begin{figure}
\begin{interactive}{animation}{video file name}
figure call (e.g.\plotone, \includegraphics, etc.)
\end{interactive}
\caption{Descriptive caption of example figure and what the animation shows.}
\end{figure}
```

--------------------------------

### Include Interactive Figures with `interactive` Environment

Source: https://journals.aas.org/aastexguide

Use the `interactive` environment to embed dynamic figures. It requires the figure type and a package containing interactive elements. A static figure call should be included for LaTeX/PDF versions.

```latex
\begin{figure}
\begin{interactive}{type}{file}
figure call (e.g.\plotone, \includegraphics, etc.)
\end{interactive}
\caption{Description of the example figure and the interactive portion which includes how to use the interactive functionality.}
\end{figure}
```

--------------------------------

### Fetching BibTeX using cURL

Source: https://journals.aas.org/aastexguide

This command-line snippet demonstrates how to retrieve the BibTeX entry for a given DOI using `curl`. This is a quick method to obtain citation information for DOIs.

```bash
curl -LH "Accept: application/x-bibtex" https://doi.org/10.5281/zenodo.15991
```

--------------------------------

### Display Numbered Equation in LaTeX

Source: https://journals.aas.org/aastexguide

Use the `equation` environment to display a single formula that is automatically numbered by LaTeX. This is useful for standard equations.

```latex
\begin{equation}
...
\end{equation}
```

--------------------------------

### Display Unnumbered Equation in LaTeX

Source: https://journals.aas.org/aastexguide

Use the `displaymath` environment for single, unnumbered formulas. This is a basic LaTeX environment for math display.

```latex
\begin{displaymath}
...
\end{displaymath}
```

--------------------------------

### BibTeX Entry for Data/Software Repositories

Source: https://journals.aas.org/aastexguide

Use the `@misc` BibTeX type for citing data or software from persistent repositories. Ensure all required fields like author, title, year, DOI, publisher, and version are included.

```bibtex
@misc{lia_corrales_2015_15991,
author       = {Lia Corrales},
title        = {{dust: Calculate the intensity of dust scattering halos in the X-ray}},
month        = mar,
year         = 2015,
doi          = {10.5281/zenodo.15991},
version      = {1.0},
publisher    = {Zenodo},
url          = {https://doi.org/10.5281/zenodo.15991}
}
```

--------------------------------

### Configure lineno Package for Subequations

Source: https://journals.aas.org/aastexguide

When using the lineno package with subequations, bracket them with the linenomath environment to prevent typesetting issues. Ensure the lineno package is called with the 'running' option.

```tex
\usepackage[running]{lineno}
\linenumbers
```

```tex
\begin{linenomath}
\begin{subequations}
...
\end{subequations}
\end{linenomath}
```

--------------------------------

### Switch Between Column Formats with \onecolumngrid and \twocolumngrid

Source: https://journals.aas.org/aastexguide

Force a switch between single and double column layouts within a document using \onecolumngrid and \twocolumngrid commands. This is particularly useful in two-column formats.

```tex
\documentclass[twocolumn]{aastex63}
\begin{document}
The following text will be in two column format per the "twocolumn" style call.
...
\onecolumngrid 
Now LaTeX will render the following text in single column format.
...
\twocolumngrid
Now back to the original two column format.
...
\end{document}
```

--------------------------------

### Tabular Environment

Source: https://journals.aas.org/aastexguide

Define the table's columns and content within the `tabular` environment. Specify column alignment (l, c, r) in the argument.

```latex
\begin{tabular}{_cols_}
...
\end{tabular}
```

--------------------------------

### Deluxetable Phantom Commands

Source: https://journals.aas.org/aastexguide

Use phantom commands like `\phn`, `\phd`, `\phs`, and `\phm{_string_}` to control column alignment and spacing within `deluxetable` data cells.

```latex
\phn | phantom numeral 0-9
\phd | phantom decimal point
\phs | phantom ? sign
\phm{_string_} | generic phantom
```

--------------------------------

### Add Additional Author Information

Source: https://journals.aas.org/aastexguide

Use \\altaffiliation for additional author notes like 'Hubble Fellow' or 'author is deceased'. This command must immediately follow the \\author command and uses non-numeric symbols.

```latex
\altaffiliation{Arecibo Observatory, \\HC3 Box 53995, \\Arecibo, PR 00612}
```

--------------------------------

### Align Columns by Decimal in AASTeX deluxetable

Source: https://journals.aas.org/aastexguide

For \begin{deluxetable*}, use 'D' in the \cols identifier and include the \decimals command before \startdata. Headers can use \multicolumn2c. The 'D' identifier can also include text like '+/-' to appear between the split columns.

```latex
\begin{deluxetable*}{cD@{+/-}D}
\tablehead{
\colhead{Letter} & \multicolumn2c{Value} & \multicolumn2c{Error} \\
}
\decimals
\startdata
A & 1234     & 100.0     \\
B &  123.4   &  10.1     \\
C &  12.34   &   1.01    \\
D &   1.234  &   0.101   \\
E &    .1234 &   0.01001 \\
\enddata
\end{deluxetable*}
```

--------------------------------

### Specify Author with ORCID and Name Details

Source: https://journals.aas.org/aastexguide

Use this syntax to include an author's ORCID, given name, surname, and suffix. The ORCID will hyperlink to the author's profile if valid. Ensure the ORCID is personally authenticated.

```latex
\author[dddd-dddd-dddd-dddd,gname='X',sname='Y',suffix='Z']{_Author Name_}
```

--------------------------------

### Set Table Font Size

Source: https://journals.aas.org/aastexguide

Use `\tabletypesize{_font size command_}` within the `deluxetable` environment to change the font size of the table content. Accepted commands include `\small`, `\footnotesize`, and `\scriptsize`.

```latex
\tabletypesize{_font size command_}
```

--------------------------------

### AASTeX Appendix Command

Source: https://journals.aas.org/aastexguide

Use the \appendix command to mark the transition from the main body to appendices. This command handles section numbering (A, B, C, etc.) and resets equation counters. Appendix sections are headed with \section.

```latex
\section{_body section_}

\appendix

\section{_appendix section_}
```

--------------------------------

### Define Custom Command for Abbreviation

Source: https://journals.aas.org/aastexguide

Use LaTeX's \newcommand to define custom abbreviations or shorthands. These definitions should be placed in the document preamble. Avoid commands that reposition text.

```latex
\newcommand{\grb}{gamma ray burst}
```

--------------------------------

### Set Table Caption

Source: https://journals.aas.org/aastexguide

Specify the table's title using `\tablecaption{_text_\label{_key_}}`. For cross-referencing, include a `\label` within this command. Explanatory notes should be in end notes.

```latex
\tablecaption{_text_\label{_key_}}
```

--------------------------------

### Add Editorial Information Commands

Source: https://journals.aas.org/aastexguide

Timestamp important dates during the peer review process. These are optional and useful for arXiv submissions, as publishers handle this information during production.

```latex
\received{_receipt date_}
```

```latex
\revised{_revision date_}
```

```latex
\accepted{_acceptance date_}
```

```latex
\published{_published date_}
```

```latex
\submitjournal{_AASJournal name_}
```

--------------------------------

### Add Comments to Machine-Readable Table Sample

Source: https://journals.aas.org/aastexguide

Use `\tablecomments` to provide a note for the sample version of a machine-readable table, indicating that the full data is available electronically. This command is used within the LaTeX submission.

```latex
\tablecomments{Table 1 is published in its entirety in the machine-readable format.
      A portion is shown here for guidance regarding its form and content.}
```

--------------------------------

### Add Keywords/Subject Headings in AASTeX

Source: https://journals.aas.org/aastexguide

The `keywords` command is for legacy subject headings. For new AAS manuscripts, Unified Astronomy Thesaurus (UAT) concepts are preferred and prompted during submission. Authors should supply no more than six keywords in alphabetical order.

```latex
\keywords{_text_}
```

```latex
\keywords{\uat{Stellar evolution}{1599} --- \uat{Type II supernovae}{1731} --- \uat{Red supergiant stars}{1375}}
```

--------------------------------

### Create Descriptive Table in LaTeX

Source: https://journals.aas.org/aastexguide

Use this LaTeX code to define a descriptive table when a standard table is too wide. It specifies column headers and provides metadata for each column.

```latex
\begin{deluxetable}{cccc}
\tablecaption{A very wide table!}
\tablehead{
   \colhead{Row number} & \colhead{Units} & \colhead{Label} & \colhead{Description}
}
\startdata
1 & \nodata & ID & Source identifier \\
2 & deg & RAdeg & Right Ascension in decimal degrees (J2000) \\
3 & deg & DEdeg & Declination in decimal degrees (J2000) \\
...
100 & \nodata & Note & Additional notes \\
\enddata
\tablecomments{Table X is published in its entirety in the electronic 
edition of the {\it Astrophysical Journal}.  A portion is shown here 
for guidance regarding its form and content.}

\end{deluxetable}
```

--------------------------------

### Single Page splitdeluxetable (Single Column)

Source: https://journals.aas.org/aastexguide

Use the `splitdeluxetable` environment for single-page tables in a single-column manuscript.

```latex
\begin{splitdeluxetable}
...
\end{splitdeluxetable}
```

--------------------------------

### Generate Revised Manuscript with latexdiff

Source: https://journals.aas.org/aastexguide

Use this command to compare two LaTeX files and produce a new file with added text highlighted in bold. This is useful for tracking changes for editors and reviewers.

```bash
latexdiff -t BOLD old.tex new.tex > diff.tex
```

--------------------------------

### Align Columns by Decimal in LaTeX

Source: https://journals.aas.org/aastexguide

Use the 'D' column identifier in the \begin{tabular} environment and the \decimals command to align columns by their decimal points. Ensure headers span two columns using \multicolumn2c or an extra '&'.

```latex
\begin{tabular}{rDD}
\hline
 & & & \multicolumn2c{More} \\
Column & \multicolumn2c{Decimals} & \multicolumn2c{Decimals}\\
\hline
\hline
\decimals
One   & 567.0 & 21345 \\
Two   & 2.0   & 62.5  \\
Three & 45    & 534.3499 \\
Four  & 21.12 & .  \\
\hline
\end{tabular}
```

--------------------------------

### Multi-Page deluxetable (Double Column)

Source: https://journals.aas.org/aastexguide

Use for tables spanning multiple pages in a double-column manuscript. Combines `\startlongtable` with the starred `deluxetable` environment.

```latex
\startlongtable
\begin{deluxetable*}
...
\end{deluxetable*}
```

--------------------------------

### AASTeX Acknowledgments Environment

Source: https://journals.aas.org/aastexguide

Use the \begin{acknowledgments} environment for the acknowledgments section. This section is anonymized for review when the 'anonymous' style is used. Text within this environment does not count towards the total word count.

```latex
\begin{acknowledgments}

_One or more paragraphs of text._

\end{acknowledgments}
```

--------------------------------

### Display Aligned Equations in LaTeX

Source: https://journals.aas.org/aastexguide

Use the `eqnarray` environment to set multiple formulas requiring vertical alignment or to display long equations across multiple lines. Each line is numbered by default.

```latex
\begin{eqnarray}
...
\end{eqnarray}
```

--------------------------------

### Set Table Width

Source: https://journals.aas.org/aastexguide

The `\tablewidth{_dimen_}` command defines the width of a `deluxetable`. Omitting it defaults to the page width. Setting it to `0pt` uses the table's natural width.

```latex
\tablewidth{_dimen_}
```

--------------------------------

### Journal Abbreviation Commands in AASTeX

Source: https://journals.aas.org/aastexguide

Use these commands to insert standard abbreviations for astronomical journals. Refer to the full list for available options.

```latex
\aj
```

```latex
\araa
```

```latex
\apj
```

```latex
\apjl
```

```latex
\apjs
```

```latex
\ao
```

```latex
\apss
```

```latex
\aap
```

```latex
\aapr
```

```latex
\aaps
```

```latex
\azh
```

```latex
\baas
```

```latex
\icarus
```

```latex
\jrasc
```

```latex
\jaavso
```

```latex
\memras
```

```latex
\mnras
```

```latex
\pra
```

```latex
\prb
```

```latex
\prc
```

```latex
\prd
```

```latex
\pre
```

```latex
\prl
```

```latex
\psj
```

```latex
\pasp
```

```latex
\pasj
```

```latex
\qjras
```

```latex
\skytel
```

```latex
\solphys
```

```latex
\sovast
```

```latex
\ssr
```

```latex
\zap
```

```latex
\nat
```

```latex
\iaucirc
```

```latex
\aplett
```

```latex
\apspr
```

```latex
\bain
```

```latex
\fcp
```

```latex
\gca
```

```latex
\grl
```

```latex
\jcp
```

```latex
\jgr
```

```latex
\jqsrt
```

```latex
\memsai
```

```latex
\nphysa
```

```latex
\physrep
```

```latex
\physscr
```

```latex
\planss
```

```latex
\procspie
```

```latex
\actaa
```

```latex
\caa
```

```latex
\cjaa
```

```latex
\jcap
```

```latex
\na
```

```latex
\nar
```

```latex
\pasa
```

```latex
\rmxaa
```

```latex
\maps
```

```latex
\aas
```

```latex
\dps
```

--------------------------------

### Generate Citations with \citep and \citet

Source: https://journals.aas.org/aastexguide

Use \citep for parenthetical citations (e.g., "(Author Year)") and \citet for inline citations where the author is part of the text (e.g., "Author (Year)"). Multiple keys can be separated by commas.

```latex
\citep{_key(s)_} \citet{_key(s)_}
```

--------------------------------

### Define Table Headings

Source: https://journals.aas.org/aastexguide

Use `\tablehead{_text_}` to define column headings. Each heading should be enclosed in `\colhead` to ensure it is centered over its column. The number of `\colhead` commands must match the number of data columns.

```latex
\tablehead{

```

--------------------------------

### Enable Two-Column Layout with twocolumn

Source: https://journals.aas.org/aastexguide

The twocolumn style option creates a tightly typeset double-column format. Be mindful of shorter line lengths and adjust tables/figures accordingly.

```latex
\documentclass[twocolumn]{aastex7}
```

--------------------------------

### Single Page tabular (Double Column)

Source: https://journals.aas.org/aastexguide

Use the starred `table` environment for single-page tables spanning both columns in a double-column manuscript.

```latex
\begin{table*}
...
\end{table*}
```

--------------------------------

### AASTeX Author Contributions Environment

Source: https://journals.aas.org/aastexguide

Use the \begin{contribution} environment for optional author contributions. This section appears between acknowledgments and the bibliography and is anonymized for review when the 'anonymous' style is used. Text within this environment does not count towards the total word count.

```latex
\begin{contribution}

_All author contributed equally

or 

Author X obtained the data and processed it. X also wrote and edited the manuscript.
Author Y provided the theoretical models and edited the manuscript.
Author Z edited the manuscript.
_

\end{contribution}
```

--------------------------------

### Create a custom grid figure in AASTeX

Source: https://journals.aas.org/aastexguide

Arrange multiple figure files in a grid pattern using \gridline. Each \gridline can contain multiple \fig, \rightfig, or \leftfig commands to build complex layouts like inverted pyramids.

```latex
\begin{figure}
\gridline{\fig{fig1a.pdf}{0.3\textwidth}{(a)}
          \fig{fig1b.pdf}{0.3\textwidth}{(b)}
          \fig{fig1c.pdf}{0.3\textwidth}{(c)}}
\gridline{\fig{fig1d.pdf}{0.3\textwidth}{(d)}
          \fig{fig1e.pdf}{0.3\textwidth}{(e)}}
\gridline{\fig{fig1f.pdf}{0.3\textwidth}{(f)}}
\caption{A nice inverted pyramid figure 
consisting of six individual files}
\end{figure}
```

--------------------------------

### Define Custom Command for Symbol

Source: https://journals.aas.org/aastexguide

Define custom commands for symbols, ensuring they do not conflict with existing AASTeX commands. Consult symbol tables before defining new ones.

```latex
\newcommand{\bHa}{Broad line H{\alpha}}
```

--------------------------------

### Span Columns with widetext Environment

Source: https://journals.aas.org/aastexguide

Employ the widetext environment to make content span both columns in a two-column document format. This is useful for equations or long URLs.

```tex
\begin{widetext}
...
\end{widetext}
```

--------------------------------

### Set Number of Columns

Source: https://journals.aas.org/aastexguide

Explicitly set the number of columns in a `deluxetable` using `\tablecolumns{_num_}`.

```latex
\tablecolumns{_num_}
```

--------------------------------

### Mark Table with Digital Asset

Source: https://journals.aas.org/aastexguide

The `\digitalasset` command, introduced in AASTeX v7, adds a blue border around a table caption. This serves as a visual indicator for peer review and arXiv submissions that the table has an associated digital asset, such as a machine-readable version. This border is not present in the final published article.

```latex
\digitalasset
```

--------------------------------

### Single Page splitdeluxetable (Double Column)

Source: https://journals.aas.org/aastexguide

Use the starred `splitdeluxetable*` environment for single-page tables spanning both columns in a double-column manuscript.

```latex
\begin{splitdeluxetable*}
...
\end{splitdeluxetable*}
```

--------------------------------

### Center Wide Tables

Source: https://journals.aas.org/aastexguide

For wide, portrait tables that do not center properly, use `\centerwidetable` at the top of the `deluxetable` environment. If further adjustment is needed, `\movetableright=X` can be used to manually shift the table left or right.

```latex
\movetableright=-1in
```

--------------------------------

### Set Document Class in AASTeX

Source: https://journals.aas.org/aastexguide

Specify the document class as 'aastex' with default settings. This command must be the first markup in the manuscript.

```latex
\documentclass{aastex7}
```

--------------------------------

### AASTeX Facility Listing

Source: https://journals.aas.org/aastexguide

List telescope facilities using \facility for a single facility or \facilities for multiple. Facility IDs can include instrument names in parentheses. This section should appear after acknowledgments.

```latex
\facility{_facility ID_}
```

```latex
\facilities{_facility ID_, _facility ID_, _facility ID_, ... }
```

--------------------------------

### Set Short Authors for Running Heads

Source: https://journals.aas.org/aastexguide

Use \shortauthors to provide a shortened author list for running heads on even-numbered pages. Limit to three authors or use 'et al.'.

```latex
\shortauthors{_text_}
```

--------------------------------

### Include Author Email

Source: https://journals.aas.org/aastexguide

A mandatory command in AASTeX v7 for each author. It can be placed before or after the \\affiliation command. The compilation will fail if any author lacks an \\email command.

```latex
\email{aastex-help@aas.org}
```

--------------------------------

### Rotated splitdeluxetable (Single Column)

Source: https://journals.aas.org/aastexguide

Use for landscape-rotated tables in a single-column manuscript. Includes the `\rotate` command within the `splitdeluxetable` environment.

```latex
\begin{splitdeluxetable}
\rotate
...
\end{splitdeluxetable}
```

--------------------------------

### Single Page deluxetable (Double Column)

Source: https://journals.aas.org/aastexguide

Use for single-page tables that span both columns in a double-column manuscript. Requires the starred version of the environment.

```latex
\begin{deluxetable*}
...
\end{deluxetable*}
```

--------------------------------

### Add Report Number

Source: https://journals.aas.org/aastexguide

Use the \reportnum command to indicate additional manuscript information, such as preprint identifiers. This command can be used multiple times.

```latex
\reportnum{astro-ph/0411275}
```

```latex
\reportnum{BAAS 2004, v36, n5}
```

--------------------------------

### Single Page splittabular

Source: https://journals.aas.org/aastexguide

Use the `splittabular` environment for single-page tables in a single-column manuscript that may require splitting.

```latex
\begin{splittabular}
...
\end{splittabular}
```

--------------------------------

### Complex Column Headings with Multicolumn

Source: https://journals.aas.org/aastexguide

Use the `multicolumn` command for table heads that span multiple columns. Ensure the command is valid within a LATEX `tabular` environment.

```latex
\multicolumn{5}{c}{_text_}
```

--------------------------------

### Add Caption and Label to Figure in AASTeX

Source: https://journals.aas.org/aastexguide

Use the \texttt{\\caption} command within the \texttt{figure} environment to provide a caption. An optional \texttt{\\label} can be added for cross-referencing. \texttt{\\figcaption} offers similar functionality with an optional filename argument.

```latex
\caption{_text_\label{_key_}}
```

```latex
\figcaption[_filename_]{_text_\label{_key_}}
```

--------------------------------

### Add Watermark to Title Page

Source: https://journals.aas.org/aastexguide

Superimpose optional text as a watermark on the title page. The font size can also be specified.

```latex
\watermark{_text_}
```

```latex
\setwatermarkfontsize{_dimension_}
```

--------------------------------

### Include EPS/PDF Graphics in AASTeX Figure Environment

Source: https://journals.aas.org/aastexguide

Use this structure within the \texttt{figure} environment to embed graphics. Ensure graphics files are in EPS or PDF format. The \texttt{\\figurenum} command can be used to manually set the figure identifier.

```latex
\begin{figure}
\figurenum{_text_}
\epsscale{_num_}
\plotone{_file_}
\plottwo{_file1_}{_file2_}
\caption{_text_}
\end{8figure}
```

--------------------------------

### Deluxetable Special Heads

Source: https://journals.aas.org/aastexguide

Use `\cutinhead{_text_}` for centered, rule-separated text across the table width, or `\sidehead{_text_}` for left-justified text spanning the table width.

```latex
\cutinhead{_text_}
```

```latex
\sidehead{_text_}
```

--------------------------------

### Rotated Multi-Page deluxetable (Single Column)

Source: https://journals.aas.org/aastexguide

Use for multi-page tables requiring landscape rotation in a single-column manuscript. Combines `\startlongtable` with `\begin{rotatetable}`.

```latex
\begin{longrotatetable}
\begin{deluxetable}
...
\end{deluxetable}
\end{longrotatetable}
```

--------------------------------

### Rotated splitdeluxetable (Double Column)

Source: https://journals.aas.org/aastexguide

Use for landscape-rotated tables spanning both columns in a double-column manuscript. Includes `\rotate` within the starred `splitdeluxetable*` environment.

```latex
\begin{splitdeluxetable*}
\rotate
...
\end{splitdeluxetable*}
```

--------------------------------

### Span Both Columns

Source: https://journals.aas.org/aastexguide

Use the asterisk (*) option with `deluxetable` or `table` environments to make the table span both columns in a two-column layout. This option can also be applied to `rotatetable` to center the rotated table.

```latex
\begin{deluxetable*}
...
\end{deluxetable*}
```

```latex
\begin{table*}
...
\end{table*}
```

--------------------------------

### Group Related Equations with Sub-numbering

Source: https://journals.aas.org/aastexguide

Use the `subequations` environment from the `amsmath` package to group related equations, numbering them with a letter appended to the main equation number. This requires \usepackage{amsmath} in the preamble.

```latex
\begin{subequations}
...
\end{subequations}
```

--------------------------------

### Add Table References and Comments with AASTeX

Source: https://journals.aas.org/aastexguide

Associate references or explanatory notes with a table using \tablerefs and \tablecomments. These commands must appear after \end{tabular} or \enddata and before \end{table} or \end{deluxetable}.

```latex
\tablerefs{_reference list_}
```

```latex
\tablecomments{_text_}
```

--------------------------------

### Automatic Math Mode in AASTeX deluxetable Columns

Source: https://journals.aas.org/aastexguide

In \begin{deluxetable}, use capital letters in the column identifier for automatic math mode. Use \dcolhead for headers to enable math mode without '$'. Embedded '$' in data cells do not affect columns set in math mode.

```latex
\begin{deluxetable}{ClR}
```

```latex
\tablhead{
```

```latex
\colhead{Math} & \dcolhead{\beta} & \colhead{3} \\
```

```latex
}
```

```latex
\stardata
```

```latex
\frac{a}{b} & 1000 & $\sim a^{\prime}$ \\
```

```latex
\enddata
```

```latex
\end{deluxetable}
```

--------------------------------

### Table Caption

Source: https://journals.aas.org/aastexguide

Add a title or caption to a table using the `\caption` command, which also automatically generates table numbering. A `\label` can be included for cross-referencing.

```latex
\caption{_text_\label{_key_}}
```

--------------------------------

### Table Positioning Tweaks

Source: https://journals.aas.org/aastexguide

Use `\movetableright` and `\movetabledown` to adjust the positioning of portrait and landscape tables, respectively. Accepts standard LaTeX units and negative values for opposite movement.

```latex
% For wide tables, \movetableright and \movetabledown can be used to tweak the positions of portrait and landscape tables, respectively.
% Both commands will accept any recognized LaTeX units, e.g. pix, inch, etc., and negative values move the table in the opposite direction.
```

--------------------------------

### Specify Ionic Species

Source: https://journals.aas.org/aastexguide

Use this command to indicate the ionization level of an atomic species. The ionization state is given as a numeral in the second argument.

```latex
\ion{_element_}{_level_}
```

--------------------------------

### Define Collaboration with Author Count

Source: https://journals.aas.org/aastexguide

Use \collaboration{number}{name} to specify a collaboration group, indicating how many authors to display before the collaboration name. This is useful for managing long author lists in the front matter.

```latex
\collaboration{number}{name}
```

--------------------------------

### Apply Multiple AASTeX Style Options

Source: https://journals.aas.org/aastexguide

Combine multiple style options like twocolumn, linenumbers, longauthor, and trackchanges to customize document layout, review features, and author information display.

```latex
\documentclass[twocolumn,linenumbers,longauthor,trackchanges]{aastex7}
```

--------------------------------

### Automatic Math Mode in LaTeX Table Columns

Source: https://journals.aas.org/aastexguide

Use capital letters (C, L, R) in the \begin{tabular} column identifier to automatically set that column in math mode, eliminating the need for '$' delimiters.

```latex
\begin{tabular}{cCR}
```

```latex
\hline
```

```latex
one&two&\alpha\\
```

```latex
\hline
```

```latex
\hline
```

```latex
a & \sum^{n=0}_{0 \to 1} & 5\pm1\\
```

```latex
\hline
```

```latex
\end{tabular}
```

--------------------------------

### Suppress Affiliations

Source: https://journals.aas.org/aastexguide

This command hides all affiliation information and must be placed before the first \\author command in the manuscript.

```latex
\suppressAffiliations
```

--------------------------------

### Specify Chemical Bonds

Source: https://journals.aas.org/aastexguide

Macros for representing single, double, and triple chemical bonds in LaTeX.

```latex
\sbond
```

```latex
\dbond
```

```latex
\tbond
```

--------------------------------

### Control Figure Placement in AASTeX

Source: https://journals.aas.org/aastexguide

Use positional placement options within the `figure` environment to override LaTeX's default placement logic. Options include 'h' (here), 'b' (bottom), 't' (top), and '!' (force). Similar options apply to tables.

```latex
\begin{figure}[_htb!_]
```

--------------------------------

### Avoid Problematic LaTeX Commands

Source: https://journals.aas.org/aastexguide

These LaTeX commands are discouraged in author-defined commands as they can cause issues during data conversion and publication.

```latex
hskip, \vskip, \raise, \raisebox, \lower, \rlap, \kern, \lineskip, \char, \mathchar, 
\mathcode, \buildref, \mathrel, \baselineskip
```

--------------------------------

### Split LaTeX Table Horizontally

Source: https://journals.aas.org/aastexguide

Use \begin{splittabular} with a 'B' column identifier to split a table horizontally. The 'B' indicates where the split should occur, creating continuing subtables.

```latex
\begin{splittabular}{cccBccc}
\hline
one & two & three &four & five & six \\
$\alpha$ & $\beta$ & $\gamma$ & $\delta$ & $\epsilon$ & $\zeta$ \\
\end{splittabular}
```

--------------------------------

### Directly Use graphicx \includegraphics in AASTeX

Source: https://journals.aas.org/aastexguide

For more advanced control, such as rotating images, invoke the \texttt{graphicx \\includegraphics} command directly. Consult the \texttt{graphicx} documentation for further options.

```latex
\includegraphics[angle=90]{_epsfile_}
```

--------------------------------

### Deluxetable Data Rows

Source: https://journals.aas.org/aastexguide

Define data rows within the `deluxetable` environment using `\startdata` and `\enddata` delimiters. Each row ends with `\\` and cells are separated by `&`.

```latex
\startdata
_data line_
_cell_&_cell_&_cell_ \\
_more data lines_
\enddata
```

--------------------------------

### Automatic Column Numbering with Decimal Alignment

Source: https://journals.aas.org/aastexguide

When using decimal alignment (the 'D' column identifier), use \decimalcolnumbers instead of \colnumbers. This command must also be used in conjunction with \decimals.

```latex
\decimalcolnumbers
```

--------------------------------

### Add Table End Notes with AASTeX

Source: https://journals.aas.org/aastexguide

Use \tablenotemark and \tablenotetext to add footnotes within tables. Ensure the key letter in \tablenotemark matches the alpha key in \tablenotetext.

```latex
\tablenotemark{_key letter(s)_}
```

```latex
\tablenotetext{_alpha key_}{_text_}
```

--------------------------------

### Rotated Multi-Page deluxetable (Double Column)

Source: https://journals.aas.org/aastexguide

Use for multi-page, landscape-rotated tables spanning both columns in a double-column manuscript. Uses `\begin{longrotatetable}` with starred environments.

```latex
\begin{longrotatetable}
\begin{deluxetable*}
...
\end{deluxetable*}
\end{longrotatetable}
```

--------------------------------

### Set Short Title for Running Heads

Source: https://journals.aas.org/aastexguide

Use \shorttitle to provide an abbreviated manuscript title for running heads on odd-numbered pages. Limit to 40-45 characters.

```latex
\shorttitle{_text_}
```

--------------------------------

### Custom Equation Numbering with \eqnum

Source: https://journals.aas.org/aastexguide

Override LaTeX's automatic numbering within `equation` or `eqnarray` environments by using the `\eqnum{_text_}` command. The provided text becomes the equation identifier. This command must be used inside the math environment.

```latex
\eqnum{_text_}
```
Tokens:
Raw