% @(#)extracrefe.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:35 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      extracrefe.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, EXTRACT/REFERENCE_IMAGE
%.PURPOSE    On-line help file for the command: EXTRACT/REFERENCE_IMAGE
%.VERSION    1.0  04-JUNE-1986 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./REFE
\es\co
EXTRACT/REFERENCE_IMAGE					04-JUNE-1986   KB
\oc\su
EXTRACT/REFERENCE_IMAGE in ref out thresh
	extract subimage according to reference image
\us\pu
Purpose:      
              Extract subimage according to reference image.
\up\sy
Syntax:       
              EXTRACT/REFERENCE_IMAGE in ref out [thresh]
\ys\pa
              in = input frame
\ap\pa
              ref = reference frame, must have same dimension as input frame
\ap\pa
              out = resulting 1-dimensional frame
\ap\pa
              thresh = threshold in reference frame, defaulted to 1.0
\ap\no
Note:         
              For all pixels in the ref. frame with a value .GE. 'thresh',
              the corresponding pixels of the input frame are copied into the
              result frame, which will be a 1-dim image (i.e. the pixels
              will be stored as one vector. By changing the descriptors NAXIS,
              NPIX, etc. you can then adapt the result frame to your needs.
\on\see
See also:     
              EXTRACT/IMAGE, EXTRACT/LINE
\ees\exs
Examples:
\ex
              EXTRACT/REFERENCE itest ref result 2.2
              Frame result.bdf will contain all pixels of itest.bdf where
              the corresponding pixel in ref.bdf has a value .GE. 2.2
\xe\ex
              EXTRACT/REFERENCE itest itest result 2.2
              Frame result.bdf will contain all pixels of itest.bdf with
              a value .GE. 2.2
\xe \sxe