Changes between Version 2 and Version 3 of UCERF3FaultSystemSolutions

Timestamp:

May 5, 2014, 2:56:47 PM (10 years ago)

Author:

Kevin Milner

Comment:

--

UCERF3FaultSystemSolutions

@@ -18 +18 @@
 
 === 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 [http://opensha.usc.edu/trac/wiki/RunningUCERF3Inversions#LogicTreeBranchNames 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.''