Difference between revisions of "BBP 14.10 Image"

From SCECpedia
Jump to navigationJump to search
 
(26 intermediate revisions by one other user not shown)
Line 1: Line 1:
== Fedora 14 Virtual Box Installation on Mac OS X 10.9 ==
+
== Overview ==
* Set up for the SCEC CME Configuration:
+
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.
== Virtual Box Software ==
 
* Install VB v4.3.18
 
  
== Download Fedora 14 ==
+
== Distribution ==
* While current Fedora is v20, some VB features like guest additions work best on older versions of fedora
+
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.
** Machine name: scecbbp
 
** Machine type: Linux - Fedora (64Bit)
 
*Use the Default System except:
 
** Set Base Memory to 2048MB
 
** Set FileSystem type VDI
 
** set dynamically allocated
 
** Size: 71.31GB dynamic (does not need to be exactly this value)
 
* After machine is created, select "Settings", "Display"
 
** Increase video memory to 32MB
 
* Define a shared folder location on host system
 
** Select a folder on host system called "share"
 
* Download "Fedora-14-x86_64-DVD.iso" onto Mac hard drive
 
** Load it into VB
 
** Select the "Fedora 14 iso image downloaded above", and then click "OK"
 
* Boot (Start) the new machine and the Fedora 14 installation will begin
 
** Select "install a new system or upgrade..."
 
* Skip the media test
 
* When warning dialog asking about re-initializing device pops-up, select "Re-Initialize All"
 
* Machine name: "scecbbp"
 
* Select "Los Angeles" time zone
 
* Root password set to: "scecbbp2014"
 
* Installation type: "Use all space"
 
** Select the review and Customize box at the bottom of page
 
** Delete the /home partition and make the / partition larger to use the space used by /home. Set it to Max size shown on screen
 
* Select "Software Development" and add "Fedora 14 - x86_64" and "Fedora 14 - x86_64 Updates"
 
* Select "Customize Now"
 
* Add
 
** Applications
 
*** Editors
 
**** Emacs, vim-x11
 
*** Engineering and Scientific
 
**** R, Octave
 
*** Office/Productivity
 
* Actual installation begins...
 
* After machine reboots...
 
* User setup
 
** Username: cme
 
** Fullname: SCEC CME
 
** Password: sceccme
 
* Installation ends!
 
* Open terminal window
 
* Set up sudo access for user cme
 
** su - (to become root)
 
** visudo
 
*** Add line at the end: "cme    ALL(ALL)    ALL"
 
* Install missing Python dependencies for BBP and UCVM
 
**sudo yum install numpy scipy python-matplotlib python-basemap
 
* Disable the sendmail daemon
 
** sudo chkconfig sendmail off
 
** Install Pyproj
 
** Download Pyproj from https://pyproj.googlecode.com/files/pyproj-1.8.9.tar.gz
 
** untar, then run "sudo python ./setup.py install"
 
* Install the Virtual Box guest additions (from http://www.sysprobs.com/install-fedora-15-virtualbox-steps-install-virtualbox-guest-additions-fedora-15)
 
** sudo yum install dkms
 
** Select "Devices" -> "Insert Guest Additions CD image..."
 
** sudo su -
 
** cd /media/VBOXADDITIONS_<VERSION_NUMBER>
 
** sh ./VBoxLinuxAdditions.run
 
** Reboot!
 
  
* Setting up a shared folder on the virtual machine
+
Instructions for downloading Virtual Box can be found here:
** https://forums.virtualbox.org/viewtopic.php?t=15868
+
*[[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

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.

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.

  1. This distribution contains a partial list of processing methods. BBP v14.3 contains five ground motion methods. BBP v14.10 contains only 3 methods.
  2. 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