Analysis of air-to-ground coupled wave particle motion using the Normalized Inner-Product (NIP) method.
Coupling-NIP is a Python3 code to analyze the seismic particle motion of air-to-ground coupled waves. This code determines the sense of prograde or retrograde motion in time-frequency space. The NIP method presented here is adapted from Meza-Fajardo et al., (2015). When using this code we ask you to cite the following paper, which provides details on the method and relevant examples:
Scamfer, L. T., Fee, D., Bishop, J. W., Haney, M., Macpherson, K. A. (in review, 2026). The Influence of Shallow Subsurface Properties on Particle Motion in Acoustic–Seismic Coupling. Seismica
Below are install instructions for an example conda environment.
We recommend using conda (or mamba) and creating a new conda environment using the provided environment.yml file:
git clone https://github.com/ltscamfer/Coupling-NIP.git
cd Coupling-NIP
conda env create -f environment.yml
conda activate NIP_env
Information on conda environments (and more) is available here.
Python packages:
See the included example.py.
(Alphabetical order by last name.)
David Fee
Logan T. Scamfer
Meza-Fajardo, K. C., Papageorgiou, A. S., & Semblat, J. (2015). Identification and extraction of surface waves from three-component seismograms based on the normalized inner product. Bulletin of the Seismological Society of America, 105(1), 210–229. https://doi.org/10.1785/0120140012