Basic ADS record inspection

The script calls a utility that supports to modes of data display:

1. The "summary" mode: some basic data
2. The "references" mode: reference data (resolved and unresolved)

Summary mode

showrecord summary -i <identifier>

As identifier anything can be supplied that is supported in the Solr identifier field.

Example output:

Summary Overview for ID: 2025ApJ...995..228S

supplied id:        2025ApJ...995..228S
canonical bibcode:  2025ApJ...995..228S
matched preprint:   arXiv:2505.11597
alternates:         2025arXiv250511597S
doi:                10.3847/1538-4357/ae1501, 10.48550/arXiv.2505.11597
identifiers:        arXiv:2505.11597, 10.48550/arXiv.2505.11597, 2025ApJ...995..228S, 2025arXiv250511597S, 10.3847/1538-4357/ae1501
SciX ID:            Not Available
unmatched DOI cites:10.1214/06-BA127 | journal-article, 10.5281/ZENODO.12447779 | Software, 10.5281/ZENODO.596036 | Software, 10.25080/Majora-92bf1922-011 | proceedings-article
fulltext sources:
    /proj/ads/fulltext/sources/ApJ/0995/apj_995_2_228.xml
reference sources:
    /proj/ads/references/sources/ApJ/0995/2025ApJ...995..228S.iopft.xml
acknowledgements:
    Acknowledgments We would like to thank etc etc etc

The output for unmatched DOI cites may need some explanation: these are entries in the file refids.dat, generated by the Classic resolver. The Classic resolver writes entries to this file whenever it encounters a reference with an "identifier" (read: "DOI"). It includes in which reference file this identifier was encountered and whether a match was found with an ADS record. This utility just reports those DOIs for which no match was found at the time of reporting (it does not check, at the moment, if this has been updated to a match). In addition an attempt is made to determine that this DOI represents (article, conference, data, software, ...).

References mode

showrecord references -i <identifier> -s <source> -m <match status>

Again, for identifier anything can be specified supported by the Solr identifier field.

For source, either Crossref or Publisher can be specied, to filter on just showing reference data of just one or the other.

For match status, either resolved (or 1), guessed (or 5) or unmatched (or 0) can be specified. The guessed category is just a special case of unmatched references where the Classic resolver "thought" it can build a bibcode (mostly meaningless).

Output is typically like this:

# Publisher references for citing bibcode: 2025ApJ...995..228S
## Reference source: /proj/ads/references/sources/ApJ/0995/2025ApJ...995..228S.iopft.xml
### Matched references
2019ApJ...882L..24A -- <ref id="apjae1501bib1" xmlns:xlink="http://www.w3.org/1999/xlink"><element-citation public
ation-type="journal"><person-group person-group-type="author"><name name-style="western"><surname>Abbott</surname>
<given-names>B. P.</given-names></name><name name-style="western"><surname>Abbott</surname><given-names>R.</given-
names></name><name name-style="western"><surname>Abbott</surname><given-names>T. D.</given-names></name><etal/></p
erson-group><year>2019</year><source>ApJL</source><volume>882</volume><fpage>L24</fpage><pub-id pub-id-type="other
" specific-use="ads">2019ApJ...882L..24A</pub-id><pub-id pub-id-type="doi">10.3847/2041-8213/ab3800</pub-id></elem
ent-citation></ref>

### Unmatched references (guessed)
1986wera.book.1986R -- <ref id="apjae1501bib150" xmlns:xlink="http://www.w3.org/1999/xlink"><element-citation publ
ication-type="book"><person-group person-group-type="author"><name name-style="western"><surname>Rybicki</surname>
<given-names>G. B.</given-names></name><name name-style="western"><surname>Lightman</surname><given-names>A. P.</g
iven-names></name></person-group><year>1986</year><source>rpa</source><publisher-name>Wiley</publisher-name><fpage
>400</fpage><pub-id pub-id-type="other" specific-use="ads">1986rpa..book.....R</pub-id></element-citation></ref>
2010LNP...299...57S -- <ref id="apjae1501bib157" xmlns:xlink="http://www.w3.org/1999/xlink"><element-citation publ
ication-type="confproc"><person-group person-group-type="author"><name name-style="western"><surname>Seabold</surn
ame><given-names>S.</given-names></name><name name-style="western"><surname>Perktold</surname><given-names>J.</giv
en-names></name></person-group><year>2010</year><article-title>Statsmodels: Econometric and Modeling with Python</
article-title><conf-name>9th Python in Science Conf.</conf-name><fpage>57</fpage><pub-id pub-id-type="doi">10.2508
0/Majora-92bf1922-011</pub-id></element-citation></ref>

### Unmatched references (no match)
................... -- <ref id="apjae1501bib22" xmlns:xlink="http://www.w3.org/1999/xlink"><element-citation publi
cation-type="data"><person-group person-group-type="author"><name name-style="western"><surname>Bradley</surname><
given-names>L.</given-names></name><name name-style="western"><surname>Sipcz</surname><given-names>B.</given-names
></name><name name-style="western"><surname>Robitaille</surname><given-names>T.</given-names></name><etal/></perso
n-group><year>2025</year><source>zndo</source><comment>Zenodo, doi:<ext-link ext-link-type="uri" xlink:href="http:
//doi.org/10.5281/ZENODO.596036">10.5281/ZENODO.596036</ext-link></comment><pub-id pub-id-type="doi">10.5281/ZENOD
O.596036</pub-id></element-citation></ref>

The references shown are in the format encountered in the raw data (so cleanup has been done). The additional filter parameters, listed earlier, allow one to just show one particular class of reference data.