with.hyperframe

0th

Percentile

Evaluate an Expression in Each Row of a Hyperframe

An expression, involving the names of columns in a hyperframe, is evaluated separately for each row of the hyperframe.

Keywords
manip, spatial, programming
Usage
## S3 method for class 'hyperframe':
with(data, expr, ...,
                         simplify = TRUE,
                         ee = NULL, enclos=NULL)
Arguments
data
A hyperframe (object of class "hyperframe") containing data.
expr
An Rlanguage expression to be evaluated.
...
Ignored.
simplify
Logical. If TRUE, the return value will be simplified to a vector whenever possible.
ee
Alternative form of expr, as an object of class "expression".
enclos
An environment in which to search for objects that are not found in the hyperframe. Defaults to parent.frame().
Details

This function evaluates the expression expr in each row of the hyperframe data. It is a method for the generic function with. The argument expr should be an Rlanguage expression in which each variable name is either the name of a column in the hyperframe data, or the name of an object in the parent frame (the environment in which with was called.) The argument ee can be used as an alternative to expr and should be an expression object (of class "expression"). For each row of data, the expression will be evaluated so that variables which are column names of data are interpreted as the entries for those columns in the current row.

For example, if a hyperframe h has columns called A and B, then with(h, A != B) inspects each row of data in turn, tests whether the entries in columns A and B are equal, and returns the $n$ logical values.

Value

  • Normally a list of length $n$ (where $n$ is the number of rows) containing the results of evaluating the expression for each row. If simplify=TRUE and each result is a single atomic value, then the result is a vector or factor containing the same values.

See Also

hyperframe, plot.hyperframe

Aliases
  • with.hyperframe
Examples
# generate Poisson point patterns with intensities 10 to 100
   H <- hyperframe(L=seq(10,100, by=10))
   X <- with(H, rpoispp(L))
Documentation reproduced from package spatstat, version 1.37-0, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.