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

D.12. BATID2XY 155
(history = NO) [boolean ]
If history = YES, then a set of HISTORY keywords will be written to the header of the
specified HDU in the output file to record the value of all the ftcopy task parameters that
were used to produce the output file.
D.12.5 EXAMPLES
Note that when commands are issued on the Unix command line, strings containing special characters
such as ‘[’ or ‘]’ must be enclosed in single or double quotes.The following examples illustrate
ways in which batid2xy can be used.
1. With an input file (“BDSD” mode).
batid2xy infile=’detids.fits’
-or- batid2xy detids.fits
An input file can be created from an ascii table containing the block, dm, side, and detector
values in columns 1-4, respectively. A template to create the proper column names can be found
in the batid2xy directory as the file bdsd mode.lis. A header template is bdsd mode.hdr.
If the data is in a file called data.lis, then the input file detids.fits is created using one of the
following commands. Both of these assume that the template files are in the current directory.
-or-
create_input.pl infile="data.lis" outfile="detids.fits"
fcreate bdsd_mode.lis data.lis detids.fits extname="DETID"
headfile=bdsd_mode.hdr clobber=yes
2. With no input file (“BDSD” mode).
batid2xy NONE 7 3 1 67
3. With an input file (“DETID” mode).
batid2xy infile=’detids.fits’
-or- batid2xy detids.fits
An input file can be created from an ascii table containing the detector ID values in column 1.
A template to create the proper column names can be found in the batid2xy directory as the file
detid mode.lis. A header template is detid mode.hdr.
If the data is in a file called data.lis, then the input file detids.fits is created using one of the
following commands. Both of these assume that the template files are in the current directory.