riskParityPortfolio

Design of Risk Parity Portfolios

dppalomar
78
24
R

output:
html_document:
variant: markdown_github
keep_md: true
md_document:
variant: markdown_github

library(knitr)
opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  fig.align = "center",
  fig.retina = 2,
  out.width = "75%",
  dpi = 96
)
knit_hooks$set(pngquant = hook_pngquant)

riskParityPortfolio

codecov
CRAN_Status_Badge
CRAN Downloads
CRAN Downloads Total
Rcpp

riskParityPortfolio provides tools to design risk parity portfolios.
In its simplest form, we consider the convex formulation with a unique solution proposed by
Spinu (2013) and use a cyclical method inspired by
Griveau-Billion (2013). For more general formulations,
which are usually nonconvex, we implement the successive convex approximation
method proposed by Feng & Palomar (2015).

The latest stable version of riskParityPortfolio is available at https://CRAN.R-project.org/package=riskParityPortfolio.

The latest development version of riskParityPortfolio is available at https://github.com/dppalomar/riskParityPortfolio.

Check out the documentation here: https://mirca.github.io/riskParityPortfolio.

Installation

To install the latest stable version of riskParityPortfolio from CRAN, run the following commands in R:

> install.packages("riskParityPortfolio")

To install the development version of riskParityPortfolio from GitHub, run the following commands in R:

> install.packages("devtools")
> devtools::install_github("dppalomar/riskParityPortfolio")

To get help:

> library(riskParityPortfolio)
> help(package = "riskParityPortfolio")
> package?riskParityPortfolio
> ?riskParityPortfolio

Please cite riskParityPortfolio in publications:

> citation("riskParityPortfolio")

You can also get riskParityPortfolio from Docker as follows:

$ docker pull mirca/riskparityportfolio

Microsoft Windows

On MS Windows environments, make sure to install the most recent version of
Rtools.

Python

A Python3 implementation of this package is currently under development at https://github.com/dppalomar/riskparity.py.
Its stable version is available in PYPI and can be installed as follows:

$ pip install riskparityportfolio

Alternatively, the development version can be installed as

$ git clone https://github.com/dppalomar/riskparity.py
$ cd riskparity.py
$ pip install -e .

Rust

A Rust version is avaiable at: https://github.com/mirca/riskparity.rs.

Basic usage

library(riskParityPortfolio)

set.seed(42)
# create covariance matrix
N <- 5
V <- matrix(rnorm(N^2), ncol = N)
Sigma <- cov(V)

# risk parity portfolio
res <- riskParityPortfolio(Sigma)
names(res)
res$w

# risk budgeting portfolio
res <- riskParityPortfolio(Sigma, b = c(0.4, 0.4, 0.1, 0.05, 0.05))
res$relative_risk_contribution

Documentation

For more detailed information, please check the
vignette.

Citation

If you find this package useful in your research, please consider citing the following works:

Contributing

We welcome all sorts of contributions. Please feel free to open an issue
to report a bug or discuss a feature request.

Links

Package: CRAN and GitHub.

README file: GitHub-readme.

Vignettes: CRAN-vignette,
slides R/Finance 2019,
slides RPP - Convex Optimization Course (HKUST),
slides HKML meetup 2020, and
tutorial - Data-driven Portfolio Optimization Course (HKUST)

Disclaimer

The information, software, and any additional resources contained in this repository are not intended as,
and shall not be understood or construed as, financial advice.
Past performance is not a reliable indicator of future results and investors may not recover the full
amount invested.
The authors of this repository
accept no liability whatsoever for any loss or damage you may incur. Any opinions expressed in this repository
are from the personal research and experience of the authors and are intended as educational material.