Shortcut: SIMPLECUBIC

Module symfunc
Description Usage
Calculate whether or not the coordination spheres of atoms are arranged as they would be in a simple cubic structure. used in 0 tutorialsused in 0 eggs
output value type
the symmetry function for each of the specified atoms vector

Output components

This action can calculate the values in the following table when the associated keyword is included in the input for the action. These values can be referenced elsewhere in the input by using this Action's label followed by a dot and the name of the value required from the list below.

Name Type Keyword Description
lessthan scalar LESS_THAN the number of colvars that have a value less than a threshold
morethan scalar MORE_THAN the number of colvars that have a value more than a threshold
altmin scalar ALT_MIN the minimum value of the cv
min scalar MIN the minimum colvar
max scalar MAX the maximum colvar
between scalar BETWEEN the number of colvars that have a value that lies in a particular interval
highest scalar HIGHEST the largest of the colvars
lowest scalar LOWEST the smallest of the colvars
sum scalar SUM the sum of the colvars
mean scalar MEAN the mean of the colvars

Input

The atoms that serve as the input for this action are specified using one or more of the keywords in the following table.

Keyword Type Description
SPECIES atoms the list of atoms for which the symmetry function is being calculated and the atoms that can be in the environments
SPECIESA atoms the list of atoms for which the symmetry function is being calculated
SPECIESB atoms the list of atoms that can be in the environments of each of the atoms for which the symmetry function is being calculated

Further details and examples

Calculate whether or not the coordination spheres of atoms are arranged as they would be in a simple cubic structure.

This shortcut is an example of a COORDINATION_SHELL_AVERAGE, which we can use to measure how similar the environment around atom i is to a simple cubic structure. We perform this comparison by evaluating the following quantity:

si=ijσ(rij)[x4ij+y4ij+z4ijr4ij]ijσ(rij)

In this expression xij, yij and zij are the x, y and z components of the vector connecting atom i to atom j and rij is the magnitude of this vector. σ(rij) is a switching function that acts on the distance between atom i and atom j and its inclusion in the numerator and the denominator of the above expression as well as the fact that we are summing over all of the other atoms in the system ensures that we are calculating an average of the function of xij, yij and zij for the atoms in the first coordination sphere around atom i. This quantity is once again a multicolvar so you can compute it for multiple atoms using a single PLUMED action and then compute the average value for the atoms in your system, the number of atoms that have an si value that is more that some target and so on. Notice also that you can rotate the reference frame if you are using a non-standard unit cell.

The following input tells plumed to calculate the simple cubic parameter for the atoms 1-100 with themselves. The mean value is then calculated.

Click on the labels of the actions for more information on what each action computes
tested on2.11
SIMPLECUBICCalculate whether or not the coordination spheres of atoms are arranged as they would be in a simple cubic structure. More details SPECIESthe list of atoms for which the symmetry function is being calculated and the atoms that can be in the environments=1-100 R_0The r_0 parameter of the switching function=1.0 MEAN calculate the mean of all the quantities

The following input tells plumed to look at the ways atoms 1-100 are within 3.0 are arranged about atoms from 101-110. The number of simple cubic parameters that are greater than 0.8 is then output

Click on the labels of the actions for more information on what each action computes
tested on2.11
SIMPLECUBICCalculate whether or not the coordination spheres of atoms are arranged as they would be in a simple cubic structure. More details SPECIESAthe list of atoms for which the symmetry function is being calculated=101-110 SPECIESBthe list of atoms that can be in the environments of each of the atoms for which the symmetry function is being calculated=1-100 R_0The r_0 parameter of the switching function=3.0 MORE_THANcalculate the number of variables that are more than a certain target value. Options for this keyword are explained in the documentation for MORE_THAN.={RATIONAL R_0=0.8 NN=6 MM=12 D_0=0}

Notice that you can you can rotate the bond vectors before computing the function in the above expression as is discussed in the documentation for COORDINATION_SHELL_FUNCTION

References

More information about how this action can be used is available in the following articles: - A. D. White, G. A. Voth, Efficient and Minimal Method to Bias Molecular Simulations with Experimental Data. Journal of Chemical Theory and Computation. 10, 3023–3030 (2014) - S. Angioletti-Uberti, M. Ceriotti, P. D. Lee, M. W. Finnis, Solid-liquid interface free energy through metadynamics simulations. Physical Review B. 81 (2010) - B. Cheng, G. A. Tribello, M. Ceriotti, Solid-liquid interfacial free energy out of equilibrium. Physical Review B. 92 (2015) - B. Cheng, G. A. Tribello, M. Ceriotti, The Gibbs free energy of homogeneous nucleation: From atomistic nuclei to the planar limit. The Journal of Chemical Physics. 147 (2017) - B. Cheng, M. Ceriotti, G. A. Tribello, Classical nucleation theory predicts the shape of the nucleus in homogeneous solidification. The Journal of Chemical Physics. 152 (2020)

Syntax

The following table describes the keywords and options that can be used with this action

Keyword Type Default Description
SPECIES input none the list of atoms for which the symmetry function is being calculated and the atoms that can be in the environments
SPECIESA input none the list of atoms for which the symmetry function is being calculated
SPECIESB input none the list of atoms that can be in the environments of each of the atoms for which the symmetry function is being calculated
NN compulsory 6 The n parameter of the switching function
MM compulsory 0 The m parameter of the switching function; 0 implies 2*NN
D_0 compulsory 0.0 The d_0 parameter of the switching function
R_0 compulsory none The r_0 parameter of the switching function
FUNCTION compulsory none the function of the bond vectors that you would like to evaluate
PHI compulsory 0.0 The Euler rotational angle phi
THETA compulsory 0.0 The Euler rotational angle theta
PSI compulsory 0.0 The Euler rotational angle psi
ALPHA compulsory 3.0 The alpha parameter of the angular function that is used for FCCUBIC
SWITCH optional not used the switching function that it used in the construction of the contact matrix. Options for this keyword are explained in the documentation for LESS_THAN.
LESS_THAN optional not used calculate the number of variables that are less than a certain target value. Options for this keyword are explained in the documentation for LESS_THAN.
MORE_THAN optional not used calculate the number of variables that are more than a certain target value. Options for this keyword are explained in the documentation for MORE_THAN.
ALT_MIN optional not used calculate the minimum value
MIN optional not used calculate the minimum value
MAX optional not used calculate the maximum value
BETWEEN optional not used calculate the number of values that are within a certain range. Options for this keyword are explained in the documentation for BETWEEN.
HIGHEST optional false this flag allows you to recover the highest of these variables
HISTOGRAM optional not used calculate a discretized histogram of the distribution of values
LOWEST optional false this flag allows you to recover the lowest of these variables
SUM optional false calculate the sum of all the quantities
MEAN optional false calculate the mean of all the quantities
LOWMEM optional false this flag does nothing and is present only to ensure back-compatibility