ASCALIN (Jan95)                ftools.asca               ASCALIN (Jan95)

NAME
    ascalin -- Process ASCA Science File to produce linearized  detector
    coordinates, gain corrected PI values, and aspected sky image.
    
USAGE
    
    1. Aspect Science File to mean pointing during file time:
    
           ascalin evtlist calfile timfile attfile ATT
    
    2. Aspect Science File to RA/DEC_NOM keyword values:
    
           ascalin evtlist calfile timfile attfile KEY
    
    3. Aspect Science File to user selected RA/DEC:
    
           ascalin evtlist calfile timfile attfile USER RA DEC
    
    4. Fixed aspect using Euler angles E1/E2/E3:
    
           ascalin evtlist calfile timfile EULER E1 E2 E3
    
    where,
        evtlist  = file containing a list of event files to be processed
        calfile  = name of teldef file       (or "default")
        timfile  = name of gain history file (or "default")
        attfile  = name of attitude file     (or "default", "EULER")
        E1,E2,E3 = Euler angles to use if attfile = EULER
        pointing = method to determine aspect point (ATT->file mean, USER)
        RA,DEC   = aspect point if pointing = USER
                                
DESCRIPTION

    Program to transform from ASCA raw telemetry values to physical val-
    ues. The results are written out to the input Science File DETX,DETY 
    (detector coordinates), X, Y (sky coordinates) and PI columns. The 
    transformations are defined by the appropriate Telescope Definition 
    File, Temporal (Gain) History File, and Attitude File.
    
    ASCALIN works on SIS FAINT, BRIGHT, and BRIGHT2 mode data, and GIS 
    all PH mode data configurations.
    
    The sky reference point for the aspecting may be selected from either 
    the Science File nominal R.A. and Dec. keywords (KEY), a given input
    value (USER), or the file average defined as the Attitude File mean 
    R.A. and Dec. during the Science File stop and start time (ATT).
    
    The option is available to perform a 'fixed aspect' using a set
    Euler angles to calculate the sky X, Y binned  R.A. and DEC.
    coordinates for each event (EULER).

    See ATTITUDE help file for additional details.

                                  -1-
ASCALIN (Jan95)                ftools.asca               ASCALIN (Jan95)


PARAMETERS
    
    datafile [file name]
        The ASCA science file to be processed.
    
    calfile [file name]
        The Telescope  Definition file appropriate for the Science File
        instrument. If 'caldb' is entered, the appropriate CALDB file
        will be used, if available. If 'default' is entered, the appro-
        priate default file name stored in the default parameters will 
        be used.
    
    tempofile [file name]
        The Temporal History file appropriate for the Science File
        instrument. If 'default' is entered, the appropriate default
        file name stored in the default parameters will be used.
    
    attfile [file name]
        The Attitude File. If 'euler' is entered, a 'fixed aspect' will
        be performed using the prompted Euler angles. If 'default' is 
        entered, the path name stored in default parameters will be app-
        ended to the attitude file name stored in the file header.
    
    pointing [string]
        The pointing choice: ATT/USER/KEY (see text above).
    
    ranom [real] (prompted for if pointing=USER) 
        The aspect sky point R.A. (center of image array)
    
    decnom [real] (prompted for if pointing=USER) 
        The aspect sky point DEC. (center of image array)
    
    eulerphi [real] (prompted for if attitude=EULER) 
        The aspect first Euler angle phi.
    
    eulertheta [real] (prompted for if attitude=EULER) 
        The aspect second Euler angle phi.
    
    eulerpsi [real] (prompted for if attitude=EULER)
        The aspect third Euler angle phi.
    
    verbose [logical] (hidden parameters)
        The verbose flag: run time information updates.
        
    xxxcol [string] (hidden parameters)
        The various appropriate science and attitude file column names.
    
                                  -2-
ASCALIN (Jan95)                ftools.asca               ASCALIN (Jan95)


    defxxxfile [string] (hidden parameters)
        The various appropriate Telescope Definition and Temporal 
        (Gain) History file names.
    
    defATTpath [string] (hidden parameters)
        The path pointing to the Attitude file.
    
EXAMPLES
    
    1. Use default files and aspect science file to mean pointing:
    
           ascalin evtlist default default default ATT
    
    2. Use default files and aspect science file to user RA/DEC:
    
           ascalin evtlist default default default USER 90.9 65.2
    
    3. Use default files with Euler angles:
    
           ascalin evtlist default default EULER 90.9 24.8 1.0
       
BUGS
    
    Beta version ASCALIN_V0.9*.
    
    Compatible with FRFREAD version 2.995 and higher.
    
    Please report problems to gotthelf@lheavx.gsfc.nasa.gov.
    
AUTHOR
    
    Eric Gotthelf.
       
SEE ALSO
    
    ATTITUDE.