Generates an interactive scatter plot based on d3.js. Interactive features include zooming, panning, text labels moving, tooltips, fading effects in legend. Additional handlers are provided to change label size, point opacity or export the figure as an SVG file via HTML form controls.
scatterD3(
x,
y,
data = NULL,
lab = NULL,
x_log = FALSE,
y_log = FALSE,
point_size = 64,
labels_size = 10,
labels_positions = NULL,
point_opacity = 1,
opacities = NULL,
hover_size = 1,
hover_opacity = NULL,
fixed = FALSE,
col_var = NULL,
col_continuous = NULL,
colors = NULL,
ellipses = FALSE,
ellipses_level = 0.95,
symbol_var = NULL,
symbols = NULL,
size_var = NULL,
size_range = c(10, 300),
sizes = NULL,
col_lab = NULL,
symbol_lab = NULL,
size_lab = NULL,
key_var = NULL,
type_var = NULL,
opacity_var = NULL,
unit_circle = FALSE,
url_var = NULL,
tooltips = TRUE,
tooltip_text = NULL,
tooltip_position = "bottom right",
xlab = NULL,
ylab = NULL,
html_id = NULL,
width = NULL,
height = NULL,
legend_width = 150,
left_margin = 30,
xlim = NULL,
ylim = NULL,
dom_id_reset_zoom = "scatterD3-reset-zoom",
dom_id_svg_export = "scatterD3-svg-export",
dom_id_lasso_toggle = "scatterD3-lasso-toggle",
transitions = FALSE,
menu = TRUE,
lasso = FALSE,
lasso_callback = NULL,
click_callback = NULL,
init_callback = NULL,
zoom_callback = NULL,
zoom_on = NULL,
zoom_on_level = NULL,
disable_wheel = FALSE,
lines = data.frame(slope = c(0, Inf), intercept = c(0, 0), stroke_dasharray = c(5,
5)),
axes_font_size = "100%",
legend_font_size = "100%",
caption = NULL
)D3.js was created by Michael Bostock. See https://d3js.org/
numerical vector of x values, or variable name if data is not NULL
numerical vector of y values, or variable name if data is not NULL
default dataset to use for plot.
optional character vector of text labels, or variable name if data is not NULL
if TRUE, set x scale as logarithmic
if TRUE, set y scale as logarithmic
points size. Ignored if size_var is not NULL.
text labels size
Either a data frame, as created by the "Export labels positions" menu entry, giving each label x and y position, or the value `"auto"` to use an automatic labeler.
points opacity, as an integer (same opacity for all points).
named list or named vector of opacities. Each opacity will be associated by their name within `opacity_var`.
factor for changing size when hovering points
points opacity when hovering
force a 1:1 aspect ratio
optional vector for points color mapping, or variable name if data is not NULL
specify if the color scale must be continuous. By
default, if col_var is numeric, not a factor, and has more than
6 unique values, it is considered as continuous.
vector of custom points colors. Colors must be defined as an
hexadecimal string (eg "#FF0000"). If colors is a named list or
a named vector, then the colors will be associated with their name
within col_var. A string can be given to specify a d3-scale-chromatic
function name (for example, "interpolatePurples" or "schemeTableau10")
draw confidence ellipses for points or the different color mapping groups
confidence level for ellipses (0.95 by default)
optional vector for points symbol mapping, or variable name if data is not NULL
vector of custom points symbols. Symbols must be defined as
character strings with the following possible values : "circle", "cross",
"diamond", "square", "star", "triangle", and "wye". If symbols is a
named list or a named vector, then the symbols will be associated with their
name within symbol_var.
optional vector for points size mapping, or variable name if data is not NULL
numeric vector of length 2, giving the minimum and maximum point sizes when mapping with size_var
named list or named vector of sizes. Each size will be associated by their name within `size_var`.
color legend title. Set to NA to remove color legend entirely.
symbols legend title. Set to NA to remove symbol legend entirely.
size legend title. Set to NA to remove size legend entirely.
optional vector of rows ids, or variable name if data is not NULL. This is passed as a key to d3, and is only added in shiny apps where displayed rows are filtered interactively.
optional vector of points type : "point" for a dot (default), "arrow" for an arrow starting from the origin.
optional vector of points opacity (values between 0 and 1)
set tot TRUE to draw a unit circle
optional vector of URLs to be opened when a point is clicked
logical value to display tooltips when hovering points
optional character vector of tooltips text
the tooltip position relative to its point. Must a combination of "top" or "bottom" with "left" or "right" (default is "bottom right").
x axis label
y axis label.
manually specify an HTML id for the svg root node. A random one is generated by default.
figure width, computed when displayed
figure height, computed when displayed
legend area width, in pixels. Set to 0 to disable legend completely.
margin on the left of the plot, in pixels
numeric vector of length 2, manual x axis limits
numeric vector of length 2, manual y axis limits
HTML DOM id of the element to bind the "reset zoom" control to.
HTML DOM id of the element to bind the "svg export" control to.
HTML DOM id of the element to bind the "toggle lasso" control to.
if TRUE, data updates are displayed with smooth transitions, if FALSE the whole chart is redrawn. Only used within shiny apps.
wether to display the tools menu (gear icon)
logical value to add https://github.com/skokenes/D3-Lasso-Plugind3-lasso-plugin feature
the body of a JavaScript callback function with the
argument sel to be applied to a lasso plugin selection
the body of a JavaScript callback function whose inputs are html_id, and the index of the clicked element.
the body of a JavaScript callback function applied to the scatter object at init time.
the body of a JavaScript callback function whose inputs are the new xmin, xmax, ymin and ymax after a zoom action is triggered.
coordinates where to center zoom on plot draw or update.
zoom level on plot draw or update. Ignored if `zoom_on` is NULL.
if TRUE, disable zooming with mousewheel.
a data frame with at least the slope and
intercept columns, and as many rows as lines to add to
scatterplot. Style can be added with stroke, stroke_width
and stroke_dasharray columns. To draw a vertical line, pass
Inf as slope value.
font size for axes text (any CSS compatible value)
font size for legend text (any CSS compatible value)
caption to be displayed when clicking on the corresponding icon. Either a character string, or a list with title, subtitle and text elements.
Interactive scatter plots based on htmlwidgets and d3.js
scatterD3(x = mtcars$wt, y = mtcars$mpg, data=NULL, lab = rownames(mtcars),
col_var = mtcars$cyl, symbol_var = mtcars$am,
xlab = "Weight", ylab = "Mpg", col_lab = "Cylinders",
symbol_lab = "Manual transmission", html_id = NULL)