pykonal.solver.PointSourceSolver¶

class pykonal.solver.PointSourceSolver(coord_sys='cartesian')¶

A convenience class to improve precision when solving the common problem of a point source.

This class implements a pair of complementary computational grids to improve precision. A refined spherical grid centered on the source is used in the near-source region. The user can specify whether a Cartesian or spherical grid is used in the far field. The refinement of the near-field grid will be handled automatically using some reasonable values if the user does not manually configure it.

initialize_far_field_narrow_band() → bool¶

Initialize the narrow band of the far-field grid using all the nodes with finite traveltimes.

Returns: Returns True upon successful completion.
Return type: bool

initialize_near_field_grid() → bool¶

Initialize the near-field grid.

Returns: Returns True upon successful completion.
Return type: bool

initialize_near_field_narrow_band() → bool¶

Initialize the narrow band of the near-field grid using the layer of nodes closest to the source.

Returns: Returns True upon successful completion.
Return type: bool

interpolate_far_field_velocity_onto_near_field() → bool¶

Interpolate the far-field velocity model onto the near-field grid.

Returns: Returns True upon successful completion.
Return type: bool

interpolate_near_field_traveltime_onto_far_field() → bool¶

Interpolate the near-field traveltime values onto the far-field grid.

Returns: Returns True upon successful completion.
Return type: bool

solve()¶

Solve the Eikonal equation on the far-field grid using the refined source grid in the near-field region.

Returns: Returns True upon successful completion.
Return type: bool

property dphi¶: [Read/Write, float] Node interval (in radians) along the azimuthal axis of the refined near-field grid.

property drho¶: [Read/Write, float] Node interval (in arbitrary distance units) along the radial axis of the refined near-field grid.

property dtheta¶: [Read/Write, float] Node interval (in radians) along the polar axis of the refined near-field grid.

property near_field¶: [Read/Write, EikonalSolver] Solver for the Eikonal equation in the near-field region.

property nphi¶: [Read, int] Number of grid nodes along the azimuthal axis of the refined near-field grid.

property nrho¶: [Read/Write, int] Number of grid nodes along the radial axis of the refined near-field grid.

property ntheta¶: [Read, int] Number of grid nodes along the polar axis of the refined near-field grid.

property src_loc¶: [Read/Write, (float, float, float)] Location of the point source in the coordinates of the far-field grid.