diff --git a/README-example.md b/README-example.md new file mode 100644 index 0000000..1487b73 --- /dev/null +++ b/README-example.md @@ -0,0 +1,218 @@ +# CygnusRFI: An open-source RFI analysis tool for Ground Stations & Radio Telescopes +An example run. + + +![RF Plot](img/example-rfi_plot.png) + + +``` +(env) jebba@cruftpi4:~/devel/spacecruft/CygnusRFI $ python CygnusRFI.py -b 2400000 -c 2048 -t 0.5 -d 5 -f 400000000 -F 430000000 + ++=================================================================+ +| CygnusRFI: An open-source Radio Frequency Interference analyzer | ++=================================================================+ + +RFI Measurement Parameters: +Frequency range to scan: 400.0-430.0 MHz +Bandwidth per spectrum: 2.4 MHz +Integration time per spectrum: 5 sec +Number of channels per spectrum (FFT Size should be a power of 2): 2048 +Integration time per FFT sample: 0.5 sec + +Estimated completion time: 62.5 sec + ++=================================================================+ +| [+] Starting measurement... | ++=================================================================+ + + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 400.0 +/- 1.2 MHz (iteration: 0)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +[INFO] [UHD] linux; GNU C++ version 10.2.1 20201207; Boost_107400; UHD_3.15.0.0-4+b1 +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 402.4 +/- 1.2 MHz (iteration: 1)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 404.79999999999995 +/- 1.2 MHz (iteration: 2)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 407.2 +/- 1.2 MHz (iteration: 3)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 409.59999999999997 +/- 1.2 MHz (iteration: 4)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 412.0 +/- 1.2 MHz (iteration: 5)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 414.4 +/- 1.2 MHz (iteration: 6)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 416.79999999999995 +/- 1.2 MHz (iteration: 7)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 419.2 +/- 1.2 MHz (iteration: 8)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 421.59999999999997 +/- 1.2 MHz (iteration: 9)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 424.0 +/- 1.2 MHz (iteration: 10)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 426.4 +/- 1.2 MHz (iteration: 11)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + +--------------------------------------------------------------------------- + [*] Currently monitoring f_center = 428.79999999999995 +/- 1.2 MHz (iteration: 12)... +--------------------------------------------------------------------------- + +gr-osmosdr 0.2.0.0 (0.2.0) gnuradio 3.8.2.0 +built-in source types: file fcd rtl rtl_tcp uhd hackrf bladerf rfspace airspy airspyhf soapy redpitaya freesrp +Using device #0 Realtek RTL2838UHIDIR SN: 00000001 +Detached kernel driver +Found Rafael Micro R820T tuner +[R82XX] PLL not locked! +[R82XX] PLL not locked! +Allocating 15 zero-copy buffers +Reattached kernel driver + ++=================================================================+ +| Measurement finished! | ++=================================================================+ + +Your data has been saved as rfi_plot.png. +``` +