Module net.finmath.lib
Class MonteCarloMertonModel
java.lang.Object
net.finmath.montecarlo.assetderivativevaluation.MonteCarloMertonModel
- All Implemented Interfaces:
Model,AssetModelMonteCarloSimulationModel,MonteCarloSimulationModel
This class glues together a
MertonModel and a Monte-Carlo implementation of a MonteCarloProcessFromProcessModel, namely EulerSchemeFromProcessModel,
and forms a Monte-Carlo implementation of the Merton model by implementing AssetModelMonteCarloSimulationModel.
The model is
\[
dS = \mu S dt + \sigma S dW + S dJ, \quad S(0) = S_{0},
\]
\[
dN = r N dt, \quad N(0) = N_{0},
\]
where \( W \) is Brownian motion and \( J \) is a jump process (compound Poisson process).
The process \( J \) is given by \( J(t) = \sum_{i=1}^{N(t)} (Y_{i}-1) \), where
\( \log(Y_{i}) \) are i.i.d. normals with mean \( a - \frac{1}{2} b^{2} \) and standard deviation \( b \).
Here \( a \) is the jump size mean and \( b \) is the jump size std. dev.
For details on the construction of the model see MertonModel.- Version:
- 1.0
- Author:
- Christian Fries
- See Also:
MertonModel,The interface for numerical schemes.,The interface for models provinding parameters to numerical schemes.
-
Constructor Summary
ConstructorsConstructorDescriptionMonteCarloMertonModel(TimeDiscretization timeDiscretization, int numberOfPaths, int seed, double initialValue, double riskFreeRate, double volatility, double jumpIntensity, double jumpSizeMean, double jumpSizeStDev)Create a Monte-Carlo simulation using given time discretization and given parameters.MonteCarloMertonModel(TimeDiscretization timeDiscretization, int numberOfPaths, int seed, double initialValue, double riskFreeRate, double volatility, double jumpIntensity, double jumpSizeMean, double jumpSizeStDev, RandomVariableFactory randomVariableFactory)Create a Monte-Carlo simulation using given time discretization and given parameters. -
Method Summary
Modifier and TypeMethodDescriptiongetAssetValue(double time, int assetIndex)Returns the random variable representing the asset's value at a given time for a given asset.getAssetValue(int timeIndex, int assetIndex)Returns the random variable representing the asset's value at a given time for a given asset.getCloneWithModifiedData(Map<String,Object> dataModified)Create a clone of this simulation modifying some of its properties (if any).getCloneWithModifiedSeed(int seed)Create a clone of the object implementingAssetModelMonteCarloSimulationModelusing a different Monte-Carlo seed.getMonteCarloWeights(double time)This method returns the weights of a weighted Monte Carlo method (the probability density).getMonteCarloWeights(int timeIndex)This method returns the weights of a weighted Monte Carlo method (the probability density).intReturns the number of asset price processes.intReturns the numberOfPaths.getNumeraire(double time)Returns the numeraire associated with the valuation measure used by this model.getNumeraire(int timeIndex)Returns the numeraire associated with the valuation measure used by this model.getRandomVariableForConstant(double value)Returns a random variable which is initialized to a constant, but has exactly the same number of paths or discretization points as the ones used by thisMonteCarloSimulationModel.Returns the model's date corresponding to the time discretization's \( t = 0 \).doublegetTime(int timeIndex)Returns the time for a given time index.Returns the timeDiscretizationFromArray.intgetTimeIndex(double time)Returns the time index for a given time.
-
Constructor Details
-
MonteCarloMertonModel
public MonteCarloMertonModel(TimeDiscretization timeDiscretization, int numberOfPaths, int seed, double initialValue, double riskFreeRate, double volatility, double jumpIntensity, double jumpSizeMean, double jumpSizeStDev, RandomVariableFactory randomVariableFactory)Create a Monte-Carlo simulation using given time discretization and given parameters.- Parameters:
timeDiscretization- The time discretization.numberOfPaths- The number of Monte-Carlo path to be used.seed- The seed used for the random number generator.initialValue- Spot value.riskFreeRate- The risk free rate.volatility- The log volatility.jumpIntensity- The intensity parameter lambda of the compound Poisson process.jumpSizeMean- The mean jump size of the normal distributes jump sizes of the compound Poisson process.jumpSizeStDev- The standard deviation of the normal distributes jump sizes of the compound Poisson process.randomVariableFactory- The factory to be used to construct random variables.
-
MonteCarloMertonModel
public MonteCarloMertonModel(TimeDiscretization timeDiscretization, int numberOfPaths, int seed, double initialValue, double riskFreeRate, double volatility, double jumpIntensity, double jumpSizeMean, double jumpSizeStDev)Create a Monte-Carlo simulation using given time discretization and given parameters.- Parameters:
timeDiscretization- The time discretization.numberOfPaths- The number of Monte-Carlo path to be used.seed- The seed used for the random number generator.initialValue- Spot value.riskFreeRate- The risk free rate.volatility- The log volatility.jumpIntensity- The intensity parameter lambda of the compound Poisson process.jumpSizeMean- The mean jump size of the normal distributes jump sizes of the compound Poisson process.jumpSizeStDev- The standard deviation of the normal distributes jump sizes of the compound Poisson process.
-
-
Method Details
-
getReferenceDate
Description copied from interface:MonteCarloSimulationModelReturns the model's date corresponding to the time discretization's \( t = 0 \).- Specified by:
getReferenceDatein interfaceMonteCarloSimulationModel- Returns:
- The model's date corresponding to the time discretization's \( t = 0 \).
-
getAssetValue
Description copied from interface:AssetModelMonteCarloSimulationModelReturns the random variable representing the asset's value at a given time for a given asset.- Specified by:
getAssetValuein interfaceAssetModelMonteCarloSimulationModel- Parameters:
time- Simulation timeassetIndex- Index of the asset (0 for a single asset model)- Returns:
- The asset process as seen on simulation time
- Throws:
CalculationException- Thrown if the valuation fails, specific cause may be available via thecause()method.
-
getAssetValue
Description copied from interface:AssetModelMonteCarloSimulationModelReturns the random variable representing the asset's value at a given time for a given asset.- Specified by:
getAssetValuein interfaceAssetModelMonteCarloSimulationModel- Parameters:
timeIndex- Index of simulation timeassetIndex- Index of the asset (0 for a single asset model)- Returns:
- The asset process as seen on simulation time
- Throws:
CalculationException- Thrown if the valuation fails, specific cause may be available via thecause()method.
-
getNumeraire
Description copied from interface:AssetModelMonteCarloSimulationModelReturns the numeraire associated with the valuation measure used by this model.- Specified by:
getNumerairein interfaceAssetModelMonteCarloSimulationModel- Parameters:
timeIndex- The time index (associated with this models time discretization).- Returns:
- The numeraire associated with the valuation measure used by this model.
- Throws:
CalculationException- Thrown if calculation of numeraire fails.
-
getNumeraire
Description copied from interface:AssetModelMonteCarloSimulationModelReturns the numeraire associated with the valuation measure used by this model.- Specified by:
getNumerairein interfaceAssetModelMonteCarloSimulationModel- Parameters:
time- The time for which the numeraire is requested.- Returns:
- The numeraire associated with the valuation measure used by this model.
- Throws:
CalculationException- Thrown if calculation of numeraire fails.
-
getMonteCarloWeights
Description copied from interface:MonteCarloSimulationModelThis method returns the weights of a weighted Monte Carlo method (the probability density).- Specified by:
getMonteCarloWeightsin interfaceMonteCarloSimulationModel- Parameters:
time- Time at which the process should be observed- Returns:
- A vector of positive weights which sums up to one
- Throws:
CalculationException- Thrown if the valuation fails, specific cause may be available via thecause()method.
-
getNumberOfAssets
public int getNumberOfAssets()Description copied from interface:AssetModelMonteCarloSimulationModelReturns the number of asset price processes.- Specified by:
getNumberOfAssetsin interfaceAssetModelMonteCarloSimulationModel- Returns:
- The number of asset price processes
-
getCloneWithModifiedData
public AssetModelMonteCarloSimulationModel getCloneWithModifiedData(Map<String,Object> dataModified)Description copied from interface:AssetModelMonteCarloSimulationModelCreate a clone of this simulation modifying some of its properties (if any).- Specified by:
getCloneWithModifiedDatain interfaceAssetModelMonteCarloSimulationModel- Specified by:
getCloneWithModifiedDatain interfaceMonteCarloSimulationModel- Parameters:
dataModified- The data which should be changed in the new model- Returns:
- Returns a clone of this model, with some data modified (then it is no longer a clone :-)
-
getCloneWithModifiedSeed
Description copied from interface:AssetModelMonteCarloSimulationModelCreate a clone of the object implementingAssetModelMonteCarloSimulationModelusing a different Monte-Carlo seed.- Specified by:
getCloneWithModifiedSeedin interfaceAssetModelMonteCarloSimulationModel- Parameters:
seed- The seed of the underlying random number generator.- Returns:
- Returns a clone of this model except for a modified Monte-Carlo seed.
-
getNumberOfPaths
public int getNumberOfPaths()Description copied from interface:MonteCarloSimulationModelReturns the numberOfPaths.- Specified by:
getNumberOfPathsin interfaceMonteCarloSimulationModel- Returns:
- Returns the numberOfPaths.
-
getTimeDiscretization
Description copied from interface:MonteCarloSimulationModelReturns the timeDiscretizationFromArray.- Specified by:
getTimeDiscretizationin interfaceMonteCarloSimulationModel- Returns:
- Returns the timeDiscretizationFromArray.
-
getTime
public double getTime(int timeIndex)Description copied from interface:MonteCarloSimulationModelReturns the time for a given time index.- Specified by:
getTimein interfaceMonteCarloSimulationModel- Parameters:
timeIndex- Time index- Returns:
- Returns the time for a given time index.
-
getTimeIndex
public int getTimeIndex(double time)Description copied from interface:MonteCarloSimulationModelReturns the time index for a given time.- Specified by:
getTimeIndexin interfaceMonteCarloSimulationModel- Parameters:
time- The time.- Returns:
- Returns the time index for a given time.
-
getRandomVariableForConstant
Description copied from interface:MonteCarloSimulationModelReturns a random variable which is initialized to a constant, but has exactly the same number of paths or discretization points as the ones used by thisMonteCarloSimulationModel.- Specified by:
getRandomVariableForConstantin interfaceMonteCarloSimulationModel- Parameters:
value- The constant value to be used for initialized the random variable.- Returns:
- A new random variable.
-
getMonteCarloWeights
Description copied from interface:MonteCarloSimulationModelThis method returns the weights of a weighted Monte Carlo method (the probability density).- Specified by:
getMonteCarloWeightsin interfaceMonteCarloSimulationModel- Parameters:
timeIndex- Time index at which the process should be observed- Returns:
- A vector of positive weights which sums up to one
- Throws:
CalculationException- Thrown if the valuation fails, specific cause may be available via thecause()method.
-