stttree

Build standard trinomial tree

Syntax

STTTree = stttree(StockSpec,RateSpec,TimeSpec)

Description

STTTree = stttree(StockSpec,RateSpec,TimeSpec) builds a standard trinomial (STT) tree.

Note

Alternatively, you can use the AssetTree object to price equity instruments. For more information, see Get Started with Workflows Using Object-Based Framework for Pricing Financial Instruments.

Examples

Build a STTTree

Create a RateSpec.

StartDates = 'Jan-1-2014'; 
EndDates = 'Jan-1-2018'; 
Rates = 0.025; 
Basis = 1; 
Compounding = -1;
RateSpec = intenvset('ValuationDate', StartDates, 'StartDates', StartDates,...
'EndDates', EndDates, 'Rates', Rates,'Compounding', Compounding, 'Basis', Basis)

RateSpec = struct with fields:
           FinObj: 'RateSpec'
      Compounding: -1
             Disc: 0.9048
            Rates: 0.0250
         EndTimes: 4
       StartTimes: 0
         EndDates: 737061
       StartDates: 735600
    ValuationDate: 735600
            Basis: 1
     EndMonthRule: 1

Create a StockSpec.

AssetPrice = 55; 
Sigma = 0.22; 
Div = 0.02; 
StockSpec = stockspec(Sigma, AssetPrice, 'continuous', Div)

StockSpec = struct with fields:
             FinObj: 'StockSpec'
              Sigma: 0.2200
         AssetPrice: 55
       DividendType: {'continuous'}
    DividendAmounts: 0.0200
    ExDividendDates: []

Create a Standard Trinomial Tree (STTTree).

NumSteps = 8;
TimeSpec = stttimespec(StartDates, EndDates, NumSteps);
STTT = stttree(StockSpec, RateSpec, TimeSpec)

STTT = struct with fields:
       FinObj: 'STStockTree'
    StockSpec: [1×1 struct]
     TimeSpec: [1×1 struct]
     RateSpec: [1×1 struct]
         tObs: [0 0.5000 1 1.5000 2 2.5000 3 3.5000 4]
         dObs: [735600 735782 735965 736147 736330 736513 736695 736878 737061]
        STree: {1×9 cell}
        Probs: {[3×1 double]  [3×3 double]  [3×5 double]  [3×7 double]  [3×9 double]  [3×11 double]  [3×13 double]  [3×15 double]}

Input Arguments

StockSpec — Stock specification for underlying asset

structure

Stock specification for underlying asset, specified using StockSpec obtained from stockspec. For information on the stock specification, see stockspec.

stockspec can handle other types of underlying assets. For example, stocks, stock indices, and commodities. If dividends are not specified in StockSpec, dividends are assumed to be 0.

Data Types: struct

RateSpec — Interest-rate term specification of initial risk-free rate curve

structure

Interest-rate term specification of initial risk-free rate curve, specified by the RateSpec obtained from intenvset. For information on the interest-rate specification, see intenvset.

Data Types: struct

TimeSpec — Tree time layout specification

structure

Tree time layout specification, specified using stttimespec to define the observation dates of the standard trinomial (STT) tree.

Data Types: struct

Output Arguments

STTTree — Tree specifying stock and time information for a standard trinomial (STT) tree

tree structure

Tree specifying stock and time information for a standard trinomial (STT) tree, returned as a tree structure.

More About

Standard Trinomial Stock Tree

The Standard Trinomial (STT) stock tree is used to price options and other derivatives by representing the potential future prices of an underlying asset over discrete time intervals.

Unlike a binomial tree, which allows for two possible outcomes (up or down) at each time step, a trinomial tree allows for three possible outcomes: an upward movement, a downward movement, and a middle (or unchanged) movement. This additional flexibility can provide a more accurate representation of price dynamics.

Version History

Introduced in R2015b