NAG C Library Function Document

nag_tsa_trans_free (g13bzc)

1
Purpose

nag_tsa_trans_free (g13bzc) frees the memory allocated by NAG functions to the transfer function model orders structure, type Nag_TransfOrder. This structure is used by some functions in Chapter g13.

2
Specification

#include <nag.h>
#include <nagg13.h>
void  nag_tsa_trans_free (Nag_TransfOrder *transfv)

3
Description

The structure Nag_TransfOrder is used by some functions in Chapter g13. This structure is allocated memory by these functions during use.
nag_tsa_trans_free (g13bzc) is supplied to allow you to easily free the allocated memory and set the associated pointers to NULL.
Use of nag_tsa_trans_free (g13bzc) is not essential but is recommended if further calls are to be made using the structure transf and memory conservation is important.

4
References

None.

5
Arguments

1:     transfv Nag_TransfOrder *Input/Output
On entry: the transfer function model orders structure of type Nag_TransfOrder
On exit: the pointers with NAG allocated memory will have been freed and set to NULL.

6
Error Indicators and Warnings

None.

7
Accuracy

Not applicable.

8
Parallelism and Performance

nag_tsa_trans_free (g13bzc) is not threaded in any implementation.

9
Further Comments

None.

10
Example

See nag_tsa_multi_inp_model_estim (g13bec) and nag_tsa_multi_inp_model_forecast (g13bjc) for examples of how nag_tsa_trans_free (g13bzc) is used.