Next: A New Implementation of
Up: 7 Reference Guide
Previous: 7.7 SDR_SUM
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.
Next: A New Implementation of
Up: 7 Reference Guide
Previous: 7.7 SDR_SUM