Difference between revisions of "Broadband Platform Upcoming Release"

From SCECpedia
Jump to navigationJump to search
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[File:SRL_Cover_v8.png|350px|thumb|right|Fig 1: Broadband Platform.]]
 
[[File:SRL_Cover_v8.png|350px|thumb|right|Fig 1: Broadband Platform.]]
  
The SCEC Broadband Platform is a software system which generates 0-100 Hz seismograms for historical and scenario earthquakes in California, Eastern North America, and Japan.
+
The SCEC Broadband Platform is a software system that can generate 0-100 Hz seismograms for historical and scenario earthquakes in California, Eastern North America, and Japan using several alternative computational methods.
  
 
== Overview ==  
 
== Overview ==  
Line 9: Line 9:
 
Users may calculate broadband seismograms for both historical earthquakes (validation events including Northridge and Loma Prieta) and user-defined earthquakes. The platform produces a variety of data products, including broadband seismograms, rupture visualizations, and several goodness-of-fit plots.  Users can install the platform on their own machine, verify that it is installed correctly, and run their own simulations on demand without requiring knowledge of any of the code involved. Users may run a validation event, supply their own simple source description, or provide a rupture description in SRF format. Users may specify their own list of stations or use a provided list. Currently the platform supports stations and events in Southern California, the Bay Area, the Mojave Desert, Eastern United States, Eastern Canada, Central and Western Japan. Users may select among various method that include rupture generation, low-frequency synthesis, high-frequency synthesis, and incorporation of site effects, with the option of running a goodness-of-fit comparison against observed or simulated seismograms.  These codes have been validated against recorded ground motions from real events.
 
Users may calculate broadband seismograms for both historical earthquakes (validation events including Northridge and Loma Prieta) and user-defined earthquakes. The platform produces a variety of data products, including broadband seismograms, rupture visualizations, and several goodness-of-fit plots.  Users can install the platform on their own machine, verify that it is installed correctly, and run their own simulations on demand without requiring knowledge of any of the code involved. Users may run a validation event, supply their own simple source description, or provide a rupture description in SRF format. Users may specify their own list of stations or use a provided list. Currently the platform supports stations and events in Southern California, the Bay Area, the Mojave Desert, Eastern United States, Eastern Canada, Central and Western Japan. Users may select among various method that include rupture generation, low-frequency synthesis, high-frequency synthesis, and incorporation of site effects, with the option of running a goodness-of-fit comparison against observed or simulated seismograms.  These codes have been validated against recorded ground motions from real events.
  
The Broadband Platform was implemented using software development best practices, including version control, user documentation, acceptance tests, and formal releases, with the aim of accuracy, reliability, ease of installation and use.
+
The Broadband Platform software development is performed using modern software engineering practices, including version control, user documentation, acceptance tests, and formal releases, with the aim of accuracy, reliability, ease of installation and use.
  
 
== Current Release ==
 
== Current Release ==
  
The current official release of Broadband Platform is v16.5.0. This is a new version of the platform that includes a large number of new capabilities. It is the first major release of the Broadband Platform since version 15.3.0, released in March 2015. Details of the new features along with several bugs fixes are provided in the release notes. New, and old Broadband platform users should work with this version of the software, and we recommend current Broadband platform users migrate to this new version whenever possible.
+
The current official release of Broadband Platform is v16.5.0. This is a new version of the platform that includes several  new capabilities. It is the first major release of the Broadband Platform since version 15.3.0, released in March 2015. Details of the new features along with several bugs fixes are provided in the release notes. New Broadband Platform users should work with this version of the software. We recommend existing Broadband platform users migrate to this new version whenever possible.
  
 
== Dependencies ==
 
== Dependencies ==
Line 20: Line 20:
  
 
*[http://www.python.org/download/ Python 2.7.9+] with
 
*[http://www.python.org/download/ Python 2.7.9+] with
**[http://github.com/numpy/numpy NumPy 1.9.2]
+
**[http://github.com/numpy/numpy NumPy 1.9.2+]
**[http://github.com/scipy/scipy Scipy 0.14.1]
+
**[http://github.com/scipy/scipy Scipy 0.14.1+]
**[http://matplotlib.sourceforge.net/ matplotlib 1.4.3]
+
**[http://matplotlib.sourceforge.net/ matplotlib 1.4.3+]
**[http://github.com/jswhit/pyproj PyProj 1.9.2]
+
**[http://github.com/jswhit/pyproj PyProj 1.9.2+]
*[http://gcc.gnu.org GNU compilers (gcc, gfortran) v4.5.1]
+
*[http://gcc.gnu.org GNU compilers (gcc, gfortran) 4.5.1+]
  
 
Please refer to the [[Broadband User Guide v16.5.0]] for more details about the specific versions required for each of the packages above. This version of the Broadband Platform does NOT require Intel compilers.
 
Please refer to the [[Broadband User Guide v16.5.0]] for more details about the specific versions required for each of the packages above. This version of the Broadband Platform does NOT require Intel compilers.
  
 
== Documentation Including Installation Instructions ==
 
== Documentation Including Installation Instructions ==
 
+
The Broadband Platform User Guide includes installation instructions:
User Guide Wiki (includes installation instructions):  
+
*[[Broadband User Guide v16.5.0]] (includes easy installation instructions)
*[[Broadband User Guide v16.5.0]]
+
*[[Broadband Platform Manual Installation 16 5 0|Broadband Platform Manual Installation]]  
*[[Broadband v16.5.0 Release Notes]]
+
*[[Broadband v16.5.0 Release Notes|Broadband 16.5.0 Release Notes]]
 +
*[[BBP 16.5.0 Virtual Box Image]]
 
*[[Broadband File Format Guide]]
 
*[[Broadband File Format Guide]]
 
+
*[[Broadband Data Products]]
== Broadband Platform Easy Installation ==
 
This section provides a brief overview of how the Broadband Platform can be installed on your local Linux or Mac OS X computer. It covers the Easy Installation method, where users download and run a shell script that downloads the other components based on user responses. Users are welcome to set up the Broadband Platform manually on their systems using the old installation instructions described in the [[Broadband Platform Manual Installation 16 5 0]] page.
 
 
 
Starting with this version of the Broadband Platform, we provide an easy installation script that can guide users through downloading and installing the Broadband Platform on a Linux or Mac OS X computer that meets the system requirements for the Broadband Platform. For this method, users need to download the [http://hypocenter.usc.edu/research/bbp/versions/16.5.0/easy_install_bbp_16.5.0.sh BBP 16.5.0 Easy Install Script]. Once that script is downloaded, users should:
 
 
 
$ chmod +x easy_install_bbp_16.5.0.sh
 
$ ./easy_install_bbp_16.5.0.sh <directory>
 
 
 
The script will automatically create a "bbp" subdirectory, where it will install the Broadband Platform. To install the Broadband Platform in the current directory, users can simply type:
 
 
 
$ ./easy_install_bbp_16.5.0.sh .
 
 
 
====== Welcome to Broadband Platform 16.5.0 installation script =====
 
 
  Using destination directory: /home/sarah
 
 
=> Main Broadband Platform Source Distribution
 
==> Downloading...
 
==> Compiling...
 
==> Installed!
 
 
 
The easy installation script will automatically download and compile the main source distribution. Following that, it will ask users to select which regions should be installed along with the Platform. Please note that saying "Yes" to a region, will automatically install any validation events available for that region. At a minimum, and in order to run Unit and Acceptance tests, users should say "Yes" to the "LA Basin" region.
 
 
 
Please select what velocity models (regions) you would like to install:
 
 
==> Would you like to install the Northern California region?
 
1) Yes
 
2) No
 
#?2
 
 
==> Would you like to install the LA Basin region?
 
1) Yes
 
2) No
 
#? 1
 
 
...
 
...
 
...
 
 
=> Installing Broadband Platform Velocity Model Packages
 
==> LA Basin
 
==> Completed!
 
=> Installing Broadband Platform Validation Packages
 
==> Northridge
 
==> GMPEs
 
==> Completed!
 
 
=> All Done!
 
 
Please add the following lines to your bash_profile:
 
 
export BBP_DIR=/home/sarah/bbp/16.5.0/bbp
 
export BBP_GF_DIR=/home/sarah/bbp/bbp_gf
 
export BBP_VAL_DIR=/home/sarah/bbp/bbp_val
 
export PYTHONPATH=/home/sarah/bbp/16.5.0/bbp/comps
 
export BBP_DATA_DIR=/home/sarah/bbp/bbp_data
 
export PATH=/home/sarah/bbp/16.5.0/bbp/comps:/home/sarah/bbp/16.5.0/bbp/utils/batch:$PATH
 
 
 
After installing the Broadband Platform on their systems, users should confirm the code is built correctly by running Unit tests and then Acceptance tests before starting to use the code for research purposes. For detailed information, please refer to the [[Broadband User Guide v16.5.0]].
 
  
 
== Supporting Materials ==
 
== Supporting Materials ==
*[http://hypocenter.usc.edu/research/SSA2016/Broadband-poster-SSA-2016.pdf Broadband Poster from SSA 2016 - Fabio Silva and Christine Goulet (PDF, 14MB)]
+
*[http://hypocenter.usc.edu/research/SSA2016/Broadband-poster-SSA-2016.pdf Broadband Poster from SSA 2016 (PDF, 14MB)]
*[http://hypocenter.usc.edu/research/broadband/documents/Broadband_overview.ppt Broadband overview talk from SC10 (PPT, 3.7 MB)]
+
*[http://hypocenter.usc.edu/research/bbp/bbp-16-5-release.pdf Broadband Platform 16.5.0 Release Overview (PDF, 1.9 MB)]
*[http://hypocenter.usc.edu/research/broadband/documents/Broadband_module_schematics.pptx Technical diagrams of Broadband module relationships (PPTX, 16 KB)]
 
  
 
== Help ==
 
== Help ==
Line 109: Line 50:
  
 
== Broadband Platform Developers and Collaborators ==
 
== Broadband Platform Developers and Collaborators ==
*[http://peer.berkeley.edu Pacific Earthquake Engineering Research Center]
+
*[http://www.scec.org SCEC]
 
*[http://www.geology.sdsu.edu/ San Diego State University Dept of Geological Sciences]
 
*[http://www.geology.sdsu.edu/ San Diego State University Dept of Geological Sciences]
*[http://www.scec.org SCEC]
 
*[http://scec.usc.edu/scecpedia SCEC/CME Project]
 
*[http://www.erdw.ethz.ch/index_EN ETH Zurich - Swiss Federal Institute of Technology Zurich]
 
*[http://www.ce.berkeley.edu University of California, Berkeley]
 
 
*[http://www.geol.ucsb.edu/ U.C. Santa Barbara Dept of Earth Sciences]
 
*[http://www.geol.ucsb.edu/ U.C. Santa Barbara Dept of Earth Sciences]
 
*[http://www.crustal.ucsb.edu/ UCSB Institute for Crustal Studies]
 
*[http://www.crustal.ucsb.edu/ UCSB Institute for Crustal Studies]
 
*[http://www.seismo.unr.edu University of Nevada Reno]
 
*[http://www.seismo.unr.edu University of Nevada Reno]
 
*[http://www.uwo.ca/earth/ University of Western Ontario]
 
*[http://www.uwo.ca/earth/ University of Western Ontario]
*[http://www.urscorp.com/ URS Corporation]
+
*[http://www.erdw.ethz.ch/index_EN ETH Zurich - Swiss Federal Institute of Technology Zurich]
 +
*[http://earthquake.usgs.gov USGS Earthquake Hazards Program including Pasadena California]
 
*[http://www.aecom-urs.com AECOM / URS]
 
*[http://www.aecom-urs.com AECOM / URS]
 +
*[http://www.ce.berkeley.edu University of California, Berkeley]
 +
*[http://peer.berkeley.edu Pacific Earthquake Engineering Research Center]
  
 
== Frequently Asked Questions (FAQ) ==
 
== Frequently Asked Questions (FAQ) ==
Line 144: Line 84:
  
 
== Acknowledging ==
 
== Acknowledging ==
 +
Please support the Broadband Platform project by acknowledging the use of this software. Acknowledgements and citations help us obtain additional resources for continued development of the platform. If you use the Broadband Platform software for work resulting in an academic publication, we would appreciate it if one, or more, of the following paper is cited.
  
If you use the Broadband Platform, please support the project by acknowledging it. If your work results in an academic publication, we would be happy if one of the following papers is cited:
+
References for specific computational methods included in the Broadband Platform (v15.3.0 and later, including v16.5.0) and for the validation procedures developed by the Broadband Platform include:
 
 
# Christine A. Goulet, Norman A. Abrahamson, Paul G. Somerville, and Katie E. Wooddell (2015) The SCEC Broadband Platform Validation Exercise: Methodology for Code Validation in the Context of Seismic‐Hazard Analyses Seismological Research Letters, January/February 2015, v. 86, p. 17-26, doi:10.1785/0220140104
 
# Philip J. Maechling, Fabio Silva, Scott Callaghan, and Thomas H. Jordan (2015) SCEC Broadband Platform: System Architecture and Software Implementation Seismological Research Letters, January/February 2015, v. 86, p. 27-38, First published on December 17, 2014, doi:10.1785/0220140125
 
 
 
== References ==
 
 
# Anderson, J. G (2015) The Composite Source Model for Broadband Simulations of Strong Ground Motions Seismological Research Letters, January/February 2015, v. 86, p. 68-74, First published on December 17, 2014, doi:10.1785/0220140098
 
# Anderson, J. G (2015) The Composite Source Model for Broadband Simulations of Strong Ground Motions Seismological Research Letters, January/February 2015, v. 86, p. 68-74, First published on December 17, 2014, doi:10.1785/0220140098
 
# Atkinson, G. M., and Assatourians, K. (2015) Implementation and Validation of EXSIM (A Stochastic Finite‐Fault Ground‐Motion Simulation Algorithm) on the SCEC Broadband Platform Seismological Research Letters, January/February 2015, v. 86, p. 48-60, First published on December 17, 2014, doi:10.1785/0220140097
 
# Atkinson, G. M., and Assatourians, K. (2015) Implementation and Validation of EXSIM (A Stochastic Finite‐Fault Ground‐Motion Simulation Algorithm) on the SCEC Broadband Platform Seismological Research Letters, January/February 2015, v. 86, p. 48-60, First published on December 17, 2014, doi:10.1785/0220140097
Line 158: Line 94:
 
# Goulet, C.A., Abrahamson, N.A., Somerville, P.G. and K, E. Wooddell (2015) The SCEC Broadband Platform Validation Exercise: Methodology for Code Validation in the Context of Seismic-Hazard Analyses, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140104
 
# Goulet, C.A., Abrahamson, N.A., Somerville, P.G. and K, E. Wooddell (2015) The SCEC Broadband Platform Validation Exercise: Methodology for Code Validation in the Context of Seismic-Hazard Analyses, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140104
 
# Graves, R., and Pitarka, A. (2015) Refinements to the Graves and Pitarka (2010) Broadband Ground‐Motion Simulation Method Seismological Research Letters, January/February 2015, v. 86, p. 75-80, First published on December 17, 2014, doi:10.1785/0220140101
 
# Graves, R., and Pitarka, A. (2015) Refinements to the Graves and Pitarka (2010) Broadband Ground‐Motion Simulation Method Seismological Research Letters, January/February 2015, v. 86, p. 75-80, First published on December 17, 2014, doi:10.1785/0220140101
#Graves, R. W. and A. Pitarka (2010). “Broadband Ground-Motion Simulation Using a Hybrid Approach.” Bull. Seis. Soc. Am., 100(5A), pp. 2095-2123, doi: 10.1785/0120100057. [http://hypocenter.usc.edu/research/broadband/documents/Graves_Pitarka_2010.pdf link]
+
# Olsen, K. B., and Takedatsu, R. (2015) The SDSU Broadband Ground‐Motion Generation Module BBtoolbox Version 1.5 Seismological Research Letters, January/February 2015, v. 86, p. 81-88, First published on December 17, 2014, doi:10.1785/0220140102
 +
 
 +
The primary reference for the Broadband Platform software system (v15.3.0 and later, including v16.50) is:
 
#Maechling, P. J., F. Silva, S. Callaghan, and T. H. Jordan (2015). SCEC Broadband Platform: System Architecture and Software Implementation, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140125.
 
#Maechling, P. J., F. Silva, S. Callaghan, and T. H. Jordan (2015). SCEC Broadband Platform: System Architecture and Software Implementation, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140125.
#Mai, P.M., W. Imperatori, and K.B. Olsen (2010). “Hybrid broadband ground motion simulations: combining long-period deterministic synthetics with high frequency multiple S-to-S back-scattering.” Bull. Seis. Soc. Am., 100(5A), pp. 2124-2142, doi: 10.1785/0120080194. [http://hypocenter.usc.edu/research/broadband/documents/Mai_Imperatori_Olsen_2010.pdf link]
+
 
# Olsen, K. B., and Takedatsu, R. (2015) The SDSU Broadband Ground‐Motion Generation Module BBtoolbox Version 1.5 Seismological Research Letters, January/February 2015, v. 86, p. 81-88, First published on December 17, 2014, doi:10.1785/0220140102
+
== Related Entries ==
#Schmedes, J., R. J. Archuleta, and D. Lavallée (2010). “Correlation of earthquake source parameters inferred from dynamic rupture simulations.” J. Geophys. Res., 115, B03304, doi:10.1029/2009JB006689.  [http://hypocenter.usc.edu/research/broadband/documents/Schmedes_Archuleta_Lavallee_2010.pdf link]
+
*[http://scec.usc.edu/scecpedia SCEC/CME Project]

Latest revision as of 14:33, 27 May 2016

Fig 1: Broadband Platform.

The SCEC Broadband Platform is a software system that can generate 0-100 Hz seismograms for historical and scenario earthquakes in California, Eastern North America, and Japan using several alternative computational methods.

Overview

The goal of the SCEC Broadband Simulation Platform is to generate broadband (0-100 Hz) ground motions for earthquakes. The SCEC Broadband Platform is a collaborative software development project involving SCEC researchers, research engineers, graduate students, and the SCEC/CME software development group. SCEC scientific groups have contributed modules to the Broadband Platform including rupture generation, low- and high-frequency seismogram synthesis, non-linear site effects, and visualization. These complex scientific codes have been integrated into a system that supports easy on-demand computation of broadband seismograms. The SCEC Broadband Platform is designed to be used by both scientific and engineering researchers with some experience interpreting ground motion simulations.

Users may calculate broadband seismograms for both historical earthquakes (validation events including Northridge and Loma Prieta) and user-defined earthquakes. The platform produces a variety of data products, including broadband seismograms, rupture visualizations, and several goodness-of-fit plots. Users can install the platform on their own machine, verify that it is installed correctly, and run their own simulations on demand without requiring knowledge of any of the code involved. Users may run a validation event, supply their own simple source description, or provide a rupture description in SRF format. Users may specify their own list of stations or use a provided list. Currently the platform supports stations and events in Southern California, the Bay Area, the Mojave Desert, Eastern United States, Eastern Canada, Central and Western Japan. Users may select among various method that include rupture generation, low-frequency synthesis, high-frequency synthesis, and incorporation of site effects, with the option of running a goodness-of-fit comparison against observed or simulated seismograms. These codes have been validated against recorded ground motions from real events.

The Broadband Platform software development is performed using modern software engineering practices, including version control, user documentation, acceptance tests, and formal releases, with the aim of accuracy, reliability, ease of installation and use.

Current Release

The current official release of Broadband Platform is v16.5.0. This is a new version of the platform that includes several new capabilities. It is the first major release of the Broadband Platform since version 15.3.0, released in March 2015. Details of the new features along with several bugs fixes are provided in the release notes. New Broadband Platform users should work with this version of the software. We recommend existing Broadband platform users migrate to this new version whenever possible.

Dependencies

Broadband has the following dependencies:

Please refer to the Broadband User Guide v16.5.0 for more details about the specific versions required for each of the packages above. This version of the Broadband Platform does NOT require Intel compilers.

Documentation Including Installation Instructions

The Broadband Platform User Guide includes installation instructions:

Supporting Materials

Help

For assistance with the Broadband Platform, you may

  • Email software @ scec.org with specific questions
  • Browse and submit new trouble tickets, or feature requests, at Broadband Trac site. SCEC user login is required to submit trouble tickets this way.

License

SCEC Broadband Platform software distributions are released under an Apache 2.0 open-source license as described here Broadband License.

Broadband Platform Developers and Collaborators

Frequently Asked Questions (FAQ)

We post BBP user questions and our response to a Broadband Platform Frequently Asked Questions (FAQ) page:

Related Wiki Entries

Older Broadband Platform Releases

Earlier version of the broadband platform software and data distributions are provided to support existing Broadband platform users. However, we recommend all users upgrade to the most recent version at first opportunity. Earlier releases can be found in the Broadband Platform Previous Releases page.

Development version

If you're an advanced user, interested in working with the latest development version of the platform, you can check it out from

svn co https://source.usc.edu/svn/broadband/trunk

Details about working with the development version are provided in the User Guide.

The next version of Broadband is expected to be released in Q3 of 2016.

Acknowledging

Please support the Broadband Platform project by acknowledging the use of this software. Acknowledgements and citations help us obtain additional resources for continued development of the platform. If you use the Broadband Platform software for work resulting in an academic publication, we would appreciate it if one, or more, of the following paper is cited.

References for specific computational methods included in the Broadband Platform (v15.3.0 and later, including v16.5.0) and for the validation procedures developed by the Broadband Platform include:

  1. Anderson, J. G (2015) The Composite Source Model for Broadband Simulations of Strong Ground Motions Seismological Research Letters, January/February 2015, v. 86, p. 68-74, First published on December 17, 2014, doi:10.1785/0220140098
  2. Atkinson, G. M., and Assatourians, K. (2015) Implementation and Validation of EXSIM (A Stochastic Finite‐Fault Ground‐Motion Simulation Algorithm) on the SCEC Broadband Platform Seismological Research Letters, January/February 2015, v. 86, p. 48-60, First published on December 17, 2014, doi:10.1785/0220140097
  3. Crempien, J. G. F., and Archuleta, R. J. (2015) UCSB Method for Simulation of Broadband Ground Motion from Kinematic Earthquake Sources Seismological Research Letters, January/February 2015, v. 86, p. 61-67, First published on December 17, 2014, doi:10.1785/0220140103
  4. Dreger, D. S., Beroza, G.C., Day, S. M., Goulet, C. A., Jordan, T. H., Spudich, P. A., and Stewart, J. P. (2015). Validation of the SCEC Broadband Platform V14.3 Simulation Methods Using Pseudospectral Acceleration Data, Seismol. Res. Lett., 86, no. 1, doi:10.1785/0220140118.
  5. Dreger, D. S., and Jordan, T. H. (2015) Introduction to the Focus Section on Validation of the SCEC Broadband Platform V14.3 Simulation Methods Seismological Research Letters, January/February 2015, v. 86, p. 15-16, doi:10.1785/0220140233
  6. Goulet, C.A., Abrahamson, N.A., Somerville, P.G. and K, E. Wooddell (2015) The SCEC Broadband Platform Validation Exercise: Methodology for Code Validation in the Context of Seismic-Hazard Analyses, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140104
  7. Graves, R., and Pitarka, A. (2015) Refinements to the Graves and Pitarka (2010) Broadband Ground‐Motion Simulation Method Seismological Research Letters, January/February 2015, v. 86, p. 75-80, First published on December 17, 2014, doi:10.1785/0220140101
  8. Olsen, K. B., and Takedatsu, R. (2015) The SDSU Broadband Ground‐Motion Generation Module BBtoolbox Version 1.5 Seismological Research Letters, January/February 2015, v. 86, p. 81-88, First published on December 17, 2014, doi:10.1785/0220140102

The primary reference for the Broadband Platform software system (v15.3.0 and later, including v16.50) is:

  1. Maechling, P. J., F. Silva, S. Callaghan, and T. H. Jordan (2015). SCEC Broadband Platform: System Architecture and Software Implementation, Seismol. Res. Lett., 86, no. 1, doi: 10.1785/0220140125.

Related Entries