View source for GNURadio@theATA

The Allen Telescope Array (ATA) is a 42-element radio telescope array located in Hat Creek, California, operated by SETI Institute. In an effort to increase accessibility to the array among potential users outside the astronomy community, we are working to integrate the array into GNU Radio software. We plan to start out by connecting USRPs to two ATA antennas and developing control, backend, and beamformer software. In addition to this, we are using a discone antenna connected to a USRP and OmniSig software to analyze radio frequency interference (RFI) at the ATA site. 


__TOC__

== General Info ==

Useful info about the ATA and friends: 

* [https://www.seti.org/ata The Allen Telescope Array, SETI Institute]  

* [https://ieeexplore.ieee.org/abstract/document/5164980?casa_token=tsHSJVpyCNAAAAAA:Q7JzzwZC9sj2WvKcrkZrKcE531EZ4JbNQKsOtt6yu6AGFpw_vhJ3Am8quAEVzkvh3ynBEnxLxIg Welch et al, 2009, The Allen Telescope Array]  

* [https://www.seti.org SETI Institute]  

* [https://seti.berkeley.edu/listen/ Berkeley SETI / Breakthrough Listen]  

* [http://seti.berkeley.edu:8000/open-data/ Berkeley SETI blog on Open Data]  

* [https://arxiv.org/abs/1906.07391 Lebofsky et al, 2019 - Breakthrough Listen public data]


== GNU Radio / SETI Hackathon ==  

In May 2019, the first step toward collaboration between the GNU Radio community, the ATA, SETI Institute, Breakthrough Listen, and Berkeley SETI communities consisted of a hackathon hosted at the Hat Creek Radio Observatory (home of the ATA). This culminated in, among other things, the beginnings of a GNU Radio module called gr-ata.  
  
* Here's a link to material from the hackathon: https://github.com/SETIatHCRO/grhack/wiki  

* And here's where you can find the ATA module: https://github.com/SETIatHCRO/gr-ata


== Connecting to VNC on ATA gnuradio machines ==

Below are instructions for connecting to the ATA machines' VNC servers on Windows (note that gnuradio0 machine is connected to the discone, gnuradio1 will be connected to the ATA antennas).  

Assuming you are connected to the ATA gnuradio vpn server, you can use PUTTY to connect to gnuradio1 or gnuradio0 machine:

* Hostname (IP address): 10.1.50.10 for gnuradio0, or 10.1.50.11 for gnuradio1. 
* SSH -> Enable compression
* SSH -> Tunnels -> Source port: 590x, Destination: localhost:590x

VNC Viewer:

* Remote Host: localhost:590x
* Enter password


== Setting up the software ==

The first step in implementing GNU Radio with the ATA is ensuring that we can effectively play back previously-recorded [http://setiquest.info/sigmf/ SigMF files] taken by the ATA in a GNU Radio flowgraph. We can do this using example code from the [https://github.com/SETIatHCRO/gr-ata gr-ata] module discussed above. To get the flowgraphs included in the "examples" folder of gr-ata working, here's a recipe of what you'll need (along with some installation tips discovered through trial-and-error). Note that the instructions below are written for Ubuntu users:

* GNU Radio version 3.8 (ppa for "releases" -- install instructions [[InstallingGR#From_Binaries|here]]).
* Install liborc-0.4-dev (sudo apt install liborc-0.4-dev)
* cmake version >= 3.13 (will have to remove the standard cmake version using $ sudo apt remove --autoremove cmake, then follow the instructions here: https://apt.kitware.com/ to install a more recent version. This is necessary for installing gr-osmosdr)  


Below is a list of external GNU Radio modules that you should install following the instructions on the linked GitHub pages. One thing to keep in mind -- for the cmake step, in some cases cmake automatically installs the modules to the wrong location, resulting in a ModuleNotFound error. To prevent this, instead of running just '''cmake ..''' run the following command: '''$ cmake -DCMAKE_INSTALL_PREFIX:PATH={prefix} ..''' where the {prefix} can be found using the command '''$ gnuradio-config-info --prefix'''. 

* [https://github.com/SETIatHCRO/gr-ata gr-ata] (of course!)
* [https://github.com/osmocom/gr-osmosdr gr-osmosdr]
* [https://github.com/ghostop14/gr-correctiq gr-correctiq] -- make sure to clone the branch maint-3.8
* [https://github.com/ghostop14/gr-lfast gr-lfast] -- make sure to clone the branch maint-3.8
* [https://github.com/ghostop14/gr-grnet gr-grnet] -- branch maint-3.8. Before attempting to install gr-grnet, make sure you've run $ sudo apt-get install zlib1g-dev libpcap-dev 
* [https://github.com/ghostop14/gr-filerepeater gr-filerepeater] -- branch maint-3.8
* [https://github.com/ghostop14/gr-gpredict-doppler gr-gpredict-doppler]
* [https://github.com/ghostop14/gr-mesa gr-mesa] -- branch maint-3.8
* [https://github.com/osmocom/gr-fosphor gr-fosphor] -- before attempting to install gr-fosphor, run the command: $ sudo apt install libglu1-mesa-dev freeglut3-dev mesa-common-dev ocl-icd-opencl-dev freetype2-demos libfreetype6 libfreetype6-dev swig qt5-default
* [https://github.com/ghostop14/gr-compress gr-compress] --branch maint-3.8; follow instructions in README on github for installation prerequisites

All of these modules (excepting gr-fosphor, which requires a GPU) have been installed along with GNU Radio version 3.8 on the gnuradio1 machine at the ATA. 

For ATA observing, you will need to install code from the ATA-Utils repository (which I have done on gnuradio1 in my account); run the commands:  

* '''git clone https://github.com/SETIatHCRO/ATA-Utils'''
* '''cd ATA-Utils/pythonLibs'''
* If pip isn't installed, run '''sudo apt-get install python3-pip'''
* Still in the pythonLibs folder, run '''sudo pip3 install . --user'''
* '''sudo python3 setup.py install'''

You should be good to go! 


== Plotting data in GNU Radio ==

Using a very simple GNU Radio flowgraph, we can plot spectrum data from archival ATA data; below are some examples:  

[[File:-home-ellie-Pictures-w3oh-maser.png|800px]]  

Figure 1: GNU Radio waterfall and frequency plots of a 6.7 GHz methanol maser, W3OH, from 2010 archival ATA data  

[[File:Hi-line.png|800px]]  

Figure 2: GNU Radio waterfall and frequency plots of the neutral hydrogen (HI) line in the direction of the pulsar psrb0329+54, also from 2010 ATA data.


== Controlling the ATA == 

The gr-ata module consists of four blocks:

* Control Block
* Track Scan Block
* On-Off Block
* IF Switch Block

which can be combined to conduct observations with the ATA. Refer to this [[GR-ATA Tutorial|tutorial]] for detailed tips on how to use the gr-ata blocks and conduct an ATA observation.