bReeze (version 0.2-2)

plotTurbIEC: Plot turbulence intensity site classification

Description

Plots the turbulence intensity and site classification after IEC.

Usage

plotTurbIEC(mast, set, ...)
pliec(mast, set, ...)

Arguments

mast

Met mast object created by createMast.

set

Set used for plotting specified as set number or set name.

...

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:

• border: Colour, used for the border around the bars -- default is"white".
• 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: Colour, used to fill the bars.
• 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.
• line: Vector of three colours -- one for each IEC turbulence class.
• lty: Vector of three line types -- one for each IEC turbulence class. Seeparfor available line types.
• lwd: Vector of three line widths -- one for each IEC turbulence class. 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 (only for plots with one dataset) -- default isc(4.5, 4.5, 1, 1).
• 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(2.2, 0.7, 0).
• pos.leg: Position of legend -- one of"bottomright","bottom","bottomleft","left","topleft","top","topright","right"or"center". UseNULLto hide the legend.
• space: Numeric value between 0 and 1, giving the space left before each bar. Default space is0.2.
• xlab: Alternative label for the x axis.
• ylab: Alternative label for the y axis.
• xlim: Limits of the x axis, as vector of two values.
• 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 interspacing factor for legend text, as numeric -- default is0.8.

Details

The IEC defines wind turbine classes by wind speed and turbulence characteristics. In terms of turbulence intensity three reference values (at 15 m/s) are defined: ll{ Turbulence class Reference value A 0.16 B 0.14 C 0.12 } plotTurbIEC plots these IEC references together with the sites values to allow for a classification.

See turbulence for a definition of turbulence intensity.

References

International Electrotechnical Commission (2005) IEC 61400-1 Wind Turbines -- Part 1: Design Requirements. IEC Standard

See Also

createMast

Examples

# load and prepare data
data(winddata)
set40 <- createSet(height=40, v.avg=winddata[,2], v.std=winddata[,5])
set30 <- createSet(height=30, v.avg=winddata[,6], v.std=winddata[,9])
set20 <- createSet(height=20, v.avg=winddata[,10], v.std=winddata[,13])
ts <- formatTS(time.stamp=winddata[,1])
neubuerg <- createMast(time.stamp=ts, set40, set30, set20)
neubuerg <- clean(mast=neubuerg)

# plot
plotTurbIEC(mast=neubuerg, set=1)
plotTurbIEC(mast=neubuerg, set="set1")	# same as above

# customize plot
plotTurbIEC(mast=neubuerg, set=1, bty="l", cex.axis=0.8, cex.lab=0.9, 
  cex.leg=0.7, col.axis="darkblue", col.box="lightblue", col.lab=
  "darkblue", col.leg="darkblue", col.ticks="darkblue", las=0, 
  leg.text=c("IEC class A", "IEC class B", "IEC class C", "measured"), 
  mar=c(3,3,0.5,0.5), mgp=c(1.8,0.5,0), pos.leg="top", xlab="v [m/s]", 
  ylab="ti [-]", xlim=c(0,25), ylim=c(0,0.5), x.intersp=1, y.intersp=1)

# customize bars
plotTurbIEC(mast=neubuerg, set=1, col="gray", border="black", space=0.6)

# customize lines
plotTurbIEC(mast=neubuerg, set=1, line=gray(1:3 / 10), lty=2:4, 
  lwd=0.5:2.5)