Search form

Placing Data Set Tags in Your Paper

The AASTeX macro “\dataset” may be used anywhere in your AASTeX paper but tags in the acknowledgments and footnotes are discouraged. If your paper has just a few data sets, place the data set commands in the main text of the paper. The most logical place to include them would usually be in an early section describing the observations underlying the paper. When the number of data sets is large, you should place them in a table with a separate column reserved for the data set identifiers. Be sure to provide enough context in the text or table headers so that the data set identifiers are legible to readers of the print journal.

The \dataset Macro

The “\dataset” macro can be used with either one or two arguments. If a single argument is used, the data set ID should appear in curly braces, e.g.


where “ADS/FacilityId#PrivateId” is a unique data set ID consisting of a facility acronym and a facility’s archive identification code. The ID supplied will be verified against the ADS data set resolver during copy editing and will serve as the link anchor in the electronic edition. Please note that AASTeX interprets everything between the curly brackets of the “\dataset” macro as regular text. Thus, the special symbol, “#,” in the “ADS/FacilityId#PrivateId” identifier must be escaped by a back slash, “\”.

In cases where you would like to include text to appear in print that is different from the data set ID, use two arguments:


Again, “ADS/FacilityId#PrivateId” is the unique identification code, which will be checked during copy editing. The text inside the curly brackets will serve as the link in the text of the electronic edition. Here no forward slash on the “#”in the identifier is required.

Note that data hosted at sites not affiliated with the ADS database will not be linked. To join follow the instructions provided by ADS.

Alterations During Copy Editing

As more and more online-only features are added to the electronic editions of the journals, the AAS remains committed to ensuring that the print edition remains readable. In the case of data sets, in instances where the author does not make the location of the data set clear in the text, the University of Chicago Press copy editors will add a description, usually the facility’s acronym, so that it is clear to the print reader what data center hosts the data.

The following table gives examples of AASTeX data set markup and how it would appear in the print journal. In the first two examples, the location of the data set is not clear from the LaTeX text provided, so the name of the data center, “Spitzer,” has been added during copy editing. In the last example, the facility acronym, “HST,” was included in the original manuscript by the author, so no change is necessary.

AASTeX version Modified version
Observations (PID 104; \dataset{ADS/Sa.Spitzer\#0006578176}) were conducted on 2003 December 9. Observations (PID 104; Spitzer 0006578176) were conducted on 2003 December 9.
\dataset[ADS/Sa.Spitzer#0008986880]{SBS 0335-052} was observed using both IRS low resolution modules. SBS 0335-052 (Spitzer 0008986880) was observed using both IRS low-resolution modules.
The star was observed by HST \dataset{ADS/Sa.HST\#O5KZ02340}. The star was observed by HST O5KZ02340