Set data lines of an scplot object

Either set aesthetics of the default data line or add another data line. The function allows customization of data lines by passing arguments similar to those used in element_line() and element_point(), such as color, size, and linetype.

set_dataline(
  object,
  variable = NULL,
  line,
  point,
  type = "continuous",
  label = NULL,
  ...
)

add_dataline(...)

Arguments

object

An scplot object (class scplot) returned from the scplot() function.

variable

String. The name of a new variable for adding a new line. If left empty, the aesthetics of the default data line are changed.

line

List with line parameters ("colour", "linewidth", "linetype", "lineend", "arrow"). See element_line().

point

A list with point parameters ("colour", "size", "shape"). See element_point().

type

Either "continuous" or "discrete". Specifies how the data line should be treated.

label

A character string which is used to set the label in a legend.

...

As a shortcut, arguments passed hear are bundled as line arguments (see element_line()).

Value

An object of class scplot (seescplot()) with a changed datalines element.

Details

If variable is left empty or set to ".dvar", the aesthetics of the default data line are changed. Otherwise, a new data line is added for the specified variable.

See also

element_line(), element_point()

Examples

data(exampleAB_add, package = "scan")
scplot(exampleAB_add)  |>
  set_dataline("depression", color = "darkblue")