Installation Guide

TrackRefiner supports Python 3.9 to 3.12 and can be installed using Conda, pip, or directly from source.

Option 1: Install via Conda

You can install TrackRefiner using Conda with the following command:

conda create -n trackrefiner -c ingalls-lab trackrefiner python=3.12
conda activate trackrefiner

Create a Conda Environment (optional but recommended)

Before exploring other options, it is recommended to create an isolated environment for TrackRefiner to ensure a smooth setup and avoid conflicts with other tools.

Here's how you can set it up:

Create a new environment named Trackrefiner by running the following command in your terminal:

conda create -n Trackrefiner python=3.12
conda activate Trackrefiner

Option 2: Install via pip

You can install TrackRefiner directly using pip:

pip install TrackRefiner

Option 3: Install from Source

TrackRefiner can also be installed from source by following these steps:

Clone the TrackRefiner Repository

Use the Git command to clone the TrackRefiner repository to your local machine:

https://github.com/ingallslab/Trackrefiner.git

Install TrackRefiner

Navigate to the directory containing the cloned repository. Then, install TrackRefiner and its dependencies in editable mode using:

cd Trackrefiner
pip install -e .

Dependencies

TrackRefiner relies on the following libraries:

• Numpy (version 1.26.4)
• Scipy
• Pandas (version ≥ 2.2.2)
• Scikit-learn
• Matplotlib
• OpenCV-python
• Scikit-image
• Psutil
• Seaborn
• PyQt5