%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  2010 European Southern Observatory
%.IDENT      copy_t3im.hlq
%.AUTHOR     KB
%.KEYWORDS   MIDAS, help files, 3D-table, image, conversion
%.PURPOSE    On-line help file for the command: COPY/T3IMA
%.VERSION    1.0  100803
%----------------------------------------------------------------
\se
SECTION./T3I
\es\co
COPY/T3IMA						31-AUG-2010  KB
\oc\su
COPY/T3IMA table column  [1st_row,norow] [1st_el,noelem] [coors] [outima]
	Convert an array column of a 3D-table to a MIDAS image file
\us\pu
Purpose:
	   Convert an array column of a 3D-table to a MIDAS image file
\up\sy
Syntax: 
           COPY/T3IMA table column [1st_row,norow] [1st_el,noelem] [coors] 
		      [outima]
\ys\pa
           table = name of 3D-table
\ap\pa
           column = name of 3D-table array (1-dim) column to be converted to
		an image
\ap\pa
	   1st_row,norow = 1st row and no. of rows to read
		if only one row is extracted, the resulting image will
		be a 1-dim image,
		for several rows the image will be a 2-dim image with
		the elements of each column entry along the x-axis
		of the result image for every selected row in the given range;
		defaulted to 1,1
\ap\pa
           1st_el,noelem = 1st element and no. of elements to read
		from the array column;
		default is 1st and no. of elements of the column	
\ap\pa
           coors = xstart,xstep[,ystart,ystep] 
		the start, step values for the x-axis of the result image
		as well as for the y-axis if several rows are converted;
		defaulted to 0.0,1.0,0.0,1.0 
\ap\pa
           outima = name of image file to be created;
		defaulted to tbimage.bdf
\ap\sa
See also:
           COPY/T3TAB, COPY/IMT3, COPY/TEIMA, COPY/TI
\as\no
Note:
              The type of the image will be D_R8_FORMAT if the column type 
	   is D_R8_FORMAT, otherwise its type will be D_R4_FORMAT. 
              The copy command will be logged and appended to descriptor 
           HISTORY of the table.
\on\exs
Examples:
\ex
           COPY/T3IMA ajo :cebollino 2,34  1,231 200.,1.1 perejil
             Extract 231 elements starting at 1st element of column :cebollino
	     in rows 2 to 34 in table `ajo.tbl' to 2-dim image `perejil.bdf'. 
	     Npix of of `perejil.bdf' will be 231,33 if all the rows are
	     selected.	Start will be 200.,1. and step will be 1.1,1.0
\xe\ex
           COPY/T3IMA ajo :cebollino 2,34  101,100 200.,1.1 perejil
             As above, but use only 100 elements starting at element no. 101 
             of the 231 pixel array at each column entry.
\xe\ex
           COPY/T3IMA myspc.fits :spec 1023  ? ?  spec
	     Start step will be 0.0 and 1.0.
             Convert row 1023  of column :spec in the FITS table `myspc.fits' 
	     using all elements of the column array to a 1-dim file 
	     `spec.bdf'. Start step will be 0.0 and 1.0.
\xe \sxe
