matplotlib.quiver.QuiverKey

classmatplotlib.quiver.QuiverKey(Q, X, Y, U, label, *, angle=0, coordinates='axes', color=None, labelsep=0.1, labelpos='N', labelcolor=None, fontproperties=None, **kw)[source]

Bases: matplotlib.artist.Artist

Метка стрелки для использования в качестве ключа масштаба графика quiver.

Добавление ключа к графику quiver.

Позиционирование ключа зависит от X, Y, coordinates и labelpos. Если labelpos равняется 'N' или 'S', X, Y задают позицию середины стрелки ключа. Если labelpos равняется 'E', X, Y позиционируют головку, а если labelpos равняется 'W', X, Y позиционируют хвост; в любом из этих двух случаев X, Y находятся где-то посередине объекта ключа со стрелкой и меткой.

Parameters

Qmatplotlib.quiver.Quiver

Объект Quiver, возвращаемый функцией quiver().

X, Yfloat

Положение ключа.

Ufloat

Длина ключа.

labelstr

Метка ключа (например, длина и единицы измерения ключа).

anglefloat, default: 0

Угол стрелки ключа, в градусах против часовой стрелки от оси x.

coordinates{'axes', 'figure', 'data', 'inches'}, default: 'axes'

Система координат и единицы измерения для X, Y: 'axes' и 'figure' — это нормализованные системы координат с (0, 0) в левом нижнем углу и (1, 1) в правом верхнем углу; 'data' — это координаты данных осей (используются для расположения векторов на графике quiver); 'inches' — положение на рисунке в дюймах, с (0, 0) в левом нижнем углу.

colorцвет

Переопределяет цвета заливки и обводки из Q.

labelpos{'N', 'S', 'E', 'W'}

Расположить метку над, под, справа, слева от стрелки соответственно.

labelsepfloat, default: 0.1

Расстояние в дюймах между стрелкой и меткой.

labelcolorцвет, default: rcParams["text.color"] (default: 'black')

Цвет метки.

fontpropertiesdict, optional

Словарь с ключевыми аргументами, принимаемыми инициализатором FontProperties: family, style, variant, size, weight.

**kwargs

Любые дополнительные ключевые аргументы используются для переопределения свойств вектора, взятых из Q.

contains(mouseevent)[source]

Проверка, содержит ли элемент художник событие мыши.

Parameters

mouseeventmatplotlib.backend_bases.MouseEvent

Returns

containsbool

Являются ли какие-либо значения в пределах радиуса.

detailsdict

Словарь, специфичный для художника, содержащий детали контекста события, такие как точки, попадающие в радиус выделения. См. отдельные подклассы художника для получения подробностей.

draw(renderer)[source]

Отрисовка элемента (и его дочерних элементов) с помощью заданного рендерера.

Не имеет эффекта, если элемент не виден (Artist.get_visible возвращает False).

Parameters

rendererRendererBase подкласс.

Примечания

Этот метод переопределяется в подклассах художника.

halign={'E': 'left', 'N': 'center', 'S': 'center', 'W': 'right'}

pivot={'E': 'tip', 'N': 'middle', 'S': 'middle', 'W': 'tail'}

remove()[source]

Удаление элемента из фигуры, если это возможно.

Эффект будет виден только после повторной отрисовки фигуры, например, с помощью FigureCanvasBase.draw_idle. Вызовите relim для обновления пределов осей, если необходимо.

Примечание: relim не увидит коллекции, даже если коллекция была добавлена на ось с autolim = True.

Примечание: нет поддержки удаления записи легенды элемента.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установка нескольких свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	скаляр или None
animated	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch или (Path, Transform) или None
figure	неизвестно
gid	str
in_layout	bool
label	объект
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемый объект
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

set_figure(fig)[source]

Устанавливает экземпляр Figure, к которому принадлежит элемент.

Parameters

figFigure

valign={'E': 'center', 'N': 'bottom', 'S': 'top', 'W': 'center'}

Примеры использования matplotlib.quiver.QuiverKey