Magnetics: Magnetic Circuits

Calculate reluctance, magnetomotive force, and flux linkage. Derive self-inductance, mutual inductance, and coupling for two windings.

Reluctance, flux, and coupling

For a uniform section, Rm=ℓ/(μA) in A/Wb. Magnetomotive force is N·I. Flux linkage is N·Φ, and inductance is flux linkage divided by current. To form the inductance matrix, supply a vector of the two self-inductances and a scalar mutual inductance. Its magnitude must be at most √(L₁L₂).

Operation reference

Jump to an operation

circuit.reluctance

A is the magnetic path length in m, B the cross-sectional area in m², and C the relative permeability μr. The result is in A/Wb.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Magnetic reluctance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.reluctance", args)
Recorded result · circuit.reluctance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      1.0
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.01
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      1000
    ]
  }
]

Result preview

{
  "value_real": 79577.47154594767,
  "value_imaginary": 0.0,
  "unit": "A/Wb"
}

circuit.permeance

A is the reluctance. Permeance is its reciprocal and is reported in Wb/A.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Magnetic permeance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.permeance", args)
Recorded result · circuit.permeance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      1200
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 0.0008333333333333334,
  "value_imaginary": 0.0,
  "unit": "Wb/A"
}

circuit.series_reluctance

A contains the reluctances of the elements that carry the same flux. The operation adds them.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Equivalent series reluctance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.series_reluctance", args)
Recorded result · circuit.series_reluctance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      1
    ],
    "real": [
      1,
      2
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 3.0,
  "value_imaginary": 0.0,
  "unit": "A/Wb"
}

circuit.parallel_reluctance

A contains the reluctances of parallel branches. The operation takes the reciprocal of the sum of the reciprocals. Each branch reluctance must be nonzero.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Equivalent parallel reluctance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.parallel_reluctance", args)
Recorded result · circuit.parallel_reluctance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      1
    ],
    "real": [
      2,
      2
    ]
  },
  {
    "kind": "empty"
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 1.0,
  "value_imaginary": 0.0,
  "unit": "A/Wb"
}

circuit.mmf

A is the number of turns and B is the current in A. Their product is in ampere-turns.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Magnetomotive force
gxtxt_api_call("MAGNETICS_API_v1", "circuit.mmf", args)
Recorded result · circuit.mmf

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      100
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      3
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 300.0,
  "value_imaginary": 0.0,
  "unit": "A_turn"
}

circuit.flux_linkage

A contains the number of turns and B the flux in Wb. Flux linkage is reported in weber-turns.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Magnetic flux linkage
gxtxt_api_call("MAGNETICS_API_v1", "circuit.flux_linkage", args)
Recorded result · circuit.flux_linkage

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      100
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.003
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 0.3,
  "value_imaginary": 0.0,
  "unit": "Wb_turn"
}

circuit.inductance

A contains the flux linkage and B is the nonzero current. The result is in H.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Inductance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.inductance", args)
Recorded result · circuit.inductance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.3
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      3
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 0.09999999999999999,
  "value_imaginary": 0.0,
  "unit": "H"
}

circuit.mutual_inductance

A is the linked flux per turn, B is the number of turns in the other winding, and C is the current that produces the flux.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Mutual inductance
gxtxt_api_call("MAGNETICS_API_v1", "circuit.mutual_inductance", args)
Recorded result · circuit.mutual_inductance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.002
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      100
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      3
    ]
  }
]

Result preview

{
  "value_real": 0.06666666666666667,
  "value_imaginary": 0.0,
  "unit": "H"
}

circuit.coupling

A is the mutual inductance. B and C are the positive self-inductances. The dimensionless result retains the sign of A.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Magnetic coupling coefficient
gxtxt_api_call("MAGNETICS_API_v1", "circuit.coupling", args)
Recorded result · circuit.coupling

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.02
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.1
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.12
    ]
  }
]

Result preview

{
  "value_real": 0.18257418583505536,
  "value_imaginary": 0.0
}

circuit.inductance_matrix

A contains the two self-inductances and B is the scalar mutual inductance. A supplies the diagonal entries and B supplies both off-diagonal entries.

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Physically admissible inductance matrix for two coils
gxtxt_api_call("MAGNETICS_API_v1", "circuit.inductance_matrix", args)
Recorded result · circuit.inductance_matrix

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      1
    ],
    "real": [
      0.1,
      0.12
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.02
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.1,
      0.02,
      0.02,
      0.12
    ]
  },
  "value_imaginary": {
    "dtype": "float64",
    "shape": [
      2,
      2
    ],
    "values": [
      0.0,
      0.0,
      0.0,
      0.0
    ]
  },
  "unit": "H"
}
Rejected input or attempted run · circuit.inductance_matrix:inadmissible-mutual

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      2,
      1
    ],
    "real": [
      0.1,
      0.12
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.2
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

"GXTXT:ScriptBridge:RemoteError: MAGNETICS_API_v1/circuit.inductance_matrix: two positive self inductances and physically bounded mutual inductance required"

circuit.energy_derived_inductance

A is the energy in J and B is the nonzero current. For the linear model, L=2W/I².

Access
Registered in the Python Job
Arguments
Typed operands a, b, and c, with an optional typed options struct.
Shape
Scalar, vector, or two-coil matrix (scalar_vector_or_two_coil_matrix)
Units
A/Wb, Wb/A, ampere-turns, H
Result
Numerical and diagnostic fields
Purpose
Inductance from the supplied magnetic energy and current
gxtxt_api_call("MAGNETICS_API_v1", "circuit.energy_derived_inductance", args)
Recorded result · circuit.energy_derived_inductance

Download the example script (ZIP).

Example operands preview

[
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      0.45
    ]
  },
  {
    "kind": "array",
    "shape": [
      1,
      1
    ],
    "real": [
      3
    ]
  },
  {
    "kind": "empty"
  }
]

Result preview

{
  "value_real": 0.1,
  "value_imaginary": 0.0,
  "unit": "H"
}