DSDLCURVE (Aug)                    99                    DSDLCURVE (Aug)




    NAME   dsdlcurve -- reads heao1 scanning data and creates scan files
    centered at  chosen targets using selected  scalar  rates  from  the
    MED and HED3  detectors.
    
    

    USAGE    equinox  ra  dec  infile  rootname  beta ivwoff daily_effic
      iclwt1 sc_mode sc_wt1 sc_wt2 sc_wt3 sc_wt4 sc_wt5 sc_wt6    sc_wt7
    sc_wt8  det_select  det_no  anti_coeff  anti_mode  anti_wt   (tchat) 
    (lchat) (clobber) (mode)
    
    

    DESCRIPTION  This  program  accumulates  scanning  profiles  in  the
    vicinity  of  a  given   object's  position, and indicates the times
    when the source was  in  view.    It  uses  the  DSDISK  data  which
    consists  of  two  files:  one for the large  (3.0 x 3.0 degree) and
    one for the small (1.5 x 3.0 degree)  field  of  view   (FOV).  Each
    file  includes  counts  only for the HED3 and MED detectors (part of
     the HEAO1 A2 experiment) in four energy bands (known  as  discovery
    scalars)   taken  during the mission lifetime.   DSDLCURVE processes
    only one file at a time either for the small or  for the large  FOV.
    For  a  selected  time  period  and  "discovery scalars",  DSDLCURVE
    accumulates data every 25 degrees scan angle during times  when  the
    source  is  in  the  experiment's field of view (FOV). The DSDLCURVE
     output contains count rate as a  function  of  scan  angles.    The
    DSDDISK data are available from the HEASARC HEAO1 ftp area
    
    

    PARAMETERS
    
    equinox [real]
                 The  equinox  of  the input sky position (default value
        1950)
    
    ra [character string]
                 The source R.A. given in hh mm ss.s or degrees.
    
    dec [character string]
                 The source Dec. given in dd mm ss.s or degrees.
    
    infile [character string]
                 The  DSDISK  raw  data  file.    The   file   will   be 
                 either  for  the  1.5 x 3.0 degree FOV or the 3.0 x 3.0
        degree FOV.   .le
        
        rootname [character string]
                         The rootname for the generated scan file.
        
        beta [real]
                         Used  to   determine   the   number   of   days
            of   data  to be             utilized.  For a  source in the
            ecliptic plane, the   program              will   accumulate
            data  for  roughly BETA*5.7 days centered on             the
            day of the peak response of   the    source.   The   default
                        BETA=0.6   provides   the   optimum   amount  of
            data for  weak             sources.
        
        daily_effic [boolean]
                         Logical flag  to  indicate  whether  to  weight
            data  by  daily               efficiency  (yes/no). If  "no"
            the  data will be weighted               equally  for  every
            observing  day              (this  is recommended for strong
            sources  >   5     Uhuru   Flux              Units).      If
            "yes"     the     data    is    weighted    by   the   daily  
                        effective response of the   source.
        
        ivwoff [integer] 
                        Indicates which scan period to use.
                         "0" 1st 6 month scan of the experiment 
                             (day 232.1 - day 454.9).
                         "1" 2nd 6 month scan of the experiment 
                             (day 400.1 - day 614.6).   
                         "2" 3rd 6 month scan of the experiment  
                             (day ? - day 737.1).
        
        iclwt1 [integer] 
              Options for setting up the  weight  values  for  discovery
            scalars :
                0 use default values for total rate
                1 use default values for hard rate
                2 use default values for soft rate
                3 use default values for R15 rate
                4 use default values for WTD R15 rate
                5 use default values for MED M1 rate
                6 to enter values from keyboard
                        It   is  strongly  advised  that the user choose
            the pre-defined             values for   the desired  option
            (these  values are  tabulated             in the appendix of
            the HEAO1  data  analysis  User  Guide  and              are
            provided  on  the  HEAO1  Software  WWW  page).  If the user
                        chooses  option  6  to  enter  values  from  the 
            keyboard   the               program  will  prompt  for  the 
            Discovery Scalar mode, and the             weights for  each
            color.     If     options     0-5     are    chosen    these   
                        parameters are skipped.
        
        sc_mode [integer]
             Discovery  scalar  mode.  The  settings  of  the  discovery 
            scalars   changed  during  the HEAO-1 mission.  Each setting
             for the discovery scalars is a mode.  There  were  a  total
            of 6 modes.
              MODE 1: HD3 M1,M2,-,-     MED M1,-,-,-
              MODE 2: HD3 M1,M2,-,-     MED M1,M2,-,-
              MODE 3: HD3 M1,M2,-,-     MED 1ACD,1B,2A,2B
              MODE 4: HD3 1AD,1B,1C,M2  MED 1ACD,1B,2A,2B
              MODE 5: HD3 1A,1B,1CD,M2  MED 1ACD,1B,2A,2B
              MODE 6: HD3 1A,1B,1CD,M2  MED 1A,1B,1CD,M2
              Each  mode  possesses  up  to  8 colors.    Weights may be
            applied to the colors as desired. You  should  choose    the
            weights  such that each mode produces approximately the same
            summed   rate.
            
        
        sc_wt1 [real]
              Weighting value for the 1st color of the selected mode.
        
        sc_wt2 [real]
              Weighting value for the 2nd color.
        
        sc_wt3 [real]
              Weighting value for the 3rd color.
        
        sc_wt4 [real]
              Weighting value for the 4th color.
        
        sc_wt5 [real]
              Weighting value for the 5th color.
        
        sc_wt6 [real]
              Weighting value for the 6th color.
        
        sc_wt7 [real]
              Weighting value for the 7th color.
        
        sc_wt8 [real]
              Weighting value for the 8th color.
        
        det_select[boolean]
                          Logical flag to indicate whether  to  use  the
            default                   detector      (data)     selection   
            (yes/no).                 Default  detector   selection   is 
            usually  combined  MED  and HD3               detectors.  If
            "no" the user can  select  the  detector                i.e.
            MED   or   HD3  or  COMBINED,  otherwise  the  parameter  is 
                          skipped.
        
        det_no [integer]
              Select the desired detector i.e. MED or HD3 or COMBINED
        
        anti_coeff [boolean]
                          Logical flag to  indicate  whether  to  change
            the                anti-coincidence   coefficient  (yes/no).
                          The  coefficient is used to correct the  rates
            by    an    amount                 proportional     to   the  
            anti-coincidence     rate;     it     is       used       to    
                          "flatten   out"   the    background  data.  If
            "no" a default               coefficient  is  used  and  the
            parameters  for  the  mode  and                weight of the
            anti-coincidence coefficent is skipped.
        
        anti_mode [real]
              Discovery   scalar   mode   for   which   to   apply   the  
               anti-coincidence coeff weighting.
        
        anti_wt[real]
              Weighting value for the anti-coincidence coefficient.
        
        (tchat = 10) [integer]
             Flag  to  indicate  how  chatty the task is at execution. A
            value of  10  is  the   default,  with  lower/higher  values
            producing  quieter/verbose output  respectively. This is for
            TERMINAL chattiness.
            
            (lchat = 10) [integer] 
                  Same as above but for the level of  chatiness  to  the
                output log file.
            
            (clobber=no) [boolean] 
                  Flag to overwrite light curve if it already exists.
            
            (mode = "ql") [character string]
                
            
            
            
            
            
BUGS
    None known