#!/usr/bin/env python3
"""Recalculate the worked numbers in the BGA defects article.

- Local board bow under a package: sagitta scales with L^2 for uniform curvature,
  so local bow = global bow * (package_span / board_span)^2.
- Corner contact budget: margin = paste height - package corner lift - board lift
  at the site (positive margin keeps contact, to first order).
- Via-in-pad wicking volumes: ball sphere, paste metal at 50 vol%,
  open through-via and unfilled microvia cylinders.
"""
import math

# --- Local bow under a 35 mm package on a 200 mm board with 0.75% bow ----------
board_span, package_span, bow_pct = 200.0, 35.0, 0.0075
global_bow = bow_pct * board_span                      # 1.5 mm across the board
local_bow_um = global_bow * (package_span / board_span) ** 2 * 1000
print("Global bow = {:.2f} mm; local under 35 mm pkg = {:.1f} um"
      .format(global_bow, local_bow_um))

# --- Corner contact budget (0.50 mm ball) -------------------------------------
print("\nCase | paste um | pkg lift um | board um | margin um")
for name, paste, pkg, brd in [
    ("A moderate pkg, flat board", 125, 50, 0),
    ("B opposite-direction bends", 125, 80, local_bow_um),
    ("C board bends with pkg", 125, 80, -local_bow_um),
    ("D as B, stencil to 100 um", 100, 80, local_bow_um)]:
    print("{:<28s} {:>4d} {:>4d} {:>+7.1f}  -> {:+.1f}".format(name, paste, pkg, brd, paste - pkg - brd))

# --- Via wicking volumes -------------------------------------------------------
def sphere_mm3(d): return 4 / 3 * math.pi * (d / 2) ** 3
def cyl_mm3(d, h): return math.pi * (d / 2) ** 2 * h

ball = sphere_mm3(0.50)
paste = cyl_mm3(0.45, 0.125) * 0.50        # aperture deposit x metal fraction
via = cyl_mm3(0.20, 1.6)
mvia = cyl_mm3(0.10, 0.075)
print("\nBall 0.50 mm          = {:.4f} mm3".format(ball))
print("Paste metal (50 vol%) = {:.4f} mm3".format(paste))
print("Open via 0.20 x 1.6   = {:.4f} mm3  = {:.1f}x paste metal, {:.0f}% of ball"
      .format(via, via / paste, 100 * via / ball))
print("Microvia 0.10 x 0.075 = {:.4f} mm3".format(mvia))
