A python3 tool to take a 360 degree survey of the RF spectrum (hamlib + rotctld + RTL-SDR/HackRF)

Last update: Dec 13, 2022

Overview

RF Light House (rflh)

A python script to use a rotor and a SDR device (RTL-SDR or HackRF One) to measure the RF level around and get a data set and beautiful interactive graphics.

WARNING: This repository is new and under construction, you will see some [TODO] & "(work in progress...)" sections/docs yet.

Motivation

This project born from a friend's challenge to measure the background noise impact on my 70cm satellite band noise floor, from a new 2/3/4G cellular tower that my ISP is setting up 50m away from my antennas and with direct sight.

Soon I realized the true potential of it and it get bigger and feature rich quickly.

Features

At the end of the execution you get:

A cvs file in the data folder with the resulting data
A png image in the data folder with the rose plot

Both files are named as follows: YYYMMDD_HHMM_device_freqMHz_BWkHz_stepo with the matching .csv and .png extensions. The runtime text on the console name the files created for easy parsing (unless you select the 'quiet' option)

For example a real fast scan showing the references to the img & cvs file for parsing:

310(307.5);-102,16941998017171
320(317.5);-101,77656601734243
330(327.5);-101,55990296468812
340(337.5);-101,583492037594
350(347.5);-102,01302571365707
Scan took 0:53
CSVFile: data/20220108_1357_rtl_145.17MHz_300kHz_10o.csv
Parking the rotor in the background
Reattached kernel driver
Dynamc range: 2.9333941135273136 dB, 10%: 0.2933394113527314
Min: -104.78663648956817, Max -101.26656355333539
ImgFile: data/20220108_1357_rtl_145.17MHz_300kHz_10o.png

You can stop the generation of the cvs and the image files if not needed, take a peek on the options.

Also if you are on a GUI enviroment you can issue the '-i' or '--interactive' switch and at the end of the sweep a interactive matplotlib graph will popup.

For a more detailed technical stuff on the features see OPTIONS_EXPLAINED.md (work in progress...)

Installation

As any script in python you will need some dependencies, default dev env is Ubuntu Linux 20.04 LTS. I'm working/testing a single portable file for linux/windows/mac but it's not ready yet (pyinstall stuff)

The installation of the utilities & python modules are covered in the Install document.

At the end of the we have some examples / use cases at the end of the OPTIONS_EXPLAINED.md document.

Author, contributions, code & donations

The author is Pavel Milanes Costa (CO7WT), you can join the team contributing with code fix, improvements, bug reports, ideas, etc. Use te "Issues" tab for that.

This software is Free Software under GPLv3, see LICENCE; free as in freedom.

If you find this piece of soft usefull and want to support the author with a tip, hardware donation or just a change for a coffee please contact me at [email protected] for instructions.

For money tips you can use my QvaPay donation page, thanks in advance!

You might also like...

Aiming at the common training datsets split, spectrum preprocessing, wavelength select and calibration models algorithm involved in the spectral analysis process

Aiming at the common training datsets split, spectrum preprocessing, wavelength select and calibration models algorithm involved in the spectral analysis process, a complete algorithm library is established, which is named opensa (openspectrum analysis).

50 Jan 7, 2023

Lighting the Darkness in the Deep Learning Era: A Survey, An Online Platform, A New Dataset

Lighting the Darkness in the Deep Learning Era: A Survey, An Online Platform, A New Dataset This repository provides a unified online platform, LoLi-P

457 Jan 3, 2023

Repository for the COLING 2020 paper "Explainable Automated Fact-Checking: A Survey."

Explainable Fact Checking: A Survey This repository and the accompanying webpage contain resources for the paper "Explainable Fact Checking: A Survey"

42 Nov 17, 2022

Deep Learning for 3D Point Clouds: A Survey (IEEE TPAMI, 2020)

🔥Deep Learning for 3D Point Clouds (IEEE TPAMI, 2020)

1.4k Jan 8, 2023

This is the accompanying toolbox for the paper "A Survey on GANs for Anomaly Detection"

Anomaly detection using GANs.

77 Nov 30, 2022

🔮 A refreshing functional take on deep learning, compatible with your favorite libraries

Thinc: A refreshing functional take on deep learning, compatible with your favorite libraries From the makers of spaCy, Prodigy and FastAPI Thinc is a

2.6k Dec 30, 2022

Let Python optimize the best stop loss and take profits for your TradingView strategy.

TradingView Machine Learning TradeView is a free and open source Trading View bot written in Python. It is designed to support all major exchanges. It

473 Jan 9, 2023

Python project to take sound as input and output as RGB + Brightness values suitable for DMX

sound-to-light Python project to take sound as input and output as RGB + Brightness values suitable for DMX Current goals: Get one pixel working: Vary

1 Nov 17, 2021

In this project, two programs can help you take full agvantage of time on the model training with a remote server

In this project, two programs can help you take full agvantage of time on the model training with a remote server, which can push notification to your phone about the information during model training, like the model indices and unexpected interrupts. Then you can do something in time for your work.

8 Dec 27, 2022

Comments

Configure the rotctld options from a config file instead of in a script

Now you have to configure the rotor in a separated script file that you need to configure and test.

I'm thinking on a rotor.ini file with some default configs the users can un-comment and adapt, and that the own python script rise and release the rotctld process in the background.
enhancement

opened by stdevPavelmc 2
Portable APP?

Yes a portable app will be cool...

But there are some limitations on the drivers on the linux/mac side, and unknown results on Linux.

I will try to come with a solution like this, but at the moment only source distribution is possible.
enhancement WIP

opened by stdevPavelmc 1

A python3 tool to take a 360 degree survey of the RF spectrum (hamlib + rotctld + RTL-SDR/HackRF)

Related tags

Overview

RF Light House (rflh)

Motivation

Features

Installation

Author, contributions, code & donations

You might also like...

Aiming at the common training datsets split, spectrum preprocessing, wavelength select and calibration models algorithm involved in the spectral analysis process

Lighting the Darkness in the Deep Learning Era: A Survey, An Online Platform, A New Dataset

Repository for the COLING 2020 paper "Explainable Automated Fact-Checking: A Survey."

Deep Learning for 3D Point Clouds: A Survey (IEEE TPAMI, 2020)

This is the accompanying toolbox for the paper "A Survey on GANs for Anomaly Detection"

🔮 A refreshing functional take on deep learning, compatible with your favorite libraries

Let Python optimize the best stop loss and take profits for your TradingView strategy.

Python project to take sound as input and output as RGB + Brightness values suitable for DMX

In this project, two programs can help you take full agvantage of time on the model training with a remote server

Comments

Configure the rotctld options from a config file instead of in a script

Portable APP?

Releases(v0.0.3-alpha)

v0.0.3-alpha(Jan 9, 2022)

v0.0.2-alpha(Jan 9, 2022)

Owner

Pavel Milanes (CO7WT)

Shape Matching of Real 3D Object Data to Synthetic 3D CADs (3DV project @ ETHZ)

PyTorch Autoencoders - Implementing a Variational Autoencoder (VAE) Series in Pytorch.

Continuous Query Decomposition for Complex Query Answering in Incomplete Knowledge Graphs

PyTorch code of my ICDAR 2021 paper Vision Transformer for Fast and Efficient Scene Text Recognition (ViTSTR)

A PyTorch version of You Only Look at One-level Feature object detector

SLIDE : In Defense of Smart Algorithms over Hardware Acceleration for Large-Scale Deep Learning Systems

Python library for tracking human heads with FLAME (a 3D morphable head model)

A 35mm camera, based on the Canonet G-III QL17 rangefinder, simulated in Python.

Single Red Blood Cell Hydrodynamic Traps Via the Generative Design

Binary classification for arrythmia detection with ECG datasets.

Self-Supervised Image Denoising via Iterative Data Refinement

The (Official) PyTorch Implementation of the paper "Deep Extraction of Manga Structural Lines"

Workshop Materials Delivered on 28/02/2022

Tensorflow implementation of our method: "Triangle Graph Interest Network for Click-through Rate Prediction".

Generative Query Network (GQN) in PyTorch as described in "Neural Scene Representation and Rendering"

[WWW 2021] Source code for "Graph Contrastive Learning with Adaptive Augmentation"

Anatomy of Matplotlib -- tutorial developed for the SciPy conference

a practicable framework used in Deep Learning. So far UDL only provide DCFNet implementation for the ICCV paper (Dynamic Cross Feature Fusion for Remote Sensing Pansharpening)

paper: Hyperspectral Remote Sensing Image Classification Using Deep Convolutional Capsule Network

Python Library for learning (Structure and Parameter) and inference (Statistical and Causal) in Bayesian Networks.