Image {IDPmisc} | R Documentation |
The density of points in a scatter plot is encoded by color.
Image(x, y = NULL, pixs = 1, zmax = NULL, ztransf = function(x){x}, colramp = IDPcolorRamp, factors = c(FALSE, FALSE))
x, y |
Coordinates of points whose density is plotted. If
x ist a matrix or a data.frame, the first two column are used as x
and y respectively. y must be in this case NULL. x and
y may be numeric or factor variable. |
pixs |
Size of pixel in x- and y-direction in [mm] on the
plotting device. When x and y are numeric,
pixels are square. When x and y are factors or should
be handled as factors (see argument factors ), pixels are no
longer square. The pixels are enlarged in the dimension in which the
factors are displayed, so that the rectangular pixels are centered
at the factor levels. |
zmax |
Maximum counts per Pixel to be plotted. When NULL
the density in the scatter plot is encoded from 0 pixel to maximum
number of pixels found. zmax must be equal or larger than
maximum counts found. |
ztransf |
Function to transform the counts. The user has to make
sure that the transformed counts lie in the range [0,zmax], where
zmax is any positive number (>=2). For examples see
ipairs and ilagplot |
colramp |
Color ramp to encode the density of the points within a pixel by color. |
factors |
Vector of logicals indicating whether x and / or
y should be handled as factors
independently of their class . |
Before calling Image
a plot must have been created by, e.g.,
calling plot(x,y,type="n")
. This function ensures
by default that the pixel has the same size in x- and y-direction. As
a drawback, pixels may be unequally spaced, when there are only very
few distinct (integer) values in x- or y-direction. When this is the case, the
corresponding dimension should be declared as factor. (cf. argument
factors
).
A similar solution for plotting densities is realized in the package
fields:
image.count
. The main differences between the
solution in IDPmisc and fields are the following: In
Image
the pixel size is defined in mm on the plotting device
whereas in image.count
the number of pixels in
x- and y-direction are defined. Image
works on ordinary plots
whereas image.count
needs the special plotting
function image.plot
. In addition, Image
also works with factors as x- and / or y-coordinates.
This function is based on graphics
Maximum number of counts per Pixel found.
Andreas Ruckstuhl, Rene Locher
ipairs
, ilagplot
,
ixyplot
, image
,
image.count
x <- rnorm(10000) y <- rnorm(10000,10) plot(x+y,y,type="n") Image(x+y,y) abline(a=0,b=1) ## plot.default(iris$Species,iris$Petal.Width, xlim=c(0.5,3.5), type="n",axes=FALSE) axis(1,at=1:3,lab=levels(iris$Species)) axis(2) Image(iris$Species,iris$Petal.Width,pixs=3) ## The above can be merged to ixyplot(iris$Species,iris$Petal.Width,pixs=3, minL.lab=10)