srPhase
The srPhase structure defines acceptable seismic phases (e.g., P, Pg, dPa, PmP, etc.) and, if applicable, associates a phase with an interface in srModel.  srPhase is a plane-organized structure with each plane defining a phase or a group of phases that are treated identically in terms of seismic ray tracing.

Notes
Acceptable Phase Names
Examaple of Matlab display
Required Variables
Notes:  
1) srPhase is defined in software; it is not a user-defined structure.  If more phase definitiions are required, contact Doug.

2) srPhase is a plane-organized structure with each plane defining a phase or a group of phases that are treated indentically in terms of seismic ray tracing. Phase names are case sensitivie and follow community conventions.  Thus ‘Pg’ is an acceptable phase, but ‘pg’ is not.

3) A phase name used by tlArrival must be present in srPhase.

4) The script ../Stingray/toolbox/define_srPhase.m creates the structure ../Stingray/toolbox/srPhase.mat

Each phase is:
    
a) Defined by a case-sensitive character string.  Note that groups  of phases (e.g., P, Pg, dPa, Pn) are defined together.

b) Assigned a phasetype (1 is direct, 2 is secondary).

c) Associated with a velocity model (P or S).  For multileg phases each leg can use a different velocity model.

d) For secondary arrivals (e.g., PmP) the phase is associated with a model interface, in this case ‘moho’.
Acceptable Phaes Names (i.e., only these have been defined thus far)
Direct P phases:
    {‘P’  ‘Pg’  ‘dPa’  ‘Pn’}

Secondary P reflection from Moho
    {‘PmP’}

Examples of Matlab Display
Required Variables

srPhase is plane organized, one plane for each interface.  srPhase is defined in code, it is not a user input.  The definitions below are the ones that are currently defined and acceptable.  If you want to add other phases, you should contact Doug for help.
Direct P Phases

srPhase(1).phase
 character (cell array)
 Case sensitive phase names.
 {‘P’  ‘Pg’  ‘dPa’  ‘Pn’}
srPhase(1).phasetype
 integer
 1 is direct, 2 is secondary
 1
srPhase(1).model
 character
 Velocity model used for ray tracing, either P or S. Empty for multileg phases
 ‘P’
srPhase(1).interface
 sub-structure
 Empty for direct phases
 []


PmP

srPhase(2).phase
 character (cell array)
 Case sensitive phase names.
 {‘PmP’}
srPhase(2).phasetype
 integer
 1 is direct, 2 is secondary
 2
srPhase(2).model
 character
 P or S for direct. Empty for multileg phases
 []
srPhase(2).interface
 sub-structure
 1x2 struct array with fields:
    name
    side
    direction
    model


PmP, downgoing leg:

srPhase(2).interface(1).name
 character
 Name of the interface causing either reflection or conversion.  This name must be found in srModel.interface(:).name
 ‘moho’
srPhase(2).interface(1).side
 character
 Either ‘top’ or ‘bottom’ to indicate the side of interface where reflection or transmission occurs.
 ‘top’
srPhase(2).interface(1).direction
 character
 Either ‘up’ or ‘down’ to indicate direction of propagation for n’th leg of secondary arrival; n is the plane.
 ‘down’
srPhase(2).interface(1).model
 character
 Velocity model used for ray tracing, either P or S.
 ‘P’

PmP, upgoing leg:

srPhase(2).interface(2).name
 character
 Name of the interface causing either reflection or conversion.  This name must be found in srModel.interface(:).name
 ‘moho’
srPhase(2).interface(2).side
 character
 Either ‘top’ or ‘bottom’ to indicate the side of interface where reflection or transmission occurs.
 ‘top’
srPhase(2).interface(2).direction
 character
 Either ‘up’ or ‘down’ to indicate direction of propagation for n’th leg of secondary arrival; n is the plane.
 ‘up’
srPhase(2).interface(2).model
 character
 Velocity model used for ray tracing, either P or S.
 ‘P’