Coordination analysis

This modifier computes two things for a particle system:
- Coordination numbers
For each particle, it counts the number of surrounding particles within a given cutoff distance. This neighbor count, the so-called coordination number of the particle, is stored in the
Coordination
output property by the modifier. The computed coordination numbers are available to subsequent modifiers in the OVITO data pipeline. For example, you could select all particles having a certain minimum number of neighbors using the Expression selection modifier or visualize the computed coordination numbers using the Color coding modifier.Optionally, the modifier can also compute the coordination numbers separately for each particle type in the system. In this case, the modifier outputs a second property called
Per Type Coordination
, which contains the number of neighbors for each particle, grouped by type of the neighbors. This is useful for analyzing the local structure of multi-component systems, such as alloys or mixtures of different particle species. To enable this feature, check the option Compute partial RDFs described below.- Radial pair distribution function
The modifier also computes the radial pair distribution function (radial PDF, or simply RDF) for the particle system. The radial pair distribution function \(g(r)\) measures the probability of finding a particle at distance \(r\) given that there is a particle at position \(r=0\); it is essentially a histogram of pair-wise particle distances. The pair distribution function is normalized by the average number density of particles (i.e. the total number of particles divided by the simulation cell volume). See the Wikipedia article for more information on this distribution function.
Element-wise RDFs

The option Compute partial RDFs lets the modifier compute separate radial distribution functions for all pair-wise combinations of particle types.
The computed partial RDFs are normalized such that the summation of the partial RDFs, weighted by the product of the two corresponding elemental concentrations, yields the total RDF. For example, for a binary system with two particle species \(\alpha\) and \(\beta\), the modifier computes a set of three partials functions \(g_{\alpha \alpha}\), \(g_{\alpha \beta}\) and \(g_{\beta \beta}\), which add up to the total distribution as follows:
\(g(r) = c_{\alpha}^2 g_{\alpha \alpha}(r) + 2 c_{\alpha} c_{\beta} g_{\alpha \beta}(r) + c_{\beta}^2 g_{\beta \beta}(r)\)
Here, \(c_{\alpha}\) and \(c_{\beta}\) denote the concentrations of the two species in the system and the factor 2 in the mixed term appears due to \(g_{\alpha \beta}(r)\) and \(g_{\beta \alpha}(r)\) being identical.
Tip
By default, the modifier uses the standard Particle Type
property
for classification of particles by species type, but you can select any other available typed property (such as Structure Type
or Atom Name
) from the dropdown menu
to compute partial RDFs based on alternative classifications.
Computing RDF for a subset of particles
The option Use only selected particles restricts the calculation to the currently selected subset of particles.
This is useful if you want to calculate the coordination numbers of the RDF only for a part of the system or certain particle species.
If this option is enabled, unselected particles will be treated as if they did not exist during the calculation. Their Coordination
values will be set to zero,
they will not be counted in the coordination numbers of other particles, and they are ignored in the normalization of the RDF(s).
If the option Compute partial RDFs is enabled too, the modifier will skip element combinations for which no particles are selected, i.e., for which a partial RDF would be zero.
Time-averaged RDF
Note that the modifier calculates the instantaneous RDF for the current simulation frame only and outputs it as a data table, which varies with simulation time. Subsequently, you can use the Time averaging modifier of OVITO to aggregate all per-frame RDFs into one mean RDF, averaging the distribution over all frames of the loaded trajectory.
Bond length distribution
Furthermore, OVITO provides another analysis tool for computing the bond length distribution specifically for bonded pairs of particles: the Bond analysis modifier. This modifier can additionally compute the distribution of bond angles formed by triplets of particles.
See also
ovito.modifiers.CoordinationAnalysisModifier
(Python API)