% @(#)set_grap.hlq 17.1.1.1 (ESO-IPG) 01/25/02 17:43:57 %++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ %.COPYRIGHT (c) 1990 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 15-JUL-1988 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 (value). The following options with their values are possible:\\ -1: data only; 0: data and a coordinate box; 1: data, a ccordinate box and minimal legend; 2: data and full legend. \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 7; the colour black is the default (1). This setting is only effective on image display devices (like workstations). The available colours are: default background (0) black (1), red (2), green (3), blue (4), yellow (5), magenta (6) cyan (7), white (8). Default colour is 0, the default background collour, currently 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= integer number: ranging from 0 to 8. Sets background as specified colour. The default background is white: 0. This option is hardware dependent and is effective only on image display devices (like the graphics window on workstations, and colour laser printers. The new background colour will only be activated after a PLOT command in which the display is cleared first. For the colour available, see above (COLOUR) \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, 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 \sxe