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 3.0.0: lifecycle status alpha

Changed in version 3.40.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_0DName of the coil

Name of the coil

coil(i1)/identifierSTR_0DAlphanumeric identifier of coils used for convenience

Alphanumeric identifier of coils used for convenience

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(:)as_parentFLT_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(:)as_parentFLT_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

  • Maximum occurrences (MDS+ backend only): 328

Coordinate

1

1...N

coil(i1)/element(i2)/nameSTR_0DName of this element

Name of this element

coil(i1)/element(i2)/identifierSTR_0DIdentifier of this element

Identifier of this element

coil(i1)/element(i2)/turns_with_sign-FLT_0DNumber of effective turns in the element for calculating magnetic […]

Number of effective turns in the element for calculating magnetic fields of the coil/loop; includes the sign of the number of turns (positive means current is counter-clockwise when seen from above)

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. Do NOT repeat the first point.

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)/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 flowing from side 1 to side 2 of the coil (inside the coil), this numbering being made consistently with the convention that the current is counter-clockwise when seen from above.

coil(i1)/current/data(:)as_parentFLT_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(:)as_parentFLT_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(:)as_parentFLT_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(:)as_parentFLT_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(:)as_parentFLT_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(:)as_parentFLT_1DData

Data

Coordinate

1

coil(i1)/force_vertical_crushing/time

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

Time

Coordinate

1

1...N

vertical_force(i1)AoSVertical forces on the axisymmetric PF coil system

Vertical forces on the axisymmetric PF coil system

  • Maximum occurrences (MDS+ backend only): 20

Coordinate

1

1...N

Deprecated since version 3.40.0.

vertical_force(i1)/nameSTR_0DName of the force combination

Name of the force combination

vertical_force(i1)/combination(:)-FLT_1DCoils involved in the force combinations. […]

Coils involved in the force combinations. Normally the force would be the full set of coils, but in some cases, we want to have a difference in forces, such as a CS coil separation force. We therefore give each coil a force weight which we call the combination

Coordinate

1

1...N

vertical_force(i1)/limit_maxNFLT_0DMaximum force combination limit

Maximum force combination limit

vertical_force(i1)/limit_minNFLT_0DMinimum force combination limit

Minimum force combination limit

vertical_force(i1)/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)

vertical_force(i1)/force/data(:)as_parentFLT_1DData

Data

Coordinate

1

vertical_force(i1)/force/time

vertical_force(i1)/force/time(:)sFLT_1DTime

Time

Coordinate

1

1...N

radial_force(i1)AoSRadial forces on the axisymmetric PF coil system

Radial forces on the axisymmetric PF coil system

  • Maximum occurrences (MDS+ backend only): 20

Coordinate

1

1...N

Deprecated since version 3.40.0.

radial_force(i1)/nameSTR_0DName of the force combination

Name of the force combination

radial_force(i1)/combination(:)-FLT_1DCoils involved in the force combinations. […]

Coils involved in the force combinations. Normally the force would be the full set of coils, but in some cases, we want to have a difference in forces, such as a CS coil separation force. We therefore give each coil a force weight which we call the combination

Coordinate

1

1...N

radial_force(i1)/limit_maxNFLT_0DMaximum force combination limit

Maximum force combination limit

radial_force(i1)/limit_minNFLT_0DMinimum force combination limit

Minimum force combination limit

radial_force(i1)/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)

radial_force(i1)/force/data(:)as_parentFLT_1DData

Data

Coordinate

1

radial_force(i1)/force/time

radial_force(i1)/force/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(:,:)-FLT_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(:)as_parentFLT_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_0DName of the circuit

Name of the circuit

circuit(i1)/identifierSTR_0DID of the circuit

ID of the circuit

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) SIDES are listed as the second dimension. Thus the second dimension has a size equal to 2*(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, or 0 otherwise. For coils, sides are listed so that a current flowing from side 1 to side 2 (inside the coil) is positive (i.e. counter-clockwise when seen from above).

Click here for further documentation.

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(:)as_parentFLT_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(:)as_parentFLT_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_0DName of the PF supply

Name of the PF supply

supply(i1)/identifierSTR_0DIdentifier of the supply

Identifier of the supply

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(:)as_parentFLT_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(:)as_parentFLT_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