% @(#)createspc3.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:14:50 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      createspc3.hlq
%.AUTHOR     FM, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/SPC3
%.PURPOSE    On-line help file for the command: CREATE/SPC3
%.VERSION    1.0  11-SEPT-1986 : Creation, FM
%----------------------------------------------------------------
\se
SECTION./SPC3
\es\co
CREATE/SPC3						11-SEPT-1986  FM
\oc\su
CREATE/SPC3 image psf_option centring table boxwidth-or-fwhm
	generate an artificial spectrum with lines 
\us\pu
Purpose:   
           Generate an artificial spectrum with lines whose locations
           are defined by a MIDAS table.  Either box or gaussian psfs
           are used (a delta function being used for the former if it
           is of sufficiently small width).
           Note that the input table must be created in one's area.
           The lines, defined in the table, are replicated three times with
           different centrings in each of the three juxtaposed "sectors",
           each of length 220 pixels.
           The first set of lines is centred on the left edge of the pixel;
           the second set on the pixel centre; and the third set is offset
           from the left edge of the pixel by the user-specified value.
\up\sy
Syntax:    
           CREATE/SPC3 image psf_option centring table boxwidth_or_fwhm
\ys\pa
           image      =  the output image name.
\ap\pa
           psf_option =  a box of specified width (B, default); or
                         a gaussian of specified full width half max. (G).
\ap\pa
           centring   =  positions of lines vis-a-vis pixel centres (in the
                         third 220-pixel sector). Default is 0.645.
\ap\pa
           table      =  input table (single column, no specific label
                         required), giving positions of lines. Default
                         is LINES.TBL.
\ap\pa
           boxwidth   =  width of "box" PSF; if .LE. 0.001, then a delta
                         function is used instead.
\\
           (or)
\ap\pa
           fwhm       =  full width half maximum (greater than 0.2).
                         Default of boxwidth or of fwhm is 1.0.
\ap\no
Note:      
           Input lines have normalized peak height.  Depending on line
           centring and line width, the maxima of the actual lines after their
           mapping onto the pixel grid may be smaller.
\on\exs
Examples:
\ex
           CREATE/SPC3 outim  G  0.61  lines 1.75
\xe \sxe