Skip to content
Projects

Beam moments

The equations of beamtracer.solver.diagnostics, declared on the code that implements them and checked by the tests.

mismatch

functionsource

Return the mismatch parameter M of a beam (alpha, beta).

mismatch
M=1+12(Δ+Δ(Δ+4))−1,Δ=(α−α0)2−(γ−γ0)(β−β0),γ=1+α2βM = \sqrt{1 + \tfrac12 \left(\Delta + \sqrt{\Delta (\Delta + 4)}\right)} - 1, \qquad \Delta = (\alpha - \alpha_0)^2 - (\gamma - \gamma_0)(\beta - \beta_0), \qquad \gamma = \frac{1 + \alpha^2}{\beta}
Assumes
  • (α0,β0)(\alpha_0, \beta_0) the design Twiss parameters; M=0M = 0 for a matched beam
References

plane_moments

functionsource

Return the BeamMoments of the trajectories crossing a plane.

mean
⟨⋅⟩=∑k∣Ik∣ (⋅)∑k∣Ik∣over the forward crossings of the plane\langle \cdot \rangle = \frac{\sum_k |I_k|\, (\cdot)}{\sum_k |I_k|} \quad \text{over the forward crossings of the plane}
rings
⟨x2⟩=12⟨r2⟩,⟨x′2⟩=12⟨r′2+a′2⟩,⟨xx′⟩=12⟨rr′⟩,r′=vrvx, a′=vθvx\langle x^2 \rangle = \tfrac12 \langle r^2 \rangle, \quad \langle x'^2 \rangle = \tfrac12 \langle r'^2 + a'^2 \rangle, \quad \langle x x' \rangle = \tfrac12 \langle r r' \rangle, \qquad r' = \frac{v_r}{v_x}, \ a' = \frac{v_\theta}{v_x}
planar
⟨y2⟩, ⟨y′2⟩, ⟨yy′⟩ about their means,y′=vyvx\langle y^2 \rangle, \ \langle y'^2 \rangle, \ \langle y y' \rangle \ \text{about their means}, \qquad y' = \frac{v_y}{v_x}
emittance
ε=⟨x2⟩⟨x′2⟩−⟨xx′⟩2,εn=ε⟨vx⟩c\varepsilon = \sqrt{\langle x^2 \rangle \langle x'^2 \rangle - \langle x x' \rangle^2}, \qquad \varepsilon_n = \varepsilon \frac{\langle v_x \rangle}{c}
twiss
α=−⟨xx′⟩ε,β=⟨x2⟩ε,γ=⟨x′2⟩ε\alpha = -\frac{\langle x x' \rangle}{\varepsilon}, \qquad \beta = \frac{\langle x^2 \rangle}{\varepsilon}, \qquad \gamma = \frac{\langle x'^2 \rangle}{\varepsilon}
Assumes
  • cylindrical: each trajectory a ring, projected on one transverse plane and averaged over the azimuth (no mean subtracted), which removes the cross term ra′r a'
  • non-relativistic: εn\varepsilon_n uses β=⟨vx⟩/c\beta = \langle v_x \rangle / c only
  • no crossings or zero current give NaN moments; ε=0\varepsilon = 0 gives NaN Twiss parameters; a negative ε2\varepsilon^2 (round-off) is clipped to 0