Equilibrium and boundary

There are four output files containing magnetic equilibrium and boundary parameters: xgc.bfield.bp, xgc.bfieldm.bp, xgc.bounce.bp and xgc.equil.bp.

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

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

This file is for the magnetic field information at the node points of the 3D mesh.

Output

Dimension

Units

Description

bfield

# poloidal planes * \(\times\)
\(\times\)
# planar mesh nodes

T

Magnetic field vector \((B_R,B_Z,B_phi)\) on the mesh nodes.

jpar_bg

# poloidal planes * \(\times\)
# planar mesh nodes

Equilibrium current \(j_{\parallel} = \hat{\mathbf{b}} \cdot (\nabla \times \mathbf{B}) / \mu_{0}\).

jpar_bg_fs_avg

# flux surfaces

Flux-surface average of jpar_bg.

n_n

Scalar

Positive integer

Number of mesh nodes per plane.

psi

# planar mesh nodes

\(\mathrm{T m^2}\)

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


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

This file is for the magnetic field at the midplane.

Output

Dimension

Units

Description

N

Scalar

Positive integer

# of midplane points (1000).

abs_bphi

# of midplane points

T

Absolute value of toroidal magnetic field.

dpdr

# of midplane points

Tm

\(\frac{d\psi}{dr}\)

psi_n

# of midplane points

Normalized

Normalized poloidal magnetic flux by X-point value.

rmajor

# of midplane points

m

Major radius.

z

Scalar

m

Z(height) at the magnetic axis.


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

Output

Dimension

Units

Description

bp_sign

Scalar

Normalized

Direction of poloidal field (1 or -1). Positive direction is negative Z-direction on the inboard side of the torus.

bt_sign

Scalar

Normalized

Direction of toroidal field (1 or -1). Positive direction is counter-clockwise looking on the torus from above.

eq_B_R_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

\(T\)

Radial magnetic field component on the rectangular grid points (only written for stellarator simulations).

eq_B_Z_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

\(T\)

Z magnetic field component on the rectangular grid points (only written for stellarator simulations).

eq_B_phi_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

\(T\)

Toroidal magnetic field component on the rectangular grid points (only written for stellarator simulations).

eq_PEST_angle_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

Radians

PEST coordinate on the rectangular grid points (only written for stellarator simulations).

eq_VMEC_angle_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

Radians

VMEC coordinate on the rectangular grid points (only written for stellarator simulations).

eq_I

eq_mpsi

Tm

\(B_{tor} R\) as a function of flux label. Poloidal current function in EFIT (not written for stellarator simulations).

eq_axis_b

# poloidal planes *
\(\times\) 1

T

Magnetic field at the magnetic axis.

eq_axis_r

# poloidal planes *
\(\times\) 1

m

Major radius at the magnetic axis.

eq_axis_z

# poloidal planes *
\(\times\) 1

m

Z (height) at the magnetic axis.

eq_max_r

Scalar

m

Maximum major radius of interpolation boundary.

eq_max_z

Scalar

m

Maximum height of interpolation boundary.

eq_min_r

Scalar

m

Minimum major radius of interpolation boundary.

eq_min_z

Scalar

m

Minimum height of interpolation boundary.

eq_mp

Scalar

Positive integer

Number of planes in input grid (only written for stellarator simulations). Note that this is not the same as nphi.

eq_mpsi

Scalar

Positive integer

Number of psi (poloidal flux/flux label) grid points.

eq_mr

Scalar

Positive integer

Number of horizontal R grid points.

eq_mz

Scalar

Positive integer

Number of vertical Z grid points.

eq_psi_grid

eq_mpsi

\(Tm^2\)

Poloidal flux on the \(\psi\) grid points.

psi_norm

Scalar

\(Tm^2\)

Poloidal flux used for normalization.

eq_psi_rz

# poloidal planes *
\(\times\) eq_mz
\(\times\) eq_mr

\(Tm^2\)

Poloidal flux on the rectangular grid points.

eq_x_psi

# poloidal planes *
\(\times\) 1

\(Tm^2\)

Poloidal flux at the first (lower) X-point.

eq_x_r

# poloidal planes *
\(\times\) 1

m

Major radius at the first (lower) X-point.

eq_x_z

# poloidal planes *
\(\times\) 1

m

Height at the first (lower) X-point.

nphi

Scalar

Positive integer

Number of poloidal planes \(N_{\mathrm{planes}}\) (only written for stellarator simulations).

periodicity

Scalar

Positive integer

Toroidal periodicity from the VMEC file or torus wedge number for a tokamak (only written for stellarator simulations).


xgc.rmp_deltaa.bp/xgc.rmp_deltab.bp
Printed when: ?   Output frequency: ?

These files are for RMP simulations (with field data from M3D-C1 file).

Output

Dimension

Units

Description

n_coord

Scalar

Positive integer

n_n
nnode

Scalar

Positive integer

Number of mesh nodes per plane.

n_phi

Scalar

Positive integer

Number of poloidal planes \(N_{\mathrm{planes}}\).

n_r

n_z

num_ntor

Scalar

Positive integer

Number of toroidal mode numbers for RMP simulations (1+ptb_3db_num_ntor).

ntor

deltaa

deltaa_re

deltaa_im

deltab_re

deltab_im

* Dimension only for stellarator simulations.