This is a command line utility for extracting time dependent probabilities and equivalent annualized rates from a UCERF3 Fault System Solution.

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

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.

TODO: download instructions

Command Line Arguments:

Short	Long	Required?	Description
-d <arg>	--duration <arg>	yes	Forecast duration in years.
-y <arg>	--start-year <arg>	no	Forecast start year. Default: 2014
-h <arg>	--hist-open-interval-basis <arg>	no	Year basis for historical openinterval. Default: 1875
-p <arg>	--prob-model <arg>	yes	Probability 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>	yes	Input Fault System Solution zip file
-o <arg>	--output-file <arg>	yes	Output file name
-b	--binary	no	Output equivalent annualized rates binary file in FSS rates.bin format. Otherwise CSV format.
-a	--filter-aftershocks	no	Apply aftershock filter
-i	--ignore-no-date-last	no	Skips 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 TimeDepRateExtractor.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