%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2008 European Southern Observatory
%.IDENT      plot_colu.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, PLOT/COLUMN
%.PURPOSE    On-line help file for the command: PLOT/COLUMN
%.VERSION    870609 RHW Creation, RHW
%.VERSION    910313 RHW Improvements acc. to verification form
%.VERSION    910904 RHW New command and help file : PLOT/COLUMN
%---------------------------------------------------------------------
\se
SECTION./COLU
\es\co
PLOT/COLUMN                                            06-MAR-2008  RHW,KB
\oc\su
PLOT/COLUMN frame [x_coord] [y_sta,y_end] [x_sc,y_sc,x_off,y_off]
	plot a column of an image on a plotting device
\us\pu
Purpose:    
            Plot a column of an image on the selected plotting device
\up\sy
Syntax:     
            PLOT/COLUMN frame [x_coord] [y_sta,y_end] [x_sc,y_sc[,x_off,y_off]]
\ys\pa
            frame     = image file name
\ap\pa
            x_coord   = column number or world coordinate in the frame;
                        default the first column
\ap\pa
            y_sta,y_end = can be: (a) first and last pixel in the column;
                        (b) start, end in world coordinates on the column.
                        Default is either the manual setting done by the
                        command SET/GRAPHICS (if present), or the whole column.
\ap\pa
            x_sc,y_sc,x_off,y_off = scale or size in the x- and y-direction,
                        offset in the x- and y-direction. For the scaling x_sc
                        and y-sc, positive numbers are interpreted as scale
                        parameters (world units/mm), negative numbers as size
                        parameters (axis will be made sc_* mm. long). A
                        combination of a positive and negative number is
                        allowed. By default the plot fills the device area. \\
                        x_off and y_off determine the distance of the lower
                        left corner of the plot to the lower left corner of the
                        graphic device, measured in mm. By default, the plot
                        is put at the top left of the graphic device, allowing
                        space for the various labels.
\ap\no
Note:       
            The max. length of file names for plotting is 60 chars.
\on\see
See also:   
            SET/GRAPHICS, SHOW/GRAPHICS,
            OVERPLOT/COLUMN, PLOT/ROW, OVERPLOT/ROW        
\ees\exs
Examples:
\ex
            PLOT/COLUMN myframe @256 @10,@100 
            This command will plot from image myframe.bdf column 256, pixels 10
            to 100.
\xe\ex
            PLOT/COLUMN myframe 256 100,10 13.6,5,20,30
            This command plots from image myframe.bdf the column corresponding
            to the x coordinate 256, in the range from 100 to 10 (all world
            coordinates) with a negative increment. The scales of the plot are
            along the x axis: 13.6 world coord. unit/mm.; in y: 13.6 intensity 
            units/mm. The plot will be drawn at 20 mm from the left edge and 
            30 mm from the botom edge of the graphic device.
\xe\ex
            PLOT/COLUMN myframe 256 100,10 13.6,-100
            This command plots from image myframe.bdf the column corresponding 
            to the x coordinate 256, in the range from 100 to 10 (all in world
            coordinates) with a negative increment. The scales of the plot are
            along the x axis again 13.6 world coord. unit/mm.; the plot will 
            be 10 cm high.
\xe \sxe
