R Graphical Manual

Browse All

Last data update: 2014.03.03

R: Draw One or Several Annuli

DrawAnnulus

R Documentation

Draw One or Several Annuli

Description

Draw an annulus (or a sequence of annuli) with given center coordinates, fill and border colors on an existing plot using classical graphics.

Usage

DrawAnnulus(x = 0, y = x, radius.in = 1, radius.out = 2, nv = 100, 
            border = par("fg"), col = par("bg"), lty = par("lty"), 
            lwd = par("lwd"), plot = TRUE)

Arguments

`x, y`	a vector (or scalar) of xy-coordinates of the center(s).
`radius.in`	a vector (or scalar) of the inner radius of the annulus(i).
`radius.out`	a vector (or scalar) of the outer radius of the annulus(i).
`nv`	number of vertices to draw the circles. Default is 100.
`border`	color for the border(s). The default is `par("fg")`. Use `border = NA` to omit borders. If there are shading lines, `border = TRUE` means use the same colour for the border as for the shading lines.
`col`	color(s) to fill or shade the annulus with. The default `NA` (or also NULL) means do not fill, i.e., draw transparent rectangles, unless `density` is specified.
`lty`	line type for borders and shading; defaults to `"solid"`.
`lwd`	line width for borders and shading.
`plot`	logical. If `TRUE` the structure will be plotted. If `FALSE` only the xy-points are calculated and returned. Use this option if you want to combine several geometric structures to a single polygon.

Details

All geometric arguments are recycled if necessary.

Value

DrawAnnulus invisibly returns a list of the calculated coordinates for all shapes.

Author(s)

Andri Signorell <andri@signorell.net>

Examples

Canvas(0.5)
DrawRegPolygon(nv=4, rot=pi/4, col="lightblue")
DrawAnnulus(radius.in=0.3, radius.out=0.45, col="lightgrey", border="darkgrey", lwd=5)

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(DescTools)
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/DescTools/DrawAnnulus.Rd_%03d_medium.png", width=480, height=480)
> ### Name: DrawAnnulus
> ### Title: Draw One or Several Annuli
> ### Aliases: DrawAnnulus
> ### Keywords: aplot
> 
> ### ** Examples
> 
> Canvas(0.5)
> DrawRegPolygon(nv=4, rot=pi/4, col="lightblue")
> DrawAnnulus(radius.in=0.3, radius.out=0.45, col="lightgrey", border="darkgrey", lwd=5)
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>