relevantESVN {esmprep} | R Documentation |
relevantESVN
Description
relevantESVN creates a list of the relevant variable names (VN) of (each of) the experience sampling (ES) dataset(s).
Usage
relevantESVN(svyName = NULL, IMEI = NULL, STARTDATE = NULL,
STARTTIME = NULL, ENDDATE = NULL, ENDTIME = NULL,
START_DATETIME = NULL, END_DATETIME = NULL)
Arguments
svyName |
a vector of character string(s). The column name in (each of) the ESM dataset(s) that specifies the particular survey version. |
IMEI |
a character string. Column name that specifies the variable in the respective dataset holding the the IMEI number. |
STARTDATE |
a character string that specifies the column name in the respective dataset holding the date of when the participant started ... see Details. |
STARTTIME |
a character string that specifies the column name in the respective dataset holding the time of when the participant started ... see Details. |
ENDDATE |
a character string that specifies the column name in the respective dataset holding the date of when the participant ended ... see Details. |
ENDTIME |
a character string that specifies the column name in the respective dataset holding the time of when the participant ended ... see Details. |
START_DATETIME |
a character string. If |
END_DATETIME |
a character string. If |
Details
The relevant variable names (i.e. column names) must refer to the raw ESM dataset(s). The date and time of both start and end refers to the single ESM questionnaires, i.e. the date and time they actually were started on the phone and the date and time they were finished.
Value
A list of the relevant variable/column names in the ESM dataset(s). To be used as the last argument in the function setES
. The last element of the list is a logical value indicating whether the date and time are either separated (TRUE) or already a date-time object (FALSE). It is meaningful only for the subsequent function setES
.
See Also
Exemplary code (fully executable) in the documentation of esmprep
(function 3 of 29).
Examples
# o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o
# ------------------------------------------------------
# Run function 3 of 29; see esmprep functions' hierarchy.
# ------------------------------------------------------
# With date and time as separate arguments
relEs <- relevantESVN(svyName="survey_name", IMEI="IMEI",
STARTDATE="start_date", STARTTIME="start_time",
ENDDATE="end_date", ENDTIME="end_time")
# With date-time objects instead of separate date and time
relEs <- relevantESVN(svyName="survey_name", IMEI="IMEI",
START_DATETIME="start_dateTime", END_DATETIME="end_dateTime")
# o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o=o