Enhanced Bibcode Access In Xamin

The recently released version 2.1.6 of Xamin has some enhanced capabilities for handling bibcode queries. For some time the web interface has allowed users to ask whether any tables have rows that index observations which are referenced in a particular article using the syntax

http://heasarc.gsfc.nasa.gov/xamin/xamin.jsp?bibcode=xxxx

where xxxx is the 19 character bibcode. The new version gives a bit more feedback about which bibcode was used when such queries are made.

The zzbib table can be used to find tables and rows matching a particular bibcode in the batch interface with a syntax like

java -jar users.jar table=zzbib constraint=bibcode="'xxxx'"

E.g.,
java -jar users.jar table=zzbib constraint=bibcode="'2014Natur.505..378C'"
bibcode |table_name|id_fields|id
2014Natur.505..378C|rosmaster |seq_id |RP200984N00
2014Natur.505..378C|rosmaster |seq_id |RP201583N00
2014Natur.505..378C|rosmaster |seq_id |RP201584N00
2014Natur.505..378C|rosmaster |seq_id |RP201585N00
2014Natur.505..378C|rosmaster |seq_id |RP201586N00
2014Natur.505..378C|rosmaster |seq_id |RP201587N00

Number of rows: 6
Number of columns: 4

will find the rows in zzbib that reference a particular bibcode. The other fields in zzbib indicate the table, the column of the table used to id specific rows the table, and the value for that id. [Note that since the bibcode is a string parameter in the zzbib table, the bibcode must be enclosed in single quotes. The enclosing double quotes make sure that the single quotes are actually part of the parameter and not processed by the shell.]

In the new release of Xamin you can also add bibcode constraints to particular tables with the new bibcode parameter:

java -jar users.jar table=rosmaster bibcode=xxxx

We can repeat our example above but get the actual data for the ROSMASTER rows

java -jar users.jar table=rosmaster bibcode=2014Natur.505..378C
seq_id |instrument|exposure|ra |dec |name
RP201587N00|PSPCB | 7749|22 43 33.6|44 00 00|EV LAC
RP201586N00|PSPCB | 5928|22 43 07.2|44 10 12|EV LAC
RP201585N00|PSPCB | 4561|22 43 09.6|44 10 12|EV LAC
RP201584N00|PSPCB | 3854|22 43 07.2|44 12 36|EV LAC
RP201583N00|PSPCB | 3445|22 43 07.2|44 13 12|EV LAC
RP200984N00|PSPCB | 2673|22 46 50.4|44 19 48|GL 873

Number of rows: 6
Number of columns: 6


will find all the rows in rosmaster referred to in a particular bibcode. You can add additional constraints to the query if you like. In this context since we have special processing of the bibcode it need note be enclosed in quotes, but if the bibcode contains special characters like ampersand you may need to use quotes or some other mechanism to escape shell processing.