movement {embryogrowth} | R Documentation |
Analyze movement recorded within a nest with an accelerometer datalogger
Description
This function is used to evaluate significant movement within a nest.
The "quiet" period is the period without any expected move. It is used as a reference
to detect the period with significant movements.
It returns a data.frame with the columns:
"Time", "x", "y", "z",
"mvt", "mvt_standardized", "peakmvt", "running", "mvt_MA_standardized",
"mvt_2", "mvt_2_standardized", "peakmvt_2", "running_2", "mvt_2_MA_standardized".
mvt and mvt_2 are two different methods. Often mvt_2 is better to descrobe movments.
Usage
movement(
x = stop("data.frame must be provided"),
col.time = "Time",
col.x = "x",
col.y = "y",
col.z = "z",
DaysQuiet = 40,
SkipDays = 1,
k = 4,
Windowsize = 15
)
Arguments
x |
A data.frame with 4 columns, one for time and three for x, y, and z position |
col.time |
Name of the column with time |
col.x |
Name of the column with x positions |
col.y |
Name of the column with y positions |
col.z |
Name of the column with z positions |
DaysQuiet |
Number of days in quiet period |
SkipDays |
Number of days to skip before being in quiet mode |
k |
Factor to multiply SD to prevent false positive detection |
Windowsize |
Number of records used for moving average |
Details
movement is a function that permits to analyze movement datalogger
Value
The function will return a data.frame
Author(s)
Marc Girondot
References
Morales-Mérida BA, Contreras-Mérida MR, Girondot M (2019).
“Pipping dynamics in marine turtle Lepidochelys olivacea nests.”
Trends in Developmental Biology, 12, 23-30.
See Also
Other Data loggers utilities:
calibrate.datalogger()
,
uncertainty.datalogger()
Examples
## Not run:
library(embryogrowth)
mv <- movement(x=dataf,
col.time="Time",
col.x="x", col.y="y", col.z="z")
## End(Not run)