Other commands

Commands described in this chapter can not be classified into categories mentioned in previous chapters. Some of them are related to script files.

Command

o.include [!] ['filename'] [ from1 [-to1] [ from2 [-to2] ...] ]

reads and executes commands from file filename. If exclamation mark (!) is present, program is reseted to initial state. Only in this case filename can be omitted. You can specify lines or ranges of lines in file, that are to be read.

Command:

o.log [[i] | [o] | [a]] 'filename'

starts logging to file user input (i), output of program (o) or both of them (a). To stop logging, or to display informations about log file, use command:

o.log [!]

With exclamation mark (!) - it will stop logging, otherwise - display informations.

There is also a command

o.dump 'filename'

that is writing a script, which can be used to restore current state of the program. It is different from logging, and usually output given by logging is easier to read by humans.

Command o.plot controls visualization of data and the sum. It is used to plot given area - in GUI it is plotted in program's main window, in CLI popular program gnuplot is used, if available. Actually there is no reason to type this command in GUI version, because it is very easy to zoom in and zoom out using mouse.

o.plot [xrange [yrange] ]

xrange and yrange have one of two following syntaxes:

{[} [min] : [max] {]}

.

The second is just a dot (.), and it remains appropriate range not changed. It will be explained on examples:

o.plot [20.4:50] [10:20] - plot will show x from 20.4 to 50 and y from 10 to 20
o.plot [20.4:] - x from 20.4 to end of data points, y range will be fitted to contain all data.
o.plot . [:10] - x range will not be changed, lower bound of y range will be a bit smaller than the smallest y coordinate of point in this x range, and upper bound of y range is equal 10.
o.plot [:] [:] - all data will be showed.
o.plot . . - the visible area will not be changed, but information about this area will be printed.
o.plot - the plot will be refreshed.

There is also command in o.plot family, that decides about plotting background:

o.plot {[+] | [-]}

Plus (+) or minus (-) are causing background to be, respectively, added or not to the sum and the data while plotting.

Value of option autoplot changes automatic plotting behaviour. By default, plot is refreshed automatically after changing the data or the sum of functions. It is also possible to visualize every iteration of fitting method by replotting peaks after every iteration.

Value of verbosity option changes amount of text output. Possible values of verbosity and autoplot options can be expanded with TAB in CLI or are visible as a list in GUI.

Command:

o.wait sec

makes program waiting sec seconds, doing nothing.

At last, if option exit-on-warning is set, any warning will close the program. It ensures, that no warnings can be overlooked.