pf_active

Description of the axisymmetric active poloidal field (PF) coils and supplies; includes the limits of these systems; includes the forces on them; does not include non-axisymmetric coil systems

  • Maximum occurrences (MDS+ backend only): 3

New in version 4.0.0: lifecycle status active

Changed in version 4.1.0.

ids_propertiesstructure

See common IDS structure reference: ids_properties.

coil(i1)AoSActive PF coils

Active PF coils

  • Maximum occurrences (MDS+ backend only): 32

Coordinate

1

1...N

coil(i1)/nameSTR_0DShort string identifier (unique for a given device)

Short string identifier (unique for a given device)

coil(i1)/descriptionSTR_0DDescription, e.g. […]

Description, e.g. “channel viewing the upper divertor”

New in version >3.

coil(i1)/function(i2)AoSSet of functions for which this coil may be used

Set of functions for which this coil may be used

This is an identifier. See pf_active_coil_function_identifier for the available options.

  • Maximum occurrences (MDS+ backend only): 6

Coordinate

1

1...N

New in version >3.34.0.

coil(i1)/function(i2)/nameSTR_0DShort string identifier

Short string identifier

coil(i1)/function(i2)/indexINT_0DInteger identifier (enumeration index within a list). […]

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

coil(i1)/function(i2)/descriptionSTR_0DVerbose description

Verbose description

coil(i1)/resistanceohmFLT_0DCoil resistance

Coil resistance

coil(i1)/resistance_additionalohmstructureAdditional resistance due to e.g. […]

Additional resistance due to e.g. dynamically switchable resistors. The coil effective resistance is obtained by adding this dynamic quantity to the static resistance of the coil.

New in version >3.36.0.

coil(i1)/resistance_additional/data(:)ohmFLT_1DData

Data

Coordinate

1

coil(i1)/resistance_additional/time

coil(i1)/resistance_additional/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/energy_limit_maxJFLT_0DMaximum Energy to be dissipated in the coil

Maximum Energy to be dissipated in the coil

coil(i1)/current_limit_max(:,:)AFLT_2DMaximum tolerable current in the conductor

Maximum tolerable current in the conductor

Coordinate

1

coil(i1)/b_field_max

2

coil(i1)/temperature

coil(i1)/b_field_max(:)TFLT_1DList of values of the maximum magnetic field on the conductor […]

List of values of the maximum magnetic field on the conductor surface (coordinate for current_limit_max)

Coordinate

1

1...N

coil(i1)/temperature(:)KFLT_1DList of values of the conductor temperature (coordinate for current_limit_max)

List of values of the conductor temperature (coordinate for current_limit_max)

Coordinate

1

1...N

coil(i1)/b_field_max_timedTstructureMaximum absolute value of the magnetic field on the conductor […]

Maximum absolute value of the magnetic field on the conductor surface

coil(i1)/b_field_max_timed/data(:)TFLT_1DData

Data

Coordinate

1

coil(i1)/b_field_max_timed/time

coil(i1)/b_field_max_timed/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/element(i2)AoSEach PF coil is comprised of a number of cross-section elements […]

Each PF coil is comprised of a number of cross-section elements described individually and connected serially

  • Maximum occurrences (MDS+ backend only): 328

Coordinate

1

1...N

coil(i1)/element(i2)/nameSTR_0DShort string identifier (unique for a given device)

Short string identifier (unique for a given device)

coil(i1)/element(i2)/descriptionSTR_0DDescription, e.g. […]

Description, e.g. “channel viewing the upper divertor”

New in version >3.

coil(i1)/element(i2)/turns_with_sign1FLT_0DNumber of effective turns in the element for calculating the […]

Number of effective turns in the element for calculating the magnetic field from the coil/loop. Should be positive, unless the coil has elements going in opposite directions.

coil(i1)/element(i2)/aream^2FLT_0DCross-sectional areas of the element

Cross-sectional areas of the element

coil(i1)/element(i2)/geometrystructureCross-sectional shape of the element

Cross-sectional shape of the element

coil(i1)/element(i2)/geometry/geometry_typeINT_0DType used to describe the element shape (1:’outline’, 2:’rectangle’, […]

Type used to describe the element shape (1:’outline’, 2:’rectangle’, 3:’oblique’, 4:’arcs of circle, 5: ‘annulus’, 6 : ‘thick line’)

coil(i1)/element(i2)/geometry/outlinestructureIrregular outline of the element. […]

Irregular outline of the element. Repeat the first point since this is a closed contour

Changed in version 4: Since this describes a closed countour first point must now be repeated at the end of the coordinate arrays of the children

coil(i1)/element(i2)/geometry/outline/r(:)mFLT_1DMajor radius

Major radius

Coordinate

1

1...N

coil(i1)/element(i2)/geometry/outline/z(:)mFLT_1DHeight

Height

Coordinate

1

coil(i1)/element(i2)/geometry/outline/r

coil(i1)/element(i2)/geometry/rectanglestructureRectangular description of the element

Rectangular description of the element

coil(i1)/element(i2)/geometry/rectangle/rmFLT_0DGeometric centre R

Geometric centre R

coil(i1)/element(i2)/geometry/rectangle/zmFLT_0DGeometric centre Z

Geometric centre Z

coil(i1)/element(i2)/geometry/rectangle/widthmFLT_0DHorizontal full width

Horizontal full width

coil(i1)/element(i2)/geometry/rectangle/heightmFLT_0DVertical full height

Vertical full height

coil(i1)/element(i2)/geometry/obliquestructureParallelogram description of the element

Parallelogram description of the element

coil(i1)/element(i2)/geometry/oblique/rmFLT_0DMajor radius of the reference point (from which the alpha and […]

Major radius of the reference point (from which the alpha and beta angles are defined, marked by a + on the diagram)

Click here for further documentation.

coil(i1)/element(i2)/geometry/oblique/zmFLT_0DHeight of the reference point (from which the alpha and beta […]

Height of the reference point (from which the alpha and beta angles are defined, marked by a + on the diagram)

Click here for further documentation.

coil(i1)/element(i2)/geometry/oblique/length_alphamFLT_0DLength of the parallelogram side inclined with angle alpha with […]

Length of the parallelogram side inclined with angle alpha with respect to the major radius axis

Click here for further documentation.

coil(i1)/element(i2)/geometry/oblique/length_betamFLT_0DLength of the parallelogram side inclined with angle beta with […]

Length of the parallelogram side inclined with angle beta with respect to the height axis

Click here for further documentation.

coil(i1)/element(i2)/geometry/oblique/alpharadFLT_0DInclination of first angle measured counter-clockwise from horizontal […]

Inclination of first angle measured counter-clockwise from horizontal outwardly directed radial vector (grad R).

Click here for further documentation.

coil(i1)/element(i2)/geometry/oblique/betaradFLT_0DInclination of second angle measured counter-clockwise from vertically […]

Inclination of second angle measured counter-clockwise from vertically upwards directed vector (grad Z). If both alpha and beta are zero (rectangle) then the simpler rectangular elements description should be used.

Click here for further documentation.

coil(i1)/element(i2)/geometry/arcs_of_circlestructureDescription of the element contour by a set of arcs of circle. […]

Description of the element contour by a set of arcs of circle. For each of these, the position of the start point is given together with the curvature radius. The end point is given by the start point of the next arc of circle.

coil(i1)/element(i2)/geometry/arcs_of_circle/r(:)mFLT_1DMajor radii of the start point of each arc of circle

Major radii of the start point of each arc of circle

Coordinate

1

1...N

coil(i1)/element(i2)/geometry/arcs_of_circle/z(:)mFLT_1DHeight of the start point of each arc of circle

Height of the start point of each arc of circle

Coordinate

1

coil(i1)/element(i2)/geometry/arcs_of_circle/r

coil(i1)/element(i2)/geometry/arcs_of_circle/curvature_radii(:)mFLT_1DCurvature radius of each arc of circle

Curvature radius of each arc of circle

Coordinate

1

coil(i1)/element(i2)/geometry/arcs_of_circle/r

coil(i1)/element(i2)/geometry/annulusstructureThe element is an annulus of centre R, Z, with inner radius radius_inner […]

The element is an annulus of centre R, Z, with inner radius radius_inner and outer radius radius_outer

New in version >3.34.0.

coil(i1)/element(i2)/geometry/annulus/rmFLT_0DCentre major radius

Centre major radius

coil(i1)/element(i2)/geometry/annulus/zmFLT_0DCentre height

Centre height

coil(i1)/element(i2)/geometry/annulus/radius_innermFLT_0DInner radius

Inner radius

coil(i1)/element(i2)/geometry/annulus/radius_outermFLT_0DOuter radius

Outer radius

coil(i1)/element(i2)/geometry/thick_linestructureThe element is approximated by a rectangle defined by a central […]

The element is approximated by a rectangle defined by a central segment and a thickness in the direction perpendicular to the segment

New in version >3.36.0.

coil(i1)/element(i2)/geometry/thick_line/first_pointstructurePosition of the first point

Position of the first point

coil(i1)/element(i2)/geometry/thick_line/first_point/rmFLT_0DMajor radius

Major radius

coil(i1)/element(i2)/geometry/thick_line/first_point/zmFLT_0DHeight

Height

coil(i1)/element(i2)/geometry/thick_line/second_pointstructurePosition of the second point

Position of the second point

coil(i1)/element(i2)/geometry/thick_line/second_point/rmFLT_0DMajor radius

Major radius

coil(i1)/element(i2)/geometry/thick_line/second_point/zmFLT_0DHeight

Height

coil(i1)/element(i2)/geometry/thick_line/thicknessmFLT_0DThickness

Thickness

coil(i1)/geometrystructureCross-sectional shape of the coil

Cross-sectional shape of the coil

New in version >4.0.0.

coil(i1)/geometry/geometry_typeINT_0DType used to describe the element shape (1:’outline’, 2:’rectangle’, […]

Type used to describe the element shape (1:’outline’, 2:’rectangle’, 3:’oblique’, 4:’arcs of circle, 5: ‘annulus’, 6 : ‘thick line’)

coil(i1)/geometry/outlinestructureIrregular outline of the element. […]

Irregular outline of the element. Repeat the first point since this is a closed contour

Changed in version 4: Since this describes a closed countour first point must now be repeated at the end of the coordinate arrays of the children

coil(i1)/geometry/outline/r(:)mFLT_1DMajor radius

Major radius

Coordinate

1

1...N

coil(i1)/geometry/outline/z(:)mFLT_1DHeight

Height

Coordinate

1

coil(i1)/geometry/outline/r

coil(i1)/geometry/rectanglestructureRectangular description of the element

Rectangular description of the element

coil(i1)/geometry/rectangle/rmFLT_0DGeometric centre R

Geometric centre R

coil(i1)/geometry/rectangle/zmFLT_0DGeometric centre Z

Geometric centre Z

coil(i1)/geometry/rectangle/widthmFLT_0DHorizontal full width

Horizontal full width

coil(i1)/geometry/rectangle/heightmFLT_0DVertical full height

Vertical full height

coil(i1)/geometry/obliquestructureParallelogram description of the element

Parallelogram description of the element

coil(i1)/geometry/oblique/rmFLT_0DMajor radius of the reference point (from which the alpha and […]

Major radius of the reference point (from which the alpha and beta angles are defined, marked by a + on the diagram)

Click here for further documentation.

coil(i1)/geometry/oblique/zmFLT_0DHeight of the reference point (from which the alpha and beta […]

Height of the reference point (from which the alpha and beta angles are defined, marked by a + on the diagram)

Click here for further documentation.

coil(i1)/geometry/oblique/length_alphamFLT_0DLength of the parallelogram side inclined with angle alpha with […]

Length of the parallelogram side inclined with angle alpha with respect to the major radius axis

Click here for further documentation.

coil(i1)/geometry/oblique/length_betamFLT_0DLength of the parallelogram side inclined with angle beta with […]

Length of the parallelogram side inclined with angle beta with respect to the height axis

Click here for further documentation.

coil(i1)/geometry/oblique/alpharadFLT_0DInclination of first angle measured counter-clockwise from horizontal […]

Inclination of first angle measured counter-clockwise from horizontal outwardly directed radial vector (grad R).

Click here for further documentation.

coil(i1)/geometry/oblique/betaradFLT_0DInclination of second angle measured counter-clockwise from vertically […]

Inclination of second angle measured counter-clockwise from vertically upwards directed vector (grad Z). If both alpha and beta are zero (rectangle) then the simpler rectangular elements description should be used.

Click here for further documentation.

coil(i1)/geometry/arcs_of_circlestructureDescription of the element contour by a set of arcs of circle. […]

Description of the element contour by a set of arcs of circle. For each of these, the position of the start point is given together with the curvature radius. The end point is given by the start point of the next arc of circle.

coil(i1)/geometry/arcs_of_circle/r(:)mFLT_1DMajor radii of the start point of each arc of circle

Major radii of the start point of each arc of circle

Coordinate

1

1...N

coil(i1)/geometry/arcs_of_circle/z(:)mFLT_1DHeight of the start point of each arc of circle

Height of the start point of each arc of circle

Coordinate

1

coil(i1)/geometry/arcs_of_circle/r

coil(i1)/geometry/arcs_of_circle/curvature_radii(:)mFLT_1DCurvature radius of each arc of circle

Curvature radius of each arc of circle

Coordinate

1

coil(i1)/geometry/arcs_of_circle/r

coil(i1)/geometry/annulusstructureThe element is an annulus of centre R, Z, with inner radius radius_inner […]

The element is an annulus of centre R, Z, with inner radius radius_inner and outer radius radius_outer

New in version >3.34.0.

coil(i1)/geometry/annulus/rmFLT_0DCentre major radius

Centre major radius

coil(i1)/geometry/annulus/zmFLT_0DCentre height

Centre height

coil(i1)/geometry/annulus/radius_innermFLT_0DInner radius

Inner radius

coil(i1)/geometry/annulus/radius_outermFLT_0DOuter radius

Outer radius

coil(i1)/geometry/thick_linestructureThe element is approximated by a rectangle defined by a central […]

The element is approximated by a rectangle defined by a central segment and a thickness in the direction perpendicular to the segment

New in version >3.36.0.

coil(i1)/geometry/thick_line/first_pointstructurePosition of the first point

Position of the first point

coil(i1)/geometry/thick_line/first_point/rmFLT_0DMajor radius

Major radius

coil(i1)/geometry/thick_line/first_point/zmFLT_0DHeight

Height

coil(i1)/geometry/thick_line/second_pointstructurePosition of the second point

Position of the second point

coil(i1)/geometry/thick_line/second_point/rmFLT_0DMajor radius

Major radius

coil(i1)/geometry/thick_line/second_point/zmFLT_0DHeight

Height

coil(i1)/geometry/thick_line/thicknessmFLT_0DThickness

Thickness

coil(i1)/currentAstructureCurrent fed in the coil (for 1 turn, to be multiplied by the […]

Current fed in the coil (for 1 turn, to be multiplied by the number of turns to obtain the generated magnetic field), positive when the current is counter-clockwise when seen from above.

coil(i1)/current/data(:)AFLT_1DData

Data

Coordinate

1

coil(i1)/current/time

coil(i1)/current/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/voltageVstructureVoltage on the coil terminals (Vside1-Vside2) - including additional […]

Voltage on the coil terminals (Vside1-Vside2) - including additional resistors if any

coil(i1)/voltage/data(:)VFLT_1DData

Data

Coordinate

1

coil(i1)/voltage/time

coil(i1)/voltage/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/force_radialNstructureRadial force applied on this coil (positive when outwards)

Radial force applied on this coil (positive when outwards)

New in version >3.39.0.

coil(i1)/force_radial/data(:)NFLT_1DData

Data

Coordinate

1

coil(i1)/force_radial/time

coil(i1)/force_radial/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/force_verticalNstructureVertical force applied on this coil (positive when upwards)

Vertical force applied on this coil (positive when upwards)

New in version >3.39.0.

coil(i1)/force_vertical/data(:)NFLT_1DData

Data

Coordinate

1

coil(i1)/force_vertical/time

coil(i1)/force_vertical/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/force_radial_crushingNstructureRadial crushing force applied on this coil (positive when compressive)

Radial crushing force applied on this coil (positive when compressive)

New in version >3.39.0.

coil(i1)/force_radial_crushing/data(:)NFLT_1DData

Data

Coordinate

1

coil(i1)/force_radial_crushing/time

coil(i1)/force_radial_crushing/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

coil(i1)/force_vertical_crushingNstructureVertical crushing force applied on this coil (positive when compressive)

Vertical crushing force applied on this coil (positive when compressive)

New in version >3.39.0.

coil(i1)/force_vertical_crushing/data(:)NFLT_1DData

Data

Coordinate

1

coil(i1)/force_vertical_crushing/time

coil(i1)/force_vertical_crushing/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

force_limitsstructureDescription of force limits on the axisymmetric PF coil system

Description of force limits on the axisymmetric PF coil system

New in version >3.39.0.

force_limits/combination_matrix(:,:)1FLT_2DForce limits are expressed as a linear combination of the forces […]

Force limits are expressed as a linear combination of the forces on each individual coil. The weights of the linear combination are given by this matrix, while the limits are given by the sibling nodes limit_min and limit_max. Each row of this matrix corresponds to a force limit. The columns represent, for each coil, the 4 types of forces on the coil namely [coil1_radial, coil1_vertical, coil1_radial_crush, coil1_vertical_crush, coil2_radial, coil2_vertical, coil2_radial_crush, coil2_vertical_crush, …]. There are therefore 4*coils_n columns.

Coordinate

1

force_limits/limit_max

2

1...N

force_limits/limit_max(:)NFLT_1DMaximum force limit, for each limit (line of the combination […]

Maximum force limit, for each limit (line of the combination matrix). EMPTY_FLT value means unbounded

Coordinate

1

1...N

force_limits/limit_min(:)NFLT_1DMinimum force limit, for each limit (line of the combination […]

Minimum force limit, for each limit (line of the combination matrix). EMPTY_FLT value means unbounded

Coordinate

1

force_limits/limit_max

force_limits/forceNstructureForce (positive when upwards for a vertical force, positive when […]

Force (positive when upwards for a vertical force, positive when outwards for a radial force)

force_limits/force/data(:)NFLT_1DData

Data

Coordinate

1

force_limits/force/time

force_limits/force/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

circuit(i1)AoSCircuits, connecting multiple PF coils to multiple supplies, […]

Circuits, connecting multiple PF coils to multiple supplies, defining the current and voltage relationships in the system

  • Maximum occurrences (MDS+ backend only): 32

Coordinate

1

1...N

circuit(i1)/nameSTR_0DShort string identifier (unique for a given device)

Short string identifier (unique for a given device)

circuit(i1)/descriptionSTR_0DDescription, e.g. […]

Description, e.g. “channel viewing the upper divertor”

New in version >3.

circuit(i1)/typeSTR_0DType of the circuit

Type of the circuit

circuit(i1)/connections(:,:)INT_2DDescription of the supplies and coils connections (nodes) across […]

Description of the supplies and coils connections (nodes) across the circuit. Nodes of the circuit are listed as the first dimension of the matrix. Supplies (listed first) and coils (listed second) are listed as the second dimension. Thus the second dimension has a size equal to (N_supplies+N_coils). N_supplies (resp. N_coils) is the total number of supplies (resp. coils) listed in the supply (resp.coil) array of structure, i.e. including also supplies/coils that are not part of the actual circuit. The (i,j) matrix elements are 1 if the j-th supply or coil side is connected to the i-th node by its positive side, -1 if connected by its negative side, or 0 if not connected.

Coordinate

1

1...N

2

1...N

circuit(i1)/voltageVstructureVoltage on the circuit between the sides of the group of supplies […]

Voltage on the circuit between the sides of the group of supplies (only for circuits with a single supply or in which supplies are grouped)

circuit(i1)/voltage/data(:)VFLT_1DData

Data

Coordinate

1

circuit(i1)/voltage/time

circuit(i1)/voltage/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

circuit(i1)/currentAstructureCurrent in the circuit between the sides of the group of supplies […]

Current in the circuit between the sides of the group of supplies (only for circuits with a single supply or in which supplies are grouped)

circuit(i1)/current/data(:)AFLT_1DData

Data

Coordinate

1

circuit(i1)/current/time

circuit(i1)/current/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

supply(i1)AoSPF power supplies

PF power supplies

  • Maximum occurrences (MDS+ backend only): 32

Coordinate

1

1...N

supply(i1)/nameSTR_0DShort string identifier (unique for a given device)

Short string identifier (unique for a given device)

supply(i1)/descriptionSTR_0DDescription, e.g. […]

Description, e.g. “channel viewing the upper divertor”

New in version >3.

supply(i1)/typeINT_0DType of the supply; TBD add free description of non-linear power […]

Type of the supply; TBD add free description of non-linear power supplies

supply(i1)/resistanceohmFLT_0DPower supply internal resistance

Power supply internal resistance

supply(i1)/delaysFLT_0DPure delay in the supply

Pure delay in the supply

supply(i1)/filter_numerator(:)mixedFLT_1DCoefficients of the numerator, in increasing order : a0 + a1\*s […]

Coefficients of the numerator, in increasing order : a0 + a1*s + … + an*s^n; used for a linear supply description

Coordinate

1

1...N

supply(i1)/filter_denominator(:)mixedFLT_1DCoefficients of the denominator, in increasing order : b0 + b1\*s […]

Coefficients of the denominator, in increasing order : b0 + b1*s + … + bm*s^m; used for a linear supply description

Coordinate

1

1...N

supply(i1)/current_limit_maxAFLT_0DMaximum current in the supply

Maximum current in the supply

supply(i1)/current_limit_minAFLT_0DMinimum current in the supply

Minimum current in the supply

supply(i1)/voltage_limit_maxVFLT_0DMaximum voltage from the supply

Maximum voltage from the supply

supply(i1)/voltage_limit_minVFLT_0DMinimum voltage from the supply

Minimum voltage from the supply

supply(i1)/current_limiter_gainVFLT_0DGain to prevent overcurrent in a linear model of the supply

Gain to prevent overcurrent in a linear model of the supply

supply(i1)/energy_limit_maxJFLT_0DMaximum energy to be dissipated in the supply during a pulse

Maximum energy to be dissipated in the supply during a pulse

supply(i1)/nonlinear_modelSTR_0DDescription of the nonlinear transfer function of the supply

Description of the nonlinear transfer function of the supply

supply(i1)/voltageVstructureVoltage at the supply output (Vside1-Vside2)

Voltage at the supply output (Vside1-Vside2)

supply(i1)/voltage/data(:)VFLT_1DData

Data

Coordinate

1

supply(i1)/voltage/time

supply(i1)/voltage/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

supply(i1)/currentAstructureCurrent at the supply output, defined positive if it flows from […]

Current at the supply output, defined positive if it flows from point 1 to point 2 in the circuit connected to the supply (outside the supply)

supply(i1)/current/data(:)AFLT_1DData

Data

Coordinate

1

supply(i1)/current/time

supply(i1)/current/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

latencysFLT_0DUpper bound of the delay between input command received from […]

Upper bound of the delay between input command received from the RT network and actuator starting to react. Applies globally to the system described by this IDS unless specific latencies (e.g. channel-specific or antenna-specific) are provided at a deeper level in the IDS structure.

New in version >3.32.1.

codestructure

See common IDS structure reference: code.

time(:)sFLT_1DGeneric time

Generic time

Coordinate

1

1...N