Troubleshooting¶
Instaseis installation¶
MTUQ uses Instaseis for generating synthetic seismograms.
If MTUQ installation fails with an Instaseis error, then we suggest the following workaround:
Comment out instaseis in the env.yaml file.
Re-try the installation:
conda activate mtuq
conda env update --file env.yaml
Install gfortran, if not already present.
Try Instaseis installation as follows:
CC=gfortran pip install git+https://github.com/rmodrak/instaseis.git
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.
Speeding up conda installs¶
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.
MTUQ installation on Apple M1 and Apple M2 Macs¶
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: