Troubleshooting¶

PyGMT installation¶

MTUQ uses full moment tensor plotting functions from the PyGMT graphics library.

To avoid a known issue with PyGMT installation under conda, it is necessary to specify a minimum PyGMT version as follows:

conda install 'pygmt>=0.9'

A more conservative approach, which avoids possible issues with PyGMT 0.10 releases, is to specify the more stable PyGMT 0.9 version:

conda install 'pygmt=0.9'

If PyGMT installation fails, most MTUQ functions will still work, but some plotting functions will fall back to GMT or ObsPy.

We note that some versions of GMT and ObsPy do not plot full moment tensors correctly.

Older versions of the conda package manager can be very slow. For a potential speed up, conda can be updated as follows:

conda update -n base conda

For reference, the largest potential speed up comes from the new mamba dependency solver, which was adopted in the 23.10 release.

Installation on Apple M1 and Apple M2 Macs is now possible using the default installation procedure.

For older versions of MTUQ, a modified installation procedure may still be necessary. For more information, please see: