wiki:UCERF3TimeDepRateExtractor

Version 11 (modified by Kevin Milner, 9 years ago) (diff)

--

UCERF3 Time Dependent Rate Calculator

This is a command line utility for extracting time dependent probabilities and equivalent annualized rates from a UCERF3 Fault System Solution. You must have the Java Runtime Environment version 6 or greater installed on your machine and in your system path.

NOTE: This is only applicable to UCERF3 single branch or branch averaged solutions. It is not applicable to any "true mean" solutions which include alternative geometries for the same faults. Older versions of the branch averaged solutions files do not contain the necessary date of last event data built in and replacements should be downloaded from UCERF3FaultSystemSolutions. An error message will be displayed and the program will exit if one of these older files is used.

WARNING: This is provided as a service and is not exhaustively tested. No warranty is expressed or implied and by downloading this software you agree to the OpenSHA license/disclaimer.

Download Here

Command Line Arguments:

Short Long Required? Description
-d <arg>--duration <arg>yesForecast duration in years.
-y <arg>--start-year <arg>noForecast start year. Default: 2014
-h <arg>--hist-open-interval-basis <arg>noYear basis for historical openinterval. Default: 1875
-p <arg>--prob-model <arg>yesProbability model. One or more of U3_PREF_BLEND,POISSON,BPT_LOW,BPT_MID,BPT_HIGH. Multiple entries can be comma separated.
-s <arg>--solution <arg>yesInput Fault System Solution zip file
-o <arg>--output-file <arg>yesOutput file name
-b--binarynoOutput equivalent annualized rates binary file in FSS rates.bin format. Otherwise CSV format.
-a--filter-aftershocksnoApply aftershock filter
-i--ignore-no-date-lastnoSkips check that ensures date of last event data is set on at least some fault sections. Can be used to calculate time dependent probabilities using only the historical open interval.

Examples:

To create a CSV file with probabilities and equivalent annualized rates for for each probability model and a 5 year duration:

java -jar ProbDist-1.2.3-10437-2013_11_16.jar --duration 5 --start-year 2014 --solution /path/to/sol.zip --hist-open-interval-basis 1875 --prob-model  U3_PREF_BLEND,POISSON,BPT_LOW,BPT_MID,BPT_HIGH --output-file /path/to/output.csv

If you see any error messages that mention java heap space such as an "OutOfMemoryError?" then re-run the command with the -Xmx<MEMORY>G option directly after "java" above, replacing <MEMORY> with the amount of memory in gigabytes that is needed. "-Xmx4G" should be more than adequate if you run into problems.

Output:

The default output is in CSV format. A truncated example is shown below:

FSS IndexFSS Rate (1/yr)U3_PREF_BLEND 5yr ProbU3_PREF_BLEND Equiv Annual Rate (1/yr)POISSON 5yr ProbPOISSON Equiv Annual Rate (1/yr)BPT_LOW 5yr ProbBPT_LOW Equiv Annual Rate (1/yr)BPT_MID 5yr ProbBPT_MID Equiv Annual Rate (1/yr)BPT_HIGH 5yr ProbBPT_HIGH Equiv Annual Rate (1/yr)
03.467132332031594E-51.793458612422435E-43.58723891268711E-51.7334159121162873E-43.4671323320325144E-51.8084313326254846E-43.6171897470727085E-51.8084313408651135E-43.61718976355584E-51.80843236536894E-43.617191812934087E-5
11.581459767253252E-58.183057338995742E-51.6366784338797184E-57.906986217631751E-51.581459767253246E-58.25199517800363E-51.6504671347706292E-58.251995215616269E-51.650467142294121E-58.251999892318725E-51.6504680777120057E-5
21.1240237590986677E-55.818032401879599E-51.1636403311906143E-55.619960869773788E-51.1240237590983228E-55.8675107934387735E-51.1735365877163924E-55.867510793443612E-51.173536587718613E-55.8675108201986965E-51.1735365930702019E-5

Alternatively, if the "--binary" flag is supplied, the only equivalent annualized rates will be output in the Double Array Binary File Format. If multiple probability models are supplied, individual files will be output with the probability model name appended.