Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/braverock/PortfolioAnalytics


https://github.com/braverock/PortfolioAnalytics

Last synced: 10 months ago
JSON representation

Awesome Lists containing this project

README 

          
README

================



This V2.1 version of PortfolioAnalytics is an update to the substantial

V2.0 version that was released on 2024-07-03. We first describe the V2.0

features, then discuss the R demo capability, and finally we describe

the additional V2.1 features.



# 2.0 Features



A major feature of 2.0 was the integration of the CVXR solver R package

for convex optimization. CVXR supports eleven solver packages, each of

which supports solvers for one or more of the following optimization

problems: LP, QP, SOCP, SDP, EXP, MIP. See the Table near the beginning

of the document “Convex Optimization in R” at .

Thus, with PortfolioAnalytics 2.0, users are able to use any one of a

large variety of solvers available in CVXR for their portfolio optimization

problems.



A particular use of CVXR in PortfolioAnalytics 2.0 is for computing

Minimum Coherent Second Moment (MCSM) portfolios, which are

second-order cone programming (SOCP) optimization problems. This is

a quite new capability that is not available in other portfolio

optimization software products. Details are provided in the Vignette

“cvxrPortfolioAnalytics”.



Another important feature of PortfolioAnalytics 2.0, is that it contains

functionality for computing outliers-robust minimum variance (MV)

optimal portfolios based on any one of several robust covariance matrix

estimators that are not much influenced by outliers Details are provided

in the Vignette “robustCovMatForPA”.



New PortfolioAnalytics Functions:



1.  meancsm.efficient.frontier (create Mean-CSM efficient frontier)

    utility function

2.  meanrisk.efficient.frontier (generate multiple efficient frontiers

    for portfolios with the same constraint object.

3.  extract_risk (extract the risk value, e.g., StdDev or ES or CSM,

    based on the weights of a portfolio)

4.  chart.EfficientFrontierCompare (Overlay the efficient frontiers of

    different minRisk portfolio objects on a single plot)

5.  backtest.plot (based on Peter Carl’s code, generate plots of the

    cumulative returns and/or drawdown for back-testing)

6.  opt.outputMvo (converts output of `optimize.portfolio` to a list of

    the portfolio weights, mean, volatility and Sharpe Ratio)

7.  plotFrontiers (plot frontiers based on the result of

    `meanvar.efficient.frontier`, `meanetl.efficient.frontier` or

    `meancsm.efficient.frontier`)



Enhanced PortfolioAnalytics Functions:



1.  optimize.portfolio (enhanced with CVXR solvers, CSM objective,

    customizable arg `momentFUN=` and output `~$moment_values`)

2.  optimize.portfolio.rebalancing (enhanced with CVXR solvers, CSM

    objective and customizable arg `momentFUN=`)

3.  create.EfficientFrontier (enhanced with type `mean-CSM` and

    `mean-risk`, and customizable arg `momentFUN=`)



Support of S3 Methods for CVXR:

1.  print.optimize.portfolio.CVXR

2.  extractStats.optimize.portfolio.CVXR



Custom Moment Functions for Robust Covariance Matrices:

1.  custom.covRob.MM

2.  custom.covRob.Rocke

3.  custom.covRob.Mcd

4.  custom.covRob.TSGS

5.  MycovRobMcd

6.  MycovRobTSGS



Two New Vignettes, the pdf files of which are downloadable from PortfolioAnalytics at

:

1.  cvxrPortfolioAnalytics, with CRAN title “CVXR for PortfolioAnalytics”.

2.  robustCovMatForPA, with CRAN title “Robust Covariance Matrices for

    PortfolioAnalytics”



# PortfolioAnalytics Demo Scripts

PortfolioAnalytics has contained a substantial number of demo R scripts in the *demo* folder for a long time.  Assuming that an R package is installed, but not necessarily loaded, you can view a list of the names of al the demo folder R scripts with the following R command



demo(package = “packageName”)



Use the above for the PortfolioAnalytics package, and you will see a list of over 30 demo scripts,

among which you will see the the following two demo scripts



1.  demo_cvxrPortfolioAnalytics.R

2.  demo_robustCovMatForPA.R



which runs the code for the corresponding two Vignettes listed above.



You can view the code for any demo R script with the command “??” (but not with “help” command).  For example, in RStudio, use of the command



?? demo_cvxrPortfolioAnalytics



results in a Help tab display with the followng two links:



* *PortfolioAnalytics::demo_cvxrPortfolioAnalytics*

* (*Run demo*).



Use the first link, which results in a display of the entire R script in the Help tab.  Then copy/paste the script into your own new R file, and run it in chunks that are of interest to you. Many of the chunks will run quite quickly, e.g., a few seconds, but a few of them may take 2-4 minutes. Doing so for the demo_cvxrPortfolioAnalytics.R will help you learn some PortfolioAnalytics basics, as well as learn how to use new capabilities in Versions 2.0 and 2.1. Running the demo_robustCovMatForPA.R scripts will show you how to compute *robust minimum variance* portfolios based on returns *robust covariance matrix estimators* that are not much influenced by returns outliers.



NOTE: We do not recommend general use of (*Run demo*). This is because it runs the entire demo script, which will often take much too long. Furthermore, some scripts may fail to execute properly when run this way. That said, the (*Run demo*) link can be handy for running R demo scripts that execute quickly.



# New 2.1 Features



The 2.1 version of PortfolioAnalytics contains the following new demo scripts:



1. demo_JPM2024MinDownsideRisk.R

2. demo_JPM2024MinDownsideRiskCVXR.R



The first script replicates all the Exhibits (Figures and Tables) in the Journal of Portfolio Management paper “Minimum Downside Risk Portfolios", published in October 2024. This first script uses CVXR package solvers “under the hood”, i.e., not directly visible, in PortfolioAnalytics.  The second script replicates just the back-test results in Exhibits 6, 8, 10, 12, 14, 16, 18, in the above paper, but it uses the CVXR code directly in the script, where on can easily see the CVXR code details.



The 2.1 release also contains:



1. Extended functionalities for graphical displays of multiple efficient frontiers, and robust covariance estimator settings

2. The term EQS for *expected quadratic shortfall* was replaced with CSM for *coherent second moment* risk.

3. Updates to the vignettes cvxrPortfolioAnalytics and robustCovMatForPA, and their demo scripts.



# Bug Reporting



Please contribute with bug fixes, comments, and testing scripts!



Please take your data and disguise it when submitting, or use data sets

like “edhec” like we do in the demos or or like “stocksCRSP” and

“factorsSPGMI” in the PCRA package or with your constraints and other

objectives modified to demonstrate your problem on public data.



Please report any bugs or issues on the PortfolioAnalytics GitHub page

at 



# Acknowledgements



The bulk of the work in creating PortfolioAnalytics 2.0 was done by

Xinran Zhao, along with contributions from Yifu Kang, under the support

of a 2022 Google Summer of Code (GSOC 2022). Xinran and Yifu were

mentored in GSOC 2022 by Professor Doug Martin and Professor Steve

Murray in the Applied Mathematics Department at the University of

Washington.