%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1988-2008 European Southern Observatory
%.IDENT      set_grap.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, SET/GRAPHICS
%.PURPOSE    On-line help file for the command: SET/GRAPHICS
%.VERSION    1.0  15-JUL-1988: Creation, RHW
%.VERSION    1.1  12-MAR-1992: Chnaged to SET/GRAPHICS, RHW
%----------------------------------------------------------------
\se
SECTION./GRAP
\es\co
SET/GRAPHICS                                                    20-NOV-2008 RHW
\oc\su
SET/GRAPHICS option1[=value1] option2[=value2] ...
	set plot characteristics
\us\pu
Purpose:      
              Set plot characteristics.
\up\sub
Subject:      
              Graphics.
\bus\sy
Syntax:       
              SET/GRAPHICS option1[=value1] option2[=value2] ...
\ys\pa
              option    = plot characteristics to be set (to value)
			  as specified below
\ap\pa
              DEFAULT=    no value; sets plot package in default mode (below)
\ap\pa
              XAXIS=      AUTO or xstart,xend,xbig,xsmall in world coordinates;
                          define the x-axis labelled from xstart to xend.
                          If xbig > 0 use that for the spacing of the large
                          ticks and try to use xsmall for the small ticks.
                          If xsmall < 0 make a logarithmic axis; if xsmall is
                          not given xsmall = xbig; for xsmall = xbig =0 the 
                          default values for the ticks are used; default AUTO
\ap\pa
              YAXIS=      AUTO or ystart,yend,ybig,ysmall in world coordinates;
                          for explanation see above (XAXIS)
\ap\pa
              ZAXIS=      AUTO or zstart,zend,zbig,zsmall in world coordinates;
                          for explanation see above (XAXIS)
\ap\pa 
              FRAME=      REctangular or SQuare to set the coordinate frame 
                          (box) in rectangular (default) of square mode. If
                          this option is used previous setting(s) of the XSCALE 
                          and/or YSCALE value(s) will be overwritten  
\ap\pa
              XSCALE=     AUTO, or xscale[,cu]: scale or size of the plot 
                          in the x direction, and optionally the coordinate 
                          units (cu). Coordinate units can be: WO (for world 
                          coordinates/mm), MM (for size of the plot in mm),
                          SC (for size of the plot in screen coordinates), or
                          NR (for normalized  units, running from 0,0, to 1,1). 
                          Without coordinate units a positive number for xscale 
                          is interpreted as world units/mm; a negative number 
                          is interpreted as the plotsize in mm units (axis will 
                          be made that among of mm. long in thex direction).
                          The AUTO setting will make a plot that fills the 
                          available space in the x direction. If this option is 
                          used the previous setting of the FRAME option will be 
                          overwritten (set to `RECT')
\ap\pa
              YSCALE=     AUTO or yscale. For explanation see above (XSCALE)
\ap\pa
              XOFFSET=    DEFault, or xoffset[,cu]: the distance of the plot 
                          with respect to the left boundary of the graphics 
                          device in cu units. Offset can be in millimeter (MM), 
                          screen coordinates (SC), or normalized  units (NR). 
                          The default value DEF will place the plot at the left 
                          of the graphics device.
\ap\pa
              YOFFSET=    Default, or yoffset[,cu]: the distance of the plot 
                          with respect to the top boundary of the graphics 
                          device in cu units. For coordinate details see above.
                          The default value NONE will place the plot at the top 
                          of the graphics device.
\ap\pa
              XFORMAT=    NONE, AUTO, or format. Format specification to draw 
                          the tickmark labels. The string can contain some of 
                          the standard C or FORTRAN format specification as 
                          well as a set of special format specifications listed
                          below.
                          For the standard notation w defines the minimum width
                          of the field, p the number of decimal positions.
                          Format strings between square brackets are defaulted.
                          Standard formats are:
                          \ \ \ [w.p]d (C): decimal integer (comp. F77 Iw.d);
                          \ \ \ [w.p]f (C): floating point (comp. F77 Fw.d);
                          \ \ \ [w.p]e (C): exp. format (comp. F77 Ew.d);
                          \ \ \ I[w.p] (F): decimal integer (eg I6.3 = 6.3d);
                          \ \ \ F[w.p] (F): floating point (eg F8.5 = 8.5f);
                          \ \ \ E[w.p] (F): exp. format (eg E15.3 = 15.3e);
                          Special formats are: 
                          \ \ \ g      (S): as f format, but strips all 
                          \ \ \             zeroes and decimal point 
                          \ \ \ p      (S): write only the power of 10;
                          \ \ \ x      (S): write only the powers of e;
                          \ \ \ [a/h][u][m][s][s][s]...: astronomical notation,
                          \ \ \ where:
                          \ \ \ [a/h]     : degrees (a) or hours (h);
                          \ \ \ [u]       : units;
                          \ \ \ [m]       : minites;
                          \ \ \ [s]       : seconds;
                          \ \ \ [s]       : first digit of fraction;
                          \ \ \ [s]       : second digit of fraction;
                          \ \ \ [s]       : etc...
                          With AUTO you will obtain (hopefully) an axis with 
                          sensible tickmarks. In case the format is set to NONE 
                          no tickmark label will be written. Default is AUTO.
\ap\pa
              YFORMAT=    NONE, AUTO or format description; see XFORMAT
\ap\pa
              ZFORMAT=    NONE, AUTO or format description; see XFORMAT
\ap\pa
              PMODE=      Plot mode in which the plot package will run. 
                          Depending on the PMODE the graphics package writes
                          additional information on the graphics output;
                          -1 -- plot without frame and legend; 0 -- plot with 
                          data and axes only; 1 -- plot with data, frame and 
                          some information; 2 -- plot with frame and full 
                          legend; default is 2
\ap\pa
              FONT=       Font to be used to write text in the graphic output:
                          0 -- Standard simple default font; 1 -- Roman font;
                          2 -- Greek font; 3 -- Script font; 4 -- Old English 
                          font; 5 -- Tiny roman font; default is 0.
\ap\pa
              LTYPE=      number: 0 -- no line at all ; 
                          1 -- solid; 2 -- dotted; 3 -- short dash; 
                          4 -- dash - dot; 5 -- long dash;  
                          6 -- dash - dot - dot; default is 1
\ap\pa
              LWIDTH=     n ranging from 1 to 4; 1 corresponds with single
                          width, 2 with double width, etc. Default is 1
\ap\pa
              STYPE=      number: 0 -- no symbol; 1 -- dot; 2 -- hexagon; 
                          3 -- square; 4 -- triangle; 5 -- cross (+);
                          6 -- cross (x); 7 -- asterisk; 8 -- star;
                          9 -- crossed square (+); 10 -- crossed square (x);
                          11 -- lozenge; 12 -- hor. bar; 13 -- vert. bar;
                          14 -- right arrow; 15 -- arrow up; 16 -- left arrow;
                          17 -- arrow down; 18 -- filled hexagon; 19 -- filled
                          square; 20 -- filled triangle; 21 -- filled lozenge;
                          A symbol can also be a character as defined in the 
                          decimal ASCII character set: numbers between 33 - 126
                          48 -- 0; 65 -- A; 97 -- a; Default is 5 (cross: +)
\ap\pa
              SSIZE=      number: symbol size multiplication factor; 
                          default is 1
\ap\pa
              TSIZE=      number: character size multiplication factor; 
                          default is 1
\ap\pa
              TWIDTH=     integer number: set line width for text strings. This
                          feature is not supported on all graphics devices. 
                          Higher values will increase the thickness if the 
                          characters. This option is supported for a limited 
                          number of devices (e.g. postscript printer, NOT for 
                          graphics windows). Default is 1
\ap\pa
              BINMODE=    OFF or ON: mode in which lines will be drawn between 
                          the data points. OFF will connect the points with 
                          a simple straight line; ON will connect the points
                          in a histogram-like manner. This mode will ONLY work
                          for equally spaced data. Hence, table data are 
                          excluded and will always be drawn with BINMODE=OFF;
                          default is OFF
\ap\pa
              COLOUR=     integer number ranging from 0 to 8: 
			  the colour black is the initial default (1). 
			  The available colours are: 
                          default background (0), black (1), red (2), green (3),
			  blue (4), yellow (5), magenta (6) cyan (7), white (8).
			  Invalid input sets colour to 0, the default 
			  background colour, currently white.
			  Or input colour directly as string (for 1-8 above): 
                          BLACK, RED, ..., WHITE
\ap\pa
              COLMODE=    SUB or XOR: set the graphic write mode. In case of 
                          SUB the colour written on the graphics device will
                          simply substitute the background colour (overwrite).
                          In case of XOR the system will adjust the colour
                          depending on the background. Default is SUB
\ap\pa
              BCOLOUR=    background colour specified like COLOUR above,
			  the colour white is the initial default (8). 
                          The new background colour will only be activated 
                          after a PLOT command in which the display is cleared
                          first. 
\ap\pa
              CLEARGRA=   OFF or ON: clear the graphics device before a new 
                          plot is produced. This option will only work for real
                          PLOT commands; OVERPLOT commands are NOT affected.
                          Using this option in combination with scale and
                          offset settings, one can plot a number of graphs on
                          the graphics device with a relatively	small number of 
                          commands. Default is ON: graphics device will be 
                          cleared at every PLOT command
\ap\no
Note:
              The format for astronomical coordinates notations does not work
              properly. The bug will be fixed. Also, the automatic format 
              adjustment is not working.

              When in mode BINMODE OFF the user wants to plot a line of
              an image or a descriptor, the plot package first looks for the
              line type. If the line type is set to 0 (LTYPE=0) it looks
              for a symbol (STYPE). If both LTYPE and STYPE are set to
              0 a warning is issued. In cases of histogram plotting or when
              the bin mode is on (BINMODE=ON) the package assumes a line type
              greater than zero; an error occurs when LTYPE=0.

              In the case of table plotting the package first looks for the
              symbol type. If STYPE is 0 (STYPE=0) a line will be drawn
              corresponding with LTYPE. A warning message is given when both
              LTYPE and STYPE are set to 0.

              In case one plots data using a line type not equal 1, the (dotted
              or dashed) line may look irregular. This can be due to rounding 
              errors or crowding of the (not equally spaced) data points.

              The option COLMODE=XOR does not always work really well when 
              COLOUR and BCOLOUR both have specified the same COLOUR.

              The scales of a plot may change if a plot is sent to a device 
              other than the original one (pre-specified by ASSIGN/GRAP).
              In general the axis ratio of the frame will have changed, and
              hence a square frame WILL NOT BE A SQUARE FRAME ANYMORE if
              you use COPY/GRAPHICS to dump your plot on another device.

              Special character like ``+'', ``-'',``('' cannot be printed using
              the fonts 2 and 4 (Greek and Old English). In additional to the 
              various fonts, text can be drawn with a number of options. For 
              example, to write formulae in the graphics output, to use 
              mathematical and astronomical symbols, etc. Also, ``LaTeX/TeX 
              like'' symbols can be used. For reference have a look at  The 
              MIDAS User's Guide, Volume A, Chapter 6. 

              The graphics setup is stored in a number of special keywords:
              PLISTAT, PLRSTAT, PLCSTAT, PLCMETA, PLCDATA, and PLRGRAP. For  
              more information about the graphics and these keywords read the 
              MIDAS Environment document or use the command HELP/KEYWORD.
\on\see
See also:     
              SHOW/GRAPHICS, LABEL/GRAPHICS, ASSIGN/GRAPHICS
	      Chapter 6 of the the MIDAS User's Guide, Vol. A.
\ees\exs
Examples:
\ex
              SET/GRAPHICS XAXIS=4000,1000,500,100
                set frame of x-axis manually from 4000 to 1000 with negative
                increment of 500
\xe\ex        
              SET/GRAPHICS xax=0,24,6,3 xfo=hu yax=-10,-8,.3,.1 yfo=aums
                set frame of x-axis manually from 0 to 24 hours with a ticks
                mark distance of 6 hours and small ticks every 3 hours. In the 
                y direction the graph will run from -10 degrees to -8 degrees 
                with ticks every 18 arcmin and small ticks every 6 arcsec.
\xe\ex
              SET/GRAPHICS XAXIS YAXIS=-2,2,1,-1 YFORM=p 
                set frame of y-axis manually in logarithmic mode from 0.01 
                to 100 with increment of one order of magnitude. Use the
                power ten notation for the tick marks labels. Set the default
                range and steps for the x-axis; for the x-axis the graphic
                package will find sensible values (I hope). 
\xe\ex
              SET/GRAPHICS LTYPE=1 BINMODE=ON
                set the line type to 1 (solid line) and plot in bin mode
\xe\ex
              SET/GRAPHICS colour=1 BCOLO=yellow
                set the plotting colour to black and background to yellow 
		colour.
\xe \sxe

