= 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 [wiki:"UCERF3 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 [wiki:FaultSystemSolution#CompoundFaultSystemSolutionFiles 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 file 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 [http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs/2013_05_10-ucerf3p3-production-10runs-bins.zip 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 [wiki:FaultSystemSolution#Doublearraybinaryfile 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 Arguments: * '''''' - Path to compound solution zip file downloaded previously * '''''' - Logic tree branch to extract. Branch choices should be separated by underscores in a single string as described [wiki:RunningUCERF3Inversions#LogicTreeBranchNames here]. Example: FM3_1_ZENGBB_Shaw09Mod_DsrTap_CharConst_M5Rate7.9_MMaxOff7.6_NoFix_SpatSeisU3 * '''''' - 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 -cp /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 with older versions of java this may 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: * Fault Model 3.1: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs/2013_05_10-ucerf3p3-production-10runs_COMPOUND_SOL_FM3_1_MEAN_BRANCH_AVG_SOL.zip * Fault Model 3.2: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs/2013_05_10-ucerf3p3-production-10runs_COMPOUND_SOL_FM3_2_MEAN_BRANCH_AVG_SOL.zip Branch averaged solutions are also available for various subsets of the logic tree: * Each Fault !Model/Deformation Model: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs_fm_dm_sub_plots/ * Each Fault !Model/Deformation !Model/Scaling Relationship: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs_fm_dm_scale_sub_plots/ == "True Mean" solution == A different type of branch averaged solution, the "true mean" solution, is also available. They are similar to the branch averaged fault system solution described above, but instead use duplicate versions of each rupture whenever a key property (rake, magnitude, area) changes. This retains all variability allowing for quick reproduction of mean UCERF3 results with a minimum set of ruptures. The [wiki:"UCERF3 ERFs#MeanUCERF3ERF" MeanUCERF3 ERF] uses this file and also allows the user to apply various approximations to further reduce the rupture count. Note: These solutions ''are not compatible with time dependent UCERF3 calculations'' as multiple instances of each subsection may exist, resulting in rate partitioning between instances and incorrect recurrence intervals for renewal model calculations. * Both fault models combined: http://opensha.usc.edu/ftp/ucerf3_erf/mean_ucerf3_sol.zip * FM3.1 only: http://opensha.usc.edu/ftp/ucerf3_erf/FM3_1_mean_ucerf3_sol.zip * FM3.2 only: http://opensha.usc.edu/ftp/ucerf3_erf/FM3_2_mean_ucerf3_sol.zip