Debugging and Status Options - Cold Manual 1.0.0

Next: Technical Options, Previous: Running Options, Up: Invoking Cold

1.6 Debugging and Status Options:

-i level Interactivity - sets the level of interactivity for the program. Options are as follows: [The numerical values are the values that need to be given. Hopefully I will soon add support for inputting the macro versions]

-1 LOGFILE send all messages to a log file.
0 AWAY display messages, make default choices, don't ask for user input.
1 VITAL only request user input when absolutely necessary.
2 PRESENT request user input whenever it may be helpful to do so.
3 ALL request user input on all irregularities, even when no input would usually be expected.
32 START Perform all file loading and parsing operations at the start of execution, and prompt for user input at this time. Do not prompt for user input once optimisation has started.
33 STARTCHECK Like START, but print a message indicating when the optimisation is ready to start.

-D level Debug level - controls the amount of debuging information output. The following options are available: [The numerical values are the values that need to be given. Hopefully I will soon add support for inputting the macro versions]

-1 SILENCE No Debugging or even status updates displayed.

0 NODEBUG Appropriate for most users. This provides basic status updates indicating the progress of the program. This should be sufficient to indicate whether the program is progressing normally. If a problem occurs, the program can be rerun with a higher debugging level to identify the problem.

1 BASICDEBUG Gives basic debugging output. May be helpful if something goes wrong. Might identify file format problems or similar things that may be fixed easily by the user.

2 FULLDEBUG Mostly only useful for developing Cold, or for users who want to extend Cold with their own code. if you want to send a bug report, please include the output from the command run with -D2.

Numbers greater than 2 default to 2, so running with -D3 is also OK, and will allow for any later extensions to the debugging options.

-q [Not yet implemented] quiet - does not print any information about the status of the program - just outputs the desired information at the end. This can be achieved with -D -1.

-v [Not yet implemented] verbose - provides a lot of information about the current state of the program. Useful for debugging. This can be achieved with -D 2

--showeverysite number controls the status display. When calculating a hessian, the program will print information about which site it is currently working on. The value number controls how often the program prints this message. If number is larger than the total number of sites, then the program never displays the message.

-1	LOGFILE	send all messages to a log file.
0	AWAY	display messages, make default choices, don't ask for user input.
1	VITAL	only request user input when absolutely necessary.
2	PRESENT	request user input whenever it may be helpful to do so.
3	ALL	request user input on all irregularities, even when no input would usually be expected.
32	START	Perform all file loading and parsing operations at the start of execution, and prompt for user input at this time. Do not prompt for user input once optimisation has started.
33	STARTCHECK	Like START, but print a message indicating when the optimisation is ready to start.

-1	SILENCE	No Debugging or even status updates displayed.
0	NODEBUG	Appropriate for most users. This provides basic status updates indicating the progress of the program. This should be sufficient to indicate whether the program is progressing normally. If a problem occurs, the program can be rerun with a higher debugging level to identify the problem.
1	BASICDEBUG	Gives basic debugging output. May be helpful if something goes wrong. Might identify file format problems or similar things that may be fixed easily by the user.
2	FULLDEBUG	Mostly only useful for developing Cold, or for users who want to extend Cold with their own code. if you want to send a bug report, please include the output from the command run with -D2.