Signal processing for field and experimental data for earthquake engineering
A Python package for seismic signal processing.
This package provides common functions for computing ground motion parameters and performing signal processing. The functions are implemented on either numpy arrays or on a signal object that uses caching to avoid expensive recalculation of widely used parameters.
- Compute the acceleration response spectrum and elastic response time series using the fast Nigam and Jennings (1968) algorithm.
- Compute the Fourier amplitude spectrum (using the scipy.signal.fft algorithm)
- Compute the smooth Fourier amplitude spectrum according to Konno and Ohmachi (1998)
- Compute velocity and displacement from acceleration time series
- Compute peak ground motion quantities (PGA, PGV, PGD)
- Compute common ground motion intensity measures (Arias intensity, CAV, CAV_dp5, significant duration, bracketed duration, dominant period)
- Compute signal features (zero crossings, global peaks, local peaks)
- Compute rotated ground motion or intensity measure from two ground motion components
- Resampling of ground motion through interpolation or periodic resampling
- Butterworth filter (using scipy), running average, polynomial fitting
- Fast loading of, and saving of, plain text to and from Signal objects
How to Use
Generate response spectra
import numpy as np import matplotlib.pyplot as plt import eqsig.single bf, sub_fig = plt.subplots() a = np.loadtxt("<path-to-acceleration-time-series>") dt = 0.005 # time step of acceleration time series periods = np.linspace(0.2, 5, 100) # compute the response for 100 periods between T=0.2s and 5.0s record = eqsig.AccSignal(a * 9.8, dt) record.generate_response_spectrum(response_times=periods) times = record.response_times sub_fig.plot(times, record.s_a, label="eqsig") plt.show()
How do I get set up?
- Run pip install -r requirements.txt
- A function that calculates a property the takes a signal as an input, should be named as calc_<property>, if the calculation has multiple different implementations, then include the citation as author and year as well calc_<property>_<author>_<year>
- If the function takes a raw array then it should contain the word array (or values or vals).
Tests are run with pytest
- Locally run: pytest on the command line.
- Tests are run on every push using travis, see the .travis.yml file
To deploy the package to pypi.com you need to:
- Push to the pypi branch. This executes the tests on circleci.com
- Create a git tag and push to github, run: trigger_deploy.py or manually:
git tag 0.5.2 -m "version 0.5.2" git push --tags origin pypi
Built via Sphinx following: https://codeandchaos.wordpress.com/2012/07/30/sphinx-autodoc-tutorial-for-dummies/
For development mode
- cd to docs
- Run make html
Docstrings follow numpy convention (in progress): https://numpydoc.readthedocs.io/en/latest/format.html
To fix long_description in setup.py: pip install collective.checkdocs, python setup.py checkdocs
On zenodo.org use the github integration tool, click on the eqsig package and click create new release.
- Added interp2d fast interpolation of a 2D array to obtain a new 2D array
- No longer raises warning when period is 0.0 for computing response spectrum
- Fixed issue with computation of smoothed response spectrum for dealing with zeroth frequency
- Increased speed of`generate_smooth_fa_spectrum`
- Can now directly set AccSignal.smooth_fa_frequencies
- Deprecated AccSignal.smooth_freq_points and AccSignal.smooth_freq_range will be removed in later version
- More accuracy in calc_surface_energy - now interpolates between time steps. More tests added.
- Fixed issue in get_zero_crossings_array_indices where it would fail if array did not contain any zeros.
- Added calculation of equivalent number of cycles and equivalent uniform amplitude using power law relationship as intensity measures
- Added function get_n_cyc_array to compute number of cycles series from a loading series
- Added intensity measure im.calc_unit_kinetic_energy() to compute the cumulative change in kinetic energy according to Millen et al. (2019)
- Added surface.py with calculation of surface energy and cumulative change in surface energy time series versus depth from surface
- Fixed issue with second order term in sdof response spectrum calculation which effected high frequency response, updated example to show difference
- First production release
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size eqsig-1.2.0.tar.gz (31.3 kB)||File type Source||Python version None||Upload date||Hashes View|