Learn R Programming

⚠️There's a newer version (2.0.8) of this package.Take me there.

PerformanceAnalytics: Econometric tools for performance and risk analysis.

PerformanceAnalytics provides an R package of econometric functions for performance and risk analysis of financial instruments or portfolios. This package aims to aid practitioners and researchers in using the latest research for analysis of both normally and non-normally distributed return streams.

We created this package to include functionality that has been appearing in the academic literature on performance analysis and risk over the past several years, but had no functional equivalent in R. In doing so, we also found it valuable to have wrappers for some functionality with good defaults and naming consistent with common usage in the finance literature.

In general, this package requires return (rather than price) data. Almost all of the functions will work with any periodicity, from annual, monthly, daily, to even minutes and seconds, either regular or irregular.

The package documentation includes sections on

Time Series Data
Performance Analysis
Style Analysis
Risk Analysis
Value at Risk - VaR
Moments and Co-moments
Robust Data Cleaning
Summary Tabular Data
Charts and Graphs
Wrapper and Utility Functions

It also includes some thoughts on work yet to be done, acknowledgments, and pointers to other literature and resources in R useful for performance and risk analysis,

Some sample data is provided in the managers dataset. It is an xts object that contains columns of monthly returns for six hypothetical asset managers (HAM1 through HAM6), the EDHEC Long-Short Equity hedge fund index, the S&P 500 total returns, and total return series for the US Treasury 10-year bond and 3-month bill. Monthly returns for all series end in December 2006 and begin at different periods starting from January 1996. That data set is used extensively in our examples and should serve as a model for formatting your data.

Copy Link

Version

Install

install.packages('PerformanceAnalytics')

Monthly Downloads

39,698

Version

1.5.3

License

GPL-2 | GPL-3

Issues

Pull Requests

Stars

Forks

Repository

https://github.com/braverock/PerformanceAnalytics

Maintainer

Brian G Peterson

Last Published

June 23rd, 2019

Functions in PerformanceAnalytics (1.5.3)

Functions to calculate systematic or beta co-moments of return series

BernardoLedoitRatio

Bernardo and Ledoit ratio of the return distribution

Burke ratio of the return distribution

utility functions for single factor (CAPM) CML, SML, and RiskPremium

calculate single factor model (CAPM) beta

calculate single factor model (CAPM) alpha

Appraisal ratio of the return distribution

AverageDrawdown

Calculates the average depth of the observed drawdowns.

Active Premium or Active Return

calculate the Hurst Index The Hurst index can be used to measure whether returns are mean reverting, totally random, or persistent.

d ratio of the return distribution

DownsideDeviation

downside risk (deviation, variance) of the return distribution

Calculates the average length (in periods) of the observed drawdowns.

M squared for Sortino of the return distribution

Functions for doing Moment Component Analysis (MCA) of financial time series

AdjustedSharpeRatio

Adjusted Sharpe ratio of the return distribution

calculate Omega for a return series

Net selectivity of the return distribution

Time-varying conditional single factor model beta

calculate Geltner liquidity-adjusted return series

Frequency of the return distribution

Market timing models

calculate a Calmar or Sterling reward/risk ratio Calmar and Sterling Ratios are yet another method of creating a risk-adjusted measure for ranking investments similar to the SharpeRatio.

clean returns in a time series to to provide more robust risk estimates

M squared of the return distribution

InformationRatio

InformationRatio = ActivePremium/TrackingError

Regression epsilon of the return distribution

Systematic risk of the return distribution

Convert coredata content from one type of return to another

Calculate Uryasev's proposed Conditional Drawdown at Risk (CDD or CDaR) measure

Drawdawn peak of the return distribution

Kappa of the return distribution

calculates Expected Shortfall(ES) (or Conditional Value-at-Risk(CVaR) for univariate and component, using a variety of analytical methods.

Modigliani-Modigliani measure

M squared excess of the return distribution

UpsidePotentialRatio

calculate Upside Potential Ratio of upside performance over downside risk

AverageRecovery

Calculates the average length (in periods) of the observed recovery period.

Functions for calculating comoments of financial time series

OmegaSharpeRatio

Omega-Sharpe ratio of the return distribution

Calculates the returns of an asset in excess of the given risk free rate

CAPM.jensenAlpha

Jensen's alpha of the return distribution

Prospect ratio of the return distribution

Functions for calculating EWMA comoments of financial time series

Fama beta of the return distribution

calculate Normalized Getmansky Smoothing Index

Create an ECDF overlaid with a Normal CDF

Pain index of the return distribution

Martin ratio of the return distribution

OmegaExcessReturn

Omega excess return of the return distribution

Return.relative

calculate the relative return of one asset to another

DownsideFrequency

downside frequency of the return distribution

Return.annualized

calculate an annualized return for comparing instruments with different length history

SharpeRatio.annualized

calculate annualized Sharpe Ratio

Pain ratio of the return distribution

Return.annualized.excess

calculates an annualized excess return for comparing instruments with different length history

Selected Price Series Example Data

Return.calculate

calculate simple or compound returns from prices

Find the drawdowns and drawdown levels in a timeseries.

StdDev.annualized

calculate a multiperiod or annualized Standard Deviation

DrawdownDeviation

Calculates a standard deviation-type statistic using individual drawdowns.

Return.centered

calculate centered Returns

Level.calculate

Calculate appropriate cumulative return series or asset level using xts attribute information

Specific risk of the return distribution

StructuredMoments

Functions for calculating structured comoments of financial time series

calculates Standard Deviation for univariate and multivariate series, also calculates component contribution to standard deviation of a portfolio

chart.CaptureRatios

Chart of Capture Ratios against a benchmark

chart.VaRSensitivity

show the sensitivity of Value-at-Risk or Expected Shortfall estimates

chart.Correlation

correlation matrix chart

chart.TimeSeries

Creates a time series chart with some extensions.

Selectivity of the return distribution

Single Factor Asset-Pricing Model Summary: Statistics and Stylized Facts

UpsideFrequency

upside frequency of the return distribution

MeanAbsoluteDeviation

Mean absolute deviation of the return distribution

calculate a traditional or modified Sharpe Ratio of Return over StdDev or VaR or ES

chart.CumReturns

Cumulates and graphs a set of periodic returns

chart.Histogram

histogram of returns

check input data type and format and coerce to the desired output type

calculate Kelly criterion ratio (leverage or bet size) for a strategy

Return.cumulative

calculate a compounded (geometric) cumulative return

Total risk of the return distribution

chart.RiskReturnScatter

scatter chart of returns vs risk for comparing multiple instruments

calculate the Ulcer Index

Return.portfolio

Calculate weighted returns for a portfolio of assets

table.AnnualizedReturns

Annualized Returns Summary: Statistics and Stylized Facts

table.DrawdownsRatio

Drawdowns Summary: Statistics and ratios

Read returns data with different date formats

calculate Sortino Ratio of performance over downside risk

calculate Treynor Ratio or modified Treynor Ratio of excess return over CAPM beta

charts.RollingPerformance

rolling performance chart

Calculate Tracking Error of returns against a benchmark

table.SpecificRisk

Specific risk Summary: Statistics and Stylized Facts

PerformanceAnalytics-package

Econometric tools for performance and risk analysis.

Periodic returns in a bar chart with risk metric overlay

box whiskers plot wrapper

calculate a function over a rolling window

table.HigherMoments

Higher Moments Summary: Statistics and Stylized Facts

calculate metrics on up and down markets for the benchmark asset

table.CaptureRatios

Calculate and display a table of capture ratio and related statistics

table.Correlation

calculate correlalations of multicolumn data

table.Arbitrary

wrapper function for combining arbitrary function list into a table

VolatilitySkewness

Volatility and variability of the return distribution

caclulate the maximum drawdown from peak equity

clean extreme observations in a time series to to provide more robust risk estimates

Plots a time series with event dates aligned

order list of drawdowns from worst to best

charts.PerformanceSummary

Create combined wealth index, period performance, and drawdown chart

Plot a QQ chart

apply.fromstart

calculate a function over an expanding window always starting from the beginning of the series

SkewnessKurtosisRatio

Skewness-Kurtosis ratio of the return distribution

table.InformationRatio

Information ratio Summary: Statistics and Stylized Facts

Returns Summary: Statistics and Stylized Facts

EDHEC-Risk Hedge Fund Style Indices

chart.RollingCorrelation

chart rolling correlation fo multiple assets

Sample sector weights for use by unit tests

Check 'seedValue' to ensure it is compatible with coredata_content attribute of 'R' (an xts object)

table.Variability

Variability Summary: Statistics and Stylized Facts

Sample sector returns for use by unit tests

wrapper for barchart of returns

internal functions for setting useful defaults for graphs

chart.Regression

Takes a set of returns and relates them to a market benchmark in a scatterplot

calculate attributes relative to the mean of the observation series given, including geometric, stderr, LCL and UCL

chart.SnailTrail

chart risk versus return over rolling time periods

table.Distributions

Distributions Summary: Statistics and Stylized Facts

table.CalendarReturns

Monthly and Calendar year Return table

Time series chart of drawdowns through time

Create ACF chart or ACF with PACF two-panel chart

chart.RelativePerformance

relative performance chart between multiple return series

Hypothetical Alternative Asset Manager and Benchmark Data

chart.StackedBar

create a stacked bar plot

table.Autocorrelation

table for calculating the first six autocorrelation coefficients and significance

table.Drawdowns

Worst Drawdowns Summary: Statistics and Stylized Facts

table.DownsideRiskRatio

Downside Summary: Statistics and ratios

portfolio_bacon

Bacon(2008) Data

chart.RollingMean

chart the rolling mean return

calculate a lower partial moment for a time series

chart.RollingPerformance

wrapper to create a chart of rolling performance metrics in a line chart

Selected Portfolio Weights Data

table.DownsideRisk

Downside Risk Summary: Statistics and Stylized Facts

table.ProbOutPerformance

Outperformance Report of Asset vs Benchmark

table.RollingPeriods

Rolling Periods Summary: Statistics and Stylized Facts

ShrinkageMoments

Functions for calculating shrinkage-based comoments of financial time series

upside risk, variance and potential of the return distribution

wrapper to draw scatter plot with sensible defaults

calculate various Value at Risk (VaR) measures

chart.RollingQuantileRegression

A wrapper to create charts of relative regression performance through time

to.period.contributions

Aggregate contributions through time

replaceTabs.inner

Display text information in a graphics plot.