Next: A.1 Adding New Missions Up: xselectManual Previous: 3.31 stop
Starting with Xselect v2.0 much of the mission-dependence has been
incorporated into a simple ascii file called xselect.mdb. The
default location for this file as distributed with the HEASOFT
software is $HEADAS/../ftools/xselect/common/xselect.mdb, i.e.
>ls $HEADAS/../ftools/xselect/common/xselect.mdb /software/heasoft/headas/setup/../ftools/xselect/common/xselect.mdbwhere
$HEADAS is the environment variable which points to your
HEASOFT software installation (as described in the HEASOFT
installation instructions at
https://heasarc.gsfc.nasa.gov/docs/software/lheasoft/install.html).
The following keywords must be present for each mission entry in the xselect.mdb file. However these keywords may not be relevant for certain missions. In such cases the value of these keywords should be NONE.
| Entry | Description | Type | Sample Values |
submkey |
The keyword read from the file to get the SubMission | String | GRATING; NONE |
instkey |
The keyword read from the file to get the Instrument | String | INSTRUME; NONE |
dmodekey |
The keyword read from the file to get the Datamode | String | DATAMODE; NONE |
mkf_def_expr |
The global expression for filenames of MKF files | String | ae*mkf* |
mkf_rel_dir |
The global expression for filenames of MKF files | String | ../hk |
time |
The column in the events extension used for time | String | TIME |
tunits |
The units for the time column | String | s |
binsize |
The default time bin size for light curves | Numeric | 1.157e-5; 16 |
x |
The column for sky X-axis | String | X |
y |
The column for sky Y-axis | String | Y |
detx |
The column for detector X-axis | String | DETX |
dety |
The column for detector Y-axis | String | DETY |
rawx |
The column for raw X-axis | String | RAWX |
rawy |
The column for raw Y-axis | String | RAWY |
gti |
The name of the extension (EXTNAME) with GTI table |
String | STDGTI |
events |
The name of the extension (EXTNAME) with event data |
String | EVENTS |
timeorder |
Yes if the events are in time order | String | yes |
timepixr |
The TIMEPIXR value to use if not in event file | String | 0.0 |
instruments |
A space-delimited list of the instruments | String | ACIS HRC |
spbn |
The binning factor for spectra | Numeric | 1 |
ecol |
The column for spectral information | String | PI |
ccol |
The column for CCD number (if required - NONE if not) | String | CCDID |
gcol |
The column for event grade/pattern | String | GRADE |
polwcol |
The column for polarization weighting (NONE if not required) | String | W_MOM |
imagecoord |
The default coordinate system for images | String | SKY |
wmapcoord |
The default coordinate system for WMAPs | String | DETECTOR |
catnum |
The extension number for catalog keywords | String | 1 |
wtmapb |
Yes if a WMAP is to be produced | String | no |
wtmapfix |
Yes if WMAP pixels outside selected region set to -1 | String | yes |
lststr |
The global expression for event files | String | ad*s0*[hml].* |
ofilt |
The default MKF filtering for valid files | String | ONTIME>100 && NEVENTS>0 |
fbin |
The default binning for images | String | 4 |
hbin |
The default binning for WMAPs | String | 8 |
modes |
A list of the datamodes | String | FAINT BRIGHT |
rbnval |
Number of channels to which spectra are binned | String | 512 |
rbnmod |
Compression mode for spectral rebinning | String | LINEAR |
catcol |
A space-delimited list of keywords used to catalog events file | String | OBJECT DATAMODE DATE-OBS |
dispcol |
A space-delimited list of keywords used to display the catalog | String | OBJECT DATAMODE BIT_RATE |
extract |
The ftool used to extract images, spectra, and light curves. Supported options are extractor, ftextractor, saextrct, or seextrct. The ftextractor backend is required for the multi-axis (per=) extraction. | String | extractor; ftextractor |
grpstr |
Grouping to be run on the spectrum when saving (NONE if not required). | String | GROUP 0 1023
& exit |
The following keywords are optional, and should only be used if they are relevant for a given mission.
| Entry | Description | Type | Default Values |
xsiz |
The keyword giving the max. value of X | String | TLMAX |
ysiz |
The keyword giving the max. value of Y | String | TLMAX |
detxsiz |
The keyword giving the max. value of DETX | String | TLMAX |
detysiz |
The keyword giving the max. value of DETY | String | TLMAX |
rawxsiz |
The keyword giving the max. value of RAWX | String | TLMAX |
rawysiz |
The keyword giving the max. value of RAWY | String | TLMAX |
phamax |
The keyword giving the max. value of ECOL | String | TLMAX |
swmapx |
True if WMAP X axis is inverted from sky | String | no |
swmapy |
True if WMAP Y axis is inverted from sky | String | no |
respscript |
The name of the script run to generate the spectral responses. | String | NONE |
respneedreg |
Set to yes if the response script needs the region file as input. | String | no |
extendresp |
If set to yes the spectral response generation has an extended source option. | String | no |
adjustgti |
If set to yes then extractor will line output GTIs up with CCD frame boundaries. | String | no |
usetpixrsel |
If set to yes then call extractor with the usetpixrsel parameter set to yes. | String | no |
badchan |
Bad channel ranges to be flagged in the QUALITY column when saving spectra (NONE if not required). | String | 1-11,212-256 |