ampy.statistics2d

Module provides analysis of robots positions and each frame, calculating various two-dimensional statistical measures

ampy.statistics2d.bond_orientation(kinematics: list, neighbours_number: int, folds_number: int, get_each: int = 1) → list

Returns bond orientation order parameter

Parameters:

• kinematics – system’s kinematics

• neighbours_number – number of neighbours to use in calculations

• folds_number – number of folds to use in calculations

• get_each – frames decimation frequency

Returns:

list of scalar values

ampy.statistics2d.calc_angle(point_a: tuple, point_b: tuple) → float

Returns angle in degrees between OX-axis and (b-a) vector direction

Parameters:

• point_a – vector’s begin point

• point_b – vector’s end point

Returns:

scalar value

ampy.statistics2d.calc_distance(point_a: tuple, point_b: tuple) → float

Returns Euclidean distance between two points

Parameters:

• point_a – first point

• point_b – vector end point

Returns:

scalar value

ampy.statistics2d.chi_4(kinematics: list, tau: int, a: float) → float

Returns spatio-temporal correlation parameter chi_4 for given time and space gape

Parameters:

• kinematics – system’s kinematics

• tau – characteristic time in frames

• a – characteristic distance in pixels

Returns:

scalar value

ampy.statistics2d.cluster_dynamics(kinematics: list, collide_function=<function _is_collide>) → list

Returns collision graph average clustering coefficient

Parameters:

• kinematics – system’s kinematics

• collide_function – collision detection function

Returns:

list of scalar values

ampy.statistics2d.mean_cartesian_displacements(kinematics: list)

Returns average particles’ cartesian displacement for each frame

Parameters:

kinematics – system’s kinematics

Returns:

list of scalar values

ampy.statistics2d.mean_distance_from_center(kinematics: list) → list

Returns average particles’ distance from center for each frame

Parameters:

kinematics – system’s kinematics extended by polar coordinates

Returns:

scalar value for each frame

ampy.statistics2d.mean_polar_angle(kinematics: list) → list

Returns average particles’ polar angle for each frame. Angle for certain frame calculating by accumulating all angle changes in previous frames

Parameters:

kinematics – system’s kinematics extended by polar coordinates

Returns:

list of scalar values

ampy.statistics2d.mean_polar_angle_absolute(kinematics: list)

Returns average particles’ polar angle for each frame. Angle for certain frame calculating by accumulating absolute values of all angle changes in previous frames

Parameters:

kinematics – system’s kinematics extended by polar coordinates

Returns:

list of scalar values