%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2007 European Southern Observatory
%.IDENT      centergaus.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CENTER/GAUSS
%.PURPOSE    On-line help file for the command: CENTER/GAUSS
%.VERSION    1.0  07-FEB-1990 : Creation, KB
%.VERSION    1.1  02-MAR-1992 : Update, KB
% 071019	last modif
%----------------------------------------------------------------
\se
SECTION./1DGA
\es\co
CENTER/1DGAUSS						19-OCT-2007  KB
\oc\su
CENTER/1DGAUSS [in_specs] [out_specs] [out_opt] [append_flag] 
	find intensity weighted center of 1dim frame
\us\pu
Purpose:  
          Compute the central position of the specified object of a
	  1-dim frame by fitting a 1-dim Gaussian function.
\up\sub
Subject: 
          Position, fitting, centering.
\bus\sy
Syntax:  
          CENTER/1DGAUSS [in_specs] [out_specs] [out_opt] [append_flag]
\ys\pa
          in_specs = input specifications, either
             (a) GCURSOR - if the subimages are interactively chosen via the
                 graphic cursor, or
             (b) image,table - if the intervals are defined in a table in the
                 columns labeled :XSTART, :XEND, or :START and :END
\ap\pa
          out_specs = output specifications:
             (x) table name, may be same as given in in_specs
             (y) if same table, only the xcenter, xsigma, xfwhm, icent
                 will be stored in columns :XCEN, :XSIG, :XFWHM, :ICENT
                 if new table, then in addition to the columns explained
                 above, also the columns labeled :XSTART, :XEND,
             By default the values are displayed only on the terminal and
             stored in the keyword OUTPUTR which is filled as follows:
             xstart, xend, xcenter, xsigma, xfwhm, icent
\ap\pa
          out_opt = EMISSION, assumes emission lines, or
                    ABSORPTION, assumes absorption lines;
		    defaulted to EMISSION
\ap\pa
          append_flag = A, append data to a table  else create a new table;
		defaulted to NoAp
\ap\sa
See also:
          CENTER/GAUSS
\as\no
Note:  
          When using the graphic cursor option (a), the command needs
          two cursor positions defining the 1-dim interval to be used. 
	  Any key can be used to input the cursor. Use  SPACE-BAR to exit.
             Also be aware the fitted will be done on the LAST plotted data.
          I.e. when addtional data is plotted using an overplot command
          the CENTER command will work on this overplotted data set.
\on\exs
Examples:
\ex
          CENTER/1DGAUSS spectr001,sources
             Use columns :XSTART, :XEND of `sources.tbl' to define the 
	     intervals of 1-dim image spectr001.bdf; just display results.
\xe\ex
          CENTER/1DGAUSS spectr001,sources sources
             As above, but store results also in table `sources.tbl'.
\xe\ex
          CENTER/1DGAUSS GCURSOR cnt-table EMISSION
             Create table `cnt-table.tbl' with central positions of emission 
	     lines of the plotted 1-dim frame; with intervals defined via
             the graphic cursor.
\xe\ex
          CENTER/1DGAUSS GCURSOR cnt-table EMISSION App
             As above but append data to the already existing table
	     `cnt-table.tbl'.
\xe \sxe
