GeoLocator DP

Data exchange format for geolocator data

GeoLocator Data Package (GeoLocator DP) defines a data exchange format for geolocator data. By using a common structure across projects, GeoLocator DP makes data easier to share, compare, and reuse, ultimately supporting bird migration research, conservation, and public outreach.

GeoLocator DP and the Master GeoLocator Data Package, which compiles all open packages, are described in Nussbaumer et al. (2026), Scientific Data.

Ready to publish your GeoLocator Data Package? Follow the step-by-step practical guide in the GeoLocator Data Package chapter of the GeoPressureManual to create, curate, and share your package with confidence.

Data Package Structure

A GeoLocator Data Package follows the more general Data Package and is organized into three components: (1) the core resources containing raw geolocator data, (2) optional but highly recommended trajectory resources generated with GeoPressureR, and (3) a minimal local manifest.

1. Core Resources

The core GeoLocator DP resources consist of raw geolocator data and deployment information. These resources can be generated without running trajectory analyses.

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 of bird-level field observations, including equipment, retrieval, and observations of control birds without tags.

2. 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.
params.json List of parameters used to run the GeoPressureR workflow, stored as plain JSON (param$<function>$<argument>).

3. Local Manifest

Following the Data Package standard, each GeoLocator DP contains a datapackage.json file with: (1) a machine-readable index of all data resources, (2) a package-level $schema pointing to the GeoLocator DP profile version. Since v1.0, the local manifest stays intentionally minimal, while metadata are managed in Zenodo. The GeoLocator DP profile defines the manifest requirements.

A manifest may carry other properties:

  • Descriptive metadata (e.g. title, contributors, licenses, version), such as for a package not yet on Zenodo or written by an older version. When a package has a Zenodo record, the record is authoritative: readers take its metadata over the manifest’s.
  • Coverage computed from the data by GeoLocatoR: temporal (first and last date of measurements), taxonomic (scientific names in tags) and numberTags (number of tags in the package and with each resource or sensor).

How to contribute?

If you have multi-sensor geolocator data and would like to contribute a GeoLocator Data Package, follow the workflow below.

  1. create_geopressuretemplate(): Set up your local GeoPressureTemplate project folder [guide].
  2. geopressuretemplate(): Run trajectory analyses in your GeoPressureTemplate project [guide].
  3. read_geopressuretemplate(): Build your GeoLocator Data Package from the template outputs [guide].
  4. Draft the record on Zenodo with metadata, reserve the DOI, and select the GeoLocator-DP community (without publishing yet) [guide].
  5. validate_gldp() and plot(): Validate the package and resolve issues until all checks pass [guide].
  6. Submit for curation and publish the record [guide].

Contribution workflow from setup to publication

Why use Zenodo?

  1. long-term hosting, DOI assignment, and versioned records,
  2. a simple and reliable way to manage metadata through web forms,
  3. community curation through the GeoLocator DP Zenodo community.

For the metadata checklist, validation policy, and visual quality checks before release, see the Curation page.

Resources

GeoLocatoR logo 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 frictionless package for geolocator data.
GeoPressureManual logo 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.
GeoPressureR logo 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.
GeoLocator DP logo 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.
GeoLocatorExplorer logo Explore the most likely trajectories of all existing data packages on a 3D map with GeoLocatorExplorer.

How to Cite

Cite the paper describing GeoLocator DP and the Master GeoLocator Data Package:

Nussbaumer, R., Adamík, P., Bell, F., et al. (2026). Standardised multi-sensor geolocator data for bird migration ecology. Scientific Data. https://doi.org/10.1038/s41597-026-08873-x

When you use the standard itself (e.g. to build or validate packages), also cite the version you used:

Nussbaumer, R., Desmet, P. & Geolocator Development Team (2024). GeoLocator Data Package. Zenodo. https://doi.org/10.5281/zenodo.14258411

When you reuse data, cite the Master GeoLocator Data Package with its concept DOI and the release version you used, and the source data packages contributing to your analysis (their bibliographicCitation):

Nussbaumer, R., Adamík, P., et al. Master GeoLocator Data Package. Zenodo. https://doi.org/10.5281/zenodo.18187092