Fits a simulated lux profile to observed light logger data to estimate locations (parameters).
stk_fit(data, roi, loc, scale, control, step_selection, clip, model)Arguments
- data
A skytrackr data frame
- roi
A region of interest defined by a dynamic bounding box (set via the tolerance value and relative to the previous step)
- loc
The location of the previous step
- scale
Scale / sky condition factor covering the skylight() range of 1-10 (from clear sky to extensive cloud coverage) but can be extended for more flexibility to account for coverage by plumage. Note that in case of non-physical accurate lux measurements values can have a range starting at 0.0001 (a multiplier instead of a divider).
- control
Control settings for the Bayesian optimization, generally should not be altered (defaults to a Monte Carlo method). For detailed information I refer to the BayesianTools package documentation.
- step_selection
A step selection function on the distance of a proposed move, step selection is specified on distance (in km) basis.
- clip
value over which lux values are clipped, to be set to the saturation value of your system when using the full diurnal profile (not only twilight) (default = NULL)
- model
model to use, either "diurnal" calculating the diurnal profile fit using a single set of locations, or "individual" where the positions are updated along the flight track but only the last position is reported back (default = diurnal).
Value
An estimated illuminance based location (and its uncertainties).