diff --git a/R/cluster.R b/R/cluster.R index 176d838..604d60a 100644 --- a/R/cluster.R +++ b/R/cluster.R @@ -10,7 +10,7 @@ #' computed by \link{mt_distmat}. #' #' Mouse trajectories often occur in distinct, qualitative types (see Wulff et -#' al., 2019; Wulff et al., 2021). Common trajectory types are linear +#' al., 2019; Wulff et al., 2022). Common trajectory types are linear #' trajectories, mildly and strongly curved trajctories, and single and multiple #' change-of-mind trials (see also \link{mt_map}). \code{mt_cluster} can tease #' these types apart. @@ -32,7 +32,7 @@ #' top-left corner of the coordinate system (\link{mt_remap_symmetric} or #' \link{mt_align} can be used to achieve this). Furthermore, it is recommended #' to use length normalized trajectories (see \link{mt_length_normalize}; Wulff -#' et al., 2019). +#' et al., 2019, Wulff et al., 2021). #' #' @inheritParams mt_time_normalize #' @param save_as a character string specifying where the resulting data should @@ -86,10 +86,15 @@ #' @references Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., #' & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in #' movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -#' Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). New York, NY: -#' Routledge. +#' Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). +#' New York, NY: Routledge. +#' +#' Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +#' Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +#' processes: A tutorial using mousetrap.} PsyArXiv. +#' \doi{10.31234/osf.io/v685r} #' -#' Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +#' Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). #' \emph{Measuring the (dis-)continuous mind: What movement trajectories #' reveal about cognition}. Manuscript in preparation. #' diff --git a/R/data.R b/R/data.R index 1598341..5640ceb 100644 --- a/R/data.R +++ b/R/data.R @@ -215,18 +215,23 @@ #' trajectory, the discrete change-of-mind trajectory, and the double discrete #' change-of-mind trajectory. #' -#' Mouse- and hand-trajectories often occur in types (Wulff, Haslbeck, & -#' Schulte-Mecklenbeck, 2017). In such cases, movement trajectory data should be -#' analyzed in terms of discrete type assignments. To this end \link{mt_map} can -#' be used to map mouse- or hand-trajectory to the closest of several predefined -#' prototypes. \code{mt_prototypes} provides a core set of prototypes that has -#' been shown to represent well a large fraction of empirical movement -#' trajectories. +#' Mouse- and hand-trajectories often occur in types. In such cases, movement +#' trajectory data should be analyzed in terms of discrete type assignments +#' (Wulff et al., 2021). To this end \link{mt_map} can be used to map mouse- or +#' hand-trajectory to the closest of several predefined prototypes. +#' \code{mt_prototypes} provides a core set of prototypes that has been shown to +#' represent well a large fraction of empirical movement trajectories (Wulff et +#' al., 2022). #' #' To tailor the set of prototypes to a given study, \code{mt_prototypes} can be #' extended using \link{mt_add_trajectory}. #' -#' @references Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2018). +#' @references Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. +#' B., & Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +#' processes: A tutorial using mousetrap.} PsyArXiv. +#' \doi{10.31234/osf.io/v685r} +#' +#' Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2022). #' \emph{Measuring the (dis-)continuous mind: What movement trajectories #' reveal about cognition}. Manuscript in preparation. #' diff --git a/R/map.R b/R/map.R index 2dcc240..b3e1410 100644 --- a/R/map.R +++ b/R/map.R @@ -6,7 +6,7 @@ #' prototype that produced the smallest distance. #' #' Mouse trajectories often occur in distinct, qualitative types (see Wulff et -#' al., 2019; Wulff et al., 2021). Common trajectory types are linear +#' al., 2019; Wulff et al., 2022). Common trajectory types are linear #' trajectories, mildly and strongly curved trajectories, and single and #' multiple change-of-mind trials. \code{mt_map} allows to map trajectories to a #' predefined set of trajectory types. @@ -22,7 +22,7 @@ #' trajectories end in the top-left corner of the coordinate system #' (\link{mt_remap_symmetric} or \link{mt_align} can be used to achieve this). #' Furthermore, it is recommended to use length normalized trajectories (see -#' \link{mt_length_normalize}; Wulff et al., 2019). +#' \link{mt_length_normalize}; Wulff et al., 2019, Wulff et al., 2021). #' #' @inheritParams mt_distmat #' @param prototypes a trajectory array containing the prototypes the @@ -51,10 +51,15 @@ #' @references Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., #' & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in #' movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -#' Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). New York, NY: -#' Routledge. +#' Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). +#' New York, NY: Routledge. #' -#' Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +#' Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +#' Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +#' processes: A tutorial using mousetrap.} PsyArXiv. +#' \doi{10.31234/osf.io/v685r} +#' +#' Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). #' \emph{Measuring the (dis-)continuous mind: What movement trajectories #' reveal about cognition}. Manuscript in preparation. #' diff --git a/R/spatialize.R b/R/spatialize.R index 62bf55a..0d0720b 100644 --- a/R/spatialize.R +++ b/R/spatialize.R @@ -35,6 +35,8 @@ #' Dirk U. Wulff #' #' Jonas M. B. Haslbeck +#' +#' Pascal J. Kieslich #' #' @export mt_length_normalize <- function( diff --git a/docs/news/index.html b/docs/news/index.html index 95c2f29..ca68017 100644 --- a/docs/news/index.html +++ b/docs/news/index.html @@ -51,7 +51,7 @@

Changelog

- +

Announcements

References

Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). New York, NY: -Routledge.

-

Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). +New York, NY: Routledge.

+

Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +Schulte-Mecklenbeck, M. (2021). Movement tracking of cognitive +processes: A tutorial using mousetrap. PsyArXiv. +doi: 10.31234/osf.io/v685r

+

Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition. Manuscript in preparation.

diff --git a/docs/reference/mt_length_normalize.html b/docs/reference/mt_length_normalize.html index b57cbc4..68745b5 100644 --- a/docs/reference/mt_length_normalize.html +++ b/docs/reference/mt_length_normalize.html @@ -111,6 +111,7 @@

Details

Author

Dirk U. Wulff

Jonas M. B. Haslbeck

+

Pascal J. Kieslich

diff --git a/docs/reference/mt_map.html b/docs/reference/mt_map.html index 96a3d71..8128d15 100644 --- a/docs/reference/mt_map.html +++ b/docs/reference/mt_map.html @@ -147,7 +147,7 @@

Value

Details

Mouse trajectories often occur in distinct, qualitative types (see Wulff et -al., 2019; Wulff et al., 2021). Common trajectory types are linear +al., 2019; Wulff et al., 2022). Common trajectory types are linear trajectories, mildly and strongly curved trajectories, and single and multiple change-of-mind trials. mt_map allows to map trajectories to a predefined set of trajectory types.

@@ -161,16 +161,20 @@

Details

trajectories end in the top-left corner of the coordinate system (mt_remap_symmetric or mt_align can be used to achieve this). Furthermore, it is recommended to use length normalized trajectories (see -mt_length_normalize; Wulff et al., 2019).

+mt_length_normalize; Wulff et al., 2019, Wulff et al., 2021).

References

Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). New York, NY: -Routledge.

-

Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +Johnson (Eds.), A Handbook of Process Tracing Methods (pp. 131-145). +New York, NY: Routledge.

+

Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +Schulte-Mecklenbeck, M. (2021). Movement tracking of cognitive +processes: A tutorial using mousetrap. PsyArXiv. +doi: 10.31234/osf.io/v685r

+

Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition. Manuscript in preparation.

diff --git a/docs/reference/mt_prototypes.html b/docs/reference/mt_prototypes.html index eb19809..c5ef207 100644 --- a/docs/reference/mt_prototypes.html +++ b/docs/reference/mt_prototypes.html @@ -71,19 +71,23 @@

Format

Details

-

Mouse- and hand-trajectories often occur in types (Wulff, Haslbeck, & -Schulte-Mecklenbeck, 2017). In such cases, movement trajectory data should be -analyzed in terms of discrete type assignments. To this end mt_map can -be used to map mouse- or hand-trajectory to the closest of several predefined -prototypes. mt_prototypes provides a core set of prototypes that has -been shown to represent well a large fraction of empirical movement -trajectories.

+

Mouse- and hand-trajectories often occur in types. In such cases, movement +trajectory data should be analyzed in terms of discrete type assignments +(Wulff et al., 2021). To this end mt_map can be used to map mouse- or +hand-trajectory to the closest of several predefined prototypes. +mt_prototypes provides a core set of prototypes that has been shown to +represent well a large fraction of empirical movement trajectories (Wulff et +al., 2022).

To tailor the set of prototypes to a given study, mt_prototypes can be extended using mt_add_trajectory.

References

-

Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2018). +

Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. +B., & Schulte-Mecklenbeck, M. (2021). Movement tracking of cognitive +processes: A tutorial using mousetrap. PsyArXiv. +doi: 10.31234/osf.io/v685r

+

Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2022). Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition. Manuscript in preparation.

diff --git a/man/mt_cluster.Rd b/man/mt_cluster.Rd index ebec0f1..2ea83e9 100644 --- a/man/mt_cluster.Rd +++ b/man/mt_cluster.Rd @@ -103,7 +103,7 @@ Cluster estimation using \link[fastcluster]{hclust} relies on distances computed by \link{mt_distmat}. Mouse trajectories often occur in distinct, qualitative types (see Wulff et -al., 2019; Wulff et al., 2021). Common trajectory types are linear +al., 2019; Wulff et al., 2022). Common trajectory types are linear trajectories, mildly and strongly curved trajctories, and single and multiple change-of-mind trials (see also \link{mt_map}). \code{mt_cluster} can tease these types apart. @@ -125,7 +125,7 @@ trajectories share the same direction, e.g., that all trajectories end in the top-left corner of the coordinate system (\link{mt_remap_symmetric} or \link{mt_align} can be used to achieve this). Furthermore, it is recommended to use length normalized trajectories (see \link{mt_length_normalize}; Wulff -et al., 2019). +et al., 2019, Wulff et al., 2021). } \examples{ # Length normalize trajectories @@ -143,10 +143,15 @@ mt_plot(KH2017,use="ln_trajectories", Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). New York, NY: -Routledge. +Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). +New York, NY: Routledge. -Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +processes: A tutorial using mousetrap.} PsyArXiv. +\doi{10.31234/osf.io/v685r} + +Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). \emph{Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition}. Manuscript in preparation. } diff --git a/man/mt_length_normalize.Rd b/man/mt_length_normalize.Rd index 2c7323d..251a808 100644 --- a/man/mt_length_normalize.Rd +++ b/man/mt_length_normalize.Rd @@ -62,4 +62,6 @@ KH2017 <- mt_length_normalize(data=KH2017, Dirk U. Wulff Jonas M. B. Haslbeck + +Pascal J. Kieslich } diff --git a/man/mt_map.Rd b/man/mt_map.Rd index 039dc84..1bc14de 100644 --- a/man/mt_map.Rd +++ b/man/mt_map.Rd @@ -90,7 +90,7 @@ prototype that produced the smallest distance. } \details{ Mouse trajectories often occur in distinct, qualitative types (see Wulff et -al., 2019; Wulff et al., 2021). Common trajectory types are linear +al., 2019; Wulff et al., 2022). Common trajectory types are linear trajectories, mildly and strongly curved trajectories, and single and multiple change-of-mind trials. \code{mt_map} allows to map trajectories to a predefined set of trajectory types. @@ -106,7 +106,7 @@ trajectories (and added prototypes) share the same direction, i.e., that all trajectories end in the top-left corner of the coordinate system (\link{mt_remap_symmetric} or \link{mt_align} can be used to achieve this). Furthermore, it is recommended to use length normalized trajectories (see -\link{mt_length_normalize}; Wulff et al., 2019). +\link{mt_length_normalize}; Wulff et al., 2019, Wulff et al., 2021). } \examples{ # Length normalize trajectories @@ -154,10 +154,15 @@ KH2017 <- mt_map(KH2017, Wulff, D. U., Haslbeck, J. M. B., Kieslich, P. J., Henninger, F., & Schulte-Mecklenbeck, M. (2019). Mouse-tracking: Detecting types in movement trajectories. In M. Schulte-Mecklenbeck, A. Kühberger, & J. G. -Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). New York, NY: -Routledge. +Johnson (Eds.), \emph{A Handbook of Process Tracing Methods} (pp. 131-145). +New York, NY: Routledge. -Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2021). +Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. B., & +Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +processes: A tutorial using mousetrap.} PsyArXiv. +\doi{10.31234/osf.io/v685r} + +Wulff, D. U., Haslbeck, J. M. B., & Schulte-Mecklenbeck, M. (2022). \emph{Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition}. Manuscript in preparation. } diff --git a/man/mt_prototypes.Rd b/man/mt_prototypes.Rd index 77ce9ea..e71acaa 100644 --- a/man/mt_prototypes.Rd +++ b/man/mt_prototypes.Rd @@ -17,19 +17,24 @@ trajectory, the discrete change-of-mind trajectory, and the double discrete change-of-mind trajectory. } \details{ -Mouse- and hand-trajectories often occur in types (Wulff, Haslbeck, & -Schulte-Mecklenbeck, 2017). In such cases, movement trajectory data should be -analyzed in terms of discrete type assignments. To this end \link{mt_map} can -be used to map mouse- or hand-trajectory to the closest of several predefined -prototypes. \code{mt_prototypes} provides a core set of prototypes that has -been shown to represent well a large fraction of empirical movement -trajectories. +Mouse- and hand-trajectories often occur in types. In such cases, movement +trajectory data should be analyzed in terms of discrete type assignments +(Wulff et al., 2021). To this end \link{mt_map} can be used to map mouse- or +hand-trajectory to the closest of several predefined prototypes. +\code{mt_prototypes} provides a core set of prototypes that has been shown to +represent well a large fraction of empirical movement trajectories (Wulff et +al., 2022). To tailor the set of prototypes to a given study, \code{mt_prototypes} can be extended using \link{mt_add_trajectory}. } \references{ -Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2018). +Wulff, D. U., Kieslich, P. J., Henninger, F., Haslbeck, J. M. +B., & Schulte-Mecklenbeck, M. (2021). \emph{Movement tracking of cognitive +processes: A tutorial using mousetrap.} PsyArXiv. +\doi{10.31234/osf.io/v685r} + +Wulff, D. U., Haslbeck, J. M. B., Schulte-Mecklenbeck, M. (2022). \emph{Measuring the (dis-)continuous mind: What movement trajectories reveal about cognition}. Manuscript in preparation. }