1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
|
\name{plot.fasp}
\alias{plot.fasp}
\title{Plot a Function Array}
\description{
Plots an array of summary functions, usually associated with a
point pattern, stored in an object of class \code{"fasp"}.
A method for \code{plot}.
}
\usage{
\method{plot}{fasp}(x,formule=NULL, \dots,
subset=NULL, title=NULL, banner=TRUE,
transpose=FALSE,
samex=FALSE, samey=FALSE,
mar.panel=NULL,
outerlabels=TRUE, cex.outerlabels=1.25,
legend=FALSE)
}
\arguments{
\item{x}{An object of class \code{"fasp"} representing a
function array.
}
\item{formule}{
A formula or list of formulae indicating what
variables are to be plotted against what variable. Each formula is
either an R language formula object, or a string that can be parsed
as a formula. If \code{formule} is a list, its \eqn{k^{th}}{k-th} component
should be applicable to the \eqn{(i,j)^{th}}{(i,j)-th}
plot where \code{x$which[i,j]=k}. If the formula is left
as \code{NULL}, then \code{plot.fasp} attempts to use the component
\code{default.formula} of \code{x}. If that component is NULL
as well, it gives up.
}
\item{\dots}{
Arguments passed to \code{\link{plot.fv}} to control
the individual plot panels.
}
\item{subset}{
A logical vector, or a vector of indices, or an
expression or a character string, or a \bold{list} of such,
indicating a subset of the data to be included in each plot.
If \code{subset} is a list, its \eqn{k^{th}}{k-th} component
should be applicable to the \eqn{(i,j)^{th}}{(i,j)-th} plot
where \code{x$which[i,j]=k}.
}
\item{title}{
Overall title for the plot.
}
\item{banner}{
Logical. If \code{TRUE}, the overall title is plotted.
If \code{FALSE}, the overall title is not plotted
and no space is allocated for it.
}
\item{transpose}{
Logical. If \code{TRUE}, rows and columns will be exchanged.
}
\item{samex,samey}{
Logical values indicating whether all individual plot panels should have the
same x axis limits and the same y axis limits, respectively.
This makes it easier to compare the plots.
}
\item{mar.panel}{
Vector of length 4 giving the value of the
graphics parameter \code{mar} controlling the size of plot margins
for each individual plot panel. See \code{\link{par}}.
}
\item{outerlabels}{Logical.
If \code{TRUE}, the row and column names of the array of functions
are plotted in the margins of the array of plot panels.
If \code{FALSE}, each individual plot panel is labelled by its
row and column name.
}
\item{cex.outerlabels}{
Character expansion factor for row and column labels of array.
}
\item{legend}{
Logical flag determining whether to plot a legend in each panel.
}
}
\details{
An object of class \code{"fasp"} represents
an array of summary functions, usually associated with a point
pattern. See \code{\link{fasp.object}} for details.
Such an object is created, for example,
by \code{\link[spatstat.explore]{alltypes}}.
The function \code{plot.fasp} is
a method for \code{plot}. It calls \code{\link{plot.fv}} to plot the
individual panels.
For information about the interpretation of the
arguments \code{formule} and \code{subset},
see \code{\link{plot.fv}}.
Arguments that are often passed through \code{...} include
\code{col} to control the colours of the different lines in a panel,
and \code{lty} and \code{lwd} to control the line type and line width
of the different lines in a panel. The argument \code{shade}
can also be used to display confidence intervals or significance bands
as filled grey shading. See \code{\link{plot.fv}}.
The argument \code{title}, if present, will determine the
overall title of the plot. If it is absent, it defaults to \code{x$title}.
Titles for the individual plot panels will be taken from
\code{x$titles}.
}
\value{None.}
\section{Warnings}{
(Each component of) the \code{subset} argument may be a
logical vector (of the same length as the vectors of data which
are extracted from \code{x}), or a vector of indices, or an
\bold{expression} such as \code{expression(r<=0.2)}, or a text string,
such as \code{"r<=0.2"}.
Attempting a syntax such as \code{subset = r<=0.2} (without
wrapping \code{r<=0.2} either in quote marks or in \code{expression()})
will cause this function to fall over.
Variables referred to in any formula must exist in the data frames
stored in \code{x}. What the names of these variables are will
of course depend upon the nature of \code{x}.
}
\seealso{
\code{\link[spatstat.explore]{alltypes}},
\code{\link{plot.fv}},
\code{\link{fasp.object}}
}
\examples{
if(interactive()) {
X.G <- alltypes(amacrine,"G")
plot(X.G)
plot(X.G,subset="r<=0.2")
plot(X.G,formule=asin(sqrt(cbind(km,theo))) ~ asin(sqrt(theo)))
plot(X.G,fo=cbind(km,theo) - theo~r, subset="theo<=0.9")
}
}
\author{\adrian
and \rolf
}
\keyword{spatial}
\keyword{hplot}
|