GeoLocator DP

Data exchange format for geolocator data

GeoLocator Data Package (GeoLocator DP) is a data exchange format for geolocator data. It follows the Data Package standard for the structuring of the data.

A geolocator data package consists of three sets of data: (1) the metadata of the project, (2) the core resources contianing the main dataset and (3) optional trajectory data generated with the GeoPressure suite.

1. Metadata

The description of project and the data is contained in datapackage.json.

File Description
datapackage.json List of the project’s metadata such as the package’s title, licences, contributors etc. as well as a list of the data resources that make up the package

2. Core Resources

The core GeoLocator DP resources contain of the raw geolocator data. These resources can be generated without any analysis of the geolocator data.

File Description
tags.csv Table of devices used in the study. We assume that a tag is only used once on a single animal.
measurements.csv Table with the raw measurements of all sensors (e.g., light, pressure, …) for all tags.
observations.csv Table with the field observations associated with tags such as equipment, retrieval, or others events.

3. GeoPressureR Resources

The GeoPressureR extensions consists of optional trajectrory data generated through the GeoPressureR workflow anaylsis.

File Description
staps.csv Table of the stationary periods of all tags.
paths.csv Table of the trajectory of all tags, typically most likely path or simulation paths.
edges.csv Table containing the flight informations of the edges associated with the paths.
twilights.csv Table of the twilights estimated from light data for all tags.
pressurepaths.csv Table of the pressurepaths

Example

Nussbaumer, R., Rime, Y., & Osinubi, S. T. (2024). GeoLocator Data Package: South African Woodland Kingfisher [Data set]. Zenodo. https://doi.org/10.5281/zenodo.13829929

User guides

Software

The GeoLocatoR R package is designed to handle GeoLocator DP: creating DP, adding resources to DP, writing DP and reading DP. It is essentially an extension of the frictionlessr package for geolocator data.
GeoPressureR is the main package to analyse geolocator data. Once a Geolocator data package is created, GeoPressureR is our recommended software to read the data into R and analyse the data.