shrutimalik123/the-compounding-clarifier-support-vector-machine-svm-quality-shield

The Compounding Clarifier: SVM Quality Shield is a Python teaching tool built as a small interactive game. It walks a player through the core ideas behind Support Vector Machines, a method used in machine learning to separate data into two groups. Instead of an abstract math lesson, the game frames everything around a pharmacist checking IV bags for sterility, using two made up sensor readings, refractive index and particulate scattering, as the data points to classify. Playing the game means acting as a quality assurance pharmacist. You look at past sterile validation records, each with two numeric readings and a label of sterile or contaminated. The game shows you a hyperplane, a dividing line placed to keep as much space as possible between the two groups of readings, and explains how a handful of the closest readings on each side, the support vectors, are what pin that line in place. When a new, borderline reading comes in, the game runs it through a simple formula and reports whether it passes as safe or trips a contamination alert. Everything runs from a single Python script with no extra libraries or matrix math tools installed, so it depends only on Python 3 being available. You clone the repository, save the provided script, and run it from the command line. There is no setup beyond that, and no persistent installation. This is meant purely as an educational demo rather than a real quality control system: it does not connect to actual lab equipment or handle real patient data. It is aimed at students or beginners who want a hands on, story driven way to understand how a maximum margin classifier decides where to draw its boundary, using clear categorical outcomes, a sterile pass or a contamination lock, instead of probability scores.