# Riskfolio-Lib¶

**Quantitative Strategic Asset Allocation, Easy for Everyone.**

## Description¶

Riskfolio-Lib is a library for making portfolio optimization and quantitative strategic asset allocation in Python made in Peru 🇵🇪. Its objective is to help students, academics and practitioners to build investment portfolios based on mathematically complex models with low effort. It is built on top of CVXPY and closely integrated with pandas data structures.

Some of key functionalities that Riskfolio-Lib offers:

Mean Risk and Logarithmic Mean Risk (Kelly Criterion) Portfolio Optimization with 4 objective functions:

Minimum Risk.

Maximum Return.

Maximum Utility Function.

Maximum Risk Adjusted Return Ratio.

Mean Risk and Logarithmic Mean Risk (Kelly Criterion) Portfolio Optimization with 18 convex risk measures:

**Dispersion Risk Measures:**Standard Deviation.

Mean Absolute Deviation (MAD).

Gini Mean Difference (GMD).

Range.

Conditional Value at Risk Range.

Tail Gini Range.

**Downside Risk Measures:**Semi Standard Deviation.

First Lower Partial Moment (Omega Ratio).

Second Lower Partial Moment (Sortino Ratio).

Conditional Value at Risk (CVaR).

Tail Gini.

Entropic Value at Risk (EVaR).

Worst Case Realization (Minimax).

**Drawdown Risk Measures:**Maximum Drawdown (Calmar Ratio) for uncompounded cumulative returns.

Average Drawdown for uncompounded cumulative returns.

Conditional Drawdown at Risk (CDaR) for uncompounded cumulative returns.

Entropic Drawdown at Risk (EDaR) for uncompounded cumulative returns.

Ulcer Index for uncompounded cumulative returns.

Risk Parity Portfolio Optimization with 14 convex risk measures:

**Dispersion Risk Measures:**Standard Deviation.

Mean Absolute Deviation (MAD).

Gini Mean Difference (GMD).

Conditional Value at Risk Range.

Tail Gini Range.

**Downside Risk Measures:**Semi Standard Deviation.

First Lower Partial Moment (Omega Ratio)

Second Lower Partial Moment (Sortino Ratio)

Conditional Value at Risk (CVaR).

Tail Gini.

Entropic Value at Risk (EVaR).

**Drawdown Risk Measures:**Conditional Drawdown at Risk (CDaR) for uncompounded cumulative returns.

Entropic Drawdown at Risk (EDaR) for uncompounded cumulative returns.

Ulcer Index for uncompounded cumulative returns.

Hierarchical Clustering Portfolio Optimization: Hierarchical Risk Parity (HRP) and Hierarchical Equal Risk Contribution (HERC) with 27 risk measures using naive risk parity:

**Dispersion Risk Measures:**Standard Deviation.

Variance.

Mean Absolute Deviation (MAD).

Gini Mean Difference (GMD).

Range.

Conditional Value at Risk Range.

Tail Gini Range.

**Downside Risk Measures:**Semi Standard Deviation.

First Lower Partial Moment (Omega Ratio).

Second Lower Partial Moment (Sortino Ratio).

Value at Risk (VaR).

Conditional Value at Risk (CVaR).

Entropic Value at Risk (EVaR).

Tail Gini.

Worst Case Realization (Minimax).

**Drawdown Risk Measures:**Maximum Drawdown (Calmar Ratio) for compounded and uncompounded cumulative returns.

Average Drawdown for compounded and uncompounded cumulative returns.

Drawdown at Risk (DaR) for compounded and uncompounded cumulative returns.

Conditional Drawdown at Risk (CDaR) for compounded and uncompounded cumulative returns.

Entropic Drawdown at Risk (EDaR) for compounded and uncompounded cumulative returns.

Ulcer Index for compounded and uncompounded cumulative returns.

Nested Clustered Optimization (NCO) with four objective functions and the available risk measures to each objective:

Minimum Risk.

Maximum Return.

Maximum Utility Function.

Equal Risk Contribution.

Worst Case Mean Variance Portfolio Optimization.

Relaxed Risk Parity Portfolio Optimization.

Ordered Weighted Averaging (OWA) Portfolio Optimization.

Portfolio optimization with Black Litterman model.

Portfolio optimization with Risk Factors model.

Portfolio optimization with Black Litterman Bayesian model.

Portfolio optimization with Augmented Black Litterman model.

Portfolio optimization with constraints on tracking error and turnover.

Portfolio optimization with short positions and leveraged portfolios.

Portfolio optimization with constraints on number of assets and number of effective assets.

Tools to build efficient frontier for 18 risk measures.

Tools to build linear constraints on assets, asset classes and risk factors.

Tools to build views on assets and asset classes.

Tools to build views on risk factors.

Tools to calculate risk measures.

Tools to calculate risk contributions per asset.

Tools to calculate uncertainty sets for mean vector and covariance matrix.

Tools to calculate assets clusters based on codependence metrics.

Tools to estimate loadings matrix (Stepwise Regression and Principal Components Regression).

Tools to visualizing portfolio properties and risk measures.

Tools to build reports on Jupyter Notebook and Excel.

Option to use commercial optimization solver like MOSEK or GUROBI for large scale problems.

## Citing¶

If you use Riskfolio-Lib for published work, please use the following BibTeX entry:

```
@misc{riskfolio,
author = {Dany Cajas},
title = {Riskfolio-Lib (3.0.0)},
year = {2022},
url = {https://github.com/dcajasn/Riskfolio-Lib},
}
```

## Contents¶

## Indices and tables¶

## Module Plans¶

The plan for this library is to add more functions that will be very useful for students, academics and practitioners.

Add more functions based on suggestion of users.