PyLoT, release version 0.3

PyLoT

version: 0.3

The Python picking and Localisation Tool

This python library contains a graphical user interfaces for picking seismic phases. This software needs ObsPy
and the PySide2 Qt5 bindings for python to be installed first.

PILOT has originally been developed in Mathworks' MatLab. In order to distribute PILOT without facing portability
problems, it has been decided to redevelop the software package in Python. The great work of the ObsPy group allows easy
handling of a bunch of seismic data and PyLoT will benefit a lot compared to the former MatLab version.

The development of PyLoT is part of the joint research project MAGS2, AlpArray and AdriaArray.

Installation

At the moment there is no automatic installation procedure available for PyLoT. Best way to install is to clone the
repository and add the path to your Python path.

It is highly recommended to use Anaconda for a simple creation of a Python installation using either the pylot.yml or the requirements.txt file found in the PyLoT root directory. First make sure that the conda-forge channel is available in your Anaconda installation:

conda config --add channels conda-forge

Afterwards run (from the PyLoT main directory where the files requirements.txt and pylot.yml are located)

conda env create -f pylot.yml

or

conda create -c conda-forge --name pylot_311 python=3.11 --file requirements.txt

to create a new Anaconda environment called pylot_311.

Afterwards activate the environment by typing

conda activate pylot_311

Prerequisites:

In order to run PyLoT you need to install:

• Python 3
• cartopy
• joblib
• obspy
• pyaml
• pyqtgraph
• pyside2

(the following are already dependencies of the above packages):

• scipy
• numpy
• matplotlib

Some handwork:

Some extra information on error estimates (just needed for reading old PILOT data) and the Richter magnitude scaling
relation

cp path-to-pylot/inputs/PILOT_TimeErrors.in path-to-pylot/inputs/richter_scaling.data ~/.pylot/

You may need to do some modifications to these files. Especially folder names should be reviewed.

PyLoT has been tested on Mac OSX (10.11), Debian Linux 8 and on Windows 10/11.

Release notes

Features:

• event organisation in project files and waveform visualisation
• consistent manual phase picking through predefined SNR dependant zoom level
• consistent automatic phase picking routines using Higher Order Statistics, AIC and Autoregression
• pick correlation correction for teleseismic waveforms
• interactive tuning of auto-pick parameters
• uniform uncertainty estimation from waveform's properties for automatic and manual picks
• pdf representation and comparison of picks taking the uncertainty intrinsically into account
• Richter and moment magnitude estimation
• location determination with external installation of NonLinLoc

Known issues:

Current release is still in development progress and has several issues. We are currently lacking manpower, but hope to assess many of the issues in the near future.

Staff

Original author(s): M. Rische, S. Wehling-Benatelli, L. Kueperkoch, M. Bischoff (PILOT)

Developer(s): S. Wehling-Benatelli, M. Paffrath, L. Kueperkoch, K. Olbert, M. Bischoff, C. Wollin, M. Rische, D. Arnold, K. Cökerim, S. Zimmermann

Others: A. Bruestle, T. Meier, W. Friederich

September 2024

PyLoT, release version 0.2

PyLoT

version: 0.2

The Python picking and Localisation Tool

This python library contains a graphical user interfaces for picking
seismic phases. This software needs ObsPy
and the PySide Qt4 bindings for python to be installed first.

PILOT has originally been developed in Mathworks' MatLab. In order to
distribute PILOT without facing portability problems, it has been decided
to redevelop the software package in Python. The great work of the ObsPy
group allows easy handling of a bunch of seismic data and PyLoT will
benefit a lot compared to the former MatLab version.

The development of PyLoT is part of the joint research project MAGS2 and AlpArray.

Installation

At the moment there is no automatic installation procedure available for PyLoT.
Best way to install is to clone the repository and add the path to your Python path.

Prerequisites:

In order to run PyLoT you need to install:

• python 2 or 3
• scipy
• numpy
• matplotlib
• obspy
• pyside

Some handwork:

PyLoT needs a properties folder on your system to work. It should be situated in your home directory
(on Windows usually C:/Users/username):

mkdir ~/.pylot

In the next step you have to copy some files to this directory:

for local distance seismicity

cp path-to-pylot/inputs/pylot_local.in ~/.pylot/pylot.in

for regional distance seismicity

cp path-to-pylot/inputs/pylot_regional.in ~/.pylot/pylot.in

for global distance seismicity

cp path-to-pylot/inputs/pylot_global.in ~/.pylot/pylot.in

and some extra information on error estimates (just needed for reading old PILOT data) and the Richter magnitude scaling relation

cp path-to-pylot/inputs/PILOT_TimeErrors.in path-to-pylot/inputs/richter_scaling.data ~/.pylot/

You may need to do some modifications to these files. Especially folder names should be reviewed.

PyLoT has been tested on Mac OSX (10.11), Debian Linux 8 and on Windows 10.

Release notes

Features:

• centralize all functionalities of PyLoT and control them from within the main GUI
• handling multiple events inside GUI with project files (save and load work progress)
• GUI based adjustments of pick parameters and I/O
• interactive tuning of parameters from within the GUI
• call automatic picking algorithm from within the GUI
• comparison of automatic with manual picks for multiple events using clear differentiation of manual picks into 'tune' and 'test-set' (beta)
• manual picking of different (user defined) phase types
• phase onset estimation with ObsPy TauPy
• interactive zoom/scale functionalities in all plots (mousewheel, pan, pan-zoom)
• array map to visualize stations and control onsets (beta feature, switch to manual picks not implemented)

Platform support:

• Python 3 support
• Windows support

Performance:

• multiprocessing for automatic picking and restitution of multiple stations
• use pyqtgraph library for better performance on main waveform plot

Visualization:

• pick uncertainty (quality classes) visualization with gradients
• pick color unification for all plots
• new icons and stylesheets

Known Issues:

• some Qt related errors might occur at runtime
• filter toggle not working in pickDlg
• PyLoT data structure requires at least three parent directories for waveform data directory

Staff

Original author(s): L. Kueperkoch, S. Wehling-Benatelli, M. Bischoff (PILOT)

Developer(s): S. Wehling-Benatelli, L. Kueperkoch, M. Paffrath, K. Olbert,
M. Bischoff, C. Wollin, M. Rische

Others: A. Bruestle, T. Meier, W. Friederich

September 2017

PyLoT, release version 0.1a

PyLoT

version: 0.1a

The Python picking and Localisation Tool

This python library contains a graphical user interfaces for picking
seismic phases. This software needs ObsPy
and the PySide Qt4 bindings for python to be installed first.

PILOT has originally been developed in Mathworks' MatLab. In order to
distribute PILOT without facing portability problems, it has been decided
to redevelop the software package in Python. The great work of the ObsPy
group allows easy handling of a bunch of seismic data and PyLoT will
benefit a lot compared to the former MatLab version.

The development of PyLoT is part of the joint research project MAGS2.

Installation

At the moment there is no automatic installation procedure available for PyLoT.
Best way to install is to clone the repository and add the path to your Python path.

Prerequisites:

In order to run PyLoT you need to install:

• python
• scipy
• numpy
• matplotlib
• obspy
• pyside

Some handwork:

PyLoT needs a properties folder on your system to work. It should be situated in your home directory:

mkdir ~/.pylot

In the next step you have to copy some files to this directory:

cp path-to-pylot/inputs/pylot.in ~/.pylot/

for local distance seismicity

cp path-to-pylot/inputs/autoPyLoT_local.in ~/.pylot/autoPyLoT.in

for regional distance seismicity

cp path-to-pylot/inputs/autoPyLoT_regional.in ~/.pylot/autoPyLoT.in

and some extra information on filtering, error estimates (just needed for reading old PILOT data) and the Richter magnitude scaling relation

cp path-to-pylot/inputs/filter.in path-to-pylot/inputs/PILOT_TimeErrors.in path-to-pylot/inputs/richter_scaling.data ~/.pylot/

You may need to do some modifications to these files. Especially folder names should be reviewed.

PyLoT has been tested on Mac OSX (10.11) and Debian Linux 8.

Release notes

Features:

• consistent manual phase picking through predefined SNR dependant zoom level
• uniform uncertainty estimation from waveform's properties for automatic and manual picks
• pdf representation and comparison of picks taking the uncertainty intrinsically into account
• Richter and moment magnitude estimation
• location determination with external installation of NonLinLoc

Known issues:

• Magnitude estimation from manual PyLoT takes some time (instrument correction)

We hope to solve these with the next release.

Staff

Original author(s): L. Kueperkoch, S. Wehling-Benatelli, M. Bischoff (PILOT)

Developer(s): S. Wehling-Benatelli, L. Kueperkoch, K. Olbert, M. Bischoff,
C. Wollin, M. Rische, M. Paffrath

Others: A. Bruestle, T. Meier, W. Friederich

October 2016