mktrace

Refine a STIS trace table.

• A trace is generated from the science file and a trace center is computed.
• The two traces bracketing the trace center are extracted from the trace table and interpolated
• The correction is computed as the difference between the linear fit to the science and interpolated traces
• The correction is applied to all traces in the trace file for that particular OPT_ELEM and CENWAVE
• A new trace table is written to the current directory and the relevant keywords are updates in the header of the input file.

Examples

Simple example of running mktrace on a STIS file named 'file.fits':

>>> import mktrace
>>> mktrace.mktrace('file.fits', [tracecen=509.4], [weights=[(x1,x2),(x3,x4)])

Authors:

• Author (IDL): Linda Dressel
• Python version: Nadia Dencheva

class stistools.mktrace.Trace(file, kwinfo)

Trace class for a crj or flt file.

Notes

tr=Trace(file) file is a crj or flt file.

opt_elem, cenwave, sporder are read from the header of the science file a2center is a2center of the trace generated from the science file

tr_ind= tr.getTraceInd(a2center)

tr_ind is the index of the row in the trace file which brackets from below a2center as computed fro the generated trace

tr.readTrace(tr_ind)

a2center = tr.generateTrace(...)

Methods

gFitTrace(specimage, y1, y2)	Fit a gaussian to each column of an image.
generateTrace(data, kwinfo[, tracecen, wind])	Generates a trace from a science file.
getTraceInd(a2center)	Finds the first trace in the trace table whose A2CENTER is larger than the specified a2center.
openTraceFile(filename)	Returns a spectrum trace table
readTrace(tr_ind)	reads the specified row from the 1dttab.fits
writeTrace(fname, sciline, refline, ...)	The 'writeTrace' method performs the following steps:

gFitTrace(specimage, y1, y2)

Fit a gaussian to each column of an image.

generateTrace(data, kwinfo, tracecen=0.0, wind=None)

Generates a trace from a science file.

getTraceInd(a2center)

Finds the first trace in the trace table whose A2CENTER is larger than the specified a2center.

openTraceFile(filename)

Returns a spectrum trace table

readTrace(tr_ind)

reads the specified row from the 1dttab.fits

writeTrace(fname, sciline, refline, interp_trace, trace1024, tr_ind, a2disp_ind)

The 'writeTrace' method performs the following steps:

• Adds sciline-refline to all traces with the relevent OPT_ELEM, CENWAVE and SPORDER.
• Writes the new trace table to the current directory.
• Updates the SPTRCTAB keyword in the header to point to the new table.
• Writes out fits files with the
  • science trace - '_sci'
  • the fit to the science trace - '_scifit'
  • the interpolated trace - '_interp'
  • the linear fit to the interpolated trace - '_interpfit'

stistools.mktrace.interp(y, n)

Given a 1D array of size m, interpolates it to a size n (m < n).

stistools.mktrace.mktrace(fname, tracecen=0.0, weights=None)

Refine a stis spectroscopic trace.