Changes between Version 10 and Version 11 of FaultSystemSolution

Timestamp:

May 5, 2014, 3:50:18 PM (10 years ago)

Author:

Kevin Milner

Comment:

--

FaultSystemSolution

@@ -11 +11 @@
 ||'''grid_sources.xml'''||[#GridSourcesXMLfile XML]||yes||This XML file, if present, gives gridded seismicity MFDs at each node in the region that this solution covers.||
 ||'''grid_sources_reg.xml'''||[#GridSourcesXMLfile XML]||yes||This XML file, if present, gives the region associated with gridded seismicity MFDs. Used in conjunction with '''grid_sources.bin''' and a more space efficient alternative to '''grid_sources.xml'''||
-||'''grid_sources.bin'''||[#GridSourcesXMLfile Double array list binary]||yes||This binary file, if present, gives gridded seismicity MFDs at each node in the region described in '''grid_sources_xml'''.||
+||'''grid_sources.bin'''||[#GridSourcesBinaryfile Double array list binary]||yes||This binary file, if present, gives gridded seismicity MFDs at each node in the region described in '''grid_sources_xml'''.||
 ||'''info.txt'''||ASCII||yes||This text file, if present, contains metadata describing the solution.||
 ||'''mags.bin'''||[#Doublearraybinaryfile Double array binary]||no||This file gives magnitudes for each rupture. It contains one double value for each rupture index, in order.||
@@ -111 +111 @@
 ''NOTE 1: UCERF3 uses the RELM region evenly discretized at 0.1 degrees for gridded seismicity. Due to the complexities involved in reproducing our gridding exactly, a file is posted here with grid node indexes and locations for this region: http://opensha.usc.edu/ftp/kmilner/ucerf3/relm_gridded_region.csv''
 
-''NOTE 2: This file is now deprecated as it is very large and does not compress well. The newer version of the file, grid_sources.xml, just contains the evenlyGriddedGeographicRegion region element below and uses a [#asdf binary format].''
+''NOTE 2: This file is now deprecated as it is very large and does not compress well. The newer version of the file, grid_sources.xml, just contains the evenlyGriddedGeographicRegion region element below and uses a [#GridSourcesBinaryfile binary format].''
 
 {{{
@@ -187 +187 @@
 === Grid Sources Binary file ===
 
+This is a binary representation of grid source MFDs. All values are stored in a binary format (8-bit big endian floating point values) as a list of double arrays.
+
+First, the number of total arrays is written, this is two times the number of grid nodes plus one, for the x values (which are only written once). The multiple of two is because each node has both an unassociated MFD (not associated with any faults) and an associated (associated with a fault) MFD.
+
+For example, the 7636 grid nodes used for UCERF3 would write (7636 * 2) + 1 = 15273 arrays.
+
+Then each array is written first with a 4-bit integer for the size of the array, followed by each 8-bit big endian value in the array. Empty arrays (size zero) mean that there is no MFD at that node (for example, many nodes do not have any faults and do not have an unassociated MFD).
+
+Lets consider a simple example with 2 grid nodes (note that actual grid source MFDs are discretized more finely). For simplicity, the y values are identical for each case:
+
+Node 1:
+Unssociated:
+||= x =||= y =||
+||5.0||0.5||
+||5.5||0.1||
+||6.0||1e-2||
+||6.5||3e-5||
+||7.0||1e-8||
+||7.5||1e-11||
+Associated sub seismogenic:
+null
+
+Node 1:
+Unssociated:
+||= x =||= y =||
+||5.0||0.5||
+||5.5||0.1||
+||6.0||1e-2||
+||6.5||3e-5||
+||7.0||1e-8||
+||7.5||1e-11||
+Associated sub seismogenic:
+||= x =||= y =||
+||5.0||0.5||
+||5.5||0.1||
+||6.0||1e-2||
+||6.5||3e-5||
+||7.0||1e-8||
+||7.5||1e-11||
+
+These would be written to the file as:
+
+'''[[span(style=color: #FF0000, 5)]] [[span(style=color: #0000FF, 6)]] [[span(style=color: #00FFFF, 5.0 5.5 6.5 7.0 7.5)]] [[span(style=color: #0000FF, 6)]] [[span(style=color: #FFBF00, 0.5 0.1 1e-2 3e-5 1e-8 1e-11)]] [[span(style=color: #0000FF, 0)]] [[span(style=color: #0000FF, 6)]] [[span(style=color: #FFBF00, 0.5 0.1 1e-2 3e-5 1e-8 1e-11)]] [[span(style=color: #0000FF, 6)]] [[span(style=color: #FFBF00, 0.5 0.1 1e-2 3e-5 1e-8 1e-11)]]'''
+
 === MFD Binary File ===
 Some mean (across multiple logic tree branches) solutions may contain Magnitude Frequency Distributions for each rupture. In this case, the rates.bin file will contain total rates and mags.bin will contain weighted average magnitudes. These MFDs can be used to more accurately represent the mean of multiple solutions instead of using the mean magnitude. They are written as a series of double arrays, with x values and y values separated into individual arrays. For example, consider these two functions: