org.opensha.sha.earthquake.rupForecastImpl.WGCEP_UCERF_2_Final
Class FaultSegmentData

java.lang.Object
  extended by org.opensha.sha.earthquake.rupForecastImpl.WGCEP_UCERF_2_Final.FaultSegmentData
All Implemented Interfaces:
Serializable

public class FaultSegmentData
extends Object
implements Serializable

Author:
Vipin Gupta and Ned Field
See Also:
Serialized Form

Constructor Summary
FaultSegmentData(ArrayList sectionToSegmentData, String[] segNames, boolean aseisReducesArea, String faultName, ArrayList<SegRateConstraint> segRateConstraints, ArrayList<SegmentTimeDepData> segTimeDepDataList)
          Description: This class contains data for one or more contiguous fault segments, where each segment is composed of one or more contiguous fault sections (or FaultSectionPrefData objects).
 
Method Summary
 double getAveRake()
          Get Ave rake for the ALL Segments
 double getAveRake(int[] segIndex)
          Get Ave rake for the selected Segments.
 double getAveSegAseisFactor(int index)
          This returns the average aseismcity factor for the ith segment
 UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(double gridSpacing)
          Get StirlingGriddedSurface for ALL Segments.
 UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(double gridSpacing, double increaseDDW_Factor)
          Get StirlingGriddedSurface for ALL Segments.
 UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(int[] segIndex, double gridSpacing)
          Get StirlingGriddedSurface for selected Segment indices.
 UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(int[] segIndex, double gridSpacing, double increaseDDW_Factor)
          Get StirlingGriddedSurface for selected Segment indices.
 String getFaultName()
          This returns the name of the fault.
 int getNumSegments()
          Get the number of segments in this model
 double getOrigSegmentArea(int index)
          Get original segment area by index - SI units (note that this is NOT reduce by any aseismicity factors)
 double getOrigSegmentDownDipWidth(int index)
          Get original segment down-dip-width - SI units (note that this is NOT reduce by any aseismicity factors)
 ArrayList getPrefFaultSectionDataList()
          Get a list of FaultSectionPrefData for selected fault model (Not sure if this is the best place for this because the info can be accessed from a returned FaultSegmentData object)
 double getRecurInterval(int segIndex)
          Computes the mean recur interval for a segment (as 1/getSegRateMean(segIndex)).
 double getRecurIntervalSigma(int index)
          Computes the standard deviation of the mean recur interval for a segment (using standard error propagation from getSegRateStdDevOfMean and getSegRateMean).
 String getSectionsInSeg(int index)
          Get segment name as a concatenated String of section names by index
 ArrayList getSectionToSegmentData()
          an ArrayList containing N ArrayLists (one for each segment), where the arrayList for each segment contains some number of FaultSectionPrefData objects.
 double getSegAperiodicity(int index)
           
 double getSegAveSlipInLastEvent(int index)
           
 double getSegCalYearOfLastEvent(int index)
           
 double getSegLower95Conf(int index)
          This returns the lower 95% confidence of segment rate (highest value is returned if more than one value on the segment).
 double getSegmentArea(int index)
          Get segment area by index - SI units (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is true)
 double getSegmentLength(int index)
          Get segment length by index.
 double getSegmentMomentRate(int index)
          Get segment moment rate by index (note that this is reduce by any non-zero aseismicity factors)
 String getSegmentName(int index)
          Get segment name by index
 String[] getSegmentNames()
          Get an array of all segment names
 double getSegmentSlipRate(int index)
          Get segment slip rate by index (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is false)
 ArrayList<SegRateConstraint> getSegRateConstraints()
          Get the segment Rates
 ArrayList<SegRateConstraint> getSegRateConstraints(int index)
          Get the rates for the sepcified segment index.
 double getSegRateMean(int index)
          This returns the mean segment rate (wt averaged if more than one constraint on the segment).
 double getSegRateStdDevOfMean(int index)
          This returns the standard deviation of the mean segment rate (wt averaged if more than one constraint on the segment).
 double getSegSlipRateStdDev(int index)
          Get Standard deviation for the slip rate by index
 SegmentTimeDepData getSegTimeDependentData(int index)
          Get Time Dependent data for specified segment index
 double getSegUpper95Conf(int index)
          This returns the upper 95% confidence of segment rate (lowest value is returned if more than one value on the segment).
 double getTotalArea()
          Get the total area of all segments combined (note that this is reduced by any non-zero aseismicity factors if aseisReducesArea is true)
 double getTotalAveAseismicityFactor()
          Get the average aseismicity factor (computed as final total moment rate divided by original total moment rate)
 double getTotalAveSlipRate()
          Get total ave slip rate - wt averaged by area (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is false)
 double getTotalLength()
          Get total length of all segments combined.
 double getTotalMomentRate()
          Get total Moment rate for all segments combined (note that this is reduce by any non-zero aseismicity factors)
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FaultSegmentData

public FaultSegmentData(ArrayList sectionToSegmentData,
                        String[] segNames,
                        boolean aseisReducesArea,
                        String faultName,
                        ArrayList<SegRateConstraint> segRateConstraints,
                        ArrayList<SegmentTimeDepData> segTimeDepDataList)
Description: This class contains data for one or more contiguous fault segments, where each segment is composed of one or more contiguous fault sections (or FaultSectionPrefData objects). This class also provides various derived data. Note that areas (or slip rates if aseisReducesArea is false) will be reduced by any non-zero fault-section aseimicity factors; the same is true for any values derived from these. Segment slip rates represent a weight-average over the sections, where the weights are section areas (and aseismicity factors are applied as specified). All data provided in the get methods are in SI units, which generally differs from the units in the input. This has special treatment for the San Jacinto and Elsinore faults, where the overlapping sections are removed when creating the combined gridded surface. Specifically, the sections containing "stepover" in the name are not included if both stepovers are included in the list of segments. This only influences what's returned from the getCombinedGriddedSurface(*) methods.

Parameters:
sectionToSegmentData - - an ArrayList containing N ArrayLists (one for each segment), where the arrayList for each segment contains some number of FaultSectionPrefData objects. It is assumed that these are in proper order such that concatenating the FaultTraces will produce a total FaultTrace with locations in the proper order.
aseisReducesArea - - if true apply asiesmicFactor as reduction of area, otherwise it reduces slip rate
Method Detail

getSectionToSegmentData

public ArrayList getSectionToSegmentData()
an ArrayList containing N ArrayLists (one for each segment), where the arrayList for each segment contains some number of FaultSectionPrefData objects. It is assumed that these are in proper order such that concatenating the FaultTraces will produce a total FaultTrace with locations in the proper order.

Returns:

getFaultName

public String getFaultName()
This returns the name of the fault.

Returns:

getTotalArea

public double getTotalArea()
Get the total area of all segments combined (note that this is reduced by any non-zero aseismicity factors if aseisReducesArea is true)

Returns:
area in SI units (meters squared)

getNumSegments

public int getNumSegments()
Get the number of segments in this model

Returns:

getSegmentArea

public double getSegmentArea(int index)
Get segment area by index - SI units (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is true)

Parameters:
index -
Returns:
area in SI units (meters squared)

getOrigSegmentArea

public double getOrigSegmentArea(int index)
Get original segment area by index - SI units (note that this is NOT reduce by any aseismicity factors)

Parameters:
index -
Returns:
area in SI units (meters squared)

getOrigSegmentDownDipWidth

public double getOrigSegmentDownDipWidth(int index)
Get original segment down-dip-width - SI units (note that this is NOT reduce by any aseismicity factors)

Parameters:
index -
Returns:
down dip width in SI units (meters)

getSegmentLength

public double getSegmentLength(int index)
Get segment length by index. Note that this is not reduced if aseisReducesArea.

Parameters:
index -
Returns:
length in SI units (meters)

getAveSegAseisFactor

public double getAveSegAseisFactor(int index)
This returns the average aseismcity factor for the ith segment

Parameters:
index -
Returns:

getTotalLength

public double getTotalLength()
Get total length of all segments combined. Note that this is not reduced if aseisReducesArea.

Returns:
length in SI units (meters)

getSegmentSlipRate

public double getSegmentSlipRate(int index)
Get segment slip rate by index (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is false)

Parameters:
index -
Returns:
slip rate in SI units (m/sec)

getSegSlipRateStdDev

public double getSegSlipRateStdDev(int index)
Get Standard deviation for the slip rate by index

Parameters:
index -
Returns:

getSegTimeDependentData

public SegmentTimeDepData getSegTimeDependentData(int index)
Get Time Dependent data for specified segment index

Parameters:
index -
Returns:

getSegCalYearOfLastEvent

public double getSegCalYearOfLastEvent(int index)

getSegAperiodicity

public double getSegAperiodicity(int index)

getSegAveSlipInLastEvent

public double getSegAveSlipInLastEvent(int index)

getTotalAveSlipRate

public double getTotalAveSlipRate()
Get total ave slip rate - wt averaged by area (note that this is reduce by any non-zero aseismicity factors if aseisReducesArea is false)

Parameters:
index -
Returns:
slip rate in SI units (m/sec)

getRecurInterval

public double getRecurInterval(int segIndex)
Computes the mean recur interval for a segment (as 1/getSegRateMean(segIndex)).

Parameters:
index -
Returns:
recur int in years

getSegRateConstraints

public ArrayList<SegRateConstraint> getSegRateConstraints(int index)
Get the rates for the sepcified segment index. Returns an empty arrayList in case there are no rates for this segment.

Parameters:
index -
Returns:

getSegRateStdDevOfMean

public double getSegRateStdDevOfMean(int index)
This returns the standard deviation of the mean segment rate (wt averaged if more than one constraint on the segment).

Parameters:
index -
Returns:
recur int in years

getSegRateMean

public double getSegRateMean(int index)
This returns the mean segment rate (wt averaged if more than one constraint on the segment).

Parameters:
index -
Returns:
recur int in years

getSegLower95Conf

public double getSegLower95Conf(int index)
This returns the lower 95% confidence of segment rate (highest value is returned if more than one value on the segment).

Parameters:
index -

getSegUpper95Conf

public double getSegUpper95Conf(int index)
This returns the upper 95% confidence of segment rate (lowest value is returned if more than one value on the segment).

Parameters:
index -

getRecurIntervalSigma

public double getRecurIntervalSigma(int index)
Computes the standard deviation of the mean recur interval for a segment (using standard error propagation from getSegRateStdDevOfMean and getSegRateMean).

Parameters:
index -
Returns:
recur int in years

getSegRateConstraints

public ArrayList<SegRateConstraint> getSegRateConstraints()
Get the segment Rates

Returns:

getSegmentMomentRate

public double getSegmentMomentRate(int index)
Get segment moment rate by index (note that this is reduce by any non-zero aseismicity factors)

Parameters:
index -
Returns:
moment rate in SI units

getTotalMomentRate

public double getTotalMomentRate()
Get total Moment rate for all segments combined (note that this is reduce by any non-zero aseismicity factors)

Returns:
total moment rate in SI units

getTotalAveAseismicityFactor

public double getTotalAveAseismicityFactor()
Get the average aseismicity factor (computed as final total moment rate divided by original total moment rate)

Returns:
total moment rate in SI units

getSegmentName

public String getSegmentName(int index)
Get segment name by index

Parameters:
index -
Returns:

getSectionsInSeg

public String getSectionsInSeg(int index)
Get segment name as a concatenated String of section names by index

Parameters:
index -
Returns:

getSegmentNames

public String[] getSegmentNames()
Get an array of all segment names

Returns:

getPrefFaultSectionDataList

public ArrayList getPrefFaultSectionDataList()
Get a list of FaultSectionPrefData for selected fault model (Not sure if this is the best place for this because the info can be accessed from a returned FaultSegmentData object)

Parameters:
faultModel -
deformationModelId -
Returns:

getCombinedGriddedSurface

public UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(double gridSpacing,
                                                                     double increaseDDW_Factor)
Get StirlingGriddedSurface for ALL Segments. It stitches together the segments and returns the resulting surface. It changes the DDW with the user provided increase factor

Returns:

getCombinedGriddedSurface

public UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(int[] segIndex,
                                                                     double gridSpacing,
                                                                     double increaseDDW_Factor)
Get StirlingGriddedSurface for selected Segment indices. It stitches together the segments and returns the resulting surface. It changes the DDW with the user provided increase factor

Parameters:
segIndex - List of Segment index to be included in the surface. The indices can have value from 0 to (getNumSegments()-1)
Returns:

getCombinedGriddedSurface

public UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(int[] segIndex,
                                                                     double gridSpacing)
Get StirlingGriddedSurface for selected Segment indices. It stitches together the segments and returns the resulting surface

Parameters:
segIndex - List of Segment index to be included in the surface. The indices can have value from 0 to (getNumSegments()-1)
Returns:

getCombinedGriddedSurface

public UCERF2_Final_StirlingGriddedSurface getCombinedGriddedSurface(double gridSpacing)
Get StirlingGriddedSurface for ALL Segments. It stitches together the segments and returns the resulting surface

Returns:

getAveRake

public double getAveRake()
Get Ave rake for the ALL Segments

Returns:

getAveRake

public double getAveRake(int[] segIndex)
Get Ave rake for the selected Segments. Rake is weighted by area of the segments

Parameters:
segIndex - List of Segment index to be included for caluclating Avg rake. The indices can have value from 0 to (getNumSegments()-1)
Returns: