next up previous contents
Next: Commenting Source Code Up: Programming Style Previous: Naming of Variables   Contents

Printing Conventions

At the moment, there isn't really a standard method for a PSI program to determine how much information to print to output.dat. Some older PSI3 modules read a flag usually called IPRINT which is a decimal representation of a binary number. Each bit is a printing option (yes or no) for the different intermediates particular to the program.

A practice which is probably preferable is to have a different print flag (boolean) for each of the major intermediates used by a program, and to have an overall print option (decimal) whose value determines the printing verbosity for the quantities without a specific printing option. The overall print option should be specified by a keyword PRINT_LVL, and its action should be as in Table 2.


Table 2: Proposed Conventions for Printing Level
0 Almost no printing; to be used by driver programs
  with -quiet option
1 Usual printing (default)
2 Verbose printing
3 Some debugging information
4 Substantial debugging information
5 Print almost all intermediates unless arrays too large
6 Print everything


next up previous contents
Next: Commenting Source Code Up: Programming Style Previous: Naming of Variables   Contents
psi 2003-01-07