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.