коллекции

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(renderer)

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_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_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()

Возвращает порядок отрисовки Artist.

have_units()

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

hitlist(event)

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

is_figure_set()

Возвращает True, если художник назначен на Figure.

is_transform_set()

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

mouseover

pchanged()

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

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_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 (или подкласс); или
• экземпляр Path, в этом случае экземпляр 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_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

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

sticky_edges

x и y списки привязанных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то не будет добавлено никакого отступа – предел представления «прилипает» к краю. Типичный пример использования — гистограммы, где обычно не ожидается отступ от нижнего края (0) гистограммы.

К этому атрибуту нельзя присвоить значение; однако, списки x и y можно изменять на месте по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm — False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (0–1).

update(props)

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

update_from(other)

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

update_scalarmappable()

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

zorder = 0

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

Bases: matplotlib.collections.PolyCollection

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

xranges

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

yrange

ymin, ywidth

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

• 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, чтобы уведомить все слушатели обратного вызова о сигнале ‘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(renderer)

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_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()

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

have_units()

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

hitlist(event)

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

is_figure_set()

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

is_transform_set()

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

mouseover

pchanged()

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

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 для установки свойств.

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_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 (или подкласс); или
• объект Path, в этом случае объект 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’.

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’ (по умолчанию), смещение применяется после применения преобразования родительской системы координат, то есть смещения в координатах экрана. Если offset_position равно ‘data’, смещение применяется до преобразования родительской системы координат, т. е. смещения в координатах данных.

set_offsets(offsets)

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

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

set_path_effects(path_effects)

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

set_paths(verts, closed=True)

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

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_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 равно True. Полосы на оси y простираются от ymin до ymax.

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

stale

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

sticky_edges

x и y списки привязанных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то отступ не добавляется — предел просмотра «прилипает» к краю. Типичный пример использования — гистограммы, где обычно ожидается отсутствие отступа на нижнем краю (0) гистограммы.

К этому атрибуту нельзя присваивать значения; однако списки x и y можно изменять на месте по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm равно False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (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, когда изменяется mappable.

aname = 'Artist'

autoscale()

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

autoscale_None()

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

axes

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

changed()

Вызывайте эту функцию, когда mappable изменяется, чтобы оповестить всех слушателей обратных вызовов об изменении (сигнал '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(renderer)

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_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’, смещение применяется после применения преобразования 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()

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

have_units()

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

hitlist(event)

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

is_figure_set()

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

is_transform_set()

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

mouseover

pchanged()

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

pick(mouseevent)

Обрабатывает событие выбора.

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

pickable()

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

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_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 (или подкласс); или
• экземпляр Path, в этом случае экземпляр 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_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)

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

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

stale

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

sticky_edges

x и y списки фиксированных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то отступ не будет добавлен — предел просмотра «прилипает» к краю. Типичный пример применения — гистограммы, где, как правило, отступ не ожидается на нижней границе (0) гистограммы.

К этому атрибуту нельзя присваивать значения; однако списки x и y можно изменять по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm имеет значение False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (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 для объектов типа patch, в виде последовательности.

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

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

%(Collection)s

add_callback(func)

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

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

add_checker(checker)

Добавляет запись в словарь флагов, которые устанавливаются в 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)

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

convert_yunits(y)

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

draw(renderer)

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()

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

get_animated()

Возвращает состояние анимации объекта-артиста

get_array()

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

get_children()

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

get_clim()

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

get_clip_box()

Возвращает clipbox элемента-артиста

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, если у объекта явно задано преобразование.

mouseover

pchanged()

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

pick(mouseevent)

Обработка события выбора.

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

pickable()

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

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_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 (или подкласс); или
• экземпляр Path, в этом случае должен быть предоставлен экземпляр 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’ (по умолчанию), смещение применяется после применения преобразования основного уровня, то есть смещения в координатах экрана. Если offset_position равно ‘data’, смещение применяется до преобразования основного уровня, т. е. смещения в координатах данных.

set_offsets(offsets)

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

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

set_path_effects(path_effects)

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

set_paths()

set_picker(picker)

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

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

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

• Функция: если 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)

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

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

stale

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

sticky_edges

x и y списки привязанных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то отступ не добавляется — предел отображения «прилипает» к краю. Типичный пример использования — гистограммы, где обычно не ожидается отступ у нижней границы (0) гистограммы.

К этому атрибуту нельзя присвоить значение; однако списки x и y можно изменять непосредственно по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm равно False, никакой нормализации входных данных не выполняется, и предполагается, что они находятся в диапазоне (0-1).

update(props)

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

update_from(other)

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

update_scalarmappable()

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

zorder = 0

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

Основы: 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 патча, в форме последовательности.

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(renderer)

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_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)

Обработка события выбора.

Каждый дочерний элемент вызовет событие выбора, если 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_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 (или подкласс); или
• экземпляр Path, в этом случае экземпляр 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’ (по умолчанию), смещение применяется после применения преобразования основной системы координат, то есть смещения задаются в экранных координатах. Если offset_position равно ‘data’, смещение применяется до преобразования основной системы координат, то есть смещения задаются в координатах данных.

set_offsets(offsets)

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

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

set_path_effects(path_effects)

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

set_paths()

set_picker(picker)

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

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

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

• Функция: если 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 : число с плавающей точкой, необязательно Амплитуда колебаний перпендикулярно исходной линии в пикселях. Если 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) объекта. Объекты с меньшими значениями zorder рисуются первыми.

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

stale

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

sticky_edges

x и y списки прилипающих границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то отступ не добавляется — предел просмотра «прилипает» к краю. Типичным случаем использования являются гистограммы, где обычно не ожидается отступ по нижнему краю (0) гистограммы.

К этому атрибуту нельзя присваивать значения; однако списки x и y можно изменять непосредственно по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm равен False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне от 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

Коллекция дискретных событий.

События задаются одномерным массивом, обычно представляющим положение чего-либо вдоль оси, например, времени или длины. У них нет амплитуды, и они отображаются в виде вертикальных или горизонтальных параллельных полос.

Параметры:

positions : одномерный массив-подобный объект Каждое значение — это событие. orientation : {None, ‘horizontal’, ‘vertical’}, необязательно Ориентация коллекции (полосы событий расположены вдоль ортогонального направления). По умолчанию «horizontal», если не указано или None. lineoffset : скаляр, необязательно, по умолчанию: 0 Смещение центра маркеров от начала координат в направлении, ортогональном к orientation. linelength : скаляр, необязательно, по умолчанию: 1 Общая высота маркера (т.е. маркер простирается от lineoffset - linelength/2 до lineoffset + linelength/2). linewidth : скаляр или None, необязательно, по умолчанию: None Если None, по умолчанию используется значение из rcParams. color : цвет, последовательность цветов или None, необязательно, по умолчанию: None Если None, по умолчанию используется значение из rcParams. linestyle : строка или кортеж, необязательно, по умолчанию: ‘solid’ Допустимые строки: [‘solid’, ‘dashed’, ‘dashdot’, ‘dotted’, ‘-‘, ‘–’, ‘-.’, ‘:’]. Кортежи для пунктира должны иметь вид: (offset, onoffseq), где onoffseq — кортеж чётной длины с значениями включения и выключения чернил в пунктах. antialiased : {None, 1, 2}, необязательно Если None, по умолчанию используется значение из rcParams. **kwargs : необязательно Другие ключевые аргументы — свойства коллекции линий. См. LineCollection для списка допустимых свойств.

Примеры

(Исходный код, 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()

Вызовите эту функцию, когда отображаемый объект изменяется, чтобы уведомить всех слушателей обратного вызова о сигнале '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(renderer)

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_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()

Возвращает функцию проверки попадания, используемую объектом-артистом, или 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()

Возвращает установку 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_horizontal()

True, если eventcollection горизонтальная, False если вертикальная

is_transform_set()

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

mouseover

pchanged()

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

pick(mouseevent)

Обработка события pick

каждый дочерний элемент графики сработает с событием 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 для установки свойств.

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_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 (или подкласс); или
• экземпляр Path, в этом случае экземпляр 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 — это число, оно интерпретируется как допускаемое отклонение в точках, и художник будет генерировать событие, если его данные находятся в пределах epsilon от события мыши. Для некоторых художников, таких как линии и коллекции областей, художник может предоставлять дополнительные данные событию выбора, например, индексы данных, находящихся в пределах epsilon от события выбора

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

  hit, props = picker(artist, mouseevent)
  

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

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

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, 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_verts(segments)

set_visible(b)

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

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

set_zorder(level)

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

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

stale

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

sticky_edges

x и y списки привязанных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, тогда отступ не добавляется — предел просмотра «прилипает» к краю. Типичный пример использования — гистограммы, где обычно не требуется отступ на нижней границе (0) гистограммы.

Этот атрибут нельзя назначать; однако списки x и y можно изменять непосредственно по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

switch_orientation()

переключить ориентацию линии событий с вертикальной на горизонтальную или наоборот

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

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

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

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

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

Если norm — False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (0-1).

update(props)

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

update_from(other)

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

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)]

то есть, свойства циклически повторяются, если количество свойств (props) меньше количества отрезков.

segments

последовательность (line0, line1, line2), где:

linen = (x0, y0), (x1, y1), ... (xm, ym)

или эквивалентная массив numpy с двумя столбцами. Каждая линия может иметь различную длину.

colors

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

antialiaseds

должна быть последовательностью единиц или нулей

linestyles [ ‘solid’ | ‘dashed’ | ‘dashdot’ | ‘dotted’ ]

строка или кортеж с типом штриховки. Кортеж с типом штриховки:

(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

Сортировочный уровень LineCollection. По умолчанию равен 2

facecolors

Цвет заливки LineCollection. По умолчанию ‘none’. Установка значения, отличного от ‘none’, приведёт к отображению заполненного многоугольника между точками на каждой линии.

Использование ScalarMappable необязательно. Если массив ScalarMappable не равен 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(renderer)

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_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’, смещение применяется после применения преобразования родительской системы координат, то есть смещения задаются в координатах экрана. Если offset_position равно ‘data’, смещение применяется до преобразования родительской системы координат, то есть смещения задаются в координатах данных.

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, если у элемента явно задано преобразование.

mouseover

pchanged()

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

pick(mouseevent)

Обрабатывает событие выбора.

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

pickable()

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

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_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 (или его подкласс); или
• экземпляр класса Path, в этом случае должен быть предоставлен экземпляр класса 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’, цвет обводки всегда будет таким же, как цвет заливки. Если c равно ‘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(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, 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_verts(segments)

set_visible(b)

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

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

set_zorder(level)

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

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

stale

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

sticky_edges

x и y списки прилипающих границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то не будет добавлен отступ — предел просмотра «прилипает» к краю. Типичное применение — гистограммы, где, как правило, не ожидается отступ по нижнему краю (0) гистограммы.

К этому атрибуту нельзя присваивать значения; однако списки x и y можно изменять непосредственно по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm равно False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (0-1).

update(props)

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

update_from(other)

Копирует свойства из другого объекта в себя.

update_scalarmappable()

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

zorder = 0

class matplotlib.collections.PatchCollection(patches, match_original=False, **kwargs)

Основы: 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)

Добавляет запись в словарь флагов boolean, которые устанавливаются в 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(renderer)

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_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_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)

Обработка события выбора.

Каждый дочерний элемент объекта сработает, если 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_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 (или подкласс); или
• объект Path, в этом случае объект 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».

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)

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

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

set_path_effects(path_effects)

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

set_paths(patches)

set_picker(picker)

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

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)

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

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

stale

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

sticky_edges

x и y списки приклеенных границ.

При выполнении автоматического масштабирования, если предел данных совпадает со значением в соответствующем списке sticky_edges, то отступ не будет добавлен — предел просмотра «приклеивается» к краю. Типичный пример использования — гистограммы, где обычно нет отступа на нижнем краю (0) гистограммы.

К этому атрибуту нельзя присвоить значение; однако списки x и y можно изменять непосредственно по мере необходимости.

Примеры

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

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

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

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

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

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

Если norm равно False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (0-1).

update(props)

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

update_from(other)

Копирует свойства из других в себя

update_scalarmappable()

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

zorder = 0

class matplotlib.collections.PathCollection(paths, sizes=None, **kwargs)

Bases: 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)

Добавляет запись в словарь логических флагов, которые устанавливаются в 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(renderer)

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_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_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()

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

have_units()

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

hitlist(event)

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

is_figure_set()

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

is_transform_set()

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

mouseover

pchanged()

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

pick(mouseevent)

Обрабатывает событие выбора.

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

pickable()

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

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_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 (или подкласс); или
• экземпляр Path, в этом случае экземпляр Transform, который будет применён к пути перед использованием его для обрезки, должен быть предоставлен; или
• None, чтобы удалить ранее установленный путь обрезки.

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

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

set_cmap(cmap)

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

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

set_color(c)

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

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

См. также

set_facecolor(), set_edgecolor()

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