g05 Chapter Contents
g05 Chapter Introduction
NAG Library Manual

# NAG Library Function Documentnag_rand_bb_make_bridge_order (g05xec)

## 1  Purpose

nag_rand_bb_make_bridge_order (g05xec) takes a set of input times and permutes them to specify one of several predefined Brownian bridge construction orders. The permuted times can be passed to nag_rand_bb_init (g05xac) or nag_rand_bb_inc_init (g05xcc) to initialize the Brownian bridge generators with the chosen bridge construction order.

## 2  Specification

 #include #include
 void nag_rand_bb_make_bridge_order (Nag_BridgeOrder bgord, double t0, double tend, Integer ntimes, const double intime[], Integer nmove, const Integer move[], double times[], NagError *fail)

## 3  Description

The Brownian bridge algorithm (see Glasserman (2004)) is a popular method for constructing a Wiener process at a set of discrete times, ${t}_{0}<{t}_{1}<{t}_{2}<,\dots ,<{t}_{N}, for $N\ge 1$. To ease notation we assume that $T$ has the index $N+1$ so that $T={t}_{N+1}$. Inherent in the algorithm is the notion of a bridge construction order which specifies the order in which the $N+2$ points of the Wiener process, ${X}_{{t}_{0}},{X}_{T}$ and ${X}_{{t}_{i}}$, for $\mathit{i}=1,2,\dots ,N$, are generated. The value of ${X}_{{t}_{0}}$ is always assumed known, and the first point to be generated is always the final time ${X}_{T}$. Thereafter, successive points are generated iteratively by an interpolation formula, using points which were computed at previous iterations. In many cases the bridge construction order is not important, since any construction order will yield a correct process. However, in certain cases, for example when using quasi-random variates to construct the sample paths, the bridge construction order can be important.

### 3.1  Supported Bridge Construction Orders

nag_rand_bb_make_bridge_order (g05xec) accepts as input an array of time points ${t}_{1},{t}_{2},\dots ,{t}_{N},T$ at which the Wiener process is to be sampled. These time points are then permuted to construct the bridge. In all of the supported construction orders the first construction point is $T$ which has index $N+1$. The remaining points are constructed by iteratively bisecting (sub-intervals of) the time indices interval $\left[0,N+1\right]$, as Figure 1 illustrates:
Figure 1
The time indices interval is processed in levels ${L}^{\mathit{i}}$, for $\mathit{i}=1,2,\dots$. Each level ${L}^{i}$ contains ${n}_{i}$ points ${L}_{1}^{i},\dots ,{L}_{{n}_{i}}^{i}$ where ${n}_{i}\le {2}^{i-1}$. The number of points at each level depends on the value of $N$. The points ${L}_{j}^{i}$ for $i\ge 1$ and $j=1,2,\dots {n}_{i}$ are computed as follows: define ${L}_{0}^{0}=N+1$ and set
 $Lji = J+ K-J/2 where J= max Lkp : 1≤k≤np , ​ 0≤p Lji$
By convention the maximum of the empty set is taken to be to be zero. Figure 1 illustrates the algorithm when $N+1$ is a power of two. When $N+1$ is not a power of two, one must decide how to round the divisions by $2$. For example, if one rounds down to the nearest integer, then one could get the following:
Figure 2
From the series of bisections outlined above, two ways of ordering the time indices ${L}_{j}^{i}$ are supported. In both cases, levels are always processed from coarsest to finest (i.e., increasing $i$). Within a level, the time indices can either be processed left to right (i.e., increasing $j$) or right to left (i.e., decreasing $j$). For example, when processing left to right, the sequence of time indices could be generated as:
 $N+1 L11 L12 L22 L13 L23 L33 L43 ⋯$
while when processing right to left, the same sequence would be generated as:
 $N+1 L11 L22 L12 L43 L33 L23 L13 ⋯$
nag_rand_bb_make_bridge_order (g05xec) therefore offers four bridge construction methods; processing either left to right or right to left, with rounding either up or down. Which method is used is controlled by the bgord argument. For example, on the set of times
 $t1 t2 t3 t4 t5 t6 t7 t8 t9 t10 t11 t12 T$
the Brownian bridge would be constructed in the following orders:
${\mathbf{bgord}}=\mathrm{Nag_LRRoundDown}$ (processing left to right, rounding down)
 $T t6 t3 t9 t1 t4 t7 t11 t2 t5 t8 t10 t12$
${\mathbf{bgord}}=\mathrm{Nag_LRRoundUp}$ (processing left to right, rounding up)
 $T t7 t4 t10 t2 t6 t9 t12 t1 t3 t5 t8 t11$
${\mathbf{bgord}}=\mathrm{Nag_RLRoundDown}$ (processing right to left, rounding down)
 $T t6 t9 t3 t11 t7 t4 t1 t12 t10 t8 t5 t2$
${\mathbf{bgord}}=\mathrm{Nag_RLRoundUp}$ (processing right to left, rounding up)
 $T t7 t10 t4 t12 t9 t6 t2 t11 t8 t5 t3 t1 .$
The four construction methods described above can be further modified through the use of the input array move. To see the effect of this argument, suppose that an array $A$ holds the output of nag_rand_bb_make_bridge_order (g05xec) when ${\mathbf{nmove}}=0$ (i.e., the bridge construction order as specified by bgord only). Let
 $B = tj : j=move[i-1], i=1,2,…,nmove$
be the array of all times identified by move, and let $C$ be the array $A$ with all the elements in $B$ removed, i.e.,
 $C = Ai : Ai ≠ Bj , i=1,2,…,ntimes , j=1,2,…,nmove .$
Then the output of nag_rand_bb_make_bridge_order (g05xec) when ${\mathbf{nmove}}>0$ is given by
 $B1 B2 ⋯ Bnmove C1 C2 ⋯ Cntimes-nmove$
When the Brownian bridge is used with quasi-random variates, this functionality can be used to allow specific sections of the bridge to be constructed using the lowest dimensions of the quasi-random points.

## 4  References

Glasserman P (2004) Monte Carlo Methods in Financial Engineering Springer

## 5  Arguments

1:    $\mathbf{bgord}$Nag_BridgeOrderInput
On entry: the bridge construction order to use.
Constraint: ${\mathbf{bgord}}=\mathrm{Nag_LRRoundDown}$, $\mathrm{Nag_LRRoundUp}$, $\mathrm{Nag_RLRoundDown}$ or $\mathrm{Nag_RLRoundUp}$.
2:    $\mathbf{t0}$doubleInput
On entry: ${t}_{0}$, the start value of the time interval on which the Wiener process is to be constructed.
3:    $\mathbf{tend}$doubleInput
On entry: $T$, the largest time at which the Wiener process is to be constructed.
4:    $\mathbf{ntimes}$IntegerInput
On entry: $N$, the number of time points in the Wiener process, excluding ${t}_{0}$ and $T$.
Constraint: ${\mathbf{ntimes}}\ge 1$.
5:    $\mathbf{intime}\left[{\mathbf{ntimes}}\right]$const doubleInput
On entry: the time points, ${t}_{1},{t}_{2},\dots ,{t}_{N}$, at which the Wiener process is to be constructed. Note that the final time $T$ is not included in this array.
Constraints:
• ${\mathbf{t0}}<{\mathbf{intime}}\left[\mathit{i}-1\right]$ and ${\mathbf{intime}}\left[\mathit{i}-1\right]<{\mathbf{intime}}\left[\mathit{i}\right]$, for $\mathit{i}=1,2,\dots ,{\mathbf{ntimes}}-1$;
• ${\mathbf{intime}}\left[{\mathbf{ntimes}}-1\right]<{\mathbf{tend}}$.
6:    $\mathbf{nmove}$IntegerInput
On entry: the number of elements in the array move.
Constraint: $0\le {\mathbf{nmove}}\le {\mathbf{ntimes}}$.
7:    $\mathbf{move}\left[{\mathbf{nmove}}\right]$const IntegerInput
On entry: the indices of the entries in intime which should be moved to the front of the times array, with ${\mathbf{move}}\left[j-1\right]=i$ setting the $j$th element of times to ${t}_{i}$. Note that $i$ ranges from $1$ to ntimes. When ${\mathbf{nmove}}=0$, move is not referenced.
Constraint: $1\le {\mathbf{move}}\left[\mathit{j}-1\right]\le {\mathbf{ntimes}}$, for $\mathit{j}=1,2,\dots ,{\mathbf{nmove}}$.
The elements of move must be unique.
8:    $\mathbf{times}\left[{\mathbf{ntimes}}\right]$doubleOutput
On exit: the output bridge construction order. This should be passed to nag_rand_bb_init (g05xac) or nag_rand_bb_inc_init (g05xcc).
9:    $\mathbf{fail}$NagError *Input/Output
The NAG error argument (see Section 3.6 in the Essential Introduction).

## 6  Error Indicators and Warnings

NE_ALLOC_FAIL
Dynamic memory allocation failed.
See Section 3.2.1.2 in the Essential Introduction for further information.
On entry, argument $〈\mathit{\text{value}}〉$ had an illegal value.
NE_INT
On entry, ${\mathbf{nmove}}=〈\mathit{\text{value}}〉$ and ${\mathbf{ntimes}}=〈\mathit{\text{value}}〉$.
Constraint: $0\le {\mathbf{nmove}}\le {\mathbf{ntimes}}$.
On entry, ${\mathbf{ntimes}}=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{ntimes}}\ge 1$.
NE_INT_ARRAY
On entry, ${\mathbf{move}}\left[〈\mathit{\text{value}}〉\right]=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{move}}\left[i\right]\ge 1$ for all $i$.
On entry, ${\mathbf{move}}\left[〈\mathit{\text{value}}〉\right]=〈\mathit{\text{value}}〉$ and ${\mathbf{ntimes}}=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{move}}\left[i\right]\le {\mathbf{ntimes}}$ for all $i$.
On entry, ${\mathbf{move}}\left[〈\mathit{\text{value}}〉\right]$ and ${\mathbf{move}}\left[〈\mathit{\text{value}}〉\right]$ both equal $〈\mathit{\text{value}}〉$.
Constraint: all elements in move must be unique.
NE_INTERNAL_ERROR
An internal error has occurred in this function. Check the function call and any array sizes. If the call is correct then please contact NAG for assistance.
An unexpected error has been triggered by this function. Please contact NAG.
See Section 3.6.6 in the Essential Introduction for further information.
NE_NO_LICENCE
Your licence key may have expired or may not have been installed correctly.
See Section 3.6.5 in the Essential Introduction for further information.
NE_NOT_STRICTLY_INCREASING
On entry, ${\mathbf{intime}}\left[〈\mathit{\text{value}}〉\right]=〈\mathit{\text{value}}〉$ and ${\mathbf{intime}}\left[〈\mathit{\text{value}}〉\right]=〈\mathit{\text{value}}〉$.
Constraint: the elements in intime must be in increasing order.
NE_REAL_2
On entry, ${\mathbf{intime}}\left[0\right]=〈\mathit{\text{value}}〉$ and ${\mathbf{t0}}=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{intime}}\left[0\right]>{\mathbf{t0}}$.
On entry, ${\mathbf{ntimes}}=〈\mathit{\text{value}}〉$, ${\mathbf{intime}}\left[{\mathbf{ntimes}}-1\right]=〈\mathit{\text{value}}〉$ and ${\mathbf{tend}}=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{intime}}\left[{\mathbf{ntimes}}-1\right]<{\mathbf{tend}}$.

Not applicable.

## 8  Parallelism and Performance

nag_rand_bb_make_bridge_order (g05xec) is threaded by NAG for parallel execution in multithreaded implementations of the NAG Library.
Please consult the X06 Chapter Introduction for information on how to control and interrogate the OpenMP environment used within this function. Please also consult the Users' Note for your implementation for any additional implementation-specific information.

None.

## 10  Example

This example calls nag_rand_bb_make_bridge_order (g05xec), nag_rand_bb_init (g05xac) and nag_rand_bb (g05xbc) to generate two sample paths of a three-dimensional free Wiener process. The array move is used to ensure that a certain part of the sample path is always constructed using the lowest dimensions of the input quasi-random points. For further details on using quasi-random points with the Brownian bridge algorithm, please see Section 2.6 in the g05 Chapter Introduction.

### 10.1  Program Text

Program Text (g05xece.c)

None.

### 10.3  Program Results

Program Results (g05xece.r)