Difference between revisions of "BBP 14.10 Image"
| (26 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
| − | == | + | == Overview == |
| − | + | The BBP Image used during the [[2014 VISES Summer School|2014 SCEC-ERI Summer School for Earthquake Science]] contains proprietary software, so we are no longer able to distribute that image. SCEC does not have permission to distribute some of the software used during that workshop. To provide access to BBP software while we prepare a fully-open source BBP distribution, we have created an unofficial release of the BBP that contains only some of the processing methods and capabilities of the full v14.3 distribution. | |
| − | |||
| − | |||
| − | == | + | == Distribution == |
| − | + | We are distributing BBP v14.10 as a Virtual Box Image. To use this version of the BBP, you will need to install the Virtual Box software. There are versions of Virtual Box for most operating systems including Mac, Windows, and Linux. The use of Virtual Box makes it easier for us to distribute, and for users to run, the BBP software which was designed to run on Linux computers. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | * | + | Instructions for downloading Virtual Box can be found here: |
| − | ** | + | *[[Install_Virtual_Box]] |
| + | |||
| + | == Download == | ||
| + | The BBP source code, python components, test data, and associated data files are collected in the following Virtual Box image. This is similar to a tar, or zip file, in that it collects a number of smaller files into one large file. To run the BBP v14.10 in Virtual Box, download the following image. | ||
| + | *[http://hypocenter.usc.edu/research/tars/scecbbp.ova Virtual Box OVA file] (13.1GB) | ||
| + | |||
| + | == Installation == | ||
| + | Many aspects of the BBP v14.10 software distribution are based on the distribution created for a recent SCEC BBP workshop. Details about loading the Image on your computer are posted here: | ||
| + | *[[SCEC-ERI_Workshop_Software]] | ||
| + | |||
| + | == Login == | ||
| + | Once you have the BBP v14.10 image running in your Virtual Box, you should boot the image. A Centos operating system will boot. Eventually you will be prompted to log into an account on the Centos computer. Please use the following username and password. | ||
| + | |||
| + | *Username: scecbbp | ||
| + | *Pwd: scecbbp.2014 | ||
| + | |||
| + | == Disclaimer == | ||
| + | The BBP v14.10 is an unofficial distribution of the Broadband Platform. We consider this an un-official version of the software for two reasons. | ||
| + | #This distribution contains a partial list of processing methods. BBP v14.3 contains five ground motion methods. BBP v14.10 contains only 3 methods. | ||
| + | #Previous BBP distributions including v14.3 were carefully tested and evaluate. The BBP v14.10 distribution has not been through the same careful evaluation process. | ||
| + | |||
| + | We have created BBP v14.10 to ensure continued access to the BBP while we make necessary modifications. We expect the next official release for the Broadband Platform to be release before end of 2014. | ||
| + | |||
| + | == Capabilities == | ||
| + | BBP v14.10 contains three ground motion methods | ||
| + | * GP | ||
| + | * UCSB | ||
| + | * CSM | ||
| + | |||
| + | These are the three methods that currently can be compiled using the open-source GNU C and fortran compilers. We removed several other methods because they require use of the Intel compilers which are commercial products that SCEC cannot distribute. | ||
| + | |||
| + | Greens functions, developed by the BBP science groups, are included for Northern California, the LA Basin, Mojave Region, and Central US. | ||
| + | |||
| + | == Environment == | ||
| + | The BBP directories have been installed on the desktop of user: scecbbp. Various aliases have been defined to help navigate. These include: | ||
| + | *bbp - This moves you to the bbp home directory (/home/scecbbp/Desktop/scec/bbp/14.3.0) This is where the python components and source code for the ground motion methods are stored. | ||
| + | *data - This moves you to the bbp data directory (/home/scecbbp/Desktop/scec/bbp/bbp_data). This is where the simulation results are written. To find the output data from a simulation, from here, cd into outdata, and the simulation outputs are stored in timestamped directories. | ||
| + | *start - This moves you to the start directory ((/home/scecbbp/Desktop/scec/bbp/bbp_data/start). This is the recommended location where you initiate bbp simulation by typing %run_bbp.py. If you are running a simulation using custominzed input files including station, and source files, you can assemble your input files in the start directory. When you invoke the run_bbp.py command, you can select these input files as local files. Once the simulation begins, copies of the input files will be moved to the indata directories. | ||
| + | |||
| + | == Evaluation == | ||
| + | We evaluated this distribution by running the BBP validation simulations (both Northridge and Loma Prieta) to confirm the software is working properly. This can be done by typing | ||
| + | |||
| + | *%run_bbp.py | ||
| + | |||
| + | And then answer yes to the first question it asks, which is: | ||
| + | *"Do you want to perform a validation run (Y/N)? | ||
| + | |||
| + | Please note that it may take several hours for the BBP to run a validation simulation. | ||
| + | |||
| + | == Related Entries == | ||
| + | *[[2014 VISES Summer School|2014 SCEC-ERI Summer School for Earthquake Science]] | ||
| + | *[[Broadband Platform]] | ||
Latest revision as of 18:14, 15 May 2015
Contents
Overview
The BBP Image used during the 2014 SCEC-ERI Summer School for Earthquake Science contains proprietary software, so we are no longer able to distribute that image. SCEC does not have permission to distribute some of the software used during that workshop. To provide access to BBP software while we prepare a fully-open source BBP distribution, we have created an unofficial release of the BBP that contains only some of the processing methods and capabilities of the full v14.3 distribution.
Distribution
We are distributing BBP v14.10 as a Virtual Box Image. To use this version of the BBP, you will need to install the Virtual Box software. There are versions of Virtual Box for most operating systems including Mac, Windows, and Linux. The use of Virtual Box makes it easier for us to distribute, and for users to run, the BBP software which was designed to run on Linux computers.
Instructions for downloading Virtual Box can be found here:
Download
The BBP source code, python components, test data, and associated data files are collected in the following Virtual Box image. This is similar to a tar, or zip file, in that it collects a number of smaller files into one large file. To run the BBP v14.10 in Virtual Box, download the following image.
- Virtual Box OVA file (13.1GB)
Installation
Many aspects of the BBP v14.10 software distribution are based on the distribution created for a recent SCEC BBP workshop. Details about loading the Image on your computer are posted here:
Login
Once you have the BBP v14.10 image running in your Virtual Box, you should boot the image. A Centos operating system will boot. Eventually you will be prompted to log into an account on the Centos computer. Please use the following username and password.
- Username: scecbbp
- Pwd: scecbbp.2014
Disclaimer
The BBP v14.10 is an unofficial distribution of the Broadband Platform. We consider this an un-official version of the software for two reasons.
- This distribution contains a partial list of processing methods. BBP v14.3 contains five ground motion methods. BBP v14.10 contains only 3 methods.
- Previous BBP distributions including v14.3 were carefully tested and evaluate. The BBP v14.10 distribution has not been through the same careful evaluation process.
We have created BBP v14.10 to ensure continued access to the BBP while we make necessary modifications. We expect the next official release for the Broadband Platform to be release before end of 2014.
Capabilities
BBP v14.10 contains three ground motion methods
- GP
- UCSB
- CSM
These are the three methods that currently can be compiled using the open-source GNU C and fortran compilers. We removed several other methods because they require use of the Intel compilers which are commercial products that SCEC cannot distribute.
Greens functions, developed by the BBP science groups, are included for Northern California, the LA Basin, Mojave Region, and Central US.
Environment
The BBP directories have been installed on the desktop of user: scecbbp. Various aliases have been defined to help navigate. These include:
- bbp - This moves you to the bbp home directory (/home/scecbbp/Desktop/scec/bbp/14.3.0) This is where the python components and source code for the ground motion methods are stored.
- data - This moves you to the bbp data directory (/home/scecbbp/Desktop/scec/bbp/bbp_data). This is where the simulation results are written. To find the output data from a simulation, from here, cd into outdata, and the simulation outputs are stored in timestamped directories.
- start - This moves you to the start directory ((/home/scecbbp/Desktop/scec/bbp/bbp_data/start). This is the recommended location where you initiate bbp simulation by typing %run_bbp.py. If you are running a simulation using custominzed input files including station, and source files, you can assemble your input files in the start directory. When you invoke the run_bbp.py command, you can select these input files as local files. Once the simulation begins, copies of the input files will be moved to the indata directories.
Evaluation
We evaluated this distribution by running the BBP validation simulations (both Northridge and Loma Prieta) to confirm the software is working properly. This can be done by typing
- %run_bbp.py
And then answer yes to the first question it asks, which is:
- "Do you want to perform a validation run (Y/N)?
Please note that it may take several hours for the BBP to run a validation simulation.
