bind.fv
Combine Function Value Tables
Advanced Use Only.
Combine objects of class "fv"
,
or glue extra columns of data onto an existing "fv"
object.
Usage
## S3 method for class 'fv':
cbind(...)
bind.fv(x, y, labl = NULL, desc = NULL, preferred = NULL)
Arguments
- ...
- Any number of arguments, which are objects of class
"fv"
. - x
- An object of class
"fv"
. - y
- Either a data frame or an object of class
"fv"
. - labl
- Plot labels (see
fv
) for columns ofy
. A character vector. - desc
- Descriptions (see
fv
) for columns ofy
. A character vector. - preferred
- Character string specifying the column which is to be the new recommended value of the function.
Details
This documentation is provided
for experienced programmers who want to modify the internal
behaviour of
The function cbind.fv
is a method for the generic
Rfunction cbind
. It combines any number of
objects of class "fv"
into a single object of
class "fv"
. The objects must be compatible, in the sense
that they have identical values of the function argument.
The function bind.fv
is a lower level
utility which glues additional columns onto an
existing object x
of class "fv"
.
It has two modes of use:
- If the additional dataset
y
is an object of class"fv"
, thenx
andy
must be compatible as described above. Then the columns ofy
that contain function values will be appended to the objectx
. - Alternatively if
y
is a data frame, theny
must have the same number of rows asx
. All columns ofy
will be appended tox
.
labl
and desc
provide
plot labels and description strings (as described in fv
)
for the new columns. If y
is an object of class
"fv"
then labl
and desc
are optional, and
default to the relevant entries in the object y
.
If y
is a data frame then
labl
and desc
must be provided.
Value
- An object of class
"fv"
.
See Also
Undocumented functions for modifying an "fv"
object
include fvnames
, fvnames<-
,
tweak.fv.entry
and rebadge.fv
.
Examples
data(cells)
K1 <- Kest(cells, correction="border")
K2 <- Kest(cells, correction="iso")
# remove column 'theo' to avoid duplication
K2 <- K2[, names(K2) != "theo"]
cbind(K1, K2)
bind.fv(K1, K2, preferred="iso")
# constrain border estimate to be monotonically increasing
bm <- cumsum(c(0, pmax(0, diff(K1$border))))
bind.fv(K1, data.frame(bmono=bm),
"%s[bmo](r)",
"monotone border-corrected estimate of %s",
"bmono")