Installation¶
Although Virgo has been tested successfully on both Windows and Mac OS, the required dependencies are most easily installed on Linux distributions (recommended OS).
Dependencies¶
Note
The following two dependencies are only required for acquiring data with the necessary hardware (software-defined radio). They are not required for planning observations, analyzing data, running calculations or any other functionalities provided by the package.
GNU Radio: An open radio framework for digital signal processing
gr-osmosdr: Fundamental I/O GNU Radio blocks supporting most SDRs
For Debian/Ubuntu and derivates, the installation is straightforward:
sudo apt install gnuradio gr-osmosdr
If you wish to verify the installation has succeeded, run:
gnuradio-companion
Once the graphical interface opens up, check the right-hand side (Library panel)
for a block named osmocom Source
. If this block shows up, GNU Radio and gr-osmosdr
have been installed on your system successfully.
Installing Virgo¶
Virgo runs on Python 2.7/3.x. To install the package, you can get it directly
from PyPI using pip
:
pip install astro-virgo
Alternatively, you may clone the repository and install the package in an offline manner:
git clone https://github.com/0xCoto/Virgo.git
cd Virgo
pip install .
By obtaining Virgo
, the following packages are installed automatically:
You can finally verify the installation by running:
python -c "import virgo"
No output indicates a successful installation.
Troubleshooting¶
In certain systems, this command may give an error like this:
Traceback (most recent call last):
File "<string>", line 1, in <module>
ImportError: No module named virgo
This is a common error when installing Python packages, and it is often
due to a mismatch between the Python versions the pip
and python
commands
refer to.
You can diagnose this with pip -V
and python -V
, or you can simply run:
python -m pip install astro-virgo
This should load the exact pip
version associated with python
.