Record selection tool

openquake/vmtk/Databases/WorkspaceDocumentationBBP.txt

@@ -0,0 +1,29 @@
+Documentation of the workspace 'BBP_***_meta_data.mat'
+
+This workspace has been created based on the SCEC BBP results from the 13.5 and 13.6 studies using either the EXSIM, GP, or SDSU method (replace the '***' with the method name when choosing one of these databases).
+
+Downloading simulated time histories for selected records
+
+An account will be needed with the Southern California Earthquake Center in order to access the results from various ground motion simulations. The links provided in the Output file generated by the Select_Ground_Motions script lead to a list of simulation numbers, while the filenames displayed in the Output file indicate the folder number and
+station (i.e. which links) to choose to access the appropriate time history. For each filename, the folder number will begin at 10000000 and the station number will appear after (e.g. for simulation 10000003.9001, 10000003 is the folder number and 9001 is the station number). Each of the time histories is located in a .acc file.
+
+Note: The EXSIM meta data only includes one-component ground motions, and two-component selection will not work for this database. 
+For single-component selection, the "Load the user-chosen database..." cell of the algorithm will need to be edited so that the soil_Vs30, magnitude, closest_D, and dirLocation variables are not repeated.  
+
+Variables: 
+
+Filename_1        : Filename of the time history data file in 				    direction 1
+Filename_2        : Filename of the time history data file in 				    direction 2
+dirLocation       : Link to the appropriate SCEC ground motion 				    simulation results page
+Periods           : Periods at which spectral accelerations have 				    been computed and stored in the workspace
+Rjb               : Joyner-Boore distance (km)
+Sa_1              : Spectral acceleration in direction 1
+Sa_2              : Spectral acceleration in direction 2
+Sa_RotD100        : Orientation independent two-component 					    spectral acceleration
+Sa_RotD50         : Orientation independent two-component 					    spectral acceleration
+closest_D        : Closest distance to the ruptured area
+magnitude         : Magnitude
+soil_Vs30         : Vs30 value 
+
+
+

openquake/vmtk/Databases/WorkspaceDocumentationCyberShake.txt

@@ -0,0 +1,29 @@
+Documentation of the workspace 'CyberShake_meta_data.mat'
+
+This workspace has been created based on selected ground motions from the SCEC CyberShake platform. For details on the ground motion selection, see:
+
+Baker, J. W., Goulet, C., Luco, N., Rezaeian, S., and Teng, G. (2020). “A Subset of CyberShake Ground Motion Time Series for Response History Analysis.” Earthquake Spectra, (in review).
+
+
+Variables available in the workspace: 
+
+Filename_1        : Filename of the time history data file in 				    direction 1
+Filename_2        : Filename of the time history data file in 				    direction 2
+dirLocation       : location of relavant directory in the archive
+Periods           : Periods at which spectral accelerations have 				    been computed and stored in the workspace
+Sa_1              : Spectral acceleration in direction 1
+Sa_2              : Spectral acceleration in direction 2
+Sa_RotD100        : Orientation independent two-component 					    spectral acceleration
+Sa_RotD50         : Orientation independent two-component 					    spectral acceleration
+closest_D         : Closest distance to the ruptured area
+magnitude         : Magnitude
+Site_Name		  : CyberShake site name
+Site_Short_Name   : CyberShake site short name
+soil_Vs30         : Vs30 value 
+Source_Name	      : seismic source name
+
+Additional ground motion metadata is available in the summaryTable.csv file in the archive described below.
+
+To access the associated ground motions, you should first download the ground motion .zip file from https://doi.org/10.5281/zenodo.3875541. Then move the .zip file to the folder  where the Matlab code is located (one directory up from where this documentation file is), and extract it there. 
+
+Then, when you set 'copyFiles = 1' in the main script, the software will know where to look for the ground motion time series.

openquake/vmtk/Databases/WorkspaceDocumentationNGAW1.txt

@@ -0,0 +1,61 @@
+Documentation of the workspace 'NGA_W1_meta_data.mat'
+
+This workspace has been created based on the PEER NGA database ground motions (Chiou et al. 2008). The documentation of the variables provided here is based on the NGA Documentation file available at:
+http://peer.berkeley.edu/nga/documentation.html
+
+Not all the variables available in the workspace may be required for the ground-motion selection. The minimum requirements have been documented in Select_Ground_Motions.m
+
+Nirmal Jayaram, Ting Lin, Jack W. Baker
+Department of Civil and Environmental Engineering
+Stanford University
+Last Updated: 27 March 2010
+Updated: March 31, 2016 to include Rjb
+
+Referenced manuscripts:
+
+Chiou, B., R. Darragh, N. Gregor, and W. Silva (2008). NGA project strong-motion database. Earthquake Spectra 24(1), 23�44.
+
+Downloading time histories for selected ground motions:
+
+The links provided in the Output File will lead to the unscaled ground motion time histories of the selected records. 
+
+Variables:
+
+Filename_1        : Filename of the time history data file in 				    direction 1
+Filename_2        : Filename of the time history data file in 				    direction 2
+Filename_FN       : Filename of the fault normal time history 				    data file
+Filename_FP       : Filename of the fault parallel time history 				    data file
+Filename_vert     : Filename of the vertical time history data 				    file
+Periods           : Periods at which spectral accelerations have 				    been
+                    computed and stored in the workspace
+Rjb               : Joyner-Boore distance (km)
+Sa_1              : Spectral acceleration in direction 1
+Sa_2              : Spectral acceleration in direction 2
+Sa_FN             : Spectral acceleration in fault normal 					    direction
+Sa_FP             : Spectral acceleration in fault parallel 				    direction
+Sa_vert           : Spectral acceleration in vertical direction
+Sa_RotD50         : Orientation independent two-component 					    spectral acceleration
+distance_campbell : Campbell distance
+closest_D         : Closest distance to the ruptured area
+distance_epi      : Epicentral distance
+distance_hyp      : Hypocentral distance
+distance_jb       : Joyner-Boore distance
+lowest_usable_freq: Lowest usable frequency
+magnitude         : Magnitude
+mechanism         : Fault mechanism
+soil_Vs30         : Vs30 value
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

openquake/vmtk/Databases/WorkspaceDocumentationNGAW2.txt

@@ -0,0 +1,55 @@
+Documentation of the workspace 'NGA_W2_meta_data.mat'
+
+This workspace has been created based on the PEER NGA West 2 database ground motions The documentation of the variables provided here is based on the NGA Documentation file available at: http://peer.berkeley.edu/ngawest2/databases/
+
+Not all the variables available in the workspace may be required for the ground-motion selection. The minimum requirements have been documented in Select_Ground_Motions.m
+
+Nirmal Jayaram, Ting Lin, Jack W. Baker Department of Civil and Environmental Engineering Stanford University
+Updated: March 20, 2014 to use the NGA West 2 database
+Updated: March 31, 2016 to include Rjb
+
+Downloading time histories for selected ground motions:
+
+The instructions for downloading time series from the NGA-W2 database are summarized in the Output File. In order to retrieve the time histories for the ground motions ultimately selected, proceed to the link: ngawest2.berkeley.edu An account is needed to access the database. If you do not have an account, click "Sign-up" at the top of the page.
+
+Once signed in, click the "NGA West2 enter" link on the right of the page. On the resulting page, select "No Scaling" under "Select Spectrum Model" and click submit. Under "Record Characteristics" enter the RSN (record sequence number) provided by the Output file generated by the Select_Ground_Motions script. The RSN values must be separated by commas. If you conducted a two-component ground motion selection, under "Suite, Spectral Ordinate" choose the type of orientation-independent spectra you used (i.e. RotD50 or RotD100). Click "Search Records."
+
+On the resulting page, scroll down to "Download Options" located near the bottom of the page and click "Download Time Series Records." For any message boxes that appear, click "OK." Save the resulting files. Each file provides the number of points (NPTS) and time step (DT) of the time history.
+
+
+Variables:
+
+Filename_1        : Filename of the time history data file 					in direction 1
+Filename_2        : Filename of the time history data file 					in direction 2
+Filename_vert     : Filename of the vertical time history 					data file
+dirLocation       : Link to the NGA-W2 page
+Periods           : Periods at which spectral accelerations 				have been
+                    computed and stored in the workspace
+Rjb               : Joyner-Boore distance (km)
+Sa_1              : Spectral acceleration in direction 1
+Sa_2              : Spectral acceleration in direction 2
+Sa_vert           : Spectral acceleration in vertical 						direction
+Sa_RotD100        : Orientation independent two-component 					spectral
+                    acceleration
+Sa_RotD50         : Orientation independent two-component 					spectral
+                    acceleration
+closest_D         : Closest distance to the ruptured area
+lowest_usable_freq: Lowest usable frequency
+magnitude         : Magnitude
+mechanism         : Fault mechanism
+soil_Vs30         : Vs30 value
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+