%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2012 European Southern Observatory
%.IDENT      statisimag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SHRINK/IMAGE
%.PURPOSE    On-line help file for the command: SHRINK/IMAGE
%.VERSION    1.0  12-MAR-1997 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
SHRINK/IMAGE			                3-FEB-2012  KB
\oc\su
SHRINK/IMAGE in_image out_image [option] 
	"shrink" 2 or 3-dim image to 1-dim image of statistical values
\us\pu
Purpose:  
          Get statistics of planes/rows of a frame and store in 1-dim image.
\up\sy
Syntax: 
          SHRINK/IMAGE in_image out_image [option] 
\ys\pa
          in_image = name of input image
\ap\pa
          out_image = name of (1-dim) output image
\ap\pa
          option = Min, Max, Mean, Median, Mom3, Mom4, Mode1, Mode, Stddev
                   or Total
             to fill the output image with either the minimum, maximum, mean, 
	     median, 3rd moment, 4th moment, 1st mode, mode, standard deviation
             or total intensity computed over the rows of a 2-dim input image 
             or the planes of a 3-dim input image;
             defaulted to Mean
\ap\sa
See also:
          EXTRACT/IMAGE, GROW/IMAGE, STATISTICS/IMAGE, TRANSPOSE/CUBE
\as\no
Note:
	  See the help of STATISTICS/IMAGE for info about the meaning
	  of the statistical options of this command.
          This command is not applicable to 1-dim images.
\on\exs
Examples:
\ex
          SHRINK/IMAGE armadillo zopilote std
            Calculate the standard deviation in the planes/rows of 3-dim/2-dim
            input image `armadillo.bdf' and store them in new 1-dim image
            `zopilote.bdf'.
\xe \sxe
