Averaging Procedures for the 3Helium Project

The following commands are in directory:  ../rtr/  They are reasonable general and can
be used to average TP PS data for many sources observed over many days.  That are not,
however, part of the v3.2 GBT_IDL standard release.

AVGNS     AVLOG     BAM        CATNS      CMARKER    DAZE      EDITNS    PUTAVNS
SELECTNS  START_SRC START_DAY  START_EPOCH 


start_epoch          Prompts for epoch label
                     If argument is omitted it will prompt
                     Syntax: start_epoch,'JN04'
                     -------------------------

start_day,day        Prompts for daily average setup parameter
                     If argument is omitted it will prompt
                     Syntax: start_day,'D1'  
                     ---------------------

start_src,srcname    Make a daily average for a specific source.   
                     Does the average for all 8 receivers.
                     If argument is omitted it will prompt
                     Syntax: start_src,"source_name" 
                     ------------------------------

bam                  ACCUM and AVE the records in the STACK
                     Displays each scan pair and offers option
                     of deleting it from the average (i.e. no ACCUM)              
                     Syntax: bam 
                     -----------

wham,nrx1,nrx2,pol   Make daily average with editing capability.
                     if  0 parameters:  defaults to all rx's
                         1           :  sets start_rx = end_rx
                         2           :  assumes both pols to be done
                         3           :  one polarization only
                     Syntax: wham, rx_to_start, rx_to_end,  no_pols_to_process
                     ---------------------------------------------------------

cmarker,nrx          Plots line id flags for input receiver, nrx
                     Syntax: cmarker,nrx
                     -------------------

putavns,ns           Save buffer 0 to NSAVE region specified by !nsave                    
                     Similar to PUTNS **BUT** changes scan number to NSAVE
                     slot number and offers option of overide of write protection
                     N.B. SAVE is an IDL command!
                     
                     !nsave_log[!nsave] is 1 if the !nsave slot has been written to
                     if ( (!protectns eq 1) and (!nsave_log[!nsave] ne 0) ) then 
                     offers option of override
                     Syntax: putavns,ns
                     ------------------

daze                 ACCUM and AVE the NSAVEs in the STACK
                     Displaying each NSAVE and offer option
                     of deleting it from the average (i.e. no ACCUM)
                     Syntax: daze
                     ------------

avlog,ns1,ns2        Print average information for NSAVE data records
                     Similar to NSLOG but gives more information 
                     related to daily averages.
                     If no input parameters it lists everything,
                     else lists only nsaves between ns1 & ns2
                     Syntax: avlog,ns1,ns2
                     ---------------------

selectns             Search the NSAVE data file and load STACK with 
                     nsave locations that match various selection criteria.
                     ALL searches are made on strings. 
                     Matches input string exactly.
                ==>  Currently the possible choices are: <==
                        Source Name   'W3'           !src
                        Data type     'JN04_D1'      !typ
                        Line ID       'HE3'          !id
                        Polarization  'LCP'          !pol
                     Syntax: selectns
                     ----------------

catns                List contents of STACK  catalog of NSAVE records.
                     Uses the AVLOG format.
                     Syntax: catns
                     -------------

setns                Sets parameter values for selection filtering of
                     data type.  Tailored for selecting on the NSAVE
                     data file which normally contains processed data.
                     Syntax: setns
                     -------------

avgns                ACCUM and AVE the NSAVE records in the STACK.  
                     Batch mode version; NO editing allowed.
                     Syntax: avgns
                     -------------

epave,npol           Make epoch average with editing capability.
                     Defaults to !this_epoch or asks.
                     Asks to set SOURCE and LINE ID.
                     Ask if you want to do a new source.
                     If npol not input defaults to LCP, RCP, and 
                     L+R averages.
                     else npol=1 -> LCP
                               2 -> RCP
                               3 -> R+L

editns,ns1,ns2       Edit the NSAVE file in some fashion.
                     You must change the procedure code to do what
                     you want.  Useful for fixing mistakes.
                     ns1,ns2 are the NSAVE slot range.
                     Default is everything.