ABJM small-N partition functions
Before this lesson: The first exact partition-function checks.
An oscillatory integral can return many stable digits of the wrong limiting prescription. A positive integral can also mislead if its integration box grows faster than its numerical resolution. This lab gives each problem a separate diagnostic.
Begin with the regulated rank-one calculation. The default program needs only that lesson. The later Spectral checks section introduces an additional prerequisite and an optional program mode; you can complete the rank-one experiment and its first exercise independently.
Fix the observable before computing
Section titled “Fix the observable before computing”We use the undeformed round-sphere partition function of three-dimensional compact , with positive integer , rank at each node, and no extra quotient by the center. The generic full theory has , or twelve real Poincaré supercharges, enhanced to sixteen at . The calculation uses its sphere subalgebra. Keep , matter scalar R-charge , zero real masses and FI terms, and the original superpotential.
The dimensionless gauge scalars are and . Our first node has phase , and . These are fixed finite-rank calculations, without a large- or semiclassical approximation.
At , introduce positive Gaussian damping:
The physical prescription is , not an arbitrary rectangular oscillatory cutoff. The normalization agrees with FG (2.1) under , . KWY (3.68), (4.4) has the opposite first-node phase; exchange its nodes to compare. Its Weyl normalization is already included, with both factors trivial at rank one.
Give the Gaussian a fixed width
Section titled “Give the Gaussian a fixed width”Set and . The absolute Jacobian is one, while and . Absolute convergence at positive permits the Gaussian integration. Writing gives
The second line is the numerical representation: the integration variable always has unit width. A routine operating directly on the first line would have to resolve a peak narrowing as .
The limit is . For a useful finite-input guarantee, use , , and :
This bounds the regulator bias. Raising numerical precision cannot remove it, and is not a physical coupling.
Run the rank-one experiment
Section titled “Run the rank-one experiment”Save these three files in one directory:
Download the complete lab (ZIP) with the program, pinned dependencies, reference output and run instructions.
The tested environment is Python 3.13.7 with mpmath 1.3.0 in an isolated virtual environment. After activating such an environment, run:
python -m pip install -r requirements.txtpython small_n.pypython small_n.py --level 2No notebook, repository imports, or network calls are required by the calculation itself. The program accepts levels one through four and 40–70 working decimal digits via --dps. The default is 50 digits, with a repeat at 70. The expected-output file contains two objects: entry is the default result, and spectral is the optional run below.
For :
| Computed | Relative bias | Proven upper bound | |
|---|---|---|---|
The precision repeat differs by about at the last input. That is evidence of numerical stability for this quadrature; the physical limit is still , nearly one percent above the finite- result.
In the program, epsilon is the regulator, k the integer level, and z1_regulated implements (LAB10.2). Changing the level changes the physical theory. Changing the regulator or working precision changes how we approximate its answer.
Spectral checks
Section titled “Spectral checks”This section and --spectral require the Fermi-gas transformation. That lesson proves the relation to the regulated matrix integral and explains the auxiliary fermions. They are a representation of the sphere observable, not a replacement of ABJM by a microscopic free-fermion theory.
Keep the precisely normalized kernel on :
Here the auxiliary Planck constant is . The operator has not been rescaled to trace one. Its normalization and permutation formula are FG (3.3)–(3.8).
Let . The two permutations of two particles give
The factor and the negative exchange term are both essential. A numerical kernel matrix can compute its trace and the trace of its square separately. We also want a comparison that avoids subtracting those two quantities.
Reduce the positive pair determinant
Section titled “Reduce the positive pair determinant”Substituting the kernel shows that the square bracket is . Use and , again with unit Jacobian. Then
For the middle equality, substitute ; the integral becomes a rational integral on . Its value at is the continuous limit one. The last line uses evenness in . Both (LAB10.5) and (LAB10.6) use the same kernel measure; there is no additional .
At , put . The remaining integral is . Integration by parts reduces it to . Thus
This is a complete finite-rank answer, not the leading term of a strong-coupling expansion.
Keep three numerical controls separate
Section titled “Keep three numerical controls separate”Run:
python small_n.py --spectralpython small_n.py --spectral --level 2 --dps 60python small_n.py --spectral --omit-exchangeThe positive integral is evaluated directly. Its difference-coordinate cutoff D has an analytic omission bound:
Indeed and for . Integrating proves the bound. At , omits about ; omits about . These bounds concern the exact truncated integral, independently of quadrature accuracy.
The kernel check instead restricts both to . For Gauss–Legendre nodes and integration weights on that interval, form . Compute and . The program also sums the positive pair determinants of this same matrix, checking their algebraic agreement; that last equality alone is not an independent quadrature test.
To test the actual quadrature, integrate the center variable analytically over its finite allowed range. For ,
Use . This one-dimensional reference has the same box as the kernel matrix. Its difference from the matrix answer isolates quadrature error. Separately, the diagonal mass outside the box is . Since the positive pair determinant is at most the diagonal product, .
Representative results are:
| Box half-width | Nodes | Quadrature difference from the same-box integral | Bound on box omission |
|---|---|---|---|
At fixed 32 nodes, a larger box is worse resolved. At fixed , more nodes cannot remove the omitted tail. Increasing --dps cannot cure either error. The complete download reports all nine box/node combinations, while its precision repeat tests the positive integral at two arithmetic settings. Its top-level trace2 is reconstructed from the full positive integral; the separately evaluated kernel traces are in finite_box_kernel_checks.
The negative mode reports at instead of the correct (LAB10.7). It deliberately omits exchange, detects that discrepancy, and returns intentional_error_detected: true. A successful diagnostic exit does not endorse the wrong number. Likewise, checks_pass means the asserted identities, bounds and precision comparisons passed; it does not claim every coarse grid in the table is accurate.
Three experiments with solutions
Section titled “Three experiments with solutions”1. Cancel the leading regulator bias
Section titled “1. Cancel the leading regulator bias”This exercise needs only the rank-one entrance. Expand through order , using . Show that cancels the linear bias. At , compare its errors at and . Does the extrapolation equal the exact answer at finite input?
Hint 1
Expand as well as the prefactor .
Hint 2
A term becomes in the extrapolated combination.
Solution
The Gaussian moments in (LAB10.2) give
Consequently the combination has no term linear in , but retains minus one-half the displayed quadratic coefficient. Direct evaluation gives absolute errors and at the two requested inputs. The ratio is about , approaching four as decreases. This is quadratic improvement, not exact removal of the regulator. It also does not automatically inherit the one-sided bound (LAB10.3).
2. Change the physical level and budget the error
Section titled “2. Change the physical level and budget the error”After the spectral preparation, use . Derive from (LAB10.6), and find . Can the bound (LAB10.8) certify a difference-cutoff omission below at ? At ? Explain why that is not yet a total numerical error certificate.
Hint 1
Set and use .
Hint 2
The remaining integral involves . Differentiate .
Solution
The unnormalized integral in (LAB10.6) becomes . Including its prefactor gives . Because , the trace is .
The bounds are approximately at and at . Only the latter certifies the requested tail budget. A quadrature comparison and a precision comparison still address separate errors in evaluating the truncated integral. A box cutoff also has its own domain and bound; it cannot be substituted for .
3. Diagnose two normalization mistakes
Section titled “3. Diagnose two normalization mistakes”After the spectral preparation, consider two modifications at : dropping from (LAB10.5), or replacing by to make it a trace-one density operator. Find both incorrect two-particle answers, and identify a rank-one check that catches the second error. What physical approximation, if any, do these modifications implement?
Hint 1
Every term in the two-particle determinant is quadratic in .
Hint 2
The rank-one sphere integral is , whereas the trace of the rescaled operator is one.
Solution
Dropping exchange gives , an overestimate by . Rescaling by four gives and changes to one. In general changes by , so this is an observable normalization change.
Neither modification is a controlled approximation to the fixed observable here. The first discards the antisymmetric occupation rule of its exact auxiliary representation; the second discards the absolute normalization inherited from localization. The three-dimensional theory remains interacting. Correct auxiliary fermion statistics and the rank-one normalization are both needed to reproduce its sphere partition function.
The successful comparison is between the specified Abel limit, the normalized kernel traces, and a positive two-particle integral with explicit cutoffs. It supports these finite-rank computations. It does not establish arbitrary contour deformations, a large- expansion, or a microscopic free-fermion description.