Skip to content

Installation Guide

Atiyeh Ahmadi edited this page Jun 11, 2025 · 9 revisions

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:

git clone https://github.com/Ati-74/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

Clone this wiki locally