%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1996 European Southern Observatory
%.IDENT      tbl2bdf.hlq
%.AUTHOR     PJG, IPG/ESO
%.KEYWORDS   MIDAS, help files, 3D-table, image, conversion
%.PURPOSE    On-line help file for the command: COPY/TEIMA
%.VERSION    1.0  1996-Apr-12 : Creation, PJG
%----------------------------------------------------------------
\se
SECTION./TEIM
\es\co
COPY/TEIMA						03-AUG-2010  PJG
\oc\su
COPY/TEIMA table column rows [npix] [coor] [prefix]
	Convert a 3D-table element to a MIDAS image file
\us\pu
Purpose:
           Convert a 3D-table element (vector) to a MIDAS image file
\up\sy
Syntax: 
           COPY/TEIMA table column rows [npix] [coor] [prefix]
\ys\pa
           table = name of 3D-table
\ap\pa
           column = name of 3D-table column which should be converted to
		an image
\ap\pa
           rows = range of rows to convert
		The range can be given as a single number (i.e. only one
		row to convert) or two row numbers separated by comma
		specifying first and last row.
\ap\pa
           npix = list of no. of pixels in each dimension or column
		(of interger type) with the numbers
		If the total size of the image specified is larger than
		the length of the column element, column values will be
		repeated to fill the image. The default is a 1D image
		with a size of the column.	
\ap\pa
           coor = list of start values followed but a list of step sizes
		for each dimension or two columns (of real type) 
		with start and step values.  Either explicit values or
		columns must be used - a mix is not allowed.  Columns
		specified must have a size corresponding to the
		dimension given by the `npix' parameter.
		Default values for both start and step are 1.0.
\ap\pa
           prefix = prefix for image file to be created.
		The file name will be constructed using the prefix and
		the row number with a minmum of 4 digits. The default
		prefix is 'image'.
\ap\sa
See also:
           COPY/T3IMA, 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. 
           If the table has a :IDENT column of character type, it will be
           used as identifier of the image.

	   Only selected rows are processed.
\on\exs
Examples:
\ex
           COPY/TEIMA mytable :image 2,34  231 200,1 test
             Convert rows 2 to 34 of column :image in table `mytable.tbl'
             to bdf-files forcing them to be 1D with 231 pixels each.
             The start and step are 200.0 and 1.0, respectively.
             The file names will be `test0002.bdf' etc.
\xe\ex
           COPY/TEIMA myspc :spec 1023  :npix :start,:step spec
             Convert row 1023  of column :spec in table `myspc.tbl' using
             the dimension defined in the column :npix.  Start and step are
             taken from columns :start and :step, respectively.
             The file `spec1023.bdf' will be created.
\xe \sxe
