wiki:UCERF3FaultSystemSolutions

Version 5 (modified by Kevin Milner, 10 years ago) (diff)

--

UCERF3 Fault System Solutions

UCERF3 data is stored in the FaultSystemSolution file format. There are a variety of solution files available to users, and different applications require different files. These files can be used with the ERFs?.

Individual Branches - Compound Fault System Solution

If you need results for one or more individual UCERF3 logic tree branches, you must use the UCERF3 Compound Fault System Solution file. This file can be downloaded here:

​http://opensha.usc.edu/ftp/ucerf3_erf/full_ucerf3_compound_sol.zip

The file format is described ​here. It does not contain the grid sources xml file for each branch. If this is needed, you can use the extraction utility described below.

If you need access to individual inversions for a single branch (UCERF3 averages 10 inversion runs per branch), you will need this files which contains rates.bin files for each run:

​http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs/2013_05_10-ucerf3p3-production-10runs_COMPOUND_SOL_WITH_IND_RUNS.zip

If you are interested in how the UCERF3 waterlevel affects results, you may also be interested in ​this zip file which contains two files per inversion per branch. The *_run*.bin files contain the rates for each rupture, similar to the previous file. The *_run*_noMinRates.bin files contain the inverted rates before the waterlevel was added back in. To recover the waterlevel, subtract values from *_run*_noMinRates.bin from the *_run*.bin files. These files are in our ​double array binary file format.

Single Solution Extraction Utility

A java utility has been provided to aid with the extraction of single logic tree branches from a Compound Fault System Solution. First, you must either obtain OpenSHA source code and build yourself (see SettingUpEclipse) or you can download the latest complete distribution jar file from here: ​http://opensha.usc.edu/dev/opensha-complete/nightly/opensha-complete.jar

You then must run the following java class with all required arguments: scratch.UCERF3.utils.CompoundSolBranchExtractor? <compound-sol-file> <branch> <output>

Arguments:

  • <compound-sol-file> - Path to compound solution zip file downloaded previously
  • <branch> - Logic tree branch to extract. Branch choices should be separated by underscores in a single string as described ​here. Example: FM3_1_ZENGBB_Shaw09Mod_DsrTap_CharConst_M5Rate7.9_MMaxOff7.6_NoFix_SpatSeisU3
  • <output> - Path to output directory, or fully qualified file name. If directory is supplied, file name will be generated automatically from branch choices.

Example to write the reference branch to /tmp: 

java -Xmx4G /path/to/OpenSHA_complete.jar scratch.UCERF3.utils.CompoundSolBranchExtractor /path/to/full_ucerf3_compound_sol.zip FM3_1_ZENGBB_Shaw09Mod_DsrTap_CharConst_M5Rate7.9_MMaxOff7.6_NoFix_SpatSeisU3 /tmp/

Note that this will not work for files greater than 4.1 GB (ZIP64 files). If you see an error relating to an invalid header, this is likely the problem.

Branch Averaged Solution

These solutions are an approximate mean model for a single Fault Model. Each rupture rate, magnitude, and rake is the weighted mean of all 720 time independent logic tree branches for that Fault Model. This means that magnitude and rake variability is discarded for a single mean value. Additionally, fault geometries can vary between logic tree branches due to aseismicity factors - this solution uses aseismicity factors derived from branch averaged slip rates. They are useful for quick calculations, but can vary substantially from the true model especially near dipping faults with variable aseismicity among logic tree branches.

Time independent hazard curves calculated with these solutions will differ from true mean (curves that were calculated for each logic tree branch independently then averaged) by 0-7%. Gridded seismicity contained in these solutions is weight averaged and captures the true mean perfectly.

They can be downloaded here: