Accessing CyberShake Database Data

To query the CyberShake database, you can use the following login information with a MySQL client:

host: focal.usc.edu
user: cybershk_ro
password: CyberShake2007
database: CyberShake

This username/password is read-only, so you don't need to worry about accidentally changing the database.

We have quite a few tables and quite a lot of information in the database, but there are only a few tables that you'll need to use. They are:

• CyberShake_Sites - used to look up the unique site ID from the name of the site (like "LADT").
• CyberShake_Runs - used to look up the unique run ID using a site ID and other run parameters (like the velocity model, broadband, etc.)
• Ruptures - list of ruptures from UCERF used in CyberShake, along with their magnitude, name, and probability.
• CyberShake_Site_Ruptures - list of ruptures used for each site, including the distance to the rupture
• Rupture_Variations - list of rupture variations (realizations with different hypocenters and slip distributions) for each rupture
• PeakAmplitudes - used to get the PSA values, given the run ID and a specific rupture, rupture variation, and period
• Hazard_Curves - contains the run id and IM type for each hazard curve
• Hazard_Curve_Points - the X and Y values describing each hazard curve

The wiki page for each CyberShake study has the information - SGT ID, Rupture_Variation_Scenario_ID, etc. - which you need to retrieve the data from a specific study.

So if you'd like to get all the PSA data for LADT for 3 seconds from Study 15.12, you'd want to run the following query:

select P.Source_ID, P.Rupture_ID, P.Rup_Var_ID, P.IM_Value
from CyberShake_Sites S, CyberShake_Runs R, PeakAmplitudes P
where S.CS_Short_Name="LADT"
and S.CS_Site_ID=R.Site_ID
and R.Max_Frequency=10.0 and R.ERF_ID=36 and R.Status="Verified" and R.SGT_Variation_ID=8 and R.Velocity_Model_ID=5 and R.Rup_Var_Scenario_ID=6
and P.Run_ID=R.Run_ID
and P.IM_Type_ID=162
order by P.IM_Value desc limit 100;

The "R.Velocity_Model_ID=5" part means CVM-S4.26. The "R.Rup_Var_Scenario_ID=6" part means Graves & Pitarka (2014) rupture variations, with uniform hypocenter spacing.

The "P.IM_Type_ID=162" means 3 second period for RotD50. This mapping is stored in the IM_Types table, but here are the values of most interest:

RotD50, Period = 10 sec, IM_Type_ID=152
RotD50, Period = 5 sec, IM_Type_ID=158
RotD50, Period = 3 sec, IM_Type_ID=162
RotD50, Period = 2 sec, IM_Type_ID=167
RotD50, Period = 1 sec, IM_Type_ID=169
RotD50, Period = 0.5 sec, IM_Type_ID=173
RotD50, Period = 0.2 sec, IM_Type_ID=174
RotD50, Period = 0.1 sec, IM_Type_ID=175

RotD100 data has different IM Types; you could search the IM_Types table to identify the type IDs you want. Here are the values of most interest:

RotD100, Period = 10 sec, IM_Type_ID=136
RotD100, Period = 5 sec, IM_Type_ID=142
RotD100, Period = 3 sec, IM_Type_ID=146
RotD100, Period = 2 sec, IM_Type_ID=151
RotD100, Period = 1 sec, IM_Type_ID=168
RotD100, Period = 0.5 sec, IM_Type_ID=170
RotD100, Period = 0.2 sec, IM_Type_ID=171
RotD100, Period = 0.1 sec, IM_Type_ID=172

We also have geometric mean data:

Period = 10 sec, IM_Type_ID=1
Period = 5 sec, IM_Type_ID=11
Period = 3 sec, IM_Type_ID=21
Period = 2 sec, IM_Type_ID=26
Period = 1 sec, IM_Type_ID=86
Period = 0.5 sec, IM_Type_ID=88
Period = 0.2 sec, IM_Type_ID=94
Period = 0.1 sec, IM_Type_ID=99

Duration data has different IM Types:

acceleration significant duration, 5% to 75%, X component, IM_Type_ID=176
acceleration significant duration, 5% to 95%, X component, IM_Type_ID=177
velocity significant duration, 5% to 75%, X component, IM_Type_ID=178
velocity significant duration, 5% to 95%, X component, IM_Type_ID=179
acceleration significant duration, 5% to 75%, X component, IM_Type_ID=180
acceleration significant duration, 5% to 95%, X component, IM_Type_ID=181
velocity significant duration, 5% to 75%, X component, IM_Type_ID=182
velocity significant duration, 5% to 95%, X component, IM_Type_ID=183

In the above example, I have asked MySQL to order them in decreasing IM_Value, so the largest PSA values are at the top. Since the query would return about 400,000 values, I've also added the 'limit 100' so I only get the top 100 values.

If you run this query, you should get source 244, rupture 12, rupture variation 25 as your largest RotD50 PSA at 3 seconds. If you wanted to learn more about this rupture, you could run the following query:

select * from Ruptures
where ERF_ID=36 and Source_ID=244 and Rupture_ID=12;

You'll see it's a Puente Hills rupture, with magnitude 7.25 and probability ~1.97e-06. The probability of the rupture is divided evenly among its rupture variations.

If you wanted to get the distance from LADT to this rupture, you could run the following query:

select SR.Site_Rupture_Dist
from CyberShake_Site_Ruptures SR, CyberShake_Sites S
where S.CS_Short_Name="LADT"
and S.CS_Site_ID=SR.CS_Site_ID
and SR.ERF_ID=36
and SR.Source_ID=244
and SR.Rupture_ID=12;

This will give you the shortest distance from the site to any part of the rupture surface, in km.