Scatter: Scatter

In Displayr/flipStandardCharts: Standard R interactive charts

Scatter

Description

Scatter plot

Usage

Scatter(
  x = NULL,
  y = NULL,
  scatter.x.column = 1,
  scatter.y.column = 2,
  scatter.labels = NULL,
  scatter.labels.name = NULL,
  scatter.sizes = NULL,
  scatter.sizes.name = NULL,
  scatter.sizes.column = 3,
  scatter.sizes.as.diameter = FALSE,
  scatter.colors = NULL,
  scatter.colors.name = NULL,
  scatter.colors.column = 4,
  scatter.colors.as.categorical = TRUE,
  scatter.labels.as.hovertext = TRUE,
  scatter.max.labels = 50,
  scatter.max.groups = 50,
  annotation.list = NULL,
  colors = ChartColors(12),
  trend.lines = FALSE,
  logos = NULL,
  logo.size = 0.5,
  fit.type = "None",
  fit.window.size = 3,
  fit.ignore.last = FALSE,
  fit.line.type = "dot",
  fit.line.width = 1,
  fit.line.name = "Fitted",
  fit.line.colors = colors,
  fit.line.opacity = 1,
  fit.CI.show = FALSE,
  fit.CI.colors = fit.line.colors,
  fit.CI.opacity = 0.4,
  legend.show = TRUE,
  legend.orientation = "Vertical",
  legend.wrap = TRUE,
  legend.wrap.nchar = 30,
  tooltip.show = TRUE,
  modebar.show = FALSE,
  zoom.enable = TRUE,
  axis.drag.enable = FALSE,
  global.font.family = "Arial",
  global.font.color = rgb(44, 44, 44, maxColorValue = 255),
  title = "",
  title.font.family = global.font.family,
  title.font.color = global.font.color,
  title.font.size = 16,
  title.align = "center",
  subtitle = "",
  subtitle.font.family = global.font.family,
  subtitle.font.color = global.font.color,
  subtitle.font.size = 12,
  subtitle.align = "center",
  footer = "",
  footer.font.family = global.font.family,
  footer.font.color = global.font.color,
  footer.font.size = 8,
  footer.align = "center",
  footer.wrap = TRUE,
  footer.wrap.nchar = 100,
  data.label.show = FALSE,
  data.label.font.family = global.font.family,
  data.label.font.color = global.font.color,
  data.label.font.autocolor = FALSE,
  data.label.font.size = 10,
  data.label.position = "top middle",
  opacity = NULL,
  background.fill.color = "transparent",
  background.fill.opacity = 1,
  charting.area.fill.color = background.fill.color,
  charting.area.fill.opacity = 0,
  legend.fill.color = background.fill.color,
  legend.fill.opacity = 0,
  legend.border.color = rgb(44, 44, 44, maxColorValue = 255),
  legend.border.line.width = 0,
  legend.font.color = global.font.color,
  legend.font.family = global.font.family,
  legend.font.size = 10,
  legend.position.y = 1,
  legend.position.x = 1.02,
  legend.ascending = NA,
  margin.autoexpand = TRUE,
  margin.top = NULL,
  margin.bottom = NULL,
  margin.left = NULL,
  margin.right = NULL,
  margin.inner.pad = NULL,
  grid.show = TRUE,
  y.title = "",
  y.title.font.color = global.font.color,
  y.title.font.family = global.font.family,
  y.title.font.size = 12,
  y.line.width = 0,
  y.line.color = rgb(0, 0, 0, maxColorValue = 255),
  y.tick.mark.length = 0,
  y.tick.mark.color = "transparent",
  y.bounds.minimum = NULL,
  y.bounds.maximum = NULL,
  y.tick.distance = NULL,
  y.tick.maxnum = NULL,
  y.zero = FALSE,
  y.zero.line.width = 0,
  y.zero.line.color = rgb(225, 225, 225, maxColorValue = 255),
  y.data.reversed = FALSE,
  y.grid.width = 1 * grid.show,
  y.grid.color = rgb(225, 225, 225, maxColorValue = 255),
  y.tick.show = TRUE,
  y.tick.on.label = TRUE,
  y.tick.suffix = "",
  y.tick.prefix = "",
  y.tick.format = "",
  y.hovertext.format = "",
  y.tick.angle = NULL,
  y.tick.font.color = global.font.color,
  y.tick.font.family = global.font.family,
  y.tick.font.size = 10,
  x.title = "",
  x.title.font.color = global.font.color,
  x.title.font.family = global.font.family,
  x.title.font.size = 12,
  x.line.width = 0,
  x.line.color = rgb(0, 0, 0, maxColorValue = 255),
  x.tick.mark.length = 3,
  x.tick.mark.color = "transparent",
  x.bounds.minimum = NULL,
  x.bounds.maximum = NULL,
  x.tick.distance = NULL,
  x.tick.maxnum = 11,
  x.zero = FALSE,
  x.zero.line.width = 0,
  x.zero.line.color = rgb(225, 225, 225, maxColorValue = 255),
  x.data.reversed = FALSE,
  x.grid.width = 1 * grid.show,
  x.grid.color = rgb(225, 225, 225, maxColorValue = 255),
  x.tick.show = TRUE,
  x.tick.on.label = TRUE,
  x.tick.suffix = "",
  x.tick.prefix = "",
  x.tick.format = "",
  x.hovertext.format = "",
  x.tick.angle = NULL,
  x.tick.font.color = global.font.color,
  x.tick.font.family = global.font.family,
  x.tick.font.size = 10,
  x.tick.label.wrap = TRUE,
  x.tick.label.wrap.nchar = 21,
  hovertext.font.family = global.font.family,
  hovertext.font.size = 11,
  hovertext.align = "left",
  hovertext.template = NULL,
  line.thickness = 0,
  line.colors = colors,
  marker.border.width = 1,
  marker.border.colors = colors,
  marker.border.opacity = NULL,
  marker.size = 6,
  marker.symbols = "circle",
  swap.x.and.y = FALSE,
  small.mult.index = NULL,
  legend.bubbles.show = TRUE,
  label.auto.placement = TRUE,
  sz.min = NULL,
  sz.max = NULL,
  sz.scale = NULL,
  col.min = NULL,
  col.max = NULL
)

Arguments

x	A numeric vector for the x-axis coordinates (which may be named); or a matrix or datarame; or a list of matrices where each matrix share the same row and column names.
y	Optional numeric vector for the y-axis coordinates. Should contain the same number of observations as x. If not provided, will use x instead.
scatter.x.column	When x is a dataframe or matrix, the index of the column (1-based) which contains the x-coordinate data.
scatter.y.column	When x is a dataframe or matrix, the index of the column (1-based) which contains the y-coordinate data.
scatter.labels	Optional vector for labelling scatter points. This should be the same length as the number of observations in x and y.
scatter.labels.name	Character; Used for labelling subtitles and footers.
scatter.sizes	Numeric vector determining of the size of each observation. These can alternatively be provided as a column in x.
scatter.sizes.name	Character; Used for labelling footers and legends.
scatter.sizes.column	When x is a dataframe or matrix, the index of the column (1-based) which contains scatter.sizes data.
scatter.sizes.as.diameter	Whether to show the points with diameter (instead of area, which is the default) proportional to the sizes variable.
scatter.colors	Numeric, character, or categorical vector determining the color of each observation. These can alternatively be provided as a column in x.
scatter.colors.name	Character; Used for labelling footers.
scatter.colors.column	When x is a dataframe or matrix, the index of the column (1-based) which contains scatter.colors data.
scatter.colors.as.categorical	Boolean; Whether to treat colors as a categorical groups, or a numeric scale.
scatter.labels.as.hovertext	Logical; if TRUE, labels are shown has hovers; otherwise, as a labeled scatterplot.
scatter.max.labels	Integer; the maximum number of labels to show on a Labeled Scatterplot. If the number of labels is greater than this parameter, extra labels will be hidden by default but can be toggled on by clicking on the marker.
scatter.max.groups	Maximum number of different color categories in data. The is equivalent to the number of enteries in the legend. Increasing this too high may cause performance issues.
annotation.list	Optional list of annotations to modify the data labels.
colors	A vector of colors to use in the chart. When scatter.colors.as.categorical, the vector of colors should have the length as the number of categories in scatter.colors. If scatter.colors is used as numeric vector, then a color ramp is constructed from the colors listed.
trend.lines	Boolean indicating whether to plot trend lines for multiple tables.
logos	Optional list of images to be used to label scatterplot instead of the row names. This should be input as a comma-seperated list of URLs.
logo.size	Numeric controlling the size of the logos.
fit.type	Character; type of line of best fit. Can be one of "None", "Linear", "LOESS", "Friedman's super smoother", "Cubic spline", "Moving average", "Centered moving average".
fit.window.size	Integer; Use to determine how the average is computed when fit.type "Moving average" or "Centered moving average".
fit.ignore.last	Logical; whether to ignore the last data point in the fit.
fit.line.type	Character; One of "solid", "dot", "dash, "dotdash", or length of dash "2px", "5px".
fit.line.width	Numeric; Line width of line of best fit.
fit.line.name	Character; Name of the line of best fit, which will appear in the hovertext.
fit.line.colors	Character; a vector containing one or more colors specified as hex codes.
fit.line.opacity	Opacity of trend line as an alpha value (0 to 1).
fit.CI.show	Show 95% confidence interval.
fit.CI.colors	Character; a vector containing one or more colors specified as hex codes.
fit.CI.opacity	Opacity of confidence interval ribbon as an alpha value (0 to 1).
legend.show	Controls whether legend is shown. This can be a logical (TRUE or FALSE); or a string ("Show" or "Hide"). If it is TRUE or NA (the default), a legend will be shown only if there is more than one data series. To force a legend to be shown even with 1 data series, use "Show" instead.
legend.orientation	Character; One of 'Vertical' or 'Horizontal'
legend.wrap	Logical; whether the legend text should be wrapped.
legend.wrap.nchar	Number of characters (approximately) in each line of the legend when legend.wrap TRUE.
tooltip.show	Logical; whether to show a tooltip on hover.
modebar.show	Logical; whether to show the zoom menu buttons or not.
zoom.enable	Logical; whether to enable zoom on the chart. For Bar and Column charts with data labels it may be useful to turn off zoom because data labels and annotations can be misplace on zoom.
axis.drag.enable	Logical; whether to enable the user to drag along axes. This interaction is available when the cursor shows up as a double-headed arrow when hovering over an axis. It is turned off by default because it can sometimes cause problems with data labels and annotations. Also, is only used when zoom.enable = TRUE. Note that in similar functionality is already available using zoom.
global.font.family	Character; font family for all occurrences of any font attribute for the chart unless specified individually.
global.font.color	Global font color as a named color in character format (e.g. "black") or an a hex code.
title	Character; chart title.
title.font.family	Character; title font family. Can be "Arial Black", "Arial", "Comic Sans MS", "Courier New", "Georgia", "Impact", "Lucida Console", "Lucida Sans Unicode", "Marlett", "Symbol", "Tahoma", "Times New Roman", "Trebuchet MS", "Verdana", "Webdings"
title.font.color	Title font color as a named color in character format (e.g. "black") or a hex code.
title.font.size	Integer; Title font size; default = 10.
title.align	Horizontal alignment of title.
subtitle	Character
subtitle.font.family	Character; subtitle font family
subtitle.font.color	subtitle font color as a named color in character format (e.g. "black") or an a hex code.
subtitle.font.size	Integer; subtitle font size
subtitle.align	Horizontal alignment of subtitle.
footer	Character
footer.font.family	Character; footer font family
footer.font.color	footer font color as a named color in character format (e.g. "black") or an a hex code.
footer.font.size	Integer; footer font size
footer.align	Horizontal alignment of footer.
footer.wrap	Logical; whether the footer text should be wrapped.
footer.wrap.nchar	Number of characters (approximately) in each line of the footer when footer.wrap TRUE.
data.label.show	Logical; whether to show data labels.
data.label.font.family	Character; font family for data label.
data.label.font.color	Font color as a named color in character format (e.g. "black") or an a hex code. This can be a single color, a vector of colors (1 for each series/column), or a comma separated list of colors
data.label.font.autocolor	Boolean; If true, data.label.font.color is ignored and labels are colored according to the series color.
data.label.font.size	Integer; Font size for data label.px.
data.label.position	Character; where to place the source data value in relation to the marker icon. Can be "top left", "top center", "top right", "middle left", "middle center", "middle right", "bottom left", "bottom center", "bottom right".
opacity	of scatter point colors as an alpha value (0 to 1).
background.fill.color	Background color in character format (e.g. "black") or a hex code.
background.fill.opacity	Background opacity as an alpha value (0 to 1).
charting.area.fill.color	Charting area background color as a named color in character format (e.g. "black") or a hex code.
charting.area.fill.opacity	Charting area background opacity as an alpha value (0 to 1).
legend.fill.color	Legend fill color as a named color in character format (e.g. "black") or a hex code.
legend.fill.opacity	Legend fill opacity as an alpha value (0 to 1).
legend.border.color	Legend border color as a named color in character format (e.g. "black") or a hex code.
legend.border.line.width	Width in pixels of the border around the legend. 0 = no border.
legend.font.color	Legend font color as a named color in character format (e.g. "black") or a hex code.
legend.font.family	Character; legend font family.
legend.font.size	Integer; Legend font size.
legend.position.y	A numeric controlling the position of the legend. Values range from 0 (bottom) to 1 (top).
legend.position.x	A numeric controlling the position of the legend. Values range from -0.5 (left) to 1.5 (right).
legend.ascending	Logical; TRUE for ascending, FALSE for descending. By default, we set it to to FALSE if the chart is stacked and TRUE otherwise.
margin.autoexpand	Logical; Whether extra space can be added to the margins to allow space for axis/legend/data labels or other chart elements.
margin.top	Margin between plot area and the top of the graphic in pixels
margin.bottom	Margin between plot area and the bottom of the graphic in pixels
margin.left	Margin between plot area and the left of the graphic in pixels
margin.right	Margin between plot area and the right of the graphic in pixels
margin.inner.pad	Padding in pixels between plot proper and axis lines
grid.show	Logical; whether to show grid lines.
y.title	Character, y-axis title; defaults to chart input values; to turn off set to "FALSE".
y.title.font.color	y-axis title font color as a named color in character format (e.g. "black") or a hex code.
y.title.font.family	Character; y-axis title font family
y.title.font.size	Integer; y-axis title font size
y.line.width	y-axis line width in pixels (0 = no line).
y.line.color	y-axis line color as a named color in character format (e.g. "black") or a hex code.
y.tick.mark.length	Length of tick marks in pixels. Ticks are only shown when y.line.width > 0.
y.tick.mark.color	Color of tick marks (default transparent).
y.bounds.minimum	Minimum of range for plotting; For a date axis this should be supplied as a date string. For a categorical axis, the index of the category (0-based) should be used.
y.bounds.maximum	Maximum of range for plotting; NULL = no manual range set.
y.tick.distance	Distance between tick marks. Requires that y.bounds.minimum and y.bounds.maximum have been set.
y.tick.maxnum	Maximum number of ticks shown on the axis. This setting is ignored if y.tick.distance is set or if the axis is categorical
y.zero	Whether the y-axis should include zero.
y.zero.line.width	Width in pixels of zero line;
y.zero.line.color	Color of horizontal zero line as a named color in character format (e.g. "black") or an rgb value (e.g. rgb(0, 0, 0, maxColorValue = 255)).
y.data.reversed	Logical; whether to reverse y-axis or not
y.grid.width	Width of y-grid lines in pixels; 0 = no line
y.grid.color	Color of y-grid lines as a named color in character format (e.g. "black") or a hex code.
y.tick.show	Whether to display the y-axis tick labels
y.tick.on.label	Logical; Set to FALSE to move grid lines between categories.
y.tick.suffix	y-axis tick label suffix
y.tick.prefix	y-axis tick label prefix
y.tick.format	A string representing a d3 formatting code. See https://github.com/d3/d3/blob/master/API.md#number-formats-d3-format
y.hovertext.format	A string representing a d3 formatting code See https://github.com/d3/d3/blob/master/API.md#number-formats-d3-format
y.tick.angle	y-axis tick label angle in degrees. 90 = vertical; 0 = horizontal
y.tick.font.color	y-axis tick label font color as a named color in character format (e.g. "black") or an a hex code.
y.tick.font.family	Character; y-axis tick label font family
y.tick.font.size	Integer; y-axis tick label font size
x.title	Character, x-axis title; defaults to chart input values; to turn off set to "FALSE".
x.title.font.color	x-axis title font color as a named color in character format (e.g. "black") or an a hex code.
x.title.font.family	Character; x-axis title font family
x.title.font.size	Integer; x-axis title font size
x.line.width	x-axis line in pixels, 0 = no line
x.line.color	x-axis line color as a named color in character format (e.g. "black") or a hex code.
x.tick.mark.length	Length of tick marks in pixels.
x.tick.mark.color	Color of tick marks.
x.bounds.minimum	Minimum of range for plotting; For a date axis this should be supplied as a date string. For a categorical axis, the index of the category (0-based) should be used.
x.bounds.maximum	Maximum of range for plotting; NULL = no manual range set. Must be greater than x.bounds.minimum
x.tick.distance	Tick mark distance in x-axis units between minimum and maximum for plotting; NULL = no manual range set.
x.tick.maxnum	Maximum number of ticks shown on the axis. It defaults to 11 which gives the same output from plotly as NULL. This setting is ignored if x.tick.distance is set or if the axis is categorical
x.zero	Whether the x-axis should include zero.
x.zero.line.width	Width in pixels of zero line.
x.zero.line.color	Color of horizontal zero (origin) line as a named color in character format (e.g. "black") or an rgb value (e.g. rgb(0, 0, 0, maxColorValue = 255)).
x.data.reversed	Logical; whether to reverse x-axis or not
x.grid.width	Width of y-grid lines in pixels; 0 = no line
x.grid.color	Color of y-grid lines as a named color in character format (e.g. "black") or a hex code.
x.tick.show	Whether to display the x-axis tick labels
x.tick.on.label	Logical; Set to FALSE to move grid lines between categories.
x.tick.suffix	x-axis tick label suffix
x.tick.prefix	x-axis tick label prefix
x.tick.format	A string representing a d3 formatting code. See https://github.com/mbostock/d3/wiki/Formatting#numbers
x.hovertext.format	A string representing a d3 formatting code. See https://github.com/mbostock/d3/wiki/Formatting#numbers
x.tick.angle	x-axis tick label angle in degrees. 90 = vertical; 0 = horizontal
x.tick.font.color	X-axis tick label font color as a named color in character format (e.g. "black") or an a hex code.
x.tick.font.family	Character; x-axis tick label font family
x.tick.font.size	Integer; x-axis tick label font size
x.tick.label.wrap	Logical; whether to wrap long labels on the x-axis.
x.tick.label.wrap.nchar	Integer; number of characters in each line when label.wrap is TRUE.
hovertext.font.family	Font family of hover text.
hovertext.font.size	Font size of hover text.
hovertext.align	Horizontal alignment of hover text. Only observable when hover contain multiple lines.
hovertext.template	Specify format of the hovertext. This can be a string or matrix which is the same dimensions as chart.matrix. If no format is specified the default is for categorical x-axis "%x: %y" or for a numerical x-axis "(%x, %y)".
line.thickness	Thickness, in pixels, of the series line
line.colors	Character; a vector containing one or more named
marker.border.width	Width in pixels of border/line around markers; 0 is no line.
marker.border.colors	Character; a vector containing one or more colors specified as hex codes.
marker.border.opacity	Opacity of border/line around markers as an alpha value (0 to 1).
marker.size	Size in pixels of marker. This is overriden if scatter.sizes is provided, but used for the legend if scatter.colors.as.categorical.
marker.symbols	Character; a vector describing the symbol used for each data series. See https://plotly-r.com/working-with-symbols.html for a list of symbol names. Note there is no corresponding parameter for LabeledScatter.
swap.x.and.y	Swap the x and y axis around on the chart.
small.mult.index	Used by Small Multiples to add prefixes to warnings.
legend.bubbles.show	Logical; show legend for bubble sizes.
label.auto.placement	Logical; whether the scatter plot labels are positioned automatically to reduce overlap.
sz.min	Parameter to control scaling of scatter.sizes, used by SmallMultiples
sz.max	Parameter to control scaling of scatter.sizes, used by SmallMultiples
sz.scale	Parameter to control scaling of scatter.sizes. Marker size (in pixels) of the points with the largest value of scatter.size. This defaults to 100/6 of marker.size.
col.min	Parameter to control scaling of scatter.colors, used by SmallMultiples
col.max	Parameter to control scaling of scatter.colors, used by SmallMultiples

Examples

z <- structure(c(1L, 2L, 3L, 4L, 5L, 2L, 3L, 4L, 5L, 6L),  .Dim = c(5L, 2L),
      .Dimnames = list(c("T", "U", "V", "W", "X"), c("A", "B")))
Column(z, type="Stacked Column")

Displayr/flipStandardCharts documentation built on Feb. 26, 2024, 12:42 a.m.