The Astrophysics Data System Logo astrophysics data system

Export Results

Export Formats

Use this button to export your search results in different formats. Currently available options are:

1. Tagged Formats:
  • BibTeX
  • BibTeX ABS
  • ADS (generic tagged abstracts)
  • EndNote
  • ProCite
  • RIS (Refman)
  • RefWorks
  • MEDLARS
2. LaTeX Formats:
  • AASTeX
  • Icarus
  • MNRAS
  • Solar Physics (SoPh)
3. XML Formats:
  • DC (Dublin Core) XML
  • REF-XML
  • REFABS-XML
  • VOTables
  • RSS
  • JATS XML

The BibTeX Format Configuration

For the two BibTeX formats there are two optional parameters maxauthor and keyformat which can be specified in user preferences.

maxauthor is maxinum number of authors displayed if number of authors exceed 200. The default values for maxauthor for BibTeX and BibTeX ABS are respectively 10 and 0, where 0 means display all authors.

keyformat is mnemonic key for identifying a BibTeX entry where default is the bibcode. Key can be specified to contain the first author’s last name, or some combination of publication year, journal, or additional authors. The key generation algorithm can be specified as a custom format. For example, the default BibTeX export for 2019AAS...23338108A is:

@INPROCEEDINGS{2019AAS...23338108A,
       author = {{Accomazzi}, Alberto and {Kurtz}, Michael J. and {Henneken}, Edwin and
...
}

which can instead be defined to be one of the following:

Accomazzi:2019              -- %1H:%Y
Accomazzi:2019:AAS          -- %1H:%Y:%q
Accomazzi2019               -- %1H%Y
Accomazzi2019AAS            -- %1H%Y%q
AccomazziKurtz2019          -- %2H%Y

Note there is also %zm specifier that is used for enumeration. This format outputs a sequence of characters to the end of keyformat when it is not unique among selected records. For example having keyformat of %1H%Y%zm produces:

Accomazzi2019a
Accomazzi2019b
Kurtz2019

The ADS Custom Format

The custom format feature allows you to output ADS data in a completely user-defined format. For example, the following format

%l (%Y), %j, %V, %p.\n

produces a reference of the form:

Vinodkumar, Dharssi, I., Bally, J., Steinle, P., McJannet, D., & Walker, J. (2017), Water Resources Research, 53, 633.

where specifiers l, Y, j, V, and p are, respectively, indicators of author list, year, journal name, volume, and page numbers, and \n is a new line indicator.

The custom format also allows you, for instance, to adapt your reference format to the requirements of a specific journal, or to build other types of output like HTML formatted references. For example, the format for Icarus is:

%ZEncoding:latex\\bibitem[%2M(%Y)]{%R} %10I\ %Y.\ %T.\ %j %V, %p-%P.\n

which produces a reference of the form:

\\bibitem[Vinodkumar, et al.(2017)]{2017WRR....53..633V} Vinodkumar, Dharssi, I., Bally, J., Steinle, P., McJannet, D. and Walker, J.\\ 2017.\\ Comparison of\nsoil wetness from multiple models over Australia with observations.\\ Water\nResources Research 53, 633-646.

As can be seen from the above examples, the format is specified as a string using a syntax similar to the one used by the C-programming printf statement. The format string is composed of zero or more directives: ordinary characters (not %), which are copied unchanged to the output; and conversion specifications, for any of the fields found in the bibliographic record to be formatted (e.g. authors, title).

Furthermore, using custom format, you can format your output as a csv file. For example, the following format

%ZEncoding:csv %ZHeader:'Author,Year,Title,Journal' %G,%Y,%T,%J

would create the four specified columns, listing your results under the column heading. Note that if no column heading is specified in your custom format, the export adds the headings based on your field selections.

For author field l (please see table below for all author formats) there are optional parameters: n.m. If the number of authors in the list is larger than n, the list will be truncated and returned as “author1, author2, …, authorm, et al.”. If .m is not specified, n.1 is assumed. The format is as follows:

%[n.m]l .

Examples

The default format is the AASTeX format:

%ZEncoding:latex%ZLinelength:0\bibitem[%4m(%Y)]{%R} %5.3l\ %Y, %j, %V, %p.\n

which produces a reference of the form:

\bibitem[Rester, et al.(1989)]{1989ApJ...342L..71R} Rester, A.~C., Coldwell, R.~L. \& Dunnam, F.~E., et al.\ 1989, \\apj, 342, L71.

The format for Icarus is:

%ZEncoding:latex\\bibitem[%2M(%Y)]{%R} %10I\ %Y.\ %T.\ %j %V, %p-%P.\n

The format for MNRAS is:

%ZEncoding:latex\\bibitem[\\protect\\citename{%1h}{%Y}]{%R} %8.3g,%Y,%q, %V,%p\n

A format to create list of records with hyperlinked title is:

%ZEncoding:html<P>%a %Y, %J <A href="%u">%T</A>\n

A format to create a list of records with hyperlinked bibcode, authors, title, journal, volume, page, year for use in latex:

%ZEncoding:latex\\item \href{%u}{%R} %A: \textit{%T,} %j,%V,%p (%Y)

The same format as above but encoded for use as a rich text document (rtf) which can be edited in textedit, word, etc.

%ZHeader:"{\\rtf1\n\n" %ZFooter:"}"%zn. {\\field{\\*\\fldinst HYPERLINK "%u"}{\\fldrslt %R }} %A: \\i %T,\\i0%q,%V,%p (%Y)\\line\

Author formats

There are 18 author formats in the custom format.

Author formats for last name only

and Format Specifier Abbreviated Example Example Abbreviated %3.2
text lastname %f \emph{et al.} -Henneken, Muench, Holm Nielsen, Blanco-Cuaresma, and Accomazzi
-Kurtz and Accomazzi
-Henneken, Muench \emph{et al.}
-Kurtz and Accomazzi
text first author only if number of authors > 2 otherwise both authors

note these are separated by spaces not commas
%H   -Henneken
-Kurtz and Accomazzi
-Henneken Muench
-Kurtz and Accomazzi
symbol first author only if number of authors > 2 otherwise both authors

note these are separated by spaces not commas
%h   -Henneken
-Kurtz & Accomazzi
-Henneken Muench
-Kurtz & Accomazzi
text lastname %M et al. -Henneken, Muench, Holm Nielsen, Blanco-Cuaresma, and Accomazzi
-Kurtz and Accomazzi
-Henneken, Muench et al.
-Kurtz and Accomazzi
symbol lastname %m et al. -Henneken, Muench, Holm Nielsen, Blanco-Cuaresma, & Accomazzi
-Kurtz & Accomazzi
-Henneken, Muench et al.
-Kurtz & Accomazzi
none first author only lastname+ %n   -Henneken,+
-Kurtz,+
-Henneken,+
-Kurtz,+

Author formats for full name

and First Name First Author vs The Rest Format Specifier Abbreviated Example Example Abbreviated %3.2
text in full if available same lastname, firstname m. %A , and xxx colleagues -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S. and Accomazzi, A.
-Kurtz, Michael J. and Accomazzi, Alberto
-Henneken, E. A., Muench, G., and 4 colleagues
-Kurtz, Michael J. and Accomazzi, Alberto
symbol in full if available same lastname, firstname m. %a , et al. -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., & Accomazzi, A.
-Kurtz, Michael J. & Accomazzi, Alberto
-Henneken, E. A., Muench, G., et al.
-Kurtz, Michael J. & Accomazzi, Alberto
none initials same lastname fm

note no dots after the initials
%E et al

note no comma before or dots after
-Henneken EA, Muench G, Holm Nielsen L, Blanco-Cuaresma S, Accomazzi A
-Kurtz MJ, Accomazzi A
-Henneken EA, Muench G et al
-Kurtz MJ, Accomazzi A
text initials same lastname f.m.

note no space after first initial
%e , and xxx colleagues -Henneken, E.A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., and Accomazzi, A.
-Kurtz, M.J. and Accomazzi, A.
-Henneken, E.A., Muench, G., and 4 colleagues
-Kurtz, M.J. and Accomazzi, A.
none initials same lastname, f. m. %G , et al. -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., Accomazzi, A.
-Kurtz, M. J., Accomazzi, A.
-Henneken, E. A., Muench, G., et al.
-Kurtz, M. J., Accomazzi, A.
none initials same lastname f. m.

note no comma after lastname
%g , et al. -Henneken E. A., Muench G., Holm Nielsen L., Blanco-Cuaresma S., Accomazzi A.
-Kurtz M. J., Accomazzi A.
-Henneken E. A., Muench G., et al.
-Kurtz M. J., Accomazzi A.
text initials different first author: lastname, f. m.

other authors: f. m. lastname
%I , and xxx colleagues -Henneken, E. A., G. Muench, L. Holm Nielsen, S. Blanco-Cuaresma, and A. Accomazzi
-Kurtz, M. J. and A. Accomazzi
-Henneken, E. A., G. Muench, and 4 colleagues
-Kurtz, M. J. and A. Accomazzi
symbol initials different first author: lastname, f. m.

other authors: f. m. lastname
%i , et al. -Henneken, E. A., G. Muench, L. Holm Nielsen, S. Blanco-Cuaresma, & A. Accomazzi
-Kurtz, M. J. & A. Accomazzi
-Henneken, E. A., G. Muench, et al.
-Kurtz, M. J. & A. Accomazzi
text in full if available same firstname m. lastname %k , et al. -E. A. Henneken, G. Muench, L. Holm Nielsen, S. Blanco-Cuaresma, and A. Accomazzi
-Michael Kurtz and Alberto Accomazzi
-E. A. Henneken, G. Muench, et al.
-Michael Kurtz and Alberto Accomazzi
text initials same lastname, f. m. %L , and xxx colleagues -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., and Accomazzi, A.
-Kurtz, M. J. and Accomazzi, A.
-Henneken, E. A., Muench, G., and 4 colleagues
-Kurtz, M. J. and Accomazzi, A.
symbol initials same lastname, f. m. %l , et al. -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., & Accomazzi, A.
-Kurtz, M. J., & Accomazzi, A.
-Henneken, E. A., Muench, G., et al.
-Kurtz and Accomazzi
none initials same lastname, f. m. %N , and xxx colleagues -Henneken, E. A., Muench, G., Holm Nielsen, L., Blanco-Cuaresma, S., Accomazzi, A.
-Kurtz, M. J., Accomazzi, A.
-Henneken, E. A., Muench, G., and 4 colleagues
-Kurtz, M. J., Accomazzi, A.
text initials same f. m. lastname %O , and xxx colleagues -E. A. Henneken, G. Muench, L. Holm Nielsen, S. Blanco-Cuaresma, and A. Accomazzi
- M. J. Kurtz and A. Accomazzi
-E. A. Henneken, G. Muench, and 4 colleagues
-M. J. Kurtz and A. Accomazzi
symbol initials same f. m. lastname %o , et al. -E. A. Henneken, G. Muench, L. Holm Nielsen, S. Blanco-Cuaresma, & A. Accomazzi
-M. J. Kurtz & A. Accomazzi
-E. A. Henneken, G. Muench, et al.
-M. J. Kurtz & A. Accomazzi

Note that formats %e and %f used to be known in Classic ADS as %za2 and %za3 respectively. %za1 from Classic ADS is deprecated since it is equivalent to %1H.

Other formats

Specifier Field Comments
B Abstract prints out the abstract if it is available
C Copyright prints out the copyright statement if available
c Citation count outputs the number of citations to the article
D Publication Date prints out the Publication date if available
d DOI outputs the Digital Object Identifier of the article if available
F Author Affiliation prints out the Author affiliation if available
J Journal prints out the journal name
j Journal prints out the journal name if available; if an AASTeX macro for the journal is available, the macro is printed instead
Q Journal prints out the full journal information if available
q Journal prints out the journal abbreviation
K Keywords prints out the keywords if available
P Last Page prints out the last page number of the article if available
p First Page prints out the first page number of the article if available
pp Page Range prints out the page range numbers of the article if available
pc Page Count prints out the number of pages of the article if available
R Bibliographic Code prints out the bibliographic code if available
S Issue prints out the issue if available
T Title prints out the title if available
U URL prints out the URL of the abstract as a complete hyperlink with the bibcode as the anchor in the form: bibcode
u URL prints out the URL of the abstract in the form: https://ui.adsabs.harvard.edu/#abs/bibcode/abstract
V Volume prints out the volume if available
W Publication Category prints the publication category, currently available categories are: MISC, BOOK, INBOOK, PROCEEDINGS, INPROCEEDINGS, ARTICLE, PHDTHESIS, MASTERSTHESIS, TECHREPORT
X arXiv e-print number prints the identifier corresponding to the paper’s e-print, as assigned by the arXiv
x Comments prints any of the comments available for the record
xe e-print Comments prints any e-print comments available for the record
Y Year prints out the publication year if available

Note the “\” character is used to specify special characters, as in a printf format (i.e., “\n” is a newline, and “\t” is a tab).

Output Field Specifier

The output field specifiers are added to the beginning of the custom format as described below.

  • zn: Enumeration

    This format outputs the sequence number of the record in the output

  • Z: Command format

    This is a special format directive. It must be the first command specified in a format string, and there can be multiple %Z directives at the beginning of the string. While the Z tag produces no output, it allows you to specify the value of certain variables with corresponding parameters. It has the following syntax: %Zcommand:parameter. The parameter can be a number, a word, or a string, depending on the command. If it is a string, it must be enclosed in double quotes. The available commands are:

    • Encoding:word Note that there are two encoding options: global and field. As the name suggests, specifying global encoding applies the encoding to the entire citation, or all output fields. Global encoding is specified using the %Z command. Please see further down for an explanation of field encoding independent of the %Z command. Available global encoding parameters are:
      • unicode (default): UTF-8 encoding of all unicode characters. Note also for backward compatibility UTF-8 option for word is also supported.
      • html: This encoding converts characters in URLs to hex notation, and & to &amp;. Outside URLs, the characters &, <, >, and “ are converted to &amp;, &lt;, &gt;, and &quot;, respectively.
      • latex: This encoding converts all special Tex characters into their Tex escape sequences. For instance ‘\’ is converted to ‘$\backslash $’, ‘$’ is converted into ‘\$’, ‘^’ is converted into ‘\^{}’, etc.
      • csv: The encoding creates csv file format including header line if not specified.
    • Linelength:number This specifies the output line length (default is 0 meaning no line wraps).
    • Header:“string” This specifies a header that will be output once before the data records.
    • Footer:“string” This specifies a footer that will be output once after all the data records are output.
    • Markup:word This specifies how to process HTML markup found in input fields (such as ≤SUB>). Available options are:
      • keep: keep the markup (default)
      • strip: remove the markup
    • EOL:“string” This specifies the character to be printed at the end of a record (newline by default).
    • AuthorSep:“string” This specifies the string to be used when concatenating the names of authors (“, “ by default).
  • Field encoding is applied to each individual field. Available field encoding characters are:

    • >: html encoding. This encoding converts characters in URLs to hex notation, and & to &amp;. Outside URLs, the characters &, <, >, and “ are converted to &amp;, &lt;, &gt;, and &quot;, respectively.
    • <: ascii encoding. This encoding converts accented characters to simple ASCII equivalents.
    • /: url encoding. This encoding converts the characters &, ?, and + to the hex encoded values.
    • \: latex encoding. This encoding converts all special Tex characters into their Tex escape sequences. For instance ‘' is converted to ‘$\backslash $’, ‘$’ is converted into ‘$’, ‘^’ is converted into ‘\^{}’, etc.
🌓