Describes the Fortran format code that is used in conjunction with usefrm
for printing the elements of the matrix a
. The format code may be any allowed on the system, whether it is standard Fortran or not. It may or may not be enclosed in brackets.
In addition, there are the following special codes which force nag_file_print_matrix_complex_gen_comp (x04db)
to choose its own format code:
- form = ' '
- nag_file_print_matrix_complex_gen_comp (x04db) will choose a format code such that numbers will be printed with an F8.4, an F11.4 or a 1PE13.4 format. The F8.4 code is chosen if the sizes of the real and imaginary parts of all the matrix elements to be printed lie between 0.001 and 1.0. The F11.4 code is chosen if the sizes of all the numbers to be printed lie between 0.001 and 9999.9999. Otherwise the 1PE13.4 code is chosen.
- form = '*'
- nag_file_print_matrix_complex_gen_comp (x04db) will choose a format code such that numbers will be printed to as many significant digits as are necessary to distinguish between neighbouring machine numbers. Thus any two numbers that are stored with different internal representations should look different on output. Whether they do in fact look different will depend on the run-time library of the Fortran compiler in use.
By preceding the desired format code by the string ‘MATLAB’, nag_file_print_matrix_complex_gen_comp (x04db)
will print the matrix such that it can be input into MATLAB, and title
will be used as the name of the matrix.
More complicated values of form
, to print a complex number in a desired form, may be used. See the description of parameter usefrm
for more details.
Examples of valid values for form
the character length of the format specifier in form
must be ≤ 80