FAQs

This section provides answers to frequently asked questions about gprMax and its uses.

What applications can gprMax simulate? gprMax is electromagnetic wave simulation software that is based on the Finite-Difference Time-Domain (FDTD) method. Many of its features have been designed to benefit simulating Ground Penetrating Radar (GPR), however it can be used to simulate many other applications in areas such as engineering, geophysics, archaeology, and medicine.

Why does gprMax not have a GUI? We considered developing a CAD-based graphical user interface (GUI) but, for now, decided against it. There were two guiding principals behind this design decision: firstly, users most often perform a series of related simulations with varying parameters to solve or optimize a particular problem; and secondly, we decided the limited resources we had were best concentrated on developing advanced modelling features for GPR within software that could easily be interfaced with other tools. Although a CAD-based GUI is useful for creating single simulations it becomes increasingly cumbersome for a series of simulations or where simulations contain heterogeneities, e.g. a model of a soil with stochastically varying electrical properties.

How is gprMax licensed? gprMax is released under the GNU General Public License v3 or higher. This means when distributing derived works, the source code of the work must be made available under the same license.

Where does the name gprMax come from? The name gprMax comes from the joining of the acroymn for Ground Penetrating Radar - gpr - and the name of the Scottish scientist who formulated the classical theory of electromagnetic radiation, James Clerk Maxwell - Max.

Do I need to learn Python to use gprMax? No, but it can be beneficial to know a little Python. We have made it easier to create more complex simulations in gprMax through scripting in the input file. This is achieved by allowing blocks of Python code to be written in the input file which are executed when the file is read by gprMax.

Can I still do all my pre/post-processing for gprMax in MATLAB? Yes, MATLAB has built-in functions to read HDF5 files.

Can I convert my output file to a text file, e.g. to import into Microsoft Excel Yes, we recommend you download HDFView which is free viewer for HDF files. You can then export any of datasets in the output file to a text (ASCII) file that can be imported into Microsoft Excel. To do so right-click on the dataset in HDFView and choose Export Dataset -> Export Data to Text File.

But converting my input file from the old version of gprMax will be really painful Hopefully not! We have provided a Python module to help you convert input files from the old version of gprMax to use syntax introduced in version 3.

How do I choose a spatial resolution for my simulation? Spatial resolution should be chosen to mitigate numerical dispersion and to adequately resolve geometry in your simulation. A 2D example of modelling a metal cylinder in a dielectric provides guidance on how to determine spatial resolution.

I specified a certain piece of geometry but I don’t see it when I view my geometry file. gprMax builds objects in a model in the order the objects were specified in the input file, using a layered canvas approach. This means, for example, a cylinder object which comes after a box object in the input file will overwrite the properties of the box object at any locations where they overlap. This approach allows complex geometries to be created using basic object building blocks.

Can I run gprMax on my HPC/cluster? Yes. gprMax has been parallelised using OpenMP and features a task farm based on MPI. For more information read the parallel performance section of the User Guide