CSPEngulfing: Engulfing Candlestick Pattern
In candlesticks: Candlestick Pattern Recognition

Description Usage Arguments Details Value Note Author(s) References Examples

Look for Bullish/Bearish Engulfing Pattern in a Open/Close price series

1	CSPEngulfing(TS)

`TS`	xts Time Series containing Open and Close prices

Number of candle lines: 2

Bullish Engulfing Pattern:
Prior trend: down
Bullish Engulfing Pattern is a pattern characterized by a large white real body engulfing a preceding small black real body, which appears during a downtrend. The white body does not necessarily engulf the shadows of the black body but totally engulfs the body itself.

Bearish Engulfing Pattern:
Prior trend: up
Bearish Engulfing Pattern is a large black real body, which engulfs a small white real body in an uptrend. The black body does not necessarily engulf the shadows of the white body but totally engulfs the body itself.

A xts object containing the columns:

`Bull.Engulfing`	TRUE if bullish engulfing pattern detected
`Bear.Engulfing`	TRUE if bearish engulfing pattern detected

The function filters patterns that look like engulfing pattern, without considering the current trend direction. If only pattern in uptrends/downtrends should be filtered, a external trend detection function must be used. See examples.

Andreas Voellenklee

The following site(s) were used to code/document this candlestick pattern:
http://thepatternsite.com/BullEngulfing.html
http://www.onlinetradingconcepts.com/TechnicalAnalysis/Candlesticks/BullishEngulfing.html
http://www.candlesticker.com/Bullish.asp
http://www.candlesticker.com/Bearish.asp

## Not run: 
  getSymbols('YHOO',adjust=TRUE)
  CSPEngulfing(YHOO)
  CSPEngulfing(YHOO)[,"Bear.Engulfing"] & TrendDetectionChannel(YHOO)[,"UpTrend"]

## End(Not run)