%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2009 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    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						01-DEC-2009 RHW,KB 
\oc\su
PLOT/ROW frame [y_coord] [x_sta,x_end] [x_sc,y_sc[,x_off,y_off]] 
	 [multi_color_option] [2ndcol_spec] [x-label] [y-label]
	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]]
		     [multi_color_option] [2ndcol_spec] [x-label] [y-label]
\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). 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\pa
            multi_color_option = data interval (1) or color data (2),
		for (1) interval:
		    low_val,hi_val			(a)
		    low_val,hi_val(@row)		(b)
		    low_val,hi_val(frame,@row)		(c)
		    optional intensity interval where to use different colour;
		    use pixels in same line (a),
		    in another line in same frame (b), 
		    or in another line in another frame (c)
		    low_val = "<" for lowest value, hi_val = ">" for highest
		    value are possible
		    (row no.s begin with 1)
		for (2) color data:
		    c=color_image,@row			(a)
		    c=@row				(b)
		    use color values from image `color_image' or different
		    row from plotted frame
\ap\pa
            2ndcol_spec = in_color,out_color - only neeed for (1) above
		    instead of the default color chosen via SET/GRAPH COLOR=n
		    all pixels with intensities in `interval' are
		    plotted with `in_color' 
		    if out_color is provided, all pixels with intensities
		    outside `interval' are plotted with that color,
		    else they are plotted with the current default color
		    pixels are chosen according to (a), (b), (c) of `interval'
		    parameter
		    the colors can be given as plot_col no.s or directly as
		    one of: black(1), red(2), green(3), blue(4), yellow(5), 
			    magenta(6), cyan(7), white(8)
\ap\pa
	    x-label = optional label for x-axis, of max. 60 chars
		    defaulted to: Position 
\ap\pa
	    y-label = optional label for y-axis, of max. 60 chars
		    defaulted to: Pixel value
\ap\no
Note:       
	    The max. length of file names for plotting is 60 chars.
               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. 
	       If parameter `multi_color_option' is used and an image is 
	    interpreted as color data the values must be in the interval 
	    [1,8] for valid colors.
\on\see
See also:   
            SET/GRAPHICS, SHOW/GRAPHICS, 
	    OVERPLOT/ROW, PLOT/COLUMN, OVERPLOT/COLUMN, OVERPLOT/ERROR
\ees\exs
Examples:
\ex
            PLOT/ROW manzana @256 @10,@100 
              Plot from image manzana.bdf line 256, pixels 10 to 100.
\xe\ex
            PLOT/ROW melon 256 100,10 13.6,5
              Plot from image melon.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 naranja 256 100,10 13.6,-100
              Plot from image naranja.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\ex
            PLOT/ROW platano @25 ? ? c=@100
              Plot row (line) 25 of image platano.bdf. The drawing color
	      is chosen according to the values in line 100 of platano.bdf.
\xe\ex
            PLOT/ROW durazno @25 p5=<,245.67 p6=2
              Plot row (line) 25 of image durazno.bdf. All pixels less than
              or equal to 245.67 are plotted in red (= color no. 2).
\xe\ex
            PLOT/ROW durazno @25 ? ? <,245.67(pera.fits,@10) red,blue
              Plot row (line) 25 of image durazno.bdf.
	      All pixels of row no. 25 where the corresponding pixel 
	      in row no. 10 of frame pera.fits is less than or equal to
              245.67 are plotted in red, else in blue (independent of current 
	      default color).
\xe\sxe
