ASCE 7 Response Spectra Comparison Tool

Overview

This tool is designed for engineers and researchers to compare ASCE 7-22 response spectra. It enables users to input specific geographic coordinates (latitude and longitude) and select from various Site Classes (A, B, BC, C, CD, D, DE, E) to view and compare response spectra. The tool provides interactive visualizations, a simple map for location verification, and the ability to generate and download a 'maximum envelope' spectrum.

Features

• Data Scraping: Automatically scrapes spectral ordinate data from the USGS Seismic Design Web Services website.
• User Input: Allows users to input latitude and longitude and select Site Classes, risk category, and other inputs.
• Interactive Plots: Visualize the spectral data for easy comparison.
• Map Integration: Provides a geographic map to validate the selected location.
• Maximum Envelope Spectrum: Generates a spectrum composed of the maximum values across selected spectra.
• Data Download: Enables users to download the spectral ordinates of selected classes.

Usage

Access the app with the URL below. Directions for its use are displayed there.

To use the app: https://spectra-plotter.streamlit.app/

Modify the Code

Prerequisites

• Python 3.11
• Pipenv for dependency management

Setup

1. Clone the repository:

   git clone (https://github.com/nshobert/Spectra-Plotter.git)
   

2. Navigate to your project directory:

   cd asce7_spectra_app
   

3. Install dependencies using Pipenv:

   pipenv install
   

4. Activate the Pipenv shell:

   pipenv shell
   

5. Start the Streamlit app:

   streamlit run source/main.py
   

6. To quit:

   ctrl+c
   

Example/ Test run

To confirm that your setup worked, run the app and submit the default settings.

1. Open a new browser window.
2. At the command line, enter streamlit run source\main.py. A browser window will open with the app.
3. Open the sidebar with the little arrow at upper left.
4. Leave the defaults. Select Check Location to confirm that the map updates to a point near Issaquah, WA.
5. Select Submit to add a plot with 4 spectra, a dataframe, and URLs to the main area.
6. You're now free to change the inputs in the sidebar for your project!

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Disclaimer

From the USGS, the source of the data:

This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software.

From the author:

This tool was developed to aid exploratory analysis of projects. It is subject to revision. Though developed thoughtfully, neither the functionality of the software nor the reliablity of the data are guaranteed. No warranty, expressed or implied, is made by the author. Users are urged to vet the data and information here against a unique source before relying on it for decision making.