Back to main menu

## Program behaviour: verbosity

#### Syntax

`-verbosity <n>`

`-v <n>`

#### Description

This allows you to change the level of verbosity of the program. The integer `<n>` can be set up as:

- 0: silent, no message is ever displayed nor written in log file. Errors, warnings and questions still appear on screen.
- 1: all messages are written on the screen only.
- 2: all messages are written in log file only. Questions, warnings and errors still appear on screen.
- 3: messages are written in log file and on screen.
- 4: debug, some additional messages are written in log file (but not on screen). Beware that in this mode, the program can be much slower, and the log file can be much bigger. This mode should be used only by developers for debugging purposes, and only with systems with a small number of particles.

By default the logfile is `atomsk.log` but you can change it.

When running in interactive mode the verbosity level is automatically reset to 1 if it is set to 0 or 2.

To make this change permanent, you may set up a configuration file.

#### Default

By default the verbosity level is set to 1.

#### Examples

- `atomsk initial.gin initial.cfg -v 3`

  This will write messages both on screen and in the log file `atomsk.log`.

- `atomsk initial.gin initial.cfg -v 0`

  Verbosity level 0 means that Atomsk will not display any message on the screen, except questions, warnings and error messages.

- `atomsk initial.gin initial.cfg -v 0 &>/dev/null`

  Same as previous example, but all messages (including questions, warnings and errors) will be sent to /dev/null, meaning that they won't be displayed at all. Note that questions, although not displayed, will still expect an answer, and therefore will pause the execution of Atomsk. This should be reserved for cases where you are sure that Atomsk will not ask any question.

Back to main menu