Git Product home page Git Product logo

rtl-power-fftw's Introduction

rtl_power_fftw

rtl_power_fftw is a program that obtains a power spectrum from RTL devices using the FFTW library to do FFT.

It is inspired by the program rtl_power in librtlsdr. However, the said program has several deficiencies that limit its usage in demanding environments, such as radio astronomy. An inspection of rtl_power in hope of modifying it and obtaining better performance resulted in the conclusion that it would be an unfeasible task. Measurements of FFT performance showed that the leading library in the field of FFT - fftw - makes mincemeat of the routine used in rtl_power, even on simple processors such as raspberryPi. Therefore, the following requirements for a program to obtain power spectrum from rtlsdr devices were set out:

  • the new program should use the fftw library
  • it will (of course) use librtlsdr to interface device
  • it should process spectra in a separate thread from data acquisition, to optimize observation time (continuous sampling)
  • it should be friendly to use and adhere to the UNIX philosophy of only doing one thing, but doing it well
  • the output of the program should be easy to further use with the standard tools (like gnuplot).

The desire to have simple code to handle option parsing lead to the choice of TCLAP and therefore C++. This further meant that to implement things in a neat way, C++11 functionality snuck into the program and therefore a modern, C++11 enabled compiler is needed to compile rtl_power_fftw.

Prerequisites

In order to prepare your environment to build from the sources you have to first install a couple of development libraries. This step is needed only the first time.

sudo apt-get install libfftw3-dev libtclap-dev librtlsdr-dev pkg-config

Installation

To compile the program, cd into the directory where you have cloned the code and do:

mkdir build
cd build
cmake ..
make

This should make the rtl_power_fftw binary in the build directory. If you copy it into a directory in your PATH, you can call it from everywhere. You can also do make install and by default it will be copied to /usr/local/bin.

Documentation

The man page of rtl_power_fftw is available here. It is maintained in Markdown format suitable for reading online, but it is also converted into a regular man page that gets installed along with the program.

TODO:

  • ... (there's always something, isn't it?!)

Many thanks to Andrej Lajovic for cleaning up the C++ code, implementing a better buffer handling system and relentlessly improving the program.

rtl-power-fftw's People

Contributors

klemenblokar avatar alajovic avatar exzombie avatar mariocannistra avatar shrx avatar calston avatar petteriaimonen avatar avian2 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.