% @(#)cuts_imag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:29 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      cuts_imag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CUTS/IMAGE
%.PURPOSE    On-line help file for the command: CUTS/IMAGE
%.VERSION    1.0  07-MAR-1984 : Creation, KB
%.VERSION    1.1  03-SEP-1991 : Update, KB
%.VERSION    1.2  22-MAY-1992 : Upgrade, KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
CUTS/IMAGE					22-MAY-1992  KB
\oc\su
CUTS/IMAGE frame [cut_specs]
	display or set low + high cut values of an image frame
\us\pu
Purpose: 
	  Display or set low + high cut values of an image frame.
\up\sy
Syntax:  
          CUTS/IMAGE frame [cut_specs]
\ys\pa
          frame = name of image frame
\ap\pa
          cut_specs = low,high cuts (a) or reference frame (b) or =option (c)
\\
             (a) either lowcut,hicut or lowcut or ,hicut to set both cut
                 values or just the low or high value
\\
             (b) name of data frame the cuts values of which are copied
                 to 'frame'
\\
             (c) =option, where option can be `sigma' or `high'
\\
                 for =sigma, cut values are set to mean-3*sigma, mean+3*sigma
\\
                 for =high, cut values are set to mean-0.1*max, max;
\\
                 if the calculated low (high) cut is less (greater) than
                 min (max) of frame, min (max) is taken instead;
\\
             if cut_specs are omitted, the contents of the descr. LHCUTS are
             displayed (i.e. the same as: READ/DESCR frame LHCUTS)
\ap\sa
See also:
          READ/DESCR, LOAD/IMAGE, PLOT/ROW, COPY/DD
\as\no
Note: 
          The cut values will be stored in real descriptor LHCUTS as
          elements 1,2 and are used with LOAD/IMAGE or PLOT/ROW.
\\
          If `cut_specs' is set to `=sigma', also the values for
          mean+-sigma and for mean+-2*sigma are computed and stored in
          real keyword OUTPUTR(11,12,...).
\\
          As a reminder:
\\
          The descriptor LHCUTS contains also the physical min, max of the
          image frame in LHCUTS(3,4).
\on\exs
Examples:
\ex
          CUTS/IMAGE durazno 2.2,6.6
          Set low, high cut of durazno.bdf to 2.2 and 6.6 .
\xe\ex
          CUTS/IMA durazno pera
          Set low, high cut of durazno.bdf to the cut values of pera.bdf .
\xe\ex
          CUTS/IMA durazno =high
          Set low cut value to maximum of (mean-0.1*max) and min of durazno.bdf 
          and set high cut value to max of durazno.bdf .
\xe\ex
          CUTS/IMA durazno
          Display current cut values of durazno.bdf .
\xe \sxe