% @(#)rotateeche.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:50:39
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      rotateeche.hlq
%.AUTHOR     PB, IPG/ESO
%.KEYWORDS   MIDAS, help files, ROTATE/ECHELLE
%.PURPOSE    On-line help file for the command: ROTATE/ECHELLE
%.VERSION    1.0  18-NOV-1990 : Creation, PB 
%----------------------------------------------------------------
\se
SECTION./ECHE
\es\co
ROTATE/ECHELLE						12-OCT-1994 PB
\oc\su
ROTATE/ECHELLE   cat,ima root-name [mode] [flip_axis] [angle] [o_time]
	rotate (and optionally flip) echelle images
\us\pu
Purpose:    Rotate and optionally flip echelle images. The output
            result has to be in such a way that wavelengths increase
            from left to right and spectral order numbers increase
            from top to bottom. All possible combination of rotation and 
            flip are made available by the parameters angle and
            flip_axis.

            Additionally, the command checks the presence of the
            descriptor with the exposure time and will prompt for
            it if not present.

            Descriptors START and STEP of rotated images are set to 1.,1.
            STEP descriptor of original images correspond to the bin
            factor and are written in echelle keyword CCDBIN.

            The command works on catalogues containing the input images.
            The catalogue is created with
            CREATE/CATALOG catalogue dirspec  (See HELP)

\up\sy
Syntax:     ROTATE/ECH cat,ima root [mode] [flip_axis] [angle] [o_time]

\ys\pa
            cat,ima   = name of the catalogue with the input images.
                        This parameter will be interpreted as a catalog
                        name by default (no extension given or extension
                        .cat). Other extensions (e.g. .bdf) will be
                        interpreted as single image names.
\ap\pa
            root      = root of the name of the resulting images
                        (up to 4 alphanumeric characters starting with
                         a letter). If a single image name is provided
                        as input, root is the name of the output image.
\ap\pa
            mode      = optional parameter to define the mode of operation:
                        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.

                        Pre-defined modes are defined for instruments:
                        CASPEC, EMMI, EFOSC, ECHELLEC.
\ap\pa
            flip_axis = Flip Axis. Used only if mode = FLIP.
                        Possible values: X,Y,XY,NONE Default: X.
                        See command FLIP/IMAGE for more information
\ap\pa
            angle     = Angle of rotation of the image, in degrees.
                        Default: 90. degrees.
\ap\pa
            o_time    = Default observation time. The procedure checks
                        for each image that the descriptor O_TIME/D/7/1
                        exists and is set to a non null value. If not
                        the default value is taken into account. If no
                        default value is provided, the user is prompted for
                        the observation time.             
\ap\no
Note:       none

\on\exs
Examples:
\ex
            ROTATE/ECHELLE mycat  a   rota
            The images in mycat are rotated. You will find the output as
            a0001, a0002, ...
\xe \sxe