Commandline options

Usually, Cuby calculation is run by calling the cuby4 script with a single argument, the name of the input file:

cuby4 input.yaml

Modifying the input

The calculation can be also modified from the commandline, the commandline options override the settings from the input (which is not modified).

The keywords used most often can be accessed with single-letter commandline options, e.g. the option "-g" can be used to specify the geometry:

cuby4 input.yaml -g geometryfile.xyz

The following keywords can be accessed this way:

Value of any keyword (at the root level of the input) can be changed from commandline by using the keyword itslf as an option, prepended with "--". For example, to change the charge of the system, use:

cuby4 input.yaml --charge 1

It is possible to set the value of keywords in specific blocks in the input. For example, to set the keyword charge in block calculation_a, following syntax is used:

cuby4 input.yaml --calculation_a:charge 1

The last feature allows changing the value of a keyword everywhere in the input (only in places where the keyword is already present). This is processed first, before individual changes are made. The syntax is:

cuby4 input.yaml --*:charge 1

Access to documentation

The cuby4 script also provides access to the automatically generated documentation:

cuby4 kw

cuby4 kw commandline

cuby4 kw keyword_name

cuby4 interface

cuby4 inteface interface_name

cuby4 protocol

cuby4 protocol protocol_name

cuby4 method

cuby4 method method_name

Shell

The following commands opens interactive ruby shell (irb) with preloaded cuby libraries:

cuby4 shell

Other tasks

Options --info, --make and --test are described at the installation page.