ADCS.satellite_hardware.errors.helpers.error_mode module

class ADCS.satellite_hardware.errors.helpers.error_mode.ErrorMode(add_bias, add_noise, update_bias, update_noise)[source]

Bases: object

Disturbance Mode Configuration.

This data class defines binary control flags that determine how a disturbance model contributes to spacecraft dynamics and how its internal stochastic components evolve over time.

It is typically consumed by disturbance models derived from Disturbance to control the inclusion of bias terms and noise processes in the applied disturbance torque or force.

Mathematical Interpretation

Let a generic disturbance be modeled as

\[\mathbf{d}(t) = \mathbf{d}_0 + \mathbf{b}(t) + \mathbf{n}(t),\]

where

  • \(\mathbf{d}_0\) is the nominal deterministic disturbance,

  • \(\mathbf{b}(t)\) is a bias term (typically slowly varying),

  • \(\mathbf{n}(t)\) is a stochastic noise term.

The boolean flags in this class determine whether each component is included in the dynamics and whether it is time-varying.

Flag Semantics

add_bias:

If True, the bias term \(\mathbf{b}(t)\) is added to the disturbance dynamics.

add_noise:

If True, the noise term \(\mathbf{n}(t)\) is added to the disturbance dynamics.

update_bias:

If True, the bias term evolves over time, typically according to a random walk model,

\[\mathbf{b}_{k+1} = \mathbf{b}_k + \mathbf{w}_k,\]

where \(\mathbf{w}_k\) is a zero-mean process noise.

update_noise:

If True, a new noise realization is sampled at each evaluation step.

param add_bias:

Enables inclusion of a bias term in the disturbance model.

type add_bias:

bool

param add_noise:

Enables inclusion of a stochastic noise term in the disturbance model.

type add_noise:

bool

param update_bias:

Enables time evolution of the bias term.

type update_bias:

bool

param update_noise:

Enables resampling of the noise term at each call.

type update_noise:

bool

return:

Disturbance mode configuration container.

rtype:

DisturbanceMode

add_bias: bool
add_noise: bool
update_bias: bool
update_noise: bool
Parameters:

  • add_bias (bool)

  • add_noise (bool)

  • update_bias (bool)

  • update_noise (bool)