% @(#)rebin_it.hlq	19.1 (ESO-IPG) 02/25/03 14:03:39 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      rebin_it.hlq
%.AUTHOR     MR, IPG/ESO
%.KEYWORDS   MIDAS, help files, REBIN/IT
%.PURPOSE    On-line help file for the command: REBIN/IT
%.VERSION    1.0  29-OCT-1985 : Creation, MR
%----------------------------------------------------------------
\se
SECTION./IT
\es\co
REBIN/IT						29-OCT-1985 MR
\oc\su
REBIN/IT outtab i,d[,b] inima [func] [param] [intop]
	nonlinear rebin Image to Table
\us\pu
Purpose:    
            Nonlinear rebinning of 1D data. Image to Table transformation.
\up\sy
Syntax:     
            REBIN/IT outtab i,d[,b] inima [func] [param] [intop]
\ys\pa
            outtab = name of output table
\ap\pa
            inima  = name of input image
\ap\pa
            i      = column reference for independent variable
\ap\pa
            d      = column reference for dependent variable
\ap\pa
            b      = [optional] column reference for binwidth
\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 smal bins)
		     into large bins

             Defaults:    REBIN/IT OUT \#1,\#2,\#3 IN LIN 0.,1. PIX
\on\exs
Examples:
\ex
             none
\xe \sxe
