Skip to content

Command line

The analysis without the window, with the presets the app saves. tracell alone starts the app.

A recorded video

tracell track video.avi --preset settings.json --out results

Writes the trajectory table, the cell summary and the settings used. Ctrl+C keeps the frames tracked so far.

Option Meaning
--preset FILE Settings saved by the app (File > Save)
--out FOLDER Where the results go (default: next to the video)
--name NAME Name prefix of the files
--frames FIRST LAST Frame range
--format csv|xlsx|txt Table format
--video-out Also write the video with traces

A live session

tracell live --preset settings.json --out sessions --cells 1000 --crops both

Runs AutoTrack on the camera and writes a session folder.

Option Meaning
--partitions N, --frames N, --cells N, --seconds S Stop rule
--frames-per-partition N Frames in one partition
--crops none|with_background|without_background|both, --crop-size PX Cell crops
--record Also save the raw frames

--quiet prints only the result and errors, --debug logs more.

Where the command comes from

On Windows the installer has the option "Add the tracell command to PATH". On Linux the package and the install script both provide tracell.