pointpats.random.poisson

pointpats.random.poisson(hull, intensity=None, size=None)

Simulate a poisson random point process with a specified intensity.

Parameters:

hullA geometry-like object

This encodes the “space” in which to simulate the normal pattern. All points will lie within this hull. Supported values are: - a bounding box encoded in a numpy array as numpy.array([xmin, ymin, xmax, ymax]) - an (N,2) array of points for which the bounding box will be computed & used - a shapely polygon/multipolygon - a scipy convexh hull

intensityfloat

the number of observations per unit area in the hull to use. If provided, then size must be an integer describing the number of replications to use.

sizetuple or int

a tuple of (n_observations, n_replications), where the first number is the number of points to simulate in each replication and the second number is the number of total replications. So, (10, 4) indicates 10 points, 4 times. If an integer is provided and intensity is None, n_replications is assumed to be 1. If size is an integer and intensity is also provided, then size indicates n_replications, and the number of observations is computed from the intensity.

Returns:

: numpy.ndarray

either an (n_replications, n_observations, 2) or (n_observations,2) array containing

the simulated realizations.