Read SOI data into a GeoLocator Data Package

Import Swiss Ornithological Institute (SOI) geolocator exports into a new GeoLocator Data Package. The function reads available raw tag data from directory_data, derives measurements, and builds tags and optionally prefilled observations from the supplied SOI summary table.

See an example of use with this tutorial.

Usage

read_soi(gdl, directory_data, generate_observations = TRUE)

Arguments

gdl

A data frame of SOI export metadata, typically returned by read_soi_gld(). It must contain at least GDL_ID and the fields needed to derive package metadata.

directory_data

Path to the directory containing SOI raw tag files or folders.

generate_observations

A logical value indicating whether to create pre-filled observations rows for equipment and retrieval events.

Value

A geolocatordp object.

Details

The function performs the following steps:

• Retrieves the data directory for each GDL_ID when not already present.

• Creates GeoPressureR tag objects for tags with available data.

• Extracts measurements and adds them as a package resource.

• Derives tags and observations from gdl and adds them as resources.

See also

read_soi_gld() to prepare the SOI input table and tags_to_measurements() for the underlying conversion of raw tag objects to the measurements resource.