collections

matplotlib.collections

Классы для эффективного отображения больших коллекций объектов, у которых общие свойства, например, большое количество отрезков линий или многоугольников.

Эти классы не так гибкие, как их аналоги для отдельных элементов (например, вы не сможете выбрать все стили линий), но они предназначены для быстрой работы в распространённых случаях (например, большом наборе сплошных отрезков линий).

class matplotlib.collections.AsteriskPolygonCollection(numsides, rotation=0, sizes=(1, ), **kwargs)

Базы: matplotlib.collections.RegularPolyCollection

Отображает набор правильных звездочек с numsides точками.

numsides

количество сторон многоугольника

rotation

угол поворота многоугольника в радианах

sizes

указывает площадь окружности, описанной вокруг правильного многоугольника, в точках^2

Допустимые ключевые аргументы для коллекции:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)

offsets и transOffset используются для перемещения фигуры после отрисовки (по умолчанию без смещений)

Если любой из edgecolors, facecolors, linewidths, antialiaseds равен None, они по умолчанию принимают значение из настроек matplotlib.rcParams для фигуры, в последовательном порядке.

Пример: см. examples/dynamic_collection.py для полного примера:

offsets = np.random.rand(20,2)
facecolors = [cm.jet(x) for x in np.random.rand(20)]
black = (0,0,0,1)

collection = RegularPolyCollection(
    numsides=5, # a pentagon
    rotation=0, sizes=(50,),
    facecolors = facecolors,
    edgecolors = (black,),
    linewidths = (1,),
    offsets = offsets,
    transOffset = ax.transData,
    )

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, которое полезно для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

Добавляет запись в словарь логических флагов, которые устанавливаются в True, когда изменяется отображаемая информация.

aname = 'Artist'

autoscale()

Автоматически масштабирует пределы скалярных значений в экземпляре norm с использованием текущего массива.

autoscale_None()

Автоматически масштабирует пределы скалярных значений в экземпляре norm с использованием текущего массива, изменяя только пределы, которые равны None.

axes

Экземпляр Axes, в котором находится объект, или None.

changed()

Вызовите эту функцию, когда изменится отображаемая информация, чтобы уведомить все слушатели обратного вызова о сигнале ‘changed’.

check_update(checker)

Если отображаемая информация изменилась с момента последней проверки, верните True; иначе верните False.

contains(mouseevent)

Проверяет, произошел ли сдвиг мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для элементов в осях, если ось x поддерживает единицы, преобразуйте x с использованием типа единиц оси x.

convert_yunits(y)

Для элементов в осях, если ось y поддерживает единицы, преобразуйте y с использованием типа единиц оси y.

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Находит объекты элементов.

Рекурсивно находит все экземпляры Artist, содержащиеся в self.

match может быть

• None: возвращает все объекты, содержащиеся в элементе.
• функция с сигнатурой boolean = match(artist) используется для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвращает только элементы типа класса.

Если include_self равно True (по умолчанию), self включается в список для проверки соответствия.

format_cursor_data(data)

Возвращает отформатированную строку cursor data.

get_agg_filter()

Возвращает функцию фильтра для использования с agg filter.

get_alpha()

Возвращает значение alpha, используемое для смешивания — не поддерживается на всех бэкэндах.

get_animated()

Возвращает состояние анимации элемента.

get_array()

Возвращает массив.

get_axes()

Возвращает экземпляр Axes, в котором находится объект, или None.

Это устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist элементов, которые содержит.

get_clim()

возвращает min и max пределов цвета для масштабирования изображения

get_clip_box()

Возвращает область обрезки элемента.

get_clip_on()

Возвращает, использует ли элемент обрезку.

get_clip_path()

Возвращает путь обрезки элемента.

get_cmap()

возвращает цветовую карту.

get_contains()

Возвращает _contains тест, используемый элементом, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные указателя для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

Возвращает, установлено ли заполнение.

get_gid()

Возвращает идентификатор группы.

get_hatch()

Возвращает текущий узор штриховки.

get_label()

Получить метку, используемую для этого элемента в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_numsides()

get_offset_position()

Возвращает способ применения смещений для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования master, то есть смещения заданы в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования master, то есть смещения заданы в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим элементом.

get_pickradius()

get_rasterized()

возвращает True, если элемент должен быть растрирован

get_rotation()

get_sizes()

Возвращает размеры элементов в коллекции. Значение представляет собой «площадь» элемента.

Возвращает:	sizes : массив «Площадь» каждого элемента.

get_sketch_params()

Возвращает параметры наброска для элемента.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебаний вдоль линии. randomness: Коэффициент масштабирования, по которому длина сжимается или расширяется. Может вернуть None, если параметры наброска не были установлены.

get_snap()

Возвращает настройку привязки, которая может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим элементом.

get_transformed_clip_path_and_affine()

Возвращает обрезной путь с применённой неаффинной частью его преобразования и оставшейся аффинной частью его преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость элемента.

get_window_extent(renderer)

get_zorder()

Возвращает значение z-порядка элемента.

have_units()

Возвращает True, если единицы измерения установлены на осях x или y

hitlist(event)

Список дочерних элементов элемента, содержащих событие мыши event.

is_figure_set()

Возвращает True, если элемент присвоен Figure.

is_transform_set()

Возвращает True, если у Artist явно задано преобразование.

mouseover

pchanged()

Срабатывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний элемент вызовет событие выбора, если mouseevent находится над элементом, и у элемента установлен пикер.

pickable()

Возвращает True, если Artist можно выбрать.

properties()

Возвращает словарь, сопоставляющий имя свойства — значение для всех свойств элемента.

remove()

Удаляет элемент с фигуры, если это возможно. Эффект не будет виден до перерисовки фигуры, например, с matplotlib.axes.Axes.draw_idle(). Вызовите matplotlib.axes.Axes.relim() для обновления пределов осей, если необходимо.

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

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

remove_callback(oid)

Удаляет обратный вызов по его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Устанавливает свойства в пакетном режиме. Передайте kwargs для установки свойств. Будут обработаны коллизии имён свойств (например, если указаны и «color», и «facecolor», свойство с более высоким приоритетом устанавливается последним).

set_agg_filter(filter_func)

Установить функцию agg_filter.

set_alpha(alpha)

Установить альфа-прозрачность коллекции. alpha должно быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации элемента.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние сглаживания при отрисовке.

ПРИНИМАЕТ: булево значение или последовательность булевых значений

set_antialiaseds(aa)

Псевдоним для set_antialiased

set_array(A)

Установить массив изображения из массива numpy A

set_axes(axes)

Установить экземпляр Axes, в котором находится элемент, если таковой имеется.

Этот метод устарел в mpl 1.5, используйте свойство axes. Будет удален в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

Установить пределы нормы для масштабирования изображения; если vmin — последовательность длиной 2, интерпретировать её как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Установить обрезной Bbox элемента.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

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

Если False, элементы будут видны за пределами осей, что может привести к неожиданным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установите область обрезки элемента, которая может быть:

• экземпляром класса Patch (или его подкласса)

• a Path instance, in which case

  можно указать необязательный экземпляр Transform, который будет применён к пути перед использованием для обрезки.

• None, чтобы удалить область обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит область обрезки в соответствующий прямоугольник и установит область обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

установить цветовую карту для данных яркости

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты

set_color(c)

Установить цвет обводки и заливки.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для установки цвета обводки или заливки индивидуально.

set_contains(picker)

Замените тест принадлежности, используемый этим элементом. Новый селектор должен быть вызываемой функцией, которая определяет, попадает ли элемент на событие мыши:

hit, props = picker(artist, mouseevent)

Если событие мыши над элементом, возвращается hit = True, а props — словарь свойств, которые вы хотите вернуть с тестом принадлежности.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Установите цвет(цвета) обводки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют один и тот же цвет) или последовательностью спецификаций; если это последовательность, фигуры будут циклически перебирать последовательность.

Если c равно ‘face’, цвет обводки всегда будет совпадать с цветом заливки. Если это ‘none’, граница фигуры не будет нарисована.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Установите цвет(цвета) заливки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют один и тот же цвет) или последовательностью спецификаций; если это последовательность, фигуры будут циклически перебирать последовательность.

Если c равно ‘none’, фигура не будет закрашена.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) элемента.

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Установить шаблон штриховки.

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае выполняется вся указанная штриховка. Если буква повторяется, это увеличивает плотность штриховки этого шаблона.

Штриховка поддерживается только в PostScript, PDF, SVG и Agg-бекендах.

В отличие от других свойств, таких как ширина линии и цвета, штриховка может быть указана только для всей коллекции, а не для каждого её члена.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установить метку s для автоматической легенды.

ПРИНИМАЕТ: строку или что-либо, что можно напечатать с преобразованием ‘%s’.

set_linestyle(ls)

Установить стиль(стили) линии для коллекции.

linestyle	описание
'-' or 'solid'	сплошная линия
'--' or 'dashed'	пунктирная линия
'-.' or 'dashdot'	штрихпунктирная линия
':' or 'dotted'	штриховая линия

В качестве альтернативы можно предоставить кортеж с делениями в следующем формате:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, содержащий значения длины в точках.

ПРИНИМАЕТ: [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ |

(смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и больше, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Установите ширину линии(линий) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, фигуры будут циклически перебирать последовательность.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

установить экземпляр нормализации

set_offset_position(offset_position)

Установить способ применения смещений. Если offset_position равно ‘screen’ (по умолчанию), смещение применяется после применения основного преобразования, то есть смещения в координатах экрана. Если offset_position равно ‘data’, смещение применяется до основного преобразования, то есть смещения в координатах данных.

set_offsets(offsets)

Установите смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_path_effects(path_effects)

установить path_effects, которые должны быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths()

set_picker(picker)

Установить эпсилон для выбора, используемый этим элементом.

picker может быть одним из следующих:

• None: выбор отключён для этого элемента (по умолчанию)
• Булево значение: если True, выбор будет включён, и элемент будет генерировать событие выбора, если курсор мыши находится над элементом
• Число с плавающей точкой: если picker — число, оно интерпретируется как значение эпсилон-толерантности в пунктах, и элемент будет генерировать событие, если его данные находятся в пределах эпсилон от события мыши. Для некоторых элементов, таких как линии и коллекции фигуры, элемент может предоставить дополнительные данные в событие выбора, например, индексы данных в пределах эпсилон от события выбора

• Функция: если picker — вызываемая функция, это пользовательская функция, которая определяет, попадает ли элемент на событие мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения теста попадания. Если курсор мыши над элементом, верните hit=True, а props — словарь свойств, которые вы хотите добавить к атрибутам PickEvent.

ПРИНИМАЕТ: [None|число с плавающей точкой|булево|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Принудительно использовать растрирование (битовое отображение) в выходных данных векторного бэкэнда.

По умолчанию None, что подразумевает поведение по умолчанию бэкэнда.

ПРИНИМАЕТ: [True | False | None]

set_sizes(sizes, dpi=72.0)

Установите размеры каждого элемента коллекции.

Параметры:	sizes : массив ndarray или None Размер для каждого элемента коллекции. Значение — «площадь» элемента. dpi : float Точки на дюйм (dpi) холста. По умолчанию 72.0.

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры эскиза.

Параметры:	scale : float, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если scale равно None, или не указано, фильтр эскиза не будет применён. length : float, необязательно Длина колебания вдоль линии в пикселях (по умолчанию 128.0). randomness : float, необязательно Коэффициент масштабирования, на который уменьшается или увеличивается длина (по умолчанию 16.0).

set_snap(snap)

Устанавливает параметр привязки, который может быть:

• True: вершины привязываются к ближайшему центру пикселя
• False: вершины остаются без изменений
• None: (автоматический) если путь содержит только прямолинейные отрезки, округляются до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Устанавливает экземпляр Transform, используемый этим элементом.

ПРИНИМАЕТ: экземпляр Transform.

set_url(url)

Устанавливает URL для элемента.

ПРИНИМАЕТ: строку URL.

set_urls(urls)

set_visible(b)

Устанавливает видимость элемента.

ПРИНИМАЕТ: [True | False].

set_zorder(level)

Устанавливает порядок элемента по оси z. Элементы с меньшими значениями zorder рисуются первыми.

ПРИНИМАЕТ: любое число.

stale

Если элемент «неактуален» и требует перерисовки для соответствия внутреннему состоянию.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x — это 1-мерная или 2-мерная последовательность скаляров, и будет возвращён соответствующий массив ndarray значений rgba, основанный на установленной норме и цветовой карте для этого объекта ScalarMappable.

Существует один специальный случай для обработки изображений, которые уже представлены в формате rgb или rgba, например, считанных из файла изображения. Если x — это массив ndarray с 3 измерениями, и последнее измерение равно 3 или 4, он будет обработан как массив rgb или rgba и никакого отображения не будет выполнено. Если последнее измерение равно 3, параметр alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, параметр alpha игнорируется; он не заменит уже существующее значение альфа-канала. Будет выброшено исключение ValueError, если третье измерение не равно 3 или 4.

В любом случае, если bytes — False (по умолчанию), массив rgba будет содержать числа с плавающей запятой в диапазоне от 0 до 1; если True, возвращаемый массив rgba будет содержать целые числа uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входной данные хорошо структурированы; он не проверяет такие аномалии, как x, являющийся маской rgba, или целым типом, отличным от uint8, или массивом rgba с плавающей запятой, значения которого находятся вне диапазона от 0 до 1.

update(props)

Обновляет свойства этого Artist из словаря prop.

update_from(other)

Копирует свойства из other в self.

update_scalarmappable()

Если массив объекта scalar mappable не равен None, обновляет цвета из скалярных данных.

zorder = 0

class matplotlib.collections.BrokenBarHCollection(xranges, yrange, **kwargs)

Bases: matplotlib.collections.PolyCollection

Совокупность горизонтальных столбцов, охватывающих yrange с последовательностью xranges.

xranges

последовательность (xmin, xwidth)

yrange

ymin, ywidth

Допустимые ключевые аргументы Collection:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)

offsets и transOffset используются для перемещения области после отрисовки (по умолчанию без смещения)

Если какие-либо из edgecolors, facecolors, linewidths, antialiaseds равны None, они по умолчанию принимают значение из настроек matplotlib.rcParams в последовательной форме.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() позднее.

add_checker(checker)

Добавляет запись в словарь флагов Boolean, которые устанавливаются в значение True, когда изменяется mappable.

aname = 'Artist'

autoscale()

Автомасштабирование пределов скалярных значений на экземпляре norm с использованием текущего массива

autoscale_None()

Автомасштабирование пределов скалярных значений на экземпляре norm с использованием текущего массива, изменяя только пределы, которые равны None

axes

Экземпляр Axes, в котором находится объект-художник, или None.

changed()

Вызывайте эту функцию всякий раз, когда mappable изменяется, чтобы уведомить все слушателей callbackSM о сигнале ‘changed’

check_update(checker)

Если mappable изменился с последней проверки, верните True; иначе верните False

contains(mouseevent)

Проверка, произошла ли событие мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для объектов-художников в осях, если ось x поддерживает единицы измерения, преобразуйте x с использованием типа единиц измерения оси x

convert_yunits(y)

Для объектов-художников в осях, если ось y поддерживает единицы измерения, преобразуйте y с использованием типа единиц измерения оси y

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов художников.

Рекурсивный поиск всех экземпляров Artist, содержащихся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция с сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Вернуть только художников указанного класса.

Если include_self True (по умолчанию), добавить self в список для проверки соответствия.

format_cursor_data(data)

Возвращает отформатированную строку данных курсора.

get_agg_filter()

Возвращает функцию фильтра для использования с agg-фильтром

get_alpha()

Возвращает значение альфа для смешивания - не поддерживается во всех бэкэндах

get_animated()

Возвращает состояние анимации художника

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится объект-художник, или None.

Устарело в mpl 1.5, используйте свойство axes. Удалено в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist элементов.

get_clim()

Возвращает минимальное и максимальное значения цветовых пределов для масштабирования изображения.

get_clip_box()

Возвращает область обрезки объекта-художника

get_clip_on()

Возвращает, использует ли объект-художник обрезку.

get_clip_path()

Возвращает путь обрезки объекта-художника

get_cmap()

Возвращает карту цветов

get_contains()

Возвращает тест _contains, используемый объектом-художником, или None для значения по умолчанию.

get_cursor_data(event)

Получение данных курсора для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

Возвращает экземпляр Figure, которому принадлежит объект-художник.

get_fill()

Возвращает, установлен ли залив.

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий шаблон штриховки

get_label()

Возвращает метку, используемую для этого объекта-художника в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает, как применяются смещения для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования master, то есть смещения находятся в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования master, то есть смещения находятся в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект picker, используемый этим объектом-художником.

get_pickradius()

get_rasterized()

возвращает True, если объект должен быть растрирован

get_sizes()

Возвращает размеры элементов в коллекции. Значение представляет «площадь» элемента.

Возвращает:	sizes : массив «Площадь» каждого элемента.

get_sketch_params()

Возвращает параметры размытия для объекта.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебаний вдоль линии. randomness: Коэффициент масштабирования, с помощью которого длина сжимается или растягивается. Может возвращать None, если параметры размытия не были заданы.

get_snap()

Возвращает настройку привязки, которая может быть:

• True: вершины привязываются к ближайшему центру пикселя
• False: вершины остаются как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округляется до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает объект Transform, используемый этим объектом.

get_transformed_clip_path_and_affine()

Возвращает путь обрезки с примененной неаффинной частью преобразования и оставшейся аффинной частью преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость объекта.

get_window_extent(renderer)

get_zorder()

Возвращает значение z-порядка объекта.

have_units()

Возвращает True, если единицы измерения установлены на осях x или y

hitlist(event)

Список потомков объекта, содержащих событие мыши event.

is_figure_set()

Возвращает True, если объект присвоен Figure.

is_transform_set()

Возвращает True, если у объекта Artist явно задано преобразование.

mouseover

pchanged()

Срабатывает событие при изменении свойства, вызывая все зарегистрированные обработчики.

pick(mouseevent)

подпись:

pick(mouseevent)

каждый дочерний объект будет генерировать событие pick, если mouseevent находится над объектом и у объекта установлен picker

pickable()

Возвращает True, если Artist можно выбрать.

properties()

Возвращает словарь, сопоставляющий имя свойства -> значение для всех свойств объекта.

remove()

Удаляет объект из фигуры, если это возможно. Эффект не будет виден до перерисовки фигуры, например, с помощью matplotlib.axes.Axes.draw_idle(). Вызовите matplotlib.axes.Axes.relim() для обновления пределов осей, если необходимо.

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

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

remove_callback(oid)

Удаляет обработчик на основе его id.

См. также

add_callback()

Для добавления обработчиков

set(**kwargs)

Установщик свойств в пакетном режиме. Передайте kwargs для установки свойств. Будет обрабатывать коллизии имен свойств (например, если указаны как «color», так и «facecolor», свойство с более высоким приоритетом устанавливается последним).

set_agg_filter(filter_func)

установить функцию agg_filter.

set_alpha(alpha)

Установить альфа-прозрачность коллекции. alpha должен быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации объекта.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние антиалиасинга для рендеринга.

ПРИНИМАЕТ: Булево значение или последовательность булевых значений

set_antialiaseds(aa)

псевдоним для set_antialiased

set_array(A)

Установить массив изображения из массива numpy A

set_axes(axes)

Установить экземпляр Axes , в котором находится объект, если он есть.

Это устарело в mpl 1.5, используйте свойство axes. Удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

установить пределы нормализации для масштабирования изображения; если vmin является последовательностью длиной 2, интерпретировать ее как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Установить область обрезки объекта Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Установить, использовать ли обрезку художника.

Если False, объекты будут видны за пределами осей, что может привести к непредсказуемым результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установите область обрезки для элемента, которая может быть:

• экземпляр класса Patch (или его подкласс)

• a Path instance, in which case

  дополнительный экземпляр Transform может быть предоставлен, который будет применён к пути перед его использованием для обрезки.

• None, для удаления области обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит область обрезки соответствующему прямоугольнику и установит область обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

установите цветовое отображение для данных яркости

ПРИНИМАЕТ: цветовое отображение или зарегистрированное имя цветового отображения

set_color(c)

Установите цвет обводки и заливки.

ПРИНИМАЕТ: matplotlib цвет или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для установки цвета обводки или заливки индивидуально.

set_contains(picker)

Замените тест на попадание, используемый этим элементом. Новый селектор должен быть вызываемой функцией, которая определяет, попадает ли мышь по элементу:

hit, props = picker(artist, mouseevent)

Если курсор мыши находится над элементом, верните hit = True и props — словарь свойств, которые вы хотите получить с тестом попадания.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Установите цвет(ы) обводки коллекции. c может быть цветом matplotlib (все элементы имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, элементы будут циклически проходить по последовательности.

Если c равно ‘face’, цвет обводки всегда будет таким же, как цвет заливки. Если это ‘none’, граница элемента не будет нарисована.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Установите цвет(ы) заливки коллекции. c может быть цветом matplotlib (все элементы имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, элементы будут циклически проходить по последовательности.

Если c равно ‘none’, элемент не будет заливаться.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) элемента.

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Установить шаблон штриховки.

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае выполняются все указанные штриховки. Если одна и та же буква повторяется, это увеличивает плотность штриховки этого шаблона.

Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

В отличие от других свойств, таких как толщина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого элемента отдельно.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установить метку в s для автоматической легенды.

ПРИНИМАЕТ: строку или что-либо, что можно распечатать с преобразованием «%s».

set_linestyle(ls)

Установите стиль линии(й) для коллекции.

linestyle	описание
'-' or 'solid'	сплошная линия
'--' or 'dashed'	штриховая линия
'-.' or 'dashdot'	штрих-пунктирная линия
':' or 'dotted'	пунктирная линия

В качестве альтернативы можно предоставить кортеж пунктира следующего вида:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, содержащий значения включения и выключения чернил в пунктах.

ПРИНИМАЕТ: [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ |

(смещение, последовательность вкл.-выкл.-пунктира) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Установите ширину линии(й) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, элементы будут циклически проходить по последовательности.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

установить экземпляр нормализации

set_offset_position(offset_position)

Установить способ применения смещений. Если offset_position равен ‘screen’ (по умолчанию), смещение применяется после применения преобразования «мастер», т. е. смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется перед преобразованием «мастер», т. е. смещения в координатах данных.

set_offsets(offsets)

Установите смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_path_effects(path_effects)

установить эффекты пути, которые должны быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths(verts, closed=True)

Это позволяет отложить инициализацию вершин.

set_picker(picker)

Установить значение epsilon для выбора, используемого этим элементом.

picker может быть одним из следующих:

• None: выбор отключён для данного элемента (по умолчанию)
• Булево значение: если True, то выбор будет включён и элемент будет генерировать событие выбора, если курсор мыши находится над ним
• Число с плавающей точкой: если picker — число, оно интерпретируется как значение toleration epsilon в пунктах, и элемент будет генерировать событие, если его данные находятся в пределах epsilon от события мыши. Для некоторых элементов, таких как линии и коллекции элементов, элемент может предоставить дополнительные данные событию выбора, например, индексы данных в пределах epsilon от события выбора

• Вызываемая функция: если picker вызываемая функция, это функция, предоставленная пользователем, которая определяет, попадает ли элемент под действие курсора мыши:

  hit, props = picker(artist, mouseevent)
  

  чтобы определить тест попадания. Если курсор мыши находится над элементом, верните hit=True и props — словарь свойств, которые вы хотите добавить к атрибутам PickEvent.

ПРИНИМАЕТ: [None|float|boolean|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Принудительно выполнить растрирование (отображение битовой карты) в выходных данных векторного бэкенда.

По умолчанию None, что подразумевает поведение по умолчанию бэкенда

ПРИНИМАЕТ: [True | False | None]

set_sizes(sizes, dpi=72.0)

Установите размеры каждого элемента коллекции.

Параметры:	sizes : ndarray или None Размер, который нужно установить для каждого элемента коллекции. Значение — это «площадь» элемента. dpi : float Точки на дюйм холста. По умолчанию 72.0.

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры построения.

Параметры:	scale : float, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если scale равно None, или не предоставлено, фильтр построения не будет применён. length : float, необязательно Длина колебаний вдоль линии в пикселях (по умолчанию 128.0) randomness : float, необязательно Коэффициент масштабирования, на который уменьшается или увеличивается длина (по умолчанию 16.0)

set_snap(snap)

Устанавливает параметр привязки, который может быть:

• True: привязывать вершины к ближайшему центру пикселя
• False: оставлять вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Установите экземпляр Transform, используемый этим элементом.

ПРИНИМАЕТ: экземпляр Transform

set_url(url)

Устанавливает URL для элемента.

ПРИНИМАЕТ: строку URL

set_urls(urls)

set_verts(verts, closed=True)

Это позволяет отложить инициализацию вершин.

set_verts_and_codes(verts, codes)

Это позволяет инициализировать вершины с кодами пути.

set_visible(b)

Установите видимость элемента.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Установите z-порядок элемента. Элементы с меньшими значениями z-порядка рисуются первыми.

ПРИНИМАЕТ: любое число

static span_where(x, ymin, ymax, where, **kwargs)

Создайте BrokenBarHCollection для построения горизонтальных столбцов из областей в x, где where истинно. Столбцы изменяются по оси y от ymin до ymax

Возвращается BrokenBarHCollection. kwargs передаются в коллекцию.

stale

Если элемент «недействителен» и требуется повторное отображение для соответствия внутреннему состоянию элемента.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x является одномерной или двумерной последовательностью скаляров, и соответствующий массив значений rgba будет возвращён на основе установленной нормализации и цветовой карты для этого ScalarMappable.

Существует один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, загруженных из файла изображения. Если x является массивом с тремя измерениями, и последнее измерение равно 3 или 4, он будет обрабатываться как массив rgb или rgba, и никаких преобразований не будет выполнено. Если последнее измерение равно 3, параметр alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, параметр alpha игнорируется; он не заменяет существующую прозрачность. Если третье измерение не равно 3 или 4, будет вызвано исключение ValueError.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет представлен числами с плавающей точкой в диапазоне 0-1; если оно равно True, возвращаемый массив rgba будет представлен числами uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входные данные корректны; он не проверяет такие аномалии, как x, являющийся маской rgba, или являющийся целым типом, отличным от uint8, или являющимся массивом rgba с плавающей точкой, имеющим значения вне диапазона 0-1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Копировать свойства из other в self

update_scalarmappable()

Если массив скалярного отображения не равен None, обновить цвета из скалярных данных

zorder = 0

class matplotlib.collections.CircleCollection(sizes, **kwargs)

Bases: matplotlib.collections._CollectionWithSizes

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

sizes Указывает площадь окружности в пунктах^2

Допустимые ключевые аргументы коллекции:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)

offsets и transOffset используются для перемещения области после отрисовки (по умолчанию смещения отсутствуют)

Если любое из edgecolors, facecolors, linewidths, antialiaseds равно None, они по умолчанию принимают значение настроек matplotlib.rcParams области, в последовательном порядке.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

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

aname = 'Artist'

autoscale()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив

autoscale_None()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив, изменяя только пределы, которые равны None

axes

Экземпляр Axes, в котором находится элемент-артист, или None.

changed()

Вызывайте это всякий раз, когда изменяется сопоставитель, чтобы уведомить всех слушателей обратного вызова о событии «changed».

check_update(checker)

Если сопоставитель изменился с момента последней проверки, возвращает True; в противном случае возвращает False

contains(mouseevent)

Проверяет, произошла ли обработка события мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для элементов-артистов в осях, если ось x поддерживает единицы, преобразуйте x, используя тип единиц оси x

convert_yunits(y)

Для элементов-артистов в осях, если ось y поддерживает единицы, преобразуйте y, используя тип единиц оси y

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов-артистов.

Рекурсивно находит все экземпляры Artist, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в артисте.
• функция с сигнатурой boolean = match(artist) для фильтрации соответствий
• экземпляр класса: например, Line2D. Возвращать только артистов указанного типа класса.

Если include_self равно True (по умолчанию), добавить self в список для проверки соответствия.

format_cursor_data(data)

Возвращает отформатированную строку данных курсора.

get_agg_filter()

возвращает функцию фильтра для использования с фильтром agg

get_alpha()

Возвращает значение альфа-канала, используемое для смешивания — не поддерживается на всех бэкэндах

get_animated()

Возвращает состояние анимации артиста

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится элемент-артист, или None.

Этот метод устарел в mpl 1.5, используйте свойство axes. Будет удален в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist элементов.

get_clim()

возвращает минимальное и максимальное значения цветовых пределов для масштабирования изображения

get_clip_box()

Возвращает область обрезки артиста

get_clip_on()

Возвращает значение, указывающее, использует ли артист обрезку

get_clip_path()

Возвращает траекторию обрезки артиста

get_cmap()

возвращает карту цветов

get_contains()

Возвращает _contains-тест, используемый артистом, или None для значения по умолчанию.

get_cursor_data(event)

Получает данные курсора для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

возвращает значение, указывающее, установлено ли заполнение

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий узор штриховки

get_label()

Получает метку, используемую для этого артиста в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает способ применения смещений для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования master, то есть смещения находятся в координатах экрана. Если offset_position равен ‘data’, смещение применяется перед преобразованием master, то есть смещения находятся в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим артистом

get_pickradius()

get_rasterized()

возвращает True, если артист должен быть растрирован

get_sizes()

Возвращает размеры элементов в коллекции. Значение представляет собой «площадь» элемента.

Возвращает:	sizes : массив «Площадь» каждого элемента.

get_sketch_params()

Возвращает параметры наброска для объекта.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебаний вдоль линии. randomness: Коэффициент масштабирования, по которому длина сжимается или расширяется. Может вернуть None, если параметры наброска не были заданы.

get_snap()

Возвращает параметр привязки, который может быть:

• True: привязывать вершины к ближайшему центру пикселя
• False: оставлять вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим объектом.

get_transformed_clip_path_and_affine()

Возвращает путь обрезки с применённой неаффинной частью преобразования и оставшейся аффинной частью преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость объекта.

get_window_extent(renderer)

get_zorder()

Возвращает z-порядок объекта.

have_units()

Возвращает True, если единицы измерения заданы для осей x или y

hitlist(event)

Список дочерних объектов художника, содержащих событие мыши event.

is_figure_set()

Возвращает True, если объект присвоен фигуре Figure.

is_transform_set()

Возвращает True, если у объекта Artist явно задано преобразование.

mouseover

pchanged()

Вызывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний объект-художник вызовет событие выбора, если событие мыши mouseevent находится над ним и для него установлено свойство picker.

pickable()

Возвращает True, если объект Artist может быть выбран.

properties()

Возвращает словарь, сопоставляющий имя свойства —> значение для всех свойств объекта-художника.

remove()

Удаляет объект из фигуры, если это возможно. Эффект не будет виден до перерисовки фигуры, например, с помощью matplotlib.axes.Axes.draw_idle(). Вызов matplotlib.axes.Axes.relim() для обновления пределов осей, если нужно.

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

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

remove_callback(oid)

Удаляет обратный вызов по его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Метод для пакетного задания свойств. Передайте kwargs для задания свойств. Будет обрабатывать конфликты имен свойств (например, если указаны как «color», так и «facecolor», свойство с более высоким приоритетом будет установлено последним).

set_agg_filter(filter_func)

Устанавливает функцию agg_filter.

set_alpha(alpha)

Устанавливает альфа-прозрачность коллекции. alpha должно быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Устанавливает состояние анимации объекта.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Устанавливает состояние сглаживания для рендеринга.

ПРИНИМАЕТ: Булево значение или последовательность булевых значений

set_antialiaseds(aa)

Псевдоним для set_antialiased

set_array(A)

Устанавливает массив изображения из массива NumPy A

set_axes(axes)

Устанавливает экземпляр Axes, в котором находится объект, если таковой имеется.

Устарело в mpl 1.5, используйте свойство axes. Удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

Устанавливает пределы нормализации для масштабирования изображения; если vmin — последовательность длиной 2, интерпретируется как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Устанавливает область обрезки объекта Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Устанавливает, использует ли объект обрезку.

Когда False, объекты будут видны за пределами осей, что может привести к неожиданным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Устанавливает путь обрезки объекта, который может быть:

• экземпляром Patch (или подкласса)

• a Path instance, in which case

  Дополнительный экземпляр Transform может быть передан, который будет применяться к пути перед использованием его для обрезки.

• None, для удаления пути обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит ограничивающую прямоугольную область в соответствии с прямоугольником и установит путь обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

Устанавливает цветовую карту для данных яркости.

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты

set_color(c)

Устанавливает цвет контура и заливки.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для установки цвета контура или заливки индивидуально.

set_contains(picker)

Заменяет тест на попадание, используемый данным элементом. Новый селектор должен быть вызываемой функцией, которая определяет, попадает ли элемент по нажатию мыши:

hit, props = picker(artist, mouseevent)

Если нажатие мыши происходит над элементом, верните hit = True, а props — словарь свойств, которые вы хотите вернуть с тестом на попадание.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Устанавливает цвет контура(ов) коллекции. c может быть спецификацией цвета matplotlib (все элементы имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, элементы будут циклически использовать значения из последовательности.

Если c равно ‘face’, цвет контура всегда будет таким же, как цвет заливки. Если это ‘none’, граница элемента не будет отрисовываться.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Устанавливает цвет заливки(ок) коллекции. c может быть спецификацией цвета matplotlib (все элементы имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, элементы будут циклически использовать значения из последовательности.

Если c равно ‘none’, элемент не будет заливаться.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) для элемента

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Устанавливает узор штриховки

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут комбинироваться, в этом случае выполняются все указанные узоры штриховки. Если буква повторяется, это увеличивает плотность штриховки данного узора.

Штриховка поддерживается только в PostScript, PDF, SVG и Agg backends.

В отличие от других свойств, таких как ширина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого элемента индивидуально.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Устанавливает метку для автоматической легенды.

ПРИНИМАЕТ: строку или любой печатный объект с преобразованием ‘%s’.

set_linestyle(ls)

Устанавливает стиль линии(й) для коллекции.

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	штриховая линия
'-.' или 'dashdot'	штрихпунктирная линия
':' или 'dotted'	пунктирная линия

В качестве альтернативы можно указать кортеж-последовательность в следующем формате:

(offset, onoffseq),

где onoffseq — это кортеж чётной длины, содержащий отступы и длины черт.

ПРИНИМАЕТ: [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ |

(смещение, последовательность длин черт) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Устанавливает ширину линии(й) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, элементы будут циклически использовать значения из последовательности.

ПРИНИМАЕТ: число или последовательность чисел

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

устанавливает экземпляр нормализации

set_offset_position(offset_position)

Устанавливает, как применяются смещения. Если offset_position равно ‘screen’ (по умолчанию), смещение применяется после применения преобразования «master», т. е. смещения задаются в координатах экрана. Если offset_position равно ‘data’, смещение применяется до преобразования «master», т. е. смещения задаются в координатах данных.

set_offsets(offsets)

Устанавливает смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число или последовательность чисел

set_path_effects(path_effects)

устанавливает path_effects, которые должны быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths()

set_picker(picker)

Устанавливает эпсилон для выделения, используемый данным элементом

picker может быть одним из следующих:

• None: выделение отключено для данного элемента (по умолчанию)
• Булево значение: если True, выделение будет включено, и элемент будет генерировать событие выделения, если курсор находится над элементом
• Число: если picker — число, оно интерпретируется как допуск эпсилон в точках, и элемент будет генерировать событие, если его данные находятся в пределах эпсилона от события мыши. Для некоторых элементов, таких как линии и коллекции фигур, элемент может предоставить дополнительные данные событию выделения, например, индексы данных, находящихся в пределах эпсилона от события выделения

• Функция: если picker является вызываемой функцией, это пользовательская функция, которая определяет, попадает ли элемент по нажатию мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения проверки на попадание. Если нажатие мыши происходит над элементом, верните hit=True и props — словарь свойств, которые вы хотите добавить к атрибутам PickEvent.

ПРИНИМАЕТ: [None|число|булево значение|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Принудительная отрисовка в растровом формате (битовая карта) в выходных данных векторного бэкенда.

По умолчанию значение None, что подразумевает поведение по умолчанию для бэкенда

ПРИНИМАЕТ: [True | False | None]

set_sizes(sizes, dpi=72.0)

Устанавливает размеры каждого элемента коллекции.

Параметры:	sizes : массив NumPy или None Размер, который необходимо установить для каждого элемента коллекции. Значение — «площадь» элемента. dpi : число dpi холста. По умолчанию 72.0.

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры черновика.

Параметры:	scale : число, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если scale равно None, или не указано, фильтр черновика не будет предоставлен. length : число, необязательно Длина колебаний вдоль линии в пикселях (по умолчанию 128.0) randomness : число, необязательно Коэффициент масштабирования, с помощью которого длина сжимается или расширяется (по умолчанию 16.0)

set_snap(snap)

Устанавливает параметры привязки, которые могут быть:

• True: привязка вершин к центрам ближайших пикселей
• False: оставить вершины как есть
• None: (авто) Если путь содержит только прямолинейные отрезки, округлять до ближайших центров пикселей

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Установите экземпляр Transform, используемый этим объектом.

ПРИНИМАЕТ: экземпляр Transform

set_url(url)

Устанавливает URL для объекта.

ПРИНИМАЕТ: строку URL.

set_urls(urls)

set_visible(b)

Устанавливает видимость объекта.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Устанавливает z-порядок для объекта. Объекты с меньшими значениями zorder рисуются первыми.

ПРИНИМАЕТ: любое число.

stale

Если объект «недействителен» и его нужно перерисовать, чтобы вывод соответствовал внутреннему состоянию объекта.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x является одномерной или двумерной последовательностью скаляров, и соответствующий массив ndarray значений rgba будет возвращен, основанный на норме и цветовой карте, установленной для этого ScalarMappable.

Существует один особый случай для обработки изображений, которые уже являются rgb или rgba, например, считанных из файла изображения. Если x является массивом ndarray с 3 измерениями, а последнее измерение равно 3 или 4, то он будет обработан как rgb или rgba массив, и никакое отображение не будет выполнено. Если последнее измерение равно 3, параметр alpha (по умолчанию 1) будет использоваться для заполнения прозрачности. Если последнее измерение равно 4, параметр alpha игнорируется; он не заменяет уже существующую альфа-компоненту. Будет возбуждено исключение ValueError, если третье измерение не равно 3 или 4.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет числами с плавающей точкой в диапазоне 0-1; если оно равно True, возвращаемый массив rgba будет uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входные данные корректны; он не проверяет такие аномалии, как x, являющийся замаскированным массивом rgba, или имеющий целочисленный тип, отличный от uint8, или являющийся массивом rgba с плавающей точкой со значениями за пределами диапазона 0-1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Копировать свойства из other в self

update_scalarmappable()

Если массив скалярного отображения не равен None, обновить цвета из скалярных данных.

zorder = 0

class matplotlib.collections.Collection(edgecolors=None, facecolors=None, linewidths=None, linestyles='solid', antialiaseds=None, offsets=None, transOffset=None, norm=None, cmap=None, pickradius=5.0, hatch=None, urls=None, offset_position='screen', zorder=1, **kwargs)

Базовые классы: matplotlib.artist.Artist, matplotlib.cm.ScalarMappable

Базовый класс для коллекций. Должен быть наследоваться, чтобы быть пригодным для использования.

Все свойства в коллекции должны быть последовательностями или скалярами; если скаляры, они будут преобразованы в последовательности. Свойство i-го элемента коллекции:

prop[i % len(props)]

Ключевые аргументы и значения по умолчанию:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• offset_position: ‘screen’ (по умолчанию) или ‘data’
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)
• hatch: None
• zorder: 1

offsets и transOffset используются для перемещения фигуры после отрисовки (по умолчанию нет смещений). Если offset_position равен ‘screen’ (по умолчанию), смещение применяется после применения преобразования мастера, то есть смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования мастера, то есть смещения в координатах данных.

Если любое из edgecolors, facecolors, linewidths, antialiaseds равно None, по умолчанию они принимают значение из настроек matplotlib.rcParams для фигуры, в виде последовательности.

Использование ScalarMappable необязательно. Если матрица ScalarMappable _A не равна None (т.е., был вызван set_array), во время отрисовки будет вызван метод скалярного отображения для установки цвета заполнения.

Создание коллекции

%(Collection)s

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда одно из свойств Artist изменяется.

Возвращает id, полезный для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

Добавляет запись в словарь логических флагов, которые устанавливаются в True, когда изменяется отображаемый объект.

aname = 'Artist'

autoscale()

Автоматически масштабировать пределы скаляров на экземпляре нормализации, используя текущий массив

autoscale_None()

Автоматически масштабировать пределы скаляров на экземпляре нормализации, используя текущий массив, изменяя только пределы, которые равны None

axes

Экземпляр Axes, в котором находится объект, или None.

changed()

Вызов этого метода, когда отображаемый объект изменяется, чтобы уведомить всех слушателей сигнала ‘changed’.

check_update(checker)

Если отображаемый объект изменился с момента последней проверки, вернуть True; иначе вернуть False

contains(mouseevent)

Проверить, произошёл ли сдвиг мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для элементов на оси, если ось x поддерживает единицы, преобразовать x, используя тип единиц оси x

convert_yunits(y)

Для элементов на оси, если ось y поддерживает единицы, преобразовать y, используя тип единиц оси y

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов художника.

Рекурсивно найти все Artist экземпляры, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция со сигнатурой boolean = match(artist) для фильтрации результатов
• экземпляр класса: например, Line2D. Вернуть только художников заданного типа.

Если include_self равно True (по умолчанию), включить self в список для проверки соответствия.

format_cursor_data(data)

Возвращает отформатированную строку данных указателя.

get_agg_filter()

возвращает функцию фильтра для использования с agg фильтром

get_alpha()

Возвращает значение альфа-канала, используемое для смешивания — не поддерживается во всех бэкендах

get_animated()

Возвращает состояние анимации художника

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится объект, или None.

Этот метод устарел в mpl 1.5, используйте свойство axes. Будет удалён в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist объектов.

get_clim()

возвращает минимальное и максимальное значения пределов цвета для масштабирования изображения

get_clip_box()

Возвращает область обрезки художника

get_clip_on()

Возвращает, используется ли обрезка художником

get_clip_path()

Возвращает путь обрезки художника

get_cmap()

возвращает карту цветов

get_contains()

Возвращает тест _contains, используемый художником, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные указателя для данного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

возвращает, установлено ли заполнение

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий узор штриховки

get_label()

Получить метку, используемую для этого художника в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает способ применения смещений для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования мастера, то есть смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования мастера, то есть смещения в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим элементом.

get_pickradius()

get_rasterized()

возвращает True, если элемент должен быть растрирован

get_sketch_params()

Возвращает параметры наброска для элемента.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебания вдоль линии. randomness: Коэффициент масштабирования, на который уменьшается или увеличивается длина. Может вернуть None, если параметры наброска не были установлены.

get_snap()

Возвращает установку snap, которая может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины как есть
• None: (авто) Если путь содержит только прямолинейные отрезки, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим элементом.

get_transformed_clip_path_and_affine()

Возвращает обрезку с примененной частью преобразования, не связанной с аффином, и оставшуюся аффинную часть преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость элемента.

get_window_extent(renderer)

get_zorder()

Возвращает значение z-порядка элемента.

have_units()

Возвращает True, если единицы установлены на осях x или y.

hitlist(event)

Список дочерних элементов элемента, содержащих событие мыши event.

is_figure_set()

Возвращает True, если элемент присвоен Figure.

is_transform_set()

Возвращает True, если у Artist явно задан трансформ.

mouseover

pchanged()

Вызывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний элемент вызовет событие pick, если mouseevent находится над элементом, и у элемента задан пикер.

pickable()

Возвращает True, если Artist можно выбирать.

properties()

возвращает словарь, сопоставляющий имя свойства со значением для всех свойств элемента.

remove()

Удаляет элемент из фигуры, если это возможно. Эффект будет виден только после перерисовки фигуры, например, с помощью matplotlib.axes.Axes.draw_idle(). Вызовите matplotlib.axes.Axes.relim(), чтобы обновить пределы осей, если нужно.

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

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

remove_callback(oid)

Удаляет обратный вызов по его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Установщик свойств. Передайте kwargs для установки свойств. Будет обрабатывать конфликты имен свойств (например, если указаны как «color», так и «facecolor», последнее будет установлено с более высоким приоритетом).

set_agg_filter(filter_func)

установить функцию agg_filter.

set_alpha(alpha)

Устанавливает прозрачность альфа коллекции. alpha должно быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Устанавливает состояние анимации элемента.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние антиалиасинга для рендеринга.

ПРИНИМАЕТ: логическое значение или последовательность логических значений

set_antialiaseds(aa)

псевдоним для set_antialiased

set_array(A)

Устанавливает массив изображения из массива numpy A

set_axes(axes)

Устанавливает экземпляр Axes, в котором находится элемент, если таковой имеется.

Это устарело в mpl 1.5, используйте свойство осей. Будет удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

установить пределы нормы для масштабирования изображения; если vmin является последовательностью длиной 2, интерпретировать ее как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Установить обрезку элемента Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Установить, использует ли элемент обрезку.

Когда False элементы будут видны за пределами осей, что может привести к неожиданным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установить обрезку элемента, которая может быть:

• экземпляр Patch (или подкласс)

• a Path instance, in which case

  Можно указать необязательный экземпляр Transform, который будет применен к пути перед использованием для обрезки.

• None, для удаления обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит прямоугольник обрезки соответствующему прямоугольнику и установит обрезку пути в None.

ПРИНИМАЕТ: [(Path, Transform) | Patch | None]

set_cmap(cmap)

установить цветовую карту для данных яркости

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты

set_color(c)

Установить цвет обводки и заливки.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для отдельного задания цвета обводки или заливки.

set_contains(picker)

Заменить тест на принадлежность, используемый этим объектом. Новый селектор должен быть вызываемой функцией, которая определяет, попадает ли по нажатию мыши на объект:

hit, props = picker(artist, mouseevent)

Если курсор мыши находится над объектом, возвращается hit = True и props — словарь свойств, которые требуется вернуть с тестом на принадлежность.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Установить цвет(а) обводки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить через последовательность.

Если c равно ‘face’, цвет обводки всегда будет таким же, как цвет заливки. Если это ‘none’, граница области не будет нарисована.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Установить цвет(а) заливки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить через последовательность.

Если c равно ‘none’, область не будет закрашена.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) для объекта

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Установить узор штриховки

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае выполняется вся указанная штриховка. Если одна и та же буква повторяется, плотность штриховки этого узора увеличивается.

Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

В отличие от других свойств, таких как толщина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого элемента по отдельности.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установить метку s для автоматической легенды.

ПРИНИМАЕТ: строку или любой печатаемый объект с преобразованием ‘%s’.

set_linestyle(ls)

Установить стиль(и) линии для коллекции.

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	штриховая линия
'-.' или 'dashdot'	штрихпунктирная линия
':' или 'dotted'	пунктирная линия

В качестве альтернативы можно указать кортеж штрихов в следующем формате:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, содержащий значения длины «включённых» и «выключённых» участков в пунктах.

ПРИНИМАЕТ: [‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ |

(смещение, последовательность на-выкл-штрих) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : {‘-‘, ‘–’, ‘-.’, ‘:’} и больше, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Установить толщину(ы) линии для коллекции. lw может быть скаляром или последовательностью; если это последовательность, области будут циклически проходить через последовательность

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

установить экземпляр нормализации

set_offset_position(offset_position)

Установить способ применения смещений. Если offset_position равно ‘screen’ (по умолчанию), смещение применяется после применения преобразования master, т. е. смещения задаются в экранных координатах. Если offset_position равно ‘data’, смещение применяется до преобразования master, т. е. смещения задаются в координатах данных.

set_offsets(offsets)

Установить смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_path_effects(path_effects)

установить path_effects, которые должны быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths()

set_picker(picker)

Установить эпсилон для выделения, используемый этим объектом

picker может быть одним из следующих:

• None: выделение отключено для этого объекта (по умолчанию)
• Булево значение: если True, выделение будет включено, и объект будет генерировать событие выделения, если курсор мыши находится над объектом
• Число с плавающей точкой: если picker — число, оно интерпретируется как значение эпсилон-допущения в пунктах, и объект будет генерировать событие, если его данные находятся в пределах эпсилон-допущения от события мыши. Для некоторых объектов, таких как линии и коллекции областей, объект может предоставлять дополнительные данные для события выделения, например, индексы данных, находящихся в пределах эпсилон-допущения от события выделения

• Функция: если picker — вызываемая функция, это функция, предоставляемая пользователем, которая определяет, попадает ли объект под нажатие мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения проверки попадания. Если курсор мыши находится над объектом, возвращается hit=True, а props — словарь свойств, которые требуется добавить к атрибутам PickEvent.

ПРИНИМАЕТ: [None|число с плавающей точкой|булево|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Вынудить растрированное (битовое) отображение в выходных данных векторного бэкенда.

По умолчанию равно None, что подразумевает поведение по умолчанию бэкенда

ПРИНИМАЕТ: [True | False | None]

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры наброска.

Параметры:

scale : число с плавающей точкой, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если scale равно None, или не указано, фильтр наброска не будет предоставлен. length : число с плавающей точкой, необязательно Длина колебаний вдоль линии в пикселях (по умолчанию 128.0) randomness : число с плавающей точкой, необязательно Множитель масштабирования, по которому длина уменьшается или увеличивается (по умолчанию 16.0)

set_snap(snap)

Устанавливает настройку привязки, которая может быть:

• True: привязывать вершины к ближайшему центру пикселя
• False: оставлять вершины как есть
• None: (авто) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Установить экземпляр Transform, используемый этим объектом.

ПРИНИМАЕТ: экземпляр Transform

set_url(url)

Установить URL для объекта

ПРИНИМАЕТ: строку URL

set_urls(urls)

set_visible(b)

Установить видимость элемента.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Установить порядок отрисовки элемента. Элементы с меньшими значениями zorder будут отрисованы раньше.

ПРИНИМАЕТ: любое число

stale

Если элемент «неактуален» и нуждается в повторной отрисовке, чтобы вывод соответствовал внутреннему состоянию элемента.

to_rgba(x, alpha=None, bytes=False)

Возвращает массив rgba, соответствующий x.

В обычном случае x — это последовательность скаляров 1D или 2D, и соответствующий массив ndarray значений rgba будет возвращён на основе установленной нормализации и цветовой карты для этого ScalarMappable.

Есть один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, таких, которые были прочитаны из файла изображения. Если x — это массив ndarray с 3 измерениями, и последнее измерение равно 3 или 4, то он будет рассматриваться как массив rgb или rgba, и никакое отображение не будет выполнено. Если последнее измерение равно 3, значение аргумента alpha (по умолчанию 1) будет использоваться для заполнения прозрачности. Если последнее измерение равно 4, аргумент alpha игнорируется; он не заменяет существующее значение альфа. Если третье измерение отличается от 3 или 4, будет вызвано исключение ValueError.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет представлен числами с плавающей точкой в диапазоне 0-1; если оно равно True, возвращаемый массив rgba будет представлен целыми числами uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входные данные корректны; он не проверяет такие аномалии, как x, являющийся массивом rgba с маской, или имеющий целочисленный тип, отличный от uint8, или имеющий массив rgba с плавающей точкой со значениями вне диапазона 0-1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Копировать свойства из other в self

update_scalarmappable()

Если массив скалярной карты не равен null, обновлять цвета из скалярных данных

zorder = 0

class matplotlib.collections.EllipseCollection(widths, heights, angles, units='points', **kwargs)

Bases: matplotlib.collections.Collection

Коллекция эллипсов, нарисованных с помощью сплайнов.

widths: последовательность

длина первой оси (например, длина большой оси)

heights: последовательность

длина второй оси

angles: последовательность

углы первой оси, градусы против часовой стрелки от оси X

units: [‘points’ | ‘inches’ | ‘dots’ | ‘width’ | ‘height’ | ‘x’ | ‘y’ | ‘xy’]

единицы измерения, в которых заданы главные и малые оси; ‘width’ и ‘height’ относятся к размерам осей, а ‘x’ и ‘y’ — к данным единицам измерения смещений. ‘xy’ отличается от всех остальных тем, что угол, отображаемый на графике, изменяется в зависимости от масштаба, и равен указанному углу только при единичном масштабе. Таким образом, он ведет себя так же, как Ellipse с axes.transData в качестве преобразования.

Дополнительные ключевые слова, унаследованные от базового Collection:

Допустимые ключевые аргументы коллекции:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)

offsets и transOffset используются для перемещения объекта после отрисовки (по умолчанию смещения отсутствуют)

Если какие-либо из edgecolors, facecolors, linewidths, antialiaseds равны None, они по умолчанию принимают значение из matplotlib.rcParams для объектов типа patch.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() в дальнейшем.

add_checker(checker)

Добавляет запись в словарь флагов boolean, которые устанавливаются в True, когда изменяется mappable.

aname = 'Artist'

autoscale()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив.

autoscale_None()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив, изменяя только отсутствующие пределы.

axes

Экземпляр Axes, в котором находится объект, или None.

changed()

Вызывайте эту функцию всякий раз, когда изменяется mappable, чтобы оповестить всех слушателей обратных вызовов signal ‘changed’

check_update(checker)

Если mappable изменился с момента последней проверки, возвращает True; иначе возвращает False

contains(mouseevent)

Проверяет, произошел ли щелчок мыши внутри коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для элементов на оси, если ось x поддерживает единицы измерения, преобразовать x используя тип единиц оси x

convert_yunits(y)

Для элементов на оси, если ось y поддерживает единицы измерения, преобразовать y используя тип единиц оси y

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов художников.

Рекурсивно находит все экземпляры Artist, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция с сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвратить только художников указанного класса.

Если include_self равно True (по умолчанию), добавить себя в список для проверки совпадения.

format_cursor_data(data)

Возвращает отформатированную строку данных курсора.

get_agg_filter()

возвращает функцию фильтра, используемую для agg фильтра

get_alpha()

Возвращает значение альфа, используемое для смешивания - не поддерживается во всех бэкендах

get_animated()

Возвращает состояние анимации художника

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится объект, или None.

Устарело в mpl 1.5, используйте свойство axes. Будет удалено в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist объектов.

get_clim()

Возвращает минимальное и максимальное значения пределов цвета для масштабирования изображения

get_clip_box()

Возвращает ограничивающую рамку объекта

get_clip_on()

Возвращает, использует ли объект обрезку

get_clip_path()

Возвращает обрезку объекта

get_cmap()

возвращает карту цветов

get_contains()

Возвращает тест _contains, используемый объектом, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные курсора для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

Возвращает экземпляр Figure, которому принадлежит объект.

get_fill()

Возвращает, установлено ли заполнение

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий шаблон штриховки

get_label()

Получить метку, используемую для этого объекта в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает, как применяются смещения для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения основного преобразования, то есть смещения задаются в координатах экрана. Если offset_position равен ‘data’, смещение применяется до основного преобразования, то есть смещения задаются в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим объектом.

get_pickradius()

get_rasterized()

возвращает True, если объект должен быть растрирован.

get_sketch_params()

Возвращает параметры наброска для объекта.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебаний вдоль линии. randomness: Коэффициент масштабирования, на который умножается длина. Может вернуть None если параметры наброска не были заданы.

get_snap()

Возвращает настройку сетки, которая может быть:

• True: привязывать вершины к ближайшему центру пикселя
• False: оставлять вершины без изменений
• None: (авто) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим объектом.

get_transformed_clip_path_and_affine()

Возвращает обрезной путь с применённой не-аффинной частью преобразования, и оставшуюся аффинную часть преобразования.

get_transforms()

get_url()

Возвращает URL.

get_urls()

get_visible()

Возвращает видимость объекта.

get_window_extent(renderer)

get_zorder()

Возвращает порядок отрисовки объекта.

have_units()

Возвращает True, если единицы измерения заданы для осей x или y.

hitlist(event)

Список дочерних элементов объекта, которые содержат событие мыши event.

is_figure_set()

Возвращает True, если объект прикреплён к Figure.

is_transform_set()

Возвращает True, если у Artist явно задано преобразование.

mouseover

pchanged()

Генерирует событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний объект сгенерирует событие выбора, если mouseevent наведён на него, и у него задан пикер.

pickable()

Возвращает True, если Artist можно выбрать.

properties()

Возвращает словарь, сопоставляющий имя свойства —> значение для всех свойств объекта.

remove()

Удаляет объект из графического окна, если возможно. Эффект будет виден после перерисовки графического окна, например, с помощью matplotlib.axes.Axes.draw_idle(). Используйте matplotlib.axes.Axes.relim(), чтобы обновить пределы осей, если нужно.

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

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

remove_callback(oid)

Удаляет обратный вызов по его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Сеттер для массовой установки свойств. Передайте kwargs для установки свойств. Будет обрабатывать коллизии имён свойств (например, если указаны «цвет» и «цвет_заливки», свойство с более высоким приоритетом устанавливается последним).

set_agg_filter(filter_func)

Установить функцию agg_filter.

set_alpha(alpha)

Задать альфа-прозрачность коллекции. alpha должно быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации объекта.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние сглаживания для отрисовки.

ПРИНИМАЕТ: Булево значение или последовательность булевых значений

set_antialiaseds(aa)

Псевдоним для set_antialiased

set_array(A)

Установить массив изображения из массива numpy A

set_axes(axes)

Установить экземпляр Axes, в котором находится объект, если таковой имеется.

Этот метод устарел в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалён в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

Установить пределы нормализации для масштабирования изображения; если vmin является последовательностью длины 2, интерпретировать её как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длины 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Установить обрезной Bbox объекта.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Установить, использует ли объект обрезку.

Если False, объекты будут видны за пределами осей, что может привести к неожиданным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установите область обрезки для объекта, которая может быть:

• экземпляром класса Patch (или его подкласса)

• a Path instance, in which case

  можно указать необязательный экземпляр Transform, который будет применён к пути перед использованием его для обрезки.

• None, чтобы удалить область обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит область обрезки соответствующему прямоугольнику и установит область обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

устанавливает карту цветов для данных яркости

ПРИНИМАЕТ: карту цветов или зарегистрированное имя карты цветов

set_color(c)

Устанавливает цвет обводки и заливки.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для установки цвета обводки или заливки индивидуально.

set_contains(picker)

Заменяет тест на принадлежность, используемый этим объектом. Новый селектор должен быть вызываемой функцией, определяющей, попадает ли объект под указанное событие мыши:

hit, props = picker(artist, mouseevent)

Если событие мыши находится над объектом, верните hit = True и props — словарь свойств, которые вы хотите получить с помощью теста на принадлежность.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Устанавливает цвет(цвета) обводки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить по последовательности.

Если c равно ‘face’, цвет обводки всегда будет таким же, как цвет заливки. Если это ‘none’, граница области не будет нарисована.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Устанавливает цвет(цвета) заливки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить по последовательности.

Если c равно ‘none’, область не будет закрашена.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор группы объекта.

ПРИНИМАЕТ: строковый идентификатор

set_hatch(hatch)

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

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае выполняется вся указанная штриховка. Если повторяется та же буква, она увеличивает плотность штриховки этого узора.

Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

В отличие от других свойств, таких как ширина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого члена по отдельности.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установить метку s для автоматической легенды.

ПРИНИМАЕТ: строку или любой печатаемый элемент с преобразованием «%s».

set_linestyle(ls)

Устанавливает стиль линии(линий) для коллекции.

linestyle	описание
'-' or 'solid'	сплошная линия
'--' or 'dashed'	штриховая линия
'-.' or 'dashdot'	штрихпунктирная линия
':' or 'dotted'	пунктирная линия

В качестве альтернативы можно указать кортеж пунктира следующего формата:

(offset, onoffseq),

где onoffseq — кортеж чётной длины чередующихся значений длины чередования и отступа в пунктах.

ПРИНИМАЕТ: [‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ |

(смещение, последовательность чередования) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Устанавливает ширину(ширины) линии(линий) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, области будут циклически проходить по последовательности

ПРИНИМАЕТ: число или последовательность чисел

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

устанавливает экземпляр нормализации

set_offset_position(offset_position)

Устанавливает способ применения смещений. Если offset_position равно ‘screen’ (по умолчанию), смещение применяется после применения преобразования master, то есть смещения заданы в экранных координатах. Если offset_position равно ‘data’, смещение применяется до преобразования master, т.е. смещения заданы в координатах данных.

set_offsets(offsets)

Устанавливает смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число или последовательность чисел

set_path_effects(path_effects)

устанавливает эффекты пути, которые должны быть списком экземпляров matplotlib.patheffect._Base или его производных.

set_paths()

set_picker(picker)

Устанавливает значение epsilon для выбора, используемое этим объектом.

picker может быть одним из следующих:

• None: выбор для данного объекта отключен (по умолчанию)
• Булево значение: если True, то выбор будет включён, и объект будет генерировать событие выбора, если курсор мыши находится над объектом
• Число с плавающей точкой: если picker — число, оно интерпретируется как значение толерантности epsilon в пунктах, и объект будет генерировать событие, если его данные находятся в пределах epsilon от события мыши. Для некоторых объектов, например, линий и коллекций областей, объект может предоставить дополнительные данные для события выбора, например, индексы данных в пределах epsilon от события выбора

• Функция: если picker — вызываемая функция, она — функция, предоставленная пользователем, которая определяет, попадает ли объект под указанное событие мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения теста на попадание. Если событие мыши находится над объектом, верните hit=True и props — словарь свойств, которые вы хотите добавить в атрибуты PickEvent.

ПРИНИМАЕТ: [None|число с плавающей точкой|boolean|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Вынуждает растровое (битовое) отображение в выходных данных векторного бэкенда.

По умолчанию равно None, что подразумевает поведение по умолчанию бэкенда

ПРИНИМАЕТ: [True | False | None]

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры наброска.

Параметры:	scale : float, optional Амплитуда колебаний, перпендикулярных исходной линии, в пикселях. Если scale равно None, или не указано, фильтр наброска не будет применён. length : float, optional Длина колебаний вдоль линии, в пикселях (по умолчанию 128.0) randomness : float, optional Коэффициент масштабирования, на который укорачивается или увеличивается длина (по умолчанию 16.0)

set_snap(snap)

Устанавливает настройку привязки, которая может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины без изменений
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Устанавливает экземпляр Transform, используемый этим элементом.

ПРИНИМАЕТ: экземпляр Transform.

set_url(url)

Устанавливает URL для элемента.

ПРИНИМАЕТ: строку URL.

set_urls(urls)

set_visible(b)

Устанавливает видимость элемента.

ПРИНИМАЕТ: [True | False].

set_zorder(level)

Устанавливает z-порядок для элемента. Элементы с меньшими значениями zorder рисуются первыми.

ПРИНИМАЕТ: любое число.

stale

Если элемент «неактуален» и необходимо перерисовать его, чтобы вывод соответствовал внутреннему состоянию элемента.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x — это одномерная или двумерная последовательность скаляров, и будет возвращён соответствующий массив ndarray значений rgba, основанный на норме и цветовой карте, установленных для этого ScalarMappable.

Есть один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, прочитанными из файла изображения. Если x — это ndarray с 3 измерениями, и последнее измерение — 3 или 4, то он будет рассматриваться как массив rgb или rgba и не будет выполнено отображение. Если последнее измерение — 3, то параметр alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение — 4, то параметр alpha игнорируется; он не заменяет существующий alpha. Будет возбуждено исключение ValueError, если третье измерение не равно 3 или 4.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет представлять собой числа с плавающей точкой в диапазоне от 0 до 1; если True, возвращаемый массив rgba будет представлять собой целые числа uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входной сигнал корректен; он не проверяет такие аномалии, как x являющийся маской rgba, или являющийся целочисленным типом, отличным от uint8, или являющимся массивом rgba с плавающей точкой со значениями за пределами диапазона 0-1.

update(props)

Обновляет свойства этого Artist из словаря prop.

update_from(other)

Копирует свойства из other в self.

update_scalarmappable()

Если массив скалярного отображаемого элемента не равен None, обновляет цвета из скалярных данных.

zorder = 0

class matplotlib.collections.EventCollection(positions, orientation=None, lineoffset=0, linelength=1, linewidth=None, color=None, linestyle='solid', antialiased=None, **kwargs)

Bases: matplotlib.collections.LineCollection

Коллекция дискретных событий.

Событие — это одномерное значение, обычно положение чего-либо по оси, например, время или длина. События не имеют амплитуды. Они отображаются как v

positions

последовательность числовых значений или одномерный массив NumPy. Может быть None

orientation [ ‘horizontal’ | ‘vertical’ | None ]

по умолчанию ‘horizontal’, если не указано или None

lineoffset

единичное числовое значение, соответствующее смещению центра маркера от начала координат

linelength

единичное числовое значение, соответствующее общей высоте маркера (т.е. маркер простирается от lineoffset+linelength/2 до lineoffset-linelength/2). По умолчанию 1

linewidth

единичное числовое значение

color

должна быть последовательность кортежей RGBA (например, произвольные строковые обозначения цвета и т. п., недопустимы).

linestyle [ ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ]

antialiased

1 или 2

Если linewidth, color или antialiased равно None, они принимают значения по умолчанию из rcParams.

norm

None (необязательно для matplotlib.cm.ScalarMappable)

cmap

None (необязательно для matplotlib.cm.ScalarMappable)

pickradius — это допуск для щелчков мышью при выделении линии. По умолчанию 5 пунктов.

Использование ScalarMappable необязательно. Если массив ScalarMappable _A не равен None (т. е. был выполнен вызов set_array()), во время отрисовки будет выполнен вызов scalar mappable для установки цветов.

Пример:

(Исходный код, png, hires.png, pdf)

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

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

add_positions(position)

добавить одно или несколько событий в указанных позициях

aname = 'Artist'

append_positions(position)

добавить одно или несколько событий в указанных позициях

autoscale()

Автоматически масштабировать скалярные пределы в экземпляре norm с использованием текущего массива

autoscale_None()

Автоматически масштабировать скалярные пределы в экземпляре norm с использованием текущего массива, изменяя только пределы, которые равны None

axes

Экземпляр Axes, в котором находится объект, или None.

changed()

Вызывается всякий раз, когда изменяется сопоставимый с картой объект, чтобы уведомить всех слушателей обратного вызова сигнала «изменено»

check_update(checker)

Если сопоставимая с картой фигура изменилась с момента последней проверки, вернуть True; иначе вернуть False

contains(mouseevent)

Проверить, произошел ли мышиный щелчок в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в списке itemlist содержит событие.

convert_xunits(x)

Для объектов в осях, если ось x поддерживает единицы измерения, преобразовать x с помощью типа единиц измерения оси x

convert_yunits(y)

Для объектов в осях, если ось y поддерживает единицы измерения, преобразовать y с помощью типа единиц измерения оси y

draw(artist, renderer, *args, **kwargs)

extend_positions(position)

добавить одно или несколько событий в указанных позициях

findobj(match=None, include_self=True)

Найти объекты-артисты.

Рекурсивно найти все экземпляры Artist, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция со сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвратить только артистов указанного класса.

Если include_self равно True (по умолчанию), включить self в список для проверки соответствия.

format_cursor_data(data)

Возвратить отформатированную строку данных курсора.

get_agg_filter()

вернуть функцию фильтра для использования с agg фильтром

get_alpha()

Возвратить значение альфа, используемое для смешивания — не поддерживается на всех бэкендах

get_animated()

Возвращает состояние анимации объекта

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится объект, или None.

Это устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist объектов.

get_clim()

Возвращает мин и макс пределы цветов для масштабирования изображения

get_clip_box()

Возвращает область обрезки объекта

get_clip_on()

Возвращает, использует ли объект обрезку

get_clip_path()

Возвращает путь обрезки объекта

get_cmap()

Возвращает цветовой маппинг

get_color()

Получить цвет линий, используемых для маркировки каждого события

get_colors()

get_contains()

Возвращает проверку _contains, используемую объектом, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные курсора для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

Возвращает экземпляр Figure, к которому принадлежит объект.

get_fill()

Возвращает, установлено ли заполнение

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий шаблон штриховки

get_label()

Получить метку, используемую для этого объекта-художника в легенде.

get_linelength()

Получить длину линий, используемых для обозначения каждого события

get_lineoffset()

Получить смещение линий, используемых для обозначения каждого события

get_linestyle()

Получить стиль линий, используемых для обозначения каждого события [‘сплошная’ | ‘пунктирная’ | ‘штрихпунктирная’ | ‘точечная’]

get_linestyles()

get_linewidth()

Получить ширину линий, используемых для обозначения каждого события

get_linewidths()

get_offset_position()

Возвращает, как применяются смещения для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования master, то есть смещения находятся в координатах экрана. Если offset_position равен ‘data’, смещение применяется перед преобразованием master, то есть смещения находятся в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_orientation()

Получить ориентацию линии события, может быть: [‘горизонтальная’ | ‘вертикальная’]

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим объектом-художником

get_pickradius()

get_positions()

возвращает массив, содержащий плавающие значения позиций

get_rasterized()

возвращает True, если объект-художник должен быть растрирован

get_segments()

get_sketch_params()

Возвращает параметры наброска для объекта-художника.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебания перпендикулярно исходной линии. length: Длина колебания вдоль линии. randomness: Коэффициент масштабирования, с помощью которого длина уменьшается или увеличивается. Может вернуть None, если параметры наброска не были заданы.

get_snap()

Возвращает настройку привязки, которая может быть:

• True: привязка вершин к ближайшему центру пикселя
• False: оставить вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округлять до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим объектом-художником.

get_transformed_clip_path_and_affine()

Возвращает обрезной путь с применённой неаффинной частью его преобразования и оставшейся аффинной частью его преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость объекта-художника

get_window_extent(renderer)

get_zorder()

Возвращает значение zorder объекта-художника.

have_units()

Возвращает True, если единицы измерения установлены на осях x или y

hitlist(event)

Список потомков объекта-художника, которые содержат событие мыши event.

is_figure_set()

Возвращает True, если объект-художник назначен на Figure.

is_horizontal()

True, если eventcollection горизонтальная, False, если вертикальная

is_transform_set()

Возвращает True, если у Artist явно задано преобразование.

mouseover

pchanged()

Вызывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний объект-художник вызовет событие pick, если mouseevent находится над объектом-художником и у объекта-художника задан пикер

pickable()

Возвращает True, если Artist можно выбрать.

properties()

Возвращает словарь, отображающий имя свойства -> значение для всех свойств объекта-художника

remove()

Если это возможно, удаляет объект-художник из рисунка. Эффект будет виден только после перерисовки рисунка, например, с помощью matplotlib.axes.Axes.draw_idle(). Используйте matplotlib.axes.Axes.relim(), чтобы обновить пределы осей, если это необходимо.

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

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

remove_callback(oid)

Удаляет обратный вызов на основе его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Установщик свойств в пакете. Передайте kwargs для установки свойств. Будет обрабатывать коллизии имен свойств (например, если указаны как ‘color’, так и ‘facecolor’, последнее свойство с более высоким приоритетом устанавливается последним).

set_agg_filter(filter_func)

Устанавливает функцию agg_filter.

set_alpha(alpha)

Установить альфа-прозрачность коллекции. alpha должен быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации объекта-художника.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние антиалиасинга для рендеринга.

ПРИНИМАЕТ: булево значение или последовательность булевых значений

set_antialiaseds(aa)

Псевдоним для set_antialiased

set_array(A)

Установить массив изображения из массива numpy A

set_axes(axes)

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

Это устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

Устанавливает пределы масштабирования нормы изображения; если vmin является последовательностью длины 2, интерпретируйте её как (vmin, vmax), что используется для поддержки setp.

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Устанавливает область обрезки художника Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Устанавливает, использует ли художник обрезку.

Если False, художники будут видны за пределами осей, что может привести к непредсказуемым результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Устанавливает путь обрезки художника, который может быть:

• экземпляр Patch (или подкласс)

• a Path instance, in which case

  Можно указать необязательный экземпляр Transform, который будет применён к пути перед использованием его для обрезки.

• None, чтобы удалить путь обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит соответствующую прямоугольную область обрезки и установит путь обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

устанавливает палитру цветов для данных яркости

ПРИНИМАЕТ: палитру цветов или зарегистрированное имя палитры

set_color(c)

Установите цвет(ы) коллекции линий. c может быть аргументом цвета matplotlib (все области имеют один и тот же цвет) или последовательностью или кортежами rgba; если это последовательность, области будут циклически проходить по последовательности.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

set_contains(picker)

Замените тест на содержание, используемый этим художником. Новый пикер должен быть вызываемой функцией, которая определяет, попадает ли художник под событие мыши:

hit, props = picker(artist, mouseevent)

Если событие мыши находится над художником, верните hit = True, а props — словарь свойств, которые вы хотите вернуть с тестом на попадание.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Установите цвет(ы) обводки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить по последовательности.

Если c равно ‘face’, цвет обводки всегда будет таким же, как и цвет заливки. Если это ‘none’, граница области не будет нарисована.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Установите цвет(ы) заливки коллекции. c может быть спецификацией цвета matplotlib (все области имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, области будут циклически проходить по последовательности.

Если c равно ‘none’, область не будет залита.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) для художника

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Установите узор штриховки

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут комбинироваться, в этом случае все указанные штриховки выполняются. Если одна и та же буква повторяется, это увеличивает плотность штриховки этого узора.

Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

В отличие от других свойств, таких как ширина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого члена отдельно.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установите метку в s для автоматической легенды.

ПРИНИМАЕТ: строку или что-либо печатное с преобразованием ‘%s’.

set_linelength(linelength)

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

set_lineoffset(lineoffset)

устанавливает смещение линий, используемых для обозначения каждого события

set_linestyle(ls)

Устанавливает стиль(и) линии для коллекции.

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	пунктирная линия
'-.' или 'dashdot'	штрихпунктирная линия
':' или 'dotted'	штриховая линия

В качестве альтернативы можно предоставить кортеж штрихов следующего вида:

(offset, onoffseq),

где onoffseq — кортеж чётной длины с длительностью заливки и отсутствия чернил в пунктах.

ПРИНИМАЕТ: [‘сплошная’ | ‘пунктирная’, ‘штрихпунктирная’, ‘штриховая’ |

(смещение, последовательность включения/выключения штриха) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и более, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Устанавливает ширину(ы) линии для коллекции. lw может быть скаляром или последовательностью; если это последовательность, области будут циклически проходить по последовательности.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

устанавливает экземпляр нормализации

set_offset_position(offset_position)

Установите способ применения смещений. Если offset_position равен ‘screen’ (по умолчанию), смещение применяется после применения преобразования основного объекта, т. е. смещения находятся в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования основного объекта, т. е. смещения находятся в координатах данных.

set_offsets(offsets)

Установите смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_orientation(orientation=None)

установить ориентацию линии событий [ ‘горизонтальная’ | ‘вертикальная’ | None ], по умолчанию ‘горизонтальная’, если не указано или None

set_path_effects(path_effects)

установить path_effects, который должен быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths(segments)

set_picker(picker)

Установите эпсилон для выбора, используемый этим объектом.

picker может быть одним из следующих:

• None: выбор отключен для этого объекта (по умолчанию)
• Булево значение: если True, выбор будет включён, и объект сгенерирует событие выбора, если курсор мыши находится над объектом
• Число с плавающей точкой: если picker является числом, оно интерпретируется как значение толерантности эпсилон в точках, и объект сгенерирует событие, если его данные находятся в пределах эпсилон от события мыши. Для некоторых объектов, таких как линии и коллекции объектов patch, объект может предоставить дополнительные данные событию выбора, например, индексы данных в пределах эпсилон от события выбора

• Функция: если picker является вызываемым объектом, это пользовательская функция, которая определяет, попадает ли объект под курсор мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения проверки попадания. Если курсор мыши находится над объектом, вернуть hit=True, а props — словарь свойств, которые нужно добавить к атрибутам PickEvent.

ПРИНИМАЕТ: [None|float|boolean|callable]

set_pickradius(pr)

set_positions(positions)

Установить позиции событий на указанное значение

set_rasterized(rasterized)

Вынужденное растровое (битовое) отображение в выходных данных векторного бэкэнда.

По умолчанию None, что подразумевает поведение по умолчанию бэкэнда.

ПРИНИМАЕТ: [True | False | None]

set_segments(segments)

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры наброска.

Параметры:	scale : float, необязательно Амплитуда колебания перпендикулярно исходной линии в пикселях. Если scale равно None, или не указано, фильтр наброска не будет применён. length : float, необязательно Длина колебания вдоль линии в пикселях (по умолчанию 128.0) randomness : float, необязательно Коэффициент масштабирования, на который уменьшается или увеличивается длина (по умолчанию 16.0)

set_snap(snap)

Устанавливает параметр snap, который может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины в исходном виде
• None: (автоматически) Если путь содержит только прямолинейные сегменты, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Установите Transform экземпляр, используемый этим объектом.

ПРИНИМАЕТ: Transform экземпляр

set_url(url)

Устанавливает URL для объекта.

ПРИНИМАЕТ: строку URL.

set_urls(urls)

set_verts(segments)

set_visible(b)

Установить видимость объекта.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Установить z-порядок объекта. Объекты с меньшими значениями zorder рисуются первыми.

ПРИНИМАЕТ: любое число

stale

Если объект «засохший» и нуждается в перерисовке, чтобы вывод соответствовал внутреннему состоянию объекта.

switch_orientation()

Переключает ориентацию линии события, либо с вертикальной на горизонтальную, либо наоборот.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x — это 1-мерная или 2-мерная последовательность скаляров, и соответствующий массив ndarray значений rgba будет возвращён на основе нормы и цветовой карты, установленных для этого ScalarMappable.

Существует один особый случай для обработки изображений, которые уже являются rgb или rgba, например, прочитанных из файла изображения. Если x — это массив ndarray с 3 измерениями, а последнее измерение — 3 или 4, то он будет рассматриваться как массив rgb или rgba, и никакого сопоставления не будет выполнено. Если последнее измерение — 3, аргумент alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение — 4, аргумент alpha игнорируется; он не заменяет уже существующую прозрачность. ValueError будет поднят, если третье измерение отличается от 3 или 4.

В любом случае, если bytes — False (по умолчанию), массив rgba будет представлен числами с плавающей точкой в диапазоне 0-1; если True, возвращаемый массив rgba будет представлен целыми числами uint8 в диапазоне 0-255.

Примечание: этот метод предполагает, что входной массив корректен; он не проверяет аномалии, такие как x, являющийся маской массива rgba или целым типом, отличным от uint8, или массивом rgba с плавающей точкой, содержащим значения вне диапазона 0-1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Копирует свойства из других в себя.

update_scalarmappable()

Если массив скалярного отображаемого объекта не равен None, обновить цвета по скалярным данным.

zorder = 0

class matplotlib.collections.LineCollection(segments, linewidths=None, colors=None, antialiaseds=None, linestyles='solid', offsets=None, transOffset=None, norm=None, cmap=None, pickradius=5, zorder=2, facecolors='none', **kwargs)

Базы: matplotlib.collections.Collection

Все параметры должны быть последовательностями или скалярами; если скаляры, они будут преобразованы в последовательности. Свойство i-го отрезка линии:

prop[i % len(props)]

т. е., свойства циклически повторяются, если количество свойств len меньше количества отрезков.

segments

последовательность (line0, line1, line2), где:

linen = (x0, y0), (x1, y1), ... (xm, ym)

или эквивалентная массив NumPy с двумя столбцами. Длина каждой линии может быть разной.

colors

должна быть последовательность кортежей RGBA (например, произвольные строковые обозначения цветов и т. д. не допускаются).

antialiaseds

должна быть последовательность единиц или нулей

linestyles [ ‘сплошная’ | ‘штриховая’ | ‘штрихпунктирная’ | ‘пунктирная’ ]

строка или кортеж штрихов. Кортеж штрихов:

(offset, onoffseq),

где onoffseq — кортеж чётной длины значений включения и выключения чернил в пунктах.

Если linewidths, colors или antialiaseds равно None, они по умолчанию принимают значения из rcParams, в виде последовательностей.

Если offsets и transOffset не равны None, тогда offsets преобразуются с помощью transOffset и применяются после того, как отрезки были преобразованы в координаты отображения.

Если offsets не равно None, но transOffset равно None, тогда offsets добавляются к отрезкам до любого преобразования. В этом случае одиночный сдвиг можно указать как:

offsets=(xo,yo)

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

norm

None (необязательно для matplotlib.cm.ScalarMappable)

cmap

None (необязательно для matplotlib.cm.ScalarMappable)

pickradius — допустимое отклонение для нажатия мышью при выделении линии. По умолчанию 5 пунктов.

zorder

Z-порядок LineCollection. По умолчанию 2

facecolors

Цвет заливки LineCollection. По умолчанию ‘none’. Установка значения отличного от ‘none’ приведёт к отрисовке заполненного многоугольника между точками на каждой линии.

Использование ScalarMappable необязательно. Если массив ScalarMappable _A не равен None (т. е., был вызван set_array()), при отрисовке будет вызвано обращение к скалярной отображаемой переменной для установки цветов.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() позднее.

add_checker(checker)

Добавляет запись в словарь флагов типа bool, которые устанавливаются в True, когда изменяется отображаемый объект.

aname = 'Artist'

autoscale()

Автомасштабирование пределов скаляров в экземпляре norm с использованием текущего массива

autoscale_None()

Автомасштабирование пределов скаляров в экземпляре norm с использованием текущего массива, изменяя только пределы, равные None

axes

Экземпляр Axes, в котором находится объект, или None.

changed()

Вызовите это, когда изменяется отображаемый объект, чтобы уведомить всех слушателей обратного вызова SM о сигнале ‘changed’

check_update(checker)

Если отображаемый объект изменился с момента последней проверки, верните True; в противном случае верните False

contains(mouseevent)

Проверяет, произошло ли событие мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для объектов в осях, если ось x поддерживает единицы, преобразовать x с помощью типа единиц оси x

convert_yunits(y)

Для объектов в осях, если ось y поддерживает единицы, преобразовать y с помощью типа единиц оси y

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Найти объекты художников.

Рекурсивно найти все Artist экземпляры, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция с сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвращать только художников указанного класса.

Если include_self True (по умолчанию), включить self в список, подлежащий проверке на соответствие.

format_cursor_data(data)

Возвращает отформатированную строку данных указателя.

get_agg_filter()

возвращает функцию фильтра для использования с agg фильтром

get_alpha()

Возвращает значение альфа, используемое для смешивания — не поддерживается на всех бэкендах

get_animated()

Возвращает состояние анимации художника

get_array()

Возвращает массив

get_axes()

Возвращает экземпляр Axes, в котором находится объект, или None.

Это было устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist объектов.

get_clim()

Возвращает минимальное и максимальное значение пределов цветов для масштабирования изображения

get_clip_box()

Возвращает область обрезки художника

get_clip_on()

Возвращает, используется ли художником обрезка

get_clip_path()

Возвращает путь обрезки художника

get_cmap()

Возвращает карту цветов

get_color()

get_colors()

get_contains()

Возвращает тест _contains, используемый художником, или None для значения по умолчанию.

get_cursor_data(event)

Получить данные указателя для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

возвращает, установлено ли заполнение

get_gid()

Возвращает идентификатор группы

get_hatch()

Возвращает текущий шаблон штриховки

get_label()

Получить метку, используемую для этого художника в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает способ применения смещений для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования «master», то есть смещения находятся в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования «master», то есть смещения находятся в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим объектом.

get_pickradius()

get_rasterized()

Возвращает True, если объект должен быть растрирован.

get_segments()

get_sketch_params()

Возвращает параметры наброска для объекта.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебаний перпендикулярно исходной линии. length: Длина колебаний вдоль линии. randomness: Коэффициент масштабирования, на который умножается длина. Может вернуть None если параметры наброска не были заданы.

get_snap()

Возвращает настройку привязки, которая может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр класса Transform, используемый этим объектом.

get_transformed_clip_path_and_affine()

Возвращает путь обрезки с применённой неаффинной частью его преобразования и оставшейся аффинной частью его преобразования.

get_transforms()

get_url()

Возвращает URL.

get_urls()

get_visible()

Возвращает видимость объекта.

get_window_extent(renderer)

get_zorder()

Возвращает порядок отрисовки объекта.

have_units()

Возвращает True, если единицы измерения заданы для осей x или y.

hitlist(event)

Список дочерних элементов объекта, содержащих событие мыши event.

is_figure_set()

Возвращает True, если объект привязан к Figure.

is_transform_set()

Возвращает True, если у объекта Artist явно задано преобразование.

mouseover

pchanged()

Срабатывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

сигнатура вызова:

pick(mouseevent)

каждый дочерний объект будет генерировать событие pick, если mouseevent находится над ним и у объекта установлен picker

pickable()

Возвращает True, если объект Artist может быть выбран.

properties()

Возвращает словарь, сопоставляющий имя свойства -> значение для всех свойств объекта.

remove()

Удаляет объект из фигуры, если это возможно. Эффект будет виден только после перерисовки фигуры, например, с помощью matplotlib.axes.Axes.draw_idle(). Вызовите matplotlib.axes.Axes.relim(), чтобы обновить пределы осей, если нужно.

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

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

remove_callback(oid)

Удаляет обратный вызов по его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Установщик свойств по партиям. Передайте kwargs для установки свойств. Будет обрабатывать конфликты имён свойств (например, если указаны и ‘color’, и ‘facecolor’, свойство с более высоким приоритетом будет установлено последним).

set_agg_filter(filter_func)

Установить функцию agg_filter.

set_alpha(alpha)

Установить прозрачность коллекции. alpha должно быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации объекта.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние сглаживания для рендеринга.

ПРИНИМАЕТ: Булево значение или последовательность булевых значений

set_antialiaseds(aa)

Синоним для set_antialiased.

set_array(A)

Установить массив изображений из массива numpy A.

set_axes(axes)

Установить экземпляр Axes, в котором находится объект, если таковой имеется.

Устарело в mpl 1.5, используйте свойство axes. Удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes.

set_clim(vmin=None, vmax=None)

установить пределы нормы для масштабирования изображения; если vmin является последовательностью длины 2, интерпретировать её как (vmin, vmax), что используется для поддержки setp

ПРИНИМАЕТ: последовательность длины 2 чисел с плавающей точкой.

set_clip_box(clipbox)

Установить ограничивающую рамку объекта обрезки Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox.

set_clip_on(b)

Установить, использует ли объект обрезку.

Если False, объекты будут видны вне осей, что может привести к неожиданным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установите область обрезки для элемента, которая может быть:

• экземпляр Patch (или подкласс)

• a Path instance, in which case

  может быть предоставлен необязательный экземпляр Transform, который будет применён к пути перед использованием для обрезки.

• None, чтобы удалить область обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит область обрезки соответствующему прямоугольнику и установит область обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

установить цветовое отображение для данных яркости

ПРИНИМАЕТ: цветовое отображение или зарегистрированное имя цветового отображения

set_color(c)

Устанавливает цвет(ы) коллекции линий. c может быть аргументом цвета matplotlib (все фигуры имеют одинаковый цвет) или последовательностью кортежей rgba; если это последовательность, фигуры будут перебирать последовательность.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

set_contains(picker)

Замените тест принадлежности, используемый этим элементом. Новый пикер должен быть вызываемой функцией, которая определяет, попадает ли элемент на событие мыши:

hit, props = picker(artist, mouseevent)

Если событие мыши находится над элементом, возвращается hit = True, а props — это словарь свойств, которые вы хотите получить с тестом принадлежности.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Установите цвет(ы) обводки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, фигуры будут перебирать последовательность.

Если c равно ‘face’, цвет обводки всегда будет таким же, как и цвет заливки. Если это ‘none’, граница фигуры не будет отображаться.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Установите цвет(ы) заливки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, фигуры будут перебирать последовательность.

Если c равно ‘none’, фигура не будет залита.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор (группы) для элемента.

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Установите узор штриховки.

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут быть объединены, в этом случае выполняются все указанные штриховки. Если одна и та же буква повторяется, она увеличивает плотность штриховки этого узора.

Штриховка поддерживается только в PostScript, PDF, SVG и Agg бэкендах.

В отличие от других свойств, таких как толщина линии и цвета, штриховку можно указать только для всей коллекции, а не для каждого элемента по отдельности.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Установите метку в s для автоматической легенды.

ПРИНИМАЕТ: строку или любой печатаемый объект с преобразованием ‘%s’.

set_linestyle(ls)

Установите стиль линии(ей) для коллекции.

linestyle	описание
'-' or 'solid'	сплошная линия
'--' or 'dashed'	штриховая линия
'-.' or 'dashdot'	штрихпунктирная линия
':' or 'dotted'	пунктирная линия

В качестве альтернативы можно указать кортеж тире следующего вида:

(offset, onoffseq),

где onoffseq — кортеж чётной длины значений включения и выключения чернил в пунктах.

ПРИНИМАЕТ: [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ |

(смещение, последовательность_вкл_выкл_штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Установите ширину(ы) линии(й) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, фигуры будут перебирать последовательность

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

установить экземпляр нормализации

set_offset_position(offset_position)

Установите способ применения смещений. Если offset_position равно ‘screen’ (по умолчанию), смещение применяется после применения преобразования master, то есть смещения находятся в координатах экрана. Если offset_position равно ‘data’, смещение применяется перед преобразованием master, т. е. смещения находятся в координатах данных.

set_offsets(offsets)

Установите смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_path_effects(path_effects)

установить path_effects, который должен быть списком экземпляров класса matplotlib.patheffect._Base или его производных.

set_paths(segments)

set_picker(picker)

Установить эпсилон для выбора, используемый этим элементом.

picker может быть одним из следующих:

• None: выбор отключён для этого элемента (по умолчанию)
• Булево значение: если True, выбор включён, и элемент сгенерирует событие выбора, если курсор находится над ним
• Число с плавающей точкой: если picker — число, оно интерпретируется как толерантность эпсилона в пунктах, и элемент сгенерирует событие, если его данные находятся в пределах эпсилона от события мыши. Для некоторых элементов, например, для линий и коллекций фигур, элемент может предоставить дополнительные данные для события выбора, например, индексы данных в пределах эпсилона от события выбора

• Функция: если picker — вызываемая функция, это функция, предоставляемая пользователем, которая определяет, попал ли элемент на событие мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения теста попадания. Если событие мыши находится над элементом, возвращается hit=True, и props — это словарь свойств, которые вы хотите добавить в атрибуты PickEvent.

ПРИНИМАЕТ: [None|число с плавающей точкой|булево значение|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Вынудительно выполнить растрирование (отображение в виде растрового изображения) в выводе векторного бэкенда.

По умолчанию равно None, что подразумевает поведение по умолчанию бэкенда.

ПРИНИМАЕТ: [True | False | None]

set_segments(segments)

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры наброска.

Параметры:	scale : float, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если scale равно None, или не указано, фильтр наброска не будет применён. length : float, необязательно Длина колебаний вдоль линии в пикселях (по умолчанию 128.0) randomness : float, необязательно Коэффициент масштабирования, с помощью которого длина уменьшается или увеличивается (по умолчанию 16.0)

set_snap(snap)

Устанавливает настройку привязки, которая может быть:

• True: привязать вершины к ближайшему центру пикселя
• False: оставить вершины как есть
• None: (автоматически) Если траектория содержит только прямолинейные отрезки, округлить до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Установить экземпляр Transform, используемый этим элементом графического интерфейса.

ПРИНИМАЕТ: экземпляр Transform

set_url(url)

Устанавливает URL для элемента графического интерфейса

ПРИНИМАЕТ: строку URL

set_urls(urls)

set_verts(segments)

set_visible(b)

Установить видимость элемента.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Установить z-порядок для элемента. Элементы с меньшими значениями z-порядка рисуются первыми.

ПРИНИМАЕТ: любое число

stale

Если элемент ‘неактуален’ и необходимо перерисовать его, чтобы вывод соответствовал внутреннему состоянию элемента.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В нормальном случае x — это одномерная или двумерная последовательность скаляров, и соответствующий массив ndarray значений rgba будет возвращён на основе нормы и цветовой карты, установленных для этого объекта ScalarMappable.

Есть один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, прочитанных из файла изображения. Если x — это массив ndarray с 3 измерениями, и последнее измерение равно 3 или 4, то он будет рассматриваться как массив rgb или rgba, и никаких преобразований не будет выполнено. Если последнее измерение равно 3, аргумент alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, аргумент alpha игнорируется; он не заменяет существующий альфа-канал. Если третье измерение имеет другое значение, кроме 3 или 4, будет поднято исключение ValueError.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет содержать числа с плавающей точкой в диапазоне 0-1; если оно равно True, возвращаемый массив rgba будет содержать целые числа uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входные данные корректно сформированы; он не проверяет такие аномалии, как x, являющийся замаскированным массивом rgba, или целым типом, отличным от uint8, или массивом rgba с плавающей точкой, содержащим значения, выходящие за пределы диапазона 0-1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Скопировать свойства из other в self

update_scalarmappable()

Если массив скалярного отображения не равен None, обновить цвета по скалярным данным

zorder = 0

class matplotlib.collections.PatchCollection(patches, match_original=False, **kwargs)

Bases: matplotlib.collections.Collection

Общий набор элементов.

Это упрощает назначение цветовой карты к разнородному набору элементов.

Это также может улучшить скорость построения графиков, поскольку PatchCollection будет рисоваться быстрее, чем большое количество отдельных элементов.

patches

последовательность объектов Patch. Этот список может содержать разнородный набор различных типов элементов.

match_original

Если True, использовать цвета и толщины линий исходных элементов. Если False, новые цвета могут быть назначены с помощью стандартных аргументов коллекции, facecolor, edgecolor, linewidths, norm или cmap.

Если какие-либо из edgecolors, facecolors, linewidths, antialiaseds равны None, они по умолчанию принимают значение настроек matplotlib.rcParams для элементов, в порядке следования.

Использование ScalarMappable необязательно. Если матрица ScalarMappable _A не равна None (т.е., был вызван метод set_array), во время рисования будет выполнен вызов скалярного отобразителя для установки цветов заливки.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, полезный для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

Добавляет запись в словарь логических флагов, которые устанавливаются в True, когда изменяется отображаемый объект.

aname = 'Artist'

autoscale()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив.

autoscale_None()

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив, изменяя только пределы, которые равны None.

axes

Экземпляр Axes, в котором находится элемент, или None.

changed()

Вызывается всякий раз, когда отображаемый объект изменяется, чтобы уведомить всех слушателей обратного вызова о сигнале ‘changed’.

check_update(checker)

Если отображаемый объект изменился с последней проверки, возвращает True; в противном случае возвращает False.

contains(mouseevent)

Проверка, произошла ли активность мыши в коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в списке itemlist содержит событие.

convert_xunits(x)

Для элементов на оси, если ось x поддерживает единицы, преобразует x с помощью типа единиц оси x.

convert_yunits(y)

Для элементов на оси, если ось y поддерживает единицы, преобразует y с помощью типа единиц оси y.

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов художников.

Рекурсивно находит все экземпляры Artist, содержащиеся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция с сигнатурой boolean = match(artist) для фильтрации совпадений
• экземпляр класса: например, Line2D. Возвращать только художников данного класса.

Если include_self равно True (по умолчанию), добавить себя в список для проверки на соответствие.

format_cursor_data(data)

Возвращает отформатированную строку данных курсора.

get_agg_filter()

возвращает функцию фильтра для использования с agg фильтром

get_alpha()

Возвращает значение альфа-канала для смешения — не поддерживается на всех бэкендах.

get_animated()

Возвращает состояние анимации элемента.

get_array()

Возвращает массив.

get_axes()

Возвращает экземпляр Axes, в котором находится элемент, или None.

Этот метод устарел в mpl 1.5, используйте свойство axes. Будет удален в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist элементов.

get_clim()

возвращает минимальное и максимальное значения цветовых пределов для масштабирования изображения.

get_clip_box()

Возвращает ограничивающую рамку художника.

get_clip_on()

Возвращает, используется ли обрезка для элемента.

get_clip_path()

Возвращает путь обрезки для элемента.

get_cmap()

возвращает цветовой карту.

get_contains()

Возвращает тест _contains, используемый элементом, или None для значения по умолчанию.

get_cursor_data(event)

Получение данных курсора для данного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

возвращает, установлена ли заливка.

get_gid()

Возвращает идентификатор группы.

get_hatch()

Возвращает текущий шаблон штриховки.

get_label()

Получение метки, используемой для этого элемента в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает, как применяются смещения для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения преобразования родительской системы координат, т. е. смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования родительской системы координат, т. е. смещения в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает объект пикера, используемый этим элементом.

get_pickradius()

get_rasterized()

возвращает True, если элемент должен быть растрирован.

get_sketch_params()

Возвращает параметры наброска для элемента.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебания перпендикулярно исходной линии. length: Длина колебания вдоль линии. randomness: Коэффициент масштабирования, с помощью которого длина сжимается или расширяется. Может вернуть None если параметры наброска не были установлены.

get_snap()

Возвращает установку «привязки», которая может быть:

• True: привязывает вершины к ближайшему центру пикселя
• False: оставляет вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округляет до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает объект Transform, используемый этим элементом.

get_transformed_clip_path_and_affine()

Возвращает путь обрезки с применённой неаффинной частью его преобразования и оставшейся аффинной частью преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость элемента.

get_window_extent(renderer)

get_zorder()

Возвращает значение z-порядка элемента.

have_units()

Возвращает True, если единицы измерения установлены на осях x или y.

hitlist(event)

Возвращает список дочерних элементов, содержащих событие мыши event.

is_figure_set()

Возвращает True, если элемент присвоен объекту Figure.

is_transform_set()

Возвращает True, если у Artist явно задано преобразование.

mouseover

pchanged()

Вызывает событие при изменении свойства, вызывая все зарегистрированные обратные вызовы.

pick(mouseevent)

Подпись:

pick(mouseevent)

Каждый дочерний элемент вызовет событие выбора, если mouseevent находится над элементом и для элемента установлен обработчик выбора.

pickable()

Возвращает True, если Artist подлежит выбору.

properties()

Возвращает словарь, сопоставляющий имя свойства —> значение для всех свойств элемента.

remove()

Если возможно, удаляет элемент из фигуры. Эффект будет виден только после перерисовки фигуры, например, с matplotlib.axes.Axes.draw_idle(). Вызовите matplotlib.axes.Axes.relim(), чтобы обновить пределы осей, если это необходимо.

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

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

remove_callback(oid)

Удаляет обратный вызов на основе его id.

См. также

add_callback()

Для добавления обратных вызовов

set(**kwargs)

Метод для пакетной установки свойств. Передайте kwargs для установки свойств. Будет обрабатывать конфликты имён свойств (например, если указаны как «color», так и «facecolor», то свойство с более высоким приоритетом будет установлено последним).

set_agg_filter(filter_func)

установить функцию agg_filter.

set_alpha(alpha)

Установить альфа-прозрачность коллекции. alpha должен быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Установить состояние анимации элемента.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Установить состояние сглаживания для рендеринга.

ПРИНИМАЕТ: логическое значение или последовательность логических значений

set_antialiaseds(aa)

Псевдоним для set_antialiased

set_array(A)

Установить массив изображения из массива NumPy A.

set_axes(axes)

Установить экземпляр Axes, в котором находится элемент, если таковой имеется.

Этот метод устарел в mpl 1.5, используйте свойство axes. Удален в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

Установить пределы нормирования для масштабирования изображения; если vmin — это последовательность длиной 2, интерпретировать её как (vmin, vmax), что используется для поддержки setp.

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой

set_clip_box(clipbox)

Установить обрезающую область элемента Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

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

Когда False, элементы будут видны за пределами осей, что может привести к непредсказуемым результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Установить путь обрезки элемента, который может быть:

• экземпляром Patch (или подкласса)

• a Path instance, in which case

  Необязательный экземпляр Transform может быть передан, который будет применён к пути перед его использованием для обрезки.

• None, чтобы удалить путь обрезки

Для повышения эффективности, если путь является прямоугольником с выровненными осями, этот метод установит коробку обрезки для соответствующего прямоугольника и установит путь обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

установить цветовую карту для данных яркости

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты

set_color(c)

Устанавливает цвет обводки и заливки.

ПРИНИМАЕТ: аргумент цвета matplotlib или последовательность кортежей rgba

См. также

set_facecolor(), set_edgecolor()

Для установки цвета обводки или заливки индивидуально.

set_contains(picker)

Заменяет тест принадлежности, используемый этим элементом. Новый селектор должен быть вызываемой функцией, определяющей, попадает ли элемент в область события мыши:

hit, props = picker(artist, mouseevent)

Если событие мыши находится над элементом, возвращает hit = True и props является словарем свойств, которые вы хотите вернуть с тестом принадлежности.

ПРИНИМАЕТ: вызываемую функцию

set_dashes(ls)

псевдоним для set_linestyle

set_edgecolor(c)

Устанавливает цвет(а) обводки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, фигуры будут циклически использовать цвета из последовательности.

Если c равно ‘face’, цвет обводки всегда будет совпадать с цветом заливки. Если это ‘none’, граница фигуры не будет отображаться.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_edgecolors(c)

псевдоним для set_edgecolor

set_facecolor(c)

Устанавливает цвет(а) заливки коллекции. c может быть спецификацией цвета matplotlib (все фигуры имеют одинаковый цвет) или последовательностью спецификаций; если это последовательность, фигуры будут циклически использовать цвета из последовательности.

Если c равно ‘none’, фигура не будет закрашена.

ПРИНИМАЕТ: спецификацию цвета matplotlib или последовательность спецификаций

set_facecolors(c)

псевдоним для set_facecolor

set_figure(fig)

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

ПРИНИМАЕТ: экземпляр matplotlib.figure.Figure

set_gid(gid)

Устанавливает идентификатор группы для элемента.

ПРИНИМАЕТ: строку-идентификатор

set_hatch(hatch)

Устанавливает шаблон штриховки.

hatch может быть одним из:

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Буквы могут комбинироваться, в этом случае выполняются все указанные штриховки. Если одна буква повторяется, это увеличивает плотность штриховки этого шаблона.

Штриховка поддерживается только в бэкендах PostScript, PDF, SVG и Agg.

В отличие от других свойств, таких как толщина линии и цвета, штриховку можно задать только для всей коллекции, а не для каждого элемента по отдельности.

ПРИНИМАЕТ: [ ‘/’ | ‘\’ | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]

set_label(s)

Устанавливает метку s для автоматической легенды.

ПРИНИМАЕТ: строку или любой печатаемый объект с преобразованием ‘%s’.

set_linestyle(ls)

Устанавливает стиль линии(й) для коллекции.

linestyle	описание
'-' или 'solid'	сплошная линия
'--' или 'dashed'	штриховая линия
'-.' или 'dashdot'	штрих-пунктирная линия
':' или 'dotted'	пунктирная линия

В качестве альтернативы можно указать кортеж штрихов в формате:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, содержащий отступы и длины штрихов в точках.

ПРИНИМАЕТ: [‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ |

(смещение, последовательность штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

Параметры:	ls : { ‘-‘, ‘–’, ‘-.’, ‘:’} и другие, см. описание Стиль линии.

set_linestyles(ls)

псевдоним для set_linestyle

set_linewidth(lw)

Устанавливает ширину линии(й) для коллекции. lw может быть скаляром или последовательностью; если это последовательность, фигуры будут циклически использовать ширины из последовательности.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_linewidths(lw)

псевдоним для set_linewidth

set_lw(lw)

псевдоним для set_linewidth

set_norm(norm)

устанавливает экземпляр нормализации

set_offset_position(offset_position)

Устанавливает способ применения смещений. Если offset_position равен ‘screen’ (по умолчанию), смещение применяется после применения преобразования master, то есть смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется до преобразования master, т.е. смещения в координатах данных.

set_offsets(offsets)

Устанавливает смещения для коллекции. offsets может быть скаляром или последовательностью.

ПРИНИМАЕТ: число с плавающей точкой или последовательность чисел с плавающей точкой

set_path_effects(path_effects)

устанавливает path_effects, которые должны быть списком экземпляров matplotlib.patheffect._Base или его производных.

set_paths(patches)

set_picker(picker)

Устанавливает значение epsilon для выбора, используемое данным элементом.

picker может быть одним из следующих:

• None: выбор отключён для данного элемента (по умолчанию)
• Булево значение: если True, то выбор включён и элемент будет генерировать событие выбора, если курсор мыши находится над ним
• Число с плавающей точкой: если picker — число, оно интерпретируется как толерантность epsilon в точках, и элемент будет генерировать событие, если его данные находятся в пределах epsilon от события мыши. Для некоторых элементов, таких как линии и коллекции фигур, элемент может предоставить дополнительную информацию событию выбора, например, индексы данных, находящихся в пределах epsilon от события выбора

• Функция: если picker — вызываемая функция, это функция пользователя, которая определяет, попадает ли элемент в область события мыши:

  hit, props = picker(artist, mouseevent)
  

  для определения проверки попадания. если курсор мыши находится над элементом, возвращает hit=True и props — словарь свойств, которые вы хотите добавить в атрибуты PickEvent.

ПРИНИМАЕТ: [None|число с плавающей точкой|boolean|вызываемая функция]

set_pickradius(pr)

set_rasterized(rasterized)

Вынужденное растрирование (отображение в виде битовой карты) при выводе векторного бэкенда.

По умолчанию None, что подразумевает поведение по умолчанию бэкенда

ПРИНИМАЕТ: [True | False | None]

set_sketch_params(scale=None, length=None, randomness=None)

Устанавливает параметры наброска.

Параметры:	scale : float, необязательно Амплитуда колебания перпендикулярно исходной линии в пикселях. Если scale — None, или не указан, фильтр наброска не будет применён. length : float, необязательно Длина колебания вдоль линии в пикселях (по умолчанию 128.0) randomness : float, необязательно Множитель масштаба, по которому длина сжимается или расширяется (по умолчанию 16.0)

set_snap(snap)

Устанавливает параметр привязки, который может быть:

• True: привязка вершин к центрам ближайших пикселей
• False: вершины остаются без изменений
• None: (авто) Если путь содержит только прямолинейные отрезки, округляется до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

set_transform(t)

Устанавливает экземпляр Transform, используемый данным элементом.

ПРИНИМАЕТ: экземпляр Transform

set_url(url)

Устанавливает URL для элемента.

ПРИНИМАЕТ: строку URL.

set_urls(urls)

set_visible(b)

Установить видимость объекта.

ПРИНИМАЕТ: [True | False]

set_zorder(level)

Установить порядок отрисовки объекта (zorder). Объекты с меньшими значениями zorder отрисовываются первыми.

ПРИНИМАЕТ: любое число

stale

Если объект «недействителен» и требует повторной отрисовки, чтобы вывод соответствовал внутреннему состоянию объекта.

to_rgba(x, alpha=None, bytes=False)

Возвращает нормализованный массив rgba, соответствующий x.

В обычном случае x — это 1-мерная или 2-мерная последовательность скаляров, и соответствующий массив ndarray значений rgba будет возвращён на основе установленных для этого ScalarMappable нормы и цветовой карты.

Существует один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, таких, которые были прочитаны из файла изображения. Если x — это массив ndarray с 3 измерениями, и последнее измерение равно 3 или 4, то он будет обрабатываться как rgb или rgba массив, и никакого отображения не будет выполнено. Если последнее измерение равно 3, аргумент alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, аргумент alpha игнорируется; он не заменяет существующую альфу. Если третье измерение не равно 3 или 4, будет вызвано исключение ValueError.

В любом случае, если bytes равно False (по умолчанию), массив rgba будет представлять собой числа с плавающей точкой в диапазоне от 0 до 1; если оно равно True, возвращаемый массив rgba будет содержать значения uint8 в диапазоне от 0 до 255.

Примечание: этот метод предполагает, что входные данные корректны; он не проверяет аномалии, такие как x, являющийся замаскированным массивом rgba, или являющийся целочисленным типом, отличным от uint8, или являющийся массивом rgba с плавающей точкой со значениями вне диапазона от 0 до 1.

update(props)

Обновить свойства этого Artist из словаря prop.

update_from(other)

Копирование свойств из other в self

update_scalarmappable()

Если массив скалярного отображения не равен None, обновить цвета из скалярных данных

zorder = 0

class matplotlib.collections.PathCollection(paths, sizes=None, **kwargs)

Базы: matplotlib.collections._CollectionWithSizes

Это подкласс Collection, наиболее базовый.

paths — последовательность экземпляров matplotlib.path.Path.

Допустимые ключевые аргументы для Collection:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (необязательно для matplotlib.cm.ScalarMappable)
• cmap: None (необязательно для matplotlib.cm.ScalarMappable)

offsets и transOffset используются для смещения фигуры после отрисовки (по умолчанию без смещения).

Если любой из edgecolors, facecolors, linewidths, antialiaseds равен None, они по умолчанию принимают значение из настроек matplotlib.rcParams фигуры.

add_callback(func)

Добавляет функцию обратного вызова, которая будет вызываться всякий раз, когда изменяется одно из свойств Artist.

Возвращает id, который полезен для удаления обратного вызова с помощью remove_callback() позже.

add_checker(checker)

Добавляет запись в словарь флагов типа boolean, которые устанавливаются в True, когда изменяется mappable.

aname = 'Artist'

autoscale()

Автомасштабирование пределов скалярных значений для объекта norm с использованием текущего массива.

autoscale_None()

Автомасштабирование пределов скалярных значений для объекта norm с использованием текущего массива, изменяя только отсутствующие пределы.

axes

Экземпляр Axes, в котором находится объект-художник, или None.

changed()

Вызов при изменении mappable для уведомления всех слушателей обратного вызова о событии «изменение».

check_update(checker)

Если mappable изменился с момента последней проверки, возвращает True; иначе — False.

contains(mouseevent)

Проверка, произошёл ли щелчок мыши внутри коллекции.

Возвращает True | False, dict(ind=itemlist), где каждый элемент в itemlist содержит событие.

convert_xunits(x)

Для элементов на оси, если у оси x есть поддержка единиц, преобразует x с использованием типа единиц оси x.

convert_yunits(y)

Для элементов на оси, если у оси y есть поддержка единиц, преобразует y с использованием типа единиц оси y.

draw(artist, renderer, *args, **kwargs)

findobj(match=None, include_self=True)

Поиск объектов художников.

Рекурсивный поиск всех экземпляров Artist, содержащихся в self.

match может быть

• None: вернуть все объекты, содержащиеся в художнике.
• функция с сигнатурой boolean = match(artist) для фильтрации результатов.
• экземпляр класса, например, Line2D. Вернуть только художников указанного класса.

Если include_self равно True (по умолчанию), добавить себя в список для проверки на соответствие.

format_cursor_data(data)

Возвращает отформатированную строку данных курсора.

get_agg_filter()

Возвращает функцию фильтра для использования с agg фильтром.

get_alpha()

Возвращает значение альфа для смешивания — не поддерживается на всех бэкэндах.

get_animated()

Возвращает состояние анимации художника.

get_array()

Возвращает массив.

get_axes()

Возвращает экземпляр Axes, в котором находится объект-художник, или None.

Этот метод устарел в mpl 1.5, пожалуйста, используйте свойство axes. Будет удален в 1.7 или 2.0.

get_children()

Возвращает список дочерних Artist`s this :class:`Artist.

get_clim()

Возвращает минимальное и максимальное значения диапазона цветов для масштабирования изображения.

get_clip_box()

Возвращает область обрезки художника.

get_clip_on()

Возвращает, использует ли художник обрезку.

get_clip_path()

Возвращает путь обрезки художника.

get_cmap()

Возвращает используемую цветовую карту.

get_contains()

Возвращает используемый для проверки _contains тест художника, или None для значения по умолчанию.

get_cursor_data(event)

Возвращает данные курсора для заданного события.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

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

get_fill()

Возвращает, задан ли fill.

get_gid()

Возвращает идентификатор группы.

get_hatch()

Возвращает текущий узор штриховки.

get_label()

Получить метку, используемую для этого художника в легенде.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Возвращает способ применения смещений для коллекции. Если offset_position равен ‘screen’, смещение применяется после применения главного преобразования, то есть смещения в координатах экрана. Если offset_position равен ‘data’, смещение применяется до главного преобразования, то есть смещения в координатах данных.

get_offset_transform()

get_offsets()

Возвращает смещения для коллекции.

get_path_effects()

get_paths()

get_picker()

Возвращает используемый для выбора объект.

get_pickradius()

get_rasterized()

Возвращает True, если художник должен быть растрирован.

get_sizes()

Возвращает размеры элементов в коллекции. Значение представляет «площадь» элемента.

Возвращает:	sizes : массив «Площадь» каждого элемента.

get_sketch_params()

Возвращает параметры наброска для объекта-художника.

Возвращает:	sketch_params : кортеж или None Кортеж из 3 элементов: scale: Амплитуда колебания перпендикулярно исходной линии. length: Длина колебания вдоль линии. randomness: Коэффициент масштабирования, на который уменьшается или увеличивается длина. Может вернуть None, если параметры наброска не были заданы.

get_snap()

Возвращает параметр привязки, который может быть:

• True: привязка вершин к ближайшему центру пикселя
• False: оставить вершины как есть
• None: (автоматически) Если путь содержит только прямолинейные отрезки, округлить до ближайшего центра пикселя

Поддерживается только бэкендами Agg и MacOSX.

get_transform()

Возвращает экземпляр Transform, используемый этим объектом-художником.

get_transformed_clip_path_and_affine()

Возвращает путь обрезки с применённой не-аффинной частью его преобразования и оставшейся аффинной частью преобразования.

get_transforms()

get_url()

Возвращает URL

get_urls()

get_visible()

Возвращает видимость объекта-художника.

get_window_extent(renderer)

get_zorder()

Возвращает порядок отрисовки Artist.

have_units()

Возвращает True, если единицы измерения установлены по осям x или y.

hitlist(event)

Список дочерних элементов объекта-художника, которые содержат событие мыши event.

is_figure_set()

Возвращает True, если объект-художник назначен на Figure.

is_transform_set()

Возвращает True, если у Artist явно задано преобразование.

mouseover

pchanged()

Срабатывает событие при изменении свойства, вызывая все зарегистрированные обработчики.

pick(mouseevent)

Подпись вызова:

pick(mouseevent)

Каждый дочерний объект-художник сгенерирует событие выбора, если mouseevent находится над объектом-художником и для него задан picker.

pickable()

Возвращает True, если Artist можно выбрать.

properties()

возвращает словарь, сопоставляющий имя свойства –> значение для всех свойств объекта-художника.

remove()

Удаляет объект-художника из фигуры, если это возможно. Эффект не будет виден до перерисовки фигуры, например, с помощью matplotlib.axes.Axes.draw_idle(). Вызов matplotlib.axes.Axes.relim() для обновления пределов осей, если необходимо.

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

Примечание: нет поддержки удаления записи в легенде объекта-художника.

remove_callback(oid)

Удаляет обработчик по его id.

См. также

add_callback()

Для добавления обработчиков

set(**kwargs)

Функция массового задания свойств. Передайте kwargs для задания свойств. Будет обрабатывать конфликты имён свойств (например, если указаны и ‘color’, и ‘facecolor’, то свойство с более высоким приоритетом устанавливается последним).

set_agg_filter(filter_func)

установить функцию agg_filter.

set_alpha(alpha)

Устанавливает альфа-прозрачность коллекции. alpha должен быть числом с плавающей точкой или None.

ПРИНИМАЕТ: число с плавающей точкой или None

set_animated(b)

Устанавливает состояние анимации объекта-художника.

ПРИНИМАЕТ: [True | False]

set_antialiased(aa)

Устанавливает состояние сглаживания для рендеринга.

ПРИНИМАЕТ: булево значение или последовательность булевых значений

set_antialiaseds(aa)

псевдоним для set_antialiased

set_array(A)

Установить массив изображений из массива numpy A

set_axes(axes)

Устанавливает экземпляр Axes, в котором находится объект-художник, если таковой имеется.

Это устарело в mpl 1.5, пожалуйста, используйте свойство axes. Будет удалено в 1.7 или 2.0.

ПРИНИМАЕТ: экземпляр Axes

set_clim(vmin=None, vmax=None)

установить пределы нормы для масштабирования изображения; если vmin является последовательностью длиной 2, интерпретировать её как (vmin, vmax), которая используется для поддержки setp

ПРИНИМАЕТ: последовательность длиной 2 чисел с плавающей точкой

set_clip_box(clipbox)

Устанавливает область обрезки объекта-художника Bbox.

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Bbox

set_clip_on(b)

Устанавливает, использует ли объект-художник обрезку.

Когда False объекты-художники будут видны за пределами осей, что может привести к непредвиденным результатам.

ПРИНИМАЕТ: [True | False]

set_clip_path(path, transform=None)

Устанавливает путь обрезки объекта-художника, который может быть:

• экземпляр Patch (или подкласс)

• a Path instance, in which case

  Может быть предоставлен необязательный экземпляр Transform, который будет применён к пути перед использованием его для обрезки.

• None, чтобы удалить путь обрезки

Для повышения эффективности, если путь оказывается прямоугольником, выровненным по осям, этот метод установит область обрезки соответствующему прямоугольнику и установит путь обрезки в None.

ПРИНИМАЕТ: [ (Path, Transform) | Patch | None ]

set_cmap(cmap)

установить цветовую карту для данных яркости

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты