sawteethΒΆ

PathDimensionsTypeUnitsDescription

sawteeth

(alpha)

Description of sawtooth events. This IDS must be used in homogeneous_time = 1 mode

sawteeth.code

(alpha)

STRUCTURE

Generic decription of the code-specific parameters for the code that has produced this IDS

sawteeth.code.commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.code.description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.code.library

(alpha)

[1...N]

STRUCT_ARRAY

List of external libraries used by the code that has produced this IDS

sawteeth.code.library[:].commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.code.library[:].description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.code.library[:].name

(alpha)

STR_0D

Name of software

sawteeth.code.library[:].parameters

(alpha)

STR_0D

List of the code specific parameters in XML format

sawteeth.code.library[:].repository

(alpha)

STR_0D

URL of software repository

sawteeth.code.library[:].version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.code.name

(alpha)

STR_0D

Name of software generating IDS

sawteeth.code.output_flag

(alpha)

[sawteeth.time]

INT_1D

Output flag : 0 means the run is successful, other values mean some difficulty has been encountered, the exact meaning is then code specific. Negative values mean the result shall not be used.

sawteeth.code.parameters

(alpha)

STR_0D

List of the code specific parameters in XML format

sawteeth.code.repository

(alpha)

STR_0D

URL of software repository

sawteeth.code.version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.crash_trigger

(alpha)

[sawteeth.time]

INT_1D

Flag indicating whether a crash condition has been satisfied : 0 = no crash. N(>0) = crash triggered due to condition N as follows. 1: crash triggered by the ideal kink criterion; 2: crash triggered by the ideal kink criterion including kinetic effects from fast particles; 31: crash triggered by the resistive kink criterion (meeting necessary conditions for reconnection); 32: crash triggered by the resistive kink criterion (resistive kink mode is unstable). The distinction between 31 and 32 only indicates whether (31) or (32) was the last criterion to be satisfied

sawteeth.diagnostics

(alpha)

STRUCTURE

Detailed information about the sawtooth characteristics

sawteeth.diagnostics.magnetic_shear_q1

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

-

Magnetic shear at surface q = 1, defined as rho_tor/q . dq/drho_tor

sawteeth.diagnostics.previous_crash_time

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

s

Time at which the previous sawtooth crash occured

sawteeth.diagnostics.previous_crash_trigger

(alpha)

[sawteeth.time]

INT_1D

Previous crash trigger. Flag indicating whether a crash condition has been satisfied : 0 = no crash. N(>0) = crash triggered due to condition N

sawteeth.diagnostics.previous_period

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

s

Previous sawtooth period

sawteeth.diagnostics.rho_tor_norm_inversion

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

-

Normalised toroidal flux coordinate at inversion radius

sawteeth.diagnostics.rho_tor_norm_mixing

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

-

Normalised toroidal flux coordinate at mixing radius

sawteeth.diagnostics.rho_tor_norm_q1

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

-

Normalised toroidal flux coordinate at surface q = 1

sawteeth.ids_properties

(alpha)

STRUCTURE

Interface Data Structure properties. This element identifies the node above as an IDS

sawteeth.ids_properties.comment

(alpha)

STR_0D

Any comment describing the content of this IDS

sawteeth.ids_properties.creation_date

(alpha)

STR_0D

Date at which this data has been produced

sawteeth.ids_properties.homogeneous_time

(alpha)

INT_0D

This node must be filled (with 0, 1, or 2) for the IDS to be valid. If 1, the time of this IDS is homogeneous, i.e. the time values for this IDS are stored in the time node just below the root of this IDS. If 0, the time values are stored in the various time fields at lower levels in the tree. In the case only constant or static nodes are filled within the IDS, homogeneous_time must be set to 2

sawteeth.ids_properties.name

(alpha)

STR_0D

User-defined name for this IDS occurrence

sawteeth.ids_properties.occurrence

INT_0D

sawteeth.ids_properties.occurrence_type

(alpha)

STRUCTURE

Type of data contained in this occurrence
1) reconstruction : Equilibrium reconstruction
2) prediction_fixed : Equilibrium prediction, fixed boundary
3) prediction_free : Equilibrium prediction, free boundary
4) mapping : Used for mapping equilibrium results from one grid type / resolution to another, or for including variables not present in the first set such as the calculation of magnetic field of other derived parameters

sawteeth.ids_properties.occurrence_type.description

(alpha)

STR_0D

Verbose description

sawteeth.ids_properties.occurrence_type.index

(alpha)

INT_0D

Integer identifier (enumeration index within a list). Private identifier values must be indicated by a negative index.

sawteeth.ids_properties.occurrence_type.name

(alpha)

STR_0D

Short string identifier

sawteeth.ids_properties.plugins

(alpha)

STRUCTURE

Information about the plugins used to write/read this IDS. This structure is filled automatically by the Access Layer at GET/PUT time, no need to fill it via a user program.

sawteeth.ids_properties.plugins.infrastructure_get

(alpha)

STRUCTURE

Plugin infrastructure used to GET the data

sawteeth.ids_properties.plugins.infrastructure_get.commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.ids_properties.plugins.infrastructure_get.description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.ids_properties.plugins.infrastructure_get.name

(alpha)

STR_0D

Name of software used

sawteeth.ids_properties.plugins.infrastructure_get.repository

(alpha)

STR_0D

URL of software repository

sawteeth.ids_properties.plugins.infrastructure_get.version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.ids_properties.plugins.infrastructure_put

(alpha)

STRUCTURE

Plugin infrastructure used to PUT the data

sawteeth.ids_properties.plugins.infrastructure_put.commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.ids_properties.plugins.infrastructure_put.description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.ids_properties.plugins.infrastructure_put.name

(alpha)

STR_0D

Name of software used

sawteeth.ids_properties.plugins.infrastructure_put.repository

(alpha)

STR_0D

URL of software repository

sawteeth.ids_properties.plugins.infrastructure_put.version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.ids_properties.plugins.node

(alpha)

[1...N]

STRUCT_ARRAY

Set of IDS nodes for which a plugin has been applied

sawteeth.ids_properties.plugins.node[:].get_operation

(alpha)

[1...N]

STRUCT_ARRAY

Plugins actually used to read back a node (potentially, multiple plugins can be applied, listed in reverse order of application). This information is filled by the plugin infrastructure during the GET operation.

sawteeth.ids_properties.plugins.node[:].get_operation[:].commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.ids_properties.plugins.node[:].get_operation[:].description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.ids_properties.plugins.node[:].get_operation[:].name

(alpha)

STR_0D

Name of software used

sawteeth.ids_properties.plugins.node[:].get_operation[:].parameters

(alpha)

STR_0D

List of the code specific parameters in XML format

sawteeth.ids_properties.plugins.node[:].get_operation[:].repository

(alpha)

STR_0D

URL of software repository

sawteeth.ids_properties.plugins.node[:].get_operation[:].version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.ids_properties.plugins.node[:].path

(alpha)

STR_0D

Path of the node within the IDS, following the syntax given in the link below. If empty, means the plugin applies to the whole IDS.

sawteeth.ids_properties.plugins.node[:].put_operation

(alpha)

[1...N]

STRUCT_ARRAY

Plugins used to PUT a node (potentially, multiple plugins can be applied, if so they are listed by order of application)

sawteeth.ids_properties.plugins.node[:].put_operation[:].commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.ids_properties.plugins.node[:].put_operation[:].description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.ids_properties.plugins.node[:].put_operation[:].name

(alpha)

STR_0D

Name of software used

sawteeth.ids_properties.plugins.node[:].put_operation[:].parameters

(alpha)

STR_0D

List of the code specific parameters in XML format

sawteeth.ids_properties.plugins.node[:].put_operation[:].repository

(alpha)

STR_0D

URL of software repository

sawteeth.ids_properties.plugins.node[:].put_operation[:].version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.ids_properties.plugins.node[:].readback

(alpha)

[1...N]

STRUCT_ARRAY

Plugins to be used to read back a node (potentially, multiple plugins can be applied, listed in reverse order of application)

sawteeth.ids_properties.plugins.node[:].readback[:].commit

(alpha)

STR_0D

Unique commit reference of software

sawteeth.ids_properties.plugins.node[:].readback[:].description

(alpha)

STR_0D

Short description of the software (type, purpose)

sawteeth.ids_properties.plugins.node[:].readback[:].name

(alpha)

STR_0D

Name of software used

sawteeth.ids_properties.plugins.node[:].readback[:].parameters

(alpha)

STR_0D

List of the code specific parameters in XML format

sawteeth.ids_properties.plugins.node[:].readback[:].repository

(alpha)

STR_0D

URL of software repository

sawteeth.ids_properties.plugins.node[:].readback[:].version

(alpha)

STR_0D

Unique version (tag) of software

sawteeth.ids_properties.provenance

(alpha)

STRUCTURE

Provenance information about this IDS

sawteeth.ids_properties.provenance.node

(alpha)

[1...N]

STRUCT_ARRAY

Set of IDS nodes for which the provenance is given. The provenance information applies to the whole structure below the IDS node. For documenting provenance information for the whole IDS, set the size of this array of structure to 1 and leave the child "path" node empty

sawteeth.ids_properties.provenance.node[:].path

(alpha)

STR_0D

Path of the node within the IDS, following the syntax given in the link below. If empty, means the provenance information applies to the whole IDS.

sawteeth.ids_properties.provenance.node[:].sources

(alpha)

[1...N]

STR_1D

List of sources used to import or calculate this node, identified as explained below. In case the node is the result of of a calculation / data processing, the source is an input to the process described in the "code" structure at the root of the IDS. The source can be an IDS (identified by a URI or a persitent identifier, see syntax in the link below) or non-IDS data imported directly from an non-IMAS database (identified by the command used to import the source, or the persistent identifier of the data source). Often data are obtained by a chain of processes, however only the last process input are recorded here. The full chain of provenance has then to be reconstructed recursively from the provenance information contained in the data sources.

sawteeth.ids_properties.provider

(alpha)

STR_0D

Name of the person in charge of producing this data

sawteeth.ids_properties.source

(obsolescent)

STR_0D

Source of the data (any comment describing the origin of the data : code, path to diagnostic signals, processing method, ...). Superseeded by the new provenance structure.

sawteeth.ids_properties.version_put

(alpha)

STRUCTURE

Version of the access layer package used to PUT this IDS

sawteeth.ids_properties.version_put.access_layer

(alpha)

STR_0D

Version of Access Layer used to PUT this IDS

sawteeth.ids_properties.version_put.access_layer_language

(alpha)

STR_0D

Programming language of the Access Layer high level API used to PUT this IDS

sawteeth.ids_properties.version_put.data_dictionary

(alpha)

STR_0D

Version of Data Dictionary used to PUT this IDS

sawteeth.profiles_1d

(alpha)

[sawteeth.profiles_1d[:].time]

STRUCT_ARRAY

Core profiles after sawtooth crash for various time slices

sawteeth.profiles_1d[:].conductivity_parallel

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

ohm^-1.m^-1

Parallel conductivity

sawteeth.profiles_1d[:].e_field_parallel

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

V.m^-1

Parallel electric field = average(E.B) / B0, where Core_Profiles/Vacuum_Toroidal_Field/ B0

sawteeth.profiles_1d[:].grid

(alpha)

STRUCTURE

Radial grid

sawteeth.profiles_1d[:].grid.area

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m^2

Cross-sectional area of the flux surface

sawteeth.profiles_1d[:].grid.psi

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Wb

Poloidal magnetic flux

sawteeth.profiles_1d[:].grid.psi_boundary

(alpha)

FLT_0D (uncertain)

Wb

Value of the poloidal magnetic flux at the plasma boundary (useful to normalize the psi array values when the radial grid doesn't go from the magnetic axis to the plasma boundary)

sawteeth.profiles_1d[:].grid.psi_magnetic_axis

(alpha)

FLT_0D (uncertain)

Wb

Value of the poloidal magnetic flux at the magnetic axis (useful to normalize the psi array values when the radial grid doesn't go from the magnetic axis to the plasma boundary)

sawteeth.profiles_1d[:].grid.rho_pol_norm

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

-

Normalised poloidal flux coordinate = sqrt((psi(rho)-psi(magnetic_axis)) / (psi(LCFS)-psi(magnetic_axis)))

sawteeth.profiles_1d[:].grid.rho_tor

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m

Toroidal flux coordinate. rho_tor = sqrt(b_flux_tor/(pi*b0)) ~ sqrt(pi*r^2*b0/(pi*b0)) ~ r [m]. The toroidal field used in its definition is indicated under vacuum_toroidal_field/b0

sawteeth.profiles_1d[:].grid.rho_tor_norm

(alpha)

[1...N]

FLT_1D (uncertain)

-

Normalised toroidal flux coordinate. The normalizing value for rho_tor_norm, is the toroidal flux coordinate at the equilibrium boundary (LCFS or 99.x % of the LCFS in case of a fixed boundary equilibium calculation, see time_slice/boundary/b_flux_pol_norm in the equilibrium IDS)

sawteeth.profiles_1d[:].grid.surface

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m^2

Surface area of the toroidal flux surface

sawteeth.profiles_1d[:].grid.volume

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m^3

Volume enclosed inside the magnetic surface

sawteeth.profiles_1d[:].j_bootstrap

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

A/m^2

Bootstrap current density = average(J_Bootstrap.B) / B0, where B0 = Core_Profiles/Vacuum_Toroidal_Field/ B0

sawteeth.profiles_1d[:].j_non_inductive

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

A/m^2

Non-inductive (includes bootstrap) parallel current density = average(jni.B) / B0, where B0 = Core_Profiles/Vacuum_Toroidal_Field/ B0

sawteeth.profiles_1d[:].j_ohmic

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

A/m^2

Ohmic parallel current density = average(J_Ohmic.B) / B0, where B0 = Core_Profiles/Vacuum_Toroidal_Field/ B0

sawteeth.profiles_1d[:].j_tor

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

A/m^2

Total toroidal current density = average(J_Tor/R) / average(1/R)

sawteeth.profiles_1d[:].j_total

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

A/m^2

Total parallel current density = average(jtot.B) / B0, where B0 = Core_Profiles/Vacuum_Toroidal_Field/ B0

sawteeth.profiles_1d[:].magnetic_shear

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

-

Magnetic shear, defined as rho_tor/q . dq/drho_tor

sawteeth.profiles_1d[:].momentum_tor

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

kg.m/s

Total plasma toroidal momentum, summed over ion species and electrons

sawteeth.profiles_1d[:].n_e

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m^-3

Electron density (thermal+non-thermal)

sawteeth.profiles_1d[:].n_e_fast

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

m^-3

Density of fast (non-thermal) electrons

sawteeth.profiles_1d[:].n_i_total_over_n_e

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

-

Ratio of total ion density (sum over species and charge states) over electron density. (thermal+non-thermal)

sawteeth.profiles_1d[:].p_e

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Electron pressure

sawteeth.profiles_1d[:].p_e_fast_parallel

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Fast (non-thermal) electron parallel pressure

sawteeth.profiles_1d[:].p_e_fast_perpendicular

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Fast (non-thermal) electron perpendicular pressure

sawteeth.profiles_1d[:].p_i_total

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Total ion pressure (sum over the ion species)

sawteeth.profiles_1d[:].p_i_total_fast_parallel

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Fast (non-thermal) total ion (sum over the ion species) parallel pressure

sawteeth.profiles_1d[:].p_i_total_fast_perpendicular

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Fast (non-thermal) total ion (sum over the ion species) perpendicular pressure

sawteeth.profiles_1d[:].phi

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Wb

Toroidal flux

sawteeth.profiles_1d[:].pressure_parallel

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Total parallel pressure (electrons+ions, thermal+non-thermal)

sawteeth.profiles_1d[:].pressure_perpendicular

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Total perpendicular pressure (electrons+ions, thermal+non-thermal)

sawteeth.profiles_1d[:].pressure_thermal

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Pa

Thermal pressure (electrons+ions)

sawteeth.profiles_1d[:].psi_star_post_crash

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Wb

Psi* = psi - phi, after the sawtooth crash

sawteeth.profiles_1d[:].psi_star_pre_crash

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

Wb

Psi* = psi - phi, just before the sawtooth crash

sawteeth.profiles_1d[:].q

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

-

Safety factor

sawteeth.profiles_1d[:].t_e

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

eV

Electron temperature

sawteeth.profiles_1d[:].t_i_average

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

eV

Ion temperature (averaged on charge states and ion species)

sawteeth.profiles_1d[:].time

(alpha)

FLT_0D

s

Time

sawteeth.profiles_1d[:].zeff

(alpha)

[sawteeth.profiles_1d[:].grid.rho_tor_norm]

FLT_1D (uncertain)

-

Effective charge

sawteeth.time

(alpha)

[1...N]

FLT_1D_TYPE

s

Generic time

sawteeth.vacuum_toroidal_field

(alpha)

STRUCTURE

Characteristics of the vacuum toroidal field (used in rho_tor definition)

sawteeth.vacuum_toroidal_field.b0

(alpha)

[sawteeth.time]

FLT_1D (uncertain)

T

Vacuum toroidal field at R0 [T]; Positive sign means anti-clockwise when viewing from above. The product R0B0 must be consistent with the b_tor_vacuum_r field of the tf IDS.

sawteeth.vacuum_toroidal_field.r0

(alpha)

FLT_0D (uncertain)

m

Reference major radius where the vacuum toroidal magnetic field is given (usually a fixed position such as the middle of the vessel at the equatorial midplane)