Seiberg–Witten periods and couplings
Before this lesson: Calculate the periods and effective coupling.
A plausible complex number is not yet a period. Its sign remembers an oriented cycle, its units remember a scale, and its derivative determines a physical coupling. This lab makes those choices testable. We will evaluate the same periods by direct quadrature and by transporting initial data with a differential equation, then deliberately report the wrong ratio and watch a simple test reject it.
The required preparation is periods and the effective coupling. The final instanton-coefficient section additionally requires the one-instanton calculation. You can complete the main program and the first two exercises before that extension.
Fix the theory, scale and sheet
Section titled “Fix the theory, scale and sheet”We study flat four-dimensional N=2 pure Yang–Mills: eight real supercharges, manifest as four in N=1 notation, no hypermultiplets, and an unbroken eight-charge Coulomb vacuum with generic low-energy gauge group . There is no curved background in the main calculation. The answer describes the two-derivative Wilsonian action; it does not enumerate stable BPS particles.
Use the first-paper convention with , ordinary fundamental trace, and classical eigenvalues chosen so that . For real positive ,
Initially . The electric cycle follows with negative real and returns on the other sheet. The magnetic cycle follows with positive imaginary and returns on the other sheet. Thus and . Both legs are included. These are the original period integrals, (6.22)–(6.23), with the branch choice made explicit.
Let be a fixed mass unit. The program accepts the dimensionless scale and coordinate , and calculates , . Dimensions are , and . Derivatives denoted by primes below are with respect to . Consequently , not .
We restrict the program to , . The straight path from lies wholly in . The square roots in the following integrals have positive real part there, so continuation from the real ray is unambiguous. This restriction deliberately excludes the singularities and loops around them; those require a separately specified continuation path.
Two computations with different failure modes
Section titled “Two computations with different failure modes”Removing square-root endpoints from the contour integrals gives smooth finite intervals:
The electric substitution is , with the reversed limits absorbed. For the magnetic contour use . These substitutions remove endpoint singularities rather than cutting off the contour short of its endpoints.
The derivative data are
Differentiating the second integral in (LAB13.2) initially gives an expression with both and a denominator cubed. Integration of the derivative of , whose boundary values vanish, reduces it to (LAB13.3). Differentiating an integral and simply omitting its moving factor would fail this check.
The second computation uses the derived period equation, independently recognizable in Bilal, (6.4), (6.11):
For a local series , set and . Matching the coefficient of gives
The program evaluates this polynomial and its derivative, moves to the next disk, and repeats. Each step is at most a fraction of the distance to the nearest puncture . Only the starting values at come from quadrature; no contour integral or elliptic function is called during a continuation step. The default comparisons use and . Changing both order and step size separates series truncation from arithmetic precision.
A third check evaluates the explicit elliptic functions from the lesson, with parameter , not modulus . The derivative ratio is . At , , so exactly. In contrast, there. This is why the diagnostic can catch a wrong coupling even when the periods themselves are correct.
Read the errors before trusting the result
Section titled “Read the errors before trusting the result”The equation has no term. Differentiating and using (LAB13.4) therefore gives . The contour normalization fixes
The Wronskian checks relative normalization as well as numerical drift. Positivity checks a physical local-frame condition. Neither alone proves that the initial cycles were the intended ones: adding an integer multiple of to preserves and while shifting . The base-point data and specified cycles still matter.
For comparing computed numbers , the program reports . All tested equalities must be below ; the absolute Wronskian error has its own field. It repeats quadrature at twenty additional decimal digits. These are finite convergence diagnostics, not interval-certified error bounds. Near , more disks and a sharper endpoint profile are expected. A high precision setting does not repair a wrong branch, normalization or coupling definition.
Weak coupling supplies a different, asymptotic check. Expanding the electric integrand and using the average gives
Thus approaches , while the remainder after subtracting the first correction decreases by roughly sixteen when doubles. This error is omitted asymptotic terms, not quadrature noise.
Run the portable calculation
Section titled “Run the portable calculation”Download the complete lab (ZIP) with the program, pinned dependencies, reference output and run instructions.
Save the Python program, pinned requirements, default output and output with the instanton extension in one directory. Python 3.10 or later and mpmath 1.3.0 suffice. The program uses no site files, online service or random input.
python -m venv .venv.venv/Scripts/python.exe -m pip install -r requirements.txt.venv/Scripts/python.exe sw_periods.py.venv/Scripts/python.exe sw_periods.py --real 5 --imag -0.7 --scale 2.venv/Scripts/python.exe sw_periods.py --swap-period-ratioOn macOS or Linux use .venv/bin/python. Input decimal strings specify
and ; --dps 40 through --dps 100 changes working
precision. The default is , , with fifty digits.
| Default quantity | Result, rounded |
|---|---|
| Maximum scaled quadrature/ODE difference, order 40 | or smaller |
| Same comparison, order 60 | At the fifty-digit rounding scale |
The reference JSON retains fourteen significant digits of values and diagnostic errors; the last error digits can depend on arithmetic details. The negative mode intentionally fills reported_coupling with the period ratio. Its base-point test becomes false and intentional_ratio_error_detected becomes true. The correctly computed derivative ratio remains separately visible. A program that prints many successful arithmetic checks while reporting the wrong observable has not solved the physical problem.
Compare a first instanton coefficient
This extension uses the extra preparation SW16. Run sw_periods.py --instanton. The parent theory is unchanged; the microscopic computation temporarily introduces the Euclidean rotational parameters and its chosen localization supercharge. It is not a second flat-space vacuum with a different SUSY count.
Nekrasov, (1.3)–(1.5), introduces the instanton generating function. To evaluate its first coefficient we use the explicit Euler orientation and imaginary equivariant coordinate of Nakajima–Yoshioka, Theorem 3.2 and §4.2, with the full translation derived in SW16:
Here is the code’s b and is an instanton fugacity of mass dimension four, not the Taylor order . The magnetic source period is and its period matrix is ; changing the electric coordinate alone would miss this factor. These are the matched curve/differential conventions, not an integral relabeling of the original charge lattice.
Put . The two one-box fixed points have tangent weights and . Summing their inverse products gives
The logarithm is expanded in before removing the regulator, as in NY, §5. At first order its coefficient is . At fixed nonzero fugacity, taking the logarithm of a one-instanton truncation and then removing the regulator is a different, nonuniform limit.
Using (LAB13.8) and differentiating with respect to the site’s gives
Compare this with the independently integrated periods through
Use the positive weak ray and its real logarithm. The constant and subtraction follow from the previously matched period expansion; they are not fitted to this comparison. The program evaluates the coefficient along , at fixed , and the period diagnostic at :
| Difference from | ||
|---|---|---|
The shrinking difference is a higher-instanton/asymptotic remainder. It should not be forced below the equality tolerance at finite . The comparison tests this coefficient and its dictionary, not an all-order instanton-counting theorem.
Exercises
Section titled “Exercises”1. A normalization that the coupling misses
Section titled “1. A normalization that the coupling misses”Suppose the return leg is accidentally omitted from both period contours and their derivatives. Predict the coupling, base-point test and Wronskian. Which test catches the error? What happens to the BPS mass bound for a fixed charge row?
Hint 1
Each closed-cycle integral contains two equal contributions. Apply the same factor to values and derivatives.
Hint 2
The coupling is a ratio; the Wronskian is bilinear. Use .
Solution
All four numbers are halved. The derivative ratio and test are unchanged, but becomes , a quarter of the required . The absolute normalization test catches the missing sheet. For fixed , and the bound are halved. Relabeling the same integer charges does not repair the normalization. This bound still does not establish that a stable particle of each charge exists.
2. Change the scale or change the vacuum
Section titled “2. Change the scale or change the vacuum”At fixed , multiply by two. Predict all four dimensionful output entries and . Then explain why holding the dimensionful fixed instead is a different experiment. Finally, at the default complex point, does conjugating simply conjugate both periods?
Hint 1
Use and . Holding fixed sends to .
Hint 2
In the chosen patch is real on the positive ray, while contains an explicit factor of .
Solution
At fixed , and double; and halve. Their ratio is unchanged, and the Wronskian in dimensionful variables is unchanged. At fixed , the coordinate becomes , changing the elliptic parameter and the coupling; it may even leave this program’s domain.
The real coefficients and positive-root continuation give but , and the same rule for derivatives. Consequently retains positive imaginary part. Conjugating both periods without the magnetic minus sign would select the wrong orientation.
3. Separate regulator error from instanton error
Section titled “3. Separate regulator error from instanton error”After SW16, use , to derive the leading error in . If both and are halved, what different quantities approach their limits, and why is neither convergence an arithmetic-precision estimate?
Hint 1
Insert and in (LAB13.9) before expanding.
Hint 2
The next instanton contribution to scales as . Multiply it by the prefactor in .
Solution
The regulated coefficient is . Halving quarters its leading deviation from ; this is a residual rotational deformation. Meanwhile on the weak ray, so doubling quarters that leading deviation. This second remainder comes from higher instanton terms in the exact periods. Increasing decimal precision at fixed resolves the same nonzero deviations more accurately; it removes neither. The two limits concern different calculations, and each must retain its own control parameter.