Source And Transport Profile Outputs

This page is generated from in-code XGC I/O metadata by utils/python/documentation/document_outputs.py.

Source, current-drive, collision-convergence, loop-voltage, and transport-profile diagnostic outputs.

xgc.col_conv_status.bp

Variable

Units

Description

Context

convergence_status

integer flag

Collision solver convergence status at each toroidal plane and mesh node. Status codes are -5: NaN or Inf found, -4: maximum Picard iterations reached, -3: too many negative distribution-function values after the solve, -2: positivity correction failed, -1: conservation check failed before the first Picard solve, 0: not attempted, 1: converged successfully, 2: still in progress/internal transient state.

context

gstep

Non-negative integer

XGC global simulation time step for this collision convergence output slice.

context

n_subcycles

Non-negative integer

Configured collision subcycle count at each toroidal plane and mesh node after convergence-based adjustment for the next collision application. On a failed node this may exceed the count used in the just-completed solve.

context

time

s

Simulation time of this collision convergence output slice.

context

tindex

Positive integer

Index of this collision convergence output slice. Values: 1, 2, …, # outputs.

context

xgc.current_drive.bp

Variable

Units

Description

Context

jpar_bg

A m^-2

Equilibrium parallel current density \(j_{\\parallel}=\\hat{b}\\cdot(\\nabla\\times B)/\\mu_0\) on mesh nodes.

context

jpar_bg_fs_avg

A m^-2

Flux-surface-averaged equilibrium parallel current density on mesh nodes.

context

n_n

Positive integer

Number of mesh nodes per plane.

context

xgc.diffusion_profiles.bp

Variable

Units

Description

Context

density

m^-3

Flux-surface-averaged density profiles on [species, sample, flux surface].

context

flow

m s^-1

Flux-surface-averaged parallel-flow profiles on [species, sample, flux surface].

context

gstep

Non-negative integer

XGC global simulation time step for this diffusion-profile diagnostic output.

context

n_samples

Positive integer

Number of buffered time samples in each diffusion-profile diagnostic output.

context

n_species

Positive integer

Number of non-adiabatic species in the diffusion-profile diagnostic.

context

n_surf

Positive integer

Number of flux-surface grid points in the diffusion-profile diagnostic.

context

psi

T m^2

Poloidal magnetic flux \(\\psi/(2\\pi)\).

context

steps

Non-negative integer

Simulation time steps corresponding to buffered diffusion-profile samples.

context

temp

eV

Flux-surface-averaged temperature profiles on [species, sample, flux surface].

context

time

s

Physical time in seconds for each buffered sample, not one scalar time per ADIOS step.

context

tindex

Non-negative integer

Index of the buffered diffusion-profile output; individual sample steps are in steps and sample times in time.

context

xgc.diffusion_solver_moments.bp

Variable

Units

Description

Context

dt

s

Physical time interval advanced by this diffusion solve.

context

moments_after

[m^-3, m s^-1, eV, eV, m s^-1, eV, eV]

Packed transport moments immediately after diffusion_solve; dimensions are [moment_block, node].

context

moments_before

[m^-3, m s^-1, eV, eV, m s^-1, eV, eV]

Packed transport moments immediately before diffusion_solve; dimensions are [moment_block, node].

context

n_moments

Positive integer

Number of packed anomalous-transport moment fields.

context

nnode

Positive integer

Number of nodes in each 2D unstructured-mesh moment field.

context

xgc.loop_vol.bp

Variable

Units

Description

Context

gstep

Non-negative integer

XGC global simulation time step for this loop-voltage diagnostic output slice.

context

jpara_diff_current

A m^-2

Current controller error bt_sign*(j_parallel,equilibrium-j_parallel,plasma), with bt_sign the equilibrium toroidal-field sign.

context

jpara_diff_integral

A m^-2

Cumulative controller sum of bt_sign*(j_parallel,equilibrium-j_parallel,plasma) over current-drive applications; no physical timestep factor is included.

context

jpara_diff_previous

A m^-2

Exponentially smoothed controller error bt_sign*(j_parallel,equilibrium-j_parallel,plasma), updated as previous=0.8*previous+0.2*current on each current-drive application.

context

loop_voltage

V

Loop voltage. The corresponding toroidal electric field is \(E_{\\phi}=V_{\\mathrm{loop}}/(2\\pi R)\), so positive loop voltage implies an electric field in the positive toroidal direction.

context

time

s

Simulation time of step in seconds.

context

tindex

Positive integer

Diagnostic cadence index computed as integer gstep divided by the configured diagnostic period. This index is not the zero-based ADIOS step and need not start at 1 in a restarted or selected product.

context