Align course direction plots

Tools for performing mixed integer optimization linear fit to course direction along with affine transform.

Reference

The mathematics and concepts behind this code package are described in a preprint:

https://www.biorxiv.org/content/10.64898/2026.07.21.739673v1

If you are inspired by this analysis, or use our code, please cite the preprint.

Install

1. Install requirements: pip install -r requirements.txt
2. Install the package: pip install git+https://github.com/vanbreugel-lab/align_course_direction_analysis.git
3. Get an academic GUROBI license (academic named-user recommended): link

See example directory for usage

See Houle et al for math and explanation