Difference between revisions of "Broadband Platform Upcoming Release"

From SCECpedia
Jump to navigationJump to search
 
(88 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:Bbp.jpg|256px|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 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 v14.3.0. This distribution was posted online on Monday, 31 March 2014. 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 13.9.0, released in September 2013. Details of the new features along with several bugs fixes are provided in the release notes and the "changes" section below. 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 19: Line 19:
 
Broadband has the following dependencies:
 
Broadband has the following dependencies:
  
*[http://www.python.org/download/ Python 2.6+] with
+
*[http://www.python.org/download/ Python 2.7.9+] with
**[http://new.scipy.org/download.html NumPy and Scipy]
+
**[http://github.com/numpy/numpy NumPy 1.9.2+]
**[http://matplotlib.sourceforge.net/ matplotlib]
+
**[http://github.com/scipy/scipy Scipy 0.14.1+]
**[http://code.google.com/p/pyproj/ PyProj]
+
**[http://matplotlib.sourceforge.net/ matplotlib 1.4.3+]
*[http://gcc.gnu.org GNU compilers]
+
**[http://github.com/jswhit/pyproj PyProj 1.9.2+]
*[http://software.intel.com/en-us/articles/non-commercial-software-download/ Intel compilers]
+
*[http://gcc.gnu.org GNU compilers (gcc, gfortran) 4.5.1+]
  
Please refer to the [[Broadband User Guide v14.3.0]] for more details about the specific versions required for each of the packages above. A non-commercial copy of Intel C and FORTRAN compilers can be obtained by registering for a [http://software.intel.com/en-us/articles/non-commercial-software-development/ non-commercial account with Intel] and downloading the compilers from the Intel website.
+
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 ==
+
== 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 v14.3.0]]
+
*[[Broadband Platform Manual Installation 16 5 0|Broadband Platform Manual Installation]]
 +
*[[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]]
== Downloads ==
 
 
 
To install and use the Broadband platform, you need the source code, one or more Green's Functions packages, and optionally one or more Validation packages. 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 previous version of the Broadband Platform will need to retrieve new versions of all the Broadband Platform packages as there have been significant changes in all the packages since the previous 13.9.0 release.
 
 
 
There are detailed installation instructions in the [[Broadband User Guide v14.3.0]].
 
 
 
Detailed instructions to setup the Broadband Platform as a local installation on a Linux Machine are provided in the [[Broadband User Guide v14.3.0]]. Briefly, they can be summarized in the following steps:
 
# The software can be installed in an account on a Linux computer with at least 10GB of disk storage and C, Fortran, and Python software installed.
 
# 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.
 
# Download each file into a directory and run the md5sum program to confirm you have an undamaged version of the distribution files by comparing the md5sum provided below against the one calculated at the local Linux computer.
 
# Uncompress the distribution (tar.gz) files into the proper directory structure as described in the [[Broadband User Guide v14.3.0]].
 
# Build the executables by running the top level makefile.
 
# Configure your environment by adding a few Broadband Platform variables to your shell's environment.
 
# Confirm the code is built correctly by running UnitTests.
 
# Confirm the code runs correctly on your system by running AcceptanceTests.
 
# Use the platform for research purposes.
 
 
 
== Current Broadband Platform Release ==
 
 
 
The current SCEC Broadband platform release is v14.3.0. Links to the source distribution and Green's Functions and Validation packages are listed in the table below:
 
 
 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
 
|-
 
! rowspan="2"| Version
 
! rowspan="2"| Release Date
 
! colspan="3"| Files
 
! rowspan="2"| User Guide
 
|-
 
! Source Code
 
! Green's Functions Packages
 
! Validations Packages
 
|-
 
! scope="row" rowspan="1" | 14.3.0
 
| 03/31/2014
 
| [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/bbp-dist-14.3.0.tar.gz BBP 14.3.0],
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/bbp-dist-14.3.0.tar.gz.md5 BBP 14.3.0.md5]
 
| [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/centraljapan-velocity-model-14.3.0.tar.gz Central Japan], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/centraljapan-velocity-model-14.3.0.tar.gz.md5 Central Japan.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/labasin-velocity-model-14.3.0.tar.gz LA Basin], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/labasin-velocity-model-14.3.0.tar.gz.md5 LA Basin.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/lomap-velocity-model-14.3.0.tar.gz LOMAP (NoCal)], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/lomap-velocity-model-14.3.0.tar.gz.md5 LOMAP.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/mojave-velocity-model-14.3.0.tar.gz Mojave], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/mojave-velocity-model-14.3.0.tar.gz.md5 Mojave.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/westernjapan-velocity-model-14.3.0.tar.gz Western Japan], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/westernjapan-velocity-model-14.3.0.tar.gz.md5 Western Japan.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/ceus1000-velocity-model-14.3.0.tar.gz Eastern United States], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/ceus1000-velocity-model-14.3.0.tar.gz.md5 Eastern United States.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/canada1000-velocity-model-14.3.0.tar.gz Eastern Canada], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/canada1000-velocity-model-14.3.0.tar.gz.md5 Eastern Canada.md5]
 
 
 
| [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/lomaprieta-validation-14.3.0.tar.gz Loma Prieta], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/lomaprieta-validation-14.3.0.tar.gz.md5 Loma Prieta.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/14.3.0/northridge-validation-14.3.0.tar.gz Northridge], [http://hypocenter.usc.edu/research/bbp/versions/14.3.0/northridge-validation-14.3.0.tar.gz.md5 Northridge.md5]
 
|[[Broadband User Guide v14.3.0]]
 
[[Broadband v14.3.0 Release Notes]]
 
|}
 
 
 
== Optional Broadband Platform Patches ==
 
 
 
There are currently no optional patches available for 14.3.0.
 
 
 
== Recent Broadband Platform Releases ==
 
 
 
Here is a list of recent SCEC Broadband platform releases. Links to the source distribution and Green's Functions and Validation packages are listed in the table below:
 
 
 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
 
|-
 
! rowspan="2"| Version
 
! rowspan="2"| Release Date
 
! colspan="3"| Files
 
! rowspan="2"| User Guide
 
|-
 
! Source Code
 
! Green's Functions Packages
 
! Validations Packages
 
|-
 
! scope="row" rowspan="1" | 13.9.0
 
| 09/26/2013
 
| [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/bbp-dist-13.9.0.tar.gz BBP 13.9.0],
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/bbp-dist-13.9.0.tar.gz.md5 BBP 13.9.0.md5]
 
| [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/centraljapan-velocity-model-13.9.0.tar.gz Central Japan], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/centraljapan-velocity-model-13.9.0.tar.gz.md5 Central Japan.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/labasin-velocity-model-13.9.0.tar.gz LA Basin], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/labasin-velocity-model-13.9.0.tar.gz.md5 LA Basin.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/lomap-velocity-model-13.9.0.tar.gz LOMAP (NoCal)], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/lomap-velocity-model-13.9.0.tar.gz.md5 LOMAP.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/mojave-velocity-model-13.9.0.tar.gz Mojave], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/mojave-velocity-model-13.9.0.tar.gz.md5 Mojave.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/westernjapan-velocity-model-13.9.0.tar.gz Western Japan], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/westernjapan-velocity-model-13.9.0.tar.gz.md5 Western Japan.md5]
 
| [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/lomaprieta-validation-13.9.0.tar.gz Loma Prieta], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/lomaprieta-validation-13.9.0.tar.gz.md5 Loma Prieta.md5]
 
 
 
[http://hypocenter.usc.edu/research/bbp/versions/13.9.0/northridge-validation-13.9.0.tar.gz Northridge], [http://hypocenter.usc.edu/research/bbp/versions/13.9.0/northridge-validation-13.9.0.tar.gz.md5 Northridge.md5]
 
|[[Broadband User Guide v13.9.0]]
 
[[Broadband v13.9.0 Release Notes]]
 
|}
 
 
 
== 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.
 
 
 
{| class="wikitable" border="1" cellpadding="5" cellspacing="0"
 
|-
 
! rowspan="2"| Version
 
! rowspan="2"| Release Date
 
! colspan="3"| Files
 
! rowspan="2"| User Guide
 
|-
 
! Source Code
 
! Data
 
! Patches
 
|-
 
! scope="row" rowspan="1" | 11.2.3
 
| 5/09/2012
 
| [http://hypocenter.usc.edu/research/bbp/bbp_dist_v11.2.3.tgz bbp_dist_v11.2.3.tgz]
 
[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/bbp/bbp_data_v11.2.3.tgz bbp_data_v11.2.3.tgz]
 
[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.3]]
 
[[Broadband v11.2.3 Release Notes]]
 
|-
 
! 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
 
| 09/29/2011
 
| [http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_dist_v11.2.1.tgz bbp_dist_v11.2.1.tgz]
 
[http://hypocenter.usc.edu/research/broadband/11.2.1/bbp_dist_v11.2.1.tgz.md5 bbp_dist_v11.2.1.tgz.md5]
 
|[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]
 
|
 
|[[Broadband User Guide v11.2.1]]
 
[[Broadband v11.2.1 Release Notes]]
 
|-
 
! scope="row" rowspan="1" | 11.2.0
 
| 02/18/2011
 
| [http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_dist_v11.2.0.tgz bbp_dist_v11.2.0.tgz]
 
[http://hypocenter.usc.edu/research/broadband/11.2.0/bbp_dist_v11.2.0.tgz.md5 bbp_dist_v11.2.0.tgz.md5]
 
|[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]
 
|
 
|[[Broadband User Guide v11.2]]  
 
|}
 
  
 
== Supporting Materials ==
 
== Supporting Materials ==
*[http://hypocenter.usc.edu/research/broadband/bbp_ssa2011-v1.pptx Broadband Platform Presentation - SSA 2011 - Robert Graves (5MB pptx file)]
+
*[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_AGU_poster.pdf Broadband poster from AGU 2010 (PDF, 882 KB)]
+
*[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_overview.ppt Broadband overview talk from SC10 (PPT, 3.7 MB)]  
 
*[http://hypocenter.usc.edu/research/broadband/documents/Broadband_module_schematics.pptx Technical diagrams of Broadband module relationships (PPTX, 16 KB)]
 
 
 
== 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 2014.
 
<!--
 
Additional details about this version is available here:
 
*[[Broadband Development Version]]
 
 
 
Details about an un-released development version of broadband are posted here:
 
*[[Broadband User Guide v11.7.0]]
 
-->
 
  
 
== Help ==
 
== Help ==
 
 
For assistance with the Broadband Platform, you may
 
For assistance with the Broadband Platform, you may
 
* Email software @ scec.org with specific questions
 
* Email software @ scec.org with specific questions
Line 217: Line 47:
  
 
== License ==
 
== License ==
 
 
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 ==
+
== Broadband Platform Developers and Collaborators ==
 
+
*[http://www.scec.org SCEC]
==== Broadband Platform 14.3.0 ====
 
 
 
Broadband Platform v14.3.0, released in March 2014 is considered a major released of the Broadband Platform. It contains most of the capabilities of the v13.9.0 version with the following modifications:
 
 
 
* Trac # 114 - Convert from f77 to gfortran
 
* Trac # 146 - Move DT out of src file
 
* Trac # 195 - Produce GMPE plot for validation simulations
 
* Trac # 212 - wrong unit on respect plot
 
* Trac # 213 - Remove unneeded GP_GOF parameters
 
* Trac # 214 - Reduce volume of logged data
 
* Trac # 215 - Modify SRF plot so that it uses same ALONG_STRIKE/DOWN_DIP reference as SRC file
 
* Trac # 219 - SRC file should specify Mw, platform then calculates the seismic moment
 
* Trac # 222 - Integrate new GP Rupture Generator v3.2.1
 
* Trac # 224 - Add randomization in BBToolbox using the iseed parameter
 
* Trac # 230 - Modify station list parser to accept float vs30 values
 
* Trac # 232 - Add the decimation factor patch from SDSU to BBToolbox
 
* Trac # 233 - Show epicenter location on all map plots
 
* Trac # 234 - Add '08 suffix to current GMPE plot labels
 
* Trac # 235 - Modify GoF plot labels
 
* Trac # 237 - Rotate all multi-figure plots so they are viewed in landscape
 
* Trac # 240 - Run LF and HF components in the UCSB method using separate GFs
 
* Trac # 241 - Modify SDSU BBtoolbox to handle smaller-magnitude events
 
* Trac # 242 - Integrate GP Rupture generator v3.3 into the Broadband Platform
 
* Trac # 243 - Update GP jbsim LF program
 
* Trac # 244 - Arias duration module fails when processing zeroed observation files
 
* Trac # 245 - Make str_fac a region-specific parameter in BBToolbox
 
* Trac # 246 - Capture and store resource information from shell
 
* Trac # 247 - Allow user to specify hypocenter randomization area in cluster script
 
* Trac # 248 - Add option to cluster script for user to run only the rupture generator
 
* Trac # 249 - Add option to cluster script for users to specify SRF files to use
 
* Trac # 250 - Correct NGA model labels on GMPE box plots
 
* Trac # 251 - Integrate ExSIM14 into Broadband Platform
 
* Trac # 252 - Integrate new version of GP high frequency code
 
* Trac # 253 - Simplify makefiles and remove support for user-specified compilers
 
* Trac # 254 - Integrate Feb 2014 version of UCSB code into Broadband Platform
 
* Trac # 256 - Integrate SDSU model version 1.5.4.1 into the Broadband Platform
 
* Trac # 257 - Use SEED in SRC file for high frequency simulation in GP method
 
* Trac # 258 - Require same parameters for cluster post-processing scripts
 
* Trac # 259 - Produce map plots for GMPE runs
 
 
 
==== Broadband Platform 13.9.0 ====
 
 
 
Broadband Platform v13.9.0, released in September 2013 is considered a major released of the Broadband Platform. It contains most of the capabilities of the v11.2.3 version with the following modifications:
 
 
 
* Trac # 38 - Running validation events with SDSU and incorrect station names causes a crash
 
* Trac # 57 - Setting fmax=20.0 Hz in bbtoolbox_cfg.py generates NaNs in output bbp
 
* Trac # 80 - Add NGA attenuenation relationship
 
* Trac # 82 - Separate validation files from GF
 
* Trac # 83 - Separate GF into individual events
 
* Trac # 84 - User selectable GF
 
* Trac # 87 - Integrate Atkinson module into broadband
 
* Trac # 88 - Integrate Irikura Module into BBP
 
* Trac # 89 - Provide no site correction option
 
* Trac # 94 - Add number cutoff distance and number of stations to bias plots
 
* Trac # 96 - Add link to bias plot results into validation table
 
* Trac # 98 - Rename main run script to run_bbp.py
 
* Trac # 100 - Rename urs modules to gp modules
 
* Trac # 101 - add test to check for mixed spaces and tabs
 
* Trac # 102 - Move plot files out of Greens Functions
 
* Trac # 103 - Make site response optional in the platform
 
* Trac # 104 - Use environment variables to find Greens Functions and Validation directories
 
* Trac # 106 - Review BBP bbtoobox unit tests on broadband.usc.edu
 
* Trac # 112 - Collect additional metadata using CSEP environment script and generate full manifest for software distribution
 
* Trac # 120 - Link velocity model and code to specific gf
 
* Trac # 121 - full validation runs with src file or user selected srf file
 
* Trac # 122 - Allow users to provide an alternative directory for input/output data files
 
* Trac # 123 - reliable system for self reporting software version for broadband
 
* Trac # 124 - Plot of station map with SDSU code base
 
* Trac # 125 - Migrate pbs script and parallel scripts into svn trunk
 
* Trac # 126 - move plots into bbp home directory
 
* Trac # 130 - Amp Fac Unit test fails due to long filenames
 
* Trac # 131 - Make parallel scripts configurable to run a number of concurrent instances
 
* Trac # 136 - Move y2r2b.cpt file from URS_DATA/plot to BBP distribution plot/data directory
 
* Trac # 137 - Rupture model png not copied to outdata directory
 
* Trac # 140 - Add Arias Duration plots for bbp full validation sims
 
* Trac # 142 - Add rotd50 routine to BBP
 
* Trac # 143 - URS validation fails due to long file paths
 
* Trac # 144 - Automatically adjust time series plot window to capture entire event
 
* Trac # 147 - Convert peer obs files to bbp format obs
 
* Trac # 148 - lowfreq corner of -99 in station list
 
* Trac # 149 - Check in uwo EXSIM code into trunk with tests
 
* Trac # 150 - Include the rupture generator in the validation workflow
 
* Trac # 152 - Rupture plot appears distorted
 
* Trac # 153 - Generate html option copies extra files to output directory
 
* Trac # 154 - check rotd50 code
 
* Trac # 155 - Fix units label on full validation seismogram plots
 
* Trac # 156 - Enable rotD50 module to handle bbp and peer inputs files
 
* Trac # 157 - Validate Broadband using ifort version 12.0 on HPCC
 
* Trac # 159 - Make FMAX user-configurable in BBToolbox
 
* Trac # 160 - Use RotD50 data in Bias plot instead of average horizontals
 
* Trac # 161 - Bias plot should only include data within band-pass filter
 
* Trac # 162 - Show band-pass bars on per-station plots
 
* Trac # 163 - Create new bias plot showing fit over station distance
 
* Trac # 164 - Move md5sums into validation and gf packages
 
* Trac # 165 - Derive UCSB station list from Broadband station list
 
* Trac # 166 - Derive BBToolbox inputs from Broadband inputs for validation runs
 
* Trac # 167 - The 2 horizontal components in the PSa5/RotD50 bias plot are inverted
 
* Trac # 168 - Create a KML file with stations and fault line
 
* Trac # 169 - Extend RotD50 GOF plot range 0.1Hz - 100Hz
 
* Trac # 171 - The geobb_srf script fails to find fault corners in certain scenarios
 
* Trac # 172 - Check station names' length and abort if above max limit
 
* Trac # 173 - Package GMPE code into the Broadband Platform
 
* Trac # 174 - Introduce version numbers for validation and GFs packages
 
* Trac # 175 - Integrate scripts to produce GMPE boxplots into the Platform
 
* Trac # 176 - Randomize hypocenter location when running multiple validation realizations
 
* Trac # 177 - Use same UCSB rupture generator binary for vertical and dipping faults
 
* Trac # 178 - Plot station map with fault using SRC file
 
* Trac # 179 - Create single component GOF plot
 
* Trac # 180 - Generate SRF file in XYZ format for the SDSU method
 
* Trac # 181 - Add Qp and Qs to the SDSU velocity model file
 
* Trac # 182 - Make switch for randomizing hypocenter required on cluster script
 
* Trac # 183 - Make SDSU seismograms module take regular station list
 
* Trac # 185 - Implement resume workflow feature on the Broadband Platform
 
* Trac # 184 - Check if SRF file exists if user wants to skip rupture generator
 
* Trac # 186 - Make BBToolbox use magnitude from SRC file
 
* Trac # 187 - Calculate HYPO_DEPTH automatically for the UCSB method
 
* Trac # 188 - Add option for users to run the Broadband Platform on the background
 
* Trac # 189 - Optimize arias_duration script
 
* Trac # 190 - Remove duplicate tests in UnitTest.py
 
* Trac # 191 - Add simulation timestamp to index.html file
 
* Trac # 192 - Integrate UNR Composite Source Model into the Platform
 
* Trac # 194 - Enable cluster to run user-defined simulations
 
* Trac # 196 - Create a map GOF plot with color
 
* Trac # 197 - Create combined GOF for all realizations and stations
 
* Trac # 198 - Whenever running binary files, print an error message if it is not found
 
* Trac # 199 - Print error when velocity model doesn't exist for selected method/event
 
* Trac # 201 - Update the BBToolbox version in the Platform to 1.5
 
* Trac # 202 - PlotMap.py doesn't work for Matplotlib v1.2.0
 
* Trac # 203 - Integrate updated version of UCSB rupture generator
 
* Trac # 204 - Support multiple colorsets on GOF plots
 
* Trac # 206 - Regenerate acceptance tests for trunk
 
* Trac # 208 - Add check to make sure number of stations is under UCSB's syn1D limit
 
* Trac # 209 - Fix race condition for matplotlib cache file when running on the cluster
 
* Trac # 210 - Increase array size is respect in order to handle larger seismograms
 
* Trac # 211 - Increase CSM's station limit and check if station list is under new limit
 
 
 
==== Broadband Platform 11.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 11.2.2 ====
 
 
 
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
 
 
 
==== Broadband Platform 11.2.1 ====
 
 
 
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.
 
 
 
==== Broadband Platform 11.2.0 ====
 
 
 
11.2.0  - February 2011 - Initial release.
 
 
 
== Collaborators ==
 
 
 
*[http://www.erdw.ethz.ch/index_EN ETH Zurich - Swiss Federal Institute of Technology Zurich]
 
 
*[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.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.urscorp.com/ URS Corporation]
+
*[http://www.seismo.unr.edu University of Nevada Reno]
*[http://www.scec.org SCEC]
+
*[http://www.uwo.ca/earth/ University of Western Ontario]
*[http://scec.usc.edu/scecpedia SCEC/CME Project]
+
*[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.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 415: Line 66:
 
* [[BBP FAQ]]
 
* [[BBP FAQ]]
  
== See Also ==
+
== Related Wiki Entries ==
 +
*[http://scec.usc.edu/scecpedia SCEC Wiki Main]
 +
*[http://www.scec.org SCEC Home Page]
 
*[[SWUS Project]]
 
*[[SWUS Project]]
*[[Broadband Platform 2007]]
 
 
*[http://scec.usc.edu/scecpedia/software SCEC Software Downloads]
 
*[http://scec.usc.edu/scecpedia/software SCEC Software Downloads]
*[http://scec.usc.edu/scecpedia SCEC Wiki Main]
 
*[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==
+
== 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:
 +
# 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
 +
# 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
 +
# 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.
 +
# 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
 +
# 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
 +
# 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.
  
#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]
+
== Related Entries ==
#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]
+
*[http://scec.usc.edu/scecpedia SCEC/CME Project]
#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]
 

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