% @(#)copy_it.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:24 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_it.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/IT
%.PURPOSE    On-line help file for the command: COPY/IT
%.VERSION    1.0  02-JUNE-1986 : Creation, JDP
%----------------------------------------------------------------
\se
SECTION./IT
\es\co
COPY/IT							02-JUNE-1986  JDP
\oc\su
COPY/IT inframe outable [column]
	copy image into table
\us\pu
Purpose:   
           Creates a new table file from the input image. The output
           table contains NPIX(1) rows and NPIX(2) columns of type
           REAL*4.
\up\sub
Subject:   
           Conversion, table
\bus\sy
Syntax:    COPY/IT inframe outable [column]
\ys\pa
           inframe  = input image
\ap\pa
           outable  = output table
\ap\pa
           [column] = for 1-dimensional frames a column name may be given
                      in which the world coordinate of the pixels will be
                      stored.
\ap\no
Note:      
           The names of the columns in the output table start with 
	   "LAB00".   
\on\sa
See also:
           COPY/TI
\as\exs
Examples:
\ex
           COPY/IT my_image my_table
	   creates a new table my_table.tbl from the input image
	   my_image.bdf.
	   If my_image.tbl is an image with NPIX(1)=5 and NPIX(2)=11,   
	   the output table my_table.tbl consists of 5 rows and 
	   12 columns.
	   The first column (which contains the world coordinate
	   of the pixels) is called :LAB001 and the following 11 columns 
	   are called :LAB002, ..., :LAB0012  
\xe\ex
           COPY/IT my_image my_table world_coord
	   as before, except for that the first column is now called 
	   :world_coord instead of :LAB001
\xe\sxe
\rs
Restrictions: \\ Implemented for 1-D and 2-D frames only.
\sr