3 Description

nag_band_real_mat_print (x04cec) prints a double band matrix stored in
packed
form.
It is an easy-to-use driver for nag_band_real_mat_print_comp (x04cfc). The function uses default values for the format in which numbers are printed, for labelling the rows and columns, and for output record length.

nag_band_real_mat_print (x04cec) will choose a format code such that numbers will be printed with
a %8.4f, a %11.4f or a %13.4e format.
The
%8.4f code is chosen if the sizes of all the matrix elements to be printed lie between 0.001 and 1.0. The
%11.4f code is chosen if the sizes of all the matrix elements to be printed lie between 0.001 and 9999.9999. Otherwise the
%13.4e code is chosen.

The matrix is printed with integer row and column labels, and with a maximum record length of 80.

The matrix is output to the file specified by outfile or,
by default, to standard output.

4 References

None.

5 Arguments

1:
order – Nag_OrderTypeInput

On entry: the order argument specifies the two-dimensional storage scheme being used, i.e., row-major ordering or column-major ordering. C language defined storage is specified by order=Nag_RowMajor. See Section 3.2.1.3 in the Essential Introduction for a more detailed explanation of the use of this argument.

Constraint:
order=Nag_RowMajor or Nag_ColMajor.

2:
m – IntegerInput

3:
n – IntegerInput

On entry: the number of rows and columns of the band matrix, respectively, to be printed.

If either m or n is less than 1, nag_band_real_mat_print (x04cec) will exit immediately after printing title; no row or column labels are printed.

This is stored as a notional two-dimensional array with row elements or column elements stored contiguously. The storage of elements Aij, for row i=1,…,m and column j=max1,i-kl,…,minn,i+ku, depends on the order argument as follows:

if order=Nag_ColMajor, Aij is stored as a[j-1×pda+ku+i-j];

if order=Nag_RowMajor, Aij is stored as a[i-1×pda+kl+j-i].

7:
pda – IntegerInput

On entry: the stride separating row or column elements (depending on the value of order) of the matrix A in the array
a.

Constraint:
pda≥kl+ku+1.

8:
title – const char *Input

On entry: a title to be printed above the matrix.

If
title=NULL,
no title (and no blank line) will be printed.

If title contains more than 80 characters, the contents of title will be wrapped onto more than one line, with the break after 80 characters.