feat(kinematics): add compute_roaming_entropy (#1001)

[AshNicolus]

Description

Closes #1001

Adds a new path-level metric, compute_roaming_entropy, which quantifies how
broadly and uniformly an individual explores 2D space over the course of a
trajectory. It is the Shannon entropy of the spatial occupancy distribution
obtained by binning positions onto a regular 2D grid:

$$H = -\sum_{i=1}^{N} p_i \ln p_i$$

where $p_i$ is the proportion of (non-NaN) time points spent in bin $i$.
The metric is invariant to the order of visits, so it captures where an
individual went rather than how, complementing speed/distance-based metrics.

API

def compute_roaming_entropy(
    data: xr.DataArray,
    bins: int | tuple[int, int] = 30,
    normalise: bool = True,
) -> xr.DataArray:

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud