GeoLocator DP

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

Structure

A GeoLocator Data Package is organized into three components: (1) the project metadata, (2) the core resources containing the main dataset, and (3) optional trajectory data generated with the GeoPressure suite.

1. Metadata

The description of the 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, licenses, contributors, etc., as well as a list of the data `resources` that make up the package

2. Core Resources

The core GeoLocator DP resources consist 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 other events.

3. GeoPressureR Resources

The GeoPressureR extension consists of optional trajectory data generated through the GeoPressureR workflow analysis.

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 information of the edges associated with the paths.
`twilights.csv`	Table of the twilights estimated from light data for all tags.
`pressurepaths.csv`	Table of pressure-based paths.

Where to find and explore GeoLocator Data Packages

	You'll be able to find all GeoLocator Data Packages in the GeoLocator Data Package Zenodo Community. Once you've published your data package, make sure to submit it to the community.
	Explore the most likely trajectories of all existing data packages on a 3D map with GeoLocatorExplorer.

Ecosystem

	The Geolocator Manual R book has a dedicated part on the use of the GeoLocator Data Package. This is a great place to start learning more about how to use it with your GeoPressureTemplate project.
	The GeoLocatoR R package is designed to handle GeoLocator DP: creating a DP, adding resources, writing a DP, and reading a DP. It is essentially an extension of the frictionlessr package for geolocator data.
	GeoPressureR is the main package to analyze geolocator data. Once a GeoLocator Data Package is created, GeoPressureR is our recommended software to read the data into R and analyze the data.

How to Cite

Nussbaumer, R. (2024). GeoLocator-DP: Data exchange format for multi-sensor geolocator. Zenodo. 10.5281/zenodo.14258411