Units

There are three output files containing units parameters: xgc.units.bp in ADIOS2 format, units.m in MATLAB format and units.txt in plain text format.

For the name of the output variable, replace [species] with one of the following: e_, i_, i2, i3, i4, i5, i6.

xgc.units.bp
Printed when: always.   Output frequency: once at start/restart.

Output	Dimension	Units	Description
diag_1d_period	Scalar	Positive integer	Input parameter diag_1d_period, i.e. output frequency of 1D diagnostics.
eq_axis_b	Scalar	Units	Description
eq_axis_r	Scalar	Units	Description
eq_axis_z	Scalar	Units	Description
eq_den_v1	Scalar	Units	Description
eq_tempi_v1	Scalar	Units	Description
eq_x_psi	Scalar	Units	Description
eq_x_r	Scalar	Units	Description
eq_x_z	Scalar	Units	Description
neu_col_period	Scalar	Units	Description
[species]ptl_charge_eu	Scalar	\(e\)	Input parameter ptl_charge_eu, i.e., the species charge number (charge in units of elementary charge \(e\)).
[species]ptl_mass_au	Scalar	\(u\)	Input parameter ptl_mass_au, i.e., the species mass in atomic mass units (hydrogen mass \(m_{\mathrm{H}}~\approx~1u\)).
ptl_num	Positive integer	Units	This does not seem to be the same as the input parameter
sml_dt	Scalar	\(\mathrm{s}\)	Time step \(\Delta t\) in seconds. Note that the unit is different from the input parameter sml_dt which is given in units of toroidal transit time. Moreover, if a simulation is restarted with a different time step this output parameter will be updated to the last used step.
sml_totalpe	Scalar	Units	Description
sml_tran	Scalar	Units	Description
sml_wedge_n	Scalar	Units	Description

units.m
Printed when: always.   Output frequency: once at start/restart.

Output	Dimension	Units	Description
diag_1d_period	Scalar	Positive integer	Same as in xgc.units.bp.
eq_axis_b	Scalar	Units	Description
eq_axis_r	Scalar	Units	Description
eq_axis_z	Scalar	Units	Description
eq_tempi_v1	Scalar	Units	Description
eq_x_r	Scalar	Units	Description
eq_x_z	Scalar	Units	Description
psi_x	Scalar	Units	Description
ptl_ion_charge_eu	Scalar	\(e\)	Same as ptl_charge_eu in xgc.units.bp.
ptl_ion_mass_au	Scalar	\(u\)	Same as ptl_mass_au in xgc.units.bp.
ptl_num	Scalar	Units	Description
sml_dt	Scalar	\(\mathrm{s}\)	Same as in xgc.units.bp.
sml_totalpe	Scalar	Units	Description
sml_tran	Scalar	Units	Description
vth	Scalar	\(\mathrm{m/s}\)	Thermal velocity of what?

units.txt
Printed when: always.   Output frequency: once at start/restart.

Output	Dimension	Units	Description
eq_axis_B(T)	Scalar	Units	Description
eq_axis_r(m)	Scalar	Units	Description
eq_axis_z(m)	Scalar	Units	Description
psi_x(code unit)	Scalar	Units	Description
psi_x(MKS)	Scalar	Units	Description
ptl_num(total)	Scalar	Positive integer	Total number of markers at the start of the simulation.
sml_dt(s)	Scalar	\(\mathrm{s}\)	Same as in xgc.units.bp.
sml_dt(tau)	Scalar	\(\tau\)	Same as the input parameter sml_dt given in units of toroidal transit time \(\tau\).
sml_dt(normalized)	Scalar	Units	Description
sml_totalpe	Scalar	Units	Description
sml_tran(s)	Scalar	Units	Description