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
- How to create a GeoLocator Data Package from a GeoPressureTemplate folder?
- How to read and use a Data package?
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. |