Skip to main content
Version: 4.14

GNC

Guidance, Navigation, and Control (GNC) refers to the systems on a spacecraft that give it the capability to know where it is, which way it is facing, and how to get to where we want it to go.

Spacecraft Mass Properties

In this section, you must specify the dry mass (spacecraft mass without fuel) and dry inertia matrix for the Wildfire spacecraft. These values affect the ease with which the spacecraft can be moved and rotated.

Define the mass properties

Input these values:

  • Dry mass: 1000 kg
  • Dry inertia matrix:
    27000
    04200
    00520

Fuel Tanks

Fuel tanks are used to store fuel and are aggregated together with fuel reservoirs.

Create a fuel tank

Add the following fuel tank:

Fuel Tank NameFuel Capacity (kg)Initial Fuel Mass (kg)PriorityTank ShapeCylinder Length (m)Cap Diameter (m)Length Orientation VectorTank Centroid Location [X, Y, Z]
Fuel Tank35351Spherocylinder0.30.3+X[0, 0, 0]

Fuel reservoirs

Fuel reservoirs are abstract fuel collections comprised of fuel tanks. Thrusters pull from fuel reservoirs, which in turn pull from one or more fuel tanks.

Create a fuel reservoir

Add the following fuel reservoir:

Reservoir NameFuel Tanks
Fuel ReservoirFuel Tank

Sensors

Sensors allow your spacecraft to collect information that it uses to detect where it is and which way it is facing.

Create a sensor

Add these sensors:

Sensor NameSensor TypeDirection Vector1σ ErrorsSensor Field of View
Star TrackerOptical Attitude SensorCross-Axis: 0.0015°
Boresight: 0.01°
Star Tracker FoV
GyroAngular Velocity SensorPer-Axis: 0.0004 rad/s
MagnetometerDirection SensorMagnetic FieldAngle: 1°
GPSPosition Sensor0.01 km

Actuators

Actuators give your spacecraft the ability to move and rotate itself.

Create an actuator

Before you add any actuators, you will need to momentarily skip ahead to add the power controller and bus regulators so that you can use them as power sources. Complete the Power Processing step of the Power section and then return here.

Reaction Wheels

Reaction wheels are the most commonly used actuators to control a spacecraft's orientation. They work by speeding up or slowing down a spinning disk in the reaction wheel housing, which in turn rotates the spacecraft.

To add a reaction wheel, select Reaction Wheel in the Actuator Type dropdown when creating an actuator. Add the following reaction wheels:

Actuator NameInertia (kg·m2)Rated Torque (N·m)Rated Angular Momentum (kg·m2/s)EfficiencyTorque Body Frame VectorPower Source
RW-X0.020.25890%+X28 V
RW-Y0.020.25890%+Y28 V
RW-Z0.020.25890%+Z28 V

Magnetorquers

Magnetorquers are another type of commonly used actuator. They work as electromagnets that use Earth's gravitational field to produce a very small force to rotate the spacecraft. They are often coupled with reaction wheels to help prevent the reaction wheels from becoming slowly overwhelmed.

To add a magnetorquer, select Magnetorquer in the Actuator Type dropdown when creating an actuator. Add the following magnetorquers:

Actuator NameRated Magnetic Moment (A·m2)Power at Rated Magnetic Moment (W)Torque Body Frame VectorPower Source
MT-X102+X12 V
MT-Y102+Y12 V
MT-Z102+Z12 V

Thrusters

Thrusters are used to change the velocity of a spacecraft and are often intended for use in changing the spacecraft's orbit. Wildfire will use its thruster to raise its orbit at the beginning of its simulation.

To add a thruster, select Thruster in the Actuator Type dropdown when creating an actuator. Add the following thruster:

Actuator NameSpecific Impulse (s)Minimum Thrust (N)Maximum Thrust (N)Thruster Location [X, Y, Z]Thruster OrientationFuel ReservoirPower Source
Thruster22550125[0.5, 0, 0]+XFuel ReservoirPower Processor

Algorithms

Algorithms are used to determine the specific behavior of sensor measurement outputs and actuator inputs.

Create an algorithm

Add the following algorithms:

Algorithm NameAlgorithm TypeAlgorithm GainsSensors/Actuators
Attitude DeterminationMEKFGyro, Star Tracker
Orbit DeterminationGPS DirectGPS
Attitude ControlSliding ModeGain K: 0.1
Gain G: 0.015
Gain C: 0.03
Epsilon: 0.07
RW-X, RW-Y, RW-Z, MT-X, MT-Y, MT-Z
Nominal ThrustStatic Thrust ControlThrust: 100 NThruster

Pointing Modes

Pointing modes determine which direction your agent will try to point in a simulation. Each operational mode has an associated pointing mode, which in turn has associated algorithms. There are three main types of pointing modes:

  • Passive: the agent will not use actuators to actively control its orientation
  • Direction Lock: the agent will use actuators to try to align one of its body frame vectors with a reference vector
  • Max Secondary Alignment: the agent will use actuators to try to align one of its body frame vectors with a reference vector and will simultaneously try to maximize the alignment between a secondary body frame vector and reference vector pair

Create a pointing mode

For each pointing mode, associate the algorithms you created above with the orbit determination, attitude determination, and attitude control algorithms slots. Only associate the thrust control algorithm with the Burn Pointing pointing mode. Add the following pointing modes:

Pointing Mode NamePointing Mode TypeLocked Body Frame Vector & Pointing DirectionMax Aligned Body Frame Vector & Pointing Direction
Burn PointingDirection Lock-X & Ram
Crosslink PointingDirection LockCrosslink Boresight & LaserComm Relays
Forward PointingMax Secondary Alignment-X & Ram+Z & Sun
Nadir Idle PointingMax Secondary Alignment-Z & Nadir-X & Sun
Imaging PointingMax Secondary Alignment-Z & Wildfires-X & Sun