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
No matching operations.
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"
}