Communication Systems - ephemerista.comms.systems¶
The systems.py module.
This module provides the CommunicationSystem class.
- class ephemerista.comms.systems.CommunicationSystem(*, id=<factory>, channels, antenna, receiver=None, transmitter=None)¶
The CommunicationSystem class.
This class composes the Antenna, Receiver, and Transmitter classes to form a model of full communication system. To instances of compatible communication systems are required to compute the properties of a link between the two systems.
- carrier_power(rx, losses, rng, tx_angle, rx_angle)¶
Calculate the carrier power at receiver input in dBW.
- Parameters:
rx (
Self) – The RX communication system.losses (
float) – The sum of the environmental lossesrng (
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 carrier power at receiver input in dBW.
- Return type:
float
- carrier_to_noise_density(rx, losses, rng, tx_angle, rx_angle)¶
Calculate the carrier-to-noise density C/N0.
- Parameters:
rx (
Self) – The RX communication system.losses (
float) – The sum of the environmental lossesrng (
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 carrier-to-noise density C/N0 in dB.Hz.
- Return type:
float
- carrier_to_noise_interference_density(rx, losses, rng, tx_angle, rx_angle, bandwidth, interference_power_w)¶
Calculate the carrier-to-noise interference density C/(I0+N0) in dBHz.
- Parameters:
rx (
Self) – The RX communication system.losses (
float) – The sum of the environmental lossesrng (
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.interference_power_w (
float) – The interference power in W
- Returns:
The carrier-to-noise interference density C/(I0+N0) in dBHz.
- Return type:
float
- 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].
- noise_power(rx, bandwidth)¶
Calculate the noise power in dBW.
- Parameters:
rx (
Self) – The RX communication system.bandwidth (
float) – The channel’s bandwidth in Hz.
- Returns:
The noise power in dBW.
- Return type:
float