Source code for mpl_toolkits.axisartist.axisline_style

import math

import numpy as np

from matplotlib.patches import _Style, FancyArrowPatch
from matplotlib.transforms import IdentityTransform
from matplotlib.path import Path

class _FancyAxislineStyle:
    class SimpleArrow(FancyArrowPatch):
        The artist class that will be returned for SimpleArrow style.
        _ARROW_STYLE = "->"

        def __init__(self, axis_artist, line_path, transform,
            self._axis_artist = axis_artist
            self._line_transform = transform
            self._line_path = line_path
            self._line_mutation_scale = line_mutation_scale


        def set_line_mutation_scale(self, scale):

        def _extend_path(self, path, mutation_size=10):
            Extend the path to make a room for drawing arrow.
            (x0, y0), (x1, y1) = path.vertices[-2:]
            theta = math.atan2(y1 - y0, x1 - x0)
            x2 = x1 + math.cos(theta) * mutation_size
            y2 = y1 + math.sin(theta) * mutation_size
            if is None:
                return Path(np.concatenate([path.vertices, [[x2, y2]]]))
                return Path(np.concatenate([path.vertices, [[x2, y2]]]),
                            np.concatenate([, [Path.LINETO]]))

        def set_path(self, path):
            self._line_path = path

        def draw(self, renderer):
            Draw the axis line.
             1) transform the path to the display coordinate.
             2) extend the path to make a room for arrow
             3) update the path of the FancyArrowPatch.
             4) draw
            path_in_disp = self._line_transform.transform_path(self._line_path)
            mutation_size = self.get_mutation_scale()  # line_mutation_scale()
            extended_path = self._extend_path(path_in_disp,
            self._path_original = extended_path
            FancyArrowPatch.draw(self, renderer)

    class FilledArrow(SimpleArrow):
        The artist class that will be returned for SimpleArrow style.
        _ARROW_STYLE = "-|>"

[docs]class AxislineStyle(_Style): """ A container class which defines style classes for AxisArtists. An instance of any axisline style class is an callable object, whose call signature is :: __call__(self, axis_artist, path, transform) When called, this should return an `.Artist` with the following methods:: def set_path(self, path): # set the path for axisline. def set_line_mutation_scale(self, scale): # set the scale def draw(self, renderer): # draw """ _style_list = {} class _Base: # The derived classes are required to be able to be initialized # w/o arguments, i.e., all its argument (except self) must have # the default values. def __init__(self): """ initialization. """ super().__init__() def __call__(self, axis_artist, transform): """ Given the AxisArtist instance, and transform for the path (set_path method), return the Matplotlib artist for drawing the axis line. """ return self.new_line(axis_artist, transform)
[docs] class SimpleArrow(_Base): """ A simple arrow. """ ArrowAxisClass = _FancyAxislineStyle.SimpleArrow
[docs] def __init__(self, size=1): """ Parameters ---------- size : float Size of the arrow as a fraction of the ticklabel size. """ self.size = size super().__init__()
[docs] def new_line(self, axis_artist, transform): linepath = Path([(0, 0), (0, 1)]) axisline = self.ArrowAxisClass(axis_artist, linepath, transform, line_mutation_scale=self.size) return axisline
_style_list["->"] = SimpleArrow
[docs] class FilledArrow(SimpleArrow): ArrowAxisClass = _FancyAxislineStyle.FilledArrow
_style_list["-|>"] = FilledArrow