net.finmath.montecarlo

Class BrownianBridge

java.lang.Object

net.finmath.montecarlo.BrownianBridge

All Implemented Interfaces:

BrownianMotionInterface

public class BrownianBridge
extends Object
implements BrownianMotionInterface

This class implements a Brownian bridge, i.e., samples of realizations of a Brownian motion conditional to a given start and end value.

A Brownian bridge is a conditional Brownian motion, i.e. for given random variables X and Y the Brownian bridge is
(W(t) | W(s) = X , W(T) = Y),
where W is a Brownian motion and s ≤ t ≤ T.

The samples of the Brownian bridge are generated by a Brownian motion which will be used to fill the gap between start and end. It is important that this Browninan motion is independent from the one which generated start and end, i.e. here: it should have a different seed.

The class implements the BrownianMotionInterface, i.e., it only provides the increments of the Brownian bridge (however, in most application, like refinement of an Euler-scheme, this is exactly the desired object).

Note: The number of paths needs to be specified, because the start and the end point may be not stochastic, i.e. it is not possible to infer this quantity from the specified start and end.

Author:

Christian Fries

Date:

24.11.2013

Constructor Summary

Constructors

Constructor and Description
BrownianBridge(TimeDiscretizationInterface timeDiscretization, int numberOfPaths, int seed, RandomVariableInterface[] start, RandomVariableInterface[] end) Construct a Brownian bridge, bridging from a given start to a given end.
BrownianBridge(TimeDiscretizationInterface timeDiscretization, int numberOfPaths, int seed, RandomVariableInterface start, RandomVariableInterface end) Construct a Brownian bridge, bridging from a given start to a given end.

Method Summary

Modifier and Type	Method and Description
RandomVariableInterface	getBrownianIncrement(int timeIndex, int factor) Return the Brownian increment for a given timeIndex.
BrownianMotionInterface	getCloneWithModifiedSeed(int seed) Return a new object implementing BrownianMotionInterface having the same specifications as this object but a different seed for the random number generator.
BrownianMotionInterface	getCloneWithModifiedTimeDiscretization(TimeDiscretizationInterface newTimeDiscretization) Return a new object implementing BrownianMotionInterface having the same specifications as this object but a different time discretization.
int	getNumberOfFactors() Returns the number of factors.
int	getNumberOfPaths() Returns the number of paths.
RandomVariableInterface	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 this BrownianMotionInterface.
TimeDiscretizationInterface	getTimeDiscretization() Returns the time discretization used for this set of time-discrete Brownian increments.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BrownianBridge

public BrownianBridge(TimeDiscretizationInterface timeDiscretization,
                      int numberOfPaths,
                      int seed,
                      RandomVariableInterface[] start,
                      RandomVariableInterface[] end)

Construct a Brownian bridge, bridging from a given start to a given end.

Parameters:

timeDiscretization - The time discretization used for the Brownian increments.

numberOfPaths - Number of paths to simulate.

seed - The seed of the random number generator.

start - Start value of the Brownian bridge.

end - End value of the Brownian bridge.

BrownianBridge

public BrownianBridge(TimeDiscretizationInterface timeDiscretization,
                      int numberOfPaths,
                      int seed,
                      RandomVariableInterface start,
                      RandomVariableInterface end)

Construct a Brownian bridge, bridging from a given start to a given end.

Parameters:

timeDiscretization - The time discretization used for the Brownian increments.

numberOfPaths - Number of paths to simulate.

seed - The seed of the random number generator.

start - Start value of the Brownian bridge.

end - End value of the Brownian bridge.

Method Detail

getBrownianIncrement

public RandomVariableInterface getBrownianIncrement(int timeIndex,
                                                    int factor)

Description copied from interface: BrownianMotionInterface

Return the Brownian increment for a given timeIndex. The method returns the random variable Δ W_j(t_i) := W_j(t_i+1)-W(t_i) for the given time index i and a given factor (index) j

Specified by:

getBrownianIncrement in interface BrownianMotionInterface

Parameters:

timeIndex - The time index (corresponding to the this class's time discretization).

factor - The index of the factor (independent scalar Brownian increment).

Returns:

The factor (component) of the Brownian increments (a random variable).

getTimeDiscretization

public TimeDiscretizationInterface getTimeDiscretization()

Description copied from interface: BrownianMotionInterface

Returns the time discretization used for this set of time-discrete Brownian increments.

Specified by:

getTimeDiscretization in interface BrownianMotionInterface

Returns:

The time discretization used for this set of time-discrete Brownian increments.

getNumberOfFactors

public int getNumberOfFactors()

Description copied from interface: BrownianMotionInterface

Returns the number of factors.

Specified by:

getNumberOfFactors in interface BrownianMotionInterface

Returns:

The number of factors.

getNumberOfPaths

public int getNumberOfPaths()

Description copied from interface: BrownianMotionInterface

Returns the number of paths.

Specified by:

getNumberOfPaths in interface BrownianMotionInterface

Returns:

The number of paths.

getRandomVariableForConstant

public RandomVariableInterface getRandomVariableForConstant(double value)

Description copied from interface: BrownianMotionInterface

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 this BrownianMotionInterface.

Specified by:

getRandomVariableForConstant in interface BrownianMotionInterface

Parameters:

value - The constant value to be used for initialized the random variable.

Returns:

A new random variable.

getCloneWithModifiedSeed

public BrownianMotionInterface getCloneWithModifiedSeed(int seed)

Description copied from interface: BrownianMotionInterface

Return a new object implementing BrownianMotionInterface having the same specifications as this object but a different seed for the random number generator. This method is useful if you like to make Monte-Carlo samplings by changing the seed.

Specified by:

getCloneWithModifiedSeed in interface BrownianMotionInterface

Parameters:

seed - New value for the seed.

Returns:

New object implementing BrownianMotionInterface.

getCloneWithModifiedTimeDiscretization

public BrownianMotionInterface getCloneWithModifiedTimeDiscretization(TimeDiscretizationInterface newTimeDiscretization)

Description copied from interface: BrownianMotionInterface

Return a new object implementing BrownianMotionInterface having the same specifications as this object but a different time discretization.

Specified by:

getCloneWithModifiedTimeDiscretization in interface BrownianMotionInterface

Parameters:

newTimeDiscretization - New time discretization

Returns:

New object implementing BrownianMotionInterface.

toString

public String toString()

Overrides:

toString in class Object