SatLink is a python based application that runs speciffic satellite downlink calcullations. It has a GUI and his main functions are:

• Atmospheric attenuation calcullation (via itur)
• Single and multi-point downlink avaiability calcullation (input and output csv file)
• Antenna size estimation for a desired availability (single point graphic plot and multi point csv output)
• Save and load parameters for satellites, ground stations and reception characteristics
• Totally free !!!

This project is a attempt to simplify satellite's link budget calcullations and to create a tool for teaching purposes. Please check the documentation for more detailed information.

For those that dont like code writing

• Simple Qt Gui made for simple usage
• Drop lists can be edited via model folder

To run the calcullations via GUI interface, run the python file main_window.py. The main window will appear. Now, just choose the functions in the action menu

Detailed information about the usage of the GUI can be found in the documentation.

A Satlink web app implementation can be used by building a dockerfile using this and runing satlink_web.py (needs to install streamlit package to work)

SatLink consists of three main classes

• Satellite class
• Ground Station class
• Reception class

You need to define those three objects and set their relationship

from GrStat import GroundStation, Reception
from sat import Satellite

# creating the objects
station = GroundStation(site_lat, site_long)
sat = Satellite(sat_long, freq, eirp_max, hsat, b_transponder, b_util, _, _, mod, rolloff, fec)
receptor = Reception(ant_size, ant_eff, coupling_loss, polarization_loss, lnb_gain, lnb_noise_temp, cable_loss, desfoc_max)

# relating the objets to the satellite
sat.set_grstation(station)
sat.set_reception(receptor) 

# example - calcullating the link availability
availability = sat.get_availability()
print(availability)  # 0 - 100 percentage

# example - calcullating the power flux density in the reception point and the antenna noise in rain conditions
pw_flx = sat.get_power_flux_density()
print(pw_flx)  # watts/m²
ant_noise = sat.reception.get_antenna_noise_temp()
print(ant_noise)  # Kelvin
ant_noise_rain = sat.get_antenna_noise_rain()
print(ant_noise_rain)  # Kelvin

The other functions are detailed in the documentation.

SatLink uses a bunch of different open source python libraries

• itur - A python implementation of the ITU-R P. Recommendations to compute atmospheric attenuation in slant and horizontal paths
• pyqt - PyQt is a set of Python bindings for The Qt Company's Qt application framework
• tqdm - Instantly make your loops show a smart progress meter
• pathos - It provides a consistent high-level interface for configuring and launching parallel computations across heterogeneous resources.
• pandas - Fast, powerful, flexible and easy to use open source data analysis and manipulation tool
• astropy - Common core package for Astronomy in Python and foster an ecosystem of interoperable astronomy packages
• numpy - The fundamental package for scientific computing with Python

SatLink is currently tested only in python 3. Just copy all the folders and files to any directory and make sure all packages are installed. To install the packages, just run first_setup.py, located in the main SatLink's folder, for a fresh package installation or run the following commands

pip install -r requirements.txt

or

pip install itur==0.2.1
pip install tqdm==4.56.0
pip install pandas==1.2.1
pip install pathos==0.2.7
pip install astropy==4.2
pip install pyqt5==5.15.2
pip install matplotlib==3.4.1

Run main_window.py to start the applicaiton via interface.

Since this is still a early version of the code, we expect there some problem can be found, We are tottaly open for contributions and bug/problems reports. Please tell us!

Some updates are planned for the future of the SatLink

• Worst month availabilty calcullation
• Web application
• Map function
• More robust XPD calculations

All the code development was made by Christian Rodrigues.

Contact: christianfragoas@gmail.com

Globo - For supporting the very first release version of the application

Caio Alexandre - Logo designer