Learn R Programming

metagear (version 0.1)

figure_scatterPlot: Detect and display all scatter plot objects.

Description

Automated detection of the X-axis, Y-axis, and points on a scatter-plot figure image. The default returns these detected objects as an EBImage raster imgae, as well as the estimated effect size (correlation coefficient or r) of the data within the scatter-plot.

Usage

figure_scatterPlot(file = file.choose(), binary_threshold = 0.6,
  binary_point_fill = FALSE, binary_point_tolerance = 2,
  axis_thickness = 5, axis_sensitivity = 0.2, axis_X_color = "#00ABAB",
  X_min = 40, X_max = 140, axis_Y_color = "#B0D36A", Y_min = 40,
  Y_max = 140, point_sensitivity = 0.2, point_shape = "circle",
  point_size = 3, point_color = "#0098B2", ignore = FALSE)

Arguments

file
The file name and location of a scatter plot figure. Prompts for file name if none is explicitly called.
binary_threshold
A proportion from zero to one designating the gray-scale threshold to convert pixels into black or white. Pixel intensities below the proportion will be converted to black, and those above white.
binary_point_fill
If TRUE then fills empty points/symbols in figure.
binary_point_tolerance
An integer used to designate the size of the points to the fill. Increase value to better fill empty points.
axis_thickness
An integer used to designate the thickness of the axis lines on a figure. Close alignment to the thickness of the axis on a figure will improve axis detection.
axis_sensitivity
A value designating the sensitivity of identifying straight lines on figure. A smaller number results in a higher sensitivity to identify axes.
axis_X_color
The color to paint the detected X-axis.
X_min
The minimum X value displayed on the X-axis (used to scale detected data points).
X_max
The maximum X value displayed on the X-axis (used to scale detected data points).
axis_Y_color
The color to paint the detected Y-axis.
Y_min
The minimum Y value displayed on the Y-axis (used to scale detected data points).
Y_max
The maximum Y value displayed on the Y-axis (used to scale detected data points).
point_sensitivity
A value designating the sensitivity of identifying unique points that overlap. A smaller number results in a higher sensitivity to split overlapping points; a larger number will extract only a single point from a cluster of overlapping points.
point_shape
The shape of points on figure: can be "circle", "square", or "diamond". If these options do not fit the shape found in a figure, use the option that best approximates that shape.
point_size
An integer used to designate the size of the points on the figure. Close alignment to the size of the points on a figure will improve point detection. See EBImage package to help determine which size to use.
point_color
The color to paint the detected scatter plot points.
ignore
When TRUE does not display painted image, only returns painted image EBImage object.

Value

  • A data frame with detected points.