by_ranges()
sets property values for cells falling within different numeric ranges.
by_ranges(breaks, values, right = FALSE, extend = TRUE, ignore_na = TRUE)
A vector of numbers in increasing order.
A vector of property values. length(values)
should be one greater than
length(breaks)
if extend = TRUE
, or one less if extend = FALSE
.
If TRUE
, intervals are closed on the right, i.e. if values are exactly equal to a
break
, they go in the lower group. Otherwise, intervals are closed on the left, so equal
values go in the higher group. FALSE
by default.
Extend breaks
to c(-Inf, breaks, Inf)
, i.e. include numbers below and above the
outermost breaks. TRUE
by default.
If TRUE
, NA
values in the result will be left unchanged
from their previous values. Otherwise, NA
normally resets to the default.
A function for use in map_***
functions.
Non-numeric cells return NA
. The effects of this depend on ignore_na
.
Other mapping functions:
by_cases()
,
by_colorspace()
,
by_function()
,
by_quantiles()
,
by_regex()
,
by_rows()
,
by_values()
ht <- huxtable(c(1, 3, 5))
map_background_color(ht,
by_ranges(
c(2, 4),
c("red", "yellow", "blue")
))
#> 1
#> 3
#> 5
map_background_color(ht,
by_ranges(
c(2, 4),
"pink",
extend = FALSE
))
#> 1
#> 3
#> 5
map_background_color(ht,
by_ranges(
c(1, 5),
c("red", "yellow", "green"),
right = TRUE
))
#> 1
#> 3
#> 5
map_background_color(ht,
by_ranges(
c(1, 5),
c("red", "yellow", "green"),
right = FALSE
))
#> 1
#> 3
#> 5