Inversion Test Problems

Inversion Test Problems (ITP) is a collection of clearly defined forward codes that simulate a wide range of geophysical processes. The goal of ITP is to bring together people developing physical simulations with those who need them. ITP's simple and consistent code structure enables users to acces a wide range of different forward code and contributers to share their solutions with a wider audience. For more information, please visit our documentation (coming soon).

Installation

It is recommended to use a clean virtual environment for the install:

conda create -n ITP_env scipy jupyterlab numpy matplotlib
conda activate ITP_env

Inversion Test Problems is available on PyIP and can be installed using this command:

Linux/MacOS

python3 -m pip install --index-url https://test.pypi.org/simple/ inversiontestproblems-h-hollmann

Windows:

py -m pip install --index-url https://test.pypi.org/simple/ inversiontestproblems-h-hollmann

Basic usage

Once installed, each test problem can be imported using the following command:

from inversiontestproblems import testproblem

Replace testproblem with one of the following currently available problems:

• gravityforward:

Once a problem is imported, it's main functions can be called using the same structure for each problem. For more information for each function please use help():

from inversiontestproblems import testproblem

tp = testproblem()

model=tp.get_model()

data=tp.get_data()

synthetic_data = tp.forward(model)

jacobian=tp.gradient(model)

tp.plot_model()

Other problem-specific values can be accessed through the 'testproblem' object, such as:

tp.rec_coords # coordinates of recording locations

tp.x_nodes # x-coordinates of all nodes of the model

Which additional values are set is highly example-specific and we suggest to use 'help(tp)' or 'dir(tp)' to quickly see what is available, or consult the Inversion Test Suite Documentation (coming soon).