The SWIFT BAT Software Guide Version 6.3 30 ... - HEASARC - Nasa

D.12. BATID2XY 153
D.12 BATID2XY
D.12.1 NAME
batid2xy - read in the detector number (either block, dm, side, detector numbers or single detector
ID) and output the x/y position in the BAT array –OR– input the x/y position in the BAT array
and output the detector identification.
D.12.2 USAGE
batid2xy infile [block] [dm] [side] [det] [detid] [detx] [dety] [outfile]
D.12.3 DESCRIPTION
This code can either read in an input FITS file containing a list of detector identifications or x/y
positions, or it can read these values from the command line (with the input file given as NONE).
The program calls batidconvert to figure out the X (column) and Y (row) numbers associated
with the particular detector or does the reverse transformation. The output is always the full
identification of the detector by DETID Block DM SIDE DET X Y.
There are three basic modes of conversion, which are abbreviated BDSD, DETID and DETXY.
The mode is selected either by including a “BATIDMOD” keyword in the input file, or by supplying
valid ( > -1) values of the detid, detx or dety parameters.
BDSD: In this mode, the conversion goes from detector identification to BAT X and Y (location
in the detector plane). The detector is identified by, respectively, block (0:15), detector
module (0:7), side (0:1), detector (0:127). In the input file, these are supplied in columns named
“BLOCK”,“DM”,“SIDE” and “DET.” The keyword “BATIDMOD” is set to “BDSD.” On the
command line, these are supplied through the block, dm, side and det parameters. See example
below.
DETID: In this mode, the conversion goes from detector identification to BAT X and Y (location
in the detector plane). The detector is identified by detector ID, which is derived from the formula:
detid = block*2048 + dm*256 + side*128 + detector. In the input file, this is supplied in a column
name “DETID.” The keyword “BATIDMOD” is set to “DETID.” On the command line, this is
supplied by setting the detid parameter equal to the detector ID. See example below.
DETXY: In this mode, the conversion goes from BAT X and Y (location in the detector plane)
to detector identificaiton. The detector location is given by BATX and BATY. In the input file,
these are supplied in columns named “DETX” and “DETY.” The keyword “BATIDMOD” is set
to “DETXY.” On the command line, these are supplied through the detx and dety parameters.
See example below.
D.12.4 PARAMETERS
infile [filename ]