tastis

Analyze STIS target acquisition images. tastis will print general information about each input target acquisition image, and will analyze both types of STIS target acquisitions: ACQs and ACQ/PEAKs

ACQ procedure is described in "STIS Onboard CCD Target Acquisitions" in the STIS Instrument Handbook. The ACQ/PEAK procedure is described in "Onboard Target-Acquisition Peakups (ACQ/PEAK)" also in the STIS Instrument Handbook.

Target positions in global and local (subarray) coordinates and the total flux of the target in the maximum checkbox during both acquistions phases (course and fine) are displayed.

If update=True, keywords are added to the header to make problems easier to locate in batch processing. Warnings are given if the spt file is not present when tastis is run.

Examples

tastis with the default of update=False:

>>> import stistools
>>> stistools.tastis.tastis("ocmv0lw6q_raw.fits")
===============================================================================
oc7w11viq       HST/STIS    G430L        0.3X0.05ND             ACQ/PEAK-UP
prop: 13465      visit: 11    line: 3   target: HD128621-2
obs date, time: 2014-07-24    22:05:06   exposure time:  0.10
dom GS/FGS: S7QX000330F1    sub-dom GS/FGS: S7QX000694F2
ACQ params:     bias sub: 1510                     method: RETURN-TO-BRIGHTEST
subarray (axis1,axis2):   size=(1022,32)          corner=(25,500)
-------------------------------------------------------------------------------
Scan type: LINEARAXIS2                  Step size (mas): 250
 [210 753   0]
                    axis1 axis2     axis1  axis2         V2   V3
                      (pixels)        (arcsec)           (arcsec)
Estimated slew:      0.0  -0.1     0.000 -0.005     -0.004  0.004
Flux in post-slew confirmation image (751752) - Pedestal (748587) = 3165 DN
-------------------------------------------------------------------------------
The flux in the confirmation image is 320% greater than the maximum flux
in the ACQ/PEAK scan.  An excess greater than 100% indicates
problems in the ACQ/PEAK.
The flux in the confirmation image is 16% of the recommended minimum
of 20000 DN for a dispersed-light ACQ/PEAK.  The signal-to-noise in
the AC
===============================================================================

tastis with update=True:

>>> import stistools
>>> stistools.tastis.tastis("ocmv0lw6q_raw.fits", update=True)
===============================================================================
ocmv0lw6q       HST/STIS    MIRVIS      F25ND3             ACQ/POINT
prop: 13760      visit: 0L    line: 1   target: CD-59D3300
obs date, time: 2016-09-29    23:43:50   exposure time:  1.10
dom GS/FGS: S4B0000993F2    sub-dom GS/FGS: S4B0000953F1
ACQ params:     bias sub: 1510   checkbox: 3      method: FLUX CENTROID
subarray (axis1,axis2):   size=(100,100)          corner=(487,466)
-------------------------------------------------------------------------------
Coarse locate phase:           Target flux in max checkbox (DN): 1560
                       global          local
                    axis1 axis2     axis1 axis2
Target location:    534.2  507.0    48.2  42.0
                    axis1 axis2     axis1  axis2         V2      V3
                      (pixels)        (arcsec)            (arcsec)
Estimated slew:     -1.5  -9.0    -0.079 -0.457       -0.379  0.268
-------------------------------------------------------------------------------
Fine locate phase:            Target flux in max checkbox (DN): 1559
                       global            local
                    axis1 axis2     axis1 axis2
Target location:    534.2  516.8    48.2  51.8
Ref ap location:    537.5  517.0    19.5  17.0
                    axis1 axis2     axis1  axis2         V2      V3
                      (pixels)        (arcsec)           (arcsec)
Estimated slew:     -2.1  -0.2     -0.104 -0.010      -0.081 -0.067
-------------------------------------------------------------------------------
Total est. slew:    -3.6  -9.2    -0.183 -0.467        -0.460  0.201
-------------------------------------------------------------------------------
Your ACQ appears to have succeeded, as the fluxes in the coarse
and fine stages agree within 25% and the fine slews were less than
4 pixels as expected
===============================================================================
stistools.tastis.tastis(raw_filename, update=False)

Analyze STIS target acquisition images.

Parameters:
raw_filename: str

Name of the input raw file. For some raw files you will need a copy of the spt file in the same directory.

update: bool

If True, keywords associated with tastis checks will be updated. Default values is False.