VacuityReport

class VacuityReport(val pairs: Long, val strictAncestorPairs: Long, val concurrentPairs: Long, val steps: Int, val effectiveRetireSteps: Int, val noOpSteps: Int, val floors: VacuityFloors)

What one binding's generator actually searched, measured by LatticeLawHarness.measureVacuity and checked against VacuityFloors.

The counts are carried alongside the rates on purpose. A rate on its own is unreadable when the denominator is small — "0.0% retiring" over 6 steps and over 600 are very different claims — and the raw counts are what makes a drift diagnosable rather than merely visible.

Parameters

pairs

ordered pairs of distinct pool positions, summed over the seeds measured.

strictAncestorPairs

pairs (a, b) with a strictly below b. See VacuityFloors — only one direction of a comparable pair counts, so this tops out at half of pairs.

concurrentPairs

pairs where neither state is below the other. Both directions count.

steps

ops applied by the pool builder. Absorbing a peer's state is not one.

effectiveRetireSteps

steps whose op is OpKind.RETIRE and which changed the state.

noOpSteps

steps of any kind that left the state unchanged.

floors

the bounds these were measured against, so a printed report is self-contained.

Constructors

Link copied to clipboard
constructor(pairs: Long, strictAncestorPairs: Long, concurrentPairs: Long, steps: Int, effectiveRetireSteps: Int, noOpSteps: Int, floors: VacuityFloors)

Properties

Link copied to clipboard
Link copied to clipboard

Fraction of pairs that are concurrent.

Link copied to clipboard

Fraction of steps that retired something and changed the state.

Link copied to clipboard
Link copied to clipboard
Link copied to clipboard

Fraction of steps that changed nothing.

Link copied to clipboard
Link copied to clipboard
val pairs: Long
Link copied to clipboard
val steps: Int
Link copied to clipboard
Link copied to clipboard

Fraction of pairs that are strict-ancestor pairs. A total order reads 0.5.

Functions

Link copied to clipboard
open override fun toString(): String