Class in Zendir.Classes | Inherits from PowerNodeModel
Declaration
class MagneticTorqueBarArrayPowerModel;Description
This model creates a map between dipole commands and the resulting load on the parent’s electrical sub-system. It is a component model that can attach to a magnetic torque bar array to provide the power draw from a system.
Magnetic torque bars are air-core coils driven by H-bridge electronics. The dipole moment produced is m = N * I * A (turns * current * area), so the current required for a commanded dipole is I = |m| / (N * A). The coil power dissipation is P = I^2 * R_coil, and the total DC power draw includes the driver efficiency and standby power.
This is a classical resistive load (not a CPL) - the resistance can be computed directly from the commanded dipoles without quasi-static iteration. If the required coil voltage (I * R) exceeds VoltageIn, the output dipole commands are scaled proportionally to stay within the available voltage.
Properties
| Declared | Description |
|---|---|
| CoilEffectiveArea | The effective cross-sectional area of each magnetic torque bar coil [m^2].The dipole moment m = N * I * A, so the required current to producea dipole m is I = |
| CoilResistance | The coil resistance per magnetic torque bar [Ohm].Power dissipated in each coil is I^2 * CoilResistance where I is thecurrent required to produce the commanded dipole moment. |
| CoilTurns | The number of turns in each magnetic torque bar coil.The dipole moment m = N * I * A, so the required current to producea dipole m is I = |
| DriverEfficiency | The efficiency of the H-bridge driver electronics [0..1].The total DC power draw is P_coil / DriverEfficiency + DriverStandbyPower.Typical H-bridge drivers have 80-90% efficiency. |
| DriverStandbyPower | The standby power consumption of the driver electronics [W].This is the quiescent power drawn when no dipole moment is commanded. |
| In_DipoleArrayMsg | Incoming array of dipole commands [A*m^2]. |
| Out_DipoleArrayMsg | Outgoing array of dipole commands that have been scaled based onavailable power [A*m^2]. If the commanded dipoles require more voltagethan available (VoltageIn), the output is scaled proportionally. |
| Inherited | Description |
|---|---|
| CurrentIn | The current flowing into this node at the In terminal.Under flow-through convention, positive means current enters at In and exits at Out.Equal to CurrentOut in steady state for two-terminal elements. |
| CurrentOut | The current flowing out of this node at the Out terminal.Under flow-through convention, positive means current exits at Out (entered at In).Equal to CurrentIn in steady state for two-terminal elements. |
| IsEnabled | Is true if the object is currently enabled. |
| IsOpenCircuit | A flag if the power node is currently open and no power willbe transferred to the next component. |
| Name | The display name or tag of this object. |
| NetPower | Net power this node contributes to the bus, calculated directly from thevoltages and currents at the In and Out terminals:NetPower = VoltageOut * CurrentOut - VoltageIn * CurrentInThis is the power delivered to the external circuit by this node (the negativeof the power absorbed by it). Under the flow-through convention, positiveCurrentIn represents current entering at the In terminal and positiveCurrentOut represents current exiting at the Out terminal.A positive NetPower means the node is adding power to the bus (e.g. a solarpanel producing power, a discharging battery). A negative NetPower means thenode is consuming power from the bus (e.g. a power sink, a charging battery,resistive losses in a fuse/switch/component).For a two-terminal element CurrentIn == CurrentOut, so this reduces to(VoltageOut - VoltageIn) * I. When one terminal is connected to ground andthe bus has ZeroGroundPlane enabled, that terminal’s voltage and current areboth zero, so the formula still represents the true energy exchange at thenon-grounded terminal (e.g. V_out * I_out for a ground-referenced source orbattery, -V_in * I_in for a ground-referenced load). |
| Out_PowerNodeMsg | The power node message that stores all the properties ofthe node. |
| Parent | The currently attached parent object. |
| Power | The Power consumed by this power node |
| Resistance | The Resistance of the node. |
| SelfSolve | A Flag to determine if the Power Node Model should update Output parameters itself if not connected to a PowerBus |
| VoltageIn | The voltage at the In (negative) terminal of this node.For a load connected between a source and ground, this is the higher potential side. |
| VoltageNode | The voltage drop across the node: VoltageIn - VoltageOut.Positive for a load (current flows from higher to lower potential).Negative for a source (Out terminal at higher potential than In). |
| VoltageOut | The voltage at the Out (positive) terminal of this node.For a load connected between a source and ground, this is the lower potential side. |
Methods
| Inherited | Description |
|---|---|
| Clear | Clear the Power Node Model if the circuit is open |
| FindParentWithID | Returns an attached parent that satisfies the specified ID. |
| FindParentWithType | Returns an attached parent that satisfies the specified type. |
| FindRootWithID | Returns a root object that satisfies the specified ID. |
| FindRootWithType | Returns a root object that satisfies the specified type. |