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 |
| pb | Publisher | prints out the publisher name for the article if available |
| pc | Page Count | prints out the number of pages of the article if available |
| pp | Page Range | prints out the page range numbers 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
&. Outside URLs, the characters &, <, >, and “ are converted to&,<,>, and", 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).
- 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:
-
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
&. Outside URLs, the characters &, <, >, and “ are converted to&,<,>, and", 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.
- >: html encoding. This encoding converts characters in URLs to hex notation, and & to