Parameters:::::: APAR FLOAT = Array(6) Fit Model Initial Parameters BACK_ORDER INT = 1 Polynomial order for background construction CHANMASK STRING = 'aaaa' Bit mask used to select rates for GRAPH command DATA_TYPE STRING = Array(2) Specification of data mode to be used for file finding. DET_ID INT = 1 Detector ID, for BATSE 0-7 DET_TYPE STRING = 'spec' Detector type DFLTS_FILE STRING = 'spex_dflts.dat' File with defaults for parameters from LIST command. ENERGY_BANDS FLOAT = Array(8) Energy bands (keV) for display in GRAPH command. Grouped by twos. EPLOTS INT = 0 Logical. If set, then display error bars in GRAPH command. ERANGE FLOAT = Array(2) Energy interval used for fitting. FLARE INT = 851 BATSE archive flare number. FREE INT = Array(6) Logical array. Set to 0 or 1 corresponding APAR parameter in F_MODEL is fixed(0) or free(1). F_MODEL (FUNCTION_COM)STRING = 'f_vth_bpow' Name of function used in fitting. HIGH_DRM INT = 0 Logical. If set, then the high energy versions of the DRMs are used in the BUILD_DRM command. IAVG INT = 1 Interval averaging parameter. Used under SELECT_INTERVAL. IAVG consecutive intervals are grouped together when using REGULAR style. IEAVG INT = 1 Spectral interval averaging parameter. For display purposes only at present. Used under SPEC_BANDS command. IFIRST INT = 0 First accumulation to use for fitting and PHOTON_SPECTRUM display. ILAST INT = 3 Last accumulation to use for fitting. ITER INT = 4 Number of outside loops on Curvefit where conversion factors are recomputed. NITER INT = 5 Number of loops inside of Curvefit. QUIET INT = 0 If set, it reduces the reporting during fitting. RANGE_HI FLOAT = Array(6) High boundaries, RANGE(*,1) RANGE_LO FLOAT = Array(6) Low boundaries, RANGE(*,0) SCALE_BANDS FLOAT = Array(4) Multiplicative factors applied to light curve bands in GRAPH. Referenced to ENERGY_BANDS or first four channels in CHAN_MASK SPXRANGE FLOAT = Array(2) If non-zero, this is the xrange used in spectral plotting. SPYRANGE FLOAT = Array(2) If non-zero, this is the yrange used in spectral plotting. SUMFIT INT = 0 If not set, then initial fit parameters are taken from the previous interval, apar_arr(*,i-1). If set, then the initial fit parameters are taken from the previous fit to the ith interval in apar_last(*,i). T_HIST_MODE STRING = 'FLUX' TIME_HISTORY and GRAPH display mode. FLUX for counts/s/cm2/keV COUNTS for counts/s UNCERT FLOAT = 0.0500000 Minimum uncertainty in FLUX bin as a fraction of FLUX. UTE STRING = '91/07/24, 23:05:16.141' Timerange upper bound. UTS STRING = '91/07/24, 23:04:06.695' Timerange lower bound. WUSE LONG = Array(87) Indices of energy bins used in fitting. XOFF INT = 400 Xoffset in device coordinates of graphics window. YOFF INT = 200 Yoffset in device coordinates of graphics window. Variables:::::: APAR_ARR FLOAT = Array(6, 4) Fit Model parameters for each interval. APAR_LAST FLOAT = Array(6, 4) Fit Model parameters for last fit to each interval. APAR_SIGMA FLOAT = Array(6, 4) Curvefit uncertainties on APAR_LAST AREA FLOAT = 127.000 Geometric area of detector for normal incidence, cm2 BACK FLOAT = Array(256, 131) Generated background rate for each channel, time bin. Same units as FLUX BACKI FLOAT = Array(256, 4) Background for accumulation interval. BACK_SIGMA FLOAT = Array(256) Uncertainty on BACK, from poly_fit. BURST INT = 574 BATSE burst number CFLUX FLOAT = Array(256) Last count rate spectrum displayed. Counts/cm2/s/keV CHI FLOAT = Array(1, 4) Reduced chi square for each accumulation interval CONVERSION FLOAT = Array(256) Conversion factor for the last displayed photon spectrum. Defined as the count rate spectrum divided by the photon spectrum defined at the energies given by the vector EMEDGE, which is defined to be the arithmetic means of the channel edges. COSINE FLOAT = 0.746035 Cosine of the angle between the detector normal and the photon source. COUNT_2_FLUX FLOAT = Array(256) Conversion from count rate to count flux, channel energy width x area. DRM FLOAT = Array(256, 100) Detector response matrix, output channels x input energies. Defined as the counts/cm2/keV per incident photon/cm2 EBACK FLOAT = Array(256, 131) Uncertainties on BACK. EBACKI FLOAT = Array(256, 4) Uncertainties on BACKI. ECFLUX FLOAT = Array(256) Uncertainties on CFLUX. EDGES FLOAT = Array(2, 256) Detector energy-loss channel edges. EFLUX FLOAT = Array(256, 131) Gaussian uncertainties on FLUX EMDGE FLOAT = Array(256) Arithmetic mean of EDGES EM_IN FLOAT = Array(100) Arithmetic mean of E_IN EOBSI FLOAT = Array(256, 4) Uncertainties on OBSI. EPIVOT (FUNCTION_COM)FLOAT = 50.0000 Pivot energy in keV. Used as normalization energy for power-law functions. E_IN FLOAT = Array(2, 100) Incident energies defined for DRM. FILES STRING = Array(2) Datafiles selected under TIME_HISTORY command. FLUX FLOAT = Array(256, 131) Observed count rate, channels by intervals, in counts/s/keV/cm2, no background subtracted IEGROUP UNDEFINED = Channel number boundaries of spectral channels grouped together. ISELECT LONG = Array(2, 4) Index of interval boundaries (referenced to FLUX) of accumulation intervals. The ith interval starts at the leading edge of ISELECT(0,i) and ends at the leading edge of ISELECT(1,i). LIVE FLOAT = Array(256,4) Live time in seconds of each channel in every accumulation interval. LTIME FLOAT = Array(256,131) Live time in seconds of each FLUX observation channel for every time bin. NBIN LONG = 131 Number of time intervals in FLUX. NCHAN LONG = 256 Number of spectral intervals in FLUX. OBSI FLOAT = Array(256, 4) Source flux in accumulation interval I. RANGE FLOAT = Array(6, 2) High and low boundaries for APAR values during fitting. RATE FLOAT = Array(256, 131) Background subtracted count rate, same units as FLUX and BACK TB FLOAT = Array(4) Boundaries of background intervals. UT DOUBLE = Array(2, 131) Time boundaries for bins in FLUX. Expressed in seconds from time given by ATIME( getutbase(0)) UTM DOUBLE = Array(131) Midpoints of UT. WEDGE FLOAT = Array(256) Widths (keV) of output energy bins, EDGES. WUSE LONG = Array(87) Indices of energy bins used in fitting. W_IN FLOAT = Array(100) Widths (keV) of input energy bins, E_IN. XSELECT DOUBLE = Array(2, 4) Time boundaries on accumulation intervals referenced to the same base as UT. Commands:::::: ACCUM Integrate the spectral data in FLUX over the selected time intervals. TIME_HISTORY Read the data files for the chosen event into FLUX and UT and plot the light curve in the time history window. COUNT_SPECTRUM Plot the count rate spectrum for the current interval, IFIRST, and overlay the calculated count rate from the given by F_MODEL and the current fit parameters for the interval in APAR, APAR_ARR, or APAR_LAST. PHOTON_SPECTRUM Plot the photon spectrum for the current interval, IFIRST, and overlay the calculated photon spectrum from the given by F_MODEL and the current fit parameters for the interval in APAR, APAR_ARR, or APAR_LAST. The opportunity is also presented to graphically select the model parameters. LIST Print a list of the control parameters and their values as well as the commands to the screen. EXIT Exit the SPEX procedure and return to IDL at the main program level. FITTING After the data is read by TIME_HISTORY, the DRM created under the DRM menu, the intervals selected using SELECT_INTERVAL, the model parameters initialized using PHOTON_SPECTRUM, the free parameters determined by the value of the FREE array, the allowed energy range selected by the value of ERANGE, the intervals are fit using a modified curvefit running from IFIRST to ILAST. EXECUTE Prompts for an IDL command line to be input for the IDL EXECUTE function. STOP IDL STOP. Resume by entering .c at the IDL prompt. ZOOM Interactive selection of a reduced xrange. Restore full scale with CLEAR_UT. DISPLAY_INTERVAL In the time history window, which must be the active window, overlay lines at the boundaries of the accumulation intervals. SELECT_INTERVAL In the time history window, which must be the active window, interactively select the time intervals for integration prior to FITTING. Also, the time intervals may be input directly into the array, XSELECT = fltarr(2,N) where the times are referenced to the same base as the data intervals in UT and each interval is specified by its boundaries. BACKGROUND_INTERVAL In the time history window, which must be the active window, interactively select the time intervals for background accumulation. The default background model is a linear interpolation in time over the data points in two selected background intervals. Experienced users may change the order of the polynomial fit used by changing the parameter BACK_ORDER from its default value of 1. INITIALIZE Restore some of the original defaults. GRAPH Plot light curves in the time history window. Light curves are integrated in energy over the ranges specified by ENERGY_BANDS or CHANMASK and may be rescaled by changing SCALE_BANDS. DRM Enter the DRM menu to READ or BUILD load the detector response matrix, DRM. READ_DRM Read the DRM files specified by DFILE for the direct response matrix and SCATTERFILE for the response matrix due to scattering off the earth. The response matrix is interpolated to fine bins and then integrated over the output bin energies for the specific data type on the date of the event. BUILD_DRM Create the DRM direct detector response matrix, DRM, by interpolating in the source aspect angle over a stored set of response matrices. The response matrix is then interpolated to fine bins and integrated over the output bin energies for the specific data type on the date of the event. TOP Return to the main SPEX menu from a branch menu. STEPS_HELP Describes the step-by-step procedure for processing spectra through the SPEX menu. SUMMARY Enter the SUMMARY menu to save and restore processed spectra and fit parameters. ERASE Clears a Tektronix graphics page. TEK Sets the graphic display to Tektronix. FIND_FILES Find the filenames or verify the filenames specified under the parameters _1FILE and _2FILE. Mostly unneeded using automatic file finding defaults with the filename parameters left blank. ENRANGE With the SPECTRAL WINDOW active (last plotted to), graphically select the energy limits on the spectra to be fit. CH_BANDS With the SPECTRAL WINDOW active (last plotted to), graphically select the four ranges in the ENERGY_BANDS parameter. SPEC_BANDS With the SPECTRAL WINDOW active (last plotted to), graphically select the groups of channels to be summed together for display. Does not affect binning for fitting which uses individual channels within the limits specified by ERANGE. NOSPEC_BANDS Resets the grouping of SPEC_BANDS to single channels without any grouping. BSPECTRUM Displays the background count rate energy spectrum. RESTORE_DFLTS Reads the parameter values saved in the file given by the parameter, DFLTS_FILE. SAVE_DFLTS Saves the parameter values saved in the file given by the parameter, DFLTS_FILE. Use to save the setup for a particular data set. The file will be named in a systematic fashion if DFLTS_FILE is set to AUTO. CLEAR_UT Resets the timerange in the TIME HISTORY WINDOW to the limits of the vector UT, i.e. to the extent of the time interval covered by the current data set input through TIME_HISTORY. KLEANPLOT Runs the routine CLEANPLOT which resets the system plotting structures to their defaults. FORCE_APAR Sets the fitting parameters in each interval in the arrays APAR_ARR and APAR_LAST to the values in APAR. APAR_ARR and APAR_LAST are dimensioned fltarr( npar, nint) where npar is the number of parameters in the fitting model (see F_MODEL) and nint is the number of fitting time intervals (see the parameters XSELECT and WINT). COMMENTS Print recent messages about the status of SPEX including problem reports and new features. T_HIST_MODE Set the display mode for the TIME_HISTORY and GRAPH commands to COUNTS or FLUX to see the light curves in units of COUNTS/S or COUNTS/S/KEV/CM2, respectively. ? Get help on SPEX parameters, arrays, and commands. Syntax is ?, where is them name of a parameter, array, or command. Common Blocks: WINDOW_ARRAY($d) FLARE_CATALOG($d) FUNCTION_COM($d) Compiled Procedures: ACCUM ALPHA_PAGE APAR_CHECK BATSE_POINTING BREAK_FILE CALIBRATE CAL_SHER CHANNEL CHECKVAR COORD_CONV COPY_STRUCT DATPLOT DAYCNV DD_INIT DEFAULTS DRAW_FLARE DUMMYPLOTS EDGE_PRODUCTS EPLOT EX2INT FILE_SEARCHER FIND_PACKET FLARE_F_NAME FLDISPLAY FSELECT FS_ARCHIVE_DRAW FS_ARCHIVE_RW FS_OPEN FUNCT1 GAIN_COR GAUSS_FUNCT GETUT GET_CONVERSION GET_DISCSP511 GET_SPEC_GAIN GET_TRIG GRAPHICS_PAGE G_C HXRBS_FORMAT IEEE_TO_HOST INT2EX INTERVALS JDCNV JUMPER JUMPER_SHER LINECOLORS LOADCT LOAD_STRUCT OP_COM POINT READ_4_SPEX READ_CAT READ_COEF READ_CONT READ_FLARE READ_SEQFILE READ_SHER READ_SHERB REMOVE_MY_SAVED REMOVE_PATH RESET RUN_CURVEFIT RUN_FILE_SEARCH SDACLOG SETUT SETUTBASE SET_GRAPHICS SET_UTLABEL SET_UTPLOT SET_VTH_BPOW SHERS_LOAD SLED SPEC_PLOT STORE_PLOTVAR SXADDPAR T_UTPLOT UTPLOT VERT_LINE VERT_MARK WINUP WINUP_EV WSETSHOW XYPRO ZOOM_X Compiled Functions: ANYTIM ANYTIM2INTS ARR2STR ATIME AVG BACKGROUND BATSE_DEADTM BPOW BREM_49 BUILD_DRM BUILD_FNAME BURST_FLARE CHKLOG CH_SCALE CONCAT_DIR CONGRID CONT_EDGES CONV_VAX_UNIX2 CRANGE CROSSP CURVEFIT CURVFIT DATATYPE DERIV_ARR DIV FCHECK FCHISQR FCOLOR FCOUNT_RATE FCRYSTAL FILEPATH F_ATIME F_BPOW F_PDER F_VTH F_VTH_BPOW GAUSSFIT GETUTBASE GET_LAD_GAIN GET_MY_WINDOWS GET_SLLD GET_W64 GT_DAY GT_TIME HEADFITS INT2SEC INTERPOL LIMITS PARA_LIVETIME PARSE_COMLINE PL_SCALE POLY POLY_FIT READFITS READ_CONT_FITS REVERSE SC_SECONDS_ED SOLEPHUT SPHCART START_OF_DAY STR2ARR STRNUMBER SXPAR TEGFC TJD2YMD UTIME UTIME2STR XREGISTERED XYRADEC X_EOUT_DRM