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

As_rho_ff

T m

Field-following As components at gyrocenter

context

aparh

T m

Perturbed parallel vector potential A_h

context

apars

T m

Symplectic part As of the perturbed parallel magnetic vector potential.

context

dAs_rho_ff

T

Negative spatial derivatives of the symplectic parallel vector potential As at zero gyro-radius, in field-following coordinates.

context

dBphi

T

Toroidal magnetic field perturbation in Tesla

context

dBpsi

T

Radial magnetic field perturbation in Tesla

context

dBtheta

T

Poloidal magnetic field perturbation in Tesla

context

ddpotdt

V s^-1

Time derivative of perturbed potential

context

depsidt

V m^-1 s^-1

Time derivative of electric field across flux surfaces

context

dethetadt

V m^-1 s^-1

Time derivative of electric field along flux surfaces

context

dpot

V

Perturbed potential in volt.

context

dpot_es

V

Electrostatic potential

context

dpot_n0

V

n=0 component of perturbed potential

context

eden

m^-3

Electron field-solve number-density contribution at mesh nodes.

context

ejpar

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.

context

epara

V/m

Parallel (to the magnetic field) electric field

context

epara2

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.

context

epsi

V/m

Radial electric field in Volt per meter

context

etheta

V/m

Poloidal electric field in Volt per meter

context

gstep

Non-negative integer

XGC global simulation time step for this output slice.

context

iden

m^-3

Ion density at each mesh node interpolated from surrounding marker particles

context

ijpar

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.

context

iphi

Non-negative integer

Index of local plane (0-based)

context

ne00_deposited_fsa

m^-3

Instantaneous unprofiled electron-density FSA using sml_field_solver_fsa_method after electron charge deposition, excluding private and wall regions

context

ne00_deposited_median

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

context

ne00_predictor

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

context

nnode

Positive integer

Number of mesh nodes per poloidal plane.

context

node_to_wall

Integer index

Mapping from mesh node to wall index

context

nphi

Positive integer

Number of toroidal mesh planes \(N_{\\mathrm{planes}}\).

context

nwall

Positive integer

Number of wall vertices

context

phi

rad

Toroidal angle of this plane

context

phi_left

rad

Toroidal angle of left plane

context

phi_right

rad

Toroidal angle of right plane

context

poisson_axisym_converged_reason

PETSc KSPConvergedReason integer

PETSc KSP termination-reason code; index 0 is adiabatic and index 1 is full.

context

poisson_axisym_iteration_count

Non-negative integer

Number of completed outer KSP iterations; index 0 is adiabatic and index 1 is full.

context

poisson_axisym_residual_count

Non-negative integer

Number of valid entries in each axisymmetric residual-history row; index 0 is adiabatic and index 1 is full.

context

poisson_axisym_residual_history

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.

context

pot0

V

Axisymmetric, flux-surface averaged (n=0, m=0) electric potential

context

pot0m

V

Full axisymmetric (n=0) electrostatic potential, including its flux-surface average and poloidally varying parts.

context

pot0m_predictor

V

Axisymmetric electric potential obtained from the adiabatic predictor before electron charge deposition, available with or without the ne00 correction

context

sheath_nphi

Positive integer

Number of unique planes of sheath potential

context

shpot

V

Sheath potential

context

sp_name + "marker_den"

m^-3

Toroidally averaged marker number density at mesh nodes, obtained from deposited marker counts divided by node volume.

context

sp_name + "mean_weight"

#real / #marker

Mean particle weight (real particles / marker particles) at each mesh node

context

sp_name + "temp"

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.

context

sp_name + "vp"

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.

context

sp_name + "weight_variance"

(#real / #marker)^2

Particle weight variance at each mesh node

context

sp_name + "wsum"

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.

context

time

s

Simulation time of step in seconds

context

tindex

Positive integer

Index of this field diagnostic output time slice. Values: 1, 2, …, # outputs.

context

xgc.f2d/f3d.*.bp

Variable

Units

Description

Context

[species]_par_en_flux_[n0/turb]_[f0/df]

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.

context

[species]_par_mom_flux_[n0/turb]_[f0/df]

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.

context

[species]_par_pot_en_flux_[n0/turb]_[f0/df]

J m^-2 s^-1

Parallel potential-energy flux density: velocity integral of f charge phi v_parallel, toroidally averaged; density included.

context

[species]_parallel_flow_[n0/turb]_[f0/df]

m/s

Toroidally averaged, density-normalized parallel-flow contribution.

context

[species]_poloidal_flow_[n0/turb]_[f0/df]

m/s

Toroidally averaged, density-normalized gyrocenter poloidal-flow contribution. Differs from the physical poloidal flow by the diamagnetic flow.

context

[species]_rad_mom_flux_3db_[n0/turb]_[f0/df]

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.

context

[species]_rad_mom_flux_ExB_[n0/turb]_[f0/df]

kg T m s^-2

Radial flux density of toroidal angular momentum in psi space from ExB drift, toroidally averaged; mass and density included.

context

[species]_rad_mom_flux_mag_[n0/turb]_[f0/df]

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.

context

[species]_radial_en_flux_3db_[n0/turb]_[f0/df]

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.

context

[species]_radial_en_flux_ExB_[n0/turb]_[f0/df]

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.

context

[species]_radial_en_flux_mag_[n0/turb]_[f0/df]

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.

context

[species]_radial_flux_3db_[n0/turb]_[f0/df]

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.

context

[species]_radial_flux_ExB_[n0/turb]_[f0/df]

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.

context

[species]_radial_flux_mag_[n0/turb]_[f0/df]

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.

context

[species]_radial_pot_en_flux_3db_[n0/turb]_[f0/df]

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.

context

[species]_radial_pot_en_flux_ExB0_[n0/turb]_[f0/df]

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.

context

[species]_radial_pot_en_flux_ExB_[n0/turb]_[f0/df]

J T m^-1 s^-1

Radial potential-energy flux density in psi space from ExB drift, toroidally averaged; density included.

context

[species]_radial_pot_en_flux_ExBt_[n0/turb]_[f0/df]

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.

context

[species]_radial_pot_en_flux_mag_[n0/turb]_[f0/df]

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.

context

[species]_tor_ang_mom_[n0/turb]_[f0/df]

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.

context

[species]_toroidal_flow_[n0/turb]_[f0/df]

m/s

Toroidally averaged, density-normalized gyrocenter toroidal-flow contribution. Differs from the physical toroidal flow by the diamagnetic flow.

context

base_name + "ExB_enflux_en"

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.

context

base_name + "ExB_flux_en"

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.

context

base_name + "_f0_delta_T"

eV

f0 perturbation: delta temperature

context

base_name + "_f0_delta_n"

m^-3

f0 perturbation: delta density

context

base_name + "_f0_delta_u"

m/s

f0 perturbation: delta flow

context

base_name + "den_en"

m^-3

Full-distribution density integrated within each normalized-speed bin, written from toroidal plane rank 0 without toroidal averaging.

context

base_name + "energy_en"

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.

context

dpot

V

Perturbed potential at midplane

context

gstep

Non-negative integer

XGC global simulation time step for this f2d/f3d diagnostic output slice.

context

inode1m1

Non-negative integer

Node offset for this rank

context

iphim1

Non-negative integer

Local plane index

context

n_energy

Positive integer

Number of energy bins

context

ndata

Positive integer

Number of nodes on this rank

context

nnode

Positive integer

Number of mesh nodes per poloidal plane.

context

nphi

Positive integer

Number of planes

context

phi

rad

Toroidal angle of this plane

context

pot0

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.

context

radial_flux_fsa_method

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.

context

sp_name + "T_para"

eV

Parallel temperature

context

sp_name + "T_perp"

eV

Perpendicular temperature

context

sp_name + "den"

m^-3

Density at each mesh node

context

sp_name + "u_para"

m/s

Parallel bulk flow

context

time

s

Simulation time of step in seconds

context

tindex

Positive integer

Index of this f2d/f3d diagnostic output time slice. Values: 1, 2, …, # outputs.

context