# maxDrawdown

##### caclulate the maximum drawdown from peak equity

To find the maximum drawdown in a return series, we need to first calculate the cumulative returns and the maximum cumulative return to that point. Any time the cumulative returns dips below the maximum cumulative returns, it's a drawdown. Drawdowns are measured as a percentage of that maximum cumulative return, in effect, measured from peak equity.

##### Usage

`maxDrawdown(R, weights = NULL, geometric = TRUE, invert = TRUE, ...)`

##### Arguments

- R
an xts, vector, matrix, data frame, timeSeries or zoo object of asset returns

- weights
portfolio weighting vector, default NULL, see Details

- geometric
utilize geometric chaining (TRUE) or simple/arithmetic chaining (FALSE) to aggregate returns, default TRUE

- invert
TRUE/FALSE whether to invert the drawdown measure. see Details.

- …
any other passthru parameters

##### Details

The option to `invert`

the measure should appease both academics and
practitioners. The default option `invert=TRUE`

will provide the
drawdown as a positive number. This should be useful for optimization
(which usually seeks to minimize a value), and for tables (where having
negative signs in front of every number may be considered clutter).
Practitioners will argue that drawdowns denote losses, and should be
internally consistent with the quantile (a negative number), for which
`invert=FALSE`

will provide the value they expect. Individually,
different preferences may apply for clarity and compactness. As such, we
provide the option, but make no value judgment on which approach is
preferable.

##### References

Bacon, C. *Practical Portfolio Performance Measurement and
Attribution*. Wiley. 2004. p. 88

##### See Also

`findDrawdowns`

`sortDrawdowns`

`table.Drawdowns`

`table.DownsideRisk`

`chart.Drawdown`

##### Examples

```
# NOT RUN {
data(edhec)
t(round(maxDrawdown(edhec[,"Funds of Funds"]),4))
data(managers)
t(round(maxDrawdown(managers),4))
# }
```

*Documentation reproduced from package PerformanceAnalytics, version 2.0.4, License:*