NAG Library Function Document

nag_rngs_triangular (g05lhc)

1  Purpose

2  Specification

3  Description

4  References

5  Arguments

1:     xmin – doubleInput

2:     xmax – doubleInput

On entry: the end points $x_{\min }$ and $x_{\max }$ of the uniform distribution.

Constraint: $\mathbf{xmin}\le \mathbf{xmax}$.

3:     xmed – doubleInput

On entry: the median of the distribution $x_{\mathrm{med}}$ (also the location of the vertex of the triangular distribution at which the PDF reaches a maximum).

Constraint: $\mathbf{xmin}\le \mathbf{xmed}\le \mathbf{xmax}$.

4:     n – IntegerInput

On entry: $n$, the number of pseudorandom numbers to be generated.

Constraint: $\mathbf{n}\ge 0$.

5:     x[n] – doubleOutput

On exit: the $n$ pseudorandom numbers from the specified triangular distribution.

6:     igen – IntegerInput

On entry: must contain the identification number for the generator to be used to return a pseudorandom number and should remain unchanged following initialization by a prior call to nag_rngs_init_repeatable (g05kbc) or nag_rngs_init_nonrepeatable (g05kcc).

7:     iseed[$4$] – IntegerCommunication Array

On entry: contains values which define the current state of the selected generator.

On exit: contains updated values defining the new state of the selected generator.

8:     fail – NagError *Input/Output

The NAG error argument (see Section 3.6 in the Essential Introduction).

6  Error Indicators and Warnings

NE_BAD_PARAM

On entry, argument $〈\mathit{\text{value}}〉$ had an illegal value.

NE_INT

On entry, $\mathbf{n}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{n}\ge 0$.

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.

NE_REAL_2

On entry, $\mathbf{xmed}=〈\mathit{\text{value}}〉$ and $\mathbf{xmax}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{xmed}\le \mathbf{xmax}$.

On entry, $\mathbf{xmed}=〈\mathit{\text{value}}〉$ and $\mathbf{xmin}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{xmed}\ge \mathbf{xmin}$.

On entry, $\mathbf{xmin}=〈\mathit{\text{value}}〉$ and $\mathbf{xmax}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{xmin}\le \mathbf{xmax}$.

7  Accuracy

8  Further Comments

9  Example

9.1  Program Text

Program Text (g05lhce.c)

9.2  Program Data

9.3  Program Results

Program Results (g05lhce.r)