Package edu.sc.seis.TauP

Class ScatteredSeismicPhase

java.lang.Object

edu.sc.seis.TauP.ScatteredSeismicPhase

All Implemented Interfaces:

SeismicPhase, Serializable, Cloneable

public class ScatteredSeismicPhase
extends Object
implements SeismicPhase

A seismic phase that scatters. Includes a specific inbound Arrival, then an outbound seismic phase.

See Also:

• Serialized Form

Field Summary

Fields inherited from interface edu.sc.seis.TauP.SeismicPhase

PWAVE, SWAVE

Constructor Summary

Constructors

Constructor	Description
ScatteredSeismicPhase(Arrival inboundArrival, SimpleSeismicPhase scatteredPhase, Scatterer scatterer, boolean backscatter)

Method Summary

Modifier and Type	Method	Description
double	calcEnergyFluxFactorReflTranPSV(Arrival arrival)	Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.
double	calcEnergyFluxFactorReflTranSH(Arrival arrival)	Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.
double	calcIncidentAngle(double arrivalRayParam)
double	calcIncidentAngleDegree(double arrivalRayParam)
double	calcRayParamForIncidentAngle(double incidentDegree)
double	calcRayParamForTakeoffAngle(double takeoffDegree)
SeismicPhaseReflTransHolder	calcReflTranPSV(Arrival arrival)	Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.
SeismicPhaseReflTransHolder	calcReflTranSH(Arrival arrival)	Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.
static double	calcScatterDistDeg(double deg, double scattererDeg, boolean backscatter)	Calculates the distance from the scatterer to the receiver.
List<ArrivalPathSegment>	calcSegmentPaths(Arrival arrival)
double	calcTakeoffAngle(double arrivalRayParam)
double	calcTakeoffAngleDegree(double arrivalRayParam)
double	calcTstar(Arrival currArrival)
int	countFlatLegs()
Arrival	createArrivalAtIndex(int rayNum)	Creates an Arrival for a sampled ray parameter from the model.
double	densityAtReceiver()
double	densityAtSource()
String	describe()
String	describeShort()
void	dump()
String	failReason()
boolean	finalSegmentIsPWave()	True if the final, incident, wavetype is a P wave, false if an S wave.
double[]	getDist()
double	getDist(int i)
Arrival	getEarliestArrival(double degrees)
SeismicPhaseSegment	getFinalPhaseSegment()
Arrival	getInboundArrival()	Gets the arrival inbound to the scatterer from the source.
SeismicPhaseSegment	getInitialPhaseSegment()
List<List<SeismicPhaseSegment>>	getListPhaseSegments()
double	getMaxDistance()
double	getMaxDistanceDeg()
double	getMaxRayParam()
int	getMaxRayParamIndex()
double	getMaxTime()
double	getMinDistance()
double	getMinDistanceDeg()
double	getMinRayParam()
int	getMinRayParamIndex()
double	getMinTime()
String	getName()
int	getNumRays()
String	getPuristName()
double[]	getRayParams()
double	getRayParams(int i)
double	getReceiverDepth()
int	getScatterDistMulFactor()
SimpleSeismicPhase	getScatteredPhase()	Gets the simple phase from the scatterer to the receiver, equivalent to setting a source at the scatterer location.
Scatterer	getScatterer()
double	getScattererDepth()
double	getScattererDistance()
double	getScattererDistanceDeg()
List<ShadowZone>	getShadowZones()
double	getSourceDepth()
double[]	getTau()
double	getTau(int i)
TauModel	getTauModel()
double[]	getTime()
double	getTime(int i)
boolean	hasArrivals()
SeismicPhase	interpolatePhase(double maxDeltaDeg)
List<TimeDist>	interpPierceTimeDist(Arrival arrival)
boolean	isAllPWave()	True is all segments of this path are only S waves.
boolean	isAllSWave()	True is all segments of this path are only S waves.
boolean	isBackscatter()
boolean	isFail()
boolean	phasesExistsInModel()
Arrival	shootRay(double rayParam)
boolean	sourceSegmentIsPWave()	True if the initial leg, leaving the source, wavetype is a P wave, false if an S wave.
double	velocityAtReceiver()
double	velocityAtSource()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface edu.sc.seis.TauP.SeismicPhase

toString

Constructor Details

ScatteredSeismicPhase

public ScatteredSeismicPhase(Arrival inboundArrival,
 SimpleSeismicPhase scatteredPhase,
 Scatterer scatterer,
 boolean backscatter)

Method Details

getInboundArrival

public Arrival getInboundArrival()

Gets the arrival inbound to the scatterer from the source. This part of the phase path is the same for all arrivals for the scattered phase.

Returns:

inbound arrival

getScatteredPhase

public SimpleSeismicPhase getScatteredPhase()

Gets the simple phase from the scatterer to the receiver, equivalent to setting a source at the scatterer location.

Returns:

scattered phase

getScattererDepth

public double getScattererDepth()

getScattererDistance

public double getScattererDistance()

getScattererDistanceDeg

public double getScattererDistanceDeg()

isBackscatter

public boolean isBackscatter()

phasesExistsInModel

public boolean phasesExistsInModel()

Specified by:

phasesExistsInModel in interface SeismicPhase

getEarliestArrival

public Arrival getEarliestArrival(double degrees)

Specified by:

getEarliestArrival in interface SeismicPhase

getTauModel

public TauModel getTauModel()

Specified by:

getTauModel in interface SeismicPhase

getMinDistanceDeg

public double getMinDistanceDeg()

Specified by:

getMinDistanceDeg in interface SeismicPhase

getMinDistance

public double getMinDistance()

Specified by:

getMinDistance in interface SeismicPhase

getMaxDistanceDeg

public double getMaxDistanceDeg()

Specified by:

getMaxDistanceDeg in interface SeismicPhase

getMaxDistance

public double getMaxDistance()

Specified by:

getMaxDistance in interface SeismicPhase

getScatterDistMulFactor

public int getScatterDistMulFactor()

getMaxRayParam

public double getMaxRayParam()

Specified by:

getMaxRayParam in interface SeismicPhase

getMinRayParam

public double getMinRayParam()

Specified by:

getMinRayParam in interface SeismicPhase

getMaxRayParamIndex

public int getMaxRayParamIndex()

Specified by:

getMaxRayParamIndex in interface SeismicPhase

getMinRayParamIndex

public int getMinRayParamIndex()

Specified by:

getMinRayParamIndex in interface SeismicPhase

getMinTime

public double getMinTime()

Specified by:

getMinTime in interface SeismicPhase

getMaxTime

public double getMaxTime()

Specified by:

getMaxTime in interface SeismicPhase

getSourceDepth

public double getSourceDepth()

Specified by:

getSourceDepth in interface SeismicPhase

getReceiverDepth

public double getReceiverDepth()

Specified by:

getReceiverDepth in interface SeismicPhase

getName

public String getName()

Specified by:

getName in interface SeismicPhase

getPuristName

public String getPuristName()

Specified by:

getPuristName in interface SeismicPhase

getListPhaseSegments

public List<List<SeismicPhaseSegment>> getListPhaseSegments()

Specified by:

getListPhaseSegments in interface SeismicPhase

getInitialPhaseSegment

public SeismicPhaseSegment getInitialPhaseSegment()

Specified by:

getInitialPhaseSegment in interface SeismicPhase

getFinalPhaseSegment

public SeismicPhaseSegment getFinalPhaseSegment()

Specified by:

getFinalPhaseSegment in interface SeismicPhase

countFlatLegs

public int countFlatLegs()

Specified by:

countFlatLegs in interface SeismicPhase

getRayParams

public double getRayParams(int i)

Specified by:

getRayParams in interface SeismicPhase

getRayParams

public double[] getRayParams()

Specified by:

getRayParams in interface SeismicPhase

getNumRays

public int getNumRays()

Specified by:

getNumRays in interface SeismicPhase

getDist

public double getDist(int i)

Specified by:

getDist in interface SeismicPhase

getDist

public double[] getDist()

Specified by:

getDist in interface SeismicPhase

getTime

public double getTime(int i)

Specified by:

getTime in interface SeismicPhase

getTime

public double[] getTime()

Specified by:

getTime in interface SeismicPhase

getTau

public double getTau(int i)

Specified by:

getTau in interface SeismicPhase

getTau

public double[] getTau()

Specified by:

getTau in interface SeismicPhase

hasArrivals

public boolean hasArrivals()

Specified by:

hasArrivals in interface SeismicPhase

createArrivalAtIndex

public Arrival createArrivalAtIndex(int rayNum)

Creates an Arrival for a sampled ray parameter from the model. No interpolation between rays as this is a sample.

Specified by:

createArrivalAtIndex in interface SeismicPhase

Parameters:

rayNum - ray parameter index

Returns:

arraival at ray num

calcScatterDistDeg

public static double calcScatterDistDeg(double deg,
 double scattererDeg,
 boolean backscatter)

Calculates the distance from the scatterer to the receiver.

Parameters:

deg - source to receiver distance

scattererDeg - scatterer distance, may be negative

backscatter - if the phase is backscattered

Returns:

scatterer to receiver distance in range -180 to 180

shootRay

public Arrival shootRay(double rayParam)

Specified by:

shootRay in interface SeismicPhase

calcRayParamForTakeoffAngle

public double calcRayParamForTakeoffAngle(double takeoffDegree)
                                   throws NoArrivalException

Specified by:

calcRayParamForTakeoffAngle in interface SeismicPhase

Throws:

NoArrivalException

calcRayParamForIncidentAngle

public double calcRayParamForIncidentAngle(double incidentDegree)
                                    throws NoArrivalException

Specified by:

calcRayParamForIncidentAngle in interface SeismicPhase

Throws:

NoArrivalException

velocityAtSource

public double velocityAtSource()

Specified by:

velocityAtSource in interface SeismicPhase

velocityAtReceiver

public double velocityAtReceiver()

Specified by:

velocityAtReceiver in interface SeismicPhase

densityAtReceiver

public double densityAtReceiver()

Specified by:

densityAtReceiver in interface SeismicPhase

densityAtSource

public double densityAtSource()

Specified by:

densityAtSource in interface SeismicPhase

calcTakeoffAngleDegree

public double calcTakeoffAngleDegree(double arrivalRayParam)

Specified by:

calcTakeoffAngleDegree in interface SeismicPhase

calcTakeoffAngle

public double calcTakeoffAngle(double arrivalRayParam)

Specified by:

calcTakeoffAngle in interface SeismicPhase

calcIncidentAngle

public double calcIncidentAngle(double arrivalRayParam)

Specified by:

calcIncidentAngle in interface SeismicPhase

calcIncidentAngleDegree

public double calcIncidentAngleDegree(double arrivalRayParam)

Specified by:

calcIncidentAngleDegree in interface SeismicPhase

sourceSegmentIsPWave

public boolean sourceSegmentIsPWave()

Description copied from interface: SeismicPhase

True if the initial leg, leaving the source, wavetype is a P wave, false if an S wave.

Specified by:

sourceSegmentIsPWave in interface SeismicPhase

finalSegmentIsPWave

public boolean finalSegmentIsPWave()

Description copied from interface: SeismicPhase

True if the final, incident, wavetype is a P wave, false if an S wave.

Specified by:

finalSegmentIsPWave in interface SeismicPhase

describe

public String describe()

Specified by:

describe in interface SeismicPhase

describeShort

public String describeShort()

Specified by:

describeShort in interface SeismicPhase

isFail

public boolean isFail()

Specified by:

isFail in interface SeismicPhase

failReason

public String failReason()

Specified by:

failReason in interface SeismicPhase

dump

public void dump()

Specified by:

dump in interface SeismicPhase

interpPierceTimeDist

public List<TimeDist> interpPierceTimeDist(Arrival arrival)
                                    throws NoArrivalException,
TauModelException

Specified by:

interpPierceTimeDist in interface SeismicPhase

Throws:

NoArrivalException

TauModelException

calcTstar

public double calcTstar(Arrival currArrival)
                 throws NoArrivalException

Specified by:

calcTstar in interface SeismicPhase

Throws:

NoArrivalException

isAllPWave

public boolean isAllPWave()

True is all segments of this path are only S waves.

Specified by:

isAllPWave in interface SeismicPhase

isAllSWave

public boolean isAllSWave()

True is all segments of this path are only S waves.

Specified by:

isAllSWave in interface SeismicPhase

interpolatePhase

public SeismicPhase interpolatePhase(double maxDeltaDeg)

Specified by:

interpolatePhase in interface SeismicPhase

calcEnergyFluxFactorReflTranPSV

public double calcEnergyFluxFactorReflTranPSV(Arrival arrival)

Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.

Specified by:

calcEnergyFluxFactorReflTranPSV in interface SeismicPhase

calcReflTranPSV

public SeismicPhaseReflTransHolder calcReflTranPSV(Arrival arrival)
                                            throws VelocityModelException

Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.

Specified by:

calcReflTranPSV in interface SeismicPhase

Throws:

VelocityModelException

calcReflTranSH

public SeismicPhaseReflTransHolder calcReflTranSH(Arrival arrival)
                                           throws VelocityModelException

Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.

Specified by:

calcReflTranSH in interface SeismicPhase

Throws:

VelocityModelException

calcEnergyFluxFactorReflTranSH

public double calcEnergyFluxFactorReflTranSH(Arrival arrival)

Calculation of a amplitude for a scattered phase doesn't make any sense given 1D ray, so always returns zero.

Specified by:

calcEnergyFluxFactorReflTranSH in interface SeismicPhase

calcSegmentPaths

public List<ArrivalPathSegment> calcSegmentPaths(Arrival arrival)
                                          throws SlownessModelException,
TauModelException

Specified by:

calcSegmentPaths in interface SeismicPhase

Throws:

SlownessModelException

TauModelException

getShadowZones

public List<ShadowZone> getShadowZones()

Specified by:

getShadowZones in interface SeismicPhase

getScatterer

public Scatterer getScatterer()