published: Feb. 14, 2019, 8:22 a.m.

readgssi - python visualization software for ground-penetrating radar

I discuss an open-source software tool I wrote for use as an reader and preprocessing module for data from a specific brand of ground-penetrating radar (GPR) devices.

readgssi is a tool intended for use as an open-source reader and preprocessing module for subsurface data collected with Geophysical Survey Systems Incorporated (GSSI) ground-penetrating radar (GPR) devices. It has the capability to read .DZT and .DZG files, and filter, plot, and export the data contained in those files.

Moreover, readgssi is accessible from both the command line and as a python function, and can therefore be used in multiple scenarios, including bulk, iterative processing of folders full of DZT and DZG files. readgssi is blazing fast and can be used in field scenarios to check data quality in large DZT files in seconds, where RADAN (GSSI's closed-source software) would take minutes.

In addition to plotting, readgssi can also be used to translate files to CSV (for MATLAB uptake, for example), numpy binary format (for GPRPy), and soon should be able to export HDF5 format similar to Blue Systems IceRadar (which can be read by irlib).

Source code for readgssi is distributed under the copyleft GNU Afferro 3.0 license, has a DOI number for citation and is available on the Python Package Index (PyPI).

I strongly recommend installing the software requirements for this package using Anaconda because some versions of pip and numpy don't play nicely together. You can use Anaconda to install readgssi in a Python environment using the following Terminal (UNIX) or Anaconda Prompt (Windows) commands:

# add the conda-forge channel
conda config --add channels conda-forge

# create new environment and install dependencies
conda create -n readgssi python==3.7 pandas h5py pytz obspy

# activate the environment
conda activate readgssi

# install readgssi
pip install readgssi

If you don't plan on using Anaconda and don't mind a challenge, you can install via pip only (this is a more advanced method and is more likely to fail trying to do things related to installing Numpy):

pip install -U readgssi

See the readgssi GitHub for more details.

Happy GPRing!