%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  2011 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  111130
%----------------------------------------------------------------
\se
SECTION./T3T
\es\co
COPY/T3TAB						30-NOV-2011  KB
\oc\su
COPY/T3TAB intab incol inrow outtab outcol [new_flag]
	Copy an array column of a 3D-table to a column of "simple" table.
\us\pu
Purpose:
	   Copy all elements of an array column of a 3D-table to a 
           column of "simple" table.
\up\sy
Syntax: 
	   COPY/T3TAB intab incol inrow outtab outcol [new_flag]
\ys\pa
           intab = name of 3D-table
\ap\pa
           incol = name (label) of  array (1-dim) column 
\ap\pa
	   inrow = row no. to work on
\ap\pa
           outtab = name of result table;
                the table is created if it does not exist yet,
		for existing tables see below (new_flag)
\ap\pa
           outcol = name of new column with array data in result table
\ap\pa
           new_flag = YES or NO - defaulted to YES;
		if NO, an existing result table is just updated, 
		result column will be reinitialized
\ap\pa
\ap\sa
See also:
           COPY/T3IMA, COPY/IMT3, COPY/TEIMA, COPY/TI
\as\no
Note:
           Array columns of type I*1 or I*2 are not supported.
	     The unit, format and type of the result column will be taken
	   from the input column.
\on\exs
Examples:
\ex
           COPY/T3TAB ajo :cebollino @12 perejil :cebo_12
             Extract all elements of column :cebollino in row 12 
	     of table `ajo.tbl' and store them in the rows of column
	     :cebo_12 of table `perejil.tbl'.
	     Even if table `perejil.tbl' exists, a new table `perejil.tbl'
	     will be created.
\xe \sxe
