pbcluster 0.2.1

Description:

pbcluster 0.2.1

PBCluster





Free software: MIT license
Documentation: https://pbcluster.readthedocs.io.

This packages makes it easier to analyze particle clusters in boxes with
periodic boundaries.
For example, take a look at this simulation box:

All these particles belong to a single cluster, but because particles jump to
the other side of the box when the cross one of the box faces (like in the
classic Asteroids game),
the cluster appears split into 2 clusters plus a lone particle.
This jumping/wrapping behavior is often called a Periodic Boundary Condition
(PBC).
Typical clustering packages make it difficult or impossible to account for PBCs,
and might classify these particles as belonging to 3 separate clusters.
PBCluster handles periodic boundary conditions, and allows you to calculate
several particle and cluster properties.
Here are some available properties:

Cluster Properties

n_particles: number of particles in a cluster
minimum_node_cuts: the number of particles you’d need to remove to
break all paths through connected particles from any face to its opposing face.
rg: the radius of gyration of a cluster
asphericity: a measure of the elongation of the cluster



Particle Properties

coordination_number: the number of neighboring particles connected to
a given particle



Bond Properties

bonds_df: a dataframe of particle-particle “bonds” (neighbors within the
cutoff distance of each other
bond_durations_df: a dataframe with data about how long particle pairs
were in contact

You can install this with pip install pbcluster.
For more details check out the Installation page of the docs.
For an example showing how to use PBCluster, check out the Example page of
the docs.


Credits
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.



History
0.1.0 (2019-04-28)

First release on PyPI.