konigcell.dynamic_prob2d#

konigcell.dynamic_prob2d(positions, values, radii=None, pixels=None, resolution=None, xlim=None, ylim=None, executor=<class 'concurrent.futures.thread.ThreadPoolExecutor'>, max_workers=None, verbose=True)[source]#

Compute the 2D probability distribution of a moving particle’s specific quantity (e.g. velocity).

This function computes the distribution of the input values across pixel cells. For example, computing the velocity distribution of a particle moving from positions A to B to C, we need to rasterize the velocity from values[0] on segment AB, then the velocity from values[1] on BC - therefore for N positions we will rasterize N-1 values.

For multiple particle trajectories, simply separate them by a row of NaN in the input positions.

All input parameters are equivalent to dynamic2d - check its documentation for full details.