pyfracval.experimental.gamma_expansion

Archived CCA gamma-expansion fallback.

Incrementally widens the contact distance (gamma_pc) and retries rigid sticking when the first attempt fails. Benchmarked against no expansion at all in the hard regime (see docs/source/experiments.md): lands within noise of the vanilla baseline - the underlying problem is geometric frustration, and relaxing the contact-distance constraint by a few percent doesn’t open up an overlap-free orientation that wasn’t already unreachable.

Kept reachable via cca_gamma_expansion_enabled for anyone who wants to try a much larger expansion budget later.

Tightly coupled to pyfracval.cca.aggregator.CCAggregator state (telemetry counters, the _gamma_pc_override/_gamma_real_override side-channel _perform_cca_sticking reads, and _perform_cca_sticking itself) - takes the aggregator instance directly rather than trying to decouple what is inherently an extension of its sticking-attempt loop.

Module Contents

pyfracval.experimental.gamma_expansion.run_gamma_expansion(aggregator, cluster_idx1, cluster_idx2, cluster_props_cache, n1, n2, m1, rg1, cm1, r_max1, radii1_in, m2, rg2, cm2, r_max2, radii2_in)

Retry sticking with an incrementally widened gamma_pc until success.