VOLT
Plugins

Cluster Analysis

Find connected particle clusters using a distance cutoff.

Parameters

ParameterTypeDefaultDescription
cutofffloat3.2Cutoff radius used to define connectivity.
sortBySizebooltrueSort clusters by size in descending order.
unwrapboolfalseUnwrap particle coordinates inside each cluster.
centersOfMassboolfalseCompute cluster centers with uniform weights.
radiusOfGyrationboolfalseCompute radii and tensors of gyration with uniform weights.

Output

{outputBase}_cluster_analysis.msgpack

type Vec3 = [float, float, float];
type GyrationTensor = [float, float, float, float, float, float];

interface Cluster {
    cluster_id: int;
    size: int;
    center?: Vec3;
    radius_of_gyration?: float;
    gyration_tensor?: GyrationTensor;
}

interface PerAtomProperties {
    id: int;
    cluster: int;
    pos_unwrapped?: Vec3;
}

interface ClusterAnalysisOutput {
    main_listing: {
        total_atoms: int;
        clusters: int;
        largest_cluster_size: int;
        has_zero_weight_cluster: boolean;
    };
    sub_listings: {
        clusters: Cluster[];
    };
    "per-atom-properties": PerAtomProperties[];
}

See Also

On this page