home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / help / base / par < prev    next >
Encoding:
Text File  |  1997-04-23  |  11.8 KB  |  288 lines
  1.     
  2.     _S_e_t _o_r _Q_u_e_r_y _G_r_a_p_h_i_c_a_l _P_a_r_a_m_e_t_e_r_s
  3.     
  4.          par(...)
  5.     
  6.     _D_e_s_c_r_i_p_t_i_o_n:
  7.     
  8.          par can be used to set or query graphical parameters.
  9.          Parameters can be set by specifying them as arguments
  10.          to par" in tag=value form, or by passing them as a list
  11.          of tagged values.  In either case the previous values
  12.          are returned in an invisible tagged list.  Such a list
  13.          can be passed as an arument to par to restore the
  14.          parameter values.
  15.     
  16.          Parameters are queried by giving vectors of character
  17.          strings to par.  In this case, the values are returned
  18.          in a tagged list.
  19.     
  20.     _A_r_g_u_m_e_n_t_s:
  21.     
  22.                   adj : The value of adj determines the way in
  23.                         which text strings are justified.  A
  24.                         value of 0 produces right left-justified
  25.                         text, 0.5 centered text and 1 right-
  26.                         justified text.
  27.     
  28.                   ann : If set to FALSE, high-level plotting
  29.                         functions do not annotate the plots they
  30.                         produce with axis and overall titles.
  31.                         The default is to do annotation.
  32.     
  33.                    bg : The color to be used for the background
  34.                         of plots.  A description of how colors
  35.                         are specified is given below.
  36.     
  37.                   bty : A character string which determined the
  38.                         type of box which is drawn about plots.
  39.                         If bty is one of are "o", "l", "7" or
  40.                         "c" the resulting box resembles the
  41.                         corresponding upper case letter.  A
  42.                         value of "n" suppresses the box.
  43.     
  44.                   cex : A numerical value giving the amount by
  45.                         which plotting text and symbols should
  46.                         be scaled relative to the default.
  47.     
  48.              cex.axis : The magnification to be used for axis
  49.                         anotation relative to the current.
  50.     
  51.               cex.lab : The magnification to be used for x and y
  52.                         labels relative to the current.
  53.     
  54.              cex.main : The magnification to be used for main
  55.                         titles relative to the current.
  56.     
  57.               cex.sub : The magnification to be used for sub-
  58.                         titles relative to the current.
  59.     
  60.                   col : A specification for the default plotting
  61.                         color.  A description of how colors are
  62.                         specified is given below.
  63.     
  64.              col.axis : The color to be used for axis annota-
  65.                         tion.
  66.     
  67.               col.lab : The color to be used for x and y labels.
  68.     
  69.              col.main : The color to be used for plot main
  70.                         titles.
  71.     
  72.               col.sub : The color to be used for plot sub-
  73.                         titles.
  74.     
  75.                   crt : A numerical value specifying (in
  76.                         degrees) how strings should be rotated.
  77.                         It is unwise to expect values other than
  78.                         multiples of 90 to work.
  79.     
  80.                   csi : (Unimplemented) The height of characters
  81.                         in inches.
  82.     
  83.                   err : (Unimplemented) The degree of error
  84.                         reporting desired.
  85.     
  86.                    fg : The color to be used for the foreground
  87.                         of plots.  This is the default color is
  88.                         used for things like axes and boxes
  89.                         around plots.  A description of how
  90.                         colors are specified is given below.
  91.     
  92.                   fig : A numerical vector of the form
  93.                         c(x1,x2,y1,y2) which gives the (NDC)
  94.                         coordinates of the figure region in the
  95.                         display region of the device.
  96.     
  97.                   fin : A numerical vector of the form c(x,y)
  98.                         which gives the size of the figure
  99.                         region in inches.
  100.     
  101.                  font : An integer which specifies which font to
  102.                         use for text.  If possible, device
  103.                         drivers arrange so that 1 corresponds to
  104.                         plain text, 2 to bold face, 3 to italic
  105.                         and 4 to bold italic.
  106.     
  107.                   lab : A numerical vector of the form
  108.                         c(x,y,len) which modifies the way that
  109.                         axes are annotated.  The values of x and
  110.                         y give the (approximate) number of tick-
  111.                         marks on the x and y axes and len
  112.                         species the label size.  Currently, len
  113.                         is unimplemented.
  114.     
  115.                   las : (Unimplemented) the style of axis
  116.                         labels.  0=always parallel to the axis,
  117.                         1=always horizontal, 2=always perpendic-
  118.                         ular to the axis.
  119.     
  120.                   lty : The line type.  Line types can either be
  121.                         specified as an integer (1=solid,
  122.                         2=dashed, 3=dotted 4=dotdashed) or as
  123.                         one of the character strings "solid",
  124.                         "dashed", "dotted" or "dotdashed".
  125.                         Alternatively, a string of up to 8 char-
  126.                         acters may be given, giving the length
  127.                         (in points) of line segments which are
  128.                         alternatively drawn and skipped.  For
  129.                         example, "44" is dashed and "13" is dot-
  130.                         ted.
  131.     
  132.                   mai : A numerical vector of the form
  133.                         c(xb,xt,yl,yr) which gives the margin
  134.                         size specified in inches.
  135.     
  136.                   mar : A numerical vector of the form
  137.                         c(xb,xt,yl,yr) which gives the lines of
  138.                         margin to be specified on the four sides
  139.                         of the plot.  The default is
  140.                         c(5,4,4,2)+0.1.
  141.     
  142.                   mex : mex is a character size expansion factor
  143.                         which is used to describe coordinates in
  144.                         the margins of plots.
  145.     
  146.                 mfcol : This is a vector of the form c(r,c).
  147.                         Subsequent figures will be drawn in an
  148.                         r-by-c array on the device by columns.
  149.     
  150.                   mfg : A numerical vector of the form
  151.                         c(i,j,r,c) where i and j indicate which
  152.                         figure in an r-by-c array of figures is
  153.                         currently being drawn.
  154.     
  155.                 mfrow : This is a vector of the form c(nr,nc).
  156.                         Subsequent figures will be drawn in an
  157.                         r-by-c array on the device by rows.
  158.     
  159.                   mgp : The margin line for the axis title, axis
  160.                         labels and axis line.  The default is
  161.                         c(3,1,0).
  162.     
  163.                   mkh : The height in inches of symbols to be
  164.                         drawn when the value of pch is an
  165.                         integer.
  166.     
  167.                   oma : A vector of the form c(xb,xt,yl,yr) giv-
  168.                         ing the size of the outer margins in
  169.                         lines of text.
  170.     
  171.                   omd : A vector of the form c(x1,x2,y1,y2) giv-
  172.                         ing the NDC coordinates of the region
  173.                         where (multiple) figures will appear on
  174.                         the device.
  175.     
  176.                   omi : A vector of the form c(xb,xt,yl,yr) giv-
  177.                         ing the size of the outer margins in
  178.                         inches.
  179.     
  180.                   pch : Either an integer specifying a symbol or
  181.                         a single character to be used as the
  182.                         default in plotting.
  183.     
  184.                   pin : The width and height of the current plot
  185.                         in inches.
  186.     
  187.                   plt : A vector of the form c(x1,x2,y1,y2) giv-
  188.                         ing the the coordinates of the plot
  189.                         region as fractions of the current fig-
  190.                         ure region.
  191.     
  192.                   pty : A character specifying the type of plot
  193.                         region to be used; "s" generates a
  194.                         square plotting region and "m" generates
  195.                         the maximal plotting region.
  196.     
  197.                   smo : (Unimplemented) a value which indicates
  198.                         how smooth circles and circular arc
  199.                         should be.
  200.     
  201.                   srt : The string rotation in degrees.  Causes
  202.                         srt to be set to the same value.
  203.     
  204.                   tck : The length of tick marks as a fraction
  205.                         of the smaller of the width or height of
  206.                         the plotting region.  If tck=1, grid
  207.                         lines are drawn.  The default value is
  208.                         -0.2.
  209.     
  210.                  tmag : A number specifying the enlargement of
  211.                         text of the main title relative to the
  212.                         other annotating text of the plot.
  213.     
  214.                   usr : A vector of the form c(x1,x2,y1,y2) giv-
  215.                         ing the extremes of the user coordinates
  216.                         of the plotting region.
  217.     
  218.                  xaxp : A vector of the form c(x1,x2,n) giving
  219.                         the coordinates of the extreme tick
  220.                         marks and the number of intervals
  221.                         between tick-marks.
  222.     
  223.                  xaxs : (Unimplemented) The style of axis inter-
  224.                         val calculation to be used for the x-
  225.                         axis.
  226.     
  227.                  xaxt : A character which specifies the axis
  228.                         type.  Specifying "n" causes an axis to
  229.                         be set up, but not plotted.
  230.     
  231.                  xlog : A logical value. If TRUE a logarithmic
  232.                         scale is used.  The default is to use a
  233.                         linear scale.
  234.     
  235.                   xpd : A logical value.  If FALSE, all plotting
  236.                         is clipped to the plot region.
  237.     
  238.                  yaxp : A vector of the form c(y1,y2,n) giving
  239.                         the coordinates of the extreme tick
  240.                         marks and the number of intervals
  241.                         between tick-marks.
  242.     
  243.                  yaxs : (Unimplemented) The style of axis inter-
  244.                         val calculation to be used for the y-
  245.                         axis.
  246.     
  247.                  yaxt : A character which specifies the axis
  248.                         type.  Specifying "n" causes an axis to
  249.                         be set up, but not plotted.
  250.     
  251.                  ylog : A logical value. If TRUE a logarithmic
  252.                         scale is used.  The default is to use a
  253.                         linear scale.
  254.     
  255.     _C_o_l_o_r _S_p_e_c_i_f_i_c_a_t_i_o_n
  256.     
  257.          Colors can be specified in several different ways.  The
  258.          simplest way is with a character string giving the
  259.          color name (eg. "red").  A list of the possible colors
  260.          can be obtained with the function colors.  Alterna-
  261.          tively, colors can be specified directly in terms of
  262.          there RGB components with a string of the form
  263.          "#RRGGBB" where each of the pairs RR, GG, BB consist of
  264.          two hexidecimal digits giving a value in the range 00
  265.          to FF.  Colors can also be specified by giving an index
  266.          into a small table of colors.  This provides compati-
  267.          bility with S.
  268.     
  269.          The functions rgb, hsv, gray and rainbow provide addi-
  270.          tional ways of generating colors.
  271.     
  272.     _L_i_n_e _T_y_p_e _S_p_e_c_i_f_i_c_a_t_i_o_n
  273.     
  274.          Line types can either be specified by giving an index
  275.          into a small built in table of line types (1=solid,
  276.          2=dashed, 3=dotted) or directly as the lengths of
  277.          on/off stretches of line.  This is done with a string
  278.          of up to eight characters which give the lengths in
  279.          consecutive positions in the string.  For example, the
  280.          string "33" specifies three pixels on followed by three
  281.          off and "3313" specifies three pixels on followed by
  282.          three off followed by one on and finally three off.
  283.     
  284.     _S_e_e _A_l_s_o:
  285.     
  286.          colors, gray, options, rainbow, rgb.
  287.     
  288.