Difference between revisions of "Broadband File Format Guide"

From SCECpedia
Jump to navigationJump to search
Line 37: Line 37:
  
 
==== Station List (STL file) ====
 
==== Station List (STL file) ====
 +
 +
Below is a sample STL file, with the stations used in the Loma Prieta earthquake (located in the San Francisco Bay Area):
  
 
<pre>
 
<pre>
#BBP Station List for EQID=118 (Loma Prieta)
+
#BBP Station List for Loma Prieta
#SLong    SLat    RSN  Rrup(km)  Vs30(m/s) LoPass_Freq(Hz) HiPass_Freq(Hz)
+
#SLong    SLat    RSN  Vs30(m/s) LoPass_Freq(Hz) HiPass_Freq(Hz)
-121.803 37.050  8001-CLS   3.9   462 0.1866  111.1111
+
-121.803 37.050  8001-CLS  462 0.1866  111.1111
-122.010 37.172  8002-LGP   3.9   515 0.3012  111.1111
+
-122.010 37.172  8002-LGP  515 0.3012  111.1111
-121.991 37.202  8003-LEX  5.0  1070 0.0984  111.1111
+
-121.991 37.202  8003-LEX  1070 0.0984  111.1111
-122.031 37.255  8004-STG   8.5   387 0.1422  111.1111
+
-122.031 37.255  8004-STG  387 0.1422  111.1111
-122.009 37.262  8005-WVC   9.3   387 0.1263  111.1111
+
-122.009 37.262  8005-WVC  387 0.1263  111.1111
-121.572 36.973  8006-G01  9.6  1428 0.2584  111.1111
+
-121.572 36.973  8006-G01  1428 0.2584  111.1111
-121.568 36.973  8007-GIL  10.0  730 0.2732  111.1111
+
-121.568 36.973  8007-GIL  730 0.2732  111.1111
-121.984 37.047  8008-BRN  10.7  353 0.2611  111.1111
+
-121.984 37.047  8008-BRN  353 0.2611  111.1111
-121.569 37.009  8009-GOF  11.0  387 0.2268  111.1111
+
-121.569 37.009  8009-GOF  387 0.2268  111.1111
-121.536 36.987  8010-G03  12.8  350 0.1248  111.1111
+
-121.536 36.987  8010-G03  350 0.1248  111.1111
-121.803 37.210  8011-SJTE  14.7  672 0.1085  111.1111
+
-121.803 37.210  8011-SJTE  672 0.1085  111.1111
-121.995 36.972  8012-WAH  17.5  390 0.2174  111.1111
+
-121.995 36.972  8012-WAH  390 0.2174  111.1111
-121.484 37.026  8020-G06  18.3  663 0.3012  111.1111
+
-121.484 37.026  8020-G06  663 0.3012  111.1111
-122.060 37.001  8016-LOB  18.4  714 0.2058  111.1111
+
-122.060 37.001  8016-LOB  714 0.2058  111.1111
-122.062 37.001  8014-UC2  18.5  714 0.4348  111.1111
+
-122.062 37.001  8014-UC2  714 0.4348  111.1111
-121.628 37.166  8021-ADL  20.3  489 0.1767  111.1111
+
-121.628 37.166  8021-ADL  489 0.1767  111.1111
-121.628 37.166  8022-AND  20.3  489 0.2674  111.1111
+
-121.628 37.166  8022-AND  489 0.2674  111.1111
-121.550 37.118  8026-CYC  20.3  540 0.1639  111.1111
+
-121.550 37.118  8026-CYC  540 0.1639  111.1111
-121.434 37.033  8015-GMR  22.7  334 0.3077  111.1111
+
-121.434 37.033  8015-GMR  334 0.3077  111.1111
-121.397 36.848  8013-HSP  27.9  306 0.1439  111.1111
+
-121.397 36.848  8013-HSP  306 0.1439  111.1111
-121.446 36.765  8025-SGI  30.2  748 0.1263  111.1111
+
-121.446 36.765  8025-SGI  748 0.1263  111.1111
-122.210 37.420  8017-SLC  30.9  425 0.3077  111.1111
+
-122.210 37.420  8017-SLC  425 0.3077  111.1111
-121.642 36.671  8024-SJW  32.8  353 0.1277  111.1111
+
-121.642 36.671  8024-SJW  353 0.1277  111.1111
-122.258 37.429  8019-WDS  34.1  454 0.1222  111.1111
+
-122.258 37.429  8019-WDS  454 0.1222  111.1111
-121.395 36.753  8018-SG3  34.3  609 0.1263  111.1111
+
-121.395 36.753  8018-SG3  609 0.1263  111.1111
-121.807 37.452  8023-CLR  35.5  540 0.1453  111.1111
+
-121.807 37.452  8023-CLR  540 0.1453  111.1111
-122.308 37.512  8040-BES  44.1  628 0.2151  111.1111
+
-122.308 37.512  8040-BES  628 0.2151  111.1111
-121.880 37.597  8032-SUF  47.6  401 0.1236  111.1111
+
-121.880 37.597  8032-SUF  401 0.1236  111.1111
-122.361 37.529  8028-XSP  48.4  782 0.3012  111.1111
+
-122.361 37.529  8028-XSP  782 0.3012  111.1111
-121.249 36.658  8036-BVW  51.0  331 0.1133  111.1111
+
-121.249 36.658  8036-BVW  331 0.1133  111.1111
-122.061 37.657  8030-A3E  52.5  517 0.3040  111.1111
+
-122.061 37.657  8030-A3E  517 0.3040  111.1111
-121.932 37.709  8037-DFS  58.8  353 0.1038  111.1111
+
-121.932 37.709  8037-DFS  353 0.1038  111.1111
-121.184 36.573  8027-BVF  61.7  353 0.3390  111.1111
+
-121.184 36.573  8027-BVF  353 0.3390  111.1111
-121.143 36.532  8038-BVR  67.5  304 0.1639  111.1111
+
-121.143 36.532  8038-BVR  304 0.1639  111.1111
-121.043 36.569  8033-BVU  71.4  390 0.2500  111.1111
+
-121.043 36.569  8033-BVU  390 0.2500  111.1111
-122.391 37.786  8029-RIN  74.1  873 0.2976  111.1111
+
-122.391 37.786  8029-RIN  873 0.2976  111.1111
-122.513 37.778  8031-CFH  78.7  782 0.2398  111.1111
+
-122.513 37.778  8031-CFH  782 0.2398  111.1111
-122.249 37.876  8034-BRK  79.2  609 0.2398  111.1111
+
-122.249 37.876  8034-BRK  609 0.2398  111.1111
-122.476 37.808  8035-GGB  79.8  653 0.2421  111.1111
+
-122.476 37.808  8035-GGB  653 0.2421  111.1111
-122.527 37.822  8039-PTB 83.5 1316 0.2941  111.1111
+
-122.527 37.822  8039-PTB  1316 0.2941  111.1111
 
</pre>
 
</pre>
  

Revision as of 22:38, 30 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.

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)

Below is a sample STL file, with the stations used in the Loma Prieta earthquake (located in the San Francisco Bay Area):

#BBP Station List for Loma Prieta
#SLong    SLat     RSN   Vs30(m/s) LoPass_Freq(Hz) HiPass_Freq(Hz)
-121.803 37.050  8001-CLS   462 0.1866  111.1111
-122.010 37.172  8002-LGP   515 0.3012  111.1111
-121.991 37.202  8003-LEX   1070 0.0984  111.1111
-122.031 37.255  8004-STG   387 0.1422  111.1111
-122.009 37.262  8005-WVC   387 0.1263  111.1111
-121.572 36.973  8006-G01   1428 0.2584  111.1111
-121.568 36.973  8007-GIL  730 0.2732  111.1111
-121.984 37.047  8008-BRN  353 0.2611  111.1111
-121.569 37.009  8009-GOF  387 0.2268  111.1111
-121.536 36.987  8010-G03  350 0.1248  111.1111
-121.803 37.210  8011-SJTE  672 0.1085  111.1111
-121.995 36.972  8012-WAH  390 0.2174  111.1111
-121.484 37.026  8020-G06  663 0.3012  111.1111
-122.060 37.001  8016-LOB  714 0.2058  111.1111
-122.062 37.001  8014-UC2  714 0.4348  111.1111
-121.628 37.166  8021-ADL  489 0.1767  111.1111
-121.628 37.166  8022-AND  489 0.2674  111.1111
-121.550 37.118  8026-CYC  540 0.1639  111.1111
-121.434 37.033  8015-GMR  334 0.3077  111.1111
-121.397 36.848  8013-HSP  306 0.1439  111.1111
-121.446 36.765  8025-SGI  748 0.1263  111.1111
-122.210 37.420  8017-SLC  425 0.3077  111.1111
-121.642 36.671  8024-SJW  353 0.1277  111.1111
-122.258 37.429  8019-WDS  454 0.1222  111.1111
-121.395 36.753  8018-SG3  609 0.1263  111.1111
-121.807 37.452  8023-CLR  540 0.1453  111.1111
-122.308 37.512  8040-BES  628 0.2151  111.1111
-121.880 37.597  8032-SUF  401 0.1236  111.1111
-122.361 37.529  8028-XSP  782 0.3012  111.1111
-121.249 36.658  8036-BVW  331 0.1133  111.1111
-122.061 37.657  8030-A3E  517 0.3040  111.1111
-121.932 37.709  8037-DFS  353 0.1038  111.1111
-121.184 36.573  8027-BVF  353 0.3390  111.1111
-121.143 36.532  8038-BVR  304 0.1639  111.1111
-121.043 36.569  8033-BVU  390 0.2500  111.1111
-122.391 37.786  8029-RIN  873 0.2976  111.1111
-122.513 37.778  8031-CFH  782 0.2398  111.1111
-122.249 37.876  8034-BRK  609 0.2398  111.1111
-122.476 37.808  8035-GGB  653 0.2421  111.1111
-122.527 37.822  8039-PTB  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>