sc_link.h File Reference

Link functions. More...

Functions
double	moon_noise_temperature ()
	Moon link noise temperature.
double	earth_noise_temperature ()
	Earth link noise temperature.
double	sun_noise_temperature (double f)
	Sun link noise temperature.
double	receiver_temperature (double tA, double lFRX, double tF, double tERX)
	Receiver input temperature.
double	attenuator_temperature (double t, double loss)
	Attenuator temperature.
double	bit_error_probability (int type, double bitRate, double cOverN)
	Bit error probability.
double	dipole_antenna_gain ()
	Gain of a dipole antenna.
double	signal_gain_to_db (double gain)
	Convert gain to db for a signal.
double	db_to_signal_gain (double db)
	Convert db to gain for a signal.
double	noise_temperature_to_power (double t, double b)
	Convert noise temperature to power.
double	eirp (double antenna_gain, double power_transmit, double feed_loss)
	EIRP.
double	antenna_beam_width (double antenna_diameter, double frequency)
	Antenna beam width.
double	signal_power (double eirp, double wavelength, double distance, double receive_gain)
	Signal power.
double	antenna_gain (double efficiency, double frequency, double antenna_diameter)
	Antenna gain.
double	energy_per_bit_per_noise_power_density (double c_over_n0, double channel_data_rate)
	Energy per bit per noise power density.
double	c_over_n (double eirp, double path_loss, double g_over_t, double bandwidth)
	Carrier to noise ratio.
double	c_over_n0 (double eirp, double path_loss, double g_over_t, double margin=0)
	Carrier to noise ratio per unit bandwidth.
int	message_success (int guard_bits, int bits, double range, double freq, double g_over_t, double eirp, double channel_data_rate)
	Message success.
double	loss_free_space (double range, double frequency)
	Free space loss.
double	c_over_n_total (const ml_matrix &c_over_n)
	C/N total.
int	link_visibility (const ml_matrix &r_gs, const ml_matrix &r_sat, double min_angle=0)
	1 if the ground station can see the satellite

---

Detailed Description

---

Function Documentation

double moon_noise_temperature

(

)

Moon link noise temperature.

Returns:

noise temperature (deg-K)

double earth_noise_temperature

(

)

Earth link noise temperature.

Returns:

noise temperature (deg-K)

double sun_noise_temperature

(

double

f )

Sun link noise temperature.

Parameters:

Frequency

(GHz)

Returns:

noise temperature (deg-K)

double receiver_temperature	(	double	tA,
		double	lFRX,
		double	tF,
		double	tERX
	)

Receiver input temperature.

tA is the ambient temperature of the antenna and tERX is the receiver noise temperature. tF is the feeder noise temperature. This function combines them to compute the noise temperature at the input.

Parameters:

tA	(1,1) Antenna temperature (deg-K)
lFRX	(1,1) Feeder loss (dB)
tF	(1,1) Feeder temperature (deg-K)
tERX	(1,1) Receiver temperature (deg-K)

Returns:

noise temperature (deg-K)

double attenuator_temperature	(	double	t,
		double	loss
	)

Attenuator temperature.

t is the ambient temperature of the attenuator and loss is the effective input noise temperature.

Parameters:

t	(1,1) Ambient temperature of the attenuator
loss	(1,1) Loss (dB)

Returns:

Effective input noise temperature (deg-K)

double bit_error_probability	(	int	type,
		double	bitRate,
		double	cOverN
	)

Bit error probability.

Parameters:

type	(1,1) 0 = 'BPSK' 1 = 'QPSK' 2 = 'DE-BPSK' 3 = 'DE-QPSK' 4 = 'D-BPSK'
bitRate	(1,1) Bits/second
cOverN	(1,1) (C/N)T (dB)

Returns:

bit error probability

double dipole_antenna_gain

(

)

Gain of a dipole antenna.

Returns:

gain

double signal_gain_to_db

(

double

gain )

Parameters:

gain

Returns:

gain in db

double db_to_signal_gain

(

double

db )

Parameters:

gain

in db

Returns:

gain

double noise_temperature_to_power	(	double	t,
		double	b
	)

Convert noise temperature to power.

Parameters:

t	Temperature (deg-K)
b	Bandwidth (Hz)

Returns:

noise power (W)

double eirp	(	double	antenna_gain,
		double	power_transmit,
		double	feed_loss
	)

EIRP.

Parameters:

antenna_gain	(dB)
power_transmit	(dB)
feed_loss	(dB)

Returns:

eirp (dB)

double antenna_beam_width	(	double	antenna_diameter,
		double	frequency
	)

Antenna beam width.

Parameters:

antenna_diameter	(m)
frequency	(Hz))

Returns:

theta_3db

References SPEED_OF_LIGHT.

double signal_power	(	double	eirp,
		double	wavelength,
		double	distance,
		double	receive_gain
	)

Signal power.

Parameters:

eirp	(dB)
wavelength	(same units as distance);
distance	(same units as wavelength)
receive_gain	(dB)

Returns:

signal power (dB)

References PI.

double antenna_gain	(	double	efficiency,
		double	frequency,
		double	antenna_diameter
	)

Antenna gain.

Parameters:

efficiency
frequency	(Hz)
antenna_diameter	(m

Returns:

antenna gain (dB)

References PI, and SPEED_OF_LIGHT.

double energy_per_bit_per_noise_power_density	(	double	c_over_n,
		double	channel_data_rate
	)

Energy per bit per noise power density.

Parameters:

c_over_n	C/N (dB)
bandwidth	(Hz)
net	bitrate

Returns:

Eb/N0 (dB)

double c_over_n	(	double	eirp,
		double	path_loss,
		double	g_over_t,
		double	bandwidth
	)

Carrier to noise ratio.

Parameters:

eirp
g_over_t	Gain to system noise temperature (db/K)
bandwidth	Bandwidth (Hz)

Returns:

Carrier to noise ratio (dB)

double c_over_n0	(	double	eirp,
		double	path_loss,
		double	g_over_t,
		double	margin
	)

Carrier to noise ratio per unit bandwidth.

Parameters:

eirp
path_loss	Path loss (dB)
g_over_t	G/T of transmitter (dB)
margin	Link margin (dB)

Returns:

Carrier to noise ratio (dB)

int message_success	(	int	guard_bits,
		int	bits,
		double	range,
		double	frequency,
		double	g_over_t,
		double	eirp,
		double	channel_data_rate
	)

Message success.

Parameters:

guard_bits	(1,1) Number of guard bits
bits	(1,1) Bits in message
range	(1,1) Range (km)
frequency	(1,1) Frequency (GHz)
g_over_t	(1,1) G/T (dB)
eirp	(1,1) EIRP (dB)

Returns:

1 if the message was successfully received

double loss_free_space	(	double	range,
		double	frequency
	)

Free space loss.

Parameters:

range	(1,1) Range (km)
frequency	(1,1) Frequency (GHz)

Returns:

loss (dB)

References PI.

double c_over_n_total

(

const ml_matrix &

c_over_n )

C/N total.

Parameters:

c_over_n

(1,n) C/N or C/I

Returns:

total c/n

int link_visibility	(	const ml_matrix &	r_gs,
		const ml_matrix &	r_sat,
		double	min_angle
	)

1 if the ground station can see the satellite

Parameters:

r_gs	Vector to the ground station
r_sat	Vector to the satellite
min_angle	Minimum elevation angle

Returns:

total c/n

References PI.