Setup, run, post process, and visualize numerical simulations. Primarily SW4
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs typos Jun 29, 2018
pySW4 BadZipFile on p3 vs BadZipfile on p2 Jul 31, 2018
tutorials Adding a tutorial and condo install instructions Sep 21, 2017
.gitignore gitignore Mar 29, 2018
LICENSE.txt Just starting up Mar 6, 2014 conda install instructions Sep 21, 2017

                     ______       ____ __
        ____  __  __/ ___/ |     / / // /
       / __ \/ / / /\__ \| | /| / / // /_
      / /_/ / /_/ /___/ /| |/ |/ /__  __/
     / .___/\__, //____/ |__/|__/  /_/
    /_/    /____/

pySW4: Python routines for interaction with SW4

pySW4 is an open-source project dedicated to provide a Python framework for working with numerical simulations of seismic-wave propagation with SW4 in all phases of the task. Preprocessing, post-processing and runtime visualization. It also provides several other tools for handling GeoTIFF files such as ASTER-GDEM tiles and others, plotting shaded-relief DEM maps and draping data over them, creating movies from image sequences, etc.

The functionality is provided through 5 sub-packages which include pre- and post-processing routines including the rfileIO library for interaction, reading and writing seismic models in the rfile format.

There are some useful utilities for geodesic projections of data and for reading and writing GeoTIFF files.

In the command line interface scripts, there are some quick and dirty plotting routines which can be run from the command line. It may be useful to run these scripts on the server-end while the computation is running in order to generate pseudo-RunTime visualization of the results.

See the full API documentation page and Tutorial examples.



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

$ conda config --add channels conda-forge

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

$ conda install pysw4

It is possible to list all of the versions of pySW4 available on your platform with:

$ conda search pysw4 --channel conda-forge


You can install the repository directly from GitHub. Use this command to install from master:

$ pip install

To get the latest release version do::

$ pip install

Add the --no-deps to forgo dependency upgrade ot downgrade.

Quick and dirty plotting from the command line

Plots and movies for a SW4 simulation run can be created using the pySW4-create-plots command line utility, e.g.:

$ pySW4-create-plots -c /tmp/ -s UH1 -s UH2 -s UH3 \\
    --pre-filt 0.05,0.1,100,200 --filter type=lowpass,freq=10,corners=4 \\
    ~/data/stations/stationxml/*UH* ~/data/waveforms/*20100622214704*

Wavefield PGV map Seismograms