catmaply is used to easily plot categorical data on heatmaps using plotly.
It can be used to plot heatmaps on categorical variables or, otherwise, plot continuous variables with categorical color range.
catmaply(
df,
x,
x_order,
x_side = "top",
x_tickangle = 90,
x_range = 30,
y,
y_order,
y_side = "left",
y_tickangle = 0,
z,
text,
text_color = "#444",
text_size = 12,
text_font_family = c("Open Sans", "verdana", "arial", "sans-serif"),
hover_template,
hover_hide = FALSE,
color_palette = viridis::plasma,
categorical_color_range = FALSE,
categorical_col = NA,
font_family = c("Open Sans", "verdana", "arial", "sans-serif"),
font_size = 12,
font_color = "#444",
legend = TRUE,
legend_col,
legend_interactive = TRUE,
tickformatstops = NULL,
rangeslider = TRUE,
slider = FALSE,
slider_steps = list(slider_start = 1, slider_range = 15, slider_shift = 5,
slider_step_name = "x"),
slider_currentvalue_prefix = "",
slider_step_visible = TRUE,
slider_currentvalue_visible = TRUE,
slider_tick_visible = TRUE,
source = "catmaply"
)plot_ly object
data.frame or tibble holding the data.
column name holding the axis values for x.
column name holding the ordering axis values for x. if no order is specified, then x will be used for ordering x; (default:"x").
on which side the axis labels on the x axis should appear. options: c("top", "bottom"); (default:"top").
the angle of the axis label on the x axis. options: range -180 until 180; (default:90).
the initial range that should be displayed on the x axis. Only works with non-time x-axis at the moment; (default: 30).
column name holding the axis values for y.
column name holding the ordering axis values for y. if no order is specified, then y will be used for ordering y; (default:"y").
on which side the axis labels on the y axis should appear. options: c("left", "right"); (default:"left").
the angle of the axis label on the x axis. options: range -180 until 180; (default:0).
column name holding the values for the fields.
optional column name holding the values that should be displayed in the fields. NA values will not be displayed.
font color to be used for text; (default: "#444").
font size to be used for text/annotation. Needs to be a number greater than or equal to 1; (default: 12).
the typeface that will be applied by the web browser for the text/annotation. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system; (default: c("Open Sans", "verdana", "arial", "sans-serif")).
template to be used to create the hover label; (default:missing).
boolean indicating if the hover label should be hidden or not; (default: FALSE).
a color palette vector a function that is able to create one; (default: viridis::plasma).
if the resulting heatmap holds categorical field values or continuous values that belong to a category; (default: FALSE).
if categorical_color_range is TRUE, then this column is used to create categories; (default: NA).
the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system; (default: c("Open Sans", "verdana", "arial", "sans-serif")).
font size to be used for plot. needs to be a number greater than or equal to 1; (default: 12).
font color to be used for plot; (default: "#444").
boolean indicating if legend should be displayed or not; (default: TRUE).
column to be used for legend naming; (default: z/categorical_col).
whether the legend should be interactive or not; i.e. remove traces on click; (default: TRUE).
used only if x axis is of type c("POSIXct", "POSIXt"). List of named list where each named list has one or
more of the keys listed here: https://plotly.com/r/reference/#heatmap-colorbar-tickformatstops. Default is optimized for summarized data of level day 24 hours;
if default value (NULL) is set, tickformatstops is set as follows:
for column class "POSIXct" or "POSIXt"
list(
list(dtickrange = list(NULL, 1000), value = "%H:%M:%S.%L ms"),
list(dtickrange = list(1000, 60000), value = "%H:%M:%S s"),
list(dtickrange = list(60000, 3600000), value = "%H:%M m"),
list(dtickrange = list(3600000, 86400000), value = "%H:%M h"),
list(dtickrange = list(86400000, 604800000), value = "%H:%M h"),
list(dtickrange = list(604800000, "M1"), value = "%H:%M h"),
list(dtickrange = list("M1", "M12"), value = "%H:%M h"),
list(dtickrange = list("M12", NULL), value = "%H:%M h")
)
)
for class equals Date:
list(
list(dtickrange = list(NULL, 1000), value = "%H:%M:%S.%L ms"),
list(dtickrange = list(1000, 60000), value = "%H:%M:%S s"),
list(dtickrange = list(60000, 3600000), value = "%H:%M m"),
list(dtickrange = list(3600000, 86400000), value = "%H:%M h"),
list(dtickrange = list(86400000, 604800000), value = "%e. %b d"),
list(dtickrange = list(604800000, "M1"), value = "%e. %b w"),
list(dtickrange = list("M1", "M12"), value = "%b '%y M"),
list(dtickrange = list("M12", NULL), value = "%Y Y")
)
)
(default: NULL)
boolean value indicating whether the rangeslider should be displayed or not; (default: TRUE).
boolean value indicating whether to use slider or not; if specified, rangeslider will not be displayed; (default: FALSE).
list holding the configuration of the steps to be created. There are two alternatives: auto and
custom; whereas the auto mode creates the steps automatically and custom takes custom instructions on how to create the steps.
For mode auto, a list with the following elements has to be submitted (values of the list element are just examples):
list(
slider_start=1,
slider_range=15,
slider_shift=5,
slider_step_name="x"
)
This will create the steps automatically for you, essentially starting at position slider_start,
shifting the window of size slider_range along the x axis with a stepsize of slider_shift. The stepnames
are automatically selected with the x value of the left side of the slider_range (so for 1 it would take the first value of the x axis as name of the step).
With custom, on the other hand, you can define the step configuration without any restrictions. The custom
configuration needs to be defined in a list with the following elements.
list(
list(name="Step_One", range=c(1, 50)),
list(name="Step_Two", range=c(5, 55)),
...
).
(default:
list(
slider_start=1,
slider_range=15,
slider_shift=5,
)).
prefix to be used for the slider title. Only used if slider=TRUE. (default: "").
boolean indicating if the step names should be displayed for the slider. (default: TRUE).
boolean indicating if the currently selected value should be displayed above the slider. (default: TRUE).
boolean indicating if the tickvalues should be displayed below the slider. (default: TRUE).
a character string of length 1. Match the value of this string with the source argument in event_data() to retrieve the event data corresponding to a specific plot (shiny apps can have multiple plots).
library(catmaply)
data("vbz")
df <- vbz[[3]]
# simple plot
catmaply(
df,
x=trip_seq,
x_order = trip_seq,
y = stop_name,
y_order = stop_seq,
z = occ_category
)
# categorical color range and template
catmaply(
df,
x = trip_seq,
y = stop_name,
y_order = stop_seq,
z = occupancy,
categorical_color_range=TRUE,
categorical_col = occ_category,
hover_template = paste(
'Trip:', trip_seq,
'Stop:', stop_seq,
'Occupancy:', occ_category,
''
)
)
# for more examples, see vignette
Run the code above in your browser using DataLab