agi.foundation.communications.signalprocessing

(agi.foundation.communications-2024r2.jar)

Class ModulationPsk

java.lang.Object

agi.foundation.communications.signalprocessing.DigitalModulation

agi.foundation.communications.signalprocessing.ModulationPsk

Direct Known Subclasses:

ModulationBpsk, ModulationQpsk

public abstract class ModulationPsk
extends DigitalModulation

A basic method of digital modulation using "Phase Shift Keying".

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ModulationPsk(int bitsPerSymbol, double spectralEfficiency) Create a new instance based on the given data rate and chips per bit

Method Summary

Modifier and Type	Method and Description
double	computeBitErrorRate(double bitEnergyPerNoiseDensity) A method to decode the digital signal and produce the probability that any given bit will be incorrect.
boolean	equals(Object obj) Indicates whether another object is exactly equal to this instance.
int	getBitsPerSymbol() Gets the number of bits per symbol.
double	getSpectralEfficiency() Gets the spectral efficiency representing the number of bits that can be represented per unit bandwidth, in bps/Hz.
double	getSymbolRate(double dataRate) Gets the rate at which symbols are transmitted, based on the rate of bits.
int	hashCode() Returns a hash code for this instance, which is suitable for use in hashing algorithms and data structures like a hash table.

Methods inherited from class agi.foundation.communications.signalprocessing.DigitalModulation

computeBitErrorRate

Methods inherited from class java.lang.Object

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

Constructor Detail

ModulationPsk

protected ModulationPsk(int bitsPerSymbol,
                        double spectralEfficiency)

Create a new instance based on the given data rate and chips per bit

Parameters:

bitsPerSymbol - The number of bits used to designate each 'symbol'. A 'symbol' represents the behavior of the waveform over a given interval and is used to encode information onto the signal.

spectralEfficiency - The number of bits per unit bandwidth, in bps/Hz.

Method Detail

computeBitErrorRate

public double computeBitErrorRate(double bitEnergyPerNoiseDensity)

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

Specified by:

computeBitErrorRate in class DigitalModulation

Parameters:

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

Returns:

The bit error rate.

getSpectralEfficiency

public 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.

Specified by:

getSpectralEfficiency in class DigitalModulation

getBitsPerSymbol

public final int getBitsPerSymbol()

Gets the number of bits per symbol.

getSymbolRate

public final double getSymbolRate(double dataRate)

Gets the rate at which symbols are transmitted, based on the rate of bits.

Parameters:

dataRate - The data rate in bits per second.

Returns:

The symbol rate.

equals

public boolean equals(Object obj)

Indicates whether another object is exactly equal to this instance.

Overrides:

equals in class Object

Parameters:

obj - The object to compare to this instance.

Returns:

true if obj is an instance of this type and represents the same value as this instance; otherwise false.

See Also:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Returns a hash code for this instance, which is suitable for use in hashing algorithms and data structures like a hash table.

Overrides:

hashCode in class Object

Returns:

A hash code for the current object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)