Description
The State Effector is a Physical Object that provides forces to rotate an object on an axis. Unlike Dynamic Effector components that primarily adjust position, a State Effector adjusts internal states or rotations of the spacecraft.
Example Use Cases
- Reaction Wheel Dynamics: Include wheel spin states for momentum management analysis.
- Magnetic Torque Bar Dynamics: Include magnetic torque bar states for momentum management analysis.
Module Implementation
The State Effector registers additional state variables with the dynamics engine and participates in the numerical integration process.
Properties
| Property | Description |
|---|---|
| Force_B | Force that the state effector applies to the body (B) frame |
| Torque_LB_B | Torque that the state effector applies to the body about the body frame (B) |
| Torque_LC_B | Torque that the state effector applies to the body about the center of mass (C) |
| In_BodyMassMsg | Message for incoming body mass state from the root object |
Methods
| Method | Description |
|---|---|
| CalculateForceTorqueOnBody | Calculates the force and torque on the object due to the State Effector |
| ComputeDerivatives | Computes the derivatives of the body along with the kinematic derivatives |
| LinkStateProperties | Links and registers any states from the state model associated with the root object |
| ModifyStates | Modifies any state values after integration |
| WriteOutputStateMessages | Writes state messages after integration |
Inheritance
This base class is extended by specific state effector implementations such as reaction wheels, control moment gyroscopes, and flexible body models. Each derived class implements the methods to calculate its specific contributions to the spacecraft dynamics.