%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2008 European Southern Observatory
%.IDENT      copy_ti.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/TI
%.PURPOSE    On-line help file for the command: COPY/TI
%.VERSION    1.0  02-JUNE-1986 : Creation, JDP
%----------------------------------------------------------------
\se
SECTION./TI
\es\co
COPY/TI							7-APRIL-2008  JDP
\oc\su
COPY/TI intable outimage [column_name]
	copy table into image
\us\pu
Purpose:   
           Create a new image file from the input table. If no single
	   column name is given, a 2dim image with NPIX(1) equal to
           the number of selected rows and NPIX(2) equal to the number of
           columns in the table.
           All columns in the table have to be of the same type,
           REAL*4 in the current version.
	   If the table contains just a single column or a specific 
	   column name is given, just that column is copied into a 1-dim image
           The null elements in the table will be set in the image to 
           the "null value" defined by the keyword NULL.
\up\sy
Syntax:    
           COPY/TI intable outimage [column_name]
\ys\pa
           intable  = the input table
\ap\pa
           outimage = the output image
\ap\pa
           column_name = optional column spec. (label or #);
		only that column is then copied
\ap\no
Note:      
           If SELECT/TABLE was used before to select a subtable from the input
	   table, the new output image will have NPIX(1) equal to the number
	   of selected rows. 
\on\sa
See also:
           COPY/IT
\as\exs
Examples:
\ex
           COPY/TI  intab outim
	     Create from table `intab.tbl' an image `outim.bdf' with NPIX(1) 
             equal to the number of selected rows and NPIX(2) equal to the 
             number of columns of `intab.tbl'.
\xe \ex
           COPY/TI  carro troca :tanque
	     Create from column :tanque (real data) of table `carro.tbl' a 
	     1-dim image `troca.bdf' with NPIX(1) equal to the number of 
	     selected rows of `caro.tbl'. 
             The table may have other (also char. data) columns.
\xe \sxe

