Data and scripts underlying the publication: Quantifying the Spatial Scales of Animal Clusters Using Density Surfaces

DOI:10.4121/61be5dd9-7880-48dc-bacf-36afbc3033ee.v1
The DOI displayed above is for this specific version of this dataset, which is currently the latest. Newer versions may be published in the future. For a link that will always point to the latest version, please use
DOI: 10.4121/61be5dd9-7880-48dc-bacf-36afbc3033ee

Datacite citation style

van Mulken, Max; J.A.J. (Jasper) Eikelboom (2025): Data and scripts underlying the publication: Quantifying the Spatial Scales of Animal Clusters Using Density Surfaces. Version 1. 4TU.ResearchData. dataset. https://doi.org/10.4121/61be5dd9-7880-48dc-bacf-36afbc3033ee.v1
Other citation styles (APA, Harvard, MLA, Vancouver, Chicago, IEEE) available at Datacite

Dataset

Wageningen University and Research logo

Geolocation

Tsavo National Park, Kenya
lat (N): -2.96
lon (E): 37.91
view on openstreetmap

Time coverage

2014

Licence

CC BY-NC 4.0

Interoperability

Supplementary scripts to the publication "Quantifying the spatial scales of animal clustering using Density Surfaces"


We implement a method to quantify the degree of clustering of point location data at different spatial scales,

which uses Kernel Density Estimation to construct a density function from the underlying point-location data.

We build upon this method to automatically detect cluster diameters using smoothing kernels that better represent the perception neighbourhood of animals.

More details can be found in the manuscript.


These scripts construct the artificial data sets and results in the figures in the main text of the manuscript.


data_generator.py

This file contains the functions to construct the artificial data sets, as well as visualization tools to plot the point sets.

Running the main() function:

1. constructs all artificial data sets

2. creates visualizations of all generated and real-life datasets, saves them as .pdf files, and shows them on-screen


metric_calculator.py

This file contains the functions to calculate the metric described in the manuscript, as well as to compute Ripley's K function

and the Radial Distribution Function.

Running the main() function:

1. generates the metric functions for all artificial and real-life data sets

2. creates visualizations of all generated metric functions, saves them as .pdf files, and shows them on-screen

3. prints the found relevant spatial scales, and their metric values, in the terminal


elephant.pickle

This file contains the real-world dataset of elephant locations to be used in metric_calculator.py

The original data was collected in March 2014 in the Tsavo National Parks, Kenya.

We use a subset of the original data set, consisting of location data of 24 elephants obtained from an aerial image that were manually taken by human observers upon spotting the animals.

The aerial image was manually processed into spatial data by placing a point on the approximate centre point of each animal in the image, and projected onto a 100x100 xy-plane.

The data is serialized and de-serialized using the native Python package "pickle". The data format used by pickle is Python-specific.


To perform the experiments:

1. Ensure you have a functioning Python3 installation.

2. Install the required packages using pip:

- numpy

- matplotlib

- scipy

- scikit-learn

3. Run the main() function in data_generator.py to generate the artificial datasets

4. Run the main() function in metric_calculator.py to generate the metric functions and figures


History

  • 2025-05-28 first online, published, posted

Publisher

4TU.ResearchData

Format

py, pickle

Organizations

TU Eindhoven, Algorithms Cluster;
Wildlife Ecology and Conservation Group, Wageningen University and Research;
Laboratory of Geo-information Science and Remote Sensing, Wageningen University and Research

DATA

Files (4)