Main Content

Graphical Representation of Trees

Introduction

You can use the function treeviewer to display a graphical representation of a tree, allowing you to examine interactively the prices and rates on the nodes of the tree until maturity. To get started with this process, first load the data file deriv.mat included in this toolbox.

load deriv.mat

Note

treeviewer price tree diagrams follow the convention that increasing prices appear on the upper branch of a tree and, consequently, decreasing prices appear on the lower branch. Conversely, for interest rate displays, decreasing interest rates appear on the upper branch (prices are rising) and increasing interest rates on the lower branch (prices are falling).

For information on the use of treeviewer to observe interest rate movement, see Observing Interest Rates. For information on using treeviewer to observe the movement of prices, see Observing Instrument Prices.

Observing Interest Rates

If you provide the name of an interest rate tree to the treeviewer function, it displays a graphical view of the path of interest rates. For example, here is the treeviewer representation of all the rates along both the up and down branches of HJMTree.

treeviewer(HJMTree)

Figure contains treeviewer user interface to display an HJM tree.

The example in Examining Trees used bushpath to find the path of forward rates along an HJM tree by taking the first branch up and then two branches down the rate tree.

FRates = bushpath(HJMTree.FwdTree, [1 2 2])
FRates =

    1.0356
    1.0364
    1.0526
    1.0674

With the treeviewer function you can display the identical information by clicking along the same sequence of nodes, as shown next.

Figure contains treeviewer user interface to display a sequence of nodes in an HJM tree.

Next is a treeviewer representation of interest rates along several branches of BDTTree.

treeviewer(BDTTree)

Figure contains treeviewer user interface to display interest rates for several branches in a BDT tree.

Note

When using treeviewer with recombining trees, such as BDT, BK, and HW, you must click each node in succession from the beginning to the end. Because these trees can recombine, treeviewer is unable to complete the path automatically.

The example in Examining Trees used treepath to find the path of interest rates taking the first branch up and then two branches down the rate tree.

FRates = treepath(BDTTree.FwdTree, [1 2 2])
FRates =

    1.1000
    1.0979
    1.1377
    1.1606

You can display the identical information by clicking along the same sequence of nodes, as shown next.

Figure contains treeviewer user interface to display a sequence of nodes in a BDT tree.

Observing Instrument Prices

To use treeviewer to display a tree of instrument prices, provide the name of an instrument set along with the name of a price tree in your call to treeviewer, for example:

load deriv.mat
[Price, PriceTree] = hjmprice(HJMTree, HJMInstSet);
treeviewer(PriceTree, HJMInstSet)

With treeviewer you select each instrument individually in the instrument portfolio for display.

Figure contains treeviewer user interface to display prices for a specific instrument in an HJM tree.

You can use an analogous process to view instrument prices based on the BDT interest rate tree included in deriv.mat.

load deriv.mat
[BDTPrice, BDTPriceTree] = bdtprice(BDTTree, BDTInstSet);
treeviewer(BDTPriceTree, BDTInstSet)

Figure contains treeviewer user interface to display prices for a specific instrument in a BDT tree.

Valuation Date Prices

You can use treeviewer instrument-by-instrument to observe instrument prices through time. For the first 4% bond in the HJM instrument portfolio, treeviewer indicates a valuation date price of 98.72, the same value obtained by accessing the PriceTree structure directly.

Figure contains treeviewer user interface to display prices through time for a specific instrument in an HJM tree.

As a further example, look at the sixth instrument in the price vector, the 3% cap. At the valuation date, its value obtained directly from the structure is 6.2831. Use treeviewer on this instrument to confirm this price.

Figure contains treeviewer user interface to display prices through time for the sixth instrument in an HJM tree.

Additional Observation Times

The second node represents the first-rate observation time, tObs = 1. This node displays two states, one representing the branch going up and the other one representing the branch going down.

Examine the prices of the node corresponding to the up branch.

PriceTree.PBush{2}(:,:,1)
ans =

  100.1563
   99.7309
    0.1007
  100.1563
  100.3782
    3.2594
    0.1007
    3.5597

As before, you can use treeviewer, this time to examine the price for the 4% bond on the up branch. treeviewer displays a price of 100.2 for the first node of the up branch, as expected.

Figure contains treeviewer user interface to display prices through time for a 4% bond instrument in an HJM tree.

Now examine the corresponding down branch.

PriceTree.PBush{2}(:,:,2)
ans =

   96.3041
   94.1986
         0
   96.3041
  100.3671
    8.6342
         0
   -0.3923

Use treeviewer once again, now to observe the price of the 4% bond on the down branch. The displayed price of 96.3 conforms to the price obtained from direct access of the PriceTree structure. You may continue this process as far along the price tree as you want.

Figure contains treeviewer user interface to display prices through time for a 4% bond instrument in an HJM tree.

See Also

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Topics