7.8 SPECANAL

Calling Sequence
SPECANAL [, SETUPFILE] [, keywords]

Arguments

SETUPFILE:

Input string specifying an anal_struc namelist file which defines the analysis configuration. This is an optional input parameter. Keyword specifications can set all anal_struc configuration variables and will override specifications in the setup_file. File extension for these files default to ``ANL''.

Indirectly Referenced Inputs:

The anal_struc namelist permits the specification of configuration files for each of the major processes: BLD_QUAD_DIF, DAY_SUMMER, and FIT_PREP. If these specifications in the setup file are blank and keyword alternate specification is not used, these configurations default to nominal configuration files which are:

IGR$IGORE_DATA:NOM_CFG.BQD
BLD_QUAD_DIF configuration
IGR$IGORE_DATA:NOM_CFG.DSM
DAY_SUMMER configuration
IGR$IGORE_DATA:NOM_CFG.FP
FIT_PREP configuration
IGR$IGORE_DATA:NOM_CFG.PA
PLOTANAL configuration
IGR$IGORE_DATA:NOM_CFG.BLN
bottomline configuration

Keywords

/NOBATCH:

Input logical, if set, executes the task as part of parent process rather than submitting it to a batch queue. Default is execute processing as a batch job. Depending on exact configuration, /nobatch mode can take a long time, locking the current IGORE session.

QUEUE:

Input string specifying the queue name for batch submission. Default queue is SYS$BATCH.

/BUILD:

Input logical, if set, causes creation of the batch command file but does not submit it for execution. All configuration information is available for inspection prior to submission.

COMFILE:

Input string specifying the name of the batch command file to be created. By default this filename is created from the FILEROOT which in turn is derived from target name and viewing period.

/CREATE:

Input logical, if set, will create directories, if necessary, for products from information derived from configuration files. Default is to check for existance of these directories and abort submission of batch job if they do not exist.

/SAVE:

Input logical, if set, records the specanal configuration in an anal_struc namelist file. This file is in the format of the SETUPFILE input parameter, Default name for the configuration file is derived from the FILEROOT as <FILEROOT>.ANL. Keyword CFGFILE overrides the default naming of this file.

CFGFILE:

Input string specifying name of saved config file. Default is derived from FILEROOT. Only meaningful with /SAVE keyword.

Additional keywords are processed by the ANAL_SETUP routine. You may note that many correspond to entries in the SETUPFILE namelist. These are described below.

TARGET:

Specify the OSSE target to process. This input may be either a target name in a string, a target id as an integer, or a dummy structure.

VP:

Specify the viewing period to process (floating point value).

START_TIME:

STOP_TIME:

PROD_DIR:

OUT_DIR:

FILEROOT:

LOGFILE:

/NOBQD:

If set, do not run BLD_QUAD_DIF Default is to generate them, NOBQD=0.

BQD_CONFIG:

BQD_DIR:

/NODAYSUM:

If set, do not run DAY_SUMMER. Default is to generate them, NODAYSUM=0.

DAYSUM_DIR:

DAYSUM_OUT:

DAYSUM_GOOD:

DAYSUM_CONFIG:

/NOFITPREP:

If set, do not generate FFIT_PREP plots and files. Default is to generate them, NOFITPREP=0.

FITPREP_OUT:

FITPREP_CONFIG:

FITPREP_DIR:

/NOPLOTANAL:

If set, do not generate `Plot Analysis' plots and files. Default is to generate them, NOPLOTANAL=0.

PLOTANAL_CONFIG:

PLOTANAL_DIR:

/NOBLN:

If set, do not generate `Bottom-Line' plots and files. Default is to generate them, NOBLN=0.

BLN_OUT:

BLN_CONFIG:

BLN_DIR:

PRODUCTION:

NODQSUMMARY:

Outputs

<dflt_dir><fileroot>.ANL
SPECANAL Setup file if /SAVE is used

<dflt_dir><fileroot>.COM
Batch file that is submitted and executed

<out_dir><fileroot>.CFG
Complete configuration of the run including anal, bqd, dsm, fitprep namelists

<out_dir><fileroot>.LOG
Result of batch execution

<bqd_dir><...>_DIFF.SDBs
BLD_QUAD_DIF difference files, 1 per day

<dsm_dir><fileroot>_DSM.SDB
DAY_SUMMER standard sum file

<dsm_dir><fileroot>_GSM.SDB
DAY_SUMMER good sum file

<fp_dir><fileroot>_PREP.LOG
FIT_PREP run log file

<fp_dir><fileroot>_TOT.SDB
FIT_PREP observation total file w/response

<fp_dir><fileroot>_DAY.SDB
FIT_PREP observation daily file with pointers to total file response

<fp_dir><fileroot>_PREP.PS
FIT_PREP plots. These are difference count spectra plotted for each detector on the source. The are plots linear in energy from zero to 4 MeV and logarithmically for 0.01 to 10 MeV. These plots are also generated with rebinning.

<pa_dir><fileroot>_PLOT.LOG
PLOTANAL run log file

<pa_dir><fileroot>_COUNT.PS
PLOTANAL count rate plot. The count plots are generated by individual detectors and summed detectors. Each of these plots is run over two energy ranges (linear & logarithmic) and two different energy-binnings. The DSA in the graph title represents the Detector Step Angle corresponding to an on-source pointing.

<pa_dir><fileroot>_EBAND.PS
PLOTANAL temporal plot (i.e. a light curve). Plots are generated for 4 energy bands: 0.05-0.15 MeV, 0.15-0.30 MeV, 0.30-0.80 MeV, 0.80-1.50 MeV, showing the daily-summed source intensity for each day of the observation. Curves are plotted for each detector and their sum. For the summed plots, the mean is computed for the observation and used as the model for the fit. P is the probability that the (constant) intensity model is consistent with the data points. The final table compares the data from one detector with the model produced by the average of the other detectors.

<pa_dir><fileroot>_DAILY.PS
PLOTANAL daily count rate plots. This set of plots consists of two major components: daily plots showing each detector (and two energy ranges for each detector) and each detector summed for the duration of the observation. Each data set is fit to a constant model of zero, the representing the probability that the plot is consistent with the zero model (probability of a non-detection).

<pa_dir><fileroot>_STATE.PS
PLOTANAL version of the SHOW_WHEN plot. Shows the pointing strategy used by each detector for each state of the instrument. Good for recognizing possible confusing sources in both source & background pointings.

<bln_dir><fileroot>_BLN.LOG
Bottom-line run log file

<bln_dir><fileroot>_RBN.SDB
Bottom-line count rates resampled to ``AGN-like'' bins

<bln_dir><fileroot>_BLN.SDB
Bottom-line crunched count rates

<bln_dir><fileroot>_BLN.PS
Bottom-line plots (PostScript file). Generates resampled plots in both count and photon space.

<bln_dir><fileroot>_PHOT.DAT
ASCII file listing `approximate' photon flux points. This is useful for plotting the output with your own plotting software.

When converting the output from counts to flux, a model must be defined to assist the instrument response deconvolution process. SPECANAL defaults to utilizing a simple power-law model, specifically . It is NOT a best-fit model! This should be kept in mind when interpreting this output.

Note: keywords and referenced configuration files can significantly alter the naming and directories of these products.