Advice on Replacement Calls for Withdrawn/Superseded Functions : NAG Library, Mark 24

The following list gives the names of functions that are suitable replacements for functions that have either been withdrawn or superseded since Mark 23.

The list indicates the minimum change necessary, but many of the replacement functions have additional flexibility and you may wish to take advantage of new features. It is strongly recommended that you consult the function documents.

Withdrawn at Mark 24.
Replaced by nag_zero_cont_func_brent (c05ayc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zero_cont_func_brent_binsrch (c05auc).

Withdrawn at Mark 24.
Replaced by nag_zero_nonlin_eqns_easy (c05qbc).

Withdrawn at Mark 24.
Replaced by nag_zero_nonlin_eqns_deriv_easy (c05rbc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zero_cont_func_brent (c05ayc).

Note that the communication structure comm is now of type Nag_Comm (see Section 3.2.1.1 in the Essential Introduction) rather than Nag_User (see Section 3.2.1.1 in the Essential Introduction).

Withdrawn at Mark 24.
Replaced by nag_zero_nonlin_eqns_easy (c05qbc).

Note that the communication structure comm and comm is now of type Nag_Comm (see Section 3.2.1.1 in the Essential Introduction) rather than Nag_User (see Section 3.2.1.1 in the Essential Introduction).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zero_nonlin_eqns_deriv_easy (c05rbc).

Note that the communication structure comm and comm is now of type Nag_Comm (see Section 3.2.1.1 in the Essential Introduction) rather than Nag_User (see Section 3.2.1.1 in the Essential Introduction).

Withdrawn at Mark 24.
Replaced by nag_check_derivs (c05zdc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_realherm_1d (c06pac).

where the dimension of the array x has been extended from the original n to

n + 2

. The output values x are stored in a different order with real and imaginary parts stored contiguously. The mapping of output elements is as follows:

$x [2 \times i - 1] \leftarrow x [i - 1]$ , for $i = 0, 1, \dots, n / 2$ and
$x [2 \times i] \leftarrow x [n - i - 1]$ , for $i = 1, 2, \dots, (n + 1) / 2$ .

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_realherm_1d (c06pac).

where the dimension of the array x has been extended from the original n to

n + 2

. The input values of x are stored in a different order with real and imaginary parts stored contiguously. Also nag_sum_fft_realherm_1d (c06pac) performs the inverse transform without the need to first conjugate. If prior conjugation of original array x is assumed then the mapping of input elements is:

$x [2 \times i - 1] \leftarrow x [i - 1]$ , for $i = 0, 1, \dots, n / 2$ and
$x [2 \times i] \leftarrow x [n - i - 1]$ , for $i = 1, 2, \dots, (n - 1) / 2$ .

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_complex_1d (c06pcc).

where

z

is a complex array of length n such that

z [i] . re = x [i]

and

z [i] . im = y [i]

, for

i = 0, 1, \dots n - 1

on input and output.

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_convcorr_real (c06fkc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_complex_1d_multi (c06psc).

where

z

is a complex array of length

m \times n

such that

z [i] . re = x [i]

and

z [i] . im = y [i]

, for

i = 0, 1, \dots, m \times n - 1

on input and output.

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_complex_2d (c06puc).

where

z

is a complex array of length

m \times n

such that

z [i] . re = x [i]

and

z [i] . im = y [i]

, for

i = 0, 1, \dots, m \times n - 1

on input and output.

Scheduled for withdrawal at Mark 26.
There is no replacement for this function.

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_sine (c06rec).

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_cosine (c06rfc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_qtrsine (c06rgc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_sum_fft_qtrcosine (c06rhc).

Withdrawn at Mark 24.
Replaced by nag_1d_quad_gen_1 (d01sjc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_osc_1 (d01skc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_brkpts_1 (d01slc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_inf_1 (d01smc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_wt_trig_1 (d01snc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function g.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_wt_alglog_1 (d01spc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function g.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_wt_cauchy_1 (d01sqc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function g.

Withdrawn at Mark 24.
Replaced by nag_1d_quad_inf_wt_trig_1 (d01ssc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function g.

Withdrawn at Mark 24.
Replaced by nag_quad_1d_gauss_vec (d01uac).

Replace quadrule with quad_type as follows:

Nag_Legendre with Nag_Quad_Gauss_Legendre;
Nag_Rational with Nag_Quad_Gauss_Rational_Adjusted;
Nag_Laguerre with Nag_Quad_Gauss_Laguerre;
Nag_Hermite with Nag_Quad_Gauss_Hermite.

comm is a pointer to a structure of type Nag_Comm available to allow you to pass information to the user-supplied function f.

iflag is an integer which you may use to force an immediate exit from nag_quad_1d_gauss_vec (d01uac) in case of an error in the user-supplied function f.

f may be used to call the original fun as follows, although it may be more efficient to recode the integrand.

Scheduled for withdrawal at Mark 25.
Replaced by nag_multid_quad_adapt_1 (d01wcc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Scheduled for withdrawal at Mark 25.
Replaced by nag_multid_quad_monte_carlo_1 (d01xbc).

Where comm, a pointer to a structure of type Nag_User, has been added to allow you to pass information to the user-supplied function f.

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_range (d02pec) and associated d02p functions.

iwsav is an Integer array of length

130

and rwsav is a double array of length

350 + 32 \times n

.

comm2 is a pointer to a structure of type Nag_Comm available to allow you to pass information to the user defined function f2 (see f in nag_ode_ivp_rkts_range (d02pec)).

The definition of f2 (see f in nag_ode_ivp_rkts_range (d02pec)) can use the original function f as follows:

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_onestep (d02pfc) and associated d02p functions.

iwsav is an Integer array of length

130

and rwsav is a double array of length

350 + 32 \times n

.

comm2 is a pointer to a structure of type Nag_Comm available to allow you to pass information to the user defined function f2 (see f in nag_ode_ivp_rkts_range (d02pec)).

The definition of f2 (see f in nag_ode_ivp_rkts_range (d02pec)) can use the original function f as follows:

Scheduled for withdrawal at Mark 26.
There is no replacement for this function.

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_setup (d02pqc).

See nag_ode_ivp_rk_range (d02pcc) and nag_ode_ivp_rk_onestep (d02pdc) for further information.

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_reset_tend (d02prc).

iwsav is an Integer array of length

130

and rwsav is a double array of length

350

.

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_interp (d02psc).

iwsav is an Integer array of length

130

and rwsav is a double array of length

350 + 32 \times n

.

comm2 is a pointer to a structure of type Nag_Comm available to allow you to pass information to the user defined function f2 (see f in nag_ode_ivp_rkts_interp (d02psc)).

wcomm is a double array of length lwcomm. See the function document for nag_ode_ivp_rkts_interp (d02psc) for further information.

The definition of f2 (see f in nag_ode_ivp_rkts_interp (d02psc)) can use the original function f as follows:

Scheduled for withdrawal at Mark 26.
Replaced by nag_ode_ivp_rkts_errass (d02puc).

n must be unchanged from that passed to nag_ode_ivp_rkts_setup (d02pqc).

iwsav is an Integer array of length

130

and rwsav is a double array of length

350 + 32 \times n

.

Withdrawn at Mark 23.
Replaced by nag_2d_shep_interp (e01sgc) or nag_2d_triang_interp (e01sjc).

nag_2d_scat_interpolant (e01sac) generates a two-dimensional surface interpolating a set of scattered data points, using either the method of Renka and Cline or a modification of Shepard's method. The replacement functions separate these two methods.

e01sac_rk.c

provides replacement call information for the Renka and Cline method (nag_2d_shep_interp (e01sgc)) and

e01sac_shep.c

provides replacement call information for the Shepard's method (nag_2d_triang_interp (e01sjc)).

Withdrawn at Mark 23.
Replaced by nag_2d_shep_eval (e01shc) or nag_2d_triang_eval (e01skc).

See the example program

e01sac_rk.c

and

e01sac_shep.c

for full details.

Withdrawn at Mark 23.
There is no replacement for this function.

Withdrawn at Mark 24.
Replaced by nag_opt_simplex_easy (e04cbc).

The options structure has been removed from nag_opt_simplex (e04ccc). The optim_tol and max_iter members of the options structure have been introduced as the arguments tolf and maxcal, respectively. tolx is an additional argument to control tolerance. A new user defined function monit has been added to allow you to monitor the optimization process. If no monitoring is required, monit may be specified as NULLFN.

Scheduled for withdrawal at Mark 26.
Replaced by nag_opt_nlp (e04ucc).

See the example program

e04jbce.c

for code demonstrating how to use nag_opt_nlp (e04ucc) instead of nag_opt_bounds_no_deriv (e04jbc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zpotrf (f07frc).

If you were only using nag_complex_cholesky (f01bnc) in order to feed its results into nag_hermitian_lin_eqn_mult_rhs (f04awc), then the simple replacement function given further below, in the section for nag_hermitian_lin_eqn_mult_rhs (f04awc), will suffice. A more thorough replacement function is given here and it will put the same values in arrays a and p as nag_complex_cholesky (f01bnc) did.

Scheduled for withdrawal at Mark 25.
Replaced by nag_dgeqrf (f08aec).

The subdiagonal elements of a and the elements of zeta returned by nag_dgeqrf (f08aec) are not the same as those returned by nag_real_qr (f01qcc). Subsequent calls to nag_real_apply_q (f01qdc) or nag_real_form_q (f01qec) must also be replaced by calls to nag_dorgqr (f08afc) or nag_dormqr (f08agc) as shown below.

Scheduled for withdrawal at Mark 25.
Replaced by nag_dormqr (f08agc).

The following replacement is valid only if the previous call to nag_real_qr (f01qcc) has been replaced by a call to nag_dgeqrf (f08aec) as shown below. It also assumes that the second argument of nag_real_apply_q (f01qdc) is set to

wheret = Nag_ElementsSeparate

, which is appropriate if the contents of a and zeta have not been changed after the call of nag_real_qr (f01qcc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_dorgqr (f08afc).

The following replacement is valid only if the previous call to nag_real_qr (f01qcc) has been replaced by a call to nag_dgeqrf (f08aec) as shown below. It also assumes that the first argument of nag_real_form_q (f01qec) is set to

wheret = Nag_ElementsSeparate

, which is appropriate if the contents of a and zeta have not been changed after the call of nag_real_qr (f01qcc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zgeqrf (f08asc).

The subdiagonal elements of a and the elements of theta returned by nag_zgeqrf (f08asc) are not the same as those returned by nag_complex_qr (f01rcc). Subsequent calls to nag_complex_apply_q (f01rdc) or nag_complex_form_q (f01rec) must also be replaced by calls to nag_zunmqr (f08auc) or nag_zungqr (f08atc) as shown below.

Scheduled for withdrawal at Mark 25.
Replaced by nag_zunmqr (f08auc).

The following replacement is valid only if the previous call to nag_complex_qr (f01rcc) has been replaced by a call to nag_zgeqrf (f08asc) as shown below. It also assumes that the second argument of nag_complex_apply_q (f01rdc) is set to

wheret = Nag_ElementsSeparate

, which is appropriate if the contents of a and theta have not been changed after the call of nag_complex_qr (f01rcc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zungqr (f08atc).

The following replacement is valid only if the previous call to nag_complex_qr (f01rcc) has been replaced by a call to nag_zgeqrf (f08asc) as shown below. It also assumes that the first argument of nag_complex_form_q (f01rec) is set to

wheret = Nag_ElementsSeparate

, which is appropriate if the contents of a and theta have not been changed after the call of nag_complex_qr (f01rcc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_dsyev (f08fac).

If nag_real_symm_eigensystem (f02abc) was called with the same array supplied for v and a, then the call to nag_dtr_copy (f16qec) may be omitted.

Scheduled for withdrawal at Mark 26.
Replaced by nag_dsygv (f08sac).

Note that the call to nag_dsygv (f08sac) will overwrite the upper triangles of the arrays a and b and leave the subdiagonal elements unchanged, whereas the call to nag_real_symm_general_eigenvalues (f02adc) overwrites the lower triangle and leaves the elements above the diagonal unchanged.

Scheduled for withdrawal at Mark 26.
Replaced by nag_dsygv (f08sac).

Note that the call to nag_dsygv (f08sac) will overwrite the upper triangle of the array b and leave the subdiagonal elements unchanged, whereas the call to nag_real_symm_general_eigensystem (f02aec) overwrites the lower triangle and leaves the elements above the diagonal unchanged. The call to nag_dtr_copy (f16qec) copies a to v, so a is left unchanged. If nag_real_symm_general_eigensystem (f02aec) was called with the same array supplied for v and a, then the call to nag_dtr_copy (f16qec) may be omitted.

Scheduled for withdrawal at Mark 26.
Replaced by nag_dgeev (f08nac).

where wr and wi are double arrays of lengths

n

such that

wr [i - 1] = r . re [i - 1]

and

wi [i - 1] = r . im [i - 1]

, for

i = 1, 2, \dots, n

; vl and vr are double arrays of length

1

(not used in this call); the iteration counts (returned by nag_real_eigenvalues (f02afc) in the array iter) are not available from nag_dgeev (f08nac).

Scheduled for withdrawal at Mark 26.
Replaced by nag_dgeev (f08nac).

where wr and wi are double arrays of lengths

n

such that

wr [i - 1] = r . re [i - 1]

and

wi [i - 1] = r . im [i - 1]

, for

i = 1, 2, \dots, n

; vl is a double array of length

1

(not used in this call) and vr is a double array of length

n \times n

; the iteration counts (returned by nag_real_eigensystem (f02agc) in the array iter) are not available from nag_dgeev (f08nac).

Eigenvector information is stored differently in vr:

$v . re [j] = vr [j]$ if $wi [j] = 0.0$ .
$v . re [j] = vr [j]$ and $v . im [j] = vr [j + 1]$ and $v . re [j + 1] = vr [j]$ and $v . im [j + 1] = - vr [j + 1]$ if $wi [j] \neq 0$ and $wi [j] = - wi [j + 1]$ .

Scheduled for withdrawal at Mark 26.
Replaced by nag_zheev (f08fnc).

If nag_hermitian_eigensystem (f02axc) was called with the same arrays supplied for v and a, then the call to nag_ztr_copy (f16tec) may be omitted.

Scheduled for withdrawal at Mark 26.
Replaced by nag_dggev (f08wac).

where alphar and alphai are double arrays of lengths

n

such that

alphar [i - 1] = alfa . re [i - 1]

and

alphai [i - 1] = alfa . im [i - 1]

, for

i = 1, 2, \dots, n

.

Scheduled for withdrawal at Mark 26.
Replaced by nag_dgesvd (f08kbc).

work must be a one-dimensional double array of length

\min (m, n)

; the iteration count (returned by nag_real_svd (f02wec) in the argument iter) is not available from nag_dgesvd (f08kbc).

Please note that the facility to return

Q^{T} B

is not provided so arguments

ncolb

and

b

are not required. Instead, nag_dgesvd (f08kbc) has an option to return the entire

m * m

orthogonal matrix

Q

, referred to as

u

in its documentation, through its 8th argument.

Scheduled for withdrawal at Mark 26.
Replaced by nag_zgesvd (f08kpc).

rwork must be a one-dimensional double array of length

\min (m, n)

; the iteration count (returned by nag_complex_svd (f02xec) in the argument iter) is not available from nag_zgesvd (f08kpc).

Please note that the facility to return

Q^{H} B

is not provided so arguments ncolb and

b

are not required. Instead, nag_zgesvd (f08kpc) has an option to return the entire

m * m

unitary matrix

Q

, referred to as

u

in its documentation, through its 8th argument.

Scheduled for withdrawal at Mark 25.
Replaced by nag_dpotrf (f07fdc) and nag_det_real_sym (f03bfc).

nag_dpotrf (f07fdc) performs the Cholesky factorization and nag_det_real_sym (f03bfc) calculates the determinant from the factored form.

Note: subsequent solution of linear systems using the Cholesky factorization performed by nag_dpotrf (f07fdc) should be performed using nag_dpotrs (f07fec)).

Scheduled for withdrawal at Mark 25.
Replaced by nag_dgetrf (f07adc) and nag_det_real_gen (f03bac).

Note: subsequent solution of linear systems using the

L U

factorization performed by nag_dgetrf (f07adc) should be performed using nag_dgetrs (f07aec)).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zgetrf (f07arc) and nag_det_complex_gen (f03bnc).

nag_zgetrf (f07arc) performs the

L U

factorization and nag_det_complex_gen (f03bnc) calculates the determinant from the factored form.

Note: the details of the

L U

factorization performed by nag_zgetrf (f07arc) differ from those perfomed by nag_complex_lu (f03ahc); subsequent solution of linear systems using the

L U

factorization performed by nag_zgetrf (f07arc) should be performed using nag_zgetrs (f07asc). The determinant returned by nag_det_complex_gen (f03bnc) independently scales the real and imaginary parts whereas the determinant returned by nag_complex_lu (f03ahc) used a single scaling factor.

The factorization and solution of a positive definite linear system can be handled by calls to functions from Chapter f07.

Scheduled for withdrawal at Mark 25.
Replaced by nag_complex_gen_lin_solve (f04cac).

Scheduled for withdrawal at Mark 25.
Replaced by nag_dpotrs (f07fec).

It is assumed that the matrix has been factorized by a call to nag_dpotrf (f07fdc) rather than nag_real_cholesky (f03aec). The array p is no longer required.

Scheduled for withdrawal at Mark 25.
Replaced by nag_dgetrs (f07aec).

It is assumed that the matrix has been factorized by a call to nag_dgetrf (f07adc) rather than nag_real_lu (f03afc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zgetrs (f07asc).

It is assumed that the matrix has been factorized by a call to nag_zgetrf (f07arc) rather than nag_complex_lu (f03ahc).

Scheduled for withdrawal at Mark 25.
Replaced by nag_real_gen_lin_solve (f04bac).

Scheduled for withdrawal at Mark 25.
Replaced by nag_zpotrs (f07fsc).

Note that the preceding call to nag_complex_cholesky (f01bnc) has been replaced by nag_zpotrf (f07frc).

The functions in Chapter f16 provide greater functionality than their corresponding functions in Chapter f06. The essential differences are:

The order argument. This provides the flexibility to operate on matrix data stored in row or column major order.
The addition of the fail argument to trap data errors. The f06 functions used to abort noisily.
The enumeration types and members use NAG_ as the prefix. This is to guard against accidental use of non-NAG enums.
Scale factors have been introduced in some functions. For example nag_dtrmv (f16pfc) has an extra argument, alpha which was not present in the corresponding old_dtrmv (f06pfc) function.

Withdrawn at Mark 23.
Replaced by nag_dgemv (f16pac).

Withdrawn at Mark 23.
Replaced by nag_dgbmv (f16pbc).

Withdrawn at Mark 23.
Replaced by nag_dsymv (f16pcc).

Withdrawn at Mark 23.
Replaced by nag_dsbmv (f16pdc).

Withdrawn at Mark 23.
Replaced by nag_dspmv (f16pec).

Withdrawn at Mark 23.
Replaced by nag_dtrmv (f16pfc).

Withdrawn at Mark 23.
Replaced by nag_dtbmv (f16pgc).

Withdrawn at Mark 23.
Replaced by nag_dtpmv (f16phc).

Withdrawn at Mark 23.
Replaced by nag_dtrsv (f16pjc).

Withdrawn at Mark 23.
Replaced by nag_dtbsv (f16pkc).

Withdrawn at Mark 23.
Replaced by nag_dtpsv (f16plc).

Withdrawn at Mark 23.
Replaced by nag_dger (f16pmc).

Withdrawn at Mark 23.
Replaced by nag_dsyr (f16ppc).

Withdrawn at Mark 23.
Replaced by nag_dspr (f16pqc).

Withdrawn at Mark 23.
Replaced by nag_dsyr2 (f16prc).

Withdrawn at Mark 23.
Replaced by nag_dspr2 (f16psc).

Withdrawn at Mark 23.
Replaced by nag_zgemv (f16sac).

Withdrawn at Mark 23.
Replaced by nag_zgbmv (f16sbc).

Withdrawn at Mark 23.
Replaced by nag_zhemv (f16scc).

Withdrawn at Mark 23.
Replaced by nag_zhbmv (f16sdc).

Withdrawn at Mark 23.
Replaced by nag_zhpmv (f16sec).

Withdrawn at Mark 23.
Replaced by nag_ztrmv (f16sfc).

Withdrawn at Mark 23.
Replaced by nag_ztbmv (f16sgc).

Withdrawn at Mark 23.
Replaced by nag_ztpmv (f16shc).

Withdrawn at Mark 23.
Replaced by nag_ztrsv (f16sjc).

Withdrawn at Mark 23.
Replaced by nag_ztbsv (f16skc).

Withdrawn at Mark 23.
Replaced by nag_ztpsv (f16slc).

Withdrawn at Mark 23.
Replaced by nag_zger (f16smc).

Withdrawn at Mark 23.
Replaced by nag_zher (f16spc).

Withdrawn at Mark 23.
Replaced by nag_zhpr (f16sqc).

Withdrawn at Mark 23.
Replaced by nag_zher2 (f16src).

Withdrawn at Mark 23.
Replaced by nag_zhpr2 (f16ssc).

Withdrawn at Mark 23.
Replaced by nag_dgemm (f16yac).

Withdrawn at Mark 23.
Replaced by nag_dsymm (f16ycc).

Withdrawn at Mark 23.
Replaced by nag_dtrmm (f16yfc).

Withdrawn at Mark 23.
Replaced by nag_dtrsm (f16yjc).

Withdrawn at Mark 23.
Replaced by nag_dsyrk (f16ypc).

Withdrawn at Mark 23.
Replaced by nag_dsyr2k (f16yrc).

Withdrawn at Mark 23.
Replaced by nag_zgemm (f16zac).

Withdrawn at Mark 23.
Replaced by nag_zhemm (f16zcc).

Withdrawn at Mark 23.
Replaced by nag_ztrmm (f16zfc).

Withdrawn at Mark 23.
Replaced by nag_ztrsm (f16zjc).

Withdrawn at Mark 23.
Replaced by nag_zherk (f16zpc).

Withdrawn at Mark 23.
Replaced by nag_zher2k (f16zrc).

Withdrawn at Mark 23.
Replaced by nag_zsymm (f16ztc).

Withdrawn at Mark 23.
Replaced by nag_zsyrk (f16zuc).

Withdrawn at Mark 23.
Replaced by nag_zsyr2k (f16zwc).

Scheduled for withdrawal at Mark 26.
Replaced by nag_summary_stats_onevar (g01atc).

Withdrawn at Mark 24.
Replaced by nag_deviates_normal (g01fac).

Scheduled for withdrawal at Mark 25.
Replaced by nag_full_step_regsn_monfun (g02efh).

Note: it is unlikely that you will need to call this function directly. Rather it will be supplied as a function argument to nag_full_step_regsn (g02efc) when monitoring information is required.

Withdrawn at Mark 24.
Replaced by nag_rand_basic (g05sac).

The Integer array state in the call to nag_rand_basic (g05sac) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_basic (g05sac) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_basic (g05sac) is likely to be different from those produced by nag_random_continuous_uniform (g05cac).

Withdrawn at Mark 24.
Replaced by nag_rand_init_repeatable (g05kfc).

The Integer array state in the call to nag_rand_init_repeatable (g05kfc) contains information on the base generator being used. The base generator is chosen via the integer arguments genid and subid. The required length of the array state depends on the base generator chosen. Due to changes in the underlying code a sequence of values produced by using a random number generator initialized via a call to nag_rand_init_repeatable (g05kfc) is likely to be different from a sequence produced by a generator initialized by nag_random_init_repeatable (g05cbc), even if the same value for i is used.

Note: it may still be necessary to call nag_random_init_repeatable (g05cbc) rather than the replacement function nag_rand_init_repeatable (g05kfc) when using nag_multid_quad_monte_carlo (d01gbc) or nag_multid_quad_monte_carlo_1 (d01xbc). See Section 10 in nag_multid_quad_monte_carlo (d01gbc) and nag_multid_quad_monte_carlo_1 (d01xbc) for additional information.

Withdrawn at Mark 24.
Replaced by nag_rand_init_nonrepeatable (g05kgc).

The Integer array state in the call to nag_rand_init_nonrepeatable (g05kgc) contains information on the base generator being used. The base generator is chosen via the integer arguments genid and subid. The required length of the array state depends on the base generator chosen.

Note: it may still be necessary to call nag_random_init_nonrepeatable (g05ccc) rather than the replacement function nag_rand_init_nonrepeatable (g05kgc) when using nag_multid_quad_monte_carlo (d01gbc) or nag_multid_quad_monte_carlo_1 (d01xbc). See Section 10 in nag_multid_quad_monte_carlo (d01gbc) and nag_multid_quad_monte_carlo_1 (d01xbc) for additional information.

Withdrawn at Mark 24.
There is no replacement for this function.

The state of the base generator for the group of functions nag_rand_init_repeatable (g05kfc), nag_rand_init_nonrepeatable (g05kgc), nag_rand_leap_frog (g05khc), nag_rand_skip_ahead (g05kjc), nag_rand_permute (g05ncc), nag_rand_sample (g05ndc), nag_rand_agarchI (g05pdc)–nag_rand_2_way_table (g05pzc), nag_rand_copula_students_t (g05rcc)–nag_rand_matrix_multi_normal (g05rzc), g05s and g05t can be saved by simply creating a local copy of the array state. The first element of the state array contains the number of elements that are used by the random number generating functions, therefore either this number of elements can be copied, or the whole array (as defined in the calling program).

Withdrawn at Mark 24.
There is no replacement for this function.

The state of the base generator for the group of functions nag_rand_init_repeatable (g05kfc), nag_rand_init_nonrepeatable (g05kgc), nag_rand_leap_frog (g05khc), nag_rand_skip_ahead (g05kjc), nag_rand_permute (g05ncc), nag_rand_sample (g05ndc), nag_rand_agarchI (g05pdc)–nag_rand_2_way_table (g05pzc), nag_rand_copula_students_t (g05rcc)–nag_rand_matrix_multi_normal (g05rzc), g05s and g05t can be restored by simply copying back the previously saved copy of the state array. The first element of the state array contains the number of elements that are used by the random number generating functions, therefore either this number of elements can be copied, or the whole array (as defined in the calling program).

Withdrawn at Mark 24.
Replaced by nag_rand_uniform (g05sqc).

The old function nag_random_continuous_uniform_ab (g05dac) returns a single variate at a time, whereas the new function nag_rand_uniform (g05sqc) returns a vector of n values in one go. In nag_rand_uniform (g05sqc) the minimum value must be held in the argument a and the maximum in argument b, therefore

a < b

. This was not the case for the equivalent arguments in nag_random_continuous_uniform_ab (g05dac).

The Integer array state in the call to nag_rand_uniform (g05sqc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_uniform (g05sqc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_uniform (g05sqc) is likely to be different from those produced by nag_random_continuous_uniform_ab (g05dac).

Withdrawn at Mark 24.
Replaced by nag_rand_exp (g05sfc).

The old function nag_random_exp (g05dbc) returns a single variate at a time, whereas the new function nag_rand_exp (g05sfc) returns a vector of n values in one go. In nag_rand_exp (g05sfc) argument a must be non-negative, this was not the case for the equivalent argument in nag_random_exp (g05dbc).

The Integer array state in the call to nag_rand_exp (g05sfc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_exp (g05sfc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_exp (g05sfc) is likely to be different from those produced by nag_random_exp (g05dbc).

Withdrawn at Mark 24.
Replaced by nag_rand_normal (g05skc).

The old function nag_random_normal (g05ddc) returns a single variate at a time, whereas the new function nag_rand_normal (g05skc) returns a vector of n values in one go. nag_rand_normal (g05skc) expects the variance of the Normal distribution (argument var), compared to nag_random_normal (g05ddc) which expected the standard deviation.

The Integer array state in the call to nag_rand_normal (g05skc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_normal (g05skc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_normal (g05skc) is likely to be different from those produced by nag_random_normal (g05ddc).

Withdrawn at Mark 24.
Replaced by nag_rand_discrete_uniform (g05tlc).

The old function nag_random_discrete_uniform (g05dyc) returns a single variate at a time, whereas the new function nag_rand_discrete_uniform (g05tlc) returns a vector of n values in one go. In nag_rand_discrete_uniform (g05tlc) the minimum value must be held in the argument a and the maximum in argument b, therefore

a \leq b

. This was not the case for the equivalent arguments in nag_random_discrete_uniform (g05dyc).

The Integer array state in the call to nag_rand_discrete_uniform (g05tlc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_discrete_uniform (g05tlc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_discrete_uniform (g05tlc) is likely to be different from those produced by nag_random_discrete_uniform (g05dyc).

Withdrawn at Mark 24.
Replaced by nag_rand_matrix_multi_normal (g05rzc).

The old function nag_ref_vec_multi_normal (g05eac) sets up a reference vector for use by nag_return_multi_normal (g05ezc). The functionality of both these functions has been combined into the single new function nag_rand_matrix_multi_normal (g05rzc). Setting

mode = Nag_InitializeReference

in the call to nag_rand_matrix_multi_normal (g05rzc) only sets up the double reference vector r and hence mimics the functionality of nag_ref_vec_multi_normal (g05eac).

The length of the double reference vector, r, in nag_rand_matrix_multi_normal (g05rzc) must be at least

m \times (m + 1) + 1

. In contrast to the equivalent argument in nag_ref_vec_multi_normal (g05eac), this array must be allocated in the calling program.

Withdrawn at Mark 24.
Replaced by nag_rand_poisson (g05tjc).

The old function nag_ref_vec_poisson (g05ecc) sets up a reference vector for use by nag_return_discrete (g05eyc). The replacement function nag_rand_poisson (g05tjc) is now used to both set up a reference vector and generate the required variates. Setting

mode = Nag_InitializeReference

in the call to nag_rand_poisson (g05tjc) sets up the double reference vector r and hence mimics the functionality of nag_ref_vec_poisson (g05ecc). Setting

mode = Nag_GenerateFromReference

generates a series of variates from a reference vector mimicking the functionality of nag_return_discrete (g05eyc) for this particular distribution. Setting

mode = Nag_InitializeAndGenerate

initializes the reference vector and generates the variates in one go.

The function nag_return_discrete (g05eyc) returns a single variate at a time, whereas the new function nag_rand_poisson (g05tjc) returns a vector of n values in one go.

The length of the double reference vector, r, in nag_rand_poisson (g05tjc), must be allocated in the calling program in contrast to the equivalent argument in nag_ref_vec_poisson (g05ecc), see the documentation for more details.

The Integer array state in the call to nag_rand_poisson (g05tjc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_poisson (g05tjc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_poisson (g05tjc) is likely to be different from those produced by a combination of nag_ref_vec_poisson (g05ecc) and nag_return_discrete (g05eyc).

Withdrawn at Mark 24.
Replaced by nag_rand_binomial (g05tac).

The old function nag_ref_vec_binomial (g05edc) sets up a reference vector for use by nag_return_discrete (g05eyc). The replacement function nag_rand_binomial (g05tac) is now used to both set up a reference vector and generate the required variates. Setting

mode = Nag_InitializeReference

in the call to nag_rand_binomial (g05tac) sets up the double reference vector r and hence mimics the functionality of nag_ref_vec_binomial (g05edc). Setting

mode = Nag_GenerateFromReference

generates a series of variates from a reference vector mimicking the functionality of nag_return_discrete (g05eyc) for this particular distribution. Setting

mode = Nag_InitializeAndGenerate

initializes the reference vector and generates the variates in one go.

The function nag_return_discrete (g05eyc) returns a single variate at a time, whereas the new function nag_rand_binomial (g05tac) returns a vector of n values in one go.

The length of the double reference vector, r, in nag_rand_binomial (g05tac), needs to be a different length from the equivalent argument in nag_ref_vec_binomial (g05edc), see the documentation for more details.

The Integer array state in the call to nag_rand_binomial (g05tac) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_binomial (g05tac) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_binomial (g05tac) is likely to be different from those produced by a combination of nag_ref_vec_binomial (g05edc) and nag_return_discrete (g05eyc).

Withdrawn at Mark 24.
Replaced by nag_rand_permute (g05ncc).

The Integer array state in the call to nag_rand_permute (g05ncc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_permute (g05ncc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_permute (g05ncc) is likely to be different from those produced by nag_ran_permut_vec (g05ehc).

Withdrawn at Mark 24.
Replaced by nag_rand_sample (g05ndc).

The Integer array state in the call to nag_rand_sample (g05ndc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_sample (g05ndc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_sample (g05ndc) is likely to be different from those produced by nag_ran_sample_vec (g05ejc).

Withdrawn at Mark 24.
Replaced by nag_rand_gen_discrete (g05tdc).

The old function nag_ref_vec_discrete_pdf_cdf (g05exc) sets up a reference vector for use by nag_return_discrete (g05eyc). The replacement function nag_rand_gen_discrete (g05tdc) is now used to both set up a reference vector and generate the required variates. Setting

mode = Nag_InitializeReference

in the call to nag_rand_gen_discrete (g05tdc) sets up the double reference vector r and hence mimics the functionality of nag_ref_vec_discrete_pdf_cdf (g05exc). Setting

mode = Nag_GenerateFromReference

generates a series of variates from a reference vector mimicking the functionality of nag_return_discrete (g05eyc) for this particular distribution. Setting

mode = Nag_InitializeAndGenerate

initializes the reference vector and generates the variates in one go.

The function nag_return_discrete (g05eyc) returns a single variate at a time, whereas the new function nag_rand_gen_discrete (g05tdc) returns a vector of n values in one go.

The length of the double reference vector, r, in nag_rand_gen_discrete (g05tdc) must be allocated in the calling program in contrast to the equivalent argument in nag_ref_vec_discrete_pdf_cdf (g05exc), see the documentation for more details.

The Integer array state in the call to nag_rand_gen_discrete (g05tdc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_gen_discrete (g05tdc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_gen_discrete (g05tdc) is likely to be different from those produced by a combination of nag_ref_vec_discrete_pdf_cdf (g05exc) and nag_return_discrete (g05eyc).

Withdrawn at Mark 24.
Replaced by nag_rand_gen_discrete (g05tdc).

There is no direct replacement function for nag_return_discrete (g05eyc).

nag_return_discrete (g05eyc) is designed to generate random draws from a distribution defined by a reference vector. These reference vectors are created by other functions in Chapter g05, for example nag_ref_vec_poisson (g05ecc), which have themselves been superseded. In order to replace a call to nag_return_discrete (g05eyc) you must identify which NAG function generated the reference vector being used and look up its replacement. For example, to replace a call to nag_return_discrete (g05eyc) preceded by a call to nag_ref_vec_discrete_pdf_cdf (g05exc), as in:

     /* nag_ref_vec_discrete_pdf_cdf (g05exc) */
     nag_ref_vec_discrete_pdf_cdf(p,np,sizep,distf,&r,&fail);
     /* nag_return_discrete (g05eyc) */
     x = nag_return_discrete(r);

you would need to look at the replacement function for nag_ref_vec_discrete_pdf_cdf (g05exc).

Withdrawn at Mark 24.
Replaced by nag_rand_matrix_multi_normal (g05rzc).

The old function nag_ref_vec_multi_normal (g05eac) sets up a reference vector for use by nag_return_multi_normal (g05ezc). The functionality of both these functions has been combined into the single new function nag_rand_matrix_multi_normal (g05rzc). Setting

mode = Nag_InitializeAndGenerate

in the call to nag_rand_matrix_multi_normal (g05rzc) sets up the double reference vector r and generates the draws from the multivariate Normal distribution in one go.

The old function nag_return_multi_normal (g05ezc) returns a single (m-dimensional vector) draw from the multivariate Normal distribution at a time, whereas the new function nag_rand_matrix_multi_normal (g05rzc) returns an n by m matrix of n draws in one go.

The Integer array state in the call to nag_rand_matrix_multi_normal (g05rzc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_matrix_multi_normal (g05rzc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_matrix_multi_normal (g05rzc) is likely to be different from those produced by nag_return_multi_normal (g05ezc).

Withdrawn at Mark 24.
Replaced by nag_rand_beta (g05sbc).

The Integer array state in the call to nag_rand_beta (g05sbc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_beta (g05sbc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_beta (g05sbc) is likely to be different from those produced by nag_random_beta (g05fec).

Withdrawn at Mark 24.
Replaced by nag_rand_gamma (g05sjc).

The Integer array state in the call to nag_rand_gamma (g05sjc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_gamma (g05sjc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_gamma (g05sjc) is likely to be different from those produced by nag_random_gamma (g05ffc).

Withdrawn at Mark 24.
Replaced by nag_rand_arma (g05phc).

The Integer array state in the call to nag_rand_arma (g05phc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_arma (g05phc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_arma (g05phc) is likely to be different from those produced by nag_arma_time_series (g05hac).

Withdrawn at Mark 24.
Replaced by nag_rand_agarchI (g05pdc).

The Integer array state in the call to nag_rand_agarchI (g05pdc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_agarchI (g05pdc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_agarchI (g05pdc) is likely to be different from those produced by nag_generate_agarchI (g05hkc).

Withdrawn at Mark 24.
Replaced by nag_rand_agarchII (g05pec).

The Integer array state in the call to nag_rand_agarchII (g05pec) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_agarchII (g05pec) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_agarchII (g05pec) is likely to be different from those produced by nag_generate_agarchII (g05hlc).

Withdrawn at Mark 24.
Replaced by nag_rand_garchGJR (g05pfc).

The Integer array state in the call to nag_rand_garchGJR (g05pfc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_garchGJR (g05pfc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization. Due to changes in the underlying code the sequence of values produced by nag_rand_garchGJR (g05pfc) is likely to be different from those produced by nag_generate_garchGJR (g05hmc).

Withdrawn at Mark 24.
Replaced by nag_rand_basic (g05sac).

The old function nag_rngs_basic (g05kac) returns a single variate at a time, whereas the new function nag_rand_basic (g05sac) returns a vector of n values in one go.

The Integer array state in the call to nag_rand_basic (g05sac) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_basic (g05sac) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_init_repeatable (g05kfc).

Withdrawn at Mark 24.
Replaced by nag_rand_init_nonrepeatable (g05kgc).

Withdrawn at Mark 24.
Replaced by nag_rand_logical (g05tbc).

The old function nag_rngs_logical (g05kec) returns a single variate at a time, whereas the new function nag_rand_logical (g05tbc) returns a vector of n values in one go.

The Integer array state in the call to nag_rand_logical (g05tbc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_logical (g05tbc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_normal (g05skc).

The Integer array state in the call to nag_rand_normal (g05skc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_normal (g05skc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_students_t (g05snc).

The Integer array state in the call to nag_rand_students_t (g05snc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_students_t (g05snc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_chi_sq (g05sdc).

The Integer array state in the call to nag_rand_chi_sq (g05sdc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_chi_sq (g05sdc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_f (g05shc).

The Integer array state in the call to nag_rand_f (g05shc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_f (g05shc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_beta (g05sbc).

The Integer array state in the call to nag_rand_beta (g05sbc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_beta (g05sbc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_gamma (g05sjc).

The Integer array state in the call to nag_rand_gamma (g05sjc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_gamma (g05sjc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_uniform (g05sqc).

The Integer array state in the call to nag_rand_uniform (g05sqc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_uniform (g05sqc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_triangular (g05spc).

The Integer array state in the call to nag_rand_triangular (g05spc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_triangular (g05spc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_exp (g05sfc).

The Integer array state in the call to nag_rand_exp (g05sfc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_exp (g05sfc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_lognormal (g05smc).

The Integer array state in the call to nag_rand_lognormal (g05smc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_lognormal (g05smc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_cauchy (g05scc).

The Integer array state in the call to nag_rand_cauchy (g05scc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_cauchy (g05scc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_weibull (g05ssc).

The Integer array state in the call to nag_rand_weibull (g05ssc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_weibull (g05ssc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_logistic (g05slc).

The Integer array state in the call to nag_rand_logistic (g05slc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_logistic (g05slc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_von_mises (g05src).

The Integer array state in the call to nag_rand_von_mises (g05src) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_von_mises (g05src) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_exp_mix (g05sgc).

The Integer array state in the call to nag_rand_exp_mix (g05sgc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_exp_mix (g05sgc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_matrix_multi_students_t (g05ryc).

The Integer array state in the call to nag_rand_matrix_multi_students_t (g05ryc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_matrix_multi_students_t (g05ryc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_matrix_multi_normal (g05rzc).

The Integer array state in the call to nag_rand_matrix_multi_normal (g05rzc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_matrix_multi_normal (g05rzc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_matrix_multi_normal (g05rzc).

The Integer array state in the call to nag_rand_matrix_multi_normal (g05rzc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_matrix_multi_normal (g05rzc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_discrete_uniform (g05tlc).

The Integer array state in the call to nag_rand_discrete_uniform (g05tlc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_discrete_uniform (g05tlc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_geom (g05tcc).

nag_rngs_geom (g05mbc) returned the number of trials required to get the first success, whereas nag_rand_geom (g05tcc) returns the number of failures before the first success, therefore the value returned by nag_rand_geom (g05tcc) is one less than the equivalent value returned from nag_rngs_geom (g05mbc).

The Integer array state in the call to nag_rand_geom (g05tcc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_geom (g05tcc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_neg_bin (g05thc).

The Integer array state in the call to nag_rand_neg_bin (g05thc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_neg_bin (g05thc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_logarithmic (g05tfc).

The Integer array state in the call to nag_rand_logarithmic (g05tfc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_logarithmic (g05tfc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_compd_poisson (g05tkc).

The Integer array state in the call to nag_rand_compd_poisson (g05tkc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_compd_poisson (g05tkc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_binomial (g05tac).

The Integer array state in the call to nag_rand_binomial (g05tac) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_binomial (g05tac) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_poisson (g05tjc).

The Integer array state in the call to nag_rand_poisson (g05tjc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_poisson (g05tjc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_hypergeometric (g05tec).

The Integer array state in the call to nag_rand_hypergeometric (g05tec) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_hypergeometric (g05tec) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_gen_multinomial (g05tgc).

The Integer array state in the call to nag_rand_gen_multinomial (g05tgc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_gen_multinomial (g05tgc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_gen_discrete (g05tdc).

The Integer array state in the call to nag_rand_gen_discrete (g05tdc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_gen_discrete (g05tdc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_permute (g05ncc).

The Integer array state in the call to nag_rand_permute (g05ncc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_permute (g05ncc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_sample (g05ndc).

The Integer array state in the call to nag_rand_sample (g05ndc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_sample (g05ndc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_arma (g05phc).

The Integer array state in the call to nag_rand_arma (g05phc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_arma (g05phc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_varma (g05pjc).

The Integer array state in the call to nag_rand_varma (g05pjc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_varma (g05pjc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_orthog_matrix (g05pxc).

The Integer array state in the call to nag_rand_orthog_matrix (g05pxc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_orthog_matrix (g05pxc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_corr_matrix (g05pyc).

The Integer array state in the call to nag_rand_corr_matrix (g05pyc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_corr_matrix (g05pyc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_2_way_table (g05pzc).

The Integer array state in the call to nag_rand_2_way_table (g05pzc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_2_way_table (g05pzc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_copula_normal (g05rdc).

The Integer array state in the call to nag_rand_copula_normal (g05rdc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_copula_normal (g05rdc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_rand_copula_students_t (g05rcc).

The Integer array state in the call to nag_rand_copula_students_t (g05rcc) contains information on the base generator being used. This array must have been initialized prior to calling nag_rand_copula_students_t (g05rcc) with a call to either nag_rand_init_repeatable (g05kfc) or nag_rand_init_nonrepeatable (g05kgc). The required length of the array state will depend on the base generator chosen during initialization.

Withdrawn at Mark 24.
Replaced by nag_quasi_init (g05ylc) and nag_quasi_rand_uniform (g05ymc).

nag_quasi_random_uniform (g05yac) has been split into two functions; nag_quasi_init (g05ylc) to initialize the quasi-random generators and nag_quasi_rand_uniform (g05ymc) to generate the values. nag_quasi_rand_uniform (g05ymc) will generate more than one realization at a time. Information is passed between nag_quasi_init (g05ylc) and nag_quasi_rand_uniform (g05ymc) using the integer vector iref rather than the NAG defined structure gf. Therefore there is no longer any need to call a function to release memory as iref can be "freed" like any C array.

Withdrawn at Mark 24.
Replaced by nag_quasi_rand_normal (g05yjc) and nag_quasi_init (g05ylc).

nag_quasi_random_normal (g05ybc) has been split into three functions; nag_quasi_init (g05ylc) to initialize the quasi-random generators, nag_quasi_rand_lognormal (g05ykc) to generate values from a log-normal distribution and nag_quasi_rand_normal (g05yjc) to generate values from a normal distribution. Both nag_quasi_rand_lognormal (g05ykc) and nag_quasi_rand_normal (g05yjc) will generate more than one realization at a time. Information is passed between nag_quasi_init (g05ylc) and nag_quasi_rand_lognormal (g05ykc) and nag_quasi_rand_normal (g05yjc) using the integer vector iref rather than the NAG defined structure gf. Therefore there is no longer any need to call a function to release memory as iref can be "freed" like any C array.

Scheduled for withdrawal at Mark 26.
Replaced by nag_kernel_density_gauss (g10bbc).

Withdrawn at Mark 24.
There is no replacement for this function.

Scheduled for withdrawal at Mark 25.
There is no replacement for this function.

NAG LibraryAdvice on Replacement Calls for Withdrawn/Superseded Functions

+− Contents

c05 – Roots of One or More Transcendental Equations

nag_zero_cont_func_bd (c05adc)

nag_zero_cont_func_brent_bsrch (c05agc)

nag_zero_nonlin_eqns (c05nbc)

nag_zero_nonlin_eqns_deriv (c05pbc)

nag_zero_cont_func_bd_1 (c05sdc)

nag_zero_nonlin_eqns_1 (c05tbc)

nag_zero_nonlin_eqns_deriv_1 (c05ubc)

nag_check_deriv (c05zbc)

nag_check_deriv_1 (c05zcc)

c06 – Fourier Transforms

nag_fft_real (c06eac)

nag_fft_hermitian (c06ebc)

nag_fft_complex (c06ecc)

nag_convolution_real (c06ekc)

nag_fft_multiple_complex (c06frc)

nag_fft_2d_complex (c06fuc)

nag_conjugate_hermitian (c06gbc)

nag_conjugate_complex (c06gcc)

nag_fft_multiple_sine (c06hac)

nag_fft_multiple_cosine (c06hbc)

nag_fft_multiple_qtr_sine (c06hcc)

nag_fft_multiple_qtr_cosine (c06hdc)

d01 – Quadrature

nag_1d_quad_gen (d01ajc)

nag_1d_quad_osc (d01akc)

nag_1d_quad_brkpts (d01alc)

nag_1d_quad_inf (d01amc)

nag_1d_quad_wt_trig (d01anc)

nag_1d_quad_wt_alglog (d01apc)

nag_1d_quad_wt_cauchy (d01aqc)

nag_1d_quad_inf_wt_trig (d01asc)

nag_1d_quad_gauss (d01bac)

nag_multid_quad_adapt (d01fcc)

nag_multid_quad_monte_carlo (d01gbc)

d02 – Ordinary Differential Equations

nag_ode_ivp_rk_range (d02pcc)

nag_ode_ivp_rk_onestep (d02pdc)

nag_ode_ivp_rk_free (d02ppc)

nag_ode_ivp_rk_setup (d02pvc)

nag_ode_ivp_rk_reset_tend (d02pwc)

nag_ode_ivp_rk_interp (d02pxc)

nag_ode_ivp_rk_errass (d02pzc)

e01 – Interpolation

nag_2d_scat_interpolant (e01sac)

nag_2d_scat_eval (e01sbc)

nag_2d_scat_free (e01szc)

e04 – Minimizing or Maximizing a Function

nag_opt_simplex (e04ccc)

nag_opt_bounds_no_deriv (e04jbc)

f01 – Matrix Operations, Including Inversion

nag_complex_cholesky (f01bnc)

nag_real_qr (f01qcc)

nag_real_apply_q (f01qdc)

nag_real_form_q (f01qec)

nag_complex_qr (f01rcc)

nag_complex_apply_q (f01rdc)

nag_complex_form_q (f01rec)

f02 – Eigenvalues and Eigenvectors

nag_real_symm_eigenvalues (f02aac)

nag_real_symm_eigensystem (f02abc)

nag_real_symm_general_eigenvalues (f02adc)

nag_real_symm_general_eigensystem (f02aec)

nag_real_eigenvalues (f02afc)

nag_real_eigensystem (f02agc)

nag_hermitian_eigenvalues (f02awc)

nag_hermitian_eigensystem (f02axc)

nag_real_general_eigensystem (f02bjc)

nag_real_svd (f02wec)

nag_complex_svd (f02xec)

f03 – Determinants

nag_real_cholesky (f03aec)

nag_real_lu (f03afc)

nag_complex_lu (f03ahc)

f04 – Simultaneous Linear Equations

nag_complex_lin_eqn_mult_rhs (f04adc)

nag_real_cholesky_solve_mult_rhs (f04agc)

nag_real_lu_solve_mult_rhs (f04ajc)

NAG Library

Advice on Replacement Calls for Withdrawn/Superseded Functions