% @(#)tutorialig.hlq	19.1 (ESO-IPG) 02/25/03 13:19:19 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      tutorialig.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, TUTORI/ALIG
%.PURPOSE    On-line help file for the command: TUTORI/ALIG
%.VERSION    1.0  03-JUL-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./ALIG
\es\co
TUTORIAL/ALIGN                                      21-DEC-1994  KB
\oc\su
TUTORIAL/ALIGN    
	explain the alignment of two images
\us\pu
Purpose:    
           Explain the alignment of two images.
\up\sy
Syntax:     
           TUTORIAL/ALIGN inputs result align_option 
\ys\pa
           inputs = inima,refima  name of image to be aligned and name of
              reference image;
\\
              or AUTO for automatic mode, in that case images are copied from
              the MID_TEST directory to serve as input for the tutorial;
\\
              if omitted, the user is asked to enter the names interactively
\ap\pa
           result = name of result, i.e. aligned, image;
\\
              if omitted, the user is asked to enter the names interactively
\ap\pa
           align_option = the `option' parameter (par. 3) of the ALIGN/IMAGE 
              command; defaulted to UNIT (as in ALIGN/IMAGE)
\ap\sa
See also:
           ALIGN/IMAGE, REBIN/ROTATE, CENTER/GAUSS
\as\no
Note:       
           In the course of the tutorial the input image is loaded into a Midas
           display window and you have to click on different stars in the 
           display to obtain rectangles around them which are used to calculate
           their centers. If the reference image is only slightly misaligned, 
           i.e. the same stars in the ref-image fall also inside these 
           rectangles, this table can also be used to compute the corresponding
           centers in the ref-image. Otherwise, also the ref-image is loaded
           into the display and the rectangles around the corresponding stars
           have to be entered again in the SAME order!
\\
           These tables are then used in an ALIGN/IMAGE command and the results
           of that provide the input for the final REBIN/ROTATE command.
\on\exs
Examples:
\ex
           TUTORIAL/ALIGN AUTO
             Run the tutorial in automatic mode.
\xe\ex
           TUTORIAL/ALIGN ? ? free
             Enter the names of input and result frames interactively, use
             the ALIGN/IMAGE command with option=FREE .
\xe\sxe
