Documentation

HexRootsMathlib.Pellet

theorem HexRootsMathlib.pellet {p : Polynomial } {n k : } {r : } (hn : p.natDegree < n) (hk : k < n) (hr : 0 r) (hdom : i(Finset.range n).erase k, p.coeff i * r ^ i < p.coeff k * r ^ k) :
rootsInDisc p 0 r = k

Pellet's theorem. If the k-th term strictly dominates all other terms on a circle, then the polynomial has exactly k roots in its open disc, counted with multiplicity.

theorem HexRootsMathlib.pellet_ne_zero {p : Polynomial } {n k : } {r : } (hn : p.natDegree < n) (hk : k < n) (hdom : i(Finset.range n).erase k, p.coeff i * r ^ i < p.coeff k * r ^ k) {z : } (hz : z Metric.sphere 0 r) :

Under Pellet dominance the polynomial has no zero on the boundary circle.

theorem HexRootsMathlib.pelletAt_size {cs : Array Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} (h : Hex.pelletAt cs k rlo rhi = true) :
k < cs.size

A successful executable Pellet check names an actual stored coefficient.

theorem HexRootsMathlib.pelletAt_bound {cs : Array Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} (h : Hex.pelletAt cs k rlo rhi = true) :
i(Finset.range cs.size).erase k, Dyadic.toReal (cs.getD i (0, 0)).hi * Dyadic.toReal rhi ^ i < Dyadic.toReal (cs.getD k (0, 0)).lo * Dyadic.toReal rlo ^ k

A successful executable Pellet check exposes its strict real coefficient-dominance inequality.

theorem HexRootsMathlib.pelletAt_dominates {p : Hex.ZPoly} {c : Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} {r : } (h : Hex.pelletAt (Hex.taylor p c) k rlo rhi = true) (hrlo : 0 Dyadic.toReal rlo) (hlo : Dyadic.toReal rlo r) (hhi : r Dyadic.toReal rhi) :

Dyadic lower and upper coefficient/radius bounds imply the exact coefficient dominance required by Pellet's theorem.

theorem HexRootsMathlib.pelletAt_rootsInDisc {p : Hex.ZPoly} {c : Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} {r : } (h : Hex.pelletAt (Hex.taylor p c) k rlo rhi = true) (hrlo : 0 Dyadic.toReal rlo) (hlo : Dyadic.toReal rlo r) (hhi : r Dyadic.toReal rhi) :

One successful executable check implies exact Pellet soundness for any real radius lying between the supplied dyadic lower and upper bounds.

theorem HexRootsMathlib.pelletAt_ne_zero {p : Hex.ZPoly} {c : Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} {r : } (h : Hex.pelletAt (Hex.taylor p c) k rlo rhi = true) (hrlo : 0 Dyadic.toReal rlo) (hlo : Dyadic.toReal rlo r) (hhi : r Dyadic.toReal rhi) {z : } (hz : z Metric.sphere 0 r) :

The same executable check excludes roots from the boundary circle at every real radius between its dyadic bounds.

Translating the variable translates every root without changing its multiplicity or its membership in the corresponding open disc.

Scaling to square-local coordinates scales the counted disc radius by the square half-width.

theorem HexRootsMathlib.pelletAt_ne_zero_center {p : Hex.ZPoly} {c : Hex.GaussDyadic} {k : } {rlo rhi : Dyadic} {r : } (h : Hex.pelletAt (Hex.taylor p c) k rlo rhi = true) (hrlo : 0 Dyadic.toReal rlo) (hlo : Dyadic.toReal rlo r) (hhi : r Dyadic.toReal rhi) {z : } (hz : z Metric.sphere (GaussDyadic.toComplex c) r) :

The executable check excludes roots from the corresponding circle about the original Taylor centre.

The public witness is either the bounded-precision Graeffe path or the exact Taylor fallback.

A successful soft Graeffe check certifies the base circumscribed disc.

A successful soft Graeffe check certifies the doubled disc.

A successful soft Graeffe check certifies the quadrupled disc.

A Pellet witness certifies exactly k roots in the square's circumscribed open disc.

The second check certifies the same root count in the doubled disc.

The third check certifies the same root count in the quadrupled disc.

The strict base-radius inequality excludes boundary roots.

The doubled-radius inequality excludes boundary roots.

The quadrupled-radius inequality excludes boundary roots.

The k = 1 Pellet disjunct certifies one interior simple root, unique in the closed circumscribed disc.

A certified cluster contains exactly its stored multiplicity count in the enclosing square's circumscribed disc.

A certified cluster has no root on the boundary of its certified disc.