PhysTrackX

🎓 Purpose

PhysTrackX is developed to assist students in understanding physics concepts through visualization and data analysis. It encourages curiosity, supports hands-on learning, and bridges theoretical concepts with practical application.

This software was created by Isam Abdullah Balghari under the mentorship of Dr. Muhammad Sabieh Anwar.

---

PhysTrackX is a user-friendly, visually engaging application designed for physics education and analysis. It allows high school and early undergraduate students to interactively engage with real-world experiments using video analysis, mathematical tools, and data visualization. The software turns ordinary experiment footage into a powerful source of measurement, exploration, and understanding.

---

🌟 Features

• 📹 Import Your Own Video Experiments
  Load any experimental video to analyze frame-by-frame.

• 🎯 Interactive Axes Setup
  Easily place coordinate axes and adjust scale based on your setup.

• 📏 Object Marking & Annotation Tools
  Mark rectangles, draw shapes, or crop regions of interest.

• 🧠 OCR Integration
  Recognize textual data (like timers or scales) embedded in videos.

• 🧪 Geometry Plugin
  Visualize triangles, angles, and geometric constructs in your footage.

• 📊 Plotting Tool
  View real-time motion plots (position, velocity, acceleration) with a click.

• 💾 Save & Export Data
  Export measurements and plots as CSV or images for reporting.

• 🌌 Clean, Dark-Themed GUI
  Built with customtkinter for a smooth and modern interface.

---

💻 Installation

1. Clone the Repository

git clone https://github.com/isamabdullah88/phystrackx.git
cd phystrackx

2. Install Requirements

pip install -r requirements.txt

3. Run the App

python phystrackx.py

💾 Windows Executable

Windows .exe binary versions are available for download here. No Python installation required.

---

☕ Support This Project

If PhysTrackX has helped you or your students learn physics better, consider supporting.

Contribute to science outreach by donating to:

👉 Khwarizmi Science Society

---

📜 License & Usage

This project is licensed under the Business Source License 1.1 (BSL).

For Researchers and Students

You are free (and encouraged!) to use this software for non-commercial purposes, including:

• Academic research and thesis work.
• Personal learning and experimentation.
• Educational demonstrations.

If you use this work in your research, please provide attribution to Isam Abdullah Balghari.

For Commercial Entities

Use of this software for primary commercial advantage or monetary compensation is prohibited until the Change Date (March 18, 2030). On that date, the license will automatically convert to the GNU GPLv3.

If you are interested in using this technology commercially before 2030, please contact me directly to discuss a commercial license.

---

For full details, please see the LICENSE file.

---

📬 Contact

Have suggestions, ideas, or want to collaborate?

• GitHub: github.com/isamabdullah88
• Email: isamabdullah88[at]gmail.com