Loading and correcting TrackMate data

To start, TrackMate XML data needs to be read into R. It may need recalibrating if the data were captured with incorrect parameters.

readTrackMateXML()

Read TrackMate XML output files.

correctTrackMateData()

Correct distance and time of imported TrackMate data.

Automated reports

TrackMateR can be used manually to have fine control over your analysis, however if you just want to analyse your data with default parameters, these two functions will process one dataset, or many

reportDataset()

Report Dataset

compareDatasets()

Compare datasets

Analysing track dynamics

To analyse track dynamics, there are several functions to calculate them. These functions are called (with set parameters) in the automated workflows and all of them must be called to make a report.

calculateAlpha()

Calculate alpha (relationship between MSD and normal diffusion)

calculateCVE()

Calculate CVE (covariance-based estimator)

calculateFD()

Calculate fractal dimension (FD)

calculateJD()

Calculate Jump Distance (JD)

calculateMSD()

Calculate Mean Squared Displacement (MSD)

calculateTrackDensity()

Calculate density of tracks

fittingJD()

Fitting jump distance (JD) data

Generating reports and summaries

Reports and summaries are collections of plots. They can be generated automatically using the automated workflows, or they can be made manually after fine-tuning the analysis of track dynamics.

makeSummaryReport()

Make Summary Report

makeComparison()

Make Comparison Plots

Plotting functions

The autoimated workflows and the reports that can be generated with TrackMateR use several different plotting functions.

plot_tm_MSD()

Make a plot of MSD data

plot_tm_NMSD()

Plot several (n) MSD curves

plot_tm_allTracks()

Make a plot of all tracks

plot_tm_alpha()

Make a histogram of alpha values

plot_tm_cumdistOverTime()

Make a plot of cumulative distance over time

plot_tm_dee()

Make a histogram of D values

plot_tm_displacementHist()

Make a histogram of displacements

plot_tm_displacementOverTime()

Make a plot of displacement over time

plot_tm_durationHist()

Make a histogram of track durations

plot_tm_fd()

Make a histogram of fractal dimension

plot_tm_intensityHist()

Make a histogram of intensities

plot_tm_neighbours()

Make a histogram of track density (number of neighbours)

plot_tm_speed()

Make a histogram of average speed

plot_tm_width()

Make a histogram of the largest point-to-point distance in each track

Analysis of non-TrackMate data

TrackMateR can read and process csv files in a similar way to TrackMate XML outputs. These are typically “ground truth” data sets that have been generated synthetically, but could come from some other package.

compareGTDatasets()

Compare ground truth datasets

readGTFile()

Read a ground truth csv file