Skip to content
Ground Penetrating Radar processing and visualization software for python
Branch: master
Clone or download


Open-source Ground Penetrating Radar processing and visualization software. Supported by the National Science Foundation under grant EAR-1550732.

Profile GUI


Simplemost installation

In the following instructions, if you use Windows, use the comands python and pip. If you use Mac or Linux, use the commands python3 and pip3 instead.

  1. Download the GPRPy software from
    Save the file somewhere on your computer and extract the zip folder.
    As an alternative, you can install git from, then run in a command prompt:
    git clone
    The advantage of the latter is that you can easily update your software by running from the GPRPy folder in a command prompt:
    git pull origin master

  2. Install Python 3.7 for example from

  3. Once the installation finished, open a command prompt that can run Python
    On Windows: click on Start, then enter "Anaconda Prompt", without the quotation marks into the "Search programs and files" field. On Mac or Linux, open the regular terminal.

  4. In the command prompt, change to the directory where you downloaded the GPRPy files. This is usually through a command like for example
    cd Desktop\GPRPy
    if you downloaded GPRPy directly onto your desktop. Then type the following and press enter afterward:
    Then type the following and press enter afterward:
    pip install .
    don't forget the period "." at the end of the pip install command

Running the software

After installation, you can run the script from the Anaconda Prompt (or your Python-enabled prompt) by running either
python -m gprpy

The first time you run GPRPy it could take a while to initialize. GPRPy will ask you if you want to run the profile [p] or WARR / CMP [c] user interface. Type
and then enter for profile, or
and then enter for CMP / WARR.

You can also directly select one by running either
gprpy p
gprpy c
python -m gprpy p
python -m gprpy c

Running automatically generated scripts

To run automatically generated scripts, open the command prompt that can run python (for example Anaconda Prompt), switch to the folder with the automatically generated script and run
where is the name of your automatically generated script.

In case of trouble

If you have several versions of python installed, for example on a Mac or Linux system, replace, in the commands shown earlier, python with python3
pip with pip3

If you have any troubles getting the software running, please send me an email or open an issue on GitHub and I will help you getting it running.

Uninstalling GPRPy

To uninstall GPRPy, simply run, in the (Anaconda) command prompt
pip uninstall gprpy


Follow @GPRPySoftware on twitter to hear about news and updates. Recent tweets:

Fixed small issue that led to multiples when picking points in profile. Thanks Marcus Pacheco for pointing it out! If you use picking in profile mode, please update to version 1.0.3 (uninstall the old version before).

— GPRPy (@GPRPySoftware) June 13, 2019

I will post updates, changes, and GPRPy news here.

— GPRPy (@GPRPySoftware) January 26, 2019

GPRPy is a free ground penetrating radar processing and visualization software developed at the University of Alabama. You can download it and install it following the instructions here:

— GPRPy (@GPRPySoftware) January 25, 2019
You can’t perform that action at this time.