library("broadcast")
x.dim <- c(4:2)
x.len <- prod(x.dim)
x.data <- sample(c(TRUE, FALSE, NA), x.len, TRUE)
x <- array(x.data, x.dim)
y <- array(1:50, c(4,1,1))
bc.b(x, y, "&")
## , , 1
##
## [,1] [,2] [,3]
## [1,] TRUE NA TRUE
## [2,] TRUE TRUE NA
## [3,] TRUE TRUE NA
## [4,] NA TRUE TRUE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] FALSE NA TRUE
## [2,] FALSE NA NA
## [3,] NA NA FALSE
## [4,] TRUE NA TRUE
bc.b(x, y, "|")
## , , 1
##
## [,1] [,2] [,3]
## [1,] TRUE TRUE TRUE
## [2,] TRUE TRUE TRUE
## [3,] TRUE TRUE TRUE
## [4,] TRUE TRUE TRUE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] TRUE TRUE TRUE
## [2,] TRUE TRUE TRUE
## [3,] TRUE TRUE TRUE
## [4,] TRUE TRUE TRUE
bc.b(x, y, "xor")
## , , 1
##
## [,1] [,2] [,3]
## [1,] FALSE NA FALSE
## [2,] FALSE FALSE NA
## [3,] FALSE FALSE NA
## [4,] NA FALSE FALSE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] TRUE NA FALSE
## [2,] TRUE NA NA
## [3,] NA NA TRUE
## [4,] FALSE NA FALSE
bc.b(x, y, "nand")
## , , 1
##
## [,1] [,2] [,3]
## [1,] FALSE FALSE FALSE
## [2,] FALSE FALSE FALSE
## [3,] FALSE FALSE FALSE
## [4,] FALSE FALSE FALSE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] FALSE FALSE FALSE
## [2,] FALSE FALSE FALSE
## [3,] FALSE FALSE FALSE
## [4,] FALSE FALSE FALSE
bc.b(x, y, "==")
## , , 1
##
## [,1] [,2] [,3]
## [1,] TRUE NA TRUE
## [2,] TRUE TRUE NA
## [3,] TRUE TRUE NA
## [4,] NA TRUE TRUE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] FALSE NA TRUE
## [2,] FALSE NA NA
## [3,] NA NA FALSE
## [4,] TRUE NA TRUE
bc.b(x, y, "!=")
## , , 1
##
## [,1] [,2] [,3]
## [1,] FALSE NA FALSE
## [2,] FALSE FALSE NA
## [3,] FALSE FALSE NA
## [4,] NA FALSE FALSE
##
## , , 2
##
## [,1] [,2] [,3]
## [1,] TRUE NA FALSE
## [2,] TRUE NA NA
## [3,] NA NA TRUE
## [4,] FALSE NA FALSEbc.b
Broadcasted Boolean Operations
Description
The bc.b() function performs broadcasted logical (or Boolean) operations on 2 arrays.
Please note that these operations will treat the input as logical.
Therefore, something like bc.b(1, 2, “==”) returns TRUE, because both 1 and 2 are TRUE when treated as logical.
For regular relational operators, see bc.rel.
Usage
bc.b(x, y, op, ...)
## S4 method for signature 'ANY'
bc.b(x, y, op)
Arguments
x, y
|
conformable vectors/arrays of type logical, numeric, or raw.
|
op
|
a single string, giving the operator. Supported Boolean operators: &, |, xor, nand, ==, !=, <, >, <=, >=. |
…
|
further arguments passed to or from methods. |
Details
bc.b() efficiently casts the input to logical.
Since the input is treated as logical, the following equalities hold for bc.b():
-
"==" is equivalent to
(x & y) | (!x & !y), but faster; -
"!=" is equivalent to
xor(x, y); -
"<" is equivalent to
(!x & y), but faster; -
">" is equivalent to
(x & !y), but faster; -
"<=" is equivalent to
(!x & y) | (y == x), but faster; -
">=" is equivalent to
(x & !y) | (y == x), but faster.
Value
Normally:
A logical array/vector as a result of the broadcasted Boolean operation.
If both x and y are type of raw:
A raw array/vector as a result of the broadcasted Boolean operation, where 01 codes for TRUE and 00 codes for FALSE.
This is convenient as raw requires less memory space than logical.