kinematics: Calculate a set of kinematics parameter from a...

In federicomarini/flowcatchR: Tools to analyze in vivo microscopy imaging data focused on tracking flowing blood cells

Calculate a set of kinematics parameter from a TrajectorySet object, or a single parameter, or from a single trajectory (all possible combinations)

Description

The computed set of parameters include delta.x, delta.t and delta.v (displacements and instantaneous velocity), totalTime, totalDistance, distStartToEnd, curvilinearVelocity, straightLineVelocity and linearityForwardProgression, Mean Squared Displacement, velocity autocorrelation, and more. If a single trajectory is specified, the computation is performed for that trajectory alone. If a parameter is specified, only that parameter is reported, either for one or all trajectories

Usage

kinematics(
  trajectoryset,
  trajectoryIDs = NULL,
  acquisitionFrequency = 30,
  scala = 50,
  feature = NULL
)

Arguments

trajectoryset	A TrajectorySet object
trajectoryIDs	The ID of a single trajectory
acquisitionFrequency	The frame rate of acquisition for the images, in milliseconds
scala	The value of micro(?)meters to which each single pixel corresponds
feature	Character string, the name of the feature to be computed

Value

A KinematicsFeaturesSet object, or a KinematicsFeatures object, or an atomic value, or a list(eventually coerced to a vector)

Author(s)

Federico Marini, [e-mail], 2014

Examples

data("candidate.platelets")
platelets.trajectories <- trajectories(candidate.platelets)
# for all trajectories, all features
alltrajs.features <- kinematics(platelets.trajectories)
# for one trajectory, all features
traj11features <- kinematics(platelets.trajectories,trajectoryIDs = 11)
# for all trajectories, one feature
alltrajs.curvVel <- kinematics(platelets.trajectories,feature = "curvilinearVelocity")
  

federicomarini/flowcatchR documentation built on June 12, 2025, 3:08 p.m.