title: GeoLocator DP background: /assets/home.png permalink: /

description: 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 containing 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 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 others events. |

3. GeoPressureR Resources

The GeoPressureR extensions 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 the pressurepaths |

Examples

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

User guides

The GeolocatorManual R book has a dedicated part on the use of Geolocator Data Package. This is a great place to start learning more on how to use it with your GeoPressureTemplate project.

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.

How to cite

Nussbaumer, R. (2024). GeoLocator Data Package. Zenodo. 10.5281/zenodo.14258411