The distance command adds a distance monitor pseudobond between the specified atoms and labels it with the distance. The current distance is also reported in the Log. The label will update automatically to reflect any changes in distance, but updates are not sent to the Log. For click-to-measure, see selection context menus and mousemode. See also: color, style, size, clashes/contacts, hbonds, crosslinks, label, measurements
Distance-monitor pseudobonds are added to a model named distances, with properties matching the first monitor in the model unless different values are given. The defaults can be changed in the Distances preferences or by using the distance style command with setDefaults true.
Color to use for the pseudobonds (initial default gold).
Radius in Å to use for the pseudobonds (initial default 0.1).
Number of dashes per pseudobond (initial default 9). Only whole numbers are accepted, with 0 indicating solid sticks. Currently, odd numbers are rounded down to give an even number of dashes.
Number of digits after the decimal point (initial default 3); affects all distance monitors and is instantly saved as the default.
symbol true | false
Whether to show the angstrom symbol Å (initial default true); affects all distance monitors and is instantly saved as the default. Distances are assumed to be in Å.
The ~distance command removes any distance monitors between specified atoms, or if nothing is specified, all distance monitors.
The distance style command changes the style of existing distance monitors, and setDefaults true (default false) indicates saving the specified values in the Distances preferences as defaults for subsequently created monitors.
The distance save command writes all current distance information to a text file with pathname distance-file. The word browse can substituted for distance-file to raise a file browser window for specifying the name and location interactively.