[Returnanalytics-commits] r3177 - pkg/PortfolioAnalytics/man

Tue Sep 24 03:30:20 CEST 2013

Author: rossbennett34
Date: 2013-09-24 03:30:19 +0200 (Tue, 24 Sep 2013)
New Revision: 3177

Modified:
   pkg/PortfolioAnalytics/man/PortfolioAnalytics-package.Rd
Log:
Adding content to PortfolioAnalytics-package file.

Modified: pkg/PortfolioAnalytics/man/PortfolioAnalytics-package.Rd
===================================================================

--- pkg/PortfolioAnalytics/man/PortfolioAnalytics-package.Rd	2013-09-24 00:56:00 UTC (rev 3176)
+++ pkg/PortfolioAnalytics/man/PortfolioAnalytics-package.Rd	2013-09-24 01:30:19 UTC (rev 3177)
@@ -11,7 +11,7 @@
 
 One of the goals of the packages is to provide a common interface to specify constraints and objectives that can be solved by any supported solver (i.e. optimization method). Currently supported optimization methods include random portfolios, differential evolution, particle swarm optimization, generalized simulated annealing, and linear and quadratic programming routines. Additional information on random portfolios is provided below. The differential evolution algorithm is implemented via the \kbd{DEoptim} package, the particle swarm optimization algorithm via the \kbd{pso} package, the generalized simulated annealing via the \kbd{GenSA} package, and linear and quadratic programming are implemented via the \kbd{ROI} package which acts as an interface to the \kbd{Rglpk} and \kbd{quadprog} packages.
 
-A key strength of \kbd{PortfolioAnalytics} is the generalization of constraints and objectives that can be solved by any available optimization methods. The quadratic and linear programming solvers can solve a limited type of convex optimization problems.
+A key strength of \kbd{PortfolioAnalytics} is the generalization of constraints and objectives that can be solved. The quadratic and linear programming solvers can solve a limited type of convex optimization problems.
 \itemize{
   \item Maxmimize portfolio return subject leverage, box, group, position limit, target mean return, and/or factor exposure constraints on weights.
   \item Minimize portfolio variance subject to leverage, box, group, turnover, and/or factor exposure constraints (otherwise known as global minimum variance portfolio).
@@ -25,12 +25,12 @@
 \itemize{
   \item The ’sample’ method to generate random portfolios is based on an idea by Pat Burns. This is the most flexible method, but also the slowest, and can generate portfolios to satisfy leverage, box, group, and position limit constraints.
   \item The ’simplex’ method to generate random portfolios is based on a paper by W. T. Shaw. The simplex method is useful to generate random portfolios with the full investment constraint, where the sum of the weights is equal to 1, and min box constraints. Values for min_sum and max_sum of the leverage constraint will be ignored, the sum of weights will equal 1. All other constraints such as the box constraint max, group and position limit constraints will be handled by elimination. If the constraints are very restrictive, this may result in very few feasible portfolios remaining. Another key point to note is that the solution may not be along the vertexes depending on the objective. For example, a risk budget objective will likely place the portfolio somewhere on the interior.
-  \item The ’grid’ method to generate random portfolios is based on the \code{gridSearch} function in package \kbd{NMOF}. The grid search method only satisfies the min and max box constraints. The min_sum and max_sum leverage constraint will likely be violated and the weights in the random portfolios should be normalized. Normalization may cause the box constraints to be violated and will be penalized in constrained_objective.
+  \item The ’grid’ method to generate random portfolios is based on the \code{gridSearch} function in package \kbd{NMOF}. The grid search method only satisfies the min and max box constraints. The min_sum and max_sum leverage constraint will likely be violated and the weights in the random portfolios should be normalized. Normalization may cause the box constraints to be violated and will be penalized in \code{constrained_objective}.
 }
 
 \kbd{PortfolioAnalytics} leverages the \kbd{PerformanceAnalytics} package for many common objective functions. The objective types in \kbd{PortfolioAnalytics} are designed to be used with \kbd{PerformanceAnalytics} functions, but any user supplied valid R function can be used as an objective.
 
-This summary attempts to provide an overview of how to construct a portfolio object with constraints and objectives, and then run the optimization.
+This summary attempts to provide an overview of how to construct a portfolio object with constraints and objectives, run the optimization, and chart the results.
 }
 
 \section{Optimization}{
@@ -44,25 +44,48 @@
 }
 
 \section{Charts and Graphs}{
-TODO
+Intuition into the optimization can be aided through visualization. The goal of creating the charts is to provide visualization tools for optimal portfolios regardless of the chosen optimization method.
+
+\code{\link{chart.Weights}} plots the weights of the optimal portfolio. \code{\link{chart.RiskReward}} plots the optimal portfolio in risk-reward space. The random portfolios, DEoptim, and pso solvers will return trace portfolio information at each iteration when \code{\link{optimize.portfolio}} is run with \code{trace=TRUE}. If this is the case, \code{\link{chart.RiskReward}} will plot these portfolios so that the feasible space can be easily visualized. Although the GenSA and ROI solvers do not return trace portfolio information, random portfolios can be be generated with the argument \code{rp=TRUE} in \code{\link{chart.RiskReward}}. A \code{plot} function is provided that will plot the weights and risk-reward scatter chart. The component risk contribution can be charted for portfolio optimization problems with risk budget objectives with \code{\link{chart.RiskBudget}}. Neighbor portfolios can be plotted in \code{\link{chart.RiskBudget}}, \code{\link{chart.Weights}}, and \code{\link{chart.RiskReward}}.
+
+Efficient frontiers can be extracted from \code{optimize.portfolio} objects or created from a \code{portfolio} object. The efficient frontier can be charted in risk-reward space with \code{\link{chart.EfficientFrontier}}. The weights along the efficient frontier can be charted with \code{\link{chart.Weights.EF}}.
+
+Multiple objects created via \code{\link{optimize.portfolio}} can be combined with \code{\link{combine.optimizations}} for visual comparison. The weights of the optimal portfolios can be plotted with \code{\link{chart.Weights}}. The optimal portfolios can be compared in risk-reward space with \code{\link{chart.RiskReward}}. The portfolio component risk contributions of the multiple optimal portfolios can be plotted with \code{\link{chart.RiskBudget}}.
 }
 
 \section{Further Work}{
-TODO
+Continued work to improved charts and graphs.
+
+Continued work to improve features to combine and compare multiple optimal portfolio objects.
+
+Support for more solvers.
+
+Comments, suggestions, and/or code patches are welcome.
 }
 
-\section{Acknowledgements}{
-TODO
+\author{
+Kris Boudt \cr
+Peter Carl \cr
+Brian G. Peterson \cr
+
+Maintainer: Brian G. Peterson \email{brian at braverock.com}
 }
 
-\section{References}{
+\references{
+Shaw, William Thornton, \emph{Portfolio Optimization for VAR, CVaR, Omega and Utility with General Return Distributions: A Monte Carlo Approach for Long-Only and Bounded Short Portfolios with Optional Robustness and a Simplified Approach to Covariance Matching} (June 1, 2011). Available at SSRN: http://ssrn.com/abstract=1856476 or http://dx.doi.org/10.2139/ssrn.1856476 \cr
+
+Scherer, B. and Martin, D. \emph{Modern Portfolio Optimization}. Springer. 2005. \cr
+
+}
+
+\section{Acknowledgements}{
 TODO
-W.T. Shaw Paper
-Modern Portfolio Optimization
-Large-scale portfolio optimization with DEoptim 
-http://cran.r-project.org/web/packages/DEoptim/vignettes/DEoptimPortfolioOptimization.pdf
 }
 
-\section{See Also}{
-TODO
+\seealso{
+CRAN task view on Empirical Finance \cr \url{http://cran.r-project.org/src/contrib/Views/Econometrics.html}
+
+CRAN task view on Optimization \cr \url{http://cran.r-project.org/web/views/Optimization.html}
+
+Large-scale portfolio optimization with DEoptim \cr \url{http://cran.r-project.org/web/packages/DEoptim/vignettes/DEoptimPortfolioOptimization.pdf}
 }
\ No newline at end of file

