sdu | R Documentation |
sdu()
computes the sleep duration for standard, micro, and shift
versions of the Munich ChronoType Questionnaire (MCTQ).
Please note that, although we tried to preserve the original authors' naming
pattern for the MCTQ functions, the name sd
provokes a dangerous name
collision with the widely used sd()
function (standard
deviation). That's why we named it sdu
. sdu()
and msl()
are the only exceptions, all the other mctq
functions maintain a strong
naming resemblance with the original authors' naming pattern.
sdu(so, se)
so |
An |
se |
An |
Standard MCTQ functions were created following the guidelines in Roenneberg, Wirz-Justice, & Merrow (2003), Roenneberg, Allebrandt, Merrow, & Vetter (2012), and from The Worldwide Experimental Platform (theWeP, n.d.).
μMCTQ functions were created following the guidelines in Ghotbi et al. (2020), in addition to the guidelines used for the standard MCTQ.
MCTQ Shift functions were created following the guidelines in Juda, Vetter, & Roenneberg (2013), in addition to the guidelines used for the standard MCTQ.
See the References section to learn more.
The mctq
package works with a set of object classes specially created to
hold time values. These classes can be found in the
lubridate and hms
packages. Please refer to those package documentations to learn more about
them.
Some operations may produce an output with fractional time (e.g.,
"19538.3828571429s (~5.43 hours)"
, 01:15:44.505
). If you want, you
can round it with round_time()
.
Our recommendation is to avoid rounding, but, if you do, make sure that you only round your values after all computations are done. That way you avoid round-off errors.
A Duration
object corresponding to the
vectorized difference between se
and so
in a circular time frame of 24
hours.
Roenneberg, Allebrandt, Merrow, & Vetter (2012), Ghotbi et al. (2020), Juda,
Vetter, & Roenneberg (2013), and The Worldwide Experimental Platform (n.d.)
guidelines for sdu()
(SD) computation are as follows.
This computation must be applied to each section of the questionnaire.
If you are visualizing this documentation in plain text, you may have some trouble understanding the equations. You can see this documentation on the package website.
SD_{W/F} = SE_{W/F} - SO_{W/F}
Where:
SD_{W/F} = Sleep duration on work or work-free days.
SE_{W/F} = Local time of sleep end on work or work-free days.
SO_{W/F} = Local time of sleep onset on work or work-free days.
* W = Workdays; F = Work-free days.
SD_{W/F}^{M/E/N} = SE_{W/F}^{M/E/N} - SO_{W/F}^{M/E/N}
Where:
SD_{W/F}^{M/E/N} = Sleep duration between two days in a particular shift or between two free days after a particular shift.
SE_{W/F}^{M/E/N} = Local time of sleep end between two days in a particular shift or between two free days after a particular shift.
SO_{W/F}^{M/E/N} = Local time of sleep onset between two days in a particular shift or between two free days after a particular shift.
* W = Workdays; F = Work-free days, M = Morning shift; E = Evening shift; N = Night shift.
Ghotbi, N., Pilz, L. K., Winnebeck, E. C., Vetter, C., Zerbini, G., Lenssen, D., Frighetto, G., Salamanca, M., Costa, R., Montagnese, S., & Roenneberg, T. (2020). The μMCTQ: an ultra-short version of the Munich ChronoType Questionnaire. Journal of Biological Rhythms, 35(1), 98-110. doi: 10.1177/0748730419886986
Juda, M., Vetter, C., & Roenneberg, T. (2013). The Munich ChronoType Questionnaire for shift-workers (MCTQ Shift). Journal of Biological Rhythms, 28(2), 130-140. doi: 10.1177/0748730412475041
Roenneberg T., Allebrandt K. V., Merrow M., & Vetter C. (2012). Social jetlag and obesity. Current Biology, 22(10), 939-43. doi: 10.1016/j.cub.2012.03.038
Roenneberg, T., Wirz-Justice, A., & Merrow, M. (2003). Life between clocks: daily temporal patterns of human chronotypes. Journal of Biological Rhythms, 18(1), 80-90. doi: 10.1177/0748730402239679
The Worldwide Experimental Platform (n.d.). MCTQ. https://www.thewep.org/documentations/mctq/
Other MCTQ functions:
fd()
,
gu()
,
le_week()
,
msf_sc()
,
msl()
,
napd()
,
sd24()
,
sd_overall()
,
sd_week()
,
sjl_sc()
,
sjl_weighted()
,
sjl()
,
so()
,
tbt()
## Scalar example so <- hms::parse_hm("23:00") se <- hms::parse_hm("08:00") sdu(so, se) #> [1] "32400s (~9 hours)" # Expected so <- hms::parse_hm("02:00") se <- hms::parse_hm("12:30") sdu(so, se) #> [1] "37800s (~10.5 hours)" # Expected so <- hms::parse_hm("03:15") se <- hms::as_hms(NA) sdu(so, se) #> [1] NA # Expected ## Vector example so <- c(hms::parse_hm("04:12"), hms::parse_hm("21:20")) se <- c(hms::parse_hm("14:30"), hms::parse_hm("03:45")) sdu(so, se) #> [1] "37080s (~10.3 hours)" "23100s (~6.42 hours)" # Expected
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.