Skip to content

geoimaging/mhvsr-vs30

Repository files navigation

mHVSR-Vs30 - A Set of Data-driven models to predict Vs30 from mHVSR

Kushal Sharma Wagle, Adrian Rodriguez-Marek, Joseph P. Vantassel jpvantassel.com

Table of Contents

About mHVSR-Vs30

mHVSR-Vs30 is a collection of data-driven models to predict the time averaged shear wave velocity in the upper 30 m (Vs30), from microtremor horizontal-to-vertical spectral ratio (mHVSR). The developed models developed include both low-dimensional (low_dim_models.ipynb) and high-dimensional (high_dim_models.ipynb). The details of the model's development and performance are presented in the reference below.

If you use these tools in your research or consulting, we ask you please cite the following:

Sharma Wagle, K., Vantassel, J.P., and Rodriguez-Marek, A. (2025). "A Set of Data-Driven Models to Predict VS30 from the Horizontal-to-Vertical Spectral Ratio of Microtremors". Bulletin of the Seismological Society of America. [In-Review]

Getting Started

Installing mHVSR-Vs30

  1. If you do not have Python 3.12 or later installed, you will need to do so. A detailed set of instructions can be found here.

  2. MacOS users, note that you may need to install libomp before continuing. You can do this using brew with the command brew install libomp or through conda with the command conda install -c conda-forge libomp.

  3. Download a copy of the repository to your local machine. This can be done by downloading a .zip file or by cloning the repository. If you download a .zip you will need to be sure that you continue using the unzipped version to prevent issues.

  4. Install the Python dependencies using pip via the command python -m pip install -r requirements.txt. If you are not familiar with pip, a useful tutorial can be found here.

  5. Confirm that the dependencies have installed/updated successfully by examining the last few lines of the text displayed in the console.

Using mHVSR-Vs30

  1. Launch the provided Jupyter notebooks, low_dim_models.ipynb or high_dim_models.ipynb (recommended), for a no-coding-required introduction to prediction models. If you have not installed Jupyter Lab, detailed instructions can be found here.

  2. Continue to explore the three datasets provided by changing the file names and associated metadata in the notebooks. Once you feel comfortable running the example data you can then apply the models on any mHVSR data of interest.

  3. Enjoy!

About

A set of data-driven models to predict Vs30 from microtremor HVSR (mHVSR).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published