The R Project SVN R

Rev

Rev 88598 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 88598 Rev 90197
Line 43... Line 43...
43 
    same color.}
 43 
    same color.}
44 
 \item{nlevels}{if \code{levels} is not specified, the range of \code{z},
 44 
 \item{nlevels}{if \code{levels} is not specified, the range of \code{z},
45 
    values is divided into approximately this many levels.}
 45 
    values is divided into approximately this many levels.}
46 
 \item{color.palette}{a color palette function to be used to assign
 46 
 \item{color.palette}{a color palette function to be used to assign
47 
    colors in the plot.}
 47 
    colors in the plot.}
48 
 \item{col}{an explicit set of colors to be used in the plot.
 48 
\item{col}{an explicit set of colors to be used in the plot.
49 
    This argument overrides any palette function specification.  There
 49 
    This argument overrides any palette function specification.
- 
 
 50 
    \bold{\code{col} must have \code{length(levels) - 1} elements}: if
- 
 
 51 
    it does not, a warning is given and the colors will be recycled or
50 
    should be one less color than levels}
 52 
    ignored when plotted, which can give misleading results (see
- 
 
 53 
    \sQuote{Details}).}
51 
 \item{plot.title}{statements which add titles to the main plot.}
 54 
 \item{plot.title}{statements which add titles to the main plot.}
52 
 \item{plot.axes}{statements which draw axes (and a \code{\link{box}})
 55 
 \item{plot.axes}{statements which draw axes (and a \code{\link{box}})
53 
   on the main plot.  This overrides the default axes.}
 56 
   on the main plot.  This overrides the default axes.}
54 
 \item{key.title}{statements which add titles for the plot key.}
 57 
 \item{key.title}{statements which add titles for the plot key.}
55 
 \item{key.axes}{statements which draw axes on the plot key.
 58 
 \item{key.axes}{statements which draw axes on the plot key.
Line 77... Line 80...
77 
  The values to be plotted can contain \code{NA}s.  Rectangles with two
 80 
  The values to be plotted can contain \code{NA}s.  Rectangles with two
78 
  or more corner values are \code{NA} are omitted entirely: where there
 81 
  or more corner values are \code{NA} are omitted entirely: where there
79 
  is a single \code{NA} value the triangle opposite the \code{NA} is
 82 
  is a single \code{NA} value the triangle opposite the \code{NA} is
80 
  omitted.
 83 
  omitted.
81 
 
 84 
 
82 
  Values to be plotted can be infinite: the effect is similar to that
 85 
Values to be plotted can be infinite: the effect is similar to that
83 
  described for \code{NA} values.
 86 
  described for \code{NA} values.
84 
 
 87 
 
- 
 
 88 
  If \code{levels} is not specified explicitly, it is computed as
- 
 
 89 
  \code{pretty(zlim, nlevels)}.  \code{\link{pretty}} chooses a
- 
 
 90 
  \dQuote{nice} set of levels and the number of levels it returns can
- 
 
 91 
  differ from \code{nlevels}: hence \code{length(levels) - 1}, the
- 
 
 92 
  number of colors \code{col} should have, is not always equal to
- 
 
 93 
  \code{nlevels - 1} or to \code{nlevels}.  If you supply \code{col}
- 
 
 94 
  explicitly, it is safest to first determine \code{levels} (either by
- 
 
 95 
  computing \code{pretty(zlim, nlevels)} yourself, or by passing
- 
 
 96 
  \code{levels} explicitly) and then set
- 
 
 97 
  \code{col} to have \code{length(levels) - 1} elements, rather than
- 
 
 98 
  guessing the count from \code{nlevels}.
- 
 
 99 
 
85 
  \code{.filled.contour} is a \sQuote{bare bones} interface to add
 100 
  \code{.filled.contour} is a \sQuote{bare bones} interface to add
86 
  just the contour plot to an already-set-up plot region.  It is is
 101 
  just the contour plot to an already-set-up plot region.  It is is
87 
  intended for programmatic use, and the programmer is
 102 
  intended for programmatic use, and the programmer is
88 
  responsible for checking the conditions on the arguments.
 103 
  responsible for checking the conditions on the arguments.
89 
}
 104 
}
90 
\references{
 105 
\references{