plotellipse {shape}R Documentation

adds part of a colored and rotated ellipse to a plot

Description

adds (part of) a colored, and rotated ellipse to a plot; an arrow can be drawn at a specified position.

Usage

plotellipse(rx=1, ry=0.2, mid=c(0,0), dr=0.01, 
  angle=0,from=-pi,to=pi,type="l", lwd=2,lcol="black",col=NULL,  
  arrow=FALSE, arr.length=0.4, arr.width=arr.length*0.5, 
  arr.type="curved",arr.pos=1,arr.code=2,arr.adj=0.5, 
  arr.col="black", ...)

Arguments

rx long radius of ellipse.
ry short radius of ellipse.
mid midpoint of ellipse.
dr size of segments, in radians, to draw ellipse (decrease for smoother).
angle rotation angle, degrees.
from starting angle for ellipse segment, radians.
to final angle for ellipse segment, radians.
type external line or points; "n" if no line.
lwd width of external line.
lcol line color.
col fill color.
arrow drawing arrowhead yes/no.
arr.length length of arrowhead.
arr.width width of arrowhead.
arr.type type of arrow.
arr.pos position of arrow, 0=start,1=end.
arr.code integer code determining kind of arrows to draw.
arr.adj adjustment of arrow.
arr.col color of arrow head.
... arguments passed to R-function lines.

Details

rx and ry are the horizontal and vertical radiusses of the ellipses.

if arrow is TRUE, an arrow is drawn along the path of the ellipse.

arr.length and arr.width set the size of the arrow.

The type of the arrowhead is set with arr.type which can take the values:

arr.pos, a real value between 0 and 1 gives the position (0=start,1=end).

arr.col specifies the color, arr.code specifies where the angle points to.

arr.adj specifies the position adjustment - see Arrows for details.

Author(s)

Karline Soetaert <k.soetaert@nioo.knaw.nl>.

See Also

getellipse, filledellipse, plotcircle.

Examples

emptyplot(c(-1,1),main="plotellipse")
  plotellipse(rx=0.8,ry=0.3,angle=60,col="blue")
  plotellipse(rx=1.0,ry=0.6,angle=0,from=pi,to=2*pi,arrow=TRUE,
              arr.pos=seq(0.1,0.5,by=0.1),arr.col=rainbow(5))
  
  plotellipse(rx=1.0,ry=0.6,angle=30,from=pi,to=1.2*pi,col="red")

[Package shape version 1.2.2 Index]