% @(#)plot_row.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:49
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      plot_row.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, PLOT/ROW
%.PURPOSE    On-line help file for the command: PLOT/ROW
%.VERSION    1.0 09-JUN-1987: RHW Creation, RHW
%.VERSION    1.1 13-Mar-1991: RHW Improvements acc. to Verification Form
%.VERSION    910904 RHW Renamed to plot_row.hlq for plot/row command
%.VERSION    950301 KB in the Note: refer to descr. CUNIT
%---------------------------------------------------------------------
\se
SECTION./ROW
\es\co
PLOT/ROW                                                       04-SEP-1991  RHW
\oc\su
PLOT/ROW frame [y_coord] [x_sta,x_end] [x_sc,y_sc[,x_off,y_off]]
	plot a row (line) of an image on a plotting device
\us\pu
Purpose:    
            Plot a row (line) of an image on the selected plotting device
\up\sy
Syntax:     
            PLOT/ROW frame [y_coord] [x_sta,x_end] [x_sc,y_sc[,x_off,y_off]]
\ys\pa
            frame     = image file name
\ap\pa
            y_coord   = row (line) number or world coordinate in the frame;
                        default the first row.
\ap\pa
            x_sta,x_end = can be: (a) first and last pixel coordinate;
                        (b) start, end in world coordinates on the line.
                        Default is either any manual setting done by the
                        command SET/GRAPHICS, or the whole line.
\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 y-axis is labeled with the string "Pixel value({CUNIT(1:16)})"
            and the x-axis with "Position ({CUNIT(17:32)}). Where e.g.
            {CUNIT(17:32)} means the contents of the descriptor CUNIT (from
            char. 17 until char. 32) of the plotted frame. 
\on\see
See also:   
            SET/GRAPHICS, SHOW/GRAPHICS, OVERPLOT/ROW, PLOT/COL, OVERPLOT/COL
\ees\exs
Examples:
\ex
            PLOT/ROW myframe @256 @10,@100 
            This command will plot from image myframe.bdf line 256,
            pixels 10 to 100.
\xe\ex
            PLOT/ROW myframe 256 100,10 13.6,5
            This command will plot from image myframe.bdf the line corresponding
            to the y coordinate 256, in the range from 100 to 10 in world
            coordinates with a negative increment. The scales are in x:
            13.6 world coord. unit/mm.; in y: 13.6 intensity units/mm.
\xe\ex
            PLOT/ROW myframe 256 100,10 13.6,-100
            This command will plot from image myframe.bdf the line corresponding
            to the y coordinate 256, in the range from 100 to 10 in world
            coordinates with a negative increment. The scale along the x axis
            is again 13.6 world coord. unit/mm.; the plot will be 10 cm high.
\xe \sxe