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.
Arguments
- gdl
A data frame of SOI export metadata, typically returned by
read_soi_gld(). It must contain at leastGDL_ID,OrderNameunless it has adirectorycolumn, and the fields needed to derive package metadata.tags$attachment_typeis built from the harness columns (Harness_data,HarnessMaterial_data,HarnessAttachement_data,HarnessThickness,LegHarnessDiameter,BreastHarnessDiameterHeadandBreastHarnessDiameterTail), whichread_soi_gld(filter_col = TRUE)does not keep: usefilter_col = FALSEto include them.- directory_data
Path to the directory containing SOI raw tag files or folders, in one sub-folder per
OrderName. Within it, a tag's data is the folder, or else the.glffile, whose name is theGDL_IDalone or followed by a non-alphanumeric separator (e.g.A1orA1_2020, but notA10_2020). When several match, the alphabetically last is used, with a warning naming the candidates. Not used whengdlalready has adirectorycolumn, which gives the data path of each tag directly.- generate_observations
A logical value. Equipment and retrieval
observations, withdevice_status = "present", are always created from the dates ingdl. IfTRUE, rows are also created without a datetime, as placeholders to fill in; ifFALSE, only rows with a known datetime are kept.
Details
The function performs the following steps:
Retrieves the data directory for each
GDL_IDwhen not already present.Creates GeoPressureR tag objects for tags with available data.
Extracts measurements and adds them as a package resource.
Derives
tagsandobservationsfromgdland 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.
