API Reference

MXHEquilibrium

Missing docstring.

Missing docstring for AMShape. Check Documenter's build log for details.

Missing docstring.

Missing docstring for AbstractEquilibrium. Check Documenter's build log for details.

MXHEquilibrium.AsymmetricMillerShapeType

AsymmetricMillerShape Structure

Defines the Asymmetric Miller Plasma Shape Parameterization

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
ϵ - Inverse Aspect Ratio a/R0 where a = minor radius
κ - Elongation
δl - Lower Triangularity
δu - Upper Triangularity

source
Missing docstring.

Missing docstring for B0Ip_sign. Check Documenter's build log for details.

Missing docstring.

Missing docstring for Bfield. Check Documenter's build log for details.

Missing docstring.

Missing docstring for Boundary. Check Documenter's build log for details.

Missing docstring.

Missing docstring for COCOS. Check Documenter's build log for details.

Missing docstring.

Missing docstring for EFITEquilibrium. Check Documenter's build log for details.

Missing docstring.

Missing docstring for EMFields. Check Documenter's build log for details.

Missing docstring.

Missing docstring for Efield. Check Documenter's build log for details.

Missing docstring.

Missing docstring for FluxSurface. Check Documenter's build log for details.

Missing docstring.

Missing docstring for Jfield. Check Documenter's build log for details.

Missing docstring.

Missing docstring for LShape. Check Documenter's build log for details.

MXHEquilibrium.LuceShapeType

Luce Plasma Shape as described in:

"An analytic functional form for characterization and generation of axisymmetric plasma boundaries",
TC Luce, Plasma Phys. Control. Fusion 55 (2013) http://dx.doi.org/10.1088/0741-3335/55/9/095009

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
r - Minor Radius [m]
Zᵣₘ - Z(Rₘₐₓ) [m]
κ - Lower and Upper Elongation
δ - Lower and Upper Triangulation
ζ - Squareness for the I,II,III,IV quadrants

source
Missing docstring.

Missing docstring for MShape. Check Documenter's build log for details.

Missing docstring.

Missing docstring for MXHShape. Check Documenter's build log for details.

MXHEquilibrium.MillerExtendedHarmonicShapeType

MillerExtendedHarmonicShape Structure

Defines the Miller Extended Harmonic Plasma Shape Parameterization

Arbon, Ryan, Jeff Candy, and Emily A. Belli. "Rapidly-convergent flux-surface shape parameterization." Plasma Physics and Controlled Fusion 63.1 (2020): 012001.

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
ϵ - Inverse Aspect Ratio a/R0 where a = minor radius
κ - Elongation
c0 - Tilt
c - Cosine coefficients i.e. [ovality, twist, ...]
s - Sine coefficients i.e. [asin(triangularity), -squareness, ...])

source
MXHEquilibrium.MillerShapeType

MillerShape Structure

Defines the Miller Plasma Shape Parameterization

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
ϵ - Inverse Aspect Ratio a/R0 where a = minor radius
κ - Elongation
δ - Triangularity

source
Missing docstring.

Missing docstring for PlasmaBoundary. Check Documenter's build log for details.

MXHEquilibrium.PlasmaGeometricParametersType

Plasma Geometry Parameters as described in:

"An analytic functional form for characterization and generation of axisymmetric plasma boundaries",
TC Luce, Plasma Phys. Control. Fusion 55 (2013) http://dx.doi.org/10.1088/0741-3335/55/9/095009

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
r - Minor Radius [m]
Zᵣₘ - Z(Rₘₐₓ) [m]
κ - Lower and Upper Elongation
δ - Lower and Upper Triangulation
ζ - Squareness for the I,II,III,IV quadrants

source
Missing docstring.

Missing docstring for PlasmaShape. Check Documenter's build log for details.

MXHEquilibrium.SolovevEquilibriumType

SolovevEquilibrium Structure

Defines the equilibrium that satisfy Δ⋆ψ(x,y) = α + (1 - α)x^2
where (r,z) = (R0 x,R0 y). F(dF/dψ) = -A, μ₀dp/dψ = -C, α = A/(A + C R0²), ψ₀ = R0²(A + C R0²)

Fields:
cocos - COCOS
B0 - Toroidal magnetic field magnitude on axis [T]
S - Plasma Shape alpha - constant relating beta regime (α)
qstar - Kink safety factor
psi0 - Poloidal flux normalization (ψ₀)
beta_p - Theoretical Poloidal beta
beta_t - Theoretical Toroidal beta
c - Coefficients for Solov'ev polynomials
diverted - If true then equilibrium has one or more x-points
symmetric - If true then equilibrium is up-down symmetric
sigma - Sign of dot(B,J)

source
Missing docstring.

Missing docstring for TMShape. Check Documenter's build log for details.

MXHEquilibrium.TurnbullMillerShapeType

TurnbullMillerShape Structure

Defines the Turnbull-Miller Plasma Shape Parameterization

Turnbull, A. D., et al. "Improved magnetohydrodynamic stability through optimization of higher order moments in cross-section shape of tokamaks." Physics of Plasmas 6.4 (1999): 1113-1116.

Fields:
R0 - Major Radius [m]
Z0 - Elevation [m]
ϵ - Inverse Aspect Ratio a/R0 where a = minor radius
κ - Elongation
δ - Triangularity
ζ - Squareness

source
Missing docstring.

Missing docstring for Wall. Check Documenter's build log for details.

Missing docstring.

Missing docstring for area. Check Documenter's build log for details.

Missing docstring.

Missing docstring for area_average. Check Documenter's build log for details.

Missing docstring.

Missing docstring for aspect_ratio. Check Documenter's build log for details.

Missing docstring.

Missing docstring for average. Check Documenter's build log for details.

Missing docstring.

Missing docstring for beta. Check Documenter's build log for details.

Missing docstring.

Missing docstring for beta_n. Check Documenter's build log for details.

Missing docstring.

Missing docstring for beta_p. Check Documenter's build log for details.

Missing docstring.

Missing docstring for beta_t. Check Documenter's build log for details.

Missing docstring.

Missing docstring for boundary. Check Documenter's build log for details.

MXHEquilibrium.boundary_extremaFunction
outer, top, inner, bottom = boundary_extrema(bdry; interp=true)

Returns the outermost, top, innermost, and bottom points on the boundary. Defaults to using interpolation to find extrema

source
Missing docstring.

Missing docstring for circumference. Check Documenter's build log for details.

Missing docstring.

Missing docstring for clear_cache. Check Documenter's build log for details.

CoordinateConventions.cocosFunction
cocos(g::GEQDSKFile; kwargs...) -> COCOS

Identifies and returns GEQDSKFile COCOS. A unique identification requires setting the clockwise_phi keyword.

source
Missing docstring.

Missing docstring for convert_eltype. Check Documenter's build log for details.

Missing docstring.

Missing docstring for curlB. Check Documenter's build log for details.

Missing docstring.

Missing docstring for curvature. Check Documenter's build log for details.

Missing docstring.

Missing docstring for cylindrical_cocos. Check Documenter's build log for details.

Missing docstring.

Missing docstring for cylindrical_cocos_indices. Check Documenter's build log for details.

Missing docstring.

Missing docstring for efit. Check Documenter's build log for details.

Missing docstring.

Missing docstring for electric_potential. Check Documenter's build log for details.

Missing docstring.

Missing docstring for electric_potential_gradient. Check Documenter's build log for details.

Missing docstring.

Missing docstring for elevation. Check Documenter's build log for details.

Missing docstring.

Missing docstring for elongation. Check Documenter's build log for details.

Missing docstring.

Missing docstring for fields. Check Documenter's build log for details.

Missing docstring.

Missing docstring for fit. Check Documenter's build log for details.

Missing docstring.

Missing docstring for flux_surface. Check Documenter's build log for details.

Missing docstring.

Missing docstring for flux_surface_geometry. Check Documenter's build log for details.

Missing docstring.

Missing docstring for gradB. Check Documenter's build log for details.

CoordinateConventions.identify_cocosFunction
identify_cocos(g::GEQDSKFIle; clockwise_phi=nothing) -> List of possible COCOS IDs

Identifies possible GEQDSKFile COCOS. A unique identification requires setting the clockwise_phi keyword.

source
Missing docstring.

Missing docstring for in_boundary. Check Documenter's build log for details.

Missing docstring.

Missing docstring for in_plasma. Check Documenter's build log for details.

Missing docstring.

Missing docstring for in_vessel. Check Documenter's build log for details.

Missing docstring.

Missing docstring for limits. Check Documenter's build log for details.

Missing docstring.

Missing docstring for magnetic_axis. Check Documenter's build log for details.

Missing docstring.

Missing docstring for major_radius. Check Documenter's build log for details.

Missing docstring.

Missing docstring for minor_radius. Check Documenter's build log for details.

Missing docstring.

Missing docstring for ovality. Check Documenter's build log for details.

Missing docstring.

Missing docstring for plasma_boundary. Check Documenter's build log for details.

Missing docstring.

Missing docstring for plasma_boundary_psi. Check Documenter's build log for details.

Missing docstring.

Missing docstring for plasma_current. Check Documenter's build log for details.

Missing docstring.

Missing docstring for plasma_geometry. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_Bfield. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_Jfield. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_cocos. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_cocos_indices. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_current. Check Documenter's build log for details.

Missing docstring.

Missing docstring for poloidal_current_gradient. Check Documenter's build log for details.

Missing docstring.

Missing docstring for pressure. Check Documenter's build log for details.

Missing docstring.

Missing docstring for pressure_gradient. Check Documenter's build log for details.

Missing docstring.

Missing docstring for psi_boundary. Check Documenter's build log for details.

Missing docstring.

Missing docstring for psi_gradient. Check Documenter's build log for details.

Missing docstring.

Missing docstring for psi_limits. Check Documenter's build log for details.

Missing docstring.

Missing docstring for psi_range. Check Documenter's build log for details.

Missing docstring.

Missing docstring for read_geqdsk. Check Documenter's build log for details.

Missing docstring.

Missing docstring for rho_p. Check Documenter's build log for details.

Missing docstring.

Missing docstring for safety_factor. Check Documenter's build log for details.

Missing docstring.

Missing docstring for scale_aspect. Check Documenter's build log for details.

Missing docstring.

Missing docstring for shape. Check Documenter's build log for details.

MXHEquilibrium.solovevFunction
solovev(B0, R0, ϵ, δ, κ, α, q⋆; B0_dir=1, Ip_dir=1, diverted=false, x_point=nothing, symmetric = true)

Creates a SolovevEquilibrium Structure

Arguments:
B0 - Toroidal magnetic field magnitude on axis [T]
R0 - Major Radius [m]
ϵ - inverse aspect ratio a/R0
δ - triangularity
κ - elongation/ellipticity
α - constant relating beta regime (α)
q⋆ - Kink safety factor
Keyword Arguments:
'Z0- Elevation [m]\B0dir- Direction of the toroidal field (+1 = CCW, -1 = CW)\Ipdir- Direction of the plasma current (+1 = CCW, -1 = CW)\diverted- If true then equilibrium has one or more x-points\xpoint`- If diverted = true, then xpoint is set to (R0(1-1.1δϵ), -R01.1κϵ) else nothing`symmetric` - Is equilibrium up-down symmetric (must be if not diverted)

source
solovev(B0, S, α, q⋆; B0_dir=1, Ip_dir=1, diverted=false, x_point=nothing, symmetric = true)

Creates a SolovevEquilibrium Structure

Arguments:
B0 - Toroidal magnetic field magnitude on axis [T]
S - Plasma Shape α - constant relating beta regime (α)
q⋆ - Kink safety factor
Keyword Arguments:
B0_dir - Direction of the toroidal field (+1 = CCW, -1 = CW)
Ip_dir - Direction of the plasma current (+1 = CCW, -1 = CW)
diverted - If true then equilibrium has one or more x-points
x_point - If diverted = true, then x_point is set to (R0(1-1.1δϵ), -R01.1κϵ) else nothing
symmetric - Is equilibrium up-down symmetric

source
Missing docstring.

Missing docstring for squareness. Check Documenter's build log for details.

Missing docstring.

Missing docstring for surface_area. Check Documenter's build log for details.

Missing docstring.

Missing docstring for tilt. Check Documenter's build log for details.

Missing docstring.

Missing docstring for toroidal_flux. Check Documenter's build log for details.

CoordinateConventions.transform_cocosFunction
transform_cocos(g::GEQDSKFile, cc_in::Union{Int,COCOS}, cc_out::Union{Int,COCOS}; kwargs...) -> GEQDSKFile

Transforms the given GEQDSKFile with COCOS=cc_in, and returns a GEQDSKFile with COCOS=cc_out.

source
Missing docstring.

Missing docstring for transp_potential!. Check Documenter's build log for details.

Missing docstring.

Missing docstring for triangularity. Check Documenter's build log for details.

Missing docstring.

Missing docstring for twist. Check Documenter's build log for details.

Missing docstring.

Missing docstring for volume. Check Documenter's build log for details.

Missing docstring.

Missing docstring for volume_average. Check Documenter's build log for details.