matplotlib.quiver.Quiver
- classmatplotlib.quiver.Quiver(ax, *args, scale=None, headwidth=3, headlength=5, headaxislength=4.5, minshaft=1, minlength=1, units='width', scale_units=None, angles='uv', width=None, color='k', pivot='tail', **kwargs)[source]
-
Основы:
PolyCollectionСпециализированный PolyCollection для стрелок.
Единственный метод API — set_UVC(), который можно использовать для изменения размера, ориентации и цвета стрелок; их расположение фиксируется при создании класса. Возможно, этот метод будет полезен при анимации.
Большая часть работы в этом классе выполняется в методе draw(), чтобы как можно больше информации было доступно о графике. При последующих вызовах draw() перерасчет ограничен элементами, которые могли измениться, поэтому использование вычислений в методе draw() не должно снизить производительность.
Конструктор принимает один обязательный аргумент, экземпляр Axes, а также аргументы и ключевые слова, описанные в следующей документации интерфейса pyplot:
Построение 2D поля стрелок.
Вызов:
quiver([X, Y], U, V, [C], **kwargs)
X, Y определяют расположение стрелок, U, V определяют направления стрелок, а C необязательно устанавливает цвет.
Длина стрелки
По умолчанию длина стрелок автоматически масштабируется до разумного размера. Чтобы изменить это поведение, см. параметры scale и scale_units.
Форма стрелки
Форма стрелки определяется параметрами width, headwidth, headlength и headaxislength. См. примечания ниже.
Стиль стрелки
Каждая стрелка внутренне представляется заполненным многоугольником с шириной линии по умолчанию 0. В результате стрелка представляет собой скорее заполненную область, а не линию с наконечником, и свойства
PolyCollection, такие как linewidth, edgecolor, facecolor и т. д., действуют соответствующим образом.- Параметры:
-
- X, Y1D или 2D массив-подобный объект, необязательно
-
Координаты x и y расположения стрелок.
Если не указаны, они будут сгенерированы как равномерная целочисленная сетка по умолчанию на основе размерности U и V.
Если X и Y являются 1D, а U, V — 2D, X, Y расширяются до 2D с помощью
X, Y = np.meshgrid(X, Y). В этом случаеlen(X)иlen(Y)должны соответствовать количеству столбцов и строк в U и V. - U, V1D или 2D массив-подобный объект
-
Компоненты x и y направлений вектора стрелки. Интерпретация этих компонентов (в данных или в пространстве экрана) зависит от angles.
U и V должны иметь одинаковое количество элементов, соответствующее количеству расположений стрелок в X, Y. U и V могут быть замаскированы. Расположения, замаскированные в любом из U, V и C, не будут нарисованы.
- C1D или 2D массив-подобный объект, необязательно
-
Числовые данные, которые определяют цвета стрелок с помощью цветовой карты посредством norm и cmap.
Это не поддерживает явные цвета. Если вы хотите задать цвета непосредственно, используйте color вместо этого. Размер C должен соответствовать количеству расположений стрелок.
- angles{'uv', 'xy'} или массив-подобный объект, по умолчанию: 'uv'
-
Метод определения угла стрелок.
-
'uv': Направление стрелки в координатах экрана. Используйте это, если стрелки обозначают величину, которая не основана на координатах данных X, Y.
Если U == V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительно вправо).
- 'xy': Направление стрелки в координатах данных, т. е. стрелки направлены от (x, y) к (x+u, y+v). Используйте это, например, для построения градиентного поля.
-
Произвольные углы могут быть явно заданы в виде массива значений в градусах, против часовой стрелки от горизонтальной оси.
В этом случае U, V используется только для определения длины стрелок.
Примечание: инвертирование оси данных будет соответственным образом инвертировать стрелки только с
angles='xy'. -
- pivot{'tail', 'mid', 'middle', 'tip'}, по умолчанию: 'tail'
-
Часть стрелки, прикрепленная к сетке X, Y. Стрелка вращается вокруг этой точки.
'mid' — синоним 'middle'.
- scalefloat, необязательно
-
Масштабирует длину стрелки обратно пропорционально.
Количество единиц данных на единицу длины стрелки, например, м/с на ширину графика; меньший параметр scale делает стрелку длиннее. По умолчанию — None.
Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задается параметром scale_units.
- scale_units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, необязательно
-
Если параметр scale равен None, единица длины стрелки. По умолчанию — None.
Например, scale_units — 'inches', scale — 2.0, и
(u, v) = (1, 0), тогда вектор будет иметь длину 0,5 дюйма.Если scale_units равен 'width' или 'height', вектор будет иметь длину половины ширины/высоты осей.
Если scale_units равен 'x', то вектор будет иметь длину 0,5 единиц оси x. Чтобы отобразить векторы в плоскости x-y с u и v, имеющими те же единицы, что и x и y, используйте
angles='xy', scale_units='xy', scale=1. - units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, по умолчанию: 'width'
-
Влияет на размер стрелки (кроме длины). В частности, ширина вала width измеряется в кратных этой единице.
Допустимые значения:
- 'width', 'height': Ширина или высота Axes.
- 'dots', 'inches': Пиксели или дюймы, основанные на разрешении figure.
- 'x', 'y', 'xy': X, Y или \(\sqrt{X^2 + Y^2}\) в единицах данных.
В следующей таблице показано, как эти значения влияют на видимый размер стрелки при масштабировании и изменении размера фигуры:
units
масштабирование
изменение размера фигуры
'x', 'y', 'xy'
размер стрелки масштабируется
'width', 'height'
размер стрелки масштабируется
'dots', 'inches'
- widthfloat, необязательно
-
Ширина вала в единицах стрелки. Все параметры наконечника относительны к width.
Значение по умолчанию зависит от выбора units выше и количества векторов; типичное начальное значение составляет примерно 0,005 от ширины графика.
- headwidthfloat, по умолчанию: 3
-
Ширина наконечника как кратная ширине вала width. См. примечания ниже.
- headlengthfloat, по умолчанию: 5
-
Длина наконечника как кратная ширине вала width. См. примечания ниже.
- headaxislengthfloat, по умолчанию: 4.5
-
Длина наконечника на пересечении с валом как кратная ширине вала width. См. примечания ниже.
- minshaftfloat, по умолчанию: 1
-
Длина, ниже которой стрелка масштабируется, в единицах длины наконечника. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно!
- minlengthfloat, по умолчанию: 1
-
Минимальная длина как кратная ширине вала; если длина стрелки меньше этого значения, отображается точка (шестиугольник) такого диаметра.
- colorцвет или последовательность цветов, необязательно
-
Явный(ые) цвет(ы) стрелок. Если C задан, color не имеет эффекта.
Это синоним параметра
PolyCollectionfacecolor.
- Возвращаемое значение:
-
Quiver
- Другие параметры:
-
- dataиндексируемый объект, необязательно
-
ЗАМЕЩЕНИЕ_ПАРАМЕТРА_ДАННЫХ
-
**kwargs
PolyCollectionсвойства, необязательно
-
Все остальные ключевые аргументы передаются в
PolyCollection:Свойство
Описание
функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив и два смещения от левого нижнего угла изображения
массивоподобное значение или скаляр или None
bool
antialiasedили aa или antialiasedsbool или список bool
массивоподобное значение или None
CapStyleили {'butt', 'projecting', 'round'}(vmin: float, vmax: float)
bool
Объект Patch или (Path, Transform) или None
Colormapили строка или Noneцвет или список кортежей rgba
edgecolorили ec или edgecolorsцвет или список цветов или 'face'
facecolorили facecolors или fcцвет или список цветов
строка
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bool
JoinStyleили {'miter', 'round', 'bevel'}объект
linestyleили dashes или linestyles или lsстрока или кортеж или список thereof
linewidthили linewidths или lwчисло с плавающей точкой или список чисел с плавающей точкой
bool
Normalizeили строка или Noneoffset_transformили transOffsetнеизвестно
(N, 2) или (2,) массивоподобное значение
список массивоподобных значений
None или bool или число с плавающей точкой или вызываемая функция
неизвестно
bool
sizesмассив NumPy или None
(scale: float, length: float, randomness: float)
bool или None
строка
список строк или None
список массивоподобных значений
неизвестно
bool
число с плавающей точкой
-
См. также
Axes.quiverkey-
Добавить ключ к графику векторов.
Примечания
Форма стрелки
Стрелка рисуется как многоугольник, используя узлы, как показано ниже. Значения headwidth, headlength и headaxislength задаются в единицах width.
По умолчанию получается слегка скошенная стрелка. Ниже приведены рекомендации по получению других форм головки:
- Чтобы сделать головку треугольной, сделайте headaxislength равным headlength.
- Чтобы сделать стрелку более заостренной, уменьшите headwidth или увеличьте headlength и headaxislength.
- Чтобы сделать головку меньше относительно хвоста, пропорционально уменьшите все параметры головки.
- Чтобы полностью убрать головку, установите все параметры head в 0.
- Чтобы получить ромбовидную головку, сделайте headaxislength больше, чем headlength.
- Предупреждение: При headaxislength < (headlength / headwidth) узлы "headaxis" (т.е. те, что соединяют головку с хвостом) будут выступать за пределы головки в направлении вперед, так что головка стрелки будет выглядеть прерванной.
- draw(renderer)[source]
-
Отрисовать элемент (и его потомков) с использованием данного рендерера.
Это не имеет эффекта, если элемент не виден (
Artist.get_visibleвозвращает False).- Параметры:
-
-
renderer
RendererBaseподкласс.
-
renderer
Примечания
Этот метод переопределен в подклассах элементов.
- get_datalim(transData)[source]
- quiver_doc=
- '\nОтображение 2D поля стрелок.\n\nВызов: \n\n quiver([X, Y], U, V, [C], **kwargs)\n\n*X*, *Y* определяют расположение стрелок, *U*, *V* — направления стрелок, а\n*C* — необязательно цвет.\n\n**Длина стрелки**\n\nПо умолчанию длина стрелок автоматически масштабируется до разумного размера.\nЧтобы изменить это поведение, см. параметры *scale* и *scale_units*.\n\n**Форма стрелки**\n\nФорма стрелки определяется параметрами *width*, *headwidth*, *headlength* и\n*headaxislength*. См. примечания ниже.\n\n**Стиль стрелки**\n\nКаждая стрелка внутренне представляется заполненным многоугольником с\nшириной линии обводки по умолчанию 0. В результате стрелка представляет собой\nзаполненную область, а не линию со стрелой, и свойства `.PolyCollection`, такие\nкак *linewidth*, *edgecolor*, *facecolor* и т. д., действуют соответственно.\n\n\nПараметры\n----------\nX, Y : 1D или 2D массив, необязательно\n Координаты x и y расположения стрелок.\n\n Если не заданы, они будут сгенерированы как равномерная сетка целых чисел,\n основанная на размерах *U* и *V*.\n\n Если *X* и *Y* являются 1D, а *U*, *V* — 2D, *X*, *Y* расширяются до 2D\n с помощью ``X, Y = np.meshgrid(X, Y)``. В этом случае ``len(X)`` и ``len(Y)``\n должны соответствовать размерам столбцов и строк *U* и *V*.\n\nU, V : 1D или 2D массив\n Компоненты направления x и y векторов стрелок. Интерпретация этих\n компонент (в данных или в пространстве экрана) зависит от *angles*.\n\n *U* и *V* должны иметь одинаковое число элементов, соответствующее числу\n расположений стрелок в *X*, *Y*. *U* и *V* могут быть замаскированы. Расположения,\n замаскированные в любом из *U*, *V* и *C*, не будут отображаться.\n\nC : 1D или 2D массив, необязательно\n Числовые данные, которые определяют цвета стрелок путем сопоставления\n цветов с помощью *norm* и *cmap*.\n\n Это не поддерживает явные цвета. Если вы хотите задать цвета напрямую,\n используйте *color* вместо этого. Размер *C* должен соответствовать количеству\n расположений стрелок.\n\nangles : {\'uv\', \'xy\'} или массив, по умолчанию: \'uv\'\n Способ определения угла стрелок.\n\n - \'uv\': Направление стрелки в координатах экрана. Используйте это, если\n стрелки обозначают величину, не основанную на координатах данных *X*, *Y*.\n\n Если *U* == *V*, ориентация стрелки на графике составляет 45 градусов\n против часовой стрелки от горизонтальной оси (положительное значение —\n вправо).\n\n - \'xy\': Направление стрелки в координатах данных, т. е. стрелки указывают\n из (x, y) в (x+u, y+v). Используйте это, например, для построения поля\n градиента.\n\n - Произвольные углы могут быть заданы явно как массив значений\n в градусах, против часовой стрелки от горизонтальной оси.\n\n В этом случае *U*, *V* используются только для определения длины\n стрелок.\n\n Примечание: инвертирование оси данных будет соответственно инвертировать\n стрелки только с ``angles=\'xy\'``.\n\npivot : {\'tail\', \'mid\', \'middle\', \'tip\'}, по умолчанию: \'tail\'\n Часть стрелки, которая закреплена к сетке *X*, *Y*. Стрелка поворачивается\n вокруг этой точки.\n\n \'mid\' — синоним для \'middle\'.\n\nscale : float, необязательно\n Масштабирует длину стрелки обратно пропорционально.\n\n Количество единиц данных на единицу длины стрелки, например, м/с на\n единицу ширины графика; меньший параметр *scale* делает стрелку длиннее.\n Значение по умолчанию — *None*.\n\n Если *None*, используется простой алгоритм автоматического масштабирования,\n основанный на средней длине вектора и количестве векторов. Единица длины\n стрелки задается параметром *scale_units*.\n\nscale_units : {\'width\', \'height\', \'dots\', \'inches\', \'x\', \'y\', \'xy\'}, необязательно\n Если *scale* равен *None*, единица длины стрелки. Значение по умолчанию — *None*.\n\n Например, если *scale_units* — \'inches\', *scale* — 2.0, и ``(u, v) = (1, 0)``,\n то вектор будет длиной 0,5 дюйма.\n\n Если *scale_units* — \'width\' или \'height\', то вектор будет равен половине\n ширины/высоты осей.\n\n Если *scale_units* — \'x\', то вектор будет равен 0,5 единицы x-оси.\n Чтобы построить векторы в плоскости x-y, с u и v, имеющими те же\n единицы, что и x и y, используйте\n ``angles=\'xy\', scale_units=\'xy\', scale=1``.\n\nunits : {\'width\', \'height\', \'dots\', \'inches\', \'x\', \'y\', \'xy\'}, по умолчанию: \'width\'\n Воздействует на размер стрелки (кроме длины). В частности, ширина\n вала *width* измеряется в кратных этой единице.\n\n Допустимые значения:\n\n - \'width\', \'height\': Ширина или высота Axes.\n - \'dots\', \'inches\': Пиксели или дюймы, основанные на разрешении figure.\n - \'x\', \'y\', \'xy\': *X*, *Y* или :math:`\\sqrt{X^2 + Y^2}` в единицах данных.\n\n Следующая таблица суммирует, как эти значения влияют на видимый размер\n стрелки при масштабировании и изменении размера figure:\n\n ================= ================= ==================\n units zoom изменение размера figure\n ================= ================= ==================\n \'x\', \'y\', \'xy\' размер стрелки масштабируется -\n \'width\', \'height\' - размер стрелки масштабируется\n \'dots\', \'inches\' - -\n ================= ================= ==================\n\nwidth : float, необязательно\n Ширина вала в единицах стрелки. Все параметры головки относительны к *width*.\n\n Значение по умолчанию зависит от выбора *units* выше и количества векторов;\n типичное начальное значение составляет примерно 0,005 ширины графика.\n\nheadwidth : float, по умолчанию: 3\n Ширина головки как кратная ширине вала *width*. См. примечания ниже.\n\nheadlength : float, по умолчанию: 5\n Длина головки как кратная ширине вала *width*. См. примечания ниже.\n\nheadaxislength : float, по умолчанию: 4.5\n Длина головки в точке пересечения с валом как кратная ширине вала *width*.\n См. примечания ниже.\n\nminshaft : float, по умолчанию: 1\n Длина, ниже которой стрелка масштабируется, в единицах длины головки.\n Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут\n выглядеть ужасно!\n\nminlength : float, по умолчанию: 1\n Минимальная длина как кратная ширине вала; если длина стрелки\n меньше этого значения, вместо этого отображается точка (шестиугольник)\n такого диаметра.\n\ncolor : цвет или последовательность цветов, необязательно\n Явный(ые) цвет(а) для стрелок. Если *C* задан, *color* не влияет.\n\n Это синоним параметра `.PolyCollection` *facecolor*.\n\nДругие параметры\n----------------\ndata : индексируемый объект, необязательно\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs : свойства `~matplotlib.collections.PolyCollection`, необязательно\n Все остальные ключевые аргументы передаются в `.PolyCollection`:\n\n \n .. table::\n :class: property-table\n\n ================================================================================================= ==============================================================================================================================================================\n Свойство Описание \n ================================================================================================= ==============================================================================================================================================================\n :meth:`agg_filter
` функция фильтра, которая принимает массив (m, n, 3) float и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения\n :meth:`alpha ` массив или скаляр или None \n :meth:`animated ` bool \n :meth:`antialiased ` или aa или antialiaseds bool или список bool \n :meth:`array ` массив или None \n :meth:`capstyle ` `.CapStyle` или {\'butt\', \'projecting\', \'round\'} \n :meth:`clim ` (vmin: float, vmax: float) \n :meth:`clip_box ` `.Bbox` \n :meth:`clip_on ` bool \n :meth:`clip_path ` Patch или (Path, Transform) или None \n :meth:`cmap ` `.Colormap` или str или None \n :meth:`color ` цвет или список rgba кортежей \n :meth:`edgecolor ` или ec или edgecolors цвет или список цветов или \'face\' \n :meth:`facecolor ` или facecolors или fc цвет или список цветов \n :meth:`figure ` `.Figure` \n :meth:`gid ` str \n :meth:`hatch ` {\'/\', \'\\\\\', \'|\', \'-\', \'+\', \'x\', \'o\', \'O\', \'.\', \'*\'} \n :meth:`in_layout ` bool \n :meth:`joinstyle ` `.JoinStyle` или {\'miter\', \'round\', \'bevel\'} \n :meth:`label ` объект \n :meth:`linestyle ` или штрихи или linestyles или ls str или кортеж или список таковых \n :meth:`linewidth ` или linewidths или lw float или список float \n :meth:`mouseover ` bool \n :meth:`norm ` `.Normalize` или str или None \n :meth:`offset_transform ` или transOffset неизвестно \n :meth:`offsets ` (N, 2) или (2,) массив \n :meth:`path_effects ` `.AbstractPathEffect` \n :meth:`paths ` список массивов \n :meth:`picker ` None или bool или float или callable \n :meth:`pickradius ` неизвестно \n :meth:`rasterized ` bool \n :meth:`sizes ` ndarray или None \n :meth:`sketch_params ` (scale: float, length: float, randomness: float) \n :meth:`snap ` bool или None \n :meth:`transform ` `.Transform` \n :meth:`url ` str \n :meth:`urls ` список str или None \n :meth:`verts ` список массивов \n :meth:`verts_and_codes ` неизвестно \n :meth:`visible ` bool \n :meth:`zorder ` float \n ================================================================================================= ==============================================================================================================================================================\n\n\nВозвращает\n-------\n`~matplotlib.quiver.Quiver`\n\nСм. также\n--------\n.Axes.quiverkey : Добавить ключ к графику стрелок.\n\nПримечания\n-----\n\n**Форма стрелки**\n\nСтрелка рисуется как многоугольник, используя узлы, как показано ниже. Значения\n*headwidth*, *headlength* и *headaxislength* выражены в единицах *width*.\n\n.. image:: /_static/quiver_sizes.svg\n :width: 500px\n\nЗначения по умолчанию дают слегка загнутую назад стрелку. Вот некоторые рекомендации, как\nполучить другие формы головки:\n\n- Чтобы сделать головку треугольником, сделайте *headaxislength* равным *headlength*.\n- Чтобы сделать стрелку более заостренной, уменьшите *headwidth* или увеличьте *headlength*\n и *headaxislength*.\n- Чтобы сделать головку меньше по отношению к валу, пропорционально уменьшите все параметры головки.\n- Чтобы полностью убрать головку, установите все параметры *head* в 0.\n- Чтобы получить головку в форме ромба, сделайте *headaxislength* больше, чем *headlength*.\n- Предупреждение: для *headaxislength* < (*headlength* / *headwidth*) "головка" будет нестандартной.
- '\nОтображение 2D поля стрелок.\n\nВызов: \n\n quiver([X, Y], U, V, [C], **kwargs)\n\n*X*, *Y* определяют расположение стрелок, *U*, *V* — направления стрелок, а\n*C* — необязательно цвет.\n\n**Длина стрелки**\n\nПо умолчанию длина стрелок автоматически масштабируется до разумного размера.\nЧтобы изменить это поведение, см. параметры *scale* и *scale_units*.\n\n**Форма стрелки**\n\nФорма стрелки определяется параметрами *width*, *headwidth*, *headlength* и\n*headaxislength*. См. примечания ниже.\n\n**Стиль стрелки**\n\nКаждая стрелка внутренне представляется заполненным многоугольником с\nшириной линии обводки по умолчанию 0. В результате стрелка представляет собой\nзаполненную область, а не линию со стрелой, и свойства `.PolyCollection`, такие\nкак *linewidth*, *edgecolor*, *facecolor* и т. д., действуют соответственно.\n\n\nПараметры\n----------\nX, Y : 1D или 2D массив, необязательно\n Координаты x и y расположения стрелок.\n\n Если не заданы, они будут сгенерированы как равномерная сетка целых чисел,\n основанная на размерах *U* и *V*.\n\n Если *X* и *Y* являются 1D, а *U*, *V* — 2D, *X*, *Y* расширяются до 2D\n с помощью ``X, Y = np.meshgrid(X, Y)``. В этом случае ``len(X)`` и ``len(Y)``\n должны соответствовать размерам столбцов и строк *U* и *V*.\n\nU, V : 1D или 2D массив\n Компоненты направления x и y векторов стрелок. Интерпретация этих\n компонент (в данных или в пространстве экрана) зависит от *angles*.\n\n *U* и *V* должны иметь одинаковое число элементов, соответствующее числу\n расположений стрелок в *X*, *Y*. *U* и *V* могут быть замаскированы. Расположения,\n замаскированные в любом из *U*, *V* и *C*, не будут отображаться.\n\nC : 1D или 2D массив, необязательно\n Числовые данные, которые определяют цвета стрелок путем сопоставления\n цветов с помощью *norm* и *cmap*.\n\n Это не поддерживает явные цвета. Если вы хотите задать цвета напрямую,\n используйте *color* вместо этого. Размер *C* должен соответствовать количеству\n расположений стрелок.\n\nangles : {\'uv\', \'xy\'} или массив, по умолчанию: \'uv\'\n Способ определения угла стрелок.\n\n - \'uv\': Направление стрелки в координатах экрана. Используйте это, если\n стрелки обозначают величину, не основанную на координатах данных *X*, *Y*.\n\n Если *U* == *V*, ориентация стрелки на графике составляет 45 градусов\n против часовой стрелки от горизонтальной оси (положительное значение —\n вправо).\n\n - \'xy\': Направление стрелки в координатах данных, т. е. стрелки указывают\n из (x, y) в (x+u, y+v). Используйте это, например, для построения поля\n градиента.\n\n - Произвольные углы могут быть заданы явно как массив значений\n в градусах, против часовой стрелки от горизонтальной оси.\n\n В этом случае *U*, *V* используются только для определения длины\n стрелок.\n\n Примечание: инвертирование оси данных будет соответственно инвертировать\n стрелки только с ``angles=\'xy\'``.\n\npivot : {\'tail\', \'mid\', \'middle\', \'tip\'}, по умолчанию: \'tail\'\n Часть стрелки, которая закреплена к сетке *X*, *Y*. Стрелка поворачивается\n вокруг этой точки.\n\n \'mid\' — синоним для \'middle\'.\n\nscale : float, необязательно\n Масштабирует длину стрелки обратно пропорционально.\n\n Количество единиц данных на единицу длины стрелки, например, м/с на\n единицу ширины графика; меньший параметр *scale* делает стрелку длиннее.\n Значение по умолчанию — *None*.\n\n Если *None*, используется простой алгоритм автоматического масштабирования,\n основанный на средней длине вектора и количестве векторов. Единица длины\n стрелки задается параметром *scale_units*.\n\nscale_units : {\'width\', \'height\', \'dots\', \'inches\', \'x\', \'y\', \'xy\'}, необязательно\n Если *scale* равен *None*, единица длины стрелки. Значение по умолчанию — *None*.\n\n Например, если *scale_units* — \'inches\', *scale* — 2.0, и ``(u, v) = (1, 0)``,\n то вектор будет длиной 0,5 дюйма.\n\n Если *scale_units* — \'width\' или \'height\', то вектор будет равен половине\n ширины/высоты осей.\n\n Если *scale_units* — \'x\', то вектор будет равен 0,5 единицы x-оси.\n Чтобы построить векторы в плоскости x-y, с u и v, имеющими те же\n единицы, что и x и y, используйте\n ``angles=\'xy\', scale_units=\'xy\', scale=1``.\n\nunits : {\'width\', \'height\', \'dots\', \'inches\', \'x\', \'y\', \'xy\'}, по умолчанию: \'width\'\n Воздействует на размер стрелки (кроме длины). В частности, ширина\n вала *width* измеряется в кратных этой единице.\n\n Допустимые значения:\n\n - \'width\', \'height\': Ширина или высота Axes.\n - \'dots\', \'inches\': Пиксели или дюймы, основанные на разрешении figure.\n - \'x\', \'y\', \'xy\': *X*, *Y* или :math:`\\sqrt{X^2 + Y^2}` в единицах данных.\n\n Следующая таблица суммирует, как эти значения влияют на видимый размер\n стрелки при масштабировании и изменении размера figure:\n\n ================= ================= ==================\n units zoom изменение размера figure\n ================= ================= ==================\n \'x\', \'y\', \'xy\' размер стрелки масштабируется -\n \'width\', \'height\' - размер стрелки масштабируется\n \'dots\', \'inches\' - -\n ================= ================= ==================\n\nwidth : float, необязательно\n Ширина вала в единицах стрелки. Все параметры головки относительны к *width*.\n\n Значение по умолчанию зависит от выбора *units* выше и количества векторов;\n типичное начальное значение составляет примерно 0,005 ширины графика.\n\nheadwidth : float, по умолчанию: 3\n Ширина головки как кратная ширине вала *width*. См. примечания ниже.\n\nheadlength : float, по умолчанию: 5\n Длина головки как кратная ширине вала *width*. См. примечания ниже.\n\nheadaxislength : float, по умолчанию: 4.5\n Длина головки в точке пересечения с валом как кратная ширине вала *width*.\n См. примечания ниже.\n\nminshaft : float, по умолчанию: 1\n Длина, ниже которой стрелка масштабируется, в единицах длины головки.\n Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут\n выглядеть ужасно!\n\nminlength : float, по умолчанию: 1\n Минимальная длина как кратная ширине вала; если длина стрелки\n меньше этого значения, вместо этого отображается точка (шестиугольник)\n такого диаметра.\n\ncolor : цвет или последовательность цветов, необязательно\n Явный(ые) цвет(а) для стрелок. Если *C* задан, *color* не влияет.\n\n Это синоним параметра `.PolyCollection` *facecolor*.\n\nДругие параметры\n----------------\ndata : индексируемый объект, необязательно\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs : свойства `~matplotlib.collections.PolyCollection`, необязательно\n Все остальные ключевые аргументы передаются в `.PolyCollection`:\n\n \n .. table::\n :class: property-table\n\n ================================================================================================= ==============================================================================================================================================================\n Свойство Описание \n ================================================================================================= ==============================================================================================================================================================\n :meth:`agg_filter
- стрелки (т. е. те, которые соединяют головку с хвостовой частью) будут выступать из головки в переднем направлении, так что головка стрелки будет выглядеть прерванной. '
- set(*, UVC=<НЕ УСТАНОВЛЕНО>, agg_filter=<НЕ УСТАНОВЛЕНО>, alpha=<НЕ УСТАНОВЛЕНО>, animated=<НЕ УСТАНОВЛЕНО>, antialiased=<НЕ УСТАНОВЛЕНО>, array=<НЕ УСТАНОВЛЕНО>, capstyle=<НЕ УСТАНОВЛЕНО>, clim=<НЕ УСТАНОВЛЕНО>, clip_box=<НЕ УСТАНОВЛЕНО>, clip_on=<НЕ УСТАНОВЛЕНО>, clip_path=<НЕ УСТАНОВЛЕНО>, cmap=<НЕ УСТАНОВЛЕНО>, color=<НЕ УСТАНОВЛЕНО>, edgecolor=<НЕ УСТАНОВЛЕНО>, facecolor=<НЕ УСТАНОВЛЕНО>, gid=<НЕ УСТАНОВЛЕНО>, hatch=<НЕ УСТАНОВЛЕНО>, in_layout=<НЕ УСТАНОВЛЕНО>, joinstyle=<НЕ УСТАНОВЛЕНО>, label=<НЕ УСТАНОВЛЕНО>, linestyle=<НЕ УСТАНОВЛЕНО>, linewidth=<НЕ УСТАНОВЛЕНО>, mouseover=<НЕ УСТАНОВЛЕНО>, norm=<НЕ УСТАНОВЛЕНО>, offset_transform=<НЕ УСТАНОВЛЕНО>, offsets=<НЕ УСТАНОВЛЕНО>, path_effects=<НЕ УСТАНОВЛЕНО>, paths=<НЕ УСТАНОВЛЕНО>, picker=<НЕ УСТАНОВЛЕНО>, pickradius=<НЕ УСТАНОВЛЕНО>, rasterized=<НЕ УСТАНОВЛЕНО>, sizes=<НЕ УСТАНОВЛЕНО>, sketch_params=<НЕ УСТАНОВЛЕНО>, snap=<НЕ УСТАНОВЛЕНО>, transform=<НЕ УСТАНОВЛЕНО>, url=<НЕ УСТАНОВЛЕНО>, urls=<НЕ УСТАНОВЛЕНО>, verts=<НЕ УСТАНОВЛЕНО>, verts_and_codes=<НЕ УСТАНОВЛЕНО>, visible=<НЕ УСТАНОВЛЕНО>, zorder=<НЕ УСТАНОВЛЕНО>)[source]
-
Установить несколько свойств сразу.
Поддерживаемые свойства:
Свойство
Описание
неизвестно
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
массивоподобный объект, скаляр или None
bool
antialiasedили aa или antialiasedsbool или список bool
массивоподобный объект или None
CapStyleили {'butt', 'projecting', 'round'}(vmin: float, vmax: float)
bool
объект Patch или (Path, Transform) или None
Colormapили строка или Noneцвет или список кортежей RGBA
edgecolorили ec или edgecolorsцвет или список цветов или 'face'
facecolorили facecolors или fcцвет или список цветов
строка
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bool
JoinStyleили {'miter', 'round', 'bevel'}объект
linestyleили dashes или linestyles или lsстрока или кортеж или список кортежей
linewidthили linewidths или lwчисло с плавающей точкой или список чисел с плавающей точкой
bool
Normalizeили строка или Noneoffset_transformили transOffsetнеизвестно
(N, 2) или (2,) массивоподобный объект
список массивоподобных объектов
None или bool или число с плавающей точкой или вызываемая функция
неизвестно
bool
sizesмассив NumPy или None
(scale: float, length: float, randomness: float)
bool или None
строка
список строк или None
список массивоподобных объектов
неизвестно
bool
число с плавающей точкой
-
- set_UVC(U, V, C=None)[source]
Примеры использования matplotlib.quiver.Quiver
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/_as_gen/matplotlib.quiver.Quiver.html