1. Formulation ¶
* Blue-colored sentences are physical assumptions used in GKV [ 1-1 ] . This manual is based on the GKV version gkvp_f0.65 .
1.1. Governing equations ¶
One derives gyrokinetic equations based on the following gyrokinetic ordering [ 1-2 ] ,
GKV follows \(\delta f\) gyrokinetics, where distribution functions are split into equilibrium and perturbed parts \(\mathcal{F}=F+\tilde{f}\) . Additionally, there are some subsidiary assumptions:
-
separation of the equilibrium and perturbed scale lengths \(|\nabla F|/F \ll |\nabla \tilde{f}|/f\) decouples neoclassical physics from turbulent dynamics and treats flute-type perturbations
-
low \(\beta\) value justifies neglect of compressional magnetosonic waves \(\tilde{B}_\parallel\) and higher-order correction in \(\beta\) , but retains shear Alfvénic dynamics \(\tilde{A}_\parallel\)
-
the present version of GKV treat equilibrium \(\bm{E} \times \bm{B}\) flow shear effect.
-
the equilibrium distribution function is to be a local Maxwellian \(F=F_\mathrm{M}=n \left(\frac{m}{2 \pi T}\right)^\frac{3}{2} e^{-\frac{mv_\parallel^2}{2T}-\frac{\mu B}{T}}\)
-
the equilibrium magnetic field satisfies the MHD equilibrium \(\nabla P = \bm{J} \times \bm{B}\)
Then, the \(\delta f\) gyrokinetic Vlasov-Poisson-Ampère equations are
where the gyrophase-average operators \(J_{0\mathrm{s}} = \oint (d\xi/2\pi) e^{\bm{\rho}_\mathrm{s} \cdot \nabla} = \oint (d\xi/2\pi) e^{-\bm{\rho}_\mathrm{s} \cdot \nabla}\) and \(\Gamma_{0\mathrm{s}} = \int dv^3 (F_\mathrm{sM}/n_\mathrm{s}) J^2_{0\mathrm{s}}\) are used with the gyroradius vector \(\bm{\rho}_\mathrm{s} = \bm{b} \times m_\mathrm{s} \bm{v} / (e_\mathrm{s}B)\) . \(\bm{V}_E = \bm{b} \times \nabla \Phi /B\) denotes the equilibrium \(\bm{E} \times \bm{B}\) flow. The perturbed electric and magnetic fields are \(\tilde{\bm{E}} = - \nabla (J_{0\mathrm{s}} \tilde{\phi}) - \bm{b} \partial \tilde{A}_\parallel /\partial t\) and \(\tilde{\bm{B}}_\perp = \nabla (J_{0\mathrm{s}} \tilde{A}_\parallel) \times \bm{b}\) . The perturbed \(\bm{E} \times \bm{B}\) , grad-B, curvature, diamagnetic drift velocities are respectively given by \(\tilde{\bm{v}}_\mathrm{E} = \bm{b} \times \nabla (J_{0\mathrm{s}} \tilde{\phi})/B\) , \(\bm{v}_\mathrm{sG} = \bm{b} \times \mu \nabla B/(e_\mathrm{s}B)\) , \(\bm{v}_\mathrm{sC} = \bm{b} \times m_\mathrm{s} v_\parallel^2 \bm{b} \cdot \nabla \bm{b}/(e_\mathrm{s}B)\) and \(\bm{v}_{\mathrm{s}*} = \bm{b} \times [T_\mathrm{s} \nabla \ln n_\mathrm{s} + ( m_\mathrm{s} v_\parallel^2 /2+ \mu B - 3 T_\mathrm{s}/2) \nabla \ln T_\mathrm{s} ] /(e_\mathrm{s}B)\) . \(C_s\) is the linearized collision term on the species \(s\) and will be explained in Section Collision operator . The nonlinear term in the Vlasov eq. (denoted \(\mathcal{N}_\mathrm{s}\) below), which originates from \(\bm{E} \times \bm{B}\) and \(v_\parallel \tilde{\bm{B}}_\perp/B\) advections of \(\tilde{f}\) and \(\tilde{\bm{E}} \cdot \tilde{\bm{B}}_\perp\) acceleration of \(F\) , can be rewritten as,
respectively.
1.2. Geometry and coordinates ¶
The following explanation is conventional flux-tube model without equilibrium flow [ 1-3 ] . For the numerical treatment of equilibrium flow shear effects in the rotating flux-tube model, please refer to [ 1-4 ] .
When an equilibrium magnetic field is known, one can construct a flux coordinate \((\rho_f, \theta_f, \varphi_f)\) such that,
where we use the safety factor \(q(\rho_f) = d\Psi_t/d\Psi_p\) and the toroidal and poloidal flux \(\Psi_p(\rho_f)\) and \(\Psi_t(\rho_f)\) . GKV employs Clebsch-type coordinate as
where \(\rho_{f0}\) , \(c_x\) and \(c_y\) are constant. We refer \((x, y, z)\) as the radial, field-line-label, and field-aligned coordinates, respectively. Using this GKV coordinates, the equilibrium magnetic field is represented by
where \(c_b = (d\Psi_p/d\rho_f)/(c_x c_y)\) and \(\sqrt{g} = (\nabla x \cdot \nabla y \times \nabla z)^{-1}\) .
Simulation domain of GKV is based on the local flux-tube model [ 1-3 ] . Using flute approximation for perturbed quantities \(k_\perp \gg k_\parallel\) (consistent with the gyrokinetic ordering Eq. (1.1) , vector differential operators in gyrokinetic Eqs. (1.2) – (1.4) become
where \(g^{ij}=\nabla r^i \cdot \nabla r^j\) denotes the metric tensor.
Since the magnetic curvature can be replaced by
when the equilibrium satisfies the MHD equilibrium, \(\nabla P = \bm{J} \times \bm{B}\) and \(\nabla \times \bm{B} = \mu_0 \bm{J}\) ,
the magnetic (i.e., grad-B and curvature) drift velocity is given by
and then the magnetic and diamagnetic drift terms are
where
and the density and temperature scale lengths \(L_{n\mathrm{s}} = - (d\ln n_\mathrm{s}/dx)^{-1}\) , \(L_{T\mathrm{s}} = - (d\ln T_\mathrm{s}/dx)^{-1}\) , and total pressure gradient \(dP/dx = d (\sum_\mathrm{s} n_\mathrm{s} T_\mathrm{s})/dx = - \sum_\mathrm{s} n_\mathrm{s} T_\mathrm{s} (L_{n\mathrm{s}}^{-1}+L_{T\mathrm{s}}^{-1})\) .
1.3. Local approximation ¶
Simulation box \(-L_x \leq x < L_x\) , \(-L_y \leq y < L_y\) , \(-N_\theta \pi < z < N_\theta \pi\) gives flux-tube domain aligned to the equilibrium magnetic field.
By assuming the perpendicular scale separation of equilibrium and perturbed quantities, the equilibrium quantities can be evaluated by the value at the center of flux-tube domain \(x=0\) or equivalently \(\rho_f = \rho_{f0}\) . When one considers an axisymmetric equilibrium \(\partial_y=0\) , the equilibrium quantities are independent to \(x\) and \(y\) , i.e., \(F = F(z,v_\parallel,\mu)\) , \(B = B(z)\) , and so on. In a non-axisymmetric equilibrium case, one may treat a thin flux-tube domain not only in \(x\) but also in \(y\) direction and evaluate the equilibrium quantities at \(x=0\) and \(y=0\) .
1.4. Pseudo-periodic boundary condition along a field line ¶
Since the equilibrium quantities are independent to perpendicular \(x\) and \(y\) directions, one expand the distribution function and electromagnetic potentials by means of Fourier basis,
where \(\bm{x}\) is the gyrocenter coordinates and \(\bm{x}'=\bm{x}+\bm{\rho}_\mathrm{s}\) is the particle-position coordinates.
Additionally, considering the torus periodicity constraint \(\tilde{\phi}(\rho_f,\theta_f+2N_\theta\pi,\varphi_f) = \tilde{\phi}(\rho_f,\theta_f,\varphi_f)\) , one finds the pseudo-periodic boundary condition along a field line,
where \(\delta k_x = -2N_\theta \pi \hat{s} k_y, C_{k_y} = \exp (i2N_\theta \pi k_y c_y q_0)\) . This conversion along a field line physically means twisting of the mode by the parallel streaming in the presence of magnetic shear.
1.5. Collision operator ¶
The present version of GKV equips three types of gyrokinetic model collision operators, operating on the non-adiabatic part of the distribution function \(\tilde{g}_{\mathrm{s}\bm{k}} = \tilde{f}_{\mathrm{s}\bm{k}} + \frac{e_\mathrm{s} F_\mathrm{Ms}}{T_\mathrm{s}} J_{0\mathrm{s}\bm{k}} \tilde{\phi}_{\bm{k}}\) .
Note
NOTE: Although the Lenard-Bernstein model collision gkvp_f0.48 operates on \(\tilde{f}_{\mathrm{s}\bm{k}}\) but not on \(\tilde{g}_{\mathrm{s}\bm{k}}\) due to historical reason, it will be modified near-future update.
Lenard-Bernstein model collision operator
Lorentz model collision operator
Sugama model collision operator [ 1-5 ]
The test-particle differential term \(C^\mathrm{V}_\mathrm{ab}\) , the test-particle non-isothermal term \(C^\mathrm{D}_\mathrm{ab}\) , and the field-particle term \(C^\mathrm{F}_\mathrm{ab}\) are given by,
where \(x_\mathrm{a} = v / (\sqrt{2}v_\mathrm{ta})\) , \(\alpha_\mathrm{ab}=v_\mathrm{ta}/v_\mathrm{tb}\) , \(\nu_\mathrm{g}^\mathrm{ab} = \nu_\parallel^\mathrm{ab}x_\mathrm{a}^2(1-\alpha_\mathrm{ab})\) , and \(\nu_\mathrm{h}^\mathrm{ab} = 3\sqrt{\pi}\tau^{-1}_\mathrm{ab}\alpha_\mathrm{ab}\Phi'(x_\mathrm{b})/(4x_\mathrm{a}^2)\) . The energy-diffusion and deflection frequencies are respectively given by \(\nu_\parallel^\mathrm{ab} = 3\sqrt{\pi}\tau^{-1}_\mathrm{ab}G(x_\mathrm{b})/(2x_\mathrm{a}^3)\) and \(\nu_\mathrm{D}^\mathrm{ab} = 3\sqrt{\pi}\tau^{-1}_\mathrm{ab}[\Phi(x_\mathrm{b})-G(x_\mathrm{b})]/(4x_\mathrm{a}^3)\) with the error function \(\Phi(x) = \mathrm{erf}(x)\) and \(G(x) = [\Phi(x) - x \Phi'(x)]/(2x^2)\) . Expressions of the other coefficients \(X_j^\mathrm{ab}\) and \(Y_j^\mathrm{ab}\) and of the fluid moments \(M_j^\mathrm{ab}\) are found, e.g., in the literature [ 1-6 ] .
1.6. Summary of formulation ¶
Finally, one obtains the \(\delta f\) gyrokinetic Vlasov-Poisson-Ampère equations in a local flux-tube model, represented in perpendicular wave-number space,
where \(J_{0\mathrm{s}\bm{k}}=J_0(k_\perp \rho_{\mathrm{s}})\) and \(\Gamma_{0\mathrm{s}\bm{k}}=I_0(k_\perp^2 \rho_{\mathrm{ts}}^2)e^{-k_\perp^2 \rho_{\mathrm{ts}}^2}\) with 0th-order Bessel and modified Bessel functions \(J_0\) and \(I_0\) . The included operators are again listed below,
The coefficients for magnetic drift \(K_x, K_y\) are given by Eqs. (1.13) and (1.14) , and the collision operator \(C_{\mathrm{s}\bm{k}}\) is given by one of Eqs. (1.17) – (1.19) .
T.-H. Watanabe and H. Sugama. Velocity–space structures of distribution function in toroidal ion temperature gradient turbulence. Nucl. Fusion , 46(1):24, Dec 2005. doi:10.1088/0029-5515/46/1/003 .
X. Garbet, Y. Idomura, L. Villard, and T.-H. Watanabe. Gyrokinetic simulations of turbulent transport. Nucl. Fusion , 50(4):043002, Mar 2010. doi:10.1088/0029-5515/50/4/043002 .
M. A. Beer, S. C. Cowley, and G. W. Hammett. Field‐aligned coordinates for nonlinear simulations of tokamak turbulence. Phys. Plasmas , 2(7):2687–2700, Jul 1995. doi:10.1063/1.871232 .
S. Maeyama, T.-H. Watanabe, M. Nakata, M. Nunami, Y. Asahi, and A. Ishizawa. Rotating flux-tube model for local gyrokinetic simulations with background flow and magnetic shears. J. Comput. Phys. , 522:113595, 2025. doi:https://doi.org/10.1016/j.jcp.2024.113595 .
H. Sugama, T.-H. Watanabe, and M. Nunami. Linearized model collision operators for multiple ion species plasmas and gyrokinetic entropy balance equations. Phys. Plasmas , 16(11):112503, Nov 2009. doi:10.1063/1.3257907 .
M. Nakata, M. Nunami, T.-H. Watanabe, and H. Sugama. Improved collision operator for plasma kinetic simulations with multi-species ions and electrons. Comput. Phys. Commun. , 197:61–72, 2015. doi:https://doi.org/10.1016/j.cpc.2015.08.007 .