agi.foundation.communications.signalprocessing

(agi.foundation.communications-2025r1.jar)

Class DigitalModulation

java.lang.Object

agi.foundation.communications.signalprocessing.DigitalModulation

Direct Known Subclasses:

ModulationFsk, ModulationOok, ModulationPsk

public abstract class DigitalModulation
extends Object

Base class for types defining methods for digital modulation of signals.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DigitalModulation() Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
abstract double	computeBitErrorRate(double bitEnergyPerNoiseDensity) A method to decode the digital signal and produce the probability that any given bit will be incorrect.
double	computeBitErrorRate(Signal intendedSignal) A method to decode the digital signal and produce the probability that any given bit will be incorrect.
abstract double	getSpectralEfficiency() Gets the spectral efficiency representing the number of bits that can be represented per unit bandwidth, in bps/Hz.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DigitalModulation

protected DigitalModulation()

Initializes a new instance.

Method Detail

computeBitErrorRate

public double computeBitErrorRate(@Nonnull
                                  Signal intendedSignal)

A method to decode the digital signal and produce the probability that any given bit will be incorrect.

Parameters:

intendedSignal - The signal object which represents the digital data.

Returns:

The bit error rate.

Throws:

ArgumentNullException - Thrown when intendedSignal is null.

computeBitErrorRate

public abstract double computeBitErrorRate(double bitEnergyPerNoiseDensity)

A method to decode the digital signal and produce the probability that any given bit will be incorrect.

Parameters:

bitEnergyPerNoiseDensity - The bit energy per noise density ratio (Eb/No).

Returns:

The bit error rate.

getSpectralEfficiency

public abstract double getSpectralEfficiency()

Gets the spectral efficiency representing the number of bits that can be represented per unit bandwidth, in bps/Hz.

This specifies the bandwidth needed to represent a certain SignalDataRate successfully. The half-bandwidth (or base-band bandwidth) of the corresponding signal is the data rate divided by the spectral efficiency.