RGPR: a free and open-source software package for ground-penetrating radar (GPR) data processing

am developing this package on my free time as a gift to the GPR community. Any support will be appreciated!

Buy me a coffee with Paypal

About

RGPR is a free and open-source software package to read, export, analyse, process and visualise ground-penetrating radar (GPR) data.

RGPR is written in R, a high-level programming language for statistical computing and graphics that is freely available under the GNU General Public License and runs on Linux, Windows and MacOS. R is a highly versatile and extensible language to which C, C++ and Fortran code can be linked and run. Furthermore, the R developer community is very active and more than 10'000 packages are hosted on the official global package repository CRAN (Comprehensive R Archive Network, https://cran.r-project.org). In 2017, R was ranked as the sixth top programming language by the Institute of Electrical and Electronics Engineers.

RGPR is hosted on GitHub at https://github.com/emanuelhuber/RGPR.

This R package is still in development, and therefore some of the functions may change in a near future.

To report bugs, contribute to the development of RGPR, see how to contribute.

If you have any questions, comments or suggestions, feel free to contact me (in english, french or german):
emanuel.huber@pm.me

Tutorials

1. Import GPR data
2. Plot GPR data
3. Basic GPR data processing
4. Pipe processing
5. Add coordinates to GPR data
6. Time/depth slice interpolation
7. GPR data migration
8. Hyperbola fitting
9. Deconvolution
10. Some explanations on the classes of RGPR
11. Free GPR data to download
12. RGPR in the web

How to install/load

1. Download R from the R Cran website and install it.
2. Optionally install a R-editor:
   • Rstudio (Recommended)
   • RKward
   • Notepad++ combined with NppToR
3. Open the R-editor (e.g., Rstudio)

4. Install RGPR

    if(!require("devtools")) install.packages("devtools")
    devtools::install_github("emanuelhuber/RGPR")
   

   Alternatively, you can download the package as a zip file and install it in R following these instructions:

   https://riptutorial.com/r/example/5556/install-package-from-local-source

   or these:

   https://stackoverflow.com/questions/30989027/how-to-install-a-package-from-a-download-zip-file/30989367#30989367

New to R? Try this free interactive course from DataCamp: Introduction to R

Notes

Supported file formats (read only):

• Sensors & Software file format (*.dt1, *.hd, *.gps).
• MALA file format (*.rd3, *.rd7, *.rad, *.cor).
• ImpulseRadar file format (*.iprb, *.iprh, *.cor, *.time, *.mrk).
• GSSI file format (*.dzt, *.dzx).
• Geomatrix Earth Science Ltd file format (Utsi Electronics format) for the GroundVue 3, 7, 100, 250 and 400 as well as for the TriVue devices (*.dat, *.hdr, *.gpt, *.gps).
• Radar Systems, Inc. Zond file format (*.sgy). WARNING: it is not a version of the SEG-Y file format.
• IDS file format (*.dt, *.gec).
• Transient Technologies file format (*.sgpr).
• US Radar file format (*.RA1, *.RA2 or *.RAD)
• SEG-Y file format developed by the Society of Exploration Geophysicists (SEG) for storing geophysical data (*.sgy), also used by Easy Radar USA
• SEG-2 Pullan, S.E., 1990, Recommended standard for seismic (/radar) files in the personal computer environment: Geophysics, 55, no. 9, 1260–1271(*.sg2). Also used by US Radar with extensions *.RA1, *.RA2, *. RAD.
• GPRmax: hdf5 file format with extension *.out (not well tested)
• 3dradar: the manufacturer does not want to reveal the binary file format *.3dra. Workaround: export the GPR data in binary VOL format (*.vol) with the examiner software -> still experimental
• R internal format (*.rds).
• serialized Python object (*.pkl).
• ENVI band sequential file format (*.dat, *.hdr).
• ASCII (*.txt): - either 3-column format (x, t, amplitude)
  • or matrix-format (without header/rownames)
• Terra Zond binary file format (*.trz) -> we are working on it

See tutorial Import GPR data.

Do you miss your preferred file format? Send me the file format description with a test file and I will adapt the RGPR-package to support this file format.

Supported export file formats

• Sensors & Software file format (*.dt1, *.hd).
• R internal format (*.rds).
• ASCII (*.txt):
• SEG-Y file format (*.sgy)

Coming soon

We are developing a new version of RGPR that will handle three-dimensional GPR data as well as multi-dimensional transformations, see our objectives.

Note that you can already interpolate GPR data (2D) into a 3D cube with the current RGPR version! Do not hesitate to contact me if you need more informations…