% @(#)align_inte.hlq	17.1.1.1 (ESO-DMD) 01/25/02 17:44:04
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      align_inter.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, ALIGN/INTER
%.PURPOSE    On-line help file for the command: ALIGN/INTER
%.VERSION    1.0  17-OCT-2001: Creation, KB
%----------------------------------------------------------------
\se
SECTION./INTE
\es\co
ALIGN/INTER						03-JAN-2002  KB
\oc\su
ALIGN/INTER in_ima ref_ima [res_ima] [align_opt] [scale_fact] [cuts_opt]
           interactively align two 2-dim images via ALIGN/IMAGE
\us\pu
Purpose: 
           Interactively align two 2-dim images by
	   a) storing coords of (same) objects in two tables
	   b) calculate the transformation coefficients via ALIGN/IMAGE
	   c) rebin/rotate the inputimage using these coeffs.
\up\sub
Subject:
           Alignment, Rebinning.
\bus\sy
Syntax:
	   ALIGN/INTER in_ima ref_ima [res_ima] [align_opt] 
          	       [scale_fact] [cuts_opt]
\ys\pa
           in_ima = name of image to be aligned, in FITS or Midas format
\ap\pa
	   ref_ima = name of reference image, in FITS or Midas format
\ap\pa
	   res_ima = name of output image (aligned image), 
	             default = align_res.bdf
\ap\pa
           align_opt = type of transformation to calculate,
               FREE, all parameters in the transformation are free;
               EQUAL, the scaling factors in x and y are equal;
               UNIT, the scaling factors in x and y are equal to 1;
               SHIFT, the scaling factors in x and y are equal to 1 and
                      rotation angle = 0.0;
	       thus, these options decrease in the degree of freedom for
	       the paramaters of the solution;
               defaulted to EQUAL
\ap\pa
	   scale_fact = optional scaling factor when displaying images;
		     default = 1
\ap\pa
	   cuts_opt   = optional flag for cut values,
		     Y, display ref_image with same cuts as input image
		     else, no (keep original cut values)
\ap\sa
See also:
           ALIGN/IMAGE, ALIGN/CENTER, TUTORIAL/ALIGN
\as\no
Note:  
	   Read the help of ALIGN/IMAGE for more info!!

           At most 2000 coord. pairs (objects) are used for the alignment.
\on\exs
Examples:
\ex
           ALIGN/INTER field1 fieldref aligned_field ? 2
             Align image `filed1.bdf' with image `fieldref.bdf' and
	     store the aligned frame into image `aligned_field.bdf'.
	     Load the images with SCALE=2 when marking the common objects.
\xe\ex
           ALIGN/INTER omi opa omi.muckis 
             Align image `omi.bdf' with image `opa.bdf' and
             store the aligned frame into image `omi.muckis'.
\xe \sxe