% @(#)rotatespec.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:55:40 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      rotatespec.hlq
%.AUTHOR     PB, DMD/ESO
%.KEYWORDS   MIDAS, help files, ROTATE/SPEC
%.PURPOSE    On-line help file for the command: ROTATE/SPEC
%.VERSION    1.0  14-JAN-1994 : Creation, PB
%----------------------------------------------------------------
\se
SECTION./SPEC
\es\co
ROTATE/SPEC						14-JAN-1994  PB
\oc\su
ROTATE/SPEC   cat [root] [meth] [flip] [angle] [mode]
	rotate (and optionally flip) a catalog of images
\us\pu
Purpose:    Rotate and optionally flip echelle images. MIDAS spectral
            packages expect that the wavelength increases from left to 
            right and for echelle spectra that the order numbers increase
            from top to bottom. All possible combination of rotation and 
            flip are made available by the parameters angle and
            flip_axis. 
            \\
            Original files can be removed after processing with
            the option mode=DELETE in order to save disk space.
            \\ 
            The command works on catalogues containing the input images.
            The catalogue is created with: \\
            \\ 
            CREATE/CATALOG catalogue dirspec  (See HELP)

\up\sy
Syntax:     ROTATE/SPEC  cat  [root] [meth] [flip] [angle] [mode]

\ys\pa
            cat       = name of the catalogue with the input images
\ap\pa
            root      = root of the name of the resulting images
                        (up to 4 alphanumeric characters starting with
                         a letter). Default: rot
\ap\pa
            meth      = Processing method, either ROTATE or FLIP.
                        \\
                        ROTATE     - rotation only. The angle of rotation
                                     is defined by parameter angle.
                        \\
                        FLIP       - rotate and flip, (default)
                                     Angle of rotation and flip axis are
                                     defined by angle and flip_axis.
\ap\pa
            flip      = Flip Axis. Used only if meth=FLIP.
                        Possible values: X,Y,XY Default: X.
                        See command FLIP/IMAGE for more information
\ap\pa
            angle     = Angle of rotation of the image, in degrees.
                        Default: 90.0 degrees.
\ap\pa
            mode      = Post-rotation mode, either KEEP or DELETE.
                        Default value is KEEP: original files are
                        conserved. Disk space can be saved with the 
                        option DELETE, which removes the input files
                        after rotation.
\ap\no
Note:       none

\on\exs
Examples:
\ex
            ROTATE/SPEC  mycat   mode=DELETE \\ 
            The images in mycat are rotated. You will find the output as
            rot0001, rot0002, ... The input files listed in the catalog
            mycat.cat are removed.
\xe \sxe