6.  Wide Band Spectrometer (WBS)

6.1  Routines for Making Time Plots

6.1.1 PLOTT_WDA

PLOTT_WDA will make a light curve plot for all channels using either the index or roadmap. The second `T' signifies that it is a time plotting routine. Seven plots are made, one for each channel. Some sample calls are:
IDL >  plott_wda, index

IDL >  plott_wda, roadmap

IDL >  plott_wda, roadmap(100:200), psym=10

6.2  Routines for Making Spectral Plots

6.2.1 PLOTS_WDA

PLOTS_WDA is a very rudimentary plotting routine that will display the spectra for any of the WBS sub-instruments. It is interactive and will prompt the user for which sub-instrument to display, and which datasets. A sample call is:
IDL >  plots_wda, index, data

6.3  Routines for 2-D Spectral Display

6.3.1 DISP_WDA

The evolution of all of the WBS spectra against time can be displayed as a pseudo-image using the routine DISP_WDA. Note: The time axis of DISP_WDA is not uniform.
IDL >  disp_wda, index, data

6.3.2 SXSPC

SXSPC makes the time profiles of SXS-PC11, PC12, PC-21, and PC22 with various options3.
IDL >  pc_data= sxscv(data, index)

IDL >  sxspc,pc_data,index

6.3.3 WBSPC

WBSPC makes four counting rate time profiles of SXS-PC11(21), SXS-PC12(22), HXS-PC1 and HXS-PC2.
IDL >  wbspc,data,index

6.3.4 PLOT_HXSPC

PLOT_HXSPC makes a counting rate time profile of HXS-PC1, HXS-PC2 or HXS-PC1 + PC2 with UTPLOT.
IDL >  plot_hxspc,index,data,pc

6.3.5 PLOT_HXSPH

PLOT_HXSPH makes a counting rate time profile of HXS-PH with UTPLOT. You choose the energy or channel range.
IDL >  plot_hxsph,index,data,range=range

IDL >  plot_hxsph,index,data,channel=channel

6.3.6 PLOT_GRSPCL

PLOT_GRSPCL makes a counting rate time profile of GRS-PC11, PC12, PC21 or PC22 with UTPLOT.
IDL >  plot_grspcl,index,data,pc

6.3.7 PLOT_GRSPCH

PLOT_GRSPCH makes a counting rate time profile of GRS-PC13, PC14, PC15, PC16, PC23, PC24, PC25 or PC26 with UTPLOT.
IDL >  plot_grspch,index,data,pc

6.3.8 PLOT_GRSPHL

PLOT_GRSPHL makes a counting rate time profile of GRS-PHL1 or GRS-PHL2 with UTPLOT. You choose the energy or channel range.
IDL >  plot_grsphl,index,data,ph=1,range=range,channel=channel

6.3.9 PLOT_GRSPHH

PLOT_GRSPHH makes a counting rate time profile of GRS-PHH1 or GRS-PHH2 with UTPLOT. You choose the energy or channel range.
IDL >  plot_grsphh,index,data,ph=1,range=range,channel=channel

6.3.10 Light Curve of RBM-PC

See the description in the User's Guide.

6.4  Routines for Data and Information Extraction

6.4.1 GT_ Routines

The routines GT_SXS1, GT_SXS2, GT_HXS, GT_GRS1, GT_GRS2, GT_RBMSD, and GT_RBMSC routines will extract the average counts/sec for the selected channel.

SXS1 Only SXS_PC21 3-15 keV
SXS2 Only SXS_PC22 15-40 keV
HXS HXS_PC1 plus HXS_PC2 20-657 keV
GRS1 GRS_PC11 plus GRS_PC21 0.3-1.2 MeV
GRS2 GRS_PC12 plus GRS_PC22 1.2-5.6 MeV
RBMSD PC1 plus PC2 5-300 keV
RBMSC Only RMSSC > 20 keV

The input can be roadmap, index, or observing log and it will get the proper structure tag and decompress it properly to return counts/sec/sensor. It is possible to get a string defining the channel selected by using the title keyword option.
IDL >  y = gt_sxs1(roadmap)

IDL >  y = gt_hxs(w_h, title=title)

6.4.2 GET_INFO

See the description in the ``General Yohkoh Software'' chapter on page 2.4.5.

6.5  Routines for Calibration and Analysis

6.5.1 HXS_FSP [*]

With HXS_FSP you interactively choose data intervals, and fit the HXS spectrum, using the routine fsp_11.pro. index and data are the WBS index and data structures. fit_pars is the structure containing the results. Optional parameters are - sc_par is a structure containing spectrometer channel information, ch_dta is a structure containing the data for each channel, outfile and pfile are filenames for printouts and plots, respectively; countfile is a filename, if this option is set, the count rates are printed into that file which may be fit by the routine FSP_PROC described above.
IDL >  HXS_FSP, index, data, fit_pars

IDL >  HXS_FSP, index, data, fit_pars, sc_par, ch_dta

IDL >  HXS_FSP, index, data, outfile=outfile

IDL >  HXS_FSP, index, data, pfile=pfile

IDL >  HXS_FSP, index, data, countfile=countfile

IDL >  HXS_FSP, index, data, fit_pars, sc_par, ch_dta, sdel=sdel

6.5.2 HXS_SPL

HXS_SPL makes a HXS spectrum fitted by single power law. You interactively choose the background and flare time intervals for the spectral analysis.
IDL >  hxs_spl,data,index

6.5.3 HXS_SP2

HXS_SP2 makes HXS spectrum fitted by double power law in a similar way to HXS_SP1.
IDL >  hxs_sp2,data,index

6.5.4 GRS_SPEFF

GRS_SPEFF makes preliminary GRS-1 and 2 spectra (0.3 - 100 MeV).You interactively choose the flare and background time intervals for the spectral analysis. The flux of each channel is calculated by dividing the counts by full energy absorption efficiency. The first three channels data of GRS-1 and the four channels of data of GRS-2 are not plotted because these channel widths are not exactly determined.
IDL >  grs_speff,data,index,ph=1,/disp

IDL >  grs_speff,data,index,ph=2,/disp

IDL >  grs_speff,data,index,ph=1,fltime=fltime,bgtime=bgtime

6.5.5 Further Analysis of HXS and GRS Data

There are several routines for further HXS and GRS data analysis. With these routines you can get the following:

See the detailed description in the User's Guide.

6.6  Instrument Response Files

The instrument response files for SXS, HXS and GRS are listed here. These files are ASCII files and are located in $DIR_WBS_CAL.

6.6.1 SXS

dtcorrf.dat Table of the deadtime correction factor vs. counting rates of SXS-PC11, PC12, PC21 and PC22

6.6.2 HXS

hxs_01.rel Table of channel number (0 - 31) vs. energy (keV) relation for HXS- PH for HXS-OS of ``01 (hex)". (1992 June 9 - present).

hxs_21.rel

Table of channel number vs. energy relation for HXS-PH for HXS-OS of ``21 (hex)". (1991 Oct. 1 - 1992 June 9).

hxs_01_conv260.rel

Table of incident photon energies (keV) corresponding to the 260 rows of the 260 x 32 response matrix for HXS-PH spectral analysis for HXS-OS of ``01 (hex)". (1992 June 9 - present).

hxs_21_conv260.rel

Table of incident photon energies (keV) corresponding to the 260 rows of the 260 x 32 response matrix for HXS-PH spectral analysis for HXS-OS of ``21 (hex)". (1991 Oct. 1 - 1992 June 9).

hxs_01_conv260.resp

260 (row) x 32 (column) response matrix for HXS-PH spectral analysis for HXS-OS of ``01 (hex)". The row and column represent the incident photon energy and observed channel number, respectively. The matrix elements of i-th row represent a response function for incident photons of i-th energy in hxs_conv260.rel.

hxs_21_conv260.resp

260 (row) x 32 (column) response matrix for HXS-PH spectral analysis for HXS-OS of ``21 (hex)". This is similar to hxs_01_conv260.resp.

dtcf_pc_hxs.pro

Deadtime correction factor for HXS-PC1 and PC2. The correction is not exact when the deadtime-corrected count of total PC exceeds about 100,000 counts/sec. It is due to instrument limitation.

dtcf_ph_hxs.pro

Deadtime correction factor for HXS-PH. The correction is not exact when the deadtime-corrected count of total PH exceeds about 35,000 counts/sec. In addition, spectral distorsion occurs when the deadtime-corrected count of total PH exceeds about 21,000 counts/sec. It is due to instrument limitation.

6.6.3 GRS

grs1_40.rel Table of channel number (0 - 127) vs. energy (keV) relation for GRS- 1 for GRS1-OS of ``40 (hex)". (1991 Oct.1- present). Energy widths of the first 3 channels are not exact.

grs2_40.rel

Table of channel number (0 - 127) vs. energy (keV) relation for GRS-2 for GRS2-OS of ``40 (hex)". (1991 Oct.1- present). Energy widths of first 4 channels are not exact.

grs1_40_conv260.rel

Table of incident photon energies (keV) corresponding to the 260 rows of the 260 (row) x 128 (column) response matrix for GRS- PHL1 spectral analysis.

grs1_40_conv260.resp

260 (row) x 128 (column) response matrix for GRS-PHL1 spectral analysis. The row and column represent the incident photon energies and observed channel number, respectively. The matrix elements of i-th row represent a response function for incident photon of i-th energy in grs1_conv260.rel.

grs2_40_conv260.rel

Table of incident photon energies (keV) corresponding to the 260 rows of the 260 (row) x 128 (column) response matrix for GRS- PHL2 spectral analysis.

grs2_40_conv260.resp

260 (row) x 128 (column) response matrix for GRS-PHL2 spectral analysis. This is similar to grs1_conv260.resp.

dtcf_ph_grs11.pro

Deadtime correction factor for GRS-PHL1.

dtcf_ph_grs21.pro

Deadtime correction factor for GRS-PHL2.