bReeze (version 0.2-2)

plotPC: Plot power curve

Description

Plots a power curve object.

Usage

plotPC(pc, cp=TRUE, ct=TRUE, ...)
plpc(pc, cp=TRUE, ct=TRUE, ...)

Arguments

pc

Power curve object ceated by createPC or imported from file by readPC, or a list of power curve objects.

cp

If TRUE, the power coefficient (cp) is added to the plot (if available).

ct

If TRUE, the thrust coefficient (ct) is added to the plot (if available).

...

Optional graphical parameters, see below for details.

encoding

UTF-8

Optional graphical parameters

The following graphical parameters can optionally be added to customize the plot:

• bty: Type of box to be drawn around the plot region. Allowed values are"o"(the default),"l","7","c","u", or"]". The resulting box resembles the corresponding upper case letter. A value of"n"suppresses the box.
• bty.leg: Type of box to be drawn around the legend. Allowed values are"n"(no box, the default) and"o".
• cex: Amount by which text on the plot should be scaled relative to the default (which is1), as numeric. To be used for scaling of all texts at once.
• cex.axis: Amount by which axis annotations should be scaled, as numeric value.
• cex.lab: Amount by which axis labels should be scaled, as numeric value.
• cex.leg: Amount by which legend text should be scaled, as numeric value.
• col: Vector of colours. The first colour is used for the power curve. If only one coefficient is available, the second colour is used for this coefficient, if both coefficients are available, the second colour is used forpcand the third forct.
• col.axis: Colour to be used for axis annotations -- default is"black".
• col.box: Colour to be used for the box around the plot region (ifbty) -- default is"black".
• col.lab: Colour to be used for axis labels -- default is"black".
• col.leg: Colour to be used for legend text -- default is"black".
• col.ticks: Colours for the axis line and the tick marks respectively -- default is"black".
• las: Style of axis labels. One of0(always parallel to the axis, default),1(always horizontal),2(always perpendicular to the axis),3(always vertical).
• legend: IfTRUE(the default) a legend is drawn.
• leg.text: A character orexpressionvector to appear in the legend.
• lty: Vector of line types, assigned likecol. Seeparfor available line types.
• lwd: Vector of line widths, assigned likecol. Seeparfor usage.
• mar: A numerical vector of the form c(bottom, left, top, right) which gives the number of lines of margin to be specified on the four sides of the plot -- default isc(5, 5, 1, 5)for one y axis andc(5, 5, 1, 1)for two y axes.
• mgp: A numerical vector of the form c(label, annotation, line), which gives the margin line for the axis label, axis annotation and axis line. The default isc(3, 1, 0).
• pos.leg: Position of legend -- one of"bottomright","bottom","bottomleft","left","topleft","top","topright","right"or"center". UseNULLto hide the legend.
• xlab: Alternative label for the x axis.
• ylab: Alternative labels for the y axis, as vector of the form c(left axis label, right axis label).
• ylim: Limits of the y axis, as vector of two values.
• x.intersp: Horizontal interspacing factor for legend text, as numeric -- default is0.4.
• y.intersp: Vertical line distance for legend text, as numeric -- default is0.4.

See Also

createPC, readPC

Examples

# create power curve
v <- seq(3, 25, 0.5)
p <- c(5, 15.5, 32, 52, 71, 98, 136, 182, 230, 285, 345, 419, 497, 594, 
  687, 760, 815, 860, 886, rep(900, 26))
cp <- c(0.263, NA, 0.352, NA, 0.423, NA, 0.453, NA, 0.470, NA, 0.478, NA, 
  0.480, NA, 0.483, NA, 0.470, NA, 0.429, NA, 0.381, NA, 0.329, NA, 0.281, 
  NA, 0.236, NA, 0.199, NA, 0.168, NA, 0.142, NA, 0.122, NA, 0.105, NA, 
  0.092, NA, 0.080, NA, 0.071, NA, 0.063)
ct <- c(0.653, NA, 0.698, NA, 0.705, NA, 0.713, NA, 0.720, NA, 0.723, NA, 
  0.724, NA, 0.727, NA, 0.730, NA, 0.732, NA, 0.385, NA, 0.301, NA, 0.242, 
  NA, 0.199, NA, 0.168, NA, 0.146, NA, 0.128, NA, 0.115, NA, 0.103, NA, 
  0.094, NA, 0.086, NA, 0.079, NA, 0.073)
my.pc <- createPC(v=v, p=p, cp=cp, ct=ct, rho=1.195, rated.p="900 kW")

# plot power curve with and without coefficients
plotPC(pc=my.pc)
plotPC(pc=my.pc, cp=FALSE, ct=FALSE)

# plot list of power curves
enercon.e82 <- readPC(file=system.file(package="bReeze", "powercurves", 
  "Enercon_E82_2.0MW.pow"))
gamesa.g83 <- readPC(file=system.file(package="bReeze", "powercurves", 
  "Gamesa_G83_2.0MW.pow"))
vestas.v80 <- readPC(file=system.file(package="bReeze", "powercurves", 
  "Vestas_V80_2.0MW.wtg"))
vestas.v90 <- readPC(file=system.file(package="bReeze", "powercurves", 
  "Vestas_V90_2.0MW.wtg"))
pc.2mw <- list(V80=vestas.v80, E82=enercon.e82, G83=gamesa.g83)
plotPC(pc.2mw, ct=FALSE)
plotPC(list(v80, v90))

# customize plot
plotPC(pc=my.pc, bty="u", bty.leg="o", cex.axis=0.8, cex.lab=0.9, 
  cex.leg=0.7, col=c("red", gray(0.4), gray(0.4)), col.axis=gray(0.2), 
  col.box=gray(0.5), col.lab=gray(0.2), col.leg=gray(0.2), 
  col.ticks=gray(0.5), las=2, leg.text=c("electric Power", 
  "power coefficient", "thrust coefficient"), lty=2:4, lwd=c(2,1,1), 
  mar=c(3.5,3.5,0.5,3.5), mgp=c(1.8,0.6,0), pos.leg="top", 
  xlab="velocity [m/s]", ylab=c("electric power", "coefficients"), 
  ylim=c(0,1100), x.intersp=1, y.intersp=1)