PAGE_PRINT $SSW/cgro/batse/idl/page_print.pro
[Previous] [Next]

 NAME: 
	PAGE_PRINT

 PURPOSE:
 	Page_print was written to take the place of type/page.  Type/page is 
	a problem because you must first create a file of all the output and 
	then type it. This takes a long time, but mainly if the user 
	unknowingly asks for WAY too much data, a huge file will be created, 
	and it will take forever.  This routine prints lines into a file, 
	and if outprint is 0, to the terminal. It counts lines and when 18 
	lines have been printed, stops and waits for the user to either hit 
	return to continue printing, or type q to quit printing.

 CATEGORY:
	BATSE

 CALLING SEQUENCE:
	Page_print, outprint, count, lun, a1,...a15

 CALLS: ***
	ALPHA_PAGE [1], ALPHA_PAGE [2]
 INPUTS:
       Outprint: 0/1 means print to terminal/printer. In either case
		information is printed in file.
	Count: counts the number of lines printed so far.  
            	must be initialized to 0 in calling routine before first call.
	Lun: logical unit number of file to write to.
	a1,...a15: things to be printed (variables or strings)

 OUTPUTS:
       Count: counts the number of lines printed so far.  
            must be initialized to 0 in calling routine before first call.

 KEYWORDS:
       Abort: if user typed q then abort is set to 1 so the calling program 
		will know to quit printing (output).
	Format: format specification for print statement (input).

 CALLED BY:
	ASCII_RATES, ASCII_RAW, BATSE_ON, FLARE_LIST, FS_PRINT
 PROCEDURE:
       none

 MODIFICATION HISTORY:
 	Kim Tolbert   May 30, 1991
	Mod. by Amy Skowronek 94/07/11 - renamed from pprint to page_print
 	Mod. by Eric Carzon 5/14/96 - input variable a9 was missing!
	Mod. by RCJ 03/97 Rearranged documentation.


PARSE_GROSSC_ATTITUDE $SSW/cgro/batse/idl/parse_grossc_attitude.pro
[Previous] [Next]
 Project     : SDAC
                   
 Name        : PARSE_GROSSC_ATTITUDE
               
 Purpose     : This file reads the GROSSC email timeline format.
               
 Category    : CGRO, BATSE, EPHEMERIS
               
 Explanation : Reads and parses the file to extract the
	times of the pointing changes and the RA and DEC
	of the Z and X spacecraft axes.
               
 Use         : 
	parse_grossc_attitude, ut, zxradec

	w = where( ut(0,*) le (sys2ut()-4*86400.), nw)
	afirst = dblarr(nw)
	out=fltarr(5,nw)
	out(0,*)=ut(0,0:nw-1)
	out(1:*,*) = zxradec(*,0:nw-1)

	for i=0,nw-1 do begin
		pointing_change, out, i, first
		if first ne 0 then afirst(i) = first
		end
	end
    
 Inputs      : 
               
 Opt. Inputs : None
               
 Outputs     : Ut - Times (sec since 1-jan-1979) for 2 x Num_intervals.
		Zxradec- Spacecraft Z and X axis pointing in RA and DEC in degrees.
		
		

 Opt. Outputs: Wreboost - Indices into text of reboost lines.
               
 Keyword Inputs:
		BATSE - if set, use the BATSE team observing plan file
			DISK4:[MOPSDATA.SPACECRAFT_CONFIGURATION]OBSERVING_PLAN.DAT
		REBOOST- if set, include all the reboost elements and set 
 Keyword Outputs:
		TEXT - full parsed pointing file. 
 Calls	      : ***
	ARR2STR [1], Arr2Str [2], LOC_FILE [1], LOC_FILE [2], LOC_FILE [3], PATH_DIR
	STR2ARR [1], STR2ARR [2], STR_SEP, TJD2YMD, anytim [1], anytim [2], anytim [3]
	anytim [4], anytim [5], curdir [1], curdir [2], rd_tfile [1], rd_tfile [2]
 Common      : None
               
 Restrictions: Observing files must be installed in batse software tree or 
	BATSE_DATA or current directory.
               
 Side effects: None.
               
 Prev. Hist  :

 Modified    : 31-Oct-1997
	Version 2, richard.schwartz@gsfc.nasa.gov, exclude reboosts. 2-nov-1997.
	Version 3, richard.schwartz@gsfc.nasa.gov, keyword to use
	batse team observing plan file.


PEAK_MARK $SSW/cgro/batse/idl/peak_mark.pro
[Previous] [Next]

 NAME: 
       PEAK_MARK

 PURPOSE:


 CATEGORY:
       BATSE

 CALLING SEQUENCE:


 CALLS: ***
	ATIME [1], ATIME [2], CROSSBAR [1], CROSSBAR [2]
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


PICK_POINTING $SSW/cgro/batse/idl/occults/pick_pointing.pro
[Previous] [Next]
 Project     : 
                   
 Name        : PICK_POINTING 
               
 Purpose     : This procedure groups the occultation structures according to
  		the spacecraft pointing.           
 Category    : BATSE, OCCULTS 
               
 Explanation : The occultation structure carries the spacecraft Z and X axis
               attitudes.  Typically the pointing last 2-3 weeks which can yield
		20-30 occultations per day.  If the pointing vectors are within a 
		noise tolerance they are collected together.
 Use         : PICK_POINTING, Occ, Group
    
 Inputs      : 
		occ-occultation results structures, created and saved in MORE_OCCULTS, 
		read in READ_RESULTS2
               
 Opt. Inputs : None
               
 Outputs     : 
		group- Grouping structure for occultations with three tags
			cos04- The four detector cosines facing the source, ordered
			top to bottom
			ut_occ-The time of the first occultation in each group		
			wocc- An array of 500 indices referencing occ, 
 Opt. Outputs: None
               
 Keywords    : INRADEC- RA and DEC of source in degrees.  Default is the Crab, J2000.

 Calls       : ***
	CHECKVAR [1], GRO_POINT, checkvar [2]
 CALLED BY:
	OCC_AVG
 Common      : None
               
 Restrictions: 
               
 Side effects: None.
               
 Prev. Hist  : Version 1, RAS, 10-Dec-1996

 Modified    : Version 2, RAS, 13-dec-1996, use lad cosines for nchan gt 2


PLOT_CRAB $SSW/cgro/batse/idl/occults/plot_crab.pro
[Previous] [Next]

 NAME: 
       PLOT_CRAB

 PURPOSE:
       This is a main program used to display occultation results for the Crab
       to try to examine cuts on the database made in angle and energy.

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	RESISTANT_Mean [3], Resistant_Mean [1], Resistant_Mean [2], ZOOM_COOR [1]
	linecolors [1], linecolors [2], zoom_coor [2]
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	discsp_crab.sav must be in the current directory.

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, Dec 1995.


PLOT_DISCSP_CRAB $SSW/cgro/batse/idl/occults/plot_discsp_crab.pro
[Previous] [Next]

 NAME: 
      PLOT_DISCSP_CRAB

 PURPOSE:
      This main program displays the measured countrates vs energy
      and overlays the figure with the predicted countrates

 CATEGORY:
      BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	none
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, ras, 7 June 1996


PLOT_DRM $SSW/cgro/batse/idl/plot_drm.pro
[Previous] [Next]

 NAME: 
       PLOT_DRM

 PURPOSE:


 CATEGORY:
       BATSE

 CALLING SEQUENCE:


 CALLS: ***
	PICKFILE, READ_COMPRESSED
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


PLOT_FLARE $SSW/cgro/batse/idl/plot_flare.pro
[Previous] [Next]
 PROJECT:
	SDAC
 NAME: 
       PLOT_FLARE

 PURPOSE:
	This procedure displays a background subtracted count rate.

 CATEGORY:
       BATSE

 CALLING SEQUENCE:
	plot_flare, flare=iflare, archive=archive, channels=channels, close=close

 CALLS: ***
	ATIME [1], ATIME [2], CHKLOG [1], CHKLOG [2], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], FCHECK, FIND_DBFILE, FSDEF, FS_ACC, FS_ARCHIVE_RW, FS_GEN_ARR
	FS_GRAPH, FS_OVERLAY, READ_FLARE, SETUT [1], SETUT [2], concat_dir [4]
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORD INPUTS:
	FLARE- Plot this flare.
	ARCHIVE- Create archive plot with channel 0 and 1 saved if set.
	CHANNELS- Plot these channels separately, may use any channels input as
	an array of integers.  Shown for detectors 1 and 2.
	ALLTIME- Plot the full event duration including background.
	CLOSE- Close the file on exit.
	NOWRITE - Don't write the archive file.
 CALLED BY:
	DO_ARCHIVEPLOTS, DO_PSPLOTS, FSPLOT, FS_AUTO_LOG
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
 Modified 7/7/94 by Amy Skowronek to have detectors as 0-7, channels as 0-1.
 Modified 7/8/94 by AES to set dd_type to discla before opening a flare
 file, so can't accidentally get CONT data for discla plot.  Resets 
 ddtype to original when done opening file.
	Version 4, RAS, 29-apr-1997, Added channels and close keywords.
       Version 5, AES, 9-oct-1997, Added gif keyword
 Version 6, richard.schwartz@gsfc.nasa.gov, 8-apr-1998.  Added ALLTIME and NOWRITE keyword.
 Version 7, amy.skowronek@gsfc.nasa.gov, 22-jun-1998.  added command to delete
	     empty save file created when openw is done to check to see if 
	     file is opened.  (under vms only)


PLOT_LDEDGES $SSW/cgro/batse/idl/plot_ldedges.pro
[Previous] [Next]
 PROJECT:
	SDAC
 NAME: 
	PLOT_LDEDGES

 PURPOSE:
	This Main program plots the histograms of the DISCLA/CONT channel
	relationship.

 CATEGORY:
	BATSE

 CALLING SEQUENCE:
	.r plot_ldedges

 CALLS:
	none
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, richard.schwartz@gsfc.nasa.gov, 23-feb-1998


PLOT_OCC_ONDAY $SSW/cgro/batse/idl/occults/plot_occ_onday.pro
[Previous] [Next]

 NAME: 
       PLOT_OCC_ONDAY

 PURPOSE:
       Early software for analyzing occultations in DISCSP

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS: ***
	ATIME [1], ATIME [2], AVG [1], AVG [2], CHECKVAR [1], CRANGE, DN_TRANS, FCHECK, F_DIV
	GETUTBASE [1], GETUTBASE [2], READ_OCC_DISCSP, SETUTBASE [1], SETUTBASE [2]
	UTPLOT [1], UTPLOT [2], UTPLOT [3], UTPLOT [4], UTPLOT [5], UTPLOT [6], anytim [1]
	anytim [2], anytim [3], anytim [4], anytim [5], checkvar [2], linecolors [1]
	linecolors [2]
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	THIS IS OBSOLETE AND NO LONGER SUPPORTED.

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	written July 1995
	Version 2, ras, June 1996 with documentation


PLOT_OCCS $SSW/cgro/batse/idl/occults/plot_occs.pro
[Previous] [Next]

 NAME: 
       PLOT_OCCS

 PURPOSE:
       This procedure controls the extraction of the source occultation steps from the
       raw data files and displays the fitted model including the occultation step.

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:
	plot_occs, occout=occout, occtime=occtime, $
	start_time=start_time, end_time=end_time, daynight=daynight, $
	nsum=nsum, inrange=inrange, tdur=tdur, ord=ord, step=step, $
	cont=cont, file = file, det_id=det_id, ntop=ntop, tmin=tmin, cut=cut


 CALLS: ***
	AVG [1], AVG [2], CHECKVAR [1], CLEAR_UTPLOT [1], CLEAR_UTPLOT [2], CRANGE
	DATATYPE [1], DATATYPE [2], DATATYPE [3], FCHECK, OCC_FILETYPE, READ_CONT
	READ_OCC_DISCSP, REGRESSION, SETUTBASE [1], SETUTBASE [2], SIGMA, UTPLOT [1]
	UTPLOT [2], UTPLOT [3], UTPLOT [4], UTPLOT [5], UTPLOT [6], anytim [1], anytim [2]
	anytim [3], anytim [4], anytim [5], checkvar [2], linecolors [1], linecolors [2]
 INPUTS:
       occout: a structure with the tags
	start_time, end_time, daynight, occtime, det_id

	or input directly through keywords
       start_time: start time for dataset, seconds from 1-jan-1979
       end_time:    end time for dataset
       daynight:    if 1 then this occultation goes from spacecraft night to day
       occtime:     midpoint of occultation extinction in seconds from 1-jan-1979
       det_id:       detector ID
       
       nsum:    sample average for display [4]
       inrange: yrange for display
       tdur:      include this many seconds around both sides of step in fit [60.]
       ord:       order of polynomial model used for background [1]
       tmin:     exclude this many seconds on each side of occultation step [8.]
       cut:       exclude points from the fit which exceed this number of standard
                    deviations in the model fit.
       priority: specifies database order for discsp, default: ['occ_discsp','.discsp','discsp_msfc']
 OPTIONAL INPUTS:
	none

 OUTPUTS:
       STEP: fltarr(3, nchans)
	For each channel the occultation step count rate(/sec) returned from the regression as well
	as the sigma for the fit. Third value is the average count rate (/sec) at the
	time of the fit.

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	noplot - don't plot
 CALLED BY:
	MORE_OCCULTS
 COMMON BLOCKS:
	plot_occs

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	Currently limited to CONT, DISCLA, and DISCSP data

 PROCEDURE:
	Data are read channel by channel.  For each channel the data are fit to a 
	model including a polynomial in time for the background as well as
	a step in the countrate at the time of the occultation excluding the
	interval 2*tdur centered on the occultation itself.  Outliers are excluded
	from the fit above cut.

 MODIFICATION HISTORY:
	Version 1, ras, 6-June-1996
	Version 2, ras, 23-Sept-1996
	Version 3, ras, 27-Sept-1996 added bdb files for DISCLA


PLOT_OCCS_RES $SSW/cgro/batse/idl/occults/plot_occs_res.pro
[Previous] [Next]

 NAME: 
       PLOT_OCCS_RES

 PURPOSE:
       This procedure plots out the database of occultation results and
        uses symbols based on the zenith angle (detector cosine) to the source.

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS: ***
	FCHECK
 INPUTS:
       X - usually the lower energy edge of a channel in keV, generally at least one
	days observations are averaged for every data point
       Y - usually the observed occultation step count rate
       Cosines - detector cosine for each observation
       Coslims - upper and lower limits on the cosine range for the plot, to be
	subdivided into steps of 0.1
 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 CALLED BY:
	PLOT_RESULTS [2], PLOT_THRESH
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, ras, June 1996


PLOT_RATIOS $SSW/cgro/batse/idl/occults/plot_ratios.pro
[Previous] [Next]

 NAME: 
       PLOT_RATIOS

 PURPOSE:
       Not a main program or procedure but an include block
       used by PLOT_RESULTS.PRO

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	none
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 CALLED BY:
	PLOT_RESULTS [2]
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, ras, august 1995


PLOT_RESPONSE $SSW/cgro/batse/idl/occults/plot_response.pro
[Previous] [Next]

 NAME: 
       PLOT_RESPONSE

 PURPOSE:
       This code is under development for looking at the results of the
       occultation analysis vs angle and energy for the CRAB DISCSP data

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	none
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


plot_results [1] $SSW/cgro/batse/idl/occults/plot_results.pro
[Previous] [Next]
  Name:
       PROCEDURE: 
               PLOTDATE
       PURPOSE:
               This procedure puts the user name, calling program and system 
               time and date in the corner of a plot.  
       CALLING SEQUENCE:
               plotdate, Prog, [Charsize=, Charthick=,/device,/data, /normal]
       OPTIONAL INPUTS:
               PROG -- Character string containing the name of the calling
                       program (Default = 'INTERACTIVE')
       KEYWORD INPUTS:
               SIZE -- Specify the character size.  (Default = 0.35)
               X, Y -- Location to put the string.  (Default is lower right 
                       corner, depedning on the current device size).  
               DEVICE -- If present and non-zero, X and Y are in DEVICE 
                         coordinates.  Ignored if X, Y are not both specified.
                         (Default = 1)
               DATA -- If present and non-zero, X and Y are in DATA 
                       coordinates.  Ignored if X, Y are not both specified.
                       (Default = 0)
               NORMAL -- If present and non-zero, X and Y are NORMALIZED
                         coordinates.  Ignored if X, Y are not both specified.
       NOTE: Only one of [DEVICE, DATA, NORMAL] should be specified.  For 
             more information regarding these parameters, check documentation
             of XYOUTS.
       REVISION HISTORY
               Modified from RCB::[BOHLIN.IDL]PLOTDATE.PRO 
               90DEC22-CHANGE XYOUTS FOR V2 AND SIMPLIFY-RCB
               Converted for general use in MOUSSE.  Keywords added, user name
               obtained from OS rather than hard-coded.   
               Joel D. Offenberg, HSTX, 26-Mar-93


PLOT_RESULTS [2] $SSW/cgro/batse/idl/occults/plot_results.pro
[Previous] [Next]

 NAME:
	PLOT_RESULTS

 PURPOSE:
	This is a main program for looking at the total BATSE DISCSP CRAB
	occultation database

 CATEGORY:
	BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	LEGEND [1], LEGEND [2], LEGEND [3], LOC_FILE [1], LOC_FILE [2], LOC_FILE [3]
	PLOT_OCCS_RES, PLOT_RATIOS, WDEF [1], WDEF [2], get_subdirs [1], get_subdirs [2]
	plotdate
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
       none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
       none

 KEYWORDS:
       none
 COMMON BLOCKS:
       none

 SIDE EFFECTS:
       none

 RESTRICTIONS:
       none

 PROCEDURE:
       none

 MODIFICATION HISTORY:


PLOT_THRESH $SSW/cgro/batse/idl/occults/plot_thresh.pro
[Previous] [Next]

 NAME: 
       PLOT_THRESH

 PURPOSE:
	This main program plots the DISCSP CRAB occultation results
	showing one figure with the measure countrates and another
	with the predicted as a function of channel edge in keV

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	PLOT_OCCS_RES
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:
	Version 1, RAS, august 1996


PLOTBATSE $SSW/cgro/batse/idl/plotbatse.pro
[Previous] [Next]

 NAME: 
       PLOTBATSE

 PURPOSE:


 CATEGORY:
       BATSE

 CALLING SEQUENCE:


 CALLS: ***
	ATIME [1], ATIME [2], AVG [1], AVG [2], BREAK_FILE [1], BREAK_FILE [2]
	BREAK_FILE [3], CRANGE, DISCSP_EDGES, DISCSP_READ, FCHECK, FDBREAD, GETUTBASE [1]
	GETUTBASE [2], HAVE_WINDOWS [1], HAVE_WINDOWS [2], SET_GRAPHICS [1]
	SET_GRAPHICS [2], UTIME [1], UTIME [2], UTPLOT_IO [1], UTPLOT_IO [2]
	UTPLOT_IO [3], anytim [1], anytim [2], anytim [3], anytim [4], anytim [5]
	batse_read_cat, break_file [4], goesplot
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


PLOTBATSE_QL $SSW/cgro/batse/idl/plotbatse_ql.pro
[Previous] [Next]

  Name:
       PLOTBATSE_QL


 PURPOSE:  Plot to compare BATSE DISCSP & DISCLA with GOES on
	orbit-based time intervals


 CATEGORY: BATSE, time-histories


 CALLING SEQUENCE:
	plotbatse_ql, indate, orbit=orbit, discsp_dates=all_dates, nolog=nolog, $
	cos_lad=cos_lad, cos_spec=cos_spec, edges_discsp=edges, specs_used=specs, $
	error=error

 CALLED BY:


 CALLS: ***
	AVG [1], AVG [2], CRANGE, DATATYPE [1], DATATYPE [2], DATATYPE [3], DISCSP_EDGES
	FCHECK, FDBREAD, FIX_DISCSP2, GETUTBASE [1], GETUTBASE [2], HAVE_WINDOWS [1]
	HAVE_WINDOWS [2], LAD_2_SPEC, OCC_DBASE, PARSE_ATIME [1], READ_DISCSP
	RESTORE_QLOOK, SETUP_BATSE_ARRAYS, SETUTBASE [1], SETUTBASE [2]
	SET_GRAPHICS [1], SET_GRAPHICS [2], UTPLOT [1], UTPLOT [2], UTPLOT [3], UTPLOT [4]
	UTPLOT [5], UTPLOT [6], anytim [1], anytim [2], anytim [3], anytim [4], anytim [5]
	batse_read_cat, goesplot, parse_atime [2]
 INPUTS:
       indate - date of data to use
       orbit  - orbit number to plot, generally 0-15
	
 OPTIONAL INPUTS:
	nolog - if not set, log of count rates plotted, if set linear count rates
	stopit- if set, procedure stops before returning	
	timerange- two times in anytim readable format giving the start and stop times
		for the plot window
	yranges- a structure with up to three keywords, yranged1, yranged2, yrangeld
		each a 2-element vector giving the plot range for the lower discsp, upper discsp
		and discla plot boxes
	ispecs - an intarr specifying the spec detectors to use in the plot
 OUTPUTS:
       discsp_dates - available dates of discsp data, no longer supported
		use occ_dbase('.discsp',date=date) and occ_dbase('discsp_msfc',date=date)
		to determine which dates have discsp data and occ_dbase('.bdb',date=date)
		for .bdb files
	cos_lad      - lad detector cosines for this orbit
	cos_spec     - spec detector cosines for this orbit
	edges_discsp - edges (keV) for discsp at this time
	specs_used   - ids of specs used in plots
	error        - if set, then there was a data acquisition problem
 OPTIONAL OUTPUTS:
	td           - discsp time
	yd           - discsp count/rates in two channels summed over specs_used
	ut           - discla time array
       youts        - various discla rates, see ylabels in restore_qlook.pro
	tg           - goes time array
	yg           - cleaned goes fluxes

 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	if the discsp data isn't there, there won't be a plot
	only implemented on sdac with some hard coded file directories for
	the discsp
 PROCEDURE:
	read in the data and plot it 

 MODIFICATION HISTORY:
 	ras, 14-sep-1995
	ras, 21-sep-1995 use fix_discsp2 for overflow,too.
	ras, 15-nov-1995, uses bdb files if they are available for
	LAD data
	ras, 16-feb-1996, fix tjd extraction for discsp
	ras, 27-mar-1996, use setup_batse_arrays
	ras, 3-sep-1996, added msfc files to data_disk0:[smmcat.batse_discsp]
	ras, 15-oct-1996, changed .bdb and discsp locator to occ_dbase
		added timerange keyword, deleted discsp_dates keyword,
		added yranges, added ispecs
	richard.schwartz@gsfc.nasa.gov, 18-dec-1998, trap errors on discsp read.


Pointing_Change $SSW/cgro/batse/idl/pointing_change.pro
[Previous] [Next]
 Project     : SDAC
                   
 Name        : Pointing_Change
               
 Purpose     : Finds changes in BATSE pointing.
               
 Category    : CGRO, BATSE, EPHEMERIS
               
 Explanation : The quicklook orbital files are examined around
	the input dat  Times are cited for changes in spacecraft
	position more than the input value given in degrees.  Default
	is 2 degrees.
               
 Use         : Pointing_change, out, test_row, first_valid 
    
 Inputs      : Out- the Batse pointing info array, obtained from
		the COSSC web pages, encoded as in GET_BATSE_POINTING.
		Test_row - Out is a fltarr( 5, nrows ), 
		test_row is the index into out.  Testing for orbits
		where the cosines in the quick-look archive file
		are consistent with this spacecraft orientation.
               
 Opt. Inputs : None
               
 Outputs     : First_Valid - first midnight of orbit that is consistent
		with the spacecraft orientation, within 1 degree.  Expressed in
		seconds from 1-jan-1979.

 Opt. Outputs: None
               
 Keywords    : 
		OFFSET- Tolerance of pointing error, default is 1 degree.
 Calls       : ***
	ATIME [1], ATIME [2], CHECKVAR [1], GRO_POINT, MINMAX [1], MINMAX [2], RESTORE_QLOOK
	SOLEPHUT, anytim [1], anytim [2], anytim [3], anytim [4], anytim [5], batse_read_cat
	checkvar [2], uniqo [1], uniqo [2]
 Common      : None
               
 Restrictions: 
               
 Side effects: None.
               
 Prev. Hist  :

 Modified    : 
	Version 1, richard.schwartz@gsfc.nasa.gov, 29-oct-1997.
	Version 2, richard.schwartz@gsfc.nasa.gov, adjusted search range 2-nov-1997.


POLYZ $SSW/cgro/batse/idl/polyz.pro
[Previous] [Next]

 NAME: 
       POLYZ

 PURPOSE:


 CATEGORY:
       BATSE

 CALLING SEQUENCE:


 CALLS: ***
	POLY
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 CALLED BY:
	FIND_TANGENT
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


pro ratesdump $SSW/cgro/batse/idl/ratesdump.pro
[Previous] [Next]
 Name:
 pro ratesdump
 Purpose:
 Dumps BATSE rates data between selected times.

 CALLS: ***
	ASCII_RATES, FILELIST, LOC_FILE [1], LOC_FILE [2], LOC_FILE [3], MORE [1], MORE [2]
	Mailfile, PATH_DIR, RATESDUMP, RATESDUMPOC, READ_SEQFILE, YOHKOH_FORMAT [1]
	YOHKOH_FORMAT [2], curdir [1], curdir [2], hxrbs_format, yohkoh_format [3]
 History:
 Kim Tolbert   10/8/91

 Mod. 8/18/94 by AES to use getenv instead of trnlog
      4/5/95 by AES - usefdb had been left out of dumpcom declaration -
      added it so it would work with rawdump.
 Version 4, ras, 27-mar-1996, removed setup_arrays (now setup_batse_arrays)
	not needed.
 VERSION 5, richard.schwartz@gsfc.nasa.gov, 26-aug-1997,
 used loc_file with path_dir('batse') to locate help files.
 Version 6 - eva@kano.nascom.nasa.gov, 09-Feb-2000
			 - Increased default time-range from 10s to 15s


PROCESS_CRAB_RESP $SSW/cgro/batse/idl/occults/process_crab_resp.pro
[Previous] [Next]

 NAME: 
       PROCESS_CRAB_RESP

 PURPOSE:
       This main program obtains the predicted Crab flux for each observation
        in the database as a function of angle and energy.  Should not be used
        now, but components of this procedure may be examined and cannibalized

 CATEGORY:
       BATSE, OCCULTS

 CALLING SEQUENCE:


 CALLS:
	none
 INPUTS:
       none explicit, only through commons;

 OPTIONAL INPUTS:
	none

 OUTPUTS:
       none explicit, only through commons;

 OPTIONAL OUTPUTS:
	none

 KEYWORDS:
	none
 COMMON BLOCKS:
	none

 SIDE EFFECTS:
	none

 RESTRICTIONS:
	none

 PROCEDURE:
	none

 MODIFICATION HISTORY:


PROCESS_SLLD_DBASE $SSW/cgro/batse/idl/process_slld_dbase.pro
[Previous] [Next]

 NAME: 
	PROCESS_SLLD_DBASE

 PURPOSE:
	Produce a complete set of BATSE SPEC LLD changes and write to
	a file starting from a more primitive database file.

 CATEGORY:
	BATSE

 CALLING SEQUENCE:
	PROCESS_SLLD_DBASE, Infile, Outfile

 CALLED BY:


 CALLS: ***
	PARSE_ATIME [1], RD_TEXT, SC_SECONDS_ED, parse_atime [2]
 INPUTS:
       Infile - name of database file prepared from extract and extract_slld
	using the jukebox platters at MSFC

 OUTPUTS:
       Outfile - file to write results into

 PROCEDURE:
	Original file is culled of redundant entries and apparent telemetry glitches.

 MODIFICATION HISTORY:
	ras, 2-jan-1996
	Version 2, ras, 4-dec-1996