3D Diagnostics
This page is generated from in-code XGC I/O metadata by utils/python/documentation/document_outputs.py.
Three-dimensional diagnostic outputs. Some call sites share metadata with the corresponding 2D file.
xgc.2d/3d.*.bp
Variable |
Units |
Description |
Context |
|---|---|---|---|
|
T m |
Field-following As components at gyrocenter |
|
|
T m |
Perturbed parallel vector potential A_h |
|
|
T m |
Symplectic part As of the perturbed parallel magnetic vector potential. |
|
|
T |
Negative spatial derivatives of the symplectic parallel vector potential As at zero gyro-radius, in field-following coordinates. |
|
|
T |
Toroidal magnetic field perturbation in Tesla |
|
|
T |
Radial magnetic field perturbation in Tesla |
|
|
T |
Poloidal magnetic field perturbation in Tesla |
|
|
V s^-1 |
Time derivative of perturbed potential |
|
|
V m^-1 s^-1 |
Time derivative of electric field across flux surfaces |
|
|
V m^-1 s^-1 |
Time derivative of electric field along flux surfaces |
|
|
V |
Perturbed potential in volt. |
|
|
V |
Electrostatic potential |
|
|
V |
n=0 component of perturbed potential |
|
|
m^-3 |
Electron field-solve number-density contribution at mesh nodes. |
|
|
m^-2 s^-1 |
Electron parallel number-flux moment deposited for the field solve, stored with positive electron number weight. The electron charge sign and elementary-charge factor are not applied. |
|
|
V/m |
Parallel (to the magnetic field) electric field |
|
|
V/m |
Right-plane reconstruction of dAdt_guess used to advance the symplectic parallel vector potential As in the IdealMHD pullback method; zero for other pullback methods. |
|
|
V/m |
Radial electric field in Volt per meter |
|
|
V/m |
Poloidal electric field in Volt per meter |
|
|
Non-negative integer |
XGC global simulation time step for this output slice. |
|
|
m^-3 |
Ion density at each mesh node interpolated from surrounding marker particles |
|
|
m^-2 s^-1 |
Ion charge-number-weighted parallel number-flux moment deposited for the field solve. Sum over ion species, including charge_eu weights; not yet multiplied by elementary charge. |
|
|
Non-negative integer |
Index of local plane (0-based) |
|
|
m^-3 |
Instantaneous unprofiled electron-density FSA using sml_field_solver_fsa_method after electron charge deposition, excluding private and wall regions |
|
|
m^-3 |
Instantaneous node-volume-weighted median of aligned surface-node electron density, mapped to nodes with sml_field_solver_fsa_method after electron charge deposition, before diffusion or radial continuation and excluding the private and wall regions |
|
|
m^-3 |
Electron-density correction used by the axisymmetric predictor after FSA or median selection, configured radial handling, and exponential time averaging; FSA reductions and surface-to-node mappings follow sml_field_solver_fsa_method, excluding private and wall regions |
|
|
Positive integer |
Number of mesh nodes per poloidal plane. |
|
|
Integer index |
Mapping from mesh node to wall index |
|
|
Positive integer |
Number of toroidal mesh planes \(N_{\\mathrm{planes}}\). |
|
|
Positive integer |
Number of wall vertices |
|
|
rad |
Toroidal angle of this plane |
|
|
rad |
Toroidal angle of left plane |
|
|
rad |
Toroidal angle of right plane |
|
|
PETSc KSPConvergedReason integer |
PETSc KSP termination-reason code; index 0 is adiabatic and index 1 is full. |
|
|
Non-negative integer |
Number of completed outer KSP iterations; index 0 is adiabatic and index 1 is full. |
|
|
Non-negative integer |
Number of valid entries in each axisymmetric residual-history row; index 0 is adiabatic and index 1 is full. |
|
|
PETSc residual norm |
Latest outer-KSP residual history; row 0 is the adiabatic solve and row 1 is the full solve. Use poisson_axisym_residual_count to identify valid entries. |
|
|
V |
Axisymmetric, flux-surface averaged (n=0, m=0) electric potential |
|
|
V |
Full axisymmetric (n=0) electrostatic potential, including its flux-surface average and poloidally varying parts. |
|
|
V |
Axisymmetric electric potential obtained from the adiabatic predictor before electron charge deposition, available with or without the ne00 correction |
|
|
Positive integer |
Number of unique planes of sheath potential |
|
|
V |
Sheath potential |
|
|
m^-3 |
Toroidally averaged marker number density at mesh nodes, obtained from deposited marker counts divided by node volume. |
|
|
#real / #marker |
Mean particle weight (real particles / marker particles) at each mesh node |
|
|
J |
Latest optionally collected main-ion particle-weighted total kinetic energy per particle at each mesh node, including parallel-flow energy. No 2/3 temperature conversion or eV conversion is applied; non-main-ion channels remain zero. |
|
|
m/s |
Latest optionally collected main-ion particle-weighted parallel velocity at each mesh node. Non-main-ion channels are not computed and remain zero. |
|
|
(#real / #marker)^2 |
Particle weight variance at each mesh node |
|
|
Number of real particles |
Latest optionally collected main-ion deposited particle-weight sum at each mesh node. It has not been divided by node volume; non-main-ion channels are not computed and remain zero. |
|
|
s |
Simulation time of step in seconds |
|
|
Positive integer |
Index of this field diagnostic output time slice. Values: 1, 2, …, # outputs. |
xgc.f2d/f3d.*.bp
Variable |
Units |
Description |
Context |
|---|---|---|---|
|
J m^-2 s^-1 |
Parallel kinetic-energy flux density: velocity integral of f E v_parallel, toroidally averaged; density included and convective energy transport retained. |
|
|
kg s^-2 |
Parallel flux density of toroidal angular momentum: velocity integral of f (m v_parallel R B_phi/|B|) v_parallel, toroidally averaged; mass and density included. |
|
|
J m^-2 s^-1 |
Parallel potential-energy flux density: velocity integral of f charge phi v_parallel, toroidally averaged; density included. |
|
|
m/s |
Toroidally averaged, density-normalized parallel-flow contribution. |
|
|
m/s |
Toroidally averaged, density-normalized gyrocenter poloidal-flow contribution. Differs from the physical poloidal flow by the diamagnetic flow. |
|
|
kg T m s^-2 |
Radial flux density of toroidal angular momentum in psi space from parallel motion across flux surfaces in the 3D magnetic field, toroidally averaged; mass and density included. |
|
|
kg T m s^-2 |
Radial flux density of toroidal angular momentum in psi space from ExB drift, toroidally averaged; mass and density included. |
|
|
kg T m s^-2 |
Radial flux density of toroidal angular momentum in psi space from magnetic drifts, toroidally averaged; mass and density included. Use line-integral flux-surface averaging. |
|
|
J T m^-1 s^-1 |
Radial kinetic-energy flux density in psi space from parallel motion across flux surfaces in the 3D magnetic field, toroidally averaged; density included and convective energy transport retained. |
|
|
J T m^-1 s^-1 |
Radial kinetic-energy flux density in psi space from ExB drift, toroidally averaged; density included and convective energy transport retained. |
|
|
J T m^-1 s^-1 |
Radial kinetic-energy flux density in psi space from magnetic drifts, toroidally averaged; density included and convective energy transport retained. Use line-integral flux-surface averaging. |
|
|
T m^-1 s^-1 |
Radial particle flux density in psi space from parallel motion across flux surfaces in the 3D magnetic field, toroidally averaged; not divided by density. |
|
|
T m^-1 s^-1 |
Radial particle flux density in psi space from ExB drift: velocity integral of f v_ExB dot grad(psi), toroidally averaged; not divided by density. |
|
|
T m^-1 s^-1 |
Radial particle flux density in psi space from magnetic drifts, toroidally averaged; not divided by density. Use line-integral flux-surface averaging to avoid magnetic-drift cancellation errors. |
|
|
J T m^-1 s^-1 |
Radial potential-energy flux density in psi space from parallel motion across flux surfaces in the 3D magnetic field, toroidally averaged; density included. |
|
|
J T m^-1 s^-1 |
Radial potential-energy flux density in psi space, XGC1 ExB0 channel using the axisymmetric ExB velocity; toroidally averaged, density included. |
|
|
J T m^-1 s^-1 |
Radial potential-energy flux density in psi space from ExB drift, toroidally averaged; density included. |
|
|
J T m^-1 s^-1 |
Radial potential-energy flux density in psi space, XGC1 ExBt channel using the fluctuating ExB velocity; toroidally averaged, density included. |
|
|
J T m^-1 s^-1 |
Radial potential-energy flux density in psi space from magnetic drifts, toroidally averaged; density included. Use line-integral flux-surface averaging. |
|
|
kg m^-1 s^-1 |
Toroidal angular-momentum density: velocity integral of f m v_parallel R B_phi/|B|, toroidally averaged; not divided by density. |
|
|
m/s |
Toroidally averaged, density-normalized gyrocenter toroidal-flow contribution. Differs from the physical toroidal flow by the diamagnetic flow. |
|
|
J T m^-1 s^-1 |
Energy-binned radial ExB kinetic-energy flux density in psi space from the nonadiabatic turbulent contribution; density included, summed within each bin, convective energy transport retained. |
|
|
T m^-1 s^-1 |
Energy-binned radial ExB particle flux density in psi space from the nonadiabatic turbulent contribution; density included, summed within each bin. |
|
|
eV |
f0 perturbation: delta temperature |
|
|
m^-3 |
f0 perturbation: delta density |
|
|
m/s |
f0 perturbation: delta flow |
|
|
m^-3 |
Full-distribution density integrated within each normalized-speed bin, written from toroidal plane rank 0 without toroidal averaging. |
|
|
m^-1 s^-2 |
Energy-binned kinetic-energy density per species mass: velocity integral of f E/m within each bin; not divided by bin density. |
|
|
V |
Perturbed potential at midplane |
|
|
Non-negative integer |
XGC global simulation time step for this f2d/f3d diagnostic output slice. |
|
|
Non-negative integer |
Node offset for this rank |
|
|
Non-negative integer |
Local plane index |
|
|
Positive integer |
Number of energy bins |
|
|
Positive integer |
Number of nodes on this rank |
|
|
Positive integer |
Number of mesh nodes per poloidal plane. |
|
|
Positive integer |
Number of planes |
|
|
rad |
Toroidal angle of this plane |
|
|
V |
Flux-surface-averaged component of the axisymmetric electrostatic potential, stored on mesh nodes; zero when the flux-surface-averaged electric-field component is disabled. |
|
|
dimensionless |
Recommended flux-surface average (FSA) method for radial transport fluxes, particularly the neoclassical ones: 0=volume integral, 1=line integral weighted with 1/B_\theta. 0 or the absence of this parameter imply that the FSA of the radial components of the grad-B and curvature drifts have been subtracted from the magnetic drifts used to evaluate the fluxes, and a consistent FSA must be used for the FSA of the fluxes. The line-integral FSA automatically satisfies <v_{D,r}>=0. |
|
|
eV |
Parallel temperature |
|
|
eV |
Perpendicular temperature |
|
|
m^-3 |
Density at each mesh node |
|
|
m/s |
Parallel bulk flow |
|
|
s |
Simulation time of step in seconds |
|
|
Positive integer |
Index of this f2d/f3d diagnostic output time slice. Values: 1, 2, …, # outputs. |