napatrackmater 2.2.2

Import Trackmate XML files for Track Visualization and analysis in Napari.

NapaTrackMater

Napari Visualization tool for Trackmate > 6.0 and bTrackmate XML files for 3D + time tracks.

This repository is the bridge between the Fiji and Napari world for exporting and viewing the track XML files using Napari track layer

Installation

This package can be installed by

pip install napatrackmater

If you are building this from the source, clone the repository and install via

git clone https://github.com/kapoorlab/NapaTrackMater/

cd NapaTrackMater

pip install -e .

# or, to install in editable mode AND grab all of the developer tools
# (this is required if you want to contribute code back to NapaTrackMater)
pip install -r requirements.txt

Usage

To use this repository you need to have an XML file coming either from the Fiji plugin Trackmate version>6.0 or from bTrackmate version>2.0. Both the programs save the same XML file containing the information about your tracking session. This XML file can be used to re-generate trackscheme along with the tracks they came from, for example a typical trackscheme with tracks overlay in Fiji:

In this scheme there are some cells that divide multiple times and some don't, we can view these tracks by using the tracks layer of Napari.

In Napari tracks layer view we break the dividing trajectory into components that are called tracklets. These tracklets represent the trajectory of individual daughter cell or the root cell.

More than just viewing the tracks we can extract the following special functions from them:

1. If the cells move inside a tissue we can calculate the distance of the cells in a track from the tissue boundary for the root track and the following tracklets after a division event, this gives a cell localization plot which shows the starting and the ending distance of each tracklet. Check the notebook.

2. If the cells had an intensity oscillation we can compute the frequency of such oscillation for each tracklet of the track by Fourier transforming the intensity over time. Check the notebook.

Example

We provide an example dataset of C. elegans developing embryo and Mouse luminal cells, click on the link provided in the txt file to obtain the tif files of the Raw, Segmentation and the Mask image. Create a local enviornment to run the example by downloading the tif files and put them in the same directory where the csv and xml files are. We create this csv file using the Raw and Segmentation image using this notebook then we did the tracking via bTrackmate using the csv file to obtain the xml file in the save directory.

To view the intensity oscillations of the cells, click on this notebook. We seperate the visualization and analysis of dividing and non-dividing trajectories, in the cell of dividing trajectories you will see the Napari tracks layer with their ID for all the dividing tracks only along with the image, segmentation and mask layers. To view the tracks you can use the time slider to see the tracks alongside the cells. To hide some of the tracks or image layers you can use the visibility toggle on the left widget of Napari. In the left down there is a trackbox widget which contains the track ids. Using this dropdown menu you can choose your trackid and display the intensity over time of all the tracklets of this track and Fourier transform of each tracklet showing the period of oscillation of each tracklet of the track. The next cell does the same for non-dividing tracks.

To view the cell fate click on this notebook Again we divide the notebook into analysis of dividing and non-dividing tracjectories. In the plots we now show the distance of the cells in the track to the boundary and plot the starting end end distance of the parent (in green) and the daughter cells (in red).

Requirements

• Python 3.9 and above.

License

Under MIT license. See LICENSE.

Authors

• Varun Kapoor [e-mail]
• Claudia Carabana Garcia