|
seams-core v2.14.0
libyodaLib, the C++ engine of d-SEAMS
|
CHILL, CHILL+, Steinhardt q_l, and the ice shell label. More...
Functions | |
| SEAMS_API seams_status | seams_chill (seams_system *sys, double cutoff, int type, int graph, int rule, int *labels, size_t labels_len, int counts9[9]) |
| Original CHILL labels, published or OVITO edges. | |
| SEAMS_API seams_status | seams_chill_plus (seams_system *sys, double cutoff, int type, int graph, int rule, int *labels, int counts9[9]) |
| CHILL+ labels, without a buffer length. | |
| SEAMS_API seams_status | seams_ql (seams_system *sys, double cutoff, int type, int order_l, int graph, double *ql, size_t ql_len, double *qlbar, size_t qlbar_len) |
| Local Steinhardt q_l, and the Lechner-Dellago average on request. | |
| SEAMS_API seams_status | seams_q4q6 (seams_system *sys, double cutoff, int type, double *q4, double *q6) |
| Local q4 and q6 on the cutoff shell, without buffer lengths. | |
| SEAMS_API seams_status | seams_q6bar (seams_system *sys, double cutoff, int type, double ice_cut, double *q6bar, size_t q6bar_len, double *mean, double *median, int *n_ice) |
| Lechner-Dellago q6-bar and the ice count above a cut. | |
CHILL, CHILL+, Steinhardt q_l, and the ice shell label.
| SEAMS_API seams_status seams_chill | ( | seams_system * | sys, |
| double | cutoff, | ||
| int | type, | ||
| int | graph, | ||
| int | rule, | ||
| int * | labels, | ||
| size_t | labels_len, | ||
| int | counts9[9] ) |
Original CHILL labels, published or OVITO edges.
Published CHILL is Moore's four-neighbour rule with inclusive c_ij edges. OVITO mode uses the same thresholds and the open edges. Labels match seams_label.
| sys | Frame handle. |
| cutoff | Positive finite cutoff, Angstrom. |
| type | Species filter. Zero and negative keep every atom. |
| graph | SEAMS_GRAPH_CUTOFF or SEAMS_GRAPH_MUTUAL. |
| rule | SEAMS_CHILL_PUBLISHED or SEAMS_CHILL_OVITO. |
| labels | Caller buffer of labels_len ints. |
| labels_len | Must be at least the frame count. |
| counts9 | Nine ints that receive the population of each label, or NULL to skip the histogram. |
| SEAMS_API seams_status seams_chill_plus | ( | seams_system * | sys, |
| double | cutoff, | ||
| int | type, | ||
| int | graph, | ||
| int | rule, | ||
| int * | labels, | ||
| int | counts9[9] ) |
CHILL+ labels, without a buffer length.
ABI 1 entry. labels must hold one int per atom in the frame. New callers use seams_chill_plus_n(), which checks the length.
| sys | Frame handle. |
| cutoff | Positive finite cutoff, Angstrom. |
| type | Species filter. Zero and negative keep every atom. |
| graph | SEAMS_GRAPH_CUTOFF or SEAMS_GRAPH_MUTUAL. |
| rule | SEAMS_CHILL_PUBLISHED or SEAMS_CHILL_OVITO. |
| labels | Caller buffer of one label per atom. |
| counts9 | Nine ints, or NULL. |
| SEAMS_API seams_status seams_q4q6 | ( | seams_system * | sys, |
| double | cutoff, | ||
| int | type, | ||
| double * | q4, | ||
| double * | q6 ) |
Local q4 and q6 on the cutoff shell, without buffer lengths.
ABI 1 pair. Each non-NULL array has one double per atom. New callers use seams_q4q6_n(), which checks the lengths.
| sys | Frame handle. |
| cutoff | Positive finite cutoff, Angstrom. |
| type | Species filter. |
| q4 | Local q4, or NULL. |
| q6 | Local q6, or NULL. q4 and q6 may not both be NULL. |
| SEAMS_API seams_status seams_q6bar | ( | seams_system * | sys, |
| double | cutoff, | ||
| int | type, | ||
| double | ice_cut, | ||
| double * | q6bar, | ||
| size_t | q6bar_len, | ||
| double * | mean, | ||
| double * | median, | ||
| int * | n_ice ) |
Lechner-Dellago q6-bar and the ice count above a cut.
The average is the same neighbour mean of q_6m as seams_ql() of order 6 on the cutoff graph. n_ice counts finite values strictly above ice_cut. The nucleation census uses 0.36. mean and median ignore non-finite values. An empty finite set stores 0.
| sys | Frame handle. |
| cutoff | Positive finite cutoff, Angstrom. |
| type | Species filter. |
| ice_cut | Finite threshold on q6-bar. |
| q6bar | Per-atom average, or NULL to keep only the summary. |
| q6bar_len | Length of q6bar. Ignored when q6bar is NULL. |
| mean | Receives the mean, or NULL. |
| median | Receives the median, or NULL. |
| n_ice | Receives the count above ice_cut, or NULL. |
| SEAMS_API seams_status seams_ql | ( | seams_system * | sys, |
| double | cutoff, | ||
| int | type, | ||
| int | order_l, | ||
| int | graph, | ||
| double * | ql, | ||
| size_t | ql_len, | ||
| double * | qlbar, | ||
| size_t | qlbar_len ) |
Local Steinhardt q_l, and the Lechner-Dellago average on request.
order_l is 3, 4, 6, 8, or 12. Either array may be NULL. A non-NULL array has one double per atom and its length must be at least the frame count. The average is the neighbour mean of q_lm. The cutoff graph reads the cutoff shell. The mutual graph reads the four nearest neighbours inside cutoff + 1.5.
| sys | Frame handle. |
| cutoff | Positive finite cutoff, Angstrom. |
| type | Species filter. Zero and negative keep every atom. |
| order_l | Spherical-harmonic degree. |
| graph | SEAMS_GRAPH_CUTOFF or SEAMS_GRAPH_MUTUAL. |
| ql | Local q_l, or NULL. |
| ql_len | Length of ql. Ignored when ql is NULL. |
| qlbar | Averaged q_l, or NULL to skip the average. |
| qlbar_len | Length of qlbar. Ignored when qlbar is NULL. |