Difference between revisions of "Broadband File Format Guide"
From SCECpedia
Jump to navigationJump to search| Line 2: | Line 2: | ||
==== SImple Source Description (SRC file) ==== | ==== SImple Source Description (SRC file) ==== | ||
| + | |||
| + | Below is a sample SRC file, used to describe the Loma Prieta earthquake in Northern California: | ||
<pre> | <pre> | ||
| Line 28: | Line 30: | ||
# | # | ||
SEED = 2379646 | SEED = 2379646 | ||
| + | </pre> | ||
| + | |||
| + | The first few parameters are used to specify the event magnitude and describe the rupture. FAULT_LENGTH is used to specify the extent of the fault plane in the along strike direction, while FAULT_WIDTH specifies the dimension of the fault plane in the down dip direction. DEPTH_TO_TOP specifies how deep the fault plane is located (zero means a surface rupture). LAT_TOP_CENTER and LON_TOP_CENTER specify the location of the top center point of the fault plane. HYPO_ALONG_STK and HYPO_DOWN_DIP specify the hypocenter location within the fault plane, with the (0, 0) coordinate being the TOP_CENTER of the fault plane. Therefore, HYPO_ALONG_STK goes from -(FAULT_LENGTH / 2) to (FAULT_LENGTH / 2), with zero being the mid-point of the fault plane. HYPO_DOWN_DIP starts at zero (top of the plane) and goes down to FAULT_WIDTH. All distances should be provided in kilometers (km). STRIKE, RAKE, and DIP are used to describe the fault mechanism and should be provided in degrees. | ||
| − | + | In the second part of the file, DWID and DLEN are used to provide the step interval (again, in kilometers) for the rupture creation. Smaller values will result in increased computation time. The CORNER_FREQ parameter is only used by the UCSB method. Finally, the SEED parameter enables randomization in the code (e.g. it allows different slip distributions to be generated). By using the same SEED parameter, users can generate reproducible results in the Broadband Platform. | |
==== Station List (STL file) ==== | ==== Station List (STL file) ==== | ||
Revision as of 23:33, 26 December 2013
This page describes the format for the files used in Broadband Platform Simulations. The simple source description (SRC file) and the station list (STL file) are inputs to the Broadband Platform simulations, and must be provided for every run. The velocity model file is part of a velocity model configuration package and is also an input to the platform. A single velocity model file can be shared among several simulations using the same region. The time history (BBP) file is produced by the Platform. The Broadband Platform workflow description (XML file) is an intermediate product of the Broadband Platform. It is produced automatically by the Platform, but can also be provided by the user in cases where script automation can be used to replace the interactive prompts of the Platform.
Contents
SImple Source Description (SRC file)
Below is a sample SRC file, used to describe the Loma Prieta earthquake in Northern California:
# # Loma Prieta source file # MAGNITUDE = 6.94 FAULT_LENGTH = 40.0 FAULT_WIDTH = 17.5 DEPTH_TO_TOP = 3.85 STRIKE = 128 RAKE = 145 DIP = 70 LAT_TOP_CENTER = 37.0789 LON_TOP_CENTER = -121.8410 HYPO_ALONG_STK = 0.0 HYPO_DOWN_DIP = 14.75 # # Model specific parameters # DWID = 0.1 DLEN = 0.1 CORNER_FREQ = 0.15 # # Alternative SEEDS create alternative .srf # SEED = 2379646
The first few parameters are used to specify the event magnitude and describe the rupture. FAULT_LENGTH is used to specify the extent of the fault plane in the along strike direction, while FAULT_WIDTH specifies the dimension of the fault plane in the down dip direction. DEPTH_TO_TOP specifies how deep the fault plane is located (zero means a surface rupture). LAT_TOP_CENTER and LON_TOP_CENTER specify the location of the top center point of the fault plane. HYPO_ALONG_STK and HYPO_DOWN_DIP specify the hypocenter location within the fault plane, with the (0, 0) coordinate being the TOP_CENTER of the fault plane. Therefore, HYPO_ALONG_STK goes from -(FAULT_LENGTH / 2) to (FAULT_LENGTH / 2), with zero being the mid-point of the fault plane. HYPO_DOWN_DIP starts at zero (top of the plane) and goes down to FAULT_WIDTH. All distances should be provided in kilometers (km). STRIKE, RAKE, and DIP are used to describe the fault mechanism and should be provided in degrees.
In the second part of the file, DWID and DLEN are used to provide the step interval (again, in kilometers) for the rupture creation. Smaller values will result in increased computation time. The CORNER_FREQ parameter is only used by the UCSB method. Finally, the SEED parameter enables randomization in the code (e.g. it allows different slip distributions to be generated). By using the same SEED parameter, users can generate reproducible results in the Broadband Platform.
Station List (STL file)
#BBP Station List for EQID=118 (Loma Prieta) #SLong SLat RSN Rrup(km) Vs30(m/s) LoPass_Freq(Hz) HiPass_Freq(Hz) -121.803 37.050 8001-CLS 3.9 462 0.1866 111.1111 -122.010 37.172 8002-LGP 3.9 515 0.3012 111.1111 -121.991 37.202 8003-LEX 5.0 1070 0.0984 111.1111 -122.031 37.255 8004-STG 8.5 387 0.1422 111.1111 -122.009 37.262 8005-WVC 9.3 387 0.1263 111.1111 -121.572 36.973 8006-G01 9.6 1428 0.2584 111.1111 -121.568 36.973 8007-GIL 10.0 730 0.2732 111.1111 -121.984 37.047 8008-BRN 10.7 353 0.2611 111.1111 -121.569 37.009 8009-GOF 11.0 387 0.2268 111.1111 -121.536 36.987 8010-G03 12.8 350 0.1248 111.1111 -121.803 37.210 8011-SJTE 14.7 672 0.1085 111.1111 -121.995 36.972 8012-WAH 17.5 390 0.2174 111.1111 -121.484 37.026 8020-G06 18.3 663 0.3012 111.1111 -122.060 37.001 8016-LOB 18.4 714 0.2058 111.1111 -122.062 37.001 8014-UC2 18.5 714 0.4348 111.1111 -121.628 37.166 8021-ADL 20.3 489 0.1767 111.1111 -121.628 37.166 8022-AND 20.3 489 0.2674 111.1111 -121.550 37.118 8026-CYC 20.3 540 0.1639 111.1111 -121.434 37.033 8015-GMR 22.7 334 0.3077 111.1111 -121.397 36.848 8013-HSP 27.9 306 0.1439 111.1111 -121.446 36.765 8025-SGI 30.2 748 0.1263 111.1111 -122.210 37.420 8017-SLC 30.9 425 0.3077 111.1111 -121.642 36.671 8024-SJW 32.8 353 0.1277 111.1111 -122.258 37.429 8019-WDS 34.1 454 0.1222 111.1111 -121.395 36.753 8018-SG3 34.3 609 0.1263 111.1111 -121.807 37.452 8023-CLR 35.5 540 0.1453 111.1111 -122.308 37.512 8040-BES 44.1 628 0.2151 111.1111 -121.880 37.597 8032-SUF 47.6 401 0.1236 111.1111 -122.361 37.529 8028-XSP 48.4 782 0.3012 111.1111 -121.249 36.658 8036-BVW 51.0 331 0.1133 111.1111 -122.061 37.657 8030-A3E 52.5 517 0.3040 111.1111 -121.932 37.709 8037-DFS 58.8 353 0.1038 111.1111 -121.184 36.573 8027-BVF 61.7 353 0.3390 111.1111 -121.143 36.532 8038-BVR 67.5 304 0.1639 111.1111 -121.043 36.569 8033-BVU 71.4 390 0.2500 111.1111 -122.391 37.786 8029-RIN 74.1 873 0.2976 111.1111 -122.513 37.778 8031-CFH 78.7 782 0.2398 111.1111 -122.249 37.876 8034-BRK 79.2 609 0.2398 111.1111 -122.476 37.808 8035-GGB 79.8 653 0.2421 111.1111 -122.527 37.822 8039-PTB 83.5 1316 0.2941 111.1111
Time History (BBP File)
% -------------------------------------------------- % synthetic broadband seismogram (Mai&Olsen 2008) % N = 8 header lines % site: 5017-A-GLP % NPTS, DT: 10922 0.009372998029 % % time(s) NS (cm/s) EW(cm/s) UP (cm/s) % -------------------------------------------------- 0.00000 0.00000E+00 0.00000E+00 0.00000E+00 0.00937 0.00000E+00 0.00000E+00 0.00000E+00 0.01875 0.00000E+00 0.00000E+00 0.00000E+00 0.02812 0.00000E+00 0.00000E+00 0.00000E+00 0.03749 0.00000E+00 0.00000E+00 0.00000E+00 … 4.82709 0.13824E-01 -0.44237E-02 -0.41983E-02 4.83647 0.64276E-01 -0.24146E-01 -0.31487E-01 4.84584 0.10083E+00 -0.45090E-01 -0.74688E-01 4.85521 0.93571E-01 -0.50971E-01 -0.10271E+00 4.86459 0.74907E-01 -0.51622E-01 -0.12331E+00 4.87396 0.55531E-01 -0.51775E-01 -0.14432E+00 … 102.32502 0.11583E+00 0.26702E-01 0.93545E-01 102.33439 0.11322E+00 0.26290E-01 0.92550E-01 102.34377 0.11017E+00 0.25777E-01 0.91201E-01 102.35314 0.10671E+00 0.25165E-01 0.89504E-01 102.36251 0.10283E+00 0.24455E-01 0.87463E-01
Velocity Model File
18 0.0020 1.7000 0.4500 2.0000 45.00 22.50 0.0040 1.8000 0.6500 2.1000 65.00 32.50 0.0060 1.8000 0.8500 2.1000 85.00 42.50 0.0080 1.9000 0.9500 2.1000 95.00 47.50 0.0100 2.0000 1.1500 2.2000 115.00 57.50 0.0700 2.4000 1.2000 2.2000 120.00 60.00 0.2000 2.8000 1.4000 2.3000 140.00 70.00 0.2000 3.1000 1.6000 2.4000 160.00 80.00 0.2000 3.4000 1.8000 2.4500 180.00 90.00 0.3000 3.7000 2.1000 2.5000 210.00 105.00 2.0000 4.4000 2.4000 2.6000 240.00 120.00 2.0000 5.1000 2.8000 2.7000 280.00 140.00 1.0000 5.6000 3.1500 2.7500 315.00 157.50 5.0000 6.1500 3.6000 2.8250 360.00 180.00 5.0000 6.3200 3.6500 2.8500 365.00 182.50 5.0000 6.5500 3.7000 2.9000 370.00 185.00 10.0000 6.8000 3.8000 2.9500 380.00 190.00 999.0000 7.8000 4.5000 3.2000 450.00 225.00
Broadband Platform Workflow Description (XML File)
<BBP_Run_Specification> <Validation_Run event="WHITTIER" input_station_file="$BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl" subset="false"/> <BBP_Modules> <BBP_Module> <name> Genslip </name> <staged_files> <file> $BBP_INSTALL_GF/LABasin/gp/genslip_nr_generic1d-gp01.vmod </file> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> </staged_files> <arguments> <argument type="str"> genslip_nr_generic1d-gp01.vmod </argument> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> whittier_v12_11_0_sdsu.srf </argument> <argument type="str"> LABasin </argument> </arguments> </BBP_Module> <BBP_Module> <name> Jbsim </name> <staged_files> <file> $BBP_INSTALL_GF/LABasin/gp/genslip_nr_generic1d-gp01.vmod </file> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> genslip_nr_generic1d-gp01.vmod </argument> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> whittier_v12_11_0_sdsu.srf </argument> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> LABasin </argument> </arguments> </BBP_Module> <BBP_Module> <name> BBToolbox </name> <staged_files> <file> $BBP_INSTALL_GF/LABasin/sdsu/sdsu-apr2013-labasin-vmod.txt </file> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> </argument> <argument type="str"> sdsu-apr2013-labasin-vmod.txt </argument> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> whittier_v12_11_0_sdsu.srf </argument> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> LABasin </argument> </arguments> </BBP_Module> <BBP_Module> <name> CopySeismograms </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> </arguments> <keyword_arguments> <keyword_argument keyword="hybrid" type="bool"> True </keyword_argument> </keyword_arguments> </BBP_Module> <BBP_Module> <name> Plot_Map </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> whittier_v13_3_1.stl </argument> </arguments> </BBP_Module> <BBP_Module> <name> PlotSeis </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="bool"> True </argument> <argument type="bool"> True </argument> </arguments> </BBP_Module> <BBP_Module> <name> Respect </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> </arguments> </BBP_Module> <BBP_Module> <name> RotD50 </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> </arguments> </BBP_Module> <BBP_Module> <name> ObsSeismograms </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> <file> $BBP_INSTALL_VAL/Whittier/ucb/whittier_v13_3_1-corrections.txt </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> $BBP_INSTALL_VAL/Whittier/ucb/AccPEER3 </argument> <argument type="str"> acc_peer </argument> <argument type="str"> whittier_v13_3_1-corrections.txt </argument> </arguments> </BBP_Module> <BBP_Module> <name> GMPEComparison </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> WHITTIER </argument> <argument type="str"> metadata.txt </argument> <argument type="bool"> True </argument> </arguments> </BBP_Module> <BBP_Module> <name> GenPlots </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> $BBP_INSTALL_VAL/Whittier/ucb/AccPEER3 </argument> <argument type="str"> acc </argument> <argument type="str"> WHITTIER </argument> </arguments> </BBP_Module> <BBP_Module> <name> GPGof </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/sdsu/whittier_v12_11_0_sdsu.src </file> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v12_11_0_sdsu.src </argument> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> metadata.txt </argument> <argument type="str"> $BBP_INSTALL_VAL/Whittier/ucb/AccPEER3 </argument> <argument type="str"> acc </argument> <argument type="float"> 5.89 </argument> <argument type="str"> WHITTIER </argument> <argument type="int"> 50 </argument> </arguments> <keyword_arguments> <keyword_argument keyword="single_component" type="bool"> False </keyword_argument> </keyword_arguments> </BBP_Module> <BBP_Module> <name> GenHTML </name> <staged_files> <file> $BBP_INSTALL_VAL/Whittier/gp/whittier_v13_3_1.stl </file> </staged_files> <arguments> <argument type="str"> whittier_v13_3_1.stl </argument> <argument type="str"> LABasin </argument> <argument type="str"> WHITTIER </argument> <argument type="str"> metadata.txt </argument> </arguments> </BBP_Module> </BBP_Modules> </BBP_Run_Specification>
