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)

Pgn2tex - Scripts to convert pgn files to latex document. Useful to build books or pdf from pgn studies

Real-time 3D multi-person detection made easy with OpenPose and the ZED

The Official Implementation of Neural View Synthesis and Matching for Semi-Supervised Few-Shot Learning of 3D Pose [NIPS 2021].

Implementation of the master's thesis "Temporal copying and local hallucination for video inpainting".

Invertible conditional GANs for image editing

PICARD - Parsing Incrementally for Constrained Auto-Regressive Decoding from Language Models

Alias-Free Generative Adversarial Networks (StyleGAN3) Official PyTorch implementation

GraphLily: A Graph Linear Algebra Overlay on HBM-Equipped FPGAs

SWA Object Detection

PyTorch implementation of our method for adversarial attacks and defenses in hyperspectral image classification.

Banglore House Prediction Using Flask Server (Python)

PyTorch Implementation of CycleGAN and SSGAN for Domain Transfer (Minimal)

PyTorch Implementation of Sparse DETR

The dynamics of representation learning in shallow, non-linear autoencoders

This repository contains FEDOT - an open-source framework for automated modeling and machine learning (AutoML)

This project is based on our SIGGRAPH 2021 paper, ROSEFusion: Random Optimization for Online DenSE Reconstruction under Fast Camera Motion .

Fine-tuning StyleGAN2 for Cartoon Face Generation

A Low Complexity Speech Enhancement Framework for Full-Band Audio (48kHz) based on Deep Filtering.

Official code for: A Probabilistic Hard Attention Model For Sequentially Observed Scenes

Algebraic effect handlers in Python