Worm Tracker

From FarsightWiki
Jump to: navigation, search

Warning. This page is under construction.

Usage

The worm tracker has the following syntax. 

Tracker [StringBeforeLabeledImageFilename] [StringBeforeRawImageFilename] [StartFrame] [EndFrame]

For each frame tracker returns a text file containing the five semicolon-delimited fields:

  • ID
  • x coordinates of spine
  • y coordinates of spine
  • Distance from head to middle
  • Distance from tail to middle

Each line of the file corresponds to a single worm. The text files has the same filename as the Raw images but with a ".txt" insted of an ".tif"

Notes

  • In labeled images the background pixels must be assigned a value of 0.
  • Tracker can accept binary images if labeled images are not available.
  • The input images should be single-slice 8-bit TIFs. Other image formats have not been tested.
  • The frame number must have 4 digits.
  • The frame number must be at to the end of the image name.

Example Input

To track worms with the following image sequence... 

C:\data\Im0000.tif
C:\data\Im0001.tif
C:\data\Im0002.tif
C:\data\Im0003.tif
C:\data\Im0004.tif

...with their associated labeled image sequence... 

C:\data\LabeledIm0000.tif
C:\data\LabeledIm0001.tif
C:\data\LabeledIm0002.tif
C:\data\LabeledIm0003.tif
C:\data\LabeledIm0004.tif

...the following command should be used. 

Tracker "C:\data\Im" "C:\data\LabeledIm" 0 4

Example Output

Here is an example output file for two worms. The second worm has an ID of 2 and a spine located at (157.459,369.683), (159.604,369.997), (161.898,370.368) and so on. Its distance from head to middle is 19.2118 and its distance from tail to middle is 16.0946.

1;[369.82,371.349,372.789,374.39,376.439,378.419,380.234,381.82,383.194,384.059,384.818,386.148,387.559,389.189,391.3,393.475,395.241,396.649,397.159,396.831,395.746,];[370.92,372.608,374.19,375.698,376.535,377.454,378.579,380.147,381.75,383.823,385.814,387.542,389.238,390.555,391.14,391.763,393.033,394.74,396.684,398.732,400.708];21.137;18.4725 2;[157.459,159.604,161.898,163.988,166.354,168.441,170.68,172.77,174.311,175.499,176.057,177.13,178.31,179.708,181.498,183.774,185.704,187.342,188.815,189.888,192.148,];[369.683,369.997,370.368,370.455,370.641,371.14,371.109,370.141,368.846,366.973,364.864,362.968,361.064,359.34,358.18,358.378,359.298,360.749,362.438,364.465,365.231];19.2118;16.0946

Algorithm

Warning. This section is under construction.

Papers

  • Roussel R, Morton CA, Finger FP, Roysam B, “A Computational Model for C. elegans Locomotory Behavior: Application to Multi-Worm Tracking,” IEEE Transactions on Biomedical Engineering. 2007 Oct; 54(10):1786-97.
  • Reid DB, "An algorithm for tracking multiple targets," IEEE Transactions on Automatic Control. 1979 Dec; 24(6):843-854.
Retrieved from "http://farsight-toolkit.ee.uh.edu/wiki/Worm_Tracker"