def beach(fm, linewidth=2, facecolor='b', bgcolor='w', edgecolor='k', alpha=1.0, xy=(0, 0), width=200, size=100, nofill=False, zorder=100, mopad_basis='USE', axes=None): """ Return a beach ball as a collection which can be connected to an current matplotlib axes instance (ax.add_collection). Based on MoPaD. S1, D1, and R1, the strike, dip and rake of one of the focal planes, can be vectors of multiple focal mechanisms. :param fm: Focal mechanism that is either number of mechanisms (NM) by 3 (strike, dip, and rake) or NM x 6 (M11, M22, M33, M12, M13, M23 - the six independent components of the moment tensor, where the coordinate system is 1,2,3 = Up,South,East which equals r,theta,phi - Harvard/Global CMT convention). The relation to Aki and Richards x,y,z equals North,East,Down convention is as follows: Mrr=Mzz, Mtt=Mxx, Mpp=Myy, Mrt=Mxz, Mrp=-Myz, Mtp=-Mxy. The strike is of the first plane, clockwise relative to north. The dip is of the first plane, defined clockwise and perpendicular to strike, relative to horizontal such that 0 is horizontal and 90 is vertical. The rake is of the first focal plane solution. 90 moves the hanging wall up-dip (thrust), 0 moves it in the strike direction (left-lateral), -90 moves it down-dip (normal), and 180 moves it opposite to strike (right-lateral). :param facecolor: Color to use for quadrants of tension; can be a string, e.g. ``'r'``, ``'b'`` or three component color vector, [R G B]. Defaults to ``'b'`` (blue). :param bgcolor: The background color. Defaults to ``'w'`` (white). :param edgecolor: Color of the edges. Defaults to ``'k'`` (black). :param alpha: The alpha level of the beach ball. Defaults to ``1.0`` (opaque). :param xy: Origin position of the beach ball as tuple. Defaults to ``(0, 0)``. :type width: int :param width: Symbol size of beach ball. Defaults to ``200``. :param size: Controls the number of interpolation points for the curves. Minimum is automatically set to ``100``. :param nofill: Do not fill the beach ball, but only plot the planes. :param zorder: Set zorder. Artists with lower zorder values are drawn first. :param mopad_basis: The basis system. Defaults to ``'USE'``. See the `Supported Basis Systems`_ section below for a full list of supported systems. :type axes: :class:`matplotlib.axes.Axes` :param axes: Used to make beach balls circular on non-scaled axes. Also maintains the aspect ratio when resizing the figure. Will not add the returned collection to the axes instance. .. rubric:: _`Supported Basis Systems` ========= =================== ============================================= Short Basis vectors Usage ========= =================== ============================================= ``'NED'`` North, East, Down Jost and Herrmann 1989 ``'USE'`` Up, South, East Global CMT Catalog, Larson et al. 2010 ``'XYZ'`` East, North, Up General formulation, Jost and Herrmann 1989 ``'RT'`` Radial, Transverse, psmeca (GMT), Wessel and Smith 1999 Tangential ``'NWU'`` North, West, Up Stein and Wysession 2003 ========= =================== ============================================= """ # initialize beachball mt = mopad_MomentTensor(fm, system=mopad_basis) bb = mopad_BeachBall(mt, npoints=size) bb._setup_BB(unit_circle=False) # extract the coordinates and colors of the lines radius = width / 2.0 neg_nodalline = bb._nodalline_negative_final_US pos_nodalline = bb._nodalline_positive_final_US tension_colour = facecolor pressure_colour = bgcolor if nofill: tension_colour = 'none' pressure_colour = 'none' # based on mopads _setup_plot_US() function # collect patches for the selection coll = [None, None, None] coll[0] = patches.Circle(xy, radius=radius) coll[1] = xy2patch(neg_nodalline[0, :], neg_nodalline[1, :], radius, xy) coll[2] = xy2patch(pos_nodalline[0, :], pos_nodalline[1, :], radius, xy) # set the color of the three parts fc = [None, None, None] if bb._plot_clr_order > 0: fc[0] = pressure_colour fc[1] = tension_colour fc[2] = tension_colour if bb._plot_curve_in_curve != 0: fc[0] = tension_colour if bb._plot_curve_in_curve < 1: fc[1] = pressure_colour fc[2] = tension_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = pressure_colour fc[2] = tension_colour else: fc[0] = tension_colour fc[1] = pressure_colour fc[2] = pressure_colour if bb._plot_curve_in_curve != 0: fc[0] = pressure_colour if bb._plot_curve_in_curve < 1: fc[1] = tension_colour fc[2] = pressure_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = tension_colour fc[2] = pressure_colour if bb._pure_isotropic: if abs(np.trace(bb._M)) > epsilon: # use the circle as the most upper layer coll = [coll[0]] if bb._plot_clr_order < 0: fc = [tension_colour] else: fc = [pressure_colour] # transform the patches to a path collection and set # the appropriate attributes collection = mpl_collections.PatchCollection(coll, match_original=False) collection.set_facecolors(fc) # Use the given axes to maintain the aspect ratio of beachballs on figure # resize. if axes is not None: # This is what holds the aspect ratio (but breaks the positioning) collection.set_transform(transforms.IdentityTransform()) # Next is a dirty hack to fix the positioning: # 1. Need to bring the all patches to the origin (0, 0). for p in collection._paths: p.vertices -= xy # 2. Then use the offset property of the collection to position the # patches collection.set_offsets(xy) collection._transOffset = axes.transData collection.set_edgecolors(edgecolor) collection.set_alpha(alpha) collection.set_linewidth(linewidth) collection.set_zorder(zorder) return collection
def beach(fm, linewidth=1, facecolor='0.75', bgcolor='w', edgecolor='k', alpha=1.0, xy=(0, 0), width=200, size=100, nofill=False, zorder=100, mopad_basis='NED', axes=None, show_iso=False): """ Plot beach ball based on `MoPaD <http://www.larskrieger.de/mopad/>`_ Function that returns a beach ball as a collection and can be added to an existing :class:`~matplotlib.axes.Axes`. This is modified from the :func:`~obspy.imaging.mopad_wrapper.beach` function to properly handle isotropic components. Original function only supports pure isotropic sources when isotropic components are plotted. :param fm: focal mechanism in (strike, dip, rake) or (M11,M22,M33,M12,M13,M23). The moment tensor elements are given for a coordinate system with axes pointing in three directions. Default is North, East and Down. :type fm: list :param linewidth: width of nodal and border lines. Default is ``1``. :type linewidth: float :param facecolor: color or shade of the compressive quadrants. Default is ``0.75`` (gray). :type facecolor: str :param bgcolor: background color, default is ``w`` (white). :type bgcolor: str :param edgecolor: color of nodal and border lines, default is ``b`` (black). :type edgecolor: str :param alpha: beach ball transparency, default is ``1.0`` (opaque). :type alpha: float :param xy: original position of the beach ball. Default is ``(0, 0)`` :type xy: tuple :param width: width of the beach ball (aka symbol size). Default is ``200``. :type width: int :param size: number of points interpolated to draw the cruve. Default is ``100``. :type size: int :param nofill: no shading of the beach ball. Default is ``False``. :type nofill: bool :param zorder: set the zorder for the artist. Artists with lower zorder values are drawn first. Default is ``100``. :type zorder: float :param mopad_basis: moment tensor coordinate system. See supported coordinate system below. Default is ``"NED"``. :type mopad_basis: str :param axes: figure axis for beach ball, this is used to ensure the aspect ratio is adjusted so that the beach ball is circular on non-scaled axes. Default is ``None``. :type axes: :class:`~matplotlib.axes.Axes` :param show_iso: flag to display the isotropic component, default is ``False``. :type show_iso: bool :return: a collection of lines and polygons. :rtype: :class:`~matplotlib.collections.PatchCollection` .. rubric:: Supported coordinate systems: .. cssclass: table-striped ================ ================== ========================== ``mopad_basis`` vectors reference ================ ================== ========================== "NED" north, east, down Jost and Herrmann, 1989 "USE" up, south, east Larson et al., 2010 "XYZ" east, north, up Jost and Herrmann, 1989 "NWU" north, west, up Stein and Wysession, 2003 ================ ================== ========================== """ # initialize beachball mt = mopad_MomentTensor(fm, system=mopad_basis) bb = mopad_BeachBall(mt, npoints=size) ## Snippets added by A. Chiang if show_iso: bb._plot_isotropic_part = True bb._nodallines_in_NED_system() ## bb._setup_BB(unit_circle=False) # extract the coordinates and colors of the lines radius = width / 2.0 neg_nodalline = bb._nodalline_negative_final_US pos_nodalline = bb._nodalline_positive_final_US tension_colour = facecolor pressure_colour = bgcolor if nofill: tension_colour = 'none' pressure_colour = 'none' # based on mopads _setup_plot_US() function # collect patches for the selection coll = [None, None, None] coll[0] = patches.Circle(xy, radius=radius) coll[1] = xy2patch(neg_nodalline[0, :], neg_nodalline[1, :], radius, xy) coll[2] = xy2patch(pos_nodalline[0, :], pos_nodalline[1, :], radius, xy) # set the color of the three parts fc = [None, None, None] if bb._plot_clr_order > 0: fc[0] = pressure_colour fc[1] = tension_colour fc[2] = tension_colour if bb._plot_curve_in_curve != 0: fc[0] = tension_colour if bb._plot_curve_in_curve < 1: fc[1] = pressure_colour fc[2] = tension_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = pressure_colour fc[2] = tension_colour else: fc[0] = tension_colour fc[1] = pressure_colour fc[2] = pressure_colour if bb._plot_curve_in_curve != 0: fc[0] = pressure_colour if bb._plot_curve_in_curve < 1: fc[1] = tension_colour fc[2] = pressure_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = tension_colour fc[2] = pressure_colour if bb._pure_isotropic: if abs(np.trace(bb._M)) > epsilon: # use the circle as the most upper layer coll = [coll[0]] if bb._plot_clr_order < 0: fc = [tension_colour] else: fc = [pressure_colour] # transform the patches to a path collection and set # the appropriate attributes collection = mpl_collections.PatchCollection(coll, match_original=False) collection.set_facecolors(fc) # Use the given axes to maintain the aspect ratio of beac hballs on figure # resize. if axes is not None: # This is what holds the aspect ratio (but breaks the positioning) collection.set_transform(transforms.IdentityTransform()) # Need to find another way to print as vector graphics # Next is a dirty hack to fix the positioning: # 1. Need to bring the all patches to the origin (0, 0). for p in collection._paths: p.vertices -= xy # 2. Then use the offset property of the collection to position the # patches collection.set_offsets(xy) collection._transOffset = axes.transData collection.set_edgecolors(edgecolor) collection.set_alpha(alpha) collection.set_linewidth(linewidth) collection.set_zorder(zorder) return collection
def Beach(fm, linewidth=2, facecolor='b', bgcolor='w', edgecolor='k', alpha=1.0, xy=(0, 0), width=200, size=100, nofill=False, zorder=100, mopad_basis='USE'): """ Return a beach ball as a collection which can be connected to an current matplotlib axes instance (ax.add_collection). Based on MoPaD. S1, D1, and R1, the strike, dip and rake of one of the focal planes, can be vectors of multiple focal mechanisms. :param fm: Focal mechanism that is either number of mechanisms (NM) by 3 (strike, dip, and rake) or NM x 6 (M11, M22, M33, M12, M13, M23 - the six independent components of the moment tensor, where the coordinate system is 1,2,3 = Up,South,East which equals r,theta,phi). The strike is of the first plane, clockwise relative to north. The dip is of the first plane, defined clockwise and perpendicular to strike, relative to horizontal such that 0 is horizontal and 90 is vertical. The rake is of the first focal plane solution. 90 moves the hanging wall up-dip (thrust), 0 moves it in the strike direction (left-lateral), -90 moves it down-dip (normal), and 180 moves it opposite to strike (right-lateral). :param facecolor: Color to use for quadrants of tension; can be a string, e.g. ``'r'``, ``'b'`` or three component color vector, [R G B]. Defaults to ``'b'`` (blue). :param bgcolor: The background color. Defaults to ``'w'`` (white). :param edgecolor: Color of the edges. Defaults to ``'k'`` (black). :param alpha: The alpha level of the beach ball. Defaults to ``1.0`` (opaque). :param xy: Origin position of the beach ball as tuple. Defaults to ``(0, 0)``. :type width: int :param width: Symbol size of beach ball. Defaults to ``200``. :param size: Controls the number of interpolation points for the curves. Minimum is automatically set to ``100``. :param nofill: Do not fill the beach ball, but only plot the planes. :param zorder: Set zorder. Artists with lower zorder values are drawn first. :param mopad_basis: The basis system. Defaults to ``'USE'``. See the `Supported Basis Systems`_ section below for a full list of supported systems. .. rubric:: _`Supported Basis Systems` ========= =================== ============================================= Short Basis vectors Usage ========= =================== ============================================= ``'NED'`` North, East, Down Jost and Herrmann 1989 ``'USE'`` Up, South, East Global CMT Catalog, Larson et al. 2010 ``'XYZ'`` East, North, Up General formulation, Jost and Herrmann 1989 ``'RT'`` Radial, Transverse, psmeca (GMT), Wessel and Smith 1999 Tangential ``'NWU'`` North, West, Up Stein and Wysession 2003 ========= =================== ============================================= """ # initialize beachball mt = mopad_MomentTensor(fm, system=mopad_basis) bb = mopad_BeachBall(mt, npoints=size) bb._setup_BB(unit_circle=False) # extract the coordinates and colors of the lines radius = width / 2.0 neg_nodalline = bb._nodalline_negative_final_US pos_nodalline = bb._nodalline_positive_final_US tension_colour = facecolor pressure_colour = bgcolor if nofill: tension_colour = 'none' pressure_colour = 'none' # based on mopads _setup_plot_US() function # collect patches for the selection coll = [None, None, None] coll[0] = patches.Circle(xy, radius=radius) coll[1] = xy2patch(neg_nodalline[0, :], neg_nodalline[1, :], radius, xy) coll[2] = xy2patch(pos_nodalline[0, :], pos_nodalline[1, :], radius, xy) # set the color of the three parts fc = [None, None, None] if bb._plot_clr_order > 0: fc[0] = pressure_colour fc[1] = tension_colour fc[2] = tension_colour if bb._plot_curve_in_curve != 0: fc[0] = tension_colour if bb._plot_curve_in_curve < 1: fc[1] = pressure_colour fc[2] = tension_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = pressure_colour fc[2] = tension_colour else: fc[0] = tension_colour fc[1] = pressure_colour fc[2] = pressure_colour if bb._plot_curve_in_curve != 0: fc[0] = pressure_colour if bb._plot_curve_in_curve < 1: fc[1] = tension_colour fc[2] = pressure_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = tension_colour fc[2] = pressure_colour if bb._pure_isotropic: if abs(np.trace(bb._M)) > epsilon: # use the circle as the most upper layer coll = [coll[0]] if bb._plot_clr_order < 0: fc = [tension_colour] else: fc = [pressure_colour] # transform the patches to a path collection and set # the appropriate attributes collection = collections.PatchCollection(coll, match_original=False) collection.set_facecolors(fc) collection.set_edgecolors(edgecolor) collection.set_alpha(alpha) collection.set_linewidth(linewidth) collection.set_zorder(zorder) return collection
def beach(fm, linewidth=1, facecolor='0.75', bgcolor='w', edgecolor='k', alpha=1.0, xy=(0, 0), width=200, size=100, nofill=False, zorder=100, mopad_basis='NED', axes=None, show_iso=False): """ Function taken from obspy.imaging.mopad_wrapper, minor modification to include isotropic components, original source code only handles pure iso. """ # initialize beachball mt = mopad_MomentTensor(fm, system=mopad_basis) bb = mopad_BeachBall(mt, npoints=size) ## Snippets added by A. Chiang if show_iso: bb._plot_isotropic_part = True bb._nodallines_in_NED_system() ## bb._setup_BB(unit_circle=False) # extract the coordinates and colors of the lines radius = width / 2.0 neg_nodalline = bb._nodalline_negative_final_US pos_nodalline = bb._nodalline_positive_final_US tension_colour = facecolor pressure_colour = bgcolor if nofill: tension_colour = 'none' pressure_colour = 'none' # based on mopads _setup_plot_US() function # collect patches for the selection coll = [None, None, None] coll[0] = patches.Circle(xy, radius=radius) coll[1] = xy2patch(neg_nodalline[0, :], neg_nodalline[1, :], radius, xy) coll[2] = xy2patch(pos_nodalline[0, :], pos_nodalline[1, :], radius, xy) # set the color of the three parts fc = [None, None, None] if bb._plot_clr_order > 0: fc[0] = pressure_colour fc[1] = tension_colour fc[2] = tension_colour if bb._plot_curve_in_curve != 0: fc[0] = tension_colour if bb._plot_curve_in_curve < 1: fc[1] = pressure_colour fc[2] = tension_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = pressure_colour fc[2] = tension_colour else: fc[0] = tension_colour fc[1] = pressure_colour fc[2] = pressure_colour if bb._plot_curve_in_curve != 0: fc[0] = pressure_colour if bb._plot_curve_in_curve < 1: fc[1] = tension_colour fc[2] = pressure_colour else: coll = [coll[i] for i in (0, 2, 1)] fc[1] = tension_colour fc[2] = pressure_colour if bb._pure_isotropic: if abs(np.trace(bb._M)) > epsilon: # use the circle as the most upper layer coll = [coll[0]] if bb._plot_clr_order < 0: fc = [tension_colour] else: fc = [pressure_colour] # transform the patches to a path collection and set # the appropriate attributes collection = mpl_collections.PatchCollection(coll, match_original=False) collection.set_facecolors(fc) # Use the given axes to maintain the aspect ratio of beachballs on figure # resize. if axes is not None: # This is what holds the aspect ratio (but breaks the positioning) collection.set_transform(transforms.IdentityTransform()) # Next is a dirty hack to fix the positioning: # 1. Need to bring the all patches to the origin (0, 0). for p in collection._paths: p.vertices -= xy # 2. Then use the offset property of the collection to position the # patches collection.set_offsets(xy) collection._transOffset = axes.transData collection.set_edgecolors(edgecolor) collection.set_alpha(alpha) collection.set_linewidth(linewidth) collection.set_zorder(zorder) return collection