It is only available if you configure PLUMED with ./configure –enable-modules=symfunc . Furthermore, this feature is still being developed so take care when using it and report any problems on the mailing list.
Calculate the local degree of order around an atoms by taking the average dot product between the q_4 vector on the central atom and the q_4 vector on the atoms in the first coordination sphere.
The Q4 command allows one to calculate one complex vectors for each of the atoms in your system that describe the degree of order in the coordination sphere around a particular atom. The difficulty with these vectors comes when combining the order parameters from all of the individual atoms/molecules so as to get a measure of the global degree of order for the system. The simplest way of doing this - calculating the average Steinhardt parameter - can be problematic. If one is examining nucleation say only the order parameters for those atoms in the nucleus will change significantly when the nucleus forms. The order parameters for the atoms in the surrounding liquid will remain pretty much the same. As such if one models a small nucleus embedded in a very large amount of solution/melt any change in the average order parameter will be negligible. Substantial changes in the value of this average can be observed in simulations of nucleation but only because the number of atoms is relatively small.
When the average Q4 parameter is used to bias the dynamics a problems can occur. These averaged coordinates cannot distinguish between the correct, single-nucleus pathway and a concerted pathway in which all the atoms rearrange themselves into their solid-like configuration simultaneously. This second type of pathway would be impossible in reality because there is a large entropic barrier that prevents concerted processes like this from happening. However, in the finite sized systems that are commonly simulated this barrier is reduced substantially. As a result in simulations where average Steinhardt parameters are biased there are often quite dramatic system size effects
If one wants to simulate nucleation using some form on biased dynamics what is really required is an order parameter that measures:
Whether or not the coordination spheres around atoms are ordered
Whether or not the atoms that are ordered are clustered together in a crystalline nucleus
LOCAL_AVERAGE and NLINKS are variables that can be combined with the Steinhardt parameters allow to calculate variables that satisfy these requirements. LOCAL_Q4 is another variable that can be used in these sorts of calculations. The LOCAL_Q4 parameter for a particular atom is a number that measures the extent to which the orientation of the atoms in the first coordination sphere of an atom match the orientation of the central atom. It does this by calculating the following quantity for each of the atoms in the system:
where \(q_{4m}(i)\) and \(q_{4m}(j)\) are the fourth order Steinhardt vectors calculated for atom \(i\) and atom \(j\) respectively and the asterisk denotes complex conjugation. The function \(\sigma( r_{ij} )\) is a switchingfunction that acts on the distance between atoms \(i\) and \(j\). The parameters of this function should be set so that it the function is equal to one when atom \(j\) is in the first coordination sphere of atom \(i\) and is zero otherwise. The sum in the numerator of this expression is the dot product of the Steinhardt parameters for atoms \(i\) and \(j\) and thus measures the degree to which the orientations of these adjacent atoms is correlated.
Examples
The following command calculates the average value of the LOCAL_Q4 parameter for the 64 Lennard Jones atoms in the system under study and prints this quantity to a file called colvar.
Click on the labels of the actions for more information on what each action computes
q4: Q4SPECIESthis keyword is used for colvars such as coordination number. =1-64 D_0 could not find this keyword =1.3 R_0 could not find this keyword =0.2 The Q4 action with label q4 calculates a single scalar valuelq4: LOCAL_Q4SPECIES=q4SWITCHThis keyword is used if you want to employ an alternative to the continuous swiching
function defined above. ={RATIONAL D_0=1.3 R_0=0.2} MEAN( default=off ) calculate the mean of all the quantities. The LOCAL_Q4 action with label lq4 calculates a single scalar valuePRINTARGcompulsory keyword
the labels of the values that you would like to print to the file =lq4.meanFILEthe name of the file on which to output these quantities =colvar The PRINT action with label
q4_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =1-64 The GROUP action with label q4_grp defines a group of atoms so that they can be referred to later in the inputq4_mat: CONTACT_MATRIXGROUPspecifies the list of atoms that should be assumed indistinguishable. =1-64 R_0 could not find this keyword =0.2 D_0 could not find this keyword =1.3 NNcompulsory keyword ( default=6 )
The n parameter of the switching function =6 MMcompulsory keyword ( default=0 )
The m parameter of the switching function; 0 implies 2*NN =0 COMPONENTS( default=off ) also calculate the components of the vector connecting the atoms
in the contact matrix The CONTACT_MATRIX action with label q4_mat calculates the following quantities:
Quantity
Description
q4_mat.w
a matrix containing the weights for the bonds between each pair of atoms
q4_mat.x
the projection of the bond on the x axis
q4_mat.y
the projection of the bond on the y axis
q4_mat.z
the projection of the bond on the z axis
q4_sh: SPHERICAL_HARMONICARGcompulsory keyword
the values input to this function =q4_mat.x,q4_mat.y,q4_mat.z,q4_mat.wLcompulsory keyword
the value of the angular momentum =4 The SPHERICAL_HARMONIC action with label q4_sh calculates the following quantities:
Quantity
Description
q4_sh.rm-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4_sh.rm-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4_sh.rm-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4_sh.rm-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4_sh.rm-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4_sh.rm-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4_sh.rm-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4_sh.rm-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4_sh.rm-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4_sh.im-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4_sh.im-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4_sh.im-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4_sh.im-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4_sh.im-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4_sh.im-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4_sh.im-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4_sh.im-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4_sh.im-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4_denom_ones: ONESSIZEcompulsory keyword
the number of ones that you would like to create =64 The ONES action with label q4_denom_ones calculates a single scalar valueq4_denom: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4_mat.w,q4_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4_denom calculates a single scalar valueq4_sp: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4_sh.*,q4_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4_sp calculates the following quantities:
Quantity
Description
q4_sp.rm-n4
the product of the matrix q4_sh.rm-n4 and the vector q4_denom_ones
q4_sp.rm-n3
the product of the matrix q4_sh.rm-n3 and the vector q4_denom_ones
q4_sp.rm-n2
the product of the matrix q4_sh.rm-n2 and the vector q4_denom_ones
q4_sp.rm-n1
the product of the matrix q4_sh.rm-n1 and the vector q4_denom_ones
q4_sp.rm-0
the product of the matrix q4_sh.rm-0 and the vector q4_denom_ones
q4_sp.rm-p1
the product of the matrix q4_sh.rm-p1 and the vector q4_denom_ones
q4_sp.rm-p2
the product of the matrix q4_sh.rm-p2 and the vector q4_denom_ones
q4_sp.rm-p3
the product of the matrix q4_sh.rm-p3 and the vector q4_denom_ones
q4_sp.rm-p4
the product of the matrix q4_sh.rm-p4 and the vector q4_denom_ones
q4_sp.im-n4
the product of the matrix q4_sh.im-n4 and the vector q4_denom_ones
q4_sp.im-n3
the product of the matrix q4_sh.im-n3 and the vector q4_denom_ones
q4_sp.im-n2
the product of the matrix q4_sh.im-n2 and the vector q4_denom_ones
q4_sp.im-n1
the product of the matrix q4_sh.im-n1 and the vector q4_denom_ones
q4_sp.im-0
the product of the matrix q4_sh.im-0 and the vector q4_denom_ones
q4_sp.im-p1
the product of the matrix q4_sh.im-p1 and the vector q4_denom_ones
q4_sp.im-p2
the product of the matrix q4_sh.im-p2 and the vector q4_denom_ones
q4_sp.im-p3
the product of the matrix q4_sh.im-p3 and the vector q4_denom_ones
q4_sp.im-p4
the product of the matrix q4_sh.im-p4 and the vector q4_denom_ones
q4_norm2: COMBINEPERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO POWERScompulsory keyword ( default=1.0 )
the powers to which you are raising each of the arguments in your function =2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2 ARGcompulsory keyword
the values input to this function =q4_sp.rm-n4,q4_sp.im-n4,q4_sp.rm-n3,q4_sp.im-n3,q4_sp.rm-n2,q4_sp.im-n2,q4_sp.rm-n1,q4_sp.im-n1,q4_sp.rm-0,q4_sp.im-0,q4_sp.rm-p1,q4_sp.im-p1,q4_sp.rm-p2,q4_sp.im-p2,q4_sp.rm-p3,q4_sp.im-p3,q4_sp.rm-p4,q4_sp.im-p4The COMBINE action with label q4_norm2 calculates a single scalar valueq4_norm: CUSTOMARGcompulsory keyword
the values input to this function =q4_norm2FUNCcompulsory keyword
the function you wish to evaluate =sqrt(x) PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4_norm calculates a single scalar valueq4: CUSTOMARGcompulsory keyword
the values input to this function =q4_norm,q4_denomFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4 calculates a single scalar valuelq4_uvec: ONESSIZEcompulsory keyword
the number of ones that you would like to create =18 The ONES action with label lq4_uvec calculates a single scalar valuelq4_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =q4The GROUP action with label lq4_grp defines a group of atoms so that they can be referred to later in the inputlq4_nmat: OUTER_PRODUCTARGcompulsory keyword
the labels of the two vectors from which the outer product is being computed =q4_norm,lq4_uvecThe OUTER_PRODUCT action with label lq4_nmat calculates a single scalar valuelq4_uvecs: VSTACKARGcompulsory keyword
the values that you would like to stack together to construct the output matrix =q4_sp.rm-n4,q4_sp.im-n4,q4_sp.rm-n3,q4_sp.im-n3,q4_sp.rm-n2,q4_sp.im-n2,q4_sp.rm-n1,q4_sp.im-n1,q4_sp.rm-0,q4_sp.im-0,q4_sp.rm-p1,q4_sp.im-p1,q4_sp.rm-p2,q4_sp.im-p2,q4_sp.rm-p3,q4_sp.im-p3,q4_sp.rm-p4,q4_sp.im-p4The VSTACK action with label lq4_uvecs calculates a single scalar valuelq4_vecs: CUSTOMARGcompulsory keyword
the values input to this function =lq4_uvecs,lq4_nmatFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label lq4_vecs calculates a single scalar valuelq4_vecsT: TRANSPOSEARGcompulsory keyword
the label of the vector or matrix that should be transposed =lq4_vecsThe TRANSPOSE action with label lq4_vecsT calculates a single scalar valuelq4_cmap: CONTACT_MATRIXGROUPspecifies the list of atoms that should be assumed indistinguishable. =q4SWITCHspecify the switching function to use between two sets of indistinguishable atoms.
=RATIONAL,D_0=1.3,R_0=0.2 The CONTACT_MATRIX action with label lq4_cmap
The following input calculates the distribution of LOCAL_Q4 parameters at any given time and outputs this information to a file.
Click on the labels of the actions for more information on what each action computes
q4: Q4SPECIESthis keyword is used for colvars such as coordination number. =1-64 D_0 could not find this keyword =1.3 R_0 could not find this keyword =0.2 The Q4 action with label q4 calculates a single scalar valuelq4: LOCAL_Q4SPECIES=q4SWITCHThis keyword is used if you want to employ an alternative to the continuous swiching
function defined above. ={RATIONAL D_0=1.3 R_0=0.2} HISTOGRAMcalculate a discretized histogram of the distribution of values. ={GAUSSIAN LOWER=0.0 UPPER=1.0 NBINS=20 SMEAR=0.1} The LOCAL_Q4 action with label lq4 calculates a single scalar valuePRINTARGcompulsory keyword
the labels of the values that you would like to print to the file =lq4.*FILEthe name of the file on which to output these quantities =colvar The PRINT action with label
q4_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =1-64 The GROUP action with label q4_grp defines a group of atoms so that they can be referred to later in the inputq4_mat: CONTACT_MATRIXGROUPspecifies the list of atoms that should be assumed indistinguishable. =1-64 R_0 could not find this keyword =0.2 D_0 could not find this keyword =1.3 NNcompulsory keyword ( default=6 )
The n parameter of the switching function =6 MMcompulsory keyword ( default=0 )
The m parameter of the switching function; 0 implies 2*NN =0 COMPONENTS( default=off ) also calculate the components of the vector connecting the atoms
in the contact matrix The CONTACT_MATRIX action with label q4_mat calculates the following quantities:
Quantity
Description
q4_mat.w
a matrix containing the weights for the bonds between each pair of atoms
q4_mat.x
the projection of the bond on the x axis
q4_mat.y
the projection of the bond on the y axis
q4_mat.z
the projection of the bond on the z axis
q4_sh: SPHERICAL_HARMONICARGcompulsory keyword
the values input to this function =q4_mat.x,q4_mat.y,q4_mat.z,q4_mat.wLcompulsory keyword
the value of the angular momentum =4 The SPHERICAL_HARMONIC action with label q4_sh calculates the following quantities:
Quantity
Description
q4_sh.rm-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4_sh.rm-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4_sh.rm-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4_sh.rm-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4_sh.rm-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4_sh.rm-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4_sh.rm-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4_sh.rm-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4_sh.rm-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4_sh.im-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4_sh.im-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4_sh.im-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4_sh.im-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4_sh.im-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4_sh.im-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4_sh.im-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4_sh.im-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4_sh.im-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4_denom_ones: ONESSIZEcompulsory keyword
the number of ones that you would like to create =64 The ONES action with label q4_denom_ones calculates a single scalar valueq4_denom: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4_mat.w,q4_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4_denom calculates a single scalar valueq4_sp: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4_sh.*,q4_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4_sp calculates the following quantities:
Quantity
Description
q4_sp.rm-n4
the product of the matrix q4_sh.rm-n4 and the vector q4_denom_ones
q4_sp.rm-n3
the product of the matrix q4_sh.rm-n3 and the vector q4_denom_ones
q4_sp.rm-n2
the product of the matrix q4_sh.rm-n2 and the vector q4_denom_ones
q4_sp.rm-n1
the product of the matrix q4_sh.rm-n1 and the vector q4_denom_ones
q4_sp.rm-0
the product of the matrix q4_sh.rm-0 and the vector q4_denom_ones
q4_sp.rm-p1
the product of the matrix q4_sh.rm-p1 and the vector q4_denom_ones
q4_sp.rm-p2
the product of the matrix q4_sh.rm-p2 and the vector q4_denom_ones
q4_sp.rm-p3
the product of the matrix q4_sh.rm-p3 and the vector q4_denom_ones
q4_sp.rm-p4
the product of the matrix q4_sh.rm-p4 and the vector q4_denom_ones
q4_sp.im-n4
the product of the matrix q4_sh.im-n4 and the vector q4_denom_ones
q4_sp.im-n3
the product of the matrix q4_sh.im-n3 and the vector q4_denom_ones
q4_sp.im-n2
the product of the matrix q4_sh.im-n2 and the vector q4_denom_ones
q4_sp.im-n1
the product of the matrix q4_sh.im-n1 and the vector q4_denom_ones
q4_sp.im-0
the product of the matrix q4_sh.im-0 and the vector q4_denom_ones
q4_sp.im-p1
the product of the matrix q4_sh.im-p1 and the vector q4_denom_ones
q4_sp.im-p2
the product of the matrix q4_sh.im-p2 and the vector q4_denom_ones
q4_sp.im-p3
the product of the matrix q4_sh.im-p3 and the vector q4_denom_ones
q4_sp.im-p4
the product of the matrix q4_sh.im-p4 and the vector q4_denom_ones
q4_norm2: COMBINEPERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO POWERScompulsory keyword ( default=1.0 )
the powers to which you are raising each of the arguments in your function =2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2 ARGcompulsory keyword
the values input to this function =q4_sp.rm-n4,q4_sp.im-n4,q4_sp.rm-n3,q4_sp.im-n3,q4_sp.rm-n2,q4_sp.im-n2,q4_sp.rm-n1,q4_sp.im-n1,q4_sp.rm-0,q4_sp.im-0,q4_sp.rm-p1,q4_sp.im-p1,q4_sp.rm-p2,q4_sp.im-p2,q4_sp.rm-p3,q4_sp.im-p3,q4_sp.rm-p4,q4_sp.im-p4The COMBINE action with label q4_norm2 calculates a single scalar valueq4_norm: CUSTOMARGcompulsory keyword
the values input to this function =q4_norm2FUNCcompulsory keyword
the function you wish to evaluate =sqrt(x) PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4_norm calculates a single scalar valueq4: CUSTOMARGcompulsory keyword
the values input to this function =q4_norm,q4_denomFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4 calculates a single scalar valuelq4_uvec: ONESSIZEcompulsory keyword
the number of ones that you would like to create =18 The ONES action with label lq4_uvec calculates a single scalar valuelq4_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =q4The GROUP action with label lq4_grp defines a group of atoms so that they can be referred to later in the inputlq4_nmat: OUTER_PRODUCTARGcompulsory keyword
the labels of the two vectors from which the outer product is being computed =q4_norm,lq4_uvecThe OUTER_PRODUCT action with label lq4_nmat calculates a single scalar valuelq4_uvecs: VSTACKARGcompulsory keyword
the values that you would like to stack together to construct the output matrix =q4_sp.rm-n4,q4_sp.im-n4,q4_sp.rm-n3,q4_sp.im-n3,q4_sp.rm-n2,q4_sp.im-n2,q4_sp.rm-n1,q4_sp.im-n1,q4_sp.rm-0,q4_sp.im-0,q4_sp.rm-p1,q4_sp.im-p1,q4_sp.rm-p2,q4_sp.im-p2,q4_sp.rm-p3,q4_sp.im-p3,q4_sp.rm-p4,q4_sp.im-p4The VSTACK action with label lq4_uvecs calculates a single scalar valuelq4_vecs: CUSTOMARGcompulsory keyword
the values input to this function =lq4_uvecs,lq4_nmatFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label lq4_vecs calculates a single scalar valuelq4_vecsT: TRANSPOSEARGcompulsory keyword
the label of the vector or matrix that should be transposed =lq4_vecsThe TRANSPOSE action with label lq4_vecsT calculates a single scalar valuelq4_cmap: CONTACT_MATRIXGROUPspecifies the list of atoms that should be assumed indistinguishable. =q4SWITCHspecify the switching function to use between two sets of indistinguishable atoms.
=RATIONAL,D_0=1.3,R_0=0.2 The CONTACT_MATRIX action with label lq4_cmap
The following calculates the LOCAL_Q4 parameters for atoms 1-5 only. For each of these atoms comparisons of the geometry of the coordination sphere are done with those of all the other atoms in the system. The final quantity is the average and is outputted to a file
Click on the labels of the actions for more information on what each action computes
q4a: Q4SPECIESAthis keyword is used for colvars such as the coordination number. =1-5 SPECIESBthis keyword is used for colvars such as the coordination number. =1-64 D_0 could not find this keyword =1.3 R_0 could not find this keyword =0.2 The Q4 action with label q4a calculates a single scalar valueq4b: Q4SPECIESAthis keyword is used for colvars such as the coordination number. =6-64 SPECIESBthis keyword is used for colvars such as the coordination number. =1-64 D_0 could not find this keyword =1.3 R_0 could not find this keyword =0.2 The Q4 action with label q4b calculates a single scalar valuew4: LOCAL_Q4SPECIES=q4a,q4bSWITCHThis keyword is used if you want to employ an alternative to the continuous swiching
function defined above. ={RATIONAL D_0=1.3 R_0=0.2} MEAN( default=off ) calculate the mean of all the quantities. LOWMEM( default=off ) this flag does nothing and is present only to ensure back-compatibility
The LOCAL_Q4 action with label w4 calculates a single scalar valuePRINTARGcompulsory keyword
the labels of the values that you would like to print to the file =w4.*FILEthe name of the file on which to output these quantities =colvar The PRINT action with label
q4a_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =1-5 The GROUP action with label q4a_grp defines a group of atoms so that they can be referred to later in the inputq4a_mat: CONTACT_MATRIXGROUPA. =1-5 GROUPB. =1-64 R_0 could not find this keyword =0.2 D_0 could not find this keyword =1.3 NNcompulsory keyword ( default=6 )
The n parameter of the switching function =6 MMcompulsory keyword ( default=0 )
The m parameter of the switching function; 0 implies 2*NN =0 COMPONENTS( default=off ) also calculate the components of the vector connecting the atoms
in the contact matrix The CONTACT_MATRIX action with label q4a_mat calculates the following quantities:
Quantity
Description
q4a_mat.w
a matrix containing the weights for the bonds between each pair of atoms
q4a_mat.x
the projection of the bond on the x axis
q4a_mat.y
the projection of the bond on the y axis
q4a_mat.z
the projection of the bond on the z axis
q4a_sh: SPHERICAL_HARMONICARGcompulsory keyword
the values input to this function =q4a_mat.x,q4a_mat.y,q4a_mat.z,q4a_mat.wLcompulsory keyword
the value of the angular momentum =4 The SPHERICAL_HARMONIC action with label q4a_sh calculates the following quantities:
Quantity
Description
q4a_sh.rm-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4a_sh.rm-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4a_sh.rm-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4a_sh.rm-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4a_sh.rm-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4a_sh.rm-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4a_sh.rm-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4a_sh.rm-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4a_sh.rm-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4a_sh.im-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4a_sh.im-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4a_sh.im-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4a_sh.im-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4a_sh.im-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4a_sh.im-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4a_sh.im-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4a_sh.im-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4a_sh.im-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4a_denom_ones: ONESSIZEcompulsory keyword
the number of ones that you would like to create =64 The ONES action with label q4a_denom_ones calculates a single scalar valueq4a_denom: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4a_mat.w,q4a_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4a_denom calculates a single scalar valueq4a_sp: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4a_sh.*,q4a_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4a_sp calculates the following quantities:
Quantity
Description
q4a_sp.rm-n4
the product of the matrix q4a_sh.rm-n4 and the vector q4a_denom_ones
q4a_sp.rm-n3
the product of the matrix q4a_sh.rm-n3 and the vector q4a_denom_ones
q4a_sp.rm-n2
the product of the matrix q4a_sh.rm-n2 and the vector q4a_denom_ones
q4a_sp.rm-n1
the product of the matrix q4a_sh.rm-n1 and the vector q4a_denom_ones
q4a_sp.rm-0
the product of the matrix q4a_sh.rm-0 and the vector q4a_denom_ones
q4a_sp.rm-p1
the product of the matrix q4a_sh.rm-p1 and the vector q4a_denom_ones
q4a_sp.rm-p2
the product of the matrix q4a_sh.rm-p2 and the vector q4a_denom_ones
q4a_sp.rm-p3
the product of the matrix q4a_sh.rm-p3 and the vector q4a_denom_ones
q4a_sp.rm-p4
the product of the matrix q4a_sh.rm-p4 and the vector q4a_denom_ones
q4a_sp.im-n4
the product of the matrix q4a_sh.im-n4 and the vector q4a_denom_ones
q4a_sp.im-n3
the product of the matrix q4a_sh.im-n3 and the vector q4a_denom_ones
q4a_sp.im-n2
the product of the matrix q4a_sh.im-n2 and the vector q4a_denom_ones
q4a_sp.im-n1
the product of the matrix q4a_sh.im-n1 and the vector q4a_denom_ones
q4a_sp.im-0
the product of the matrix q4a_sh.im-0 and the vector q4a_denom_ones
q4a_sp.im-p1
the product of the matrix q4a_sh.im-p1 and the vector q4a_denom_ones
q4a_sp.im-p2
the product of the matrix q4a_sh.im-p2 and the vector q4a_denom_ones
q4a_sp.im-p3
the product of the matrix q4a_sh.im-p3 and the vector q4a_denom_ones
q4a_sp.im-p4
the product of the matrix q4a_sh.im-p4 and the vector q4a_denom_ones
q4a_norm2: COMBINEPERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO POWERScompulsory keyword ( default=1.0 )
the powers to which you are raising each of the arguments in your function =2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2 ARGcompulsory keyword
the values input to this function =q4a_sp.rm-n4,q4a_sp.im-n4,q4a_sp.rm-n3,q4a_sp.im-n3,q4a_sp.rm-n2,q4a_sp.im-n2,q4a_sp.rm-n1,q4a_sp.im-n1,q4a_sp.rm-0,q4a_sp.im-0,q4a_sp.rm-p1,q4a_sp.im-p1,q4a_sp.rm-p2,q4a_sp.im-p2,q4a_sp.rm-p3,q4a_sp.im-p3,q4a_sp.rm-p4,q4a_sp.im-p4The COMBINE action with label q4a_norm2 calculates a single scalar valueq4a_norm: CUSTOMARGcompulsory keyword
the values input to this function =q4a_norm2FUNCcompulsory keyword
the function you wish to evaluate =sqrt(x) PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4a_norm calculates a single scalar valueq4a: CUSTOMARGcompulsory keyword
the values input to this function =q4a_norm,q4a_denomFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4a calculates a single scalar valueq4b_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =6-64 The GROUP action with label q4b_grp defines a group of atoms so that they can be referred to later in the inputq4b_mat: CONTACT_MATRIXGROUPA. =6-64 GROUPB. =1-64 R_0 could not find this keyword =0.2 D_0 could not find this keyword =1.3 NNcompulsory keyword ( default=6 )
The n parameter of the switching function =6 MMcompulsory keyword ( default=0 )
The m parameter of the switching function; 0 implies 2*NN =0 COMPONENTS( default=off ) also calculate the components of the vector connecting the atoms
in the contact matrix The CONTACT_MATRIX action with label q4b_mat calculates the following quantities:
Quantity
Description
q4b_mat.w
a matrix containing the weights for the bonds between each pair of atoms
q4b_mat.x
the projection of the bond on the x axis
q4b_mat.y
the projection of the bond on the y axis
q4b_mat.z
the projection of the bond on the z axis
q4b_sh: SPHERICAL_HARMONICARGcompulsory keyword
the values input to this function =q4b_mat.x,q4b_mat.y,q4b_mat.z,q4b_mat.wLcompulsory keyword
the value of the angular momentum =4 The SPHERICAL_HARMONIC action with label q4b_sh calculates the following quantities:
Quantity
Description
q4b_sh.rm-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4b_sh.rm-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4b_sh.rm-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4b_sh.rm-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4b_sh.rm-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4b_sh.rm-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4b_sh.rm-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4b_sh.rm-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4b_sh.rm-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4b_sh.im-n4
the real parts of the spherical harmonic values with the m value given This is the n4th of these quantities
q4b_sh.im-n3
the real parts of the spherical harmonic values with the m value given This is the n3th of these quantities
q4b_sh.im-n2
the real parts of the spherical harmonic values with the m value given This is the n2th of these quantities
q4b_sh.im-n1
the real parts of the spherical harmonic values with the m value given This is the n1th of these quantities
q4b_sh.im-0
the real parts of the spherical harmonic values with the m value given This is the 0th of these quantities
q4b_sh.im-p1
the real parts of the spherical harmonic values with the m value given This is the p1th of these quantities
q4b_sh.im-p2
the real parts of the spherical harmonic values with the m value given This is the p2th of these quantities
q4b_sh.im-p3
the real parts of the spherical harmonic values with the m value given This is the p3th of these quantities
q4b_sh.im-p4
the real parts of the spherical harmonic values with the m value given This is the p4th of these quantities
q4b_denom_ones: ONESSIZEcompulsory keyword
the number of ones that you would like to create =64 The ONES action with label q4b_denom_ones calculates a single scalar valueq4b_denom: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4b_mat.w,q4b_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4b_denom calculates a single scalar valueq4b_sp: MATRIX_VECTOR_PRODUCTARGcompulsory keyword
the label for the matrix and the vector/scalar that are being multiplied. =q4b_sh.*,q4b_denom_onesThe MATRIX_VECTOR_PRODUCT action with label q4b_sp calculates the following quantities:
Quantity
Description
q4b_sp.rm-n4
the product of the matrix q4b_sh.rm-n4 and the vector q4b_denom_ones
q4b_sp.rm-n3
the product of the matrix q4b_sh.rm-n3 and the vector q4b_denom_ones
q4b_sp.rm-n2
the product of the matrix q4b_sh.rm-n2 and the vector q4b_denom_ones
q4b_sp.rm-n1
the product of the matrix q4b_sh.rm-n1 and the vector q4b_denom_ones
q4b_sp.rm-0
the product of the matrix q4b_sh.rm-0 and the vector q4b_denom_ones
q4b_sp.rm-p1
the product of the matrix q4b_sh.rm-p1 and the vector q4b_denom_ones
q4b_sp.rm-p2
the product of the matrix q4b_sh.rm-p2 and the vector q4b_denom_ones
q4b_sp.rm-p3
the product of the matrix q4b_sh.rm-p3 and the vector q4b_denom_ones
q4b_sp.rm-p4
the product of the matrix q4b_sh.rm-p4 and the vector q4b_denom_ones
q4b_sp.im-n4
the product of the matrix q4b_sh.im-n4 and the vector q4b_denom_ones
q4b_sp.im-n3
the product of the matrix q4b_sh.im-n3 and the vector q4b_denom_ones
q4b_sp.im-n2
the product of the matrix q4b_sh.im-n2 and the vector q4b_denom_ones
q4b_sp.im-n1
the product of the matrix q4b_sh.im-n1 and the vector q4b_denom_ones
q4b_sp.im-0
the product of the matrix q4b_sh.im-0 and the vector q4b_denom_ones
q4b_sp.im-p1
the product of the matrix q4b_sh.im-p1 and the vector q4b_denom_ones
q4b_sp.im-p2
the product of the matrix q4b_sh.im-p2 and the vector q4b_denom_ones
q4b_sp.im-p3
the product of the matrix q4b_sh.im-p3 and the vector q4b_denom_ones
q4b_sp.im-p4
the product of the matrix q4b_sh.im-p4 and the vector q4b_denom_ones
q4b_norm2: COMBINEPERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO POWERScompulsory keyword ( default=1.0 )
the powers to which you are raising each of the arguments in your function =2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2 ARGcompulsory keyword
the values input to this function =q4b_sp.rm-n4,q4b_sp.im-n4,q4b_sp.rm-n3,q4b_sp.im-n3,q4b_sp.rm-n2,q4b_sp.im-n2,q4b_sp.rm-n1,q4b_sp.im-n1,q4b_sp.rm-0,q4b_sp.im-0,q4b_sp.rm-p1,q4b_sp.im-p1,q4b_sp.rm-p2,q4b_sp.im-p2,q4b_sp.rm-p3,q4b_sp.im-p3,q4b_sp.rm-p4,q4b_sp.im-p4The COMBINE action with label q4b_norm2 calculates a single scalar valueq4b_norm: CUSTOMARGcompulsory keyword
the values input to this function =q4b_norm2FUNCcompulsory keyword
the function you wish to evaluate =sqrt(x) PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4b_norm calculates a single scalar valueq4b: CUSTOMARGcompulsory keyword
the values input to this function =q4b_norm,q4b_denomFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label q4b calculates a single scalar valuew4_uvec: ONESSIZEcompulsory keyword
the number of ones that you would like to create =18 The ONES action with label w4_uvec calculates a single scalar valuew4_grp: GROUPATOMSthe numerical indexes for the set of atoms in the group. =q4a,q4bThe GROUP action with label w4_grp defines a group of atoms so that they can be referred to later in the inputw4_mags: CONCATENATEARGthe values that should be concatenated together to form the output vector =q4a_norm,q4b_normThe CONCATENATE action with label w4_mags calculates a single scalar valuew4_uvecs1: VSTACKARGcompulsory keyword
the values that you would like to stack together to construct the output matrix =q4a_sp.rm-n4,q4a_sp.im-n4,q4a_sp.rm-n3,q4a_sp.im-n3,q4a_sp.rm-n2,q4a_sp.im-n2,q4a_sp.rm-n1,q4a_sp.im-n1,q4a_sp.rm-0,q4a_sp.im-0,q4a_sp.rm-p1,q4a_sp.im-p1,q4a_sp.rm-p2,q4a_sp.im-p2,q4a_sp.rm-p3,q4a_sp.im-p3,q4a_sp.rm-p4,q4a_sp.im-p4The VSTACK action with label w4_uvecs1 calculates a single scalar valuew4_uvecs2: VSTACKARGcompulsory keyword
the values that you would like to stack together to construct the output matrix =q4b_sp.rm-n4,q4b_sp.im-n4,q4b_sp.rm-n3,q4b_sp.im-n3,q4b_sp.rm-n2,q4b_sp.im-n2,q4b_sp.rm-n1,q4b_sp.im-n1,q4b_sp.rm-0,q4b_sp.im-0,q4b_sp.rm-p1,q4b_sp.im-p1,q4b_sp.rm-p2,q4b_sp.im-p2,q4b_sp.rm-p3,q4b_sp.im-p3,q4b_sp.rm-p4,q4b_sp.im-p4The VSTACK action with label w4_uvecs2 calculates a single scalar valuew4_nmat: OUTER_PRODUCTARGcompulsory keyword
the labels of the two vectors from which the outer product is being computed =w4_mags,w4_uvecThe OUTER_PRODUCT action with label w4_nmat calculates a single scalar valuew4_uvecs: CONCATENATEMATRIX11compulsory keyword
specify the matrices that you wish to join together into a single matrix. =w4_uvecs1MATRIX21compulsory keyword
specify the matrices that you wish to join together into a single matrix. =w4_uvecs2The CONCATENATE action with label w4_uvecs calculates a single scalar valuew4_vecs: CUSTOMARGcompulsory keyword
the values input to this function =w4_uvecs,w4_nmatFUNCcompulsory keyword
the function you wish to evaluate =x/y PERIODICcompulsory keyword
if the output of your function is periodic then you should specify the periodicity
of the function. =NO The CUSTOM action with label w4_vecs calculates a single scalar valuew4_vecsT: TRANSPOSEARGcompulsory keyword
the label of the vector or matrix that should be transposed =w4_vecsThe TRANSPOSE action with label w4_vecsT calculates a single scalar valuew4_cmap: CONTACT_MATRIXGROUPspecifies the list of atoms that should be assumed indistinguishable. =q4a,q4bSWITCHspecify the switching function to use between two sets of indistinguishable atoms.
=RATIONAL,D_0=1.3,R_0=0.2 The CONTACT_MATRIX action with label w4_cmap
Glossary of keywords and components
Description of components
Quantity
Description
.#!value
the values of the local steinhardt parameters for the input atoms
In addition the following quantities can be calculated by employing the keywords listed below
Quantity
Keyword
Description
lessthan
LESS_THAN
the number of colvars that have a value less than a threshold
morethan
MORE_THAN
the number of colvars that have a value more than a threshold
altmin
ALT_MIN
the minimum value of the cv
min
MIN
the minimum colvar
max
MAX
the maximum colvar
between
BETWEEN
the number of colvars that have a value that lies in a particular interval
highest
HIGHEST
the largest of the colvars
lowest
LOWEST
the smallest of the colvars
sum
SUM
the sum of the colvars
mean
MEAN
the mean of the colvars
Options
LOWMEM
( default=off ) this flag does nothing and is present only to ensure back-compatibility
HIGHEST
( default=off ) this flag allows you to recover the highest of these variables.
LOWEST
( default=off ) this flag allows you to recover the lowest of these variables.
SUM
( default=off ) calculate the sum of all the quantities.
MEAN
( default=off ) calculate the mean of all the quantities.
SPECIES
SPECIESA
SPECIESB
SWITCH
This keyword is used if you want to employ an alternative to the continuous swiching function defined above. The following provides information on the switchingfunction that are available. When this keyword is present you no longer need the NN, MM, D_0 and R_0 keywords.
LESS_THAN
calculate the number of variables that are less than a certain target value. This quantity is calculated using \(\sum_i \sigma(s_i)\), where \(\sigma(s)\) is a switchingfunction.. You can use multiple instances of this keyword i.e. LESS_THAN1, LESS_THAN2, LESS_THAN3...
MORE_THAN
calculate the number of variables that are more than a certain target value. This quantity is calculated using \(\sum_i 1 - \sigma(s_i)\), where \(\sigma(s)\) is a switchingfunction.. You can use multiple instances of this keyword i.e. MORE_THAN1, MORE_THAN2, MORE_THAN3...
ALT_MIN
calculate the minimum value. To make this quantity continuous the minimum is calculated using \( \textrm{min} = -\frac{1}{\beta} \log \sum_i \exp\left( -\beta s_i \right) \) The value of \(\beta\) in this function is specified using (BETA= \(\beta\)).
MIN
calculate the minimum value. To make this quantity continuous the minimum is calculated using \( \textrm{min} = \frac{\beta}{ \log \sum_i \exp\left( \frac{\beta}{s_i} \right) } \) The value of \(\beta\) in this function is specified using (BETA= \(\beta\))
MAX
calculate the maximum value. To make this quantity continuous the maximum is calculated using \( \textrm{max} = \beta \log \sum_i \exp\left( \frac{s_i}{\beta}\right) \) The value of \(\beta\) in this function is specified using (BETA= \(\beta\))
BETWEEN
calculate the number of values that are within a certain range. These quantities are calculated using kernel density estimation as described on histogrambead.. You can use multiple instances of this keyword i.e. BETWEEN1, BETWEEN2, BETWEEN3...
HISTOGRAM
calculate a discretized histogram of the distribution of values. This shortcut allows you to calculates NBIN quantites like BETWEEN.