Difference between revisions of "Broadband Platform v11.2.3"

From SCECpedia
Jump to navigationJump to search
Line 13: Line 13:
 
== Current Release ==
 
== Current Release ==
  
The current version of the Broadband Platform is v11.7.0 which was released on Friday, 22 Jul 2011. The last stable release of Broadband Platform was v11.2.0, release on Friday, 18 February 2011.
+
The last stable release of Broadband Platform was v11.2.0, release on Friday, 18 February 2011. This is the best available version.
 +
An unofficial "beta" new version of the Broadband Platform called v11.7.0 was posted online on Friday, 22 Jul 2011. This is a "release candidate" version of the Platform that is under evaluation. Once this version have been reviewed by the scientific developers, it will become the official release.
  
 
== Dependencies ==
 
== Dependencies ==

Revision as of 22:03, 3 August 2011

Fig 1: Broadband Platform.

The SCEC Broadband Platform is a software system which generates 0-10 Hz seismograms for historical and scenario earthquakes in California.

Overview

The goal of the SCEC Broadband Simulation Platform is to generate broadband (0-10 Hz) ground motions for earthquakes using deterministic low-frequency and stochastic high-frequency simulations. The SCEC Broadband Platform is a collaborative software development project involving SCEC researchers, graduate students, and the SCEC/CME software development group. SCEC scientific groups have contributed modules to the Broadband Platform including rupture generation, low-frequency deterministic seismogram synthesis, high-frequency stochastic seismogram synthesis, and non-linear site effects. 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, Loma Prieta, and Landers) and user-defined earthquakes. The platform produces a variety of data products, including broadband seismograms, rupture visualizations, and 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, and the Mojave. Users may select among various codebases for 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 ease of installation and use.

Current Release

The last stable release of Broadband Platform was v11.2.0, release on Friday, 18 February 2011. This is the best available version.
An unofficial "beta" new version of the Broadband Platform called v11.7.0 was posted online on Friday, 22 Jul 2011. This is a "release candidate" version of the Platform that is under evaluation. Once this version have been reviewed by the scientific developers, it will become the official release.

Dependencies

Broadband has the following dependencies:

A non-commercial copy of Intel c and FORTRAN compilers can be obtained by registering for a non-commercial account with Intel and downloading the compilers from the Intel website.

and the following optional dependencies for additional functionality:

  • GMT (for plotting)
  • Matlab with map toolbox (for certain platform modules)
  • PyGTK (for interactive plotting)

Documentation

User Guide Wiki (includes installation instructions):

Downloads

To install and use the Broadband platform, you need both the source code and the data files. There are detailed installation instructions in the Broadband User Guide. There are two options for installing Broadband Platform:

  1. Local installation on a 64-Bit Linux machine
  2. Linux VirtualBox Image

The main steps involved in installing the platform as a local installation on Linux machine include:

  1. The software can be installed in an account on a Linux computer with at least 4GB of disk storage and C, Fortran, and Python software installed.
  2. From this Linux computer, start a web browser and point to this download page. Alternatively, you can download the files to a different machine and use FTP or SFTP to copy them over.
  3. Download the following four files (source, source md5sum, data, data md5sum) into a directory and run the md5sum program to confirm you have an undamaged version of the distribution files.
  4. Uncompress the distribution (tgz) files into data and source directory structures. The data files are nearly 3GB, but they are static and will not be modified and will not grow in size during use of the platform. The source directory is small, but this directory will increase as the platform is used, since the results produced by the platform will be stored here.
  5. Configure your environment to add broadband platform directories into your python path and define other useful environment variables.
  6. Build the executables by running the top level makefile.
  7. Confirm the code is built correctly by running UnitTests.
  8. Confirm the code runs correctly on your system by running AcceptanceTests.
  9. Use the platform for research purposes.

The main steps involved in installing a Broadband VirtualBox image:

  1. Download the VirtualBox client software.
  2. Download the VirtualBox image file and image md5sum for the desired operating system.
  3. Run the md5sum program to confirm you have an undamaged copy of the compressed VirtualBox image.
  4. Uncompress the VirtualBox image. the image file is nearly 16 GB in size.
  5. Setup a virtual machine in VirtualBox client with uncompressed image file as the virtual SATA disk drive.
  6. Launch the virtual machine and login with the credentials from Broadband user guide.
  7. Use the platform for research purposes.
Version Release Date Files User Guide
Source Code Data VirtualBox Image
11.7.0 07/22/2011 bbp_dist_v11.7.0.tgz

bbp_dist_v11.7.0.tgz.md5

bbp_data_v11.7.0.tgz

bbp_data_v11.7.0.tgz.md5

MAC / Linux Broadband User Guide v11.7

Broadband v11.7.0 Release Notes

bbp_vb_v11.7.0.tgz

bbp_vb_v11.7.0.tgz.md5

Windows
bbp_vb_v11.7.0.zip

bbp_vb_v11.7.0.zip.md5

11.2.0 02/18/2011 bbp_dist_v11.2.0.tgz

bbp_dist_v11.2.0.tgz.md5

bbp_data_v11.2.0.tgz

bbp_data_v11.2.0.tgz.md5

Broadband User Guide v11.2

Supporting Materials

Development version

If you're 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, v 11.7, is expected to be released in July 2011. Additional details about this version is available here:

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.

Release History

11.7.0 - July 2011

  • New goodness-of-fit module: SDSU - Mayhew-Olsen
  • New site response module: GATECH - Site1d
  • Removed dependency on Matlab
  • Broadband 11.7 distribution available as a Oracle VirtualBox Image
  • Several bug fixes. Complete list is available here : Broadband v11.7.0.

11.2.0 - February 2011 - Initial release.

Collaborators

See Also

References

  1. 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. link
  2. 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. link
  3. 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. link