|
seams-core v2.14.0
libyodaLib, the C++ engine of d-SEAMS
|
Defines RDF-specific functions. More...
Functions | |
| int | rdf2Danalysis_AA (std::string path, std::vector< double > &rdfValues, const molSys::PointCloud< molSys::Point< double >, double > &yCloud, double cutoff, double binwidth, int firstFrame, int finalFrame) |
| std::vector< int > | sampleRDF_AA (const molSys::PointCloud< molSys::Point< double >, double > &yCloud, double cutoff, double binwidth, int nbin) |
| Samples the RDF histogram at every step. | |
| int | normalizeRDF (int nopA, std::vector< double > &rdfValues, std::vector< int > histogram, double binwidth, int nbin, std::vector< double > volumeLengths, int nIter) |
| Normalize the histogram. | |
| std::vector< double > | getSystemLengths (const molSys::PointCloud< molSys::Point< double >, double > &yCloud) |
| double | getPlaneArea (std::vector< double > volumeLengths) |
| Gets the plane area from the volume lengths vector. | |
Defines RDF-specific functions.
The radial distribution function \(g(r)\), or pair distribution function. It can be used to illuminate features of short-range and long-range order. The RDF is the probability of finding a particle at a distance of \(r\) from a tagged reference particle, relative to that of an ideal gas. For a system of \(N\) particles, the pair correlation function for \(N(N-1)\) pairs is:
\[ \rho_N^{(2)}(r,r') = ⟨\sum_{i=1}^{N} \sum_{j=1,j \neq i}^{N} \delta (r-r_i) \delta (r'-r_j) \langle \]
The code essentially bins distances between pairs of particles, and normalizes the resulting histogram is normalized with respect to an ideal gas. The algorithm for the calculation of \(g(r)\) may be divided into the following steps:
To account for the geometry of the slab-like quasi-two-dimensional system, the RDF must be additionally normalized by a form factor \(f\) such that \(f = 1 - \frac{r}{2h}\) for \(r \le h\) and \(f = \frac{h}{2r}\) for \(r > h\); where \(h\) is the height of the quasi-two-dimensional system. That is what rdf2::normalizeRDF implements.
| double rdf2::getPlaneArea | ( | std::vector< double > | volumeLengths | ) |
Gets the plane area from the volume lengths vector.
| std::vector< double > rdf2::getSystemLengths | ( | const molSys::PointCloud< molSys::Point< double >, double > & | yCloud | ) |
Gets the lengths of the volume slice of the quasi-two-dimensional system. box.size()>=6 returns dump H {lx, ly, lz}; a length-3 box stays the particle AABB so slab tests keep the occupied extents.
|
nodiscard |
Normalize the histogram.
|
nodiscard |
Main function for calculating the RDF for the same type of particle: calls other functions for initializing, sampling and normalizing the RDF
| std::vector< int > rdf2::sampleRDF_AA | ( | const molSys::PointCloud< molSys::Point< double >, double > & | yCloud, |
| double | cutoff, | ||
| double | binwidth, | ||
| int | nbin ) |
Samples the RDF histogram at every step.