Skip to contents

Make an MCTQ dataset more presentable

Source: R/pretty_mctq.R
pretty_mctq.Rd

[Maturing]

pretty_mctq() helps you to transform your Munich ChronoType Questionnaire (MCTQ) data in many ways. See the Arguments and Details section to learn more.

Usage

pretty_mctq(data, round = TRUE, hms = TRUE)

Arguments

data

A data.frame object.

round

(optional) a logical value indicating if Duration and hms objects must be rounded at the seconds level (default: TRUE).

hms

(optional) a logical value indicating if Duration and difftime objects must be converted to hms (default: TRUE).

Value

A transformed data.frame object, as indicated in the arguments.

Details

Rounding

Please note that by rounding MCTQ values you discard data. That is to say that if you need to redo a computation, or do new ones, your values can be off by a couple of seconds (see round-off error).

Round your values only if and when you want to present them more clearly, like in graphical representations. You can also round values to facilitate data exporting to text formats (like .csv), but note that this will come with a precision cost.

Note also that pretty_mctq() uses round_time() for rounding. round_time() is based on round(), which uses the IEC 60559 standard. For more information see the round_time() documentation.

See also

Other utility functions: assign_date(), cycle_time(), qplot_walk(), random_mctq(), raw_data(), round_time(), shorter_interval(), sum_time()

Examples

data <- data.frame(
    a = 1,
    b = lubridate::duration(1.12345),
    c = hms::hms(1.12345)
    )

## Rounding time objects from `data`

pretty_mctq(data, round = TRUE, hms = FALSE)
#>   a  b        c
#> 1 1 1s 00:00:01

## Converting non-'hms' time objects from 'data' to 'hms'

pretty_mctq(data, round = FALSE, hms = TRUE)
#>   a              b              c
#> 1 1 00:00:01.12345 00:00:01.12345