Difference between revisions of "Broadband Platform v11.2.3"

From SCECpedia
Jump to navigationJump to search
m (moved Broadband Platform to Broadband Platform v11.2.3: Renamed page due to v13.9.0 release)
 
(32 intermediate revisions by 3 users not shown)
Line 13: Line 13:
 
== Current Release ==
 
== Current Release ==
  
The current official release of Broadband Platform is v11.2.2. This distribution was posted online on Thursday, 21 Oct 2011. This is a "bug-fix" version of the platform that fixes a small number of bugs discovered in v11.2.1. since its release in September 2011.
+
The current official release of Broadband Platform is v11.2.3. This distribution was posted online on Wednesday, 09 May 2012. This is a "bug-fix" version of the platform that fixes a small number of bugs discovered in v11.2.2 since its release in October 2011. Details of the bugs fixes are provided in the release notes. No new features are introduced in this version of the platform. New 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.
 
 
We recommend current Broadband platform users migrate to this new version at first opportunity. No significant functional changes are introduced in this version of the platform.
 
  
 
== Dependencies ==
 
== Dependencies ==
Line 36: Line 34:
  
 
User Guide Wiki (includes installation instructions):  
 
User Guide Wiki (includes installation instructions):  
*[[Broadband_User_Guide_v11.2]]
+
*[[Broadband User Guide Current]]
  
 
== Downloads ==
 
== Downloads ==
  
To install and use the Broadband platform, you need both the source code and the data files. The broadband platform contains cumulative improvements to the geoscientific codes and software infrastructure. We recommend use of the most recent version of the broadband platform, in most cases.
+
To install and use the Broadband platform, you need both the source code and the data files. The broadband platform contains cumulative improvements to the geoscientific codes and software infrastructure. We recommend use of the most recent version of the broadband platform, unless you are trying to reproduce results generated with an earlier version of the platform.
  
Users that are upgrading from V11.2.0 to v11.2.2 should retrieve new versions of both the Broadband Platform data files and the Broadband Platform source code. Both were changed in this latest release.
+
Users that are upgrading from V11.2.0 to v11.2.3 should retrieve new versions of both the Broadband Platform data files and the Broadband Platform source code. Both were changed in this latest release.
  
There are detailed installation instructions in the [[Broadband User Guide v11.2]].
+
There are detailed installation instructions in the [[Broadband User Guide Current]].
  
 
The main steps involved in installing the platform as a local installation on Linux machine include:
 
The main steps involved in installing the platform as a local installation on Linux machine include:
Line 59: Line 57:
 
== Current Broadband Platform Release ==  
 
== Current Broadband Platform Release ==  
  
The current SCEC Broadband platform release is v11.2.2. Links to the source code and data distributions are listed in the table below:
+
The current SCEC Broadband platform release is v11.2.3. Links to the source code and data distributions are listed in the table below:
  
 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
Line 71: Line 69:
 
! Data
 
! Data
 
|-
 
|-
! scope="row" rowspan="1" | 11.2.2
+
! scope="row" rowspan="1" | 11.2.3
| 10/14/2011
+
| 05/09/2012
| [http://hypocenter.usc.edu/research/broadband/11.2.2/bbp_dist_v11.2.2.tgz bbp_dist_v11.2.2.tgz]
+
| [http://hypocenter.usc.edu/research/bbp/bbp_dist_v11.2.3.tgz bbp_dist_v11.2.3.tgz]
[http://hypocenter.usc.edu/research/broadband/11.2.2/bbp_dist_v11.2.2.tgz.md5 bbp_dist_v11.2.2.tgz.md5]
+
[http://hypocenter.usc.edu/research/bbp/bbp_dist_v11.2.3.tgz.md5 bbp_dist_v11.2.3.tgz.md5]
|[http://hypocenter.usc.edu/research/broadband/11.2.2/bbp_data_v11.2.2.tgz bbp_data_v11.2.2.tgz]
+
|[http://hypocenter.usc.edu/research/bbp/bbp_data_v11.2.3.tgz bbp_data_v11.2.3.tgz]
[http://hypocenter.usc.edu/research/broadband/11.2.2/bbp_data_v11.2.2.tgz.md5 bbp_data_v11.2.2.tgz.md5]
+
[http://hypocenter.usc.edu/research/bbp/bbp_data_v11.2.3.tgz.md5 bbp_data_v11.2.3.tgz.md5]
|[[Broadband User Guide v11.2.2]]
+
|[[Broadband User Guide v11.2.3]]
[[Broadband v11.2.2 Release Notes]]
+
[[Broadband v11.2.3 Release Notes]]
 
|}
 
|}
 +
 +
== Optional Broadband Platform Patches ==
 +
 +
There are currently no optional patches available for 11.2.3.
  
 
== Previous Broadband Platform Release ==
 
== Previous Broadband Platform Release ==
Line 89: Line 91:
 
! rowspan="2"| Version
 
! rowspan="2"| Version
 
! rowspan="2"| Release Date
 
! rowspan="2"| Release Date
! colspan="2"| Files
+
! colspan="3"| Files
 
! rowspan="2"| User Guide
 
! rowspan="2"| User Guide
 
|-
 
|-
 
! Source Code
 
! Source Code
 
! Data
 
! Data
 +
! Patches
 +
|-
 +
! scope="row" rowspan="1" | 11.2.2
 +
| 10/21/2011
 +
| [http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_dist_v11.2.2.tgz bbp_dist_v11.2.2.tgz]
 +
[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_dist_v11.2.2.tgz.md5 bbp_dist_v11.2.2.tgz.md5]
 +
|[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.2.tgz bbp_data_v11.2.2.tgz]
 +
[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.2.tgz.md5 bbp_data_v11.2.2.tgz.md5]
 +
|[http://hypocenter.usc.edu/research/broadband/11.2.2_patch/bbp_patch_v11.2.2.1.tgz bbp_patch_v11.2.2.1.tgz]
 +
[http://hypocenter.usc.edu/research/broadband/11.2.2_patch/bbp_patch_v11.2.2.2.tgz bbp_patch_v11.2.2.2.tgz]
 +
|[[Broadband User Guide v11.2.2]]
 +
[[Broadband v11.2.2 Release Notes]]
 
|-
 
|-
 
! scope="row" rowspan="1" | 11.2.1
 
! scope="row" rowspan="1" | 11.2.1
Line 101: Line 115:
 
|[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.1.tgz bbp_data_v11.2.1.tgz]
 
|[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.1.tgz bbp_data_v11.2.1.tgz]
 
[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.1.tgz.md5 bbp_data_v11.2.1.tgz.md5]
 
[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_data_v11.2.1.tgz.md5 bbp_data_v11.2.1.tgz.md5]
 +
|
 
|[[Broadband User Guide v11.2.1]]
 
|[[Broadband User Guide v11.2.1]]
 
[[Broadband v11.2.1 Release Notes]]
 
[[Broadband v11.2.1 Release Notes]]
Line 110: Line 125:
 
|[http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_data_v11.2.0.tgz bbp_data_v11.2.0.tgz]
 
|[http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_data_v11.2.0.tgz bbp_data_v11.2.0.tgz]
 
[http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_data_v11.2.0.tgz.md5 bbp_data_v11.2.0.tgz.md5]
 
[http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_data_v11.2.0.tgz.md5 bbp_data_v11.2.0.tgz.md5]
 +
|
 
|[[Broadband User Guide v11.2]]  
 
|[[Broadband User Guide v11.2]]  
 
|}
 
|}
Line 126: Line 142:
 
Details about working with the development version are provided in the User Guide.
 
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 Q4 of 2011. Additional details about this version is available here:
+
The next version of Broadband is expected to be released in Q3 of 2012. Additional details about this version is available here:
 
*[[Broadband Development Version]]
 
*[[Broadband Development Version]]
 +
 +
Details about an un-released development version of broadband are posted here:
 +
*[[Broadband User Guide v11.7.0]]
  
 
== Help ==
 
== Help ==
Line 139: Line 158:
 
SCEC Broadband Platform software distributions are released under an Apache 2.0 open-source license as described here [[Broadband License]].
 
SCEC Broadband Platform software distributions are released under an Apache 2.0 open-source license as described here [[Broadband License]].
  
== Changes in Broadband Platform v11.2.2 ==
+
== Changes in Broadband Platform v11.2.3 ==
Broadband Platform v11.2.2, releases in October 2011 is considered a 'bug-fix' release of Broadband Platform. Broadband Platform v11.2.2 contains the same functional capabilities as v11.2.1 with the following modifications.
+
 
 +
Broadband Platform v11.2.3, released in May 2012 is considered a 'bug-fix' release of Broadband Platform. Broadband Platform v11.2.3 contains the same functional capabilities as v11.2.2 with the following modifications.
 +
 
 +
* Trac # 30 Change tolerance depending on acceptance test combo
 +
* Trac # 69 UCSB high and low frequency modules don't work for Loma Prieta validation
 +
* Trac # 70 UCSB src/ucsb/Converter/utlFault.h srf name buffer length too short
 +
* Trac # 71 Allow tolerance checks to be disabled in unit/acceptance tests
 +
* Trac # 72 run_bbp_2G.py option file parsing exception when selecting a file among two or more choices
 +
* Trac # 74 Minor bug in a routine that is used for geographic conversions in the URS simulations on the BB platform
 +
* Trac # 75 Update Green's function data file with fixes and new datasets
 +
* Trac # 76 Change DEFAULT_KAPPA from 0.02 to 0.01 in ./comps/stas2files.py
 +
* Trac # 77 Remove station "olem" vs30 value from from UCSB Loma Prieta stations.vs30 in 11.7.0/trunk data sets
 +
* Trac # 78 Updated geobb_srf.py to use URS ll2xy coordinate conversion routines on trunk
 +
 
 +
Broadband Platform v11.2.2, released in October 2011 is considered a 'bug-fix' release of Broadband Platform. Broadband Platform v11.2.2 contains the same functional capabilities as v11.2.1 with the following modifications.
  
 
* Trac # 56 Convert BBP Matlab scripts to Python
 
* Trac # 56 Convert BBP Matlab scripts to Python
Line 162: Line 195:
  
 
== Collaborators ==
 
== Collaborators ==
 
  
 
*[http://www.erdw.ethz.ch/index_EN ETH Zurich - Swiss Federal Institute of Technology Zurich]
 
*[http://www.erdw.ethz.ch/index_EN ETH Zurich - Swiss Federal Institute of Technology Zurich]
Line 171: Line 203:
 
*[http://www.scec.org SCEC]
 
*[http://www.scec.org SCEC]
 
*[http://scec.usc.edu/scecpedia SCEC/CME Project]
 
*[http://scec.usc.edu/scecpedia SCEC/CME Project]
 +
 +
== Frequently Asked Questions (FAQ) ==
 +
We post BBP user questions and our response to a Broadband Platform Frequently Asked Questions (FAQ) page:
 +
* [[BBP FAQ]]
  
 
== See Also ==
 
== See Also ==
Line 177: Line 213:
 
*[http://scec.usc.edu/scecpedia SCEC Wiki Main]
 
*[http://scec.usc.edu/scecpedia SCEC Wiki Main]
 
*[http://www.scec.org SCEC Home Page]
 
*[http://www.scec.org SCEC Home Page]
 +
*[[Broadband User Guide Current]]
 +
*[[Broadband User Guide Development]]
 +
*[[Broadband Server]]
 +
*[[Broadband Hanging Wall Simulation]]
 +
*[[Broadband Development]]
 +
*[[Broadband Platform Installation Guide Current]]
 +
*[[Broadband Platform User Guide Current]]
  
 
==References==
 
==References==

Latest revision as of 19:18, 30 September 2013

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 current official release of Broadband Platform is v11.2.3. This distribution was posted online on Wednesday, 09 May 2012. This is a "bug-fix" version of the platform that fixes a small number of bugs discovered in v11.2.2 since its release in October 2011. Details of the bugs fixes are provided in the release notes. No new features are introduced in this version of the platform. New 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.

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. The broadband platform contains cumulative improvements to the geoscientific codes and software infrastructure. We recommend use of the most recent version of the broadband platform, unless you are trying to reproduce results generated with an earlier version of the platform.

Users that are upgrading from V11.2.0 to v11.2.3 should retrieve new versions of both the Broadband Platform data files and the Broadband Platform source code. Both were changed in this latest release.

There are detailed installation instructions in the Broadband User Guide Current.

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.

Current Broadband Platform Release

The current SCEC Broadband platform release is v11.2.3. Links to the source code and data distributions are listed in the table below:

Version Release Date Files User Guide
Source Code Data
11.2.3 05/09/2012 bbp_dist_v11.2.3.tgz

bbp_dist_v11.2.3.tgz.md5

bbp_data_v11.2.3.tgz

bbp_data_v11.2.3.tgz.md5

Broadband User Guide v11.2.3

Broadband v11.2.3 Release Notes

Optional Broadband Platform Patches

There are currently no optional patches available for 11.2.3.

Previous Broadband Platform Release

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.

Version Release Date Files User Guide
Source Code Data Patches
11.2.2 10/21/2011 bbp_dist_v11.2.2.tgz

bbp_dist_v11.2.2.tgz.md5

bbp_data_v11.2.2.tgz

bbp_data_v11.2.2.tgz.md5

bbp_patch_v11.2.2.1.tgz

bbp_patch_v11.2.2.2.tgz

Broadband User Guide v11.2.2

Broadband v11.2.2 Release Notes

11.2.1 09/29/2011 bbp_dist_v11.2.1.tgz

bbp_dist_v11.2.1.tgz.md5

bbp_data_v11.2.1.tgz

bbp_data_v11.2.1.tgz.md5

Broadband User Guide v11.2.1

Broadband v11.2.1 Release Notes

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 is expected to be released in Q3 of 2012. Additional details about this version is available here:

Details about an un-released development version of broadband are posted 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.

Changes in Broadband Platform v11.2.3

Broadband Platform v11.2.3, released in May 2012 is considered a 'bug-fix' release of Broadband Platform. Broadband Platform v11.2.3 contains the same functional capabilities as v11.2.2 with the following modifications.

  • Trac # 30 Change tolerance depending on acceptance test combo
  • Trac # 69 UCSB high and low frequency modules don't work for Loma Prieta validation
  • Trac # 70 UCSB src/ucsb/Converter/utlFault.h srf name buffer length too short
  • Trac # 71 Allow tolerance checks to be disabled in unit/acceptance tests
  • Trac # 72 run_bbp_2G.py option file parsing exception when selecting a file among two or more choices
  • Trac # 74 Minor bug in a routine that is used for geographic conversions in the URS simulations on the BB platform
  • Trac # 75 Update Green's function data file with fixes and new datasets
  • Trac # 76 Change DEFAULT_KAPPA from 0.02 to 0.01 in ./comps/stas2files.py
  • Trac # 77 Remove station "olem" vs30 value from from UCSB Loma Prieta stations.vs30 in 11.7.0/trunk data sets
  • Trac # 78 Updated geobb_srf.py to use URS ll2xy coordinate conversion routines on trunk

Broadband Platform v11.2.2, released in October 2011 is considered a 'bug-fix' release of Broadband Platform. Broadband Platform v11.2.2 contains the same functional capabilities as v11.2.1 with the following modifications.

  • Trac # 56 Convert BBP Matlab scripts to Python
  • Trac # 67 Rename the cleanup.py so that people do not run it accidentally
  • Trac # 68 Build Broadband with latest (2011) Intel and GNU compilers

11.2.1 - September 2011 - Bug-fix release List of Trac items fixed in this release:

  • Trac # 41 - Add License file (EULA) to Broadband distribution.
  • Trac # 42 - Add a file manifest to the distribution archives.
  • Trac # 46 - Remove Hardcoded Green_Bank.inf entries.
  • Trac # 47 - Syn1d Module fails with IO error due to missing file.
  • Trac # 54 - plot_SRF.csh fails with "Newline in variable name".
  • Trac # 61 - Provide an option to remove temporary folders at end of Broadband simulation run.
  • Trac # 62 - Add a warning and user prompt to comps/cleanup.py script.
  • Trac # 63 - Acceptance resume.txt should not be created in ref_data/accept_inputs.
  • Trac # 64 - Simulations with URS HF module fail with IOError and segmentation faults.
  • Trac # 65 - Add the XML file generated during a Broadband simulation to the output directory as metadata.

11.2.0 - February 2011 - Initial release.

Collaborators

Frequently Asked Questions (FAQ)

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

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