# Bond length distribution pro

This modifier computes the distribution of the bond lengths, i.e., the histogram of distances between pairs of particles connected by bonds.

The modifier only includes bonded particles in the distribution, whereas non-bonded pairs will be ignored. Typically, the bond topology is read from the input simulation file or it needs to be generated within OVITO using the Create bonds modifier.

For computing the radial distribution function (RDF), i.e., the histogram of the distances between all pairs of particles, including non-bonded ones, you can use the Radial distribution function (RDF) modifier instead. The Bond angle distribution modifier computes the distribution of angles formed by triplets of bonded particles.

Changed in version 3.15.0: This modifier partially replaces the functionality of the “Bond Analysis” modifier found in earlier program versions.

## Bond length distribution

The bond length histogram ranges from 0 to the cutoff parameter of the modifier. Bonds exceeding the specified length cutoff will not be included in the bond length distribution.

The modifier outputs the bond length histogram as a data table, which can be opened in the pipeline data inspector using the button Show in data inspector.

## Partitioned distributions

The modifier can break the computed distribution down into several partial histograms, one for each combination of bond or particle types. The following partitioning modes are available:

Bond type

  Computes a separate bond length histogram for each individual bond type.

Bond selection

  Treats currently selected bonds and unselected bonds as two different kinds of bonds, thus computing two separate bond length histograms.

Particle type

  Computes separate bond length histograms for each pair-wise combination of particle types. If the number of particle types in the system is \(N\), then the bond length distribution, which involves pairs of particles, will be partitioned into \(N (N+1)/2\) partial distributions.

Particle selection

  Treats currently selected and unselected particles as two different species. Computes three separate bond length histograms: one for bonds connecting two selected particles, one for bonds connecting two unselected particles, and one for bonds connecting one selected and one unselected particle.

## Time-averaged distributions

The Bond length distribution modifier calculates the instantaneous bond length distribution for just one simulation frame at a time. You can subsequently apply the Time averaging modifier to reduce the instantaneous distributions to a single mean distribution by averaging the output data table over all frames of the loaded MD trajectory.

See also

`ovito.modifiers.BondLengthDistributionModifier` (Python API)