mpathsenser 1.1.2
Major changes
link()
gained 3 new arguments:time
: The name of the column containing the timestamps inx
.end_time
: Optionally, the name of the column containing the end time inx
.y_time
: The name of the column containing the timestamps iny
.name
: The name of the nestedy
data, defaulting to"data"
.
Usingend_time
, it is now possible to specify custom time intervals instead of only fixed
intervals throughoffset_before
oroffset_after
. Note that these two functionality cannot
be specified at the same time.
time
andy_time
inlink()
must now be explicitly named, though for the time being default
to 'time' with a warning.- Added
continue
argument toadd_gaps()
that controls whether the last measurement(s) should be
continued after a gap. link_db()
is now soft deprecated as it provides only marginal added functionality compared to
link()
.decrypt_gps()
now takes a vector of encrypted GPS coordinates instead of a whole data frame
with fixed variables names (latitude
andlongitude
). This allows more flexibility in its use.
Also, parallelisation has been added similar to other functions in this package (i.e. by setting
a future plan, e.g.future::plan("multisession")
).
Deprecations
The following functions are now made defunctional and internal:
activity_duration()
app_usage()
n_screen_on()
n_screen_unlocks()
screen_duration()
,step_count()
These functions delivered incorrect output and only allowed summaries by a fixed time frame, e.g.
by hour or day. These functions will be reimplemented (some with a different name) in mpathsenser
2.0.0.
Minor changes
- When
add_before
oradd_after
isTRUE
inlink()
, no extra row is added if there already is
a row with a timestamp exactly equal to the start of the interval (foradd_before = TRUE
) or to
the end of the interval (add_after = TRUE)
. moving_average()
now allows a lazy tibble to allow further computations in-database after
having calledmoving_average()
.identify_gaps()
is now slightly more efficient.get_data()
is now case insensitive. In a future update, all sensor names throughout all
functions will be made case insensitive.- When using
add_before = TRUE
,link()
no longer adds an extra measurement if the first
measurement in the interval equals the start time of the interval exactly. get_data()
now allows multipleparticipant_id
s to be used.external_time
has been added as an argument tolink_db()
, to be able to specify the time
column inexternal_data
in accordance with the change inlink()
above.
Bugfixes
link()
now correctly handles natural joins (whenby = NULL
) and cross joins (when
by = character()
).- The column
original_time
was not added for any other nested data row except the first one,
ifadd_before
oradd_after
was true. link()
no longer suffers fromfuture
's max object restriction (500MB by default).- When
x
andy
use different time zones inlink()
andadd_before = TRUE
,link()
now
correctly leaves all time zones equal to the input. link()
incorrectly assigned the time zone ofx
to the nested data ofy
, ifadd_before
or
add_after
was true. This is now changed to the time zone ofy
, to ensure consistency. Note that
if the time zones ofx
andy
are different, matching will be correct but the nested data may
seem off as it will keepy
's input time zone.