Generator

reversal

One function in the relacc library, called 6 times across 1 essay. Below: what it draws at its defaults, what it draws at every value an essay asks for, the 11 claims it put to the test while drawing them, and where it stands against the rule this site is named for.

At its defaults it draws the same four routes on a bidiagonal whose entries are all 1 or 2^12. Nothing about this matrix is graded: every entry is within a factor of 4096 of every other. Its singular values are not — 7 of them are clustered near 4096.9 and the last is 5.17·10⁻²⁶, a spread of 29 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 0.0145. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 5.55·10⁻¹⁶ in 16.

reversal is one function in lib/figures/relacc.js — relative accuracy — small compared to what, against an exact rational answer. Everything below came out of it during this build, at arguments taken from the essays rather than invented for this page. A figure here is the figure a reader meets in an essay, and if the generator changes, this page changes with it.

At its defaults

Drawn even though every essay passes arguments — which on this site is every essay, at 100% of placements since the standard pass. A default nothing exercises is a trap for the next essay to call this with none, and this is the page where a default that has drifted from the figures around it becomes visible.

The same four routes on a bidiagonal whose entries are all 1 or 2^12Nothing about this matrix is graded: every entry is within a factor of 4096 of every other. Its singular values are not — 7 of them are clustered near 4096.9 and the last is 5.17·10⁻²⁶, a spread of 29 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 0.0145. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 5.55·10⁻¹⁶ in 16.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly5.2·10⁻²⁶Jacobi's error on it0.015sweeps, zero shift400sweeps, shifted16a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 4096 of every other. Its singular values are not — 7 of them are clustered near 4096.9 and the last is 5.17·10⁻²⁶, a spread of 29 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 0.0145. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 5.55·10⁻¹⁶ in 16.

bits: 12

The arguments are the ones Accurate is not a property of a method passes. A value drawn at the generator's defaults instead would be a picture no essay asked for and no assertion has been run against.

The same four routes on a bidiagonal whose entries are all 1 or 2^12Nothing about this matrix is graded: every entry is within a factor of 4096 of every other. Its singular values are not — 7 of them are clustered near 4096.9 and the last is 5.17·10⁻²⁶, a spread of 29 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 0.0145. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 5.55·10⁻¹⁶ in 16.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly5.2·10⁻²⁶Jacobi's error on it0.015sweeps, zero shift400sweeps, shifted16a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 4096 of every other. Its singular values are not — 7 of them are clustered near 4096.9 and the last is 5.17·10⁻²⁶, a spread of 29 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 0.0145. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 5.55·10⁻¹⁶ in 16.

bits: 4

The arguments are the ones Accurate is not a property of a method passes. A value drawn at the generator's defaults instead would be a picture no essay asked for and no assertion has been run against.

The same four routes on a bidiagonal whose entries are all 1 or 2^4Nothing about this matrix is graded: every entry is within a factor of 16 of every other. Its singular values are not — 7 of them are clustered near 16.929 and the last is 3.711·10⁻⁹, a spread of 10 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 1.6·10⁻¹³. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 8.66·10⁻¹⁶ in 17.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly3.7·10⁻⁹Jacobi's error on it1.6·10⁻¹³sweeps, zero shift400sweeps, shifted17a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 16 of every other. Its singular values are not — 7 of them are clustered near 16.929 and the last is 3.711·10⁻⁹, a spread of 10 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 1.6·10⁻¹³. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 8.66·10⁻¹⁶ in 17.

bits: 8

The arguments are the ones Accurate is not a property of a method passes. A value drawn at the generator's defaults instead would be a picture no essay asked for and no assertion has been run against.

The same four routes on a bidiagonal whose entries are all 1 or 2^8Nothing about this matrix is graded: every entry is within a factor of 256 of every other. Its singular values are not — 7 of them are clustered near 256.92 and the last is 1.388·10⁻¹⁷, a spread of 19 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 1.32·10⁻⁷. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 7.8·10⁻¹⁶ in 17.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly1.4·10⁻¹⁷Jacobi's error on it1.3·10⁻⁷sweeps, zero shift400sweeps, shifted17a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 256 of every other. Its singular values are not — 7 of them are clustered near 256.92 and the last is 1.388·10⁻¹⁷, a spread of 19 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 1.32·10⁻⁷. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 7.8·10⁻¹⁶ in 17.

bits: 6

The arguments are the ones Accurate is not a property of a method passes. A value drawn at the generator's defaults instead would be a picture no essay asked for and no assertion has been run against.

The same four routes on a bidiagonal whose entries are all 1 or 2^6Nothing about this matrix is graded: every entry is within a factor of 64 of every other. Its singular values are not — 7 of them are clustered near 64.925 and the last is 2.273·10⁻¹³, a spread of 14 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 9.44·10⁻¹⁰. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 1.67·10⁻¹⁵ in 17.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly2.3·10⁻¹³Jacobi's error on it9.4·10⁻¹⁰sweeps, zero shift400sweeps, shifted17a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 64 of every other. Its singular values are not — 7 of them are clustered near 64.925 and the last is 2.273·10⁻¹³, a spread of 14 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 9.44·10⁻¹⁰. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 1.67·10⁻¹⁵ in 17.

bits: 10

The arguments are the ones Accurate is not a property of a method passes. A value drawn at the generator's defaults instead would be a picture no essay asked for and no assertion has been run against.

The same four routes on a bidiagonal whose entries are all 1 or 2^10Nothing about this matrix is graded: every entry is within a factor of 1024 of every other. Its singular values are not — 7 of them are clustered near 1024.9 and the last is 8.47·10⁻²², a spread of 24 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 3.39·10⁻⁵. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 9.99·10⁻¹⁶ in 16.1234567810⁻¹⁷10⁻¹⁴10⁻¹¹10⁻⁸10⁻⁵10⁻²10¹singular value, largest firstrelative errorone-sided Jacobizero-shift QRshifted QReigenvalues of BᵀBthe same four routes, reversedσ_min, exactly8.5·10⁻²²Jacobi's error on it3.4·10⁻⁵sweeps, zero shift400sweeps, shifted16a method is not accuratea method on a matrix is

Nothing about this matrix is graded: every entry is within a factor of 1024 of every other. Its singular values are not — 7 of them are clustered near 1024.9 and the last is 8.47·10⁻²², a spread of 24 decades. Every ordering from the graded family turns over. One-sided Jacobi, which held everything there, returns the 7 large values exactly and σ_min wrong by a relative 3.39·10⁻⁵. The zero-shift sweep, which has the theorem behind it, does not converge at all — 400 sweeps and still running. The shifted sweep, which the theorem is a warning about, gets every value to 9.99·10⁻¹⁶ in 16.

What it checked while drawing

Every figure above asserted its own claims on the way to being drawn, and a claim that failed would have failed the build rather than drawn a wrong picture. Those assertions used to leave no trace at all: a passing one returned true and the only evidence the figure had checked anything was that nothing crashed. The list below is what they actually said, collected by running this generator with an observer installed — not a description of what it is believed to check.

11 distinct claims across 6 sets of arguments, grouped below by shape — because most of them are one sentence with a different number in it, and how many separate times that sentence was put to the test is the informative part.

a finite number to convert exactly

a size the exact bisection can afford

a superdiagonal inside the range the exact route can bracket

a value that is a dyadic rational, which every float is

and at this superdiagonal it still gets the small one

and gets the small one wrong, which is the one it is recommended for

and the shifted one gets everything, in a few sweeps

Jacobi needs a symmetric matrix

matmul shapes agree

one-sided Jacobi gets every large singular value exactly

the zero-shift sweep does not converge on this family at all

Against the rule

It draws a decomposition and prints its residual. It calls viaJacobi, viaNormalEquations, bidiagQR, exactSingularValues, and every figure above carries the badge — which residualcheck verifies by looking for it in the emitted SVG rather than by finding the call that builds one. A badge that is constructed and then left out of the body is the failure that check exists for.

Across the library: the rule bites on 113 of 219 generators — 98 print a residual and 15 are exempt with a published reason; 106 factorise nothing. Read from lib/residual-rule.js, which is the same body the gate enforces from, and the gate's last check fails the build if this page and it disagree about any generator.

Where it is called

Changing this generator changes every figure on this list. That is what makes the list worth publishing rather than keeping in a check script.

The whole library · All essays · What must fail