Checkpoint Restart Outputs
This page is generated from in-code XGC I/O metadata by utils/python/documentation/document_outputs.py.
Checkpoint-restart variables. These files are written for restart fidelity and are not ordinary analysis diagnostics.
restart_dir/xgc.restart*.bp
Variable |
Units |
Description |
Context |
|---|---|---|---|
|
dimensionless |
Restart value of the 3D perturbed magnetic-field ramp-up factor. |
|
|
T m |
Restart value of perturbed parallel vector potential \(A_{\\parallel}\) on toroidal planes and mesh nodes. |
|
|
m^-3 |
Checkpoint of the per-toroidal-plane Poisson-RHS charge-number-density accumulation, indexed by Runge-Kutta stage and solver iflag during the RMP EM/ES cycle. |
|
|
Positive integer |
Version index indicating the format of this restart file. |
|
|
V |
Restart history of perturbed electrostatic potential on toroidal planes and mesh nodes. |
|
|
Integer index |
One-based global index of the first mesh node assigned to each MPI rank in the checkpoint domain decomposition. |
|
|
m^-2 s^-1 |
Checkpoint of the per-toroidal-plane Ampere-RHS accumulation for each Runge-Kutta stage during the RMP EM/ES cycle; elementary charge is not included. |
|
|
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. |
|
|
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. |
|
|
V |
Restart value of the loop-voltage profile on mesh nodes. |
|
|
m^-3 |
Checkpointed neutral background density on mesh nodes. |
|
|
eV |
Checkpointed neutral background temperature on mesh nodes. |
|
|
simulation-particle weight |
Checkpointed sum of lost main-ion particle weights binned by wall node and incident-ion energy, used to determine the neutral recycling source. |
|
|
simulation-particle weight |
Checkpointed sum of lost main-ion particle weights, used to normalize the recycled-neutral source. |
|
|
simulation-particle weight |
Checkpointed sum of lost main-ion particle weights at each wall node, used to determine the neutral recycling source. |
|
|
Positive integer |
Number of perpendicular velocity grid points in f0 checkpoint arrays. |
|
|
Positive integer |
Number of 2D mesh nodes. |
|
|
Positive integer |
Number of toroidal mesh planes \(N_{\\mathrm{planes}}\). |
|
|
main-ion toroidal transit times |
Averaging time used to accumulate predictor_ne00_time_avg. |
|
|
m^-3 |
Restart value of the exponentially time-averaged predictor electron-density correction. |
|
|
Non-negative integer |
Largest globally unique marker-particle ID already assigned for this species. |
|
|
m^-3 |
Axisymmetric right-hand-side density offset used when restarting the Poisson/charge solve. |
|
|
C |
Checkpointed ion charge-loss accumulator on toroidal planes and wall nodes. |
|
|
C |
Checkpointed signed net charge-loss accumulator on toroidal planes and wall nodes. |
|
|
Positive integer |
Number of toroidal planes in sheath checkpoint arrays. |
|
|
Positive integer |
Number of wall elements in sheath checkpoint arrays. |
|
|
V |
Checkpointed sheath potential on toroidal planes and wall elements. |
|
|
eV |
Restart value of species temperature perturbation added to the analytic f0 background on mesh nodes. |
|
|
m^-3 |
Restart value of species density perturbation added to the analytic f0 background on mesh nodes. |
|
|
m s^-1 |
Restart value of species flow perturbation added to the analytic f0 background on mesh nodes. |
|
|
m^-3 eV^-1 |
Species residual/grid contribution to the f0 distribution function on [toroidal plane, perpendicular velocity, mesh node, parallel velocity]. |
|
|
integer flag |
Packed 64-bit ESC_PTL particle state for this checkpoint species, including low status bits, the stored escape-step payload, and the signed fixed-point weight-change payload; this is not the decoded low-bit flag array in xgc.escaped_ptls.*.bp. |
|
|
Integer index |
Globally unique marker-particle IDs for this species. |
|
|
Positive integer |
Number of columns in the species particle phase checkpoint array. |
|
|
Non-negative integer |
Number of checkpointed marker particles for this species written by each MPI rank. |
|
|
Non-negative integer |
Total number of checkpointed marker particles for this species across all MPI ranks. |
|
|
Non-negative integer |
Global particle-array offset for this species for each MPI rank in the checkpoint. |
|
|
[m, m, rad, m, dimensionless, dimensionless, J/T, dimensionless, m^-3 eV^(-3/2)] |
Species particle phase checkpoint array with columns [R, Z, phi, rho, w1, w2, mu, w0, g], where \(R\), \(Z\), and \(\\phi\) are the cylindrical coordinates of the particle, \(\\rho\) is the parallel gyroradius (proxy for \(v_{\\parallel}\)), \(w_1\) is the delta-f weight, \(w_2\) is a weight used in the weight evolution equation, \(\\mu\) is the magnetic moment, \(w_0\) is the full-f weight (from importance sampling), and \(g\) is the phase-space marker density. |
|
|
m^-3 eV^-1 |
Persistent residual df0g distribution retained for later particle transfer on [toroidal plane, perpendicular velocity, mesh node, parallel velocity]. |
|
|
source-application count |
Age counter for persistent residual df0g entries on [toroidal plane, perpendicular velocity, mesh node, parallel velocity]. |
|
|
s |
Simulation time of step in seconds. |
|
|
Non-negative integer |
Simulation time step stored in the checkpoint. |
|
|
Positive integer |
Number of MPI ranks used when the checkpoint was written. |
|
|
Positive integer |
Number of parallel velocity grid points in f0 checkpoint arrays. |