rvattach {rv} | R Documentation |
rattach
works like attach
but removes
objects from .GlobalEnv
that have conflicting names;
optionally can also impute vector components by name into the
object that is in .GlobalEnv
(copying the imputed object into the
attached list.
rvattach
first splits a named vector into a list, and then
uses rattach
to attach them to the search path.
rattach(what, name=deparse(substitute(what)), overwrite=TRUE, impute=FALSE, ...) rvattach(what, name=deparse(substitute(what)), overwrite=TRUE, impute=FALSE, ...)
what |
an rv object to be split up into a list of sub-vectors and attached |
name |
name to use for the attached database. All databases with the exact same name in the search path are removed first. |
overwrite |
If TRUE , objects with identical names in the workspace (.GlobalEnv ) that are masking objects in the database to be attached will be deleted. |
impute |
If TRUE , the components of each sub-vector are imputed into the object with identical name in the workspace and saved into the list. The object in the workspace is not affected (unless overwrite=TRUE ). |
... |
further arguments passed to attach |
rvattach
takes an rv object, splits it up into a list
of sub-vectors
(using split.rv
) by their name attributes and attaches the list
to the search path.
For example, if the object to be processed has names x[1]
and y[3]
,
this will be split into a list of two sub-vectors, x
and y
,
and then attached.
If the option impute is TRUE
, the corresponding variables
with the same names are merged with the ones that are found in .GlobalEnv
,
and copied into the database.
If the option overwrite is TRUE
, the objects with identical
names in the Workspace are deleted.
All databases with the exact same name in the search path are removed first.
Jouni Kerman jouni@kerman.com
Kerman, J. and Gelman, A. (2007). Manipulating and Summarizing Posterior Simulations Using Random Variable Objects. Statistics and Computing 17:3, 235-244.
See also vignette("rv")
.
# Trying rattach: x <- rvnorm(9) names(x) <- paste("theta[", 1+seq_along(x), "]", sep="") L <- list(x=x) x <- 1:10 rattach(L, impute=TRUE) # attaches a list called 'rattach' containing an object 'x' print(x) rattach() # Detaches the list 'rattach' exists("x") # FALSE # Trying rvattach: rvattach(L$x) # attaches a list 'rvattach' containing an object 'theta' print(theta) rvattach() # Detaches the list 'rvattach' exists("theta") # FALSE