For most users, installing from PyPI is the preferred way:
pip install tmatrix
For developers, the project can be compiled with cmake:
cd tmatrix
mkdir build && cd build
cmake ..
make
All objects are placed in the build subdirectory. If cmake detects a
MATLAB installation, the tmatrix_porosity_mex.X wrapper is also
built. The interface exposed to MATLAB is analogeous to the original
<T_matrix_porosity.m> function.
To use this mex-file in MATLAB simply add the dynamic library to the matlab path and call it like you would the original script:
addpath path/to/build/
tmatrix_porosity_mex(mineral_property, ... )
Note that enabling parallel processing incurs some overhead, and should only be enabled for large jobs (e.g. 10.000+ sequential calls).
Under Windows use, find your desired Windows CMake generator, ie:
cd tmatrix
mkdir build
cd build
cmake .. -G "Visual Studio 14 2015 Win64"
cmake --build . --target ALL_BUILD --config Release
The theory can be found in the papers and in the references therein:
-
Agersborg, R., Jakobsen, M., Ruud, B.O. and Johansen, T. A. 2007. Effects of pore fluid pressure on the seismic response of a fractured carbonate reservoir. Stud. Geophys. Geod., 51, 89-118. Link
-
Agersborg, R., Johansen, T. A. and Ruud, B.O. 2008. Modelling reflection signatures of pore fluids and dual porosity in carbonate reservoirs. Journal of Seismic Exploration, 17(1), 63-83.
-
Agersborg, R., Johansen, T. A., Jakobsen, M., Sothcott, J. and Best, A. 2008. Effect of fluids and dual-pores systems on pressure-dependent velocities and attenuation in carbonates, Geophysics, 73, No. 5, N35-N47. Link
-
Agersborg, R., Johansen, T. A., and Jakobsen, M. 2009. Velocity variations in carbonate rocks due to dual porosity and wave-induced fluid flow. Geophysical Prospecting, 57, 81-98. Link
All of the papers and a extended explanations of the involved equations can be found in Agersborg (2007), phd thesis: Link