Installation#

Dependencies#

The current version has been integration tested using Python 3.

Following Python modules are required for the Seispy, but do not have to be installed manually. Once the Seispy has been installed, dependencies are automatically installed to your environment.

Install and update via Anaconda#

We recommend to install the Anaconda as the Python environment.

Installing seispy from the conda-forge channel can be achieved by adding conda-forge to your channels with:

conda config --add channels conda-forge
conda config --set channel_priority strict

Note

For Chinese users, we recommend to change the source of the conda-forge to 清华大学 Anaconda 镜像

Once the conda-forge channel has been enabled, seispy can be installed with:

conda create -n seispy seispy
conda activate seispy

Seispy can be updated with:

conda update seispy

Install and update via PyPi#

Recommended for normal users to install Seispy with a stable version

pip install python-seispy

Note

  • We recommend Chinese users to use 清华大学 pypi 镜像 to install Seispy.

  • An error may be raised during installing Obspy via PyPi on Linux platform as following:

    ERROR: Could not build wheels for obspy which use PEP 517 and cannot be installed directly
    

    Please install Obspy via conda first.

    conda config --add channels conda-forge
    conda install obspy
    

Upgrading Seispy to the next stable version.

pip install python-seispy -U

Install and update from source codes#

Download source codes#

Clone the source code from Github to any directory.

git clone https://github.com/xumi1993/seispy.git

To access developing version, users can clone the source codes with

git clone --branch=dev https://github.com/xumi1993/seispy.git

For Chinese users, try to clone the source code from Gitlab repository

git clone https://gitlab.com/xumi1993/seispy.git

or

git clone --branch=dev https://gitlab.com/xumi1993/seispy.git

Install Seispy to the Python environment#

Change path to where the source code was cloned into, and install the module via Python pip command

cd path/to/seispy
pip install .

Update Seispy#

To update the Seispy, please change to directory of the source code, and execute following commands.

cd path/to/seispy
git pull
pip install .

FAQ#

  • When old users update seispy to v1.3.0, An error probably raised because of incompatible Qt library
    qt.core.plugin.loader: In /Users/zhangxiaoqing/miniconda3/plugins/platforms/libqwebgl.dylib:
    Plugin uses incompatible Qt library (5.15.0) [release]
    qt.core.plugin.loader: In /Users/zhangxiaoqing/miniconda3/plugins/platforms/libqoffscreen.dylib:
    Plugin uses incompatible Qt library (5.15.0) [release]
    qt.core.plugin.loader: In /Users/zhangxiaoqing/miniconda3/plugins/platforms/libqminimal.dylib:
    Plugin uses incompatible Qt library (5.15.0) [release]
    qt.core.plugin.loader: In /Users/zhangxiaoqing/miniconda3/plugins/platforms/libqcocoa.dylib:
    Plugin uses incompatible Qt library (5.15.0) [release]
    qt.qpa.plugin: Could not find the Qt platform plugin "cocoa" in ""
    This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.
    

    Please uninstall PyQt5 with pip or conda

    pip uninstall pyqt5
    

    or

    conda remove pyqt