rvmatch: Generate a Random Vector from a Bernoulli Sampling Model
Description
rvmatch returns a (random) vector of the positions of (first) matches of
its first argument in its second. %*in*% is a binary operator (analogous in its operation to
%in%)
which returns a logical (random) vector indicating if there is a match or not for
its left operand.
Usage
rvmatch(x, table, nomatch = NA_integer_, incomparables = NULL)
x %*in*% y
Arguments
x
random vector, regular atomic vector, or NULL: the values to be matched.
table, y
random vector, regular atomic vector, or NULL: the values to be matched against.
nomatch
the value to be returned in the case when no match is found.
Note that the value is coerced to integer.
incomparables
a vector of values that cannot be matched. Any value in
x matching a value in this vector is assigned the nomatch
value. For historical reasons, FALSE is equivalent to NULL
Value
A random vector (an rv object) of the same length as x. rvmatch returns an integer-valued vector. %*in*% returns a logical-valued vector. Both functions are compatible with regular atomic vectors.
Details
...
References
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").