Bonds

../../../_images/bonds_panel.jpg

This visual element controls how bonds between pairs of particles are rendered as cylindrical connections.

Bonds are either loaded from the simulation file as part of the model, or they can be created within OVITO by the Create bonds modifier. Alternatively, the Voronoi analysis modifier can generate bonds between nearest neighbor particles.

Parameters

Appearance

These settings control the geometric representation of bonds:

Bond width

Controls the uniform display diameter of bond cylinders (default: 0.4 distance units). This value is used for all bonds unless overridden by the per-bond Width property. The width is specified in simulation units of length.

Flat shading

When enabled, bonds are rendered with flat shading to create the look of thick lines connecting particles. When disabled (default), bonds use smooth shading for a more realistic cylindrical appearance.

Coloring

The color of bonds is determined through a priority hierarchy. The coloring mode selector controls which method is used when explicit per-bond colors are not present:

By bond type

Colors bonds according to their Bond Type property value. Each bond type can have a unique color assigned through the Edit types modifier.

By particle

Bonds adopt colors from the particles they connect. Each bond is rendered as two half-cylinders, with each half colored according to its connected particle.

Uniform color

All bonds are rendered using the same color specified by the color selector (default: gray).

All these options are disabled when the Color per-bond property is defined, which always takes precedence.

Note

To set explicit colors for individual bonds, use the Compute property or Color coding modifiers to set the Color bond property. Once this property exists, it takes precedence over all coloring mode options.

Fractional Bonds

Fractional bonds (i.e., non-integer Bond Order property values) are visualized as dashed cylinders instead of solid ones. Note that only the fractional part of the bond order is rendered as dashes. For example, a bond order of 1.5 is rendered as one solid bond and one dashed bond.

Number of filled segments

Controls the number of dashes making up each fractional bond.

Filled segment fraction

Controls the length of the filled dashes, where a greater value results in longer dashes.

Additional bond properties

The visualization can additionally be affected by certain properties of the bonds themselves, listed in the following table.

Bond property

Data type

Description

Color

Real (R,G,B)

Explicit RGB color for individual bonds. Red, green, and blue components must be in the range [0,1].

Width

Real

Controls the display diameter of individual bonds.

Transparency

Real

Controls the transparency of individual bonds. Must be in the range [0,1].

Selection

Integer

Marks currently selected bonds (1 = selected, 0 = unselected). Selected bonds are highlighted in red (only in interactive viewports but not in rendered images).

Bond Order

Real

Controls the number of cylinders used to render a bond. Bond orders in the range (1,3] are displayed as multiple cylinders next to each other. Bond orders greater than 3 are rendered as a single cylinder.

To see the list of bond properties present in your dataset, open the data inspector panel.

See also

ovito.vis.BondsVis (Python API)