namespace nucleation¶
Overview¶
namespace nucleation {
// enums
enum CommittorFate;
// structs
struct Ascent;
struct CommittorCall;
struct FrameRecord;
struct GrowBasin;
struct HalfRise;
struct Lead;
struct Shift;
// global variables
double kCutoffA = 3.5;
int kRingDepth = 7;
double kQ6BarIceCut = 0.36;
double kQ6SolidCutoffA = 3.2;
double kQ6SolidCut = 0.5;
// global functions
std::vector<double> q6DotScore(const molSys::PointCloud<molSys::Point<double>, double>& cloud, const std::vector<int>& offsets, const std::vector<int>& cols);
FrameRecord analyzeFrame(molSys::PointCloud<molSys::Point<double>, double>& cloud, double cutoff, int ringDepth, int typeI, double q6Cut, int frame);
double stackFraction(int cubic, int hexagonal);
Ascent finalAscent(const std::vector<double>& series);
GrowBasin growBasin(const std::vector<double>& series);
CommittorCall committorOf(const std::vector<double>& series, int molecules);
HalfRise halfRise(const std::vector<double>& series);
Lead ringLead(const std::vector<double>& ringFraction, const std::vector<double>& iceFraction);
Shift definitionShift(int sizeA, int frameA, int sizeB, int frameB);
} // namespace nucleation
Detailed Documentation¶
Global Variables¶
double kCutoffA = 3.5
Published CHILL+ cutoff. Not a fitted parameter.
int kRingDepth = 7
Primitive rings through this size. Depth 7 is the adjacency-row search.
double kQ6BarIceCut = 0.36
Lechner-Dellago \(\bar{q}_6\) above this value is an ice-like environment. Set from the gap between a perfect mW Ic crystal and a liquid reference, not from the nucleation trajectory.
double kQ6SolidCutoffA = 3.2
q6 solid criterion of ten Wolde, Ruiz-Montero and Frenkel, J. Chem. Phys. 104, 9932 (1996), in the mW form of Haji-Akbari and Debenedetti, PNAS 112(34) (2015), doi:10.1073/pnas.1509267112, SI Table S1: neighbours within 3.2 A (the first minimum of the mW g(r)), and a molecule is solid when the mean over its neighbours of the normalised q6(i).q6*(j) exceeds 0.5. The solid cluster is the largest component of solid molecules on the same 3.2 A graph. The Reinhardt chain exclusion is not applied.
Global Functions¶
std::vector<double> q6DotScore(const molSys::PointCloud<molSys::Point<double>, double>& cloud, const std::vector<int>& offsets, const std::vector<int>& cols)
Per-molecule ten Wolde q6 score: the mean over neighbours within cutoff of Re q6(i).q6*(j) / (|q6(i)| |q6(j)|). A molecule without neighbours scores 0. The box is orthorhombic.
FrameRecord analyzeFrame(molSys::PointCloud<molSys::Point<double>, double>& cloud, double cutoff, int ringDepth, int typeI, double q6Cut, int frame)
Label one frame. Leaves iceType as the published CHILL+ label. typeI selects the molecules passed to q6-bar. q6Cut is the ice cut on \(\bar{q}_6\).
double stackFraction(int cubic, int hexagonal)
Cubic / (cubic + hexagonal). Quiet NaN when the denominator is 0.
Lead ringLead(const std::vector<double>& ringFraction, const std::vector<double>& iceFraction)
Ring signal is n6 / (n5 + n6). Ice signal is the ice-like count divided by the molecule count. Both are intensive.
Shift definitionShift(int sizeA, int frameA, int sizeB, int frameB)
How far definition b moves the onset size and the onset frame relative to definition a. dSize = b.size - a.size at each onset.