Channels - ephemerista.comms.channels

The channels.py module.

This module provides the Channel class which models a radio communications channel.

class ephemerista.comms.channels.Channel(*, id=<factory>, linkType, name='Default Channel', dataRate, requiredEbN0, margin, modulation, rollOff=1.5, forwardErrorCorrection=0.5)

The Channel class.

property bandwidth: float

bandwidth of the channel in Hz.

Type:

float

bit_energy_to_noise_density(tx, rx, losses, rng, tx_angle, rx_angle)

Calculate Eb/N0.

This method calculates the energy per bit to noise power spectral density ratio for a link between a transmitting CommunicationSystem and a receiving CommunicationSystem on this channel.

Parameters:
  • tx (CommunicationSystem) – The TX communication system.

  • rx (CommunicationSystem) – The RX communication system.

  • losses (float) – The sum of the environmental losses

  • rng (float) – The slant range in meters.

  • tx_angle (float) – The angle between the transmitter antenna’s boresight vector and the transmitter-receiver vector in radians.

  • rx_angle (float) – The angle between the receiver antenna’s boresight vector and the receiver-transmitter vector in radians.

Returns:

The energy per bit to noise power spectral density ratio Eb/N0 in dB.

Return type:

float

bit_energy_to_noise_interference_density(tx, rx, losses, rng, tx_angle, rx_angle, bandwidth, interference_power_w)

Calculate the energy per bit to noise and interference power spectral density Eb/(N0+I0).

Parameters:
  • tx (CommunicationSystem) – The TX communication system.

  • rx (CommunicationSystem) – The RX communication system.

  • losses (float) – The sum of the environmental losses

  • rng (float) – The slant range in meters.

  • tx_angle (float) – The angle between the transmitter antenna’s boresight vector and the transmitter-receiver vector in radians.

  • rx_angle (float) – The angle between the receiver antenna’s boresight vector and the receiver-transmitter vector in radians.

  • bandwidth (float) – The channel’s bandwidth in Hz.

  • interference_power_w (float) – The interference power in W.

Returns:

The energy per bit to noise and interference power spectral density Eb/(N0+I0) in dB.

Return type:

float

bits_per_symbol()

Return the required bits per symbol for the channel’s modulation scheme.

Returns:

The number of bits per symbol corresponding to the channels’ modulation scheme.

Return type:

int

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].