Revision d606122dc24b56ecf537d55eda38f4bf5ac4de1f authored by Adrian Baddeley on 25 October 2010, 10:40:51 UTC, committed by cran-robot on 25 October 2010, 10:40:51 UTC
1 parent 66bc933
eval.fasp.Rd
\name{eval.fasp}
\alias{eval.fasp}
\title{Evaluate Expression Involving Function Arrays}
\description{
Evaluates any expression involving one or more function arrays
(\code{fasp} objects)
and returns another function array.
}
\usage{
eval.fasp(expr, envir)
}
\arguments{
\item{expr}{An expression.}
\item{envir}{Optional. The environment in which to evaluate the expression.}
}
\details{
This is a wrapper to make it easier to perform
pointwise calculations with the arrays of summary functions
used in spatial statistics.
A function array (object of class \code{"fasp"}) can be regarded as a matrix
whose entries are functions. Objects of this kind
are returned by the command \code{\link{alltypes}}.
Suppose \code{X} is an object of class \code{"fasp"}.
Then \code{eval.fasp(X+3)} effectively adds 3 to the value of
every function in the array \code{X}, and returns
the resulting object.
Suppose \code{X} and \code{Y} are two objects of class \code{"fasp"}
which are compatible (for example the arrays
must have the same dimensions). Then
\code{eval.im(X + Y)} will add the corresponding functions in
each cell of the arrays \code{X} and \code{Y},
and return the resulting array of functions.
In general, \code{expr} can be any expression involving
(a) the \emph{names} of objects of class \code{"fasp"}, (b) scalar
constants, and (c) functions which are vectorised.
See the Examples.
First \code{eval.fasp} determines which of the \emph{variable names}
in the expression \code{expr} refer to objects of class \code{"fasp"}.
The expression is then evaluated for each cell of the array
using \code{\link{eval.fv}}.
The expression \code{expr} must be vectorised.
There must be at least one object of class \code{"fasp"} in the expression.
All such objects must be compatible.
}
\value{
Another object of class \code{"fasp"}.
}
\seealso{
\code{\link{fasp.object}},
\code{\link{Kest}}
}
\examples{
# manipulating the K function
data(amacrine)
K <- alltypes(amacrine, "K")
# expressions involving a fasp object
eval.fasp(K + 3)
L <- eval.fasp(sqrt(K/pi))
# expression involving two fasp objects
eval.fasp(K - L)
}
\author{Adrian Baddeley
\email{adrian@maths.uwa.edu.au}
\url{http://www.maths.uwa.edu.au/~adrian/}
and Rolf Turner
\email{r.turner@auckland.ac.nz}
}
\keyword{spatial}
\keyword{manip}
\keyword{programming}
Computing file changes ...