PortfolioMAD

Create PortfolioMAD object for mean-absolute deviation portfolio optimization and analysis

Description

The PortfolioMAD object implements mean-absolute deviation portfolio optimization, where MAD stands for “mean-absolute deviation.” PortfolioMAD objects support functions that are specific to MAD portfolio optimization.

The main workflow for MAD portfolio optimization is to create an instance of a PortfolioMAD object that completely specifies a portfolio optimization problem and to operate on the PortfolioMAD object to obtain and analyze efficient portfolios. For more information on the workflow when using PortfolioMAD objects, see PortfolioMAD Object Workflow.

You can use the PortfolioMAD object in several ways. To set up a portfolio optimization problem in a PortfolioMAD object, the simplest syntax is:

p = PortfolioMAD;

This syntax creates a PortfolioMAD object, p, such that all object properties are empty.

The PortfolioMAD object also accepts collections of name-value pair arguments for properties and their values. The PortfolioMAD object accepts inputs for properties with the general syntax:

	p = PortfolioMAD('property1',value1,'property2',value2, ... );

If a PortfolioMAD object exists, the syntax permits the first (and only the first argument) of the PortfolioMAD object to be an existing object with subsequent name-value pair arguments for properties to be added or modified. For example, given an existing PortfolioMAD object in p, the general syntax is:

p = PortfolioMAD(p,'property1',value1,'property2',value2, ... );

Input argument names are not case-sensitive, but must be completely specified. In addition, several properties can be specified with alternative argument names (see Shortcuts for Property Names). The PortfolioMAD object tries to detect problem dimensions from the inputs and, once set, subsequent inputs can undergo various scalar or matrix expansion operations that simplify the overall process to formulate a problem. In addition, a PortfolioMAD object is a value object so that, given portfolio p, the following code creates two objects, p and q, that are distinct:

q = PortfolioMAD(p, ...)

After creating a PortfolioMAD object, you can use the associated object functions to set portfolio constraints, analyze the efficient frontier, and validate the portfolio model.

For more detailed information on the theoretical basis for conditional value-at-risk portfolio optimization, see Portfolio Optimization Theory.

Creation

Syntax

p = PortfolioMAD

p = PortfolioMAD(Name,Value)

p = PortfolioMAD(p,Name,Value)

Description

p = PortfolioMAD creates an empty PortfolioMAD object for mean-absolute deviation portfolio optimization and analysis. You can then add elements to the PortfolioMAD object using the supported "add" and "set" functions. For more information, see Creating the PortfolioMAD Object.

p = PortfolioMAD(Name,Value) creates a PortfolioMAD object (p) and sets Properties using name-value pairs. For example, p = PortfolioMAD('AssetList',Assets(1:12)). You can specify multiple name-value pairs.

p = PortfolioMAD(p,Name,Value) creates a PortfolioMAD object (p) using a previously created PortfolioMAD object p and sets Properties using name-value pairs. You can specify multiple name-value pairs.

Input Arguments

p — Previously constructed PortfolioMAD object

object

Previously constructed PortfolioMAD object, specified using PortfolioMAD.

Properties

Setting Up the PortfolioMAD Object

AssetList — Names or symbols of assets in universe

[] (default) | cell array of character vectors | string array

Names or symbols of assets in the universe, specified as a cell array of character vectors or a string array.

Data Types: cell | string

InitPort — Initial portfolio

[] (default) | vector

Initial portfolio, specified as a vector.

Data Types: double

Name — Name for instance of PortfolioMAD object

[] (default) | character vector | string

Name for instance of the PortfolioMAD object, specified as a character vector.

Data Types: char | string

NumAssets — Number of assets in the universe

[] (default) | integer scalar

Number of assets in the universe, specified as an integer scalar.

Data Types: double

PortfolioMAD Object Constraints

AEquality — Linear equality constraint matrix

[] (default) | matrix

Linear equality constraint matrix, specified as a matrix. For more information, see Linear Equality Constraints.

Data Types: double

AInequality — Linear inequality constraint matrix

[] (default) | matrix

Linear inequality constraint matrix, specified as a matrix. For more information, see Linear Inequality Constraints.

Data Types: double

bEquality — Linear equality constraint vector

[] (default) | vector

Linear equality constraint vector, specified as a vector. For more information, see Linear Equality Constraints.

Data Types: double

bInequality — Linear inequality constraint

[] (default) | vector

Linear inequality constraint vector, specified as a vector. For more information, see Linear Inequality Constraints.

Data Types: double

GroupA — Group A weights to be bounded by weights in group B

[] (default) | matrix

Group A weights to be bounded by weights in group B, specified as a matrix. For more information, see Group Constraints.

Data Types: double

GroupB — Group B weights

[] (default) | matrix

Group B weights, specified as a matrix. For more information, see Group Constraints.

Data Types: double

GroupMatrix — Group membership matrix

[] (default) | matrix

Group membership matrix, specified as a matrix. For more information, see Group Ratio Constraints.

Data Types: double

LowerBound — Lower-bound constraint

[] (default) | vector

Lower-bound constraint, specified as a vector. For more information, see 'Simple' Bound Constraints and 'Conditional' Bound Constraints.

Data Types: double

LowerBudget — Lower-bound budget constraint

[] (default) | scalar

Lower-bound budget constraint, specified as a scalar. For more information, see Budget Constraints.

Data Types: double

LowerGroup — Lower-bound group constraint

[] (default) | vector

Lower-bound group constraint, specified as a vector. For more information, see Group Constraints.

Data Types: double

LowerRatio — Minimum ratio of allocations between Groups A and B

[] (default) | vector

Minimum ratio of allocations between GroupA and GroupB, specified as a vector. For more information, see Group Ratio Constraints.

Data Types: double

UpperBound — Upper-bound constraint

[] (default) | vector

Upper-bound constraint, specified as a vector. For more information, see 'Simple' Bound Constraints and 'Conditional' Bound Constraints.

Data Types: double

UpperBudget — Upper-bound budget constraint

[] (default) | scalar

Upper-bound budget constraint, specified as a scalar. For more information, see Budget Constraints.

Data Types: double

UpperGroup — Upper-bound group constraint

[] (default) | vector

Upper-bound group constraint, specified as a vector. For more information, see Group Constraints.

Data Types: double

UpperRatio — Maximum ratio of allocations between Groups A and B

[] (default) | vector

Maximum ratio of allocations between GroupA and GroupB, specified as a vector. For more information, see Group Ratio Constraints.

Data Types: double

BoundType — Type of bounds for each asset weight

'Simple' (default) | character vector with value 'Simple' or 'Conditional' | string with value "Simple" or "Conditional" | cell array of character vectors with values 'Simple' or 'Conditional' | string array with values "Simple" or "Conditional"

Type of bounds for each asset weight, specified as a scalar character vector or string, or a cell array of character vectors or a string array. For more information, see setBounds.

Data Types: char | cell | string

MinNumAssets — Minimum number of assets allocated in portfolio

[] (default) | numeric

Minimum number of assets allocated in portfolio, specified as a scalar numeric value. For more information, see setMinMaxNumAssets and Cardinality Constraints.

Data Types: double

MaxNumAssets — Maximum number of assets allocated in portfolio

[] (default) | numeric

Maximum number of assets allocated in portfolio, specified as a scalar numeric value. For more information, see setMinMaxNumAssets and Cardinality Constraints.

Data Types: double

BuyTurnover — Turnover constraint on purchases

[] (default) | scalar

Turnover constraint on purchases, specified as a scalar. For more information, see Average Turnover Constraints and One-way Turnover Constraints.

Data Types: double

SellTurnover — Turnover constraint on sales

[] (default) | scalar

Turnover constraint on sales, specified as a scalar. For more information, see Average Turnover Constraints and One-way Turnover Constraints.

Data Types: double

Turnover — Turnover constraint

[] (default) | scalar

Turnover constraint, specified as a scalar. For more information, see Average Turnover Constraints and One-way Turnover Constraints.

Data Types: double

PortfolioMAD Object Modeling

BuyCost — Proportional purchase costs

[] (default) | vector

Proportional purchase costs, specified as a vector. For more information, see Net Portfolio Returns.

Data Types: double

RiskFreeRate — Risk-free rate

[] (default) | scalar

Risk-free rate, specified as a scalar.

Data Types: double

ProbabilityLevel — Value-at-risk probability level which is 1 − (loss probability)

[] (default) | scalar

Value-at-risk probability level which is 1 − (loss probability), specified as a scalar.

Data Types: double

NumScenarios — Number of scenarios

[] (default) | integer scalar

Number of scenarios, specified as an integer scalar.

Data Types: double

SellCost — Proportional sales costs

[] (default) | vector

Proportional sales costs, specified as a vector. For more information, see Net Portfolio Returns.

Data Types: double

Object Functions

setAssetList	Set up list of identifiers for assets
setInitPort	Set up initial or current portfolio
setDefaultConstraints	Set up portfolio constraints with nonnegative weights that sum to 1
estimateAssetMoments	Estimate mean and covariance of asset returns from data
setCosts	Set up proportional transaction costs for portfolio
addEquality	Add linear equality constraints for portfolio weights to existing constraints
addGroupRatio	Add group ratio constraints for portfolio weights to existing group ratio constraints
addGroups	Add group constraints for portfolio weights to existing group constraints
addInequality	Add linear inequality constraints for portfolio weights to existing constraints
getBounds	Obtain bounds for portfolio weights from portfolio object
getBudget	Obtain budget constraint bounds from portfolio object
getCosts	Obtain buy and sell transaction costs from portfolio object
getEquality	Obtain equality constraint arrays from portfolio object
getGroupRatio	Obtain group ratio constraint arrays from portfolio object
getGroups	Obtain group constraint arrays from portfolio object
getInequality	Obtain inequality constraint arrays from portfolio object
getOneWayTurnover	Obtain one-way turnover constraints from portfolio object
setGroups	Set up group constraints for portfolio weights
setInequality	Set up linear inequality constraints for portfolio weights
setBounds	Set up bounds for portfolio weights for portfolio
setMinMaxNumAssets	Set cardinality constraints on the number of assets invested in a portfolio
setBudget	Set up budget constraints for portfolio
setCosts	Set up proportional transaction costs for portfolio
setDefaultConstraints	Set up portfolio constraints with nonnegative weights that sum to 1
setEquality	Set up linear equality constraints for portfolio weights
setGroupRatio	Set up group ratio constraints for portfolio weights
setInitPort	Set up initial or current portfolio
setOneWayTurnover	Set up one-way portfolio turnover constraints
setTurnover	Set up maximum portfolio turnover constraint
checkFeasibility	Check feasibility of input portfolios against portfolio object
estimateBounds	Estimate global lower and upper bounds for set of portfolios
estimateFrontier	Estimate specified number of optimal portfolios on the efficient frontier
estimateFrontierByReturn	Estimate optimal portfolios with targeted portfolio returns
estimateFrontierByRisk	Estimate optimal portfolios with targeted portfolio risks
estimateFrontierLimits	Estimate optimal portfolios at endpoints of efficient frontier
plotFrontier	Plot efficient frontier
estimatePortReturn	Estimate mean of portfolio returns
estimatePortRisk	Estimate portfolio risk according to risk proxy associated with corresponding object
setSolver	Choose main solver and specify associated solver options for portfolio optimization
setProbabilityLevel	Set probability level for VaR and CVaR calculations
setScenarios	Set asset returns scenarios by direct matrix
getScenarios	Obtain scenarios from portfolio object
simulateNormalScenariosByData	Simulate multivariate normal asset return scenarios from data
simulateNormalScenariosByMoments	Simulate multivariate normal asset return scenarios from mean and covariance of asset returns
estimateScenarioMoments	Estimate mean and covariance of asset return scenarios
estimatePortStd	Estimate standard deviation of portfolio returns

Examples

Create an Empty PortfolioMAD Object

You can create a PortfolioMAD object, p, with no input arguments and display it using disp.

p = PortfolioMAD;
disp(p);

  PortfolioMAD with properties:

         BuyCost: []
        SellCost: []
    RiskFreeRate: []
        Turnover: []
     BuyTurnover: []
    SellTurnover: []
    NumScenarios: []
            Name: []
       NumAssets: []
       AssetList: []
        InitPort: []
     AInequality: []
     bInequality: []
       AEquality: []
       bEquality: []
      LowerBound: []
      UpperBound: []
     LowerBudget: []
     UpperBudget: []
     GroupMatrix: []
      LowerGroup: []
      UpperGroup: []
          GroupA: []
          GroupB: []
      LowerRatio: []
      UpperRatio: []
    MinNumAssets: []
    MaxNumAssets: []
       BoundType: []

This approach provides a way to set up a portfolio optimization problem with the PortfolioMAD function. You can then use the associated set functions to set and modify collections of properties in the PortfolioMAD object.

Create a PortfolioMAD Object Using a Single-Step Setup

You can use the PortfolioMAD object directly to set up a “standard” portfolio optimization problem. Given scenarios of asset returns in the variable AssetScenarios, this problem is completely specified as follows:

m = [ 0.05; 0.1; 0.12; 0.18 ];
C = [ 0.0064 0.00408 0.00192 0; 
    0.00408 0.0289 0.0204 0.0119;
    0.00192 0.0204 0.0576 0.0336;
    0 0.0119 0.0336 0.1225 ];
m = m/12;
C = C/12;

AssetScenarios = mvnrnd(m, C, 20000);

p = PortfolioMAD('Scenarios', AssetScenarios, ...
'LowerBound', 0, 'LowerBudget', 1, 'UpperBudget', 1)

p = 
  PortfolioMAD with properties:

         BuyCost: []
        SellCost: []
    RiskFreeRate: []
        Turnover: []
     BuyTurnover: []
    SellTurnover: []
    NumScenarios: 20000
            Name: []
       NumAssets: 4
       AssetList: []
        InitPort: []
     AInequality: []
     bInequality: []
       AEquality: []
       bEquality: []
      LowerBound: [4x1 double]
      UpperBound: []
     LowerBudget: 1
     UpperBudget: 1
     GroupMatrix: []
      LowerGroup: []
      UpperGroup: []
          GroupA: []
          GroupB: []
      LowerRatio: []
      UpperRatio: []
    MinNumAssets: []
    MaxNumAssets: []
       BoundType: []

Note that the LowerBound property value undergoes scalar expansion since AssetScenarios provides the dimensions of the problem.

Create a PortfolioMAD Object Using a Sequence of Steps

Using a sequence of steps is an alternative way to accomplish the same task of setting up a “standard” MAD portfolio optimization problem, given AssetScenarios variable is:

m = [ 0.05; 0.1; 0.12; 0.18 ];
C = [ 0.0064 0.00408 0.00192 0;
0.00408 0.0289 0.0204 0.0119;
0.00192 0.0204 0.0576 0.0336;
0 0.0119 0.0336 0.1225 ];

m = m/12;
C = C/12;

AssetScenarios = mvnrnd(m, C, 20000);

p = PortfolioMAD;
p = setScenarios(p, AssetScenarios);
p = PortfolioMAD(p, 'LowerBound', 0);
p = PortfolioMAD(p, 'LowerBudget', 1, 'UpperBudget', 1);

plotFrontier(p);

This way works because the calls to PortfolioMAD are in this particular order. In this case, the call to initialize AssetScenarios provides the dimensions for the problem. If you were to do this step last, you would have to explicitly dimension the LowerBound property as follows:

m = [ 0.05; 0.1; 0.12; 0.18 ];
C = [ 0.0064 0.00408 0.00192 0;
0.00408 0.0289 0.0204 0.0119;
0.00192 0.0204 0.0576 0.0336;
0 0.0119 0.0336 0.1225 ];

m = m/12;
C = C/12;

AssetScenarios = mvnrnd(m, C, 20000);

p = PortfolioMAD;
p = PortfolioMAD(p, 'LowerBound', zeros(size(m)));
p = PortfolioMAD(p, 'LowerBudget', 1, 'UpperBudget', 1);
p = setScenarios(p, AssetScenarios);

plotFrontier(p);

If you did not specify the size of LowerBound but, instead, input a scalar argument, the PortfolioMAD object assumes that you are defining a single-asset problem and produces an error at the call to set asset scenarios with four assets.

Create a PortfolioMAD Object Using Shortcuts for Property Names

You can create a PortfolioMAD object, p with the PortfolioMAD object using shortcuts for property names.

m = [ 0.05; 0.1; 0.12; 0.18 ];
C = [ 0.0064 0.00408 0.00192 0;
0.00408 0.0289 0.0204 0.0119;
0.00192 0.0204 0.0576 0.0336;
0 0.0119 0.0336 0.1225 ];

m = m/12;
C = C/12;

AssetScenarios = mvnrnd(m, C, 20000);

p = PortfolioMAD('scenario', AssetScenarios, 'lb', 0, 'budget', 1)

p = 
  PortfolioMAD with properties:

         BuyCost: []
        SellCost: []
    RiskFreeRate: []
        Turnover: []
     BuyTurnover: []
    SellTurnover: []
    NumScenarios: 20000
            Name: []
       NumAssets: 4
       AssetList: []
        InitPort: []
     AInequality: []
     bInequality: []
       AEquality: []
       bEquality: []
      LowerBound: [4x1 double]
      UpperBound: []
     LowerBudget: 1
     UpperBudget: 1
     GroupMatrix: []
      LowerGroup: []
      UpperGroup: []
          GroupA: []
          GroupB: []
      LowerRatio: []
      UpperRatio: []
    MinNumAssets: []
    MaxNumAssets: []
       BoundType: []

Direct Setting of PortfolioMAD Object Properties

Although not recommended, you can set properties directly, however no error-checking is done on your inputs.

m = [ 0.05; 0.1; 0.12; 0.18 ];
C = [ 0.0064 0.00408 0.00192 0; 
    0.00408 0.0289 0.0204 0.0119;
    0.00192 0.0204 0.0576 0.0336;
    0 0.0119 0.0336 0.1225 ];
m = m/12;
C = C/12;

AssetScenarios = mvnrnd(m, C, 20000);

p = PortfolioMAD;

p = setScenarios(p, AssetScenarios);

p.LowerBudget = 1;
p.UpperBudget = 1;
p.LowerBound = zeros(size(m));
disp(p);

  PortfolioMAD with properties:

         BuyCost: []
        SellCost: []
    RiskFreeRate: []
        Turnover: []
     BuyTurnover: []
    SellTurnover: []
    NumScenarios: 20000
            Name: []
       NumAssets: 4
       AssetList: []
        InitPort: []
     AInequality: []
     bInequality: []
       AEquality: []
       bEquality: []
      LowerBound: [4x1 double]
      UpperBound: []
     LowerBudget: 1
     UpperBudget: 1
     GroupMatrix: []
      LowerGroup: []
      UpperGroup: []
          GroupA: []
          GroupB: []
      LowerRatio: []
      UpperRatio: []
    MinNumAssets: []
    MaxNumAssets: []
       BoundType: []

Scenarios cannot be assigned directly to a PortfolioMAD object. Scenarios must always be set through either the PortfolioMAD function, the setScenarios function, or any of the scenario simulation functions.

Create a PortfolioMAD Object and Determine Efficient Portfolios

Create efficient portfolios:

load CAPMuniverse

p = PortfolioMAD('AssetList',Assets(1:12));
p = simulateNormalScenariosByData(p, Data(:,1:12), 20000 ,'missingdata',true);
p = setDefaultConstraints(p);

plotFrontier(p);

pwgt = estimateFrontier(p, 5);

pnames = cell(1,5);
for i = 1:5
	pnames{i} = sprintf('Port%d',i);
end

Blotter = dataset([{pwgt},pnames],'obsnames',p.AssetList);

disp(Blotter);

            Port1       Port2       Port3       Port4      Port5
    AAPL    0.030785    0.074603     0.11383    0.13349    0    
    AMZN           0           0           0          0    0    
    CSCO           0           0           0          0    0    
    DELL    0.010139           0           0          0    0    
    EBAY           0           0           0          0    0    
    GOOG      0.1607     0.35186     0.54435    0.74908    1    
    HPQ     0.056834    0.024903           0          0    0    
    IBM      0.45716     0.38008     0.29373    0.11743    0    
    INTC           0           0           0          0    0    
    MSFT     0.28438     0.16855    0.048097          0    0    
    ORCL           0           0           0          0    0    
    YHOO           0           0           0          0    0    

More About

Mean-Absolute Deviation Portfolio Optimization

A MAD optimization problem is completely specified with three elements.

The three elements for a A MAD optimization problem are:

• A universe of assets with scenarios of asset total returns for a period of interest, where scenarios comprise a collection of samples from the underlying probability distribution for asset total returns. This collection must be sufficiently large for asymptotic convergence of sample statistics. Asset return moments and related statistics are derived exclusively from the scenarios.

• A portfolio set that specifies the set of portfolio choices in terms of a collection of constraints.

• A model for portfolio return and risk proxies, which, for MAD optimization, is either the gross or net mean of portfolio returns and the mean-absolute deviation of portfolio returns.

After these three elements have been specified unambiguously, it is possible to solve and analyze MAD portfolio optimization problems.

The simplest MAD portfolio optimization problem has:

• Scenarios of asset total returns

• A requirement that all portfolios have nonnegative weights that sum to 1 (the summation constraint is known as a budget constraint)

• Built-in models for portfolio return and risk proxies that use scenarios of asset total returns

Given scenarios of asset returns in the variable AssetScenarios, this problem is completely specified by:

p = PortfolioMAD('Scenarios', AssetScenarios, 'LowerBound', 0, 'Budget', 1);

or equivalently by:

p = PortfolioMAD;
p = setScenarios(p, AssetScenarios);
p = setDefaultConstraints(p);

To confirm that this is a valid portfolio optimization problem, the following function determines whether the set of PortfolioMAD choices is bounded (a necessary condition for portfolio optimization).

[lb, ub, isbounded] = estimateBounds(p);

Given the problem specified in the PortfolioMAD object p, the efficient frontier for this problem can be displayed with:

plotFrontier(p);

and efficient portfolios can be obtained with:

pwgt = estimateFrontier(p);

For more detailed information on the theoretical basis for mean-absolute deviation optimization, see Portfolio Optimization Theory.

PortfolioMAD Problem Sufficiency

A MAD portfolio optimization problem is completely specified with the PortfolioMAD object if three conditions are met.

The following are the three conditions that must be met:

• You must specify a collection of asset returns or prices known as scenarios such that all scenarios are finite asset returns or prices. These scenarios are meant to be samples from the underlying probability distribution of asset returns. This condition can be satisfied by the setScenarios function or with several canned scenario simulation functions.

• The set of feasible portfolios must be a nonempty compact set, where a compact set is closed and bounded. You can satisfy this condition using an extensive collection of properties that define different types of constraints to form a set of feasible portfolios. Since such sets must be bounded, either explicit or implicit constraints can be imposed and several tools, such as the estimateBounds function, provide ways to ensure that your problem is properly formulated.

  Although the general sufficient conditions for MAD portfolio optimization go beyond these conditions, the PortfolioMAD object handles all these additional conditions.

Shortcuts for Property Names

The PortfolioMAD object has shorter argument names that replace longer argument names associated with specific properties of the PortfolioMAD object.

For example, rather than enter 'AInequality', PortfolioMAD accepts the case-insensitive name 'ai' to set the AInequality property in a PortfolioMAD object. Every shorter argument name corresponds with a single property in the PortfolioMAD function. The one exception is the alternative argument name 'budget', which signifies both the LowerBudget and UpperBudget properties. When 'budget' is used, then the LowerBudget and UpperBudget properties are set to the same value to form an equality budget constraint.

Shortcuts for Property Names

Shortcut Argument Name	Equivalent Argument / Property Name
ae	AEquality
ai	AInequality
assetnames or assets	AssetList
be	bEquality
bi	bInequality
budget	UpperBudget and LowerBudget
group	GroupMatrix
lb	LowerBound
n or num	NumAssets
rfr	RiskFreeRate
scenario or assetscenarios	Scenarios
ub	UpperBound

References

[1] For a complete list of references for the PortfolioMAD object, see Portfolio Optimization.

Version History

Introduced in R2013b