% @(#)rebin_ii.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:52 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      rebin_ii.hlq
%.AUTHOR     MR, IPG/ESO
%.KEYWORDS   MIDAS, help files, REBIN/II
%.PURPOSE    On-line help file for the command: REBIN/II
%.VERSION    1.0  29-OCT-1985 : Creation, MR
%----------------------------------------------------------------
\se
SECTION./II
\es\co
REBIN/II						29-OCT-1985 MR
\oc\su
REBIN/II outima inima refima [func] [param] [intop]
	nonlinear rebin Image to Image
\us\pu
Purpose:    
            Nonlinear rebinning of 1D data. Image to Image transformation.
\up\sy
Syntax:     
            REBIN/II outima inima refima [func] [param] [intop]
\ys\pa
            outima = name of output image
\ap\pa
            inima  = name of input image; 
                     `outima' and `inima' MUST be different!
\ap\pa
            refima = reference image
\ap\pa
            func   = function code (see below) for the mapping of
                     OUTPUT indep.variable into INPUT indep. variable
                     defaulted to LIN
\ap\pa
            param  = parameters for the function used, defaulted to 0.,1.
\ap\pa
            intop  = interpolation option (se below) defaulted to PIX

\ap\no
Note:       
            FUNCTIONS (parameters A, B, C, ..... )
\\
             LIN     x(old) = A + Bx
\\
             POL     x      = A + Bx +Cxx + .... (up to 16 coeff)
\\
             INV     x      = A + B/x
\\
	     EXP     x      = A + B*EXP(Cx)
\\
             DEX     x      = A + B*10.**(Cx)
\\
	     LOG     x      = A + B*LOG(Cx)
\\
             DLG     x      = A + B*LOG10(x)
\\
	     IPO     x      = A + B/(x-D) + C/(x-D)**2 + ... 
\\
	     U01     x      = user defined function of x.
\\
	     INTOP  (interpolation options)
\\
	     PIX     take fractions of pixel areas
\\
	     LIN     interpolate linearly and add polygons
\\
	     SPG     interpolate with hermite polynomials
                     and integrate with Gaussian formula
\\
             Recommended option is SPG, LIN is faster and may provide 
             sufficient accuracy whenever well behaved data are rebinned 
             to larger stepsizes. PIX (same speed as LIN) will give adequate
             results only when rebinning from an oversampled array (very 
             small bins) into large bins.
\\
             Defaults:    REBIN/II OUT IN REF LIN 0.,1. PIX
\on\exs
Examples:
\ex
             none
\xe \sxe