*qplintran* -- Apply linear transformation to a qp file through filter

Transforms a qpoe file according to the specified parameters. Position X1,Y1 is changed to:

$$\begin{eqnarray*}X2& =& Xout + ((X1-Xin)*Xmag*cos(Angle) - (Y1-Yin)*Ymag*sin(Ang... ...&= &Yout + ((Y1-Yin)*Ymag*cos(Angle) + (X1-Xin)*Xmag*sin(Angle)) \end{eqnarray*}$$

where Xout,Yout is the new reference point in pixels, Xin,Yin is the input reference point. Xmag,Ymag are the relative plate scales in X and Y (normally 1). Any type of filtering can be applied to the input qpoe file, including region filtering. In addition, the size of the output event record can be different from the size of the input event record. (Of course, usually one makes the output record equal to or smaller than the input. If the output record size is made greater than the input record, a warning is issued and the ``extra'' part of the record is undefined.)

This task is modeled after imlintran but runs in qpoe files. Simple SHIFT and ROTATE functions can be performed with the specialized tasks above.

N.B.: The warning ``QPEXwarning: bad attribute name `time''' can be ignored.

     input file:	xdata$rp110590.qp

     output file:	arlac_lintran.qp


  xs> qplintran xin=7140 yin=7440 xout=7681 yout=7681   

  input qpoe file name (xdata$rp110590n00.qp): xdata$rp110590n00.qp
  region descriptor (FIELD): FIELD
  angle (degrees) through which to rotate (0.): 20.0
  output qpoe file name (arlac_mag.qp): arlac_lintran.qp
  event definition: FULL

xdata$rp110590n00.qp (FIELD; no exp.) -> arlac_lintran.qp (xin=7140.00 yin=7440.00 
                                  xrot=20.00 yrot=20.00 xout=7681.00 yout=7681.00)
Creating QPOE output file: arlac_lintran.qp