circles: Draw circles

In KevCaz/graphicsutils: Collection of graphics utilities

Draw circles

Description

Draw circles in a flexible way.

Usage

circles(
  x,
  y = x,
  radi = 1,
  from = 0,
  to = 2 * pi,
  incr = 0.01,
  pie = FALSE,
  clockwise = FALSE,
  add = TRUE,
  ...
)

Arguments

x, y	the x and y coordinates of the centers of the circles.
radi	the radii of the circles.
from	the angles, expressed in radians, from which circles are drawn.
to	the angles, expressed in radians, to which circles are drawn.
incr	increments between two points to be linked (expressed in radians).
pie	a logical. If TRUE, end points are linked with the center of the circle (default is set to FALSE).
clockwise	a logical. Shall circles and arcs be drawn clockwise? Defaut is FALSE.
add	a logical. Should the circles be added on the current plot?
...	additional arguments to be passed to graphics::polygon() function.

Details

The number of circles drawn is given by the maximum argument length amng x, y, radi, from and to arguments. Sizes are adjusted (i.e. repeated over) with rep_len() function.

Value

An invisible list of data.frame of two columns including the coordinates of all circles.

See Also

graphics::symbols(), plotrix::draw.circle(), plotrix::draw.arc().

Examples

# Example 1:
plot0()
circles(x = 0)

# Example 2:
plot0()
circles(x = -.5, radi = 0.45, from = 0.5 * pi, to = 0.25 * pi)
circles(x = .5, radi = 0.45, from = 0.5 * pi, to = 0.25 * pi, pie = TRUE)
circles(x = .5, y = -.5, radi = 0.45, from = 0.5 * pi, to = 0.25 * pi, pie
= TRUE, clockwise = TRUE)

# Example 3:
plot0()
circles(matrix(-.5 + .5 * stats::runif(18), ncol = 3))

# Example 4:
plot0(x = c(-2, 2), y = c(-2, 2), asp = 1)
circles(x = c(-1, 1), c(1, 1, -1, -1), from = pi * seq(0.25, 1, by = 0.25),
to = 1.25 * pi, col = 2, border = 4, lwd = 3)

KevCaz/graphicsutils documentation built on Sept. 16, 2022, 10:05 a.m.