% @(#)createstar.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:11:27 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      createstar.hlq
%.AUTHOR     CO, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/STAR
%.PURPOSE    On-line help file for the command: CREATE/STAR
%.VERSION    1.0  24-MAY-1984 : Creation, CO
%----------------------------------------------------------------
\se
SECTION./STAR
\es\co
CREATE/STAR	                                               1-MRT-1994 RHW
\oc\su  
CREATE/STAR in_frm in_tab out_frm [n_size] [frm_specs] [dmin,dmax] [radius]
	create the profile of a reference star by adding and averaging
\us\pu
Purpose:      
              Create a frame containing the profile of the standard reference 
              star, by adding and averaging inside a circular window some 
              selected  stars, after recentering
\up\sy
Syntax:       
              CREATE/STAR in_frame in_table out_frame [n_size] [frm_specs] 
                          [dmin,dmax] [radius]
\ys\pa
              in_frame  = input frame containing the selected stars
\ap\pa
              in_table  = input table containing the coordinates of
                          these stars in column :X_COORD and :Y_COORD
\ap\pa
              out_frame = output frame containing the calculated reference 
                          star
\ap\pa
              n_size    = size of the output frame in number of pixels. The 
                          output frame will square, having n_size pixels in 
                          each dimension
\ap\pa
              frm_specs = specifications for the output frame in the format
                          startx, starty, stepx, stepy. Default are the values
                          of the input frame
\ap\pa
              dmin,dmax = low cut, high cut to select the stars; defaulted to 
                          the real cuts of the input frame
\ap\pa
              radius    = in pixel number, the radius of a circular window 
                          centered on each selected star; default 20
\ap\no
Note:         
              The input table containing the input star coordinates can easily
              obtained by the command GET/CURSOR.\\
\\
              The maximum of the stellar profile will be in the centre of the 
              output frame.
\on\exs
Examples:
\ex
              crea/star tspiral ttab ttest 128 0,0,0.1,0.1 ? 40
              Create a frame of 128 * 128 pixels containing the stellar profile
              obtained by averaging the stars stored in tabel `ttab'. The input
              frame is `tspiral'. The default for the low and high cuts is to 
              be used; the radius of the circular window is 40 pixels.
\xe \sxe