Changes between Version 7 and Version 8 of UCERF3FaultSystemSolutions


Ignore:
Timestamp:
May 5, 2014, 3:23:46 PM (10 years ago)
Author:
Kevin Milner
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • UCERF3FaultSystemSolutions

    v7 v8  
    11= UCERF3 Fault System Solutions =
    22
    3 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].
     3UCERF3 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"].
    44
    55== Individual Branches - Compound Fault System Solution ==
    … …  
    99http://opensha.usc.edu/ftp/ucerf3_erf/full_ucerf3_compound_sol.zip
    1010
    11 The file format is described [aultSystemSolution#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.
     11The 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.
    1212
    1313If 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:
    … …  
    1515http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs/2013_05_10-ucerf3p3-production-10runs_COMPOUND_SOL_WITH_IND_RUNS.zip
    1616
    17 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 [FaultSystemSolution#Doublearraybinaryfile double array binary file format].
     17If 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].
    1818
    1919=== Single Solution Extraction Utility ===
    … …  
    2121A 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
    2222
    23 You then must run the following java class with all required arguments: scratch.UCERF3.utils.CompoundSolBranchExtractor <compound-sol-file> <branch> <output>
     23You then must run the following java class with all required arguments: scratch.UCERF3.utils.!CompoundSolBranchExtractor <compound-sol-file> <branch> <output>
    2424
    2525Arguments:
    2626* '''<compound-sol-file>''' - Path to compound solution zip file downloaded previously
    27 * '''<branch>''' - Logic tree branch to extract. Branch choices should be separated by underscores in a single string as described [RunningUCERF3Inversions#LogicTreeBranchNames here]. Example: FM3_1_ZENGBB_Shaw09Mod_DsrTap_CharConst_M5Rate7.9_MMaxOff7.6_NoFix_SpatSeisU3
     27* '''<branch>''' - 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
    2828* '''<output>''' - Path to output directory, or fully qualified file name. If directory is supplied, file name will be generated automatically from branch choices.
    2929
    … …  
    4848Branch averaged solutions are also available for various subsets of the logic tree:
    4949
    50 * Each Fault Model/Deformation Model: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs_fm_dm_sub_plots/
    51 * 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/
     50* Each Fault !Model/Deformation Model: http://opensha.usc.edu/ftp/kmilner/ucerf3/2013_05_10-ucerf3p3-production-10runs_fm_dm_sub_plots/
     51* 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/
    5252
    5353== "True Mean" solution ==
    5454
    55 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 [UCERF3%20ERFs#MeanUCERF3ERF MeanUCERF3 ERF] uses this file and also allows the user to apply various approximations to further reduce the rupture count.
     55A 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.
    5656
    5757Note: 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.