Description
The Telemetry System governs all communication links between Transmitter and Receiver components across the simulation. It automatically creates and manages DataLinkMessage objects that represent the communication channels between compatible antenna pairs on different spacecraft, ground stations, or other entities. The system performs comprehensive link budget calculations each simulation step, computing signal power, noise power, interference, channel capacity, and bit error rates for every active link.
Example Use Cases
- Mission Communication Analysis: Evaluate uplink and downlink performance throughout a mission timeline.
- Constellation Design: Assess inter-satellite link availability and data throughput for distributed architectures.
- Interference Studies: Analyse the impact of jamming or co-channel interference on communication reliability.
- Ground Network Planning: Optimise ground station placement and scheduling based on link availability windows.
Module Implementation
The telemetry system operates as a centralised manager for all communication components. It maintains separate lists of transmitters and receivers, automatically creating bidirectional links between compatible pairs when antennas are added to the simulation.
Link Creation
When an antenna is added to the simulation, the telemetry system evaluates all existing antennas of the opposite type (transmitters for a new receiver, receivers for a new transmitter) and creates links where:
- Transmission Types Match: Both antennas must use the same transmission type (Radio or Optical)
- Different Root Objects: The antennas must belong to different root objects (e.g., different spacecraft)
Each link is represented by a DataLinkMessage that stores all computed link parameters and is accessible from both the transmitter and receiver.
Update Sequence
At each simulation step, the telemetry system performs calculations in two phases:
Phase 1 - Transmitter Processing: For each enabled transmitter:
- Process queued data packets
- For each link to a receiver:
- Calculate distance and Doppler shift
- Determine celestial access (line-of-sight past planets)
- Calculate connection fraction, pointing losses, and space loss
- Compute signal power and noise power
- Calculate baseline signal-to-noise ratio
Phase 2 - Receiver Processing: For each enabled receiver:
- Accumulate interference from all transmitting links
- For each connected link:
- Calculate effective signal-to-noise ratio including interference
- Compute channel capacity, energy per bit to noise ratio, and bit error rate
- Determine effective transmission rate
- Process received data packets
Doppler Shift
When enabled on a receiver, the telemetry system calculates the Doppler-shifted frequency based on the relative velocity between transmitter and receiver:
where:
- is the received frequency [Hz]
- is the transmitted frequency [Hz]
- is the relative velocity (positive for closing) [m/s]
- is the speed of light [m/s]
The relative velocity is computed from the rate of change of distance:
Connection Fraction
The connection fraction determines how well the transmitted signal falls within the receiver’s passband:
where is the receiver centre frequency and is the receiver bandwidth.
Free Space Path Loss
The space loss represents signal attenuation due to geometric spreading of the electromagnetic wave:
where:
- is the space loss [dB] (stored as positive value)
- is the distance between antennas [m]
- is the transmission frequency [Hz]
- is the speed of light [m/s]
This follows SMAD equation 13-23a, inverted to store loss as a positive decibel value.
Pointing Loss
The pointing loss accounts for antenna misalignment. For each antenna, the off-axis angle to the target is calculated:
where is the direction to the target and is the antenna boresight direction.
The pointing loss is then determined by either:
- Fixed Mode: A constant configured value
- Lookup Mode: Interpolation from a loaded electromagnetic pattern table
The total pointing loss is the sum of transmitter and receiver contributions:
Signal Power
The received signal power is calculated using the link budget equation:
where (all in dB or dBm):
- is the transmitter power
- is the transmitter line loss
- is the transmitter antenna gain
- is the transmitter pointing loss
- is the free space path loss
- is the atmospheric loss
- is the receiver antenna gain
- is the receiver pointing loss
For multi-band transmitters (e.g., Jamming Transmitter), the signal power is multiplied by the number of bands within the receiver’s frequency range.
Noise Power
The thermal noise power is calculated from the system noise temperature:
where:
- J/K is Boltzmann’s constant
- is the receiver bandwidth [Hz]
- is the system noise temperature [K]
Interference Power
Interference from other transmitting links is accumulated using a Gaussian roll-off model:
where the interference factor is:
with chosen so that interference falls to approximately 5% at the bandwidth edge.
Signal-to-Noise Ratio
The baseline SNR excludes interference:
The effective SNR includes interference:
Both are clamped to a minimum of 0 dB (linear ratio of 1).
Channel Capacity
The theoretical maximum data rate is calculated using the Shannon-Hartley theorem:
where is the channel capacity [bps] and is the bandwidth [Hz].
Energy per Bit to Noise Ratio
The normalises the SNR by the spectral efficiency:
where is the transmission bit rate [bps].
Bit Error Rate
The bit error rate is calculated based on the modulation scheme. For each modulation type, the BER is a function of :
| Modulation | BER Formula |
|---|---|
| BPSK | |
| QPSK | |
| BFSK | |
| 8-PSK | |
| 16-QAM | |
| 64-QAM |
The complementary error function is approximated using the Horner’s method (Abramowitz and Stegun 7.1.26):
where .
BER is clamped to the range , where 0.5 represents random noise (no signal).
Transmission Rate
The effective transmission rate is the minimum of the transmitter bit rate and channel capacity:
If the effective SNR falls below the receiver sensitivity threshold, the transmission rate is set to zero.
Celestial Access
Line-of-sight occlusion by celestial bodies is computed using ray-sphere intersection. For each planet in the Solar System, the system tests whether the line segment between transmitter and receiver intersects the planetary sphere:
Given:
- = receiver position
- = transmitter position
- = planet center
- = planet radius
The intersection is found by solving the quadratic:
where:
If the discriminant and both roots , the link is occluded.
Pass Tracking
The telemetry system tracks communication passes for each link:
- Passes: Incremented each time a link transitions from disconnected to connected
- Current Pass Time: Duration of the current pass, reset on new connection
- Total Pass Time: Cumulative time across all passes
- Current Data: Data transferred in current pass [Mb]
- Total Data: Cumulative data transferred [Mb]
Assumptions/Limitations
- Links are only created between antennas on different root objects; intra-spacecraft communication is not modelled.
- The system assumes far-field propagation; near-field effects are not considered.
- Atmospheric loss must be provided externally; the system does not compute atmospheric attenuation.
- The connection fraction uses a rectangular passband model; real filter responses may differ.
- Interference calculations assume all signals are independent; coherent interference is not modelled.
- The celestial access calculation models planets as perfect spheres; terrain and atmospheric refraction are not considered.
- Polarization mismatch losses are not explicitly computed.
- The system processes transmitters and receivers in parallel; race conditions are avoided by careful data structure design.
- Multi-path propagation effects are not modelled.
- The BER calculation assumes ideal matched filtering and synchronization.
References
[1] Wertz, J.R. and Larson, W.J. “Space Mission Analysis and Design (SMAD).” 3rd ed. Microcosm Press and Kluwer Academic Publishers, 1999.
[2] Sklar, B. “Digital Communications: Fundamentals and Applications.” 2nd ed. Prentice Hall, 2001.
[3] Abramowitz, M. and Stegun, I.A. “Handbook of Mathematical Functions with Formulas, Graphs, and Mathematical Tables.” Dover Publications, 1964.
[4] Shannon, C.E. “A Mathematical Theory of Communication.” Bell System Technical Journal, Vol. 27, 1948.