HEASARC Bibliography
The HEASARC Bibliography: Explanation and Help
Welcome to the HEASARC Bibliography
These publication lists and associated metadata have been used for internal reviews and reports, for setting up the links between the ADS and HEASARC, and other bibliometric needs, but ideally they will also enable a broader community an even more efficient use of the archive itself. Like the papers in these lists, any bibliography contains a certain amount of human judgement and bias, so explaining how this particular example has been put together is important, not to mention giving much deserved credit to the many resources it has relied upon. So first and foremost we should mention that the HEASARC bibliography adheres to the premier list of bibliographic recommendations outlined in Best Practices for Creating an Observatory or Telescope Bibliography from the IAU Commission 5 Working Group on Libraries, as this help file will attempt to verify.

History
We began this bibliography-related work here at NASA/GSFC in 2010 by updating the Bibcode Status page which tracks the bibcodes and ObsIDs (Observation Identifiers) delivered to the ADS from GSFC in order to set up the "observation-to-publication" (and vice-versa) links between the ADS and HEASARC. When any archive delivers such information, the ADS populates an "On-line data" link on that particular publication's search result page which then displays the observations from all archives that have delivered ObsIDs to them for that bibcode/publication. (This is the same as the "D" link in an ADS list of multiple search results). In turn, the HEASARC also displays a link to the publications in the ADS which have made use of the particular ObsID returned in any search result. Our procedure for finding bibcodes is to use the ADS Labs 2.0 fulltext search with the particular mission name as keyword. We use the HEASARC to find or verify the ObsIDs according to the information in the publication. As previously mentioned, the Bibcode Status page tracks the total number of bibcode/obsid links we've sent to the ADS per mission. This page contains missions currently operational as well as retired:

Operational missions:
NuSTAR - We search the ADS for NuSTAR bibcodes, then search the HEASARC for their ObsIDs, then deliver to the ADS, cross-checking with NuSTAR Project Scientist Daniel Stern.
Fermi - see the Fermi paragraph below:
Swift - In 2015 we searched the ADS for all Swift papers and updated the entire Swift bibliography. This included deleting, reclassifying, and adding many hundreds of additional Swift papers between 2005 and the present, and creating hundreds of thousands of new bibcode-to-obsid links.
INTEGRAL - In 2016 we searched the ADS for all INTEGRAL papers and updated the entire INTEGRAL bibliography. This included deleting, reclassifying, and adding many hundreds of additional INTEGRAL papers between 2003 and the present, and creating hundreds of thousands of new bibcode-to-science-window links.
XMM and Chandra - We are currently searching the ADS for all Chandra and XMM papers since their launch dates. We have so far progressed to 2005, deleting, reclassifying, and adding many papers and bibcode-to-obsid links.

Retired missions:
Suzaku - In 2015 we searched the ADS for all Suzaku papers and updated the entire Suzaku bibliography. This included deleting, reclassifying, and adding many additional Swift papers between 2006 and the present, and creating hundreds of new bibcode-to-obsid links.
HETE-2 - no obsids have been delievered to the ADS for the HEASARC, and the bibliography was only recently created.
BeppoSAX - the HEASARC and bibliography don't include the WFC data in any useful form, so no WFC papers are included either.
RXTE - In 2017 we searched the ADS for all RXTE papers and updated the entire RXTE bibliography. This included deleting, reclassifying, and adding many hundreds of additional RXTE papers between 1996 and the present, and creating hundreds of thousands of new bibcode-to-obsid links. RXTE is the most active bibliography by far in this list of retired missions.
ASCA - We compiled bibcodes and obsids from 2005 to the present, while others did so from 1994 up to 2005.
EUVE - the HEASARC and bibliography include pointed phase Deep Survey/Spectrometer (DS/S) data and papers, but no All-Sky Survey or Right Angle Program data or papers.
CGRO - We compiled bibcodes and obsids from 2006 to the present, while others did so from 1992 up to 2006.
ROSAT - no RASS papers are included as the typical RASS-dedicated paper analyzes the entire RASS archive, or quotes the flux of a favorite source from a table.

Chandra and Fermi:
Two of the missions not yet mentioned have played critical roles in this timeline. During support for the local Fermi peer review we reconnected with a former co-worker from STScI who put us in contact with his colleagues at CXC who in turn developed and maintain the Chandra Bibliography. We agreed to meet during a AAS meeting in Boston and they gave us a live-demo of their bibliography software. Weeks later they delivered a partial version of it for use at GSFC on the HEASARC bibliographies. A side note on Chandra here is while the HEASARC does contain Chandra data, we don't create links between the ADS and HEASARC in order to avoid confusion with CXC's own links to the ADS.

Another mission not yet mentioned is Fermi, which has no ObsIDs for delivery to the ADS since the LAT is an all-sky instrument. Yet the Fermi group at GSFC desired a new bibliography format to replace their outdated version. One option we presented to them was the Chandra-format, since we now had the perl code from CXC. A few months later a new Fermi Bibliography was online. We currently maintain it by adding monthly bibcode updates from Jerry Bonnell of the Fermi team to the database. We added our own list of science subjects to choose from, but kept the general Chandra classification scheme that uses five different categories. This is critical because we've used this scheme throughout, classifying the other mission's bibcodes with this scheme in mind. A major point we keep hearing from other bibliographers is to be as consistent as possible, which can be a great challenge especially for a multi-mission archive. So although we've tried to do that here, there are portions of these publication lists that have been created by others with different clasification schemes in mind. Our attempt to be consistent is primarily with the missions currently in operation, and then we plan to eventually reclassify the lists that were created by others, but using our current scheme. All operational mission lists have been classified in the same manner except for Swift years 2010-2015 and INTEGRAL, which are in progress. We give a complete description of the scheme, two paragraphs below:

We've used CXC's software to develop bibliography search pages for all of these previously mentioned missions. However in the spring of 2015 there was a NASA review of the HEASARC which required bibliography lists for all missions in html format. So instead of publishing the search pages we created from CXC's perl code, we used the database to generate the html publication lists which NASA HQ requested. The goal is still to add or replace the html lists with the perl-code search-pages, but for the time being these lists are in place as the HEASARC Bibliography. There remain several missions not mentioned, two being AGILE and MAXI, both in operation. There is currently no data for these missions in the HEASARC, so we don't deliver any bibcode/obsid link information to the ADS. However since the HEASARC will eventually archive them, they have publication lists in our bibliography. Then briefly, neither GALEX or FUSE are expected to have data in the HEASARC nor are currently in operation. Yet since the HEASARC contains observations tables which link to the corresponding data files in other archives, we still include their publication lists in our bibliography, but do not include them in the "Publication Totals" table on the main HEASARC Bibliography page.

Pre-1990 missions:
I've not mentioned the pre-1990 missions, but am taking another look at those now, so will be adding more here as I proceed:
ARIEL-V - papers using the ASM (all sky monitor) and SSI (sky survey instrument) are included in the Ariel-V bibliography, since the HEASARC does not include the RMC (rotation modulation colimator), the high resolution proportional counter spectrometer, the polarimeter spectrometer, or the scintillation telescope data.
COS-B - papers using the spark chamber gamma-ray detector are included in the COS-B bibliography, since the HEASARC does not include the proportional counter data.
SAS-2 - papers using any SAS-2 data are included in the bibliography, as the HEASARC contains raw data for all SAS-2 instruments.
Copernicus - papers using the UCL/MSSL x-ray instrument (UCLXE) are included in the Copernicus bibliography. No papers using the Princeton UV telescope/spectrometer (which are listed and data archived at STScI/MAST) are included, since the HEASARC contains the raw UCLXE data.
Vela-5B - papers using the x-ray ASM (all sky monitor) instrument, also called the scintillation x-ray detector (XC), are included in the Vela-5B bibliography. No papers using either the gamma-ray detectors, or the hemispherical plate electrostatic analyzer (SM) detectors are included, since the HEASARC contains only the ASM lightcurve data.


Bibcode classification scheme:
These categories come straight from the Chandra Bibliography, though we've altered them somewhat and use the following color-codes in the bibliography lists:

Presents science: This category includes publications that present science which comes from any raw data they have newly processed (they are the PI) or re-processed (archival data). So our publication list includes both team papers and non-team papers. We make the distinction in our search page, and try to include which working group it comes from for the team papers.

Reviews science: We created this category on our own for review papers. So it's similar to the "refers to science" category but this would include papers that at least partly focus on summarizing the current state of the field from a perspective, by referring to several other science publications (which are again linked to in our search page).

Follows-up science: This category also "refers to science" as above, but does add new analysis. In a nutshell this category would includes a paper that:

i) builds on others work (refers to their science) and yet does new, original science that the should be able to count as coming from their data. This analysis of published results adds new quantities to the original data, or adds significant value to the body of science produced from the original data.
ii) presents science on a target discovered by, but observes it using a different mission (multi-wavelength).
iii) uses theory in order to describe science presented by other papers.

Refers to science: This includes publications that only make reference to science from other papers, without adding any new analysis. However, we only include papers that either make some compelling scientific point when referring to other papers (more than just "their data agrees with our Chandra data" for example), or when they create a useful plot that combines science from multiple missions, etc. We then set up a link between these papers in our search page.

Predicts science: The paper makes some sort of quantitative prediction for science, not just that will be useful in the future for this target.

Presents instrumentation, mission, or software: Mostly calibration papers, but also those that summarize the long term mission goals, instruments, or describe calibration software, pipelines, etc.

Please contact the author Doug van Orsow with any questions or comments.

Back to HEASARC bibliography