README.md

Vertebrae Tracker - Particle Filter

---

Vertebraes tracking using particle filter with polyroi package.

📝 Table of Contents

• 📝 Table of Contents
• 🧐 Problem Statement
• ⛓️ Dependencies / Limitations
• 🚀 Future Scope
• 🏁 Getting Started
  • Prerequisites
  • Installing
• 🎈 Usage
• ⛏️ Built With
• ✍️ Authors
• 🎉 Acknowledgments

🧐 Problem Statement

One of the main problems we face during our tries to track multiple vertebraes is the low quality of image sequences.

• IDEAL: We want to create an application to track multiple vertebraes at the same time. Export the image of each vertebrae during each iterations.

• REALITY: Currently we can track one vertebrae but working on a method to choose the best particle that maximize the likelihood.

• CONSEQUENCES: we will fail to export the best particle's vertebrae images.

⛓️ Dependencies / Limitations

• As you increase the instances of particles and trackers, the performence get affected.
• This is one of the setbacks of the particle filter method.

🚀 Future Scope

Create a GUI to help configure the expirements before launch.

🏁 Getting Started

Here are the thisngs you need to have up and ready before using this script.

Prerequisites

What things you need to install the software and how to install them.

pip install opencv-python
pip install numpy
pip install polyroi 

Installing

You can launch the script using this command.

python main.py -v tiw.avi -np 200 -vs 4 -vr 7

🎈 Usage

Parameters:

-v : Video

-np : particles number

-vs : Vertebraes speed

-vr : vertebraes rotation

⛏️ Built With

• polyroi - polyroi
• opencv - OpenCV
• Numpy - NumPy

✍️ Authors

• @skywolfmo - Idea & Initial work
• @SaidiSouad - Collaborator

See also the list of contributors who participated in this project.

🎉 Acknowledgments

• https://stackoverflow.com/a/30902423/6512445
• https://stackoverflow.com/questions/15341538/numpy-opencv-2-how-do-i-crop-non-rectangular-region/15343106#15343106
• https://github.com/hbenbel/VOIR
• https://pypi.org/project/polyroi/