# NAG Library Function Document

## 1Purpose

nag_tsa_transf_orders (g13byc) allocates memory to the four pointers in the structure of type Nag_TransfOrder. The structure is used to hold the transfer function model orders of the input series for some functions in Chapter g13. This function must be called before any attempt is made to access this structure.

## 2Specification

 #include #include
 void nag_tsa_transf_orders (Integer nseries, Nag_TransfOrder *transfv, NagError *fail)

## 3Description

The transfer function model orders of the input series are supplied to the time series function in memory allocated to four pointers. These pointers are the constituent members of the structure of type Nag_TransfOrder used by some functions in Chapter g13.
The purpose of nag_tsa_transf_orders (g13byc) is to allocate memory to these four pointers.

None.

## 5Arguments

1:    $\mathbf{nseries}$IntegerInput
On entry: the total number of input and output series. There may be any number of input series (including none), but always one output series. (See nag_tsa_multi_inp_model_estim (g13bec) or nag_tsa_multi_inp_model_forecast (g13bjc) for details).
Constraint: ${\mathbf{nseries}}\ge 1$.
2:    $\mathbf{transfv}$Nag_TransfOrder *
Pointer to structure of type Nag_TransfOrder with the following members:
bInteger *Output
qInteger *Output
pInteger *
rInteger *Output
On exit: each of the pointers will have been allocated sufficient memory. (See nag_tsa_multi_inp_model_estim (g13bec) or nag_tsa_multi_inp_model_forecast (g13bjc) for details).
3:    $\mathbf{fail}$NagError *Input/Output
The NAG error argument (see Section 3.7 in How to Use the NAG Library and its Documentation).

## 6Error Indicators and Warnings

NE_ALLOC_FAIL
Dynamic memory allocation failed.
NE_INT_ARG_LT
On entry, ${\mathbf{nseries}}=〈\mathit{\text{value}}〉$.
Constraint: ${\mathbf{nseries}}\ge 1$.

Not applicable.

## 8Parallelism and Performance

nag_tsa_transf_orders (g13byc) is not threaded in any implementation.