If you use this software in a scientific publication, we'd very much appreciate if you could cite the following papers:

• Hassan, R., Hejrani, B., Medlin, A., Gorbatov, A. and Zhang, F., 2020. High-performance seismological tools (HiPerSeis). In: Czarnota, K., Roach, I., Abbott, S., Haynes, M., Kositcin, N., Ray, A. and Slatter, E. (eds.) Exploring for the Future: Extended Abstracts, Geoscience Australia, Canberra, 1–4. https://ecat.ga.gov.au/geonetwork/srv/eng/catalog.search#/metadata/135095

• Home Page: https://github.com/GeoscienceAustralia/hiperseis
• Documentation: http://hiperseis.readthedocs.io/en/develop/
• Wiki Pages: https://github.com/GeoscienceAustralia/hiperseis/wiki

• Fei Zhang: fei.zhang@ga.gov.au
• Bren Moushall: Brenainn.Moushall@ga.gov.au
• Alexei Gorbatov: alexei.gorbatov@ga.gov.au
• Babak Hejrani: babak.hejrani@ga.gov.au

• Linux OS, including Ubuntu and CentOS
• Python 3.6 or higher (recommended)
• Python 2.7 (deprecated, no longer supported)

Certain modules require specific third party (non-Python) libraries to be installed on the host system. For example, scripts that convert to sc3ml format also require Seiscomp3 to be installed and to be visible in the PATH. In most cases, Python libraries that depend on third party libraries will indicate their dependencies either during attempted installation, or when used at runtime. Note that the following list includes indirect dependencies, i.e. dependencies that come from Python libraries used by HiPerSeis.

Current third party dependencies (actual requirements may vary by platform or Python distribution):

• HDF5
• MPI, for example Open MPI
• PROJ
• GEOS

1. First, obtain the source code from Github repository

• git clone https://github.com/GeoscienceAustralia/hiperseis.git
• cd hiperseis
• git submodule init
• git submodule update

2. Install Python environment and dependency packages. See Wiki Pages
3. To use HiPerSeis in the checked out location, you will need to add the root HiPerSeis folder to your PYTHONPATH variable. For example, if you checked out HiPerSeis to the folder dev/hiperseis relative to your home directory, then in a bash shell you need to execute the following shell command: export PYTHONPATH=$HOME/dev/hiperseis. This needs to be done for each command shell session.

HiPerSeis is licensed under the GPL version 3