Сборки

matplotlib.collections

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

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

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

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

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

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

get_agg_filter()

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

get_alpha()

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

get_animated()

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

get_array()

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

get_capstyle()

get_children()

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

get_clim()

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

get_clip_box()

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

get_clip_on()

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

get_clip_path()

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

get_cmap()

Возвращает цветовое отображение.

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

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

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

get_rotation()

get_sizes()

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

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

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

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

Будьте осторожны при использовании этой функции, результаты не обновятся, если область окна элемента изменится. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемой области рисования (как это делается при сохранении фигуры). Это может привести к непредсказуемому поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но сохранятся неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устаревшее с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устаревшее с версии 2.2: artist.figure is not None

Возвращает, назначен ли элемент 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_func : callable Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (m, n, 3).

set_alpha(alpha)

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

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

set_animated(b)

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

Параметры:	b : bool

set_antialiased(aa)

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

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

set_antialiaseds(aa)

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

set_array(A)

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

Параметры:	A : ndarray

set_capstyle(cs)

Установить стиль закругления для коллекции. Стиль закругления можно установить только глобально для всех элементов в коллекции

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль закругления

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой; может быть переопределено в методах, имеющих vmin и vmax параметры.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

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 — словарь свойств, которые вы хотите вернуть с тестом принадлежности.

Параметры:	picker : callable

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, к которому относится элемент.

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

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

Установить стиль соединения для коллекции. Стиль соединения можно установить только глобально для всех элементов в коллекции.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразовано в строку с помощью вызова str (unicode в Py2).

set_linestyle(ls)

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

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

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

(offset, onoffseq),

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

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

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls)

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

set_linewidth(lw)

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

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

set_linewidths(lw)

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

set_lw(lw)

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position)

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

set_offsets(offsets)

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

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

set_path_effects(path_effects)

Установить эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths()

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr)

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

Параметры:	d : float Радиус выбора, в пунктах.

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or None

set_sizes(sizes, dpi=72.0)

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

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

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.

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls)

Параметры:	urls : List[str] or None

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

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)

Обновить свойства этого объекта от словаря prop.

update_from(other)

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

update_scalarmappable()

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

zorder = 0

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

Bases: matplotlib.collections.PolyCollection

A collection of horizontal bars spanning yrange with a sequence of xranges.

xranges

sequence of (xmin, xwidth)

yrange

ymin, ywidth

Valid Collection keyword arguments:

• edgecolors: None
• facecolors: None
• linewidths: None
• antialiaseds: None
• offsets: None
• transOffset: transforms.IdentityTransform()
• norm: None (optional for matplotlib.cm.ScalarMappable)
• cmap: None (optional for matplotlib.cm.ScalarMappable)

offsets and transOffset are used to translate the patch after rendering (default no offsets)

If any of edgecolors, facecolors, linewidths, antialiaseds are None, they default to their matplotlib.rcParams patch setting, in sequence form.

add_callback(func)

Adds a callback function that will be called whenever one of the Artist's properties changes.

Returns an id that is useful for removing the callback with remove_callback() later.

add_checker(checker)

Add an entry to a dictionary of boolean flags that are set to True when the mappable is changed.

aname = 'Artist'

autoscale()

Autoscale the scalar limits on the norm instance using the current array

autoscale_None()

Autoscale the scalar limits on the norm instance using the current array, changing only limits that are None

axes

The Axes instance the artist resides in, or None.

changed()

Call this whenever the mappable is changed to notify all the callbackSM listeners to the 'changed' signal

check_update(checker)

If mappable has changed since the last check, return True; else return False

contains(mouseevent)

Test whether the mouse event occurred in the collection.

Returns True | False, dict(ind=itemlist), where every item in itemlist contains the event.

convert_xunits(x)

For artists in an axes, if the xaxis has units support, convert x using xaxis unit type

convert_yunits(y)

For artists in an axes, if the yaxis has units support, convert y using yaxis unit type

draw(renderer)

Derived classes drawing method

findobj(match=None, include_self=True)

Find artist objects.

Recursively find all Artist instances contained in self.

match can be

• None: return all objects contained in artist.
• function with signature boolean = match(artist) used to filter matches
• class instance: e.g., Line2D. Only return artists of class type.

If include_self is True (default), include self in the list to be checked for a match.

format_cursor_data(data)

Return cursor data string formatted.

get_agg_filter()

Return filter function to be used for agg filter.

get_alpha()

Return the alpha value used for blending - not supported on all backends

get_animated()

Return the artist's animated state

get_array()

Return the array

get_capstyle()

get_children()

Return a list of the child Artist`s this :class:`Artist contains.

get_clim()

return the min, max of the color limits for image scaling

get_clip_box()

Return artist clipbox

get_clip_on()

Return whether artist uses clipping

get_clip_path()

Return artist clip path

get_cmap()

return the colormap

get_contains()

Return the _contains test used by the artist, or None for default.

get_cursor_data(event)

Get the cursor data for a given event.

get_dashes()

get_datalim(transData)

get_edgecolor()

get_edgecolors()

get_facecolor()

get_facecolors()

get_figure()

Return the Figure instance the artist belongs to.

get_fill()

return whether fill is set

get_gid()

Returns the group id.

get_hatch()

Return the current hatching pattern.

get_joinstyle()

get_label()

Get the label used for this artist in the legend.

get_linestyle()

get_linestyles()

get_linewidth()

get_linewidths()

get_offset_position()

Returns how offsets are applied for the collection. If offset_position is 'screen', the offset is applied after the master transform has been applied, that is, the offsets are in screen coordinates. If offset_position is 'data', the offset is applied before the master transform, i.e., the offsets are in data coordinates.

get_offset_transform()

get_offsets()

Return the offsets for the collection.

get_path_effects()

get_paths()

get_picker()

Return the picker object used by this artist.

get_pickradius()

get_rasterized()

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

get_sizes()

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

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

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

Получает область отрисовки объекта на оси в пространстве отображения. Подклассы должны переопределять, чтобы включить её в вычисление "плотной" области. По умолчанию возвращает пустую область отрисовки в точке 0, 0.

Будьте внимательны при использовании этой функции, результаты не обновляются, если область отрисовки элемента изменяется. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть хорошо на экране, но будут сохранены неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устарело начиная с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устарело начиная с версии 2.2: artist.figure не равно None

Возвращает, назначен ли элемент фигуре 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_func : callable Функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi и возвращает (m, n, 3) массив.

set_alpha(alpha)

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

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

set_animated(b)

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

Параметры:	b : bool

set_antialiased(aa)

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

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

set_antialiaseds(aa)

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

set_array(A)

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

Параметры:	A : ndarray

set_capstyle(cs)

Установка стиля окончания для коллекции. Стиль окончания можно установить только глобально для всех элементов коллекции.

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль окончания

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой; может быть переопределён в методах, имеющих vmin и vmax аргументы.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

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)

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

hit, props = picker(artist, mouseevent)

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

Параметры:	picker : callable

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

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

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

Установить стиль соединения для коллекции. Стиль соединения может быть установлен только глобально для всех элементов коллекции.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразовано в строку с помощью вызова str (unicode в Py2).

set_linestyle(ls)

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

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

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

(offset, onoffseq),

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

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

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls)

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

set_linewidth(lw)

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

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

set_linewidths(lw)

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

set_lw(lw)

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position)

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

set_offsets(offsets)

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

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

set_path_effects(path_effects)

Устанавливает эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths(verts, closed=True)

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

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr)

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

Параметры:	d : float Радиус выбора в точках.

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or None

set_sizes(sizes, dpi=72.0)

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

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

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.

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls)

Параметры:	urls : List[str] or None

set_verts(verts, closed=True)

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

set_verts_and_codes(verts, codes)

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

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

static span_where(x, ymin, ymax, where, **kwargs) [source]

Создаёт 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, и соответствующий массив 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)

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

update_from(other)

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

update_scalarmappable()

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

zorder = 0

class matplotlib.collections.CircleCollection(sizes, **kwargs) [source]

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

get_children()

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

get_clim()

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

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

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

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

get_sizes()

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

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

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

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

Будьте осторожны при использовании этой функции; результаты не будут обновляться, если область отображения объекта-художника изменится. Область отображения может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но сохранятся неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устарело начиная с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устарело начиная с версии 2.2: artist.figure is not None

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

is_transform_set()

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

mouseover

pchanged()

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

pick(mouseevent)

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

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

pickable()

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

properties()

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

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_func : callable Функция фильтра, которая принимает (m, n, 3) массив с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив.

set_alpha(alpha)

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

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

set_animated(b)

Устанавливает состояние анимации объекта-художника.

Параметры:	b : bool

set_antialiased(aa)

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

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

set_antialiaseds(aa)

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

set_array(A)

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

Параметры:	A : ndarray

set_capstyle(cs)

Устанавливает стиль соединения для коллекции. Стиль соединения может быть установлен только глобально для всех элементов коллекции.

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль соединения

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой; может быть переопределен в методах, имеющих vmin и vmax в качестве аргументов.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

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 является словарем свойств, которые вы хотите вернуть с тестом принадлежности.

Параметры:	picker : callable

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, к которому принадлежит художник.

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

set_hatch(hatch)

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

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

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

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

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

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

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

set_joinstyle(js)

Установить стиль соединения для коллекции. Стиль соединения может быть установлен только глобально для всех элементов коллекции.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразовано в строку с помощью вызова str (unicode в Py2).

set_linestyle(ls)

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

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

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

(offset, onoffseq),

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

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

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls)

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

set_linewidth(lw)

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

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

set_linewidths(lw)

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

set_lw(lw)

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position)

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

set_offsets(offsets)

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

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

set_path_effects(path_effects)

Установить эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths()

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr)

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

Параметры:	d : float Радиус выбора, в точках.

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or None

set_sizes(sizes, dpi=72.0)

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

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

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.

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls)

Параметры:	urls : List[str] or None

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

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 измерениями, и последнее измерение равно 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)

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

update_from(other)

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

update_scalarmappable()

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

zorder = 0

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

Базы: matplotlib.artist.Artist, matplotlib.cm.ScalarMappable

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

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

prop[i % len(props)]

Исключениями являются свойства capstyle и joinstyle, эти свойства могут быть установлены только глобально для всей коллекции.

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

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

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

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

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

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

%(Collection)s

add_callback(func)

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

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

add_checker(checker)

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

aname = 'Artist'

autoscale()

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

autoscale_None()

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

axes

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

changed()

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

check_update(checker)

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

contains(mouseevent) [source]

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

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

convert_xunits(x)

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

convert_yunits(y)

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

draw(renderer) [source]

Метод отрисовки производных классов

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_capstyle() [source]

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

get_edgecolor() [source]

get_edgecolors()

get_facecolor() [source]

get_facecolors()

get_figure()

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

get_fill() [source]

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

get_gid()

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

get_hatch() [source]

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

get_joinstyle() [source]

get_label()

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

get_linestyle()

get_linestyles() [source]

get_linewidth()

get_linewidths() [source]

get_offset_position() [source]

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

get_offset_transform() [source]

get_offsets() [source]

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

get_path_effects()

get_paths() [source]

get_picker()

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

get_pickradius() [source]

get_rasterized()

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

get_sketch_params()

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

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

get_snap()

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

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

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

get_transform()

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

get_transformed_clip_path_and_affine()

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

get_transforms() [source]

get_url()

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

get_urls() [source]

get_visible()

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

get_window_extent(renderer) [source]

Получить прямоугольник области отрисовки осей в пространстве отображения. Подклассы должны переопределять его для включения в вычисление "плотного" прямоугольника области отрисовки. По умолчанию возвращает пустой прямоугольник области отрисовки в точке 0, 0.

Будьте осторожны при использовании этой функции, результаты не обновляются, если изменяется прямоугольник области отрисовки объекта-артиста. Размеры могут измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но будут сохраняться некорректно.

get_zorder()

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

have_units()

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

hitlist(event)

Устарело начиная с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устарело начиная с версии 2.2: artist.figure is not None

Возвращает, назначен ли объект-артист 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_func : callable Функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3).

set_alpha(alpha) [source]

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

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

set_animated(b)

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

Параметры:	b : bool

set_antialiased(aa) [source]

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

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

set_antialiaseds(aa) [source]

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

set_array(A)

Установить массив изображений из массива NumPy A.

Параметры:	A : ndarray

set_capstyle(cs) [source]

Установить стиль окончания отрезков для коллекции. Стиль окончания может быть установлен только глобально для всех элементов коллекции.

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль окончания

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длины 2 из чисел с плавающей точкой; может быть переопределен в методах, имеющих vmin и vmax аргументы.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

set_clip_path(path, transform=None)

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

• экземпляр Patch (или подкласс); или
• экземпляр Path, в этом случае экземпляр Transform, который будет применён к пути перед его использованием для обрезки, должен быть предоставлен; или
• None, чтобы удалить ранее установленный путь обрезки.

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

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

set_cmap(cmap)

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

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

set_color(c) [source]

Установить цвет границы и заливки.

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

См. также

set_facecolor(), set_edgecolor()

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

set_contains(picker)

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

hit, props = picker(artist, mouseevent)

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

Параметры:	picker : callable

set_dashes(ls) [source]

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

set_edgecolor(c) [source]

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

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

set_edgecolors(c) [source]

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

set_facecolor(c) [source]

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

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

set_facecolors(c) [source]

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

set_figure(fig)

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

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

set_hatch(hatch) [source]

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

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_joinstyle(js) [source]

Установите стиль соединения для набора. Стиль соединения может быть установлен только глобально для всех элементов в наборе.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразовано в строку с помощью вызова str (unicode в Py2).

set_linestyle(ls) [source]

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

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

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

(offset, onoffseq),

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

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

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls) [source]

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

set_linewidth(lw) [source]

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

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

set_linewidths(lw) [source]

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

set_lw(lw) [source]

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position) [source]

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

set_offsets(offsets) [source]

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

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

set_path_effects(path_effects)

Установите эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths() [source]

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr) [source]

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

Параметры:	d : float Радиус выбора в пунктах.

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or None

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

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

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

set_snap(snap)

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

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

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

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls) [source]

Параметры:	urls : List[str] or None

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

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 является массивом 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)

Обновляет свойства этого объекта по данным из словаря prop.

update_from(other) [source]

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

update_scalarmappable() [source]

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

zorder = 0

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

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

Допустимые ключевые аргументы 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) [source]

Метод отрисовки производных классов

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

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

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

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

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

Получает область отображения осей. Подклассы должны переопределять для включения в расчет области отображения "плотно". По умолчанию возвращается пустая область отображения в координатах 0, 0.

Будьте осторожны при использовании этой функции. Результаты не будут обновляться, если область отображения элемента изменится. Область отображения может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемой области рисования (как это делается при сохранении изображения). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но сохранятся неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устарело начиная с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устарело начиная с версии 2.2: artist.figure is not None

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

is_transform_set()

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

mouseover

pchanged()

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

pick(mouseevent)

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

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

pickable()

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

properties()

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

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_func : callable Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (m, n, 3).

set_alpha(alpha)

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

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

set_animated(b)

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

Параметры:	b : bool

set_antialiased(aa)

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

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

set_antialiaseds(aa)

Синоним для set_antialiased

set_array(A)

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

Параметры:	A : ndarray

set_capstyle(cs)

Устанавливает стиль обрезки для коллекции. Стиль обрезки можно установить только глобально для всех элементов коллекции.

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль обрезки

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длины 2 из чисел с плавающей точкой; может быть переопределено в методах, имеющих vmin и vmax в качестве аргументов.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

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 — словарь свойств, которые вы хотите получить с тестом на вхождение.

Параметры:	picker : callable

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

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

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

Установить стиль соединения для коллекции. Стиль соединения может быть установлен только глобально для всех элементов коллекции.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразован в строку с помощью вызова str (unicode в Py2).

set_linestyle(ls)

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

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

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

(offset, onoffseq),

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

ПРИНИМАЕТ: ['сплошная' | 'пунктирная', 'штрих-пунктирная', 'точечная' |

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls)

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

set_linewidth(lw)

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

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

set_linewidths(lw)

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

set_lw(lw)

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position)

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

set_offsets(offsets)

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

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

set_path_effects(path_effects)

Установите эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths()

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr)

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

Параметры:	d : float Радиус выбора в точках.

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or None

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

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

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

set_snap(snap)

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

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

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

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls)

Параметры:	urls : List[str] or None

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

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-го порядка, и соответствующий массив 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)

Обновляет свойства этого элемента на основе словаря 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) [source]

Базы: matplotlib.collections.LineCollection

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

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

Параметры:

positions : 1D array-like object Каждое значение — событие. orientation : {None, 'horizontal', 'vertical'}, optional Ориентация коллекции (полосы событий направлены вдоль перпендикулярного направления). По умолчанию 'horizontal', если не указано или None. lineoffset : scalar, optional, default: 0 Смещение центра маркеров от начала координат в направлении, перпендикулярном orientation. linelength : scalar, optional, default: 1 Полная высота маркера (т.е. маркер простирается от lineoffset - linelength/2 до lineoffset + linelength/2). linewidth : scalar or None, optional, default: None Если None, используется значение из rcParams в виде последовательности. color : color, sequence of colors or None, optional, default: None Если None, используется значение из rcParams в виде последовательности. linestyle : str or tuple, optional, default: 'solid' Допустимые строки: ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Кортежи пунктира должны иметь вид: (offset, onoffseq), где onoffseq — кортеж чётной длины, содержащий значения включения/выключения чернил в пунктах. antialiased : {None, 1, 2}, optional Если None, используется значение из rcParams в виде последовательности. **kwargs : optional Другие ключевые аргументы — свойства коллекции линий. Список допустимых свойств см. в LineCollection.

Примеры

(Исходный код, png, pdf)

add_callback(func)

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

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

add_checker(checker)

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

add_positions(position) [source]

Добавление одного или нескольких событий в указанные позиции

aname = 'Artist'

append_positions(position)

Добавление одного или нескольких событий в указанные позиции

autoscale()

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

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

get_children()

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

get_clim()

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

get_clip_box()

Возвращает ограничивающую рамку графического элемента.

get_clip_on()

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

get_clip_path()

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

get_cmap()

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

get_color() [source]

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

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

get_label()

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

get_linelength() [source]

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

get_lineoffset() [source]

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

get_linestyle() [source]

Получить стиль линий, используемых для маркировки каждого события [ 'сплошная' | 'штриховая' | 'штрихпунктирная' | 'пунктирная' ].

get_linestyles()

get_linewidth() [source]

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

get_linewidths()

get_offset_position()

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

get_offset_transform()

get_offsets()

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

get_orientation() [source]

Получить ориентацию линии события, может быть: [ 'горизонтальная' | 'вертикальная' ]

get_path_effects()

get_paths()

get_picker()

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

get_pickradius()

get_positions() [source]

Возвращает массив, содержащий значения позиций с плавающей точкой.

get_rasterized()

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

get_segments()

Возвращает:	segments : list Список отрезков в LineCollection. Каждый элемент списка содержит массив вершин.

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

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

Будьте осторожны при использовании этой функции, результаты не будут обновляться, если область окна элемента на графике изменится. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть хорошо на экране, но будут сохранены неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устарело начиная с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устарело начиная с версии 2.2: artist.figure is not None

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

is_horizontal() [source]

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

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_func : callable Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3).

set_alpha(alpha)

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

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

set_animated(b)

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

Параметры:	b : bool

set_antialiased(aa)

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

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

set_antialiaseds(aa)

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

set_array(A)

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

Параметры:	A : ndarray

set_capstyle(cs)

Установить стиль окончания линии для коллекции. Стиль окончания может быть установлен только глобально для всех элементов коллекции

Параметры:	cs : ['butt' | 'round' | 'projecting'] Стиль окончания

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой; может быть переопределено в методах, имеющих vmin и vmax kwargs.

set_clip_box(clipbox)

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

Параметры:	clipbox : Bbox

set_clip_on(b)

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

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

Параметры:	b : bool

set_clip_path(path, transform=None)

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

• объект Patch (или подкласс); или
• объект Path, в этом случае объект Transform, который будет применён к пути перед использованием его для обрезки, должен быть предоставлен; или
• None, чтобы удалить ранее установленный путь обрезки.

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

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

set_cmap(cmap)

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

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

set_color(c)

Установить цвет(ы) LineCollection.

Параметры:	c : Аргумент цвета Matplotlib (все элементы имеют одинаковый цвет), или последовательность или кортежи rgba; если это последовательность, элементы будут циклически перебирать последовательность.

set_contains(picker)

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

hit, props = picker(artist, mouseevent)

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

Параметры:	picker : callable

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

Параметры:	fig : Figure

set_gid(gid)

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

Параметры:	gid : str

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

Установить стиль соединения для набора. Стиль соединения может быть установлен только глобально для всех элементов набора.

Параметры:	js : ['miter' | 'round' | 'bevel'] Стиль соединения

set_label(s)

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

Параметры:	s : object s будет преобразовано в строку с помощью вызова str (unicode в Py2).

set_linelength(linelength) [source]

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

set_lineoffset(lineoffset) [source]

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

set_linestyle(ls)

Установить стиль(и) линии для набора.

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

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

(offset, onoffseq),

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

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

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

Параметры:	ls : { '-', '--', '-.', ':'} and more see description Стиль линии.

set_linestyles(ls)

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

set_linewidth(lw)

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

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

set_linewidths(lw)

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

set_lw(lw)

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

set_norm(norm)

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

Параметры:	norm : Normalize

set_offset_position(offset_position)

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

set_offsets(offsets)

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

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

set_orientation(orientation=None) [source]

установить ориентацию линии события [ 'горизонтальная' | 'вертикальная' | None ], по умолчанию 'горизонтальная', если не указано или None

set_path_effects(path_effects)

Установить эффекты пути.

Параметры:	path_effects : AbstractPathEffect

set_paths(segments)

set_picker(picker)

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

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

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

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

  hit, props = picker(artist, mouseevent)
  

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

Параметры:	picker : None or bool or float or callable

set_pickradius(pr)

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

Параметры:	d : float Радиус выбора в пунктах.

set_positions(positions) [source]

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

set_rasterized(rasterized)

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

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

Параметры:	rasterized : bool or 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.

Параметры:	snap : bool or None

set_transform(t)

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

Параметры:	t : Transform

set_url(url)

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

Параметры:	url : str

set_urls(urls)

Параметры:	urls : List[str] or None

set_verts(segments)

set_visible(b)

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

Параметры:	b : bool

set_zorder(level)

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

Параметры:	level : float

stale

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

sticky_edges

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

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

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

Примеры

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

switch_orientation() [source]

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

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 игнорируется; он не заменит уже существующее значение alpha. ValueError будет вызван, если третье измерение не равно 3 или 4.

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

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

update(props)

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

update_from(other)

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

update_scalarmappable()

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

zorder = 0

class matplotlib.collections.LineCollection(segments, linewidths=None, colors=None, antialiaseds=None, linestyles='solid', offsets=None, transOffset=None, norm=None, cmap=None, pickradius=5, zorder=2, facecolors='none', **kwargs) [source]

Базы: matplotlib.collections.Collection

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

prop[i % len(props)]

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

Параметры:

segments : Последовательность (line0, line1, line2), где: linen = (x0, y0), (x1, y1), ... (xm, ym) или эквивалентная массив NumPy с двумя столбцами. Длина каждой линии может быть разной. colors : sequence, optional Последовательность кортежей RGBA (например, произвольные цветовые строки и т. д., не допускаются). antialiaseds : sequence, optional Последовательность единиц или нулей. linestyles : string, tuple, optional Любой из [ 'solid' | 'dashed' | 'dashdot' | 'dotted' ], или кортеж тире. Кортеж тире имеет вид: (offset, onoffseq) где onoffseq — кортеж чётной длины со значениями «включено» и «выключено» чернил в пунктах. norm : Normalize, optional Normalize экземпляр. cmap : string or Colormap, optional Имя цветовой карты или Colormap экземпляр. pickradius : float, optional Допуск в пунктах для нажатия мышью, выбирающего линию. По умолчанию 5 пт. zorder : int, optional zorder коллекции линий. По умолчанию 2. facecolors : optional Цвета заливки коллекции линий. По умолчанию 'none'. Установка значения, отличного от 'none', приведёт к отрисовке заполненного многоугольника между точками на каждой линии.

Примечания

Если linewidths, colors или antialiaseds имеют значение None, они по умолчанию принимают значение из rcParams, в виде последовательности.

Если offsets и transOffset не равны None, то offsets преобразуются с помощью transOffset и применяются после преобразования отрезков в координаты отображения.

Если offsets не равно None, но transOffset равно None, то offsets добавляются к отрезкам до любого преобразования. В этом случае, можно указать единственное значение смещения:

offsets=(xo,yo)

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

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

add_callback(func)

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

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

add_checker(checker)

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

aname = 'Artist'

autoscale()

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

autoscale_None()

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

axes

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

changed()

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

check_update(checker)

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

contains(mouseevent)

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

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

convert_xunits(x)

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

convert_yunits(y)

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

draw(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 фильтром.

get_alpha()

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

get_animated()

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

get_array()

Возвратить массив

get_capstyle()

get_children()

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

get_clim()

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

get_clip_box()

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

get_clip_on()

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

get_clip_path()

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

get_cmap()

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

get_color() [source]

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

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

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

get_segments() [source]

Возвращает:	segments : list Список сегментов в LineCollection. Каждый элемент списка содержит массив вершин.

get_sketch_params()

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

Возвращает:	sketch_params : tuple or 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)

Получить прямоугольник области построения осей в пространстве отображения. Подклассы должны переопределять его для включения в вычисление "обрезки" прямоугольника области построения. По умолчанию возвращает пустой прямоугольник в 0, 0.

Будьте осторожны при использовании этой функции, результаты не будут обновлены, если область построения объекта изменится. Область построения может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но будут сохраняться неправильно.

get_zorder()

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

have_units()

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

hitlist(event)

Устаревшее с версии 2.2: Функция hitlist устарела в версии 2.2.

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

is_figure_set()

Устаревшее с версии 2.2: artist.figure is not None

Возвращает, назначен ли объект 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_func : callable Функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив.

set_alpha(alpha)

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

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