How the Pool Water Troubleshooting Wizard Works
This diagnostic tool uses a decision-tree engine that cross-references four key symptom dimensions — water color, wall texture, CYA (stabilizer) level, and pH — to narrow your pool problem down to the single most likely root cause. Rather than one-size-fits-all advice, it delivers a personalized 3-step treatment protocol based on the specific chemistry and physics of your situation.
Diagnostic Logic Behind the Tool
The wizard maps 10 distinct pool conditions across a symptom matrix. Here is the underlying diagnostic grid:
| Symptom | Most Likely Cause | Key Indicator |
|---|---|---|
| Green + Slimy walls | Green Algae Bloom | Low FC allowed algae to colonize surfaces |
| Green + Rough/dark spots | Black Algae | Waxy coating resists normal chlorine levels |
| Green + Smooth + High CYA | Chlorine Lock | CYA >80 ppm binds FC into inactivity |
| Green + Smooth + Normal CYA | Early Stage Algae | FC dropped below 7.5% of CYA threshold |
| Cloudy + High pH | Calcium Precipitation | pH >7.8 triggers CaCO3 coming out of solution |
| Cloudy + Normal pH/CYA | Dead Algae / Filtration | Particles pass through underperforming filter |
| Cloudy + Low CYA | Bacterial Bloom | Insufficient sanitizer allowed rapid bacteria growth |
| Yellow/Mustard tint | Mustard Algae | Chlorine-resistant; spreads via equipment |
| Clear + Strong “chlorine” odor | Chloramines (Combined Chlorine) | CC >0.5 ppm; ammonia-bound chlorine |
| Brown/Tea-colored | Metal Contamination | Iron, copper, or manganese oxidation |
Key Chemistry Principles Referenced
- FC/CYA Ratio: The industry-standard benchmark (per CDC and ANSI/APSP standards) that free chlorine should be maintained at a minimum of 7.5% of the cyanuric acid level to prevent algae. SLAM-level targets use 40% of CYA for green algae and 60% for mustard algae.
- Breakpoint Chlorination: The stoichiometric principle that 10x the combined chlorine (CC) reading is needed to fully oxidize chloramines into nitrogen gas and water, eliminating the “chlorine smell” and eye irritation.
- LSI (Langelier Saturation Index): Governs calcium carbonate equilibrium. When pH exceeds 7.8, the LSI tilts positive, and dissolved calcium precipitates as visible cloudiness — a physics problem, not a sanitation problem.
- CYA Over-Stabilization: Cyanuric acid binds reversibly to chlorine (equilibrium chemistry). Above ~70–80 ppm, the equilibrium shifts so far that the free, active chlorine fraction drops below the level needed to kill algae, even though a DPD test still reads “normal” FC.
Pool Water Troubleshooting FAQs
This is almost always a CYA (stabilizer) issue. If your cyanuric acid level is above 80–100 ppm, the chlorine molecules are bound so tightly to the stabilizer that they cannot effectively sanitize. Your test kit will show adequate Free Chlorine, but the active (hypochlorous acid) fraction is too small to kill algae. The wizard checks for this exact scenario — if your walls feel smooth but water is green with high CYA, it flags Chlorine Lock and recommends a partial drain as the only reliable fix. Adding more chlorine without lowering CYA compounds the problem because most chlorine products (tablets, dichlor) add even more stabilizer.
When chemistry is balanced but water stays hazy, the culprit is almost always mechanical — your filter is not capturing fine suspended particles. Possible causes: a sand filter that needs backwashing or has channeled sand, a cartridge that needs deep-cleaning or replacement, a DE filter with torn grids, or simply insufficient pump run time (less than 8 hours/day). Dead algae cells from a previous shock treatment that were never vacuumed to waste will also remain suspended indefinitely. The wizard directs you to deep-clean your filter, add a clarifier to coagulate fine particles, and verify you are achieving at least 2 full water turnovers per day.
Mustard algae (yellow algae) has three distinguishing traits: (1) it appears as a yellow-brown dust or film — never bright green; (2) it favors shaded areas of the pool (under ledges, on the shady side of walls, behind ladders); and (3) it brushes off easily but returns within 24 hours, often in the exact same spots. Green algae, by contrast, turns the entire water column green, makes walls slimy, and responds quickly to normal shock levels. The diagnostic wizard treats these as completely separate conditions because mustard algae requires roughly 50% higher chlorine levels (60% vs 40% of CYA) and demands that you sanitize all pool equipment and swimwear to prevent reinfection.
The sharp ‘chlorine smell’ is not chlorine — it is chloramines (combined chlorine), formed when free chlorine reacts with ammonia from sweat, urine, and skin oils. The nose detects trichloramine gas off-gassing from the water surface. A well-sanitized pool with adequate free chlorine and zero combined chlorine has virtually no odor. This is the single most misunderstood pool chemistry fact: ‘too much chlorine smell’ actually means ‘not enough free chlorine to oxidize the waste.’ The wizard’s chloramines diagnosis calculates your breakpoint target — you need to add 10x the combined chlorine reading to fully oxidize the chloramines — which often means shocking with much more chlorine than pool owners expect.
Yes, absolutely. A saltwater chlorine generator (SWG) produces the exact same sanitizing agent — hypochlorous acid — as manually added chlorine. The diagnostic logic (FC/CYA ratio, breakpoint chlorination, calcium saturation) applies identically. The only operational difference is that SWG pools tend to have a naturally rising pH (due to hydrogen gas off-gassing at the cell), which makes them slightly more prone to calcium clouding. If the wizard diagnoses calcium precipitation for your saltwater pool, pay extra attention to maintaining pH at 7.4–7.6 with regular acid additions, and check your salt cell for scale buildup.