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.
Here "horizontal" and "vertical" denote the position BEFORE rotation

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.1 Index]