GeoLight2TAGS: Function to write down twilights annotated in GeoLight...

In FLightR: Reconstruct Animal Paths from Solar Geolocation Loggers Data

Function to write down twilights annotated in GeoLight package data in so-called TAGS format

Description

this function converts combines twilights detected in BAStag to twGeos with raw data and writes them down in TAGS format that can be easily read by get.tags.data

Usage

GeoLight2TAGS(raw, gl_twl, threshold, filename = NULL)

Arguments

raw	original data - dataframe with two columns first column must contain time and second measured light levels
gl_twl	twilights object from GeoLight
threshold	threshold value used for twilight definition in GeoLight
filename	if NULL data.frame in TAGS format will be returned otherwise .csv file in TAGS format will be written

Details

TAGS format returned or written as .csv by this function is a dataframe with columns

datetime

date and time in ISO 8601 format e.g. 2013-06-16T00:00:11.000Z

light

light value measured by tag

twilight

assigned by the software numeric indication of whether the record belongs to sunrise (1), sunset (2) or none of those (0)

excluded

indication of whether a twilight was excluded during manual inspection (logical, TRUE | FALSE)

interp

indication of whether the light value at twilight was interpolated (logical, TRUE | FALSE)

The fields excluded and interp may have values of TRUE only for twilight > 0.

Value

NULL if filename is provided or TAGS formatted dataframe.

Author(s)

Eldar Rakhimberdiev & Simeon Lisovski

See Also

twGeos2TAGS and BAStag2TAGS

FLightR documentation built on Sept. 11, 2024, 5:14 p.m.