matplotlib.contour

Классы для поддержки построения и маркировки контуров для класса Axes.

classmatplotlib.contour.ContourLabeler[source]

Базовое классы: object

Mixin для предоставления возможностей маркировки ContourSet.

add_label(x, y, rotation, lev, cvalue)[source]

Добавить метку контура, учитывая, был ли установлен use_clabeltext.

add_label_clabeltext(x, y, rotation, lev, cvalue)[source]

[Устарело] Добавить метку контура с Text.set_transform_rotates_text.

Примечания

Устарело начиная с версии 3.8: Используйте add_label вместо этого.

add_label_near(x, y, inline=True, inline_spacing=5, transform=None)[source]

Добавить метку рядом с точкой (x, y).

Параметры:

x, yfloat

Приблизительное расположение метки.

inlinebool, по умолчанию: True

Если True, удалить сегмент контура под меткой.

inline_spacingint, по умолчанию: 5

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

transformTransform или False, по умолчанию: self.axes.transData

Преобразование, применяемое к (x, y) перед маркировкой. По умолчанию (x, y) интерпретируется как координаты данных. False является синонимом IdentityTransform; т.е. (x, y) следует интерпретировать как координаты отображения.

calc_label_rot_and_inline(slc, ind, lw, lc=None, spacing=5)[source]

[Устарело] Вычислить соответствующее вращение метки, учитывая координаты линии контура в экранных единицах, индекс расположения метки и ширину метки.

Если lc не равно None или пусто, также разбить контуры и вычислить inline.

spacing - это пустое пространство, которое следует оставить вокруг метки в пикселях.

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

Здесь используется метод, который включает вычисление длины пути вдоль контура в координатах пикселей, а затем приблизительно (ширина метки / 2) от центральной точки для определения вращения и последующего разбиения контура, если это необходимо.

Примечания

Устарело начиная с версии 3.8.

clabel(levels=None, *, fontsize=None, inline=True, inline_spacing=5, fmt=None, colors=None, use_clabeltext=False, manual=False, rightside_up=True, zorder=None)[source]

Подписывает контурный график.

Добавляет подписи к линиям контуров в этом ContourSet (который наследуется от этого миксин-класса).

Параметры:

levelsпоследовательность, необязательно

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

fontsizeстрока или число с плавающей точкой, по умолчанию: rcParams["font.size"] (по умолчанию: 10.0)

Размер в пунктах или относительный размер, например, 'smaller', 'x-large'. См. Text.set_size для допустимых строковых значений.

colorsцвет или цвета или None, по умолчанию: None

Цвета подписей:

• Если None, цвет каждой подписи соответствует цвету соответствующего контура.
• Если один строковый цвет, например, colors = 'r' или colors = 'red', все подписи будут отображаться в этом цвете.
• Если кортеж из цветов (строка, число с плавающей точкой, RGB и т. д.), разные подписи будут отображаться в разных цветах в указанном порядке.

inlineбулево значение, по умолчанию: True

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

inline_spacingчисло с плавающей точкой, по умолчанию: 5

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

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

fmtFormatter или строка или вызываемая функция или словарь, необязательно

Как форматируются уровни:

• Если Formatter, она используется для форматирования всех уровней одновременно, используя свой метод Formatter.format_ticks.
• Если строка, она интерпретируется как строка форматирования в стиле %-.
• Если вызываемая функция, она вызывается с одним уровнем за раз и должна возвращать соответствующую подпись.
• Если словарь, он должен напрямую сопоставлять уровни с подписями.

По умолчанию используется стандартный ScalarFormatter.

manualбулево значение или последовательность, по умолчанию: False

Если True, подписи контуров будут размещаться вручную с помощью щелчков мыши. Щелкните левой кнопкой мыши вблизи контура, чтобы добавить подпись, щелкните правой кнопкой мыши (или, возможно, обеими кнопками мыши одновременно), чтобы завершить добавление подписей. Третью кнопку можно использовать для удаления последней добавленной подписи, но только если подписи не находятся внутри.

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

manual также может быть итерируемым объектом кортежей (x, y). Подписи контуров будут созданы так, как если бы в каждой точке (x, y) щелкали мышью.

rightside_upбулево значение, по умолчанию: True

Если True, повороты подписей всегда будут составлять плюс или минус 90 градусов от уровня.

use_clabeltextбулево значение, по умолчанию: False

Если True, используйте Text.set_transform_rotates_text, чтобы убедиться, что поворот подписи обновляется всякий раз, когда меняется аспект оси.

zorderчисло с плавающей точкой или None, по умолчанию: (2 + contour.get_zorder())

z-порядок подписей контуров.

Возвращаемые значения:

labels

Список экземпляров Text для подписей.

get_text(lev, fmt)[source]

Получение текста подписи.

labels(inline, inline_spacing)[source]

locate_label(linecontour, labelwidth)[source]

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

pop_label(index=-1)[source]

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

print_label(linecontour, labelwidth)[source]

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

remove()[source]

too_close(x, y, lw)[source]

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

classmatplotlib.contour.ContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None,), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, negative_linestyles=None, clip_path=None, **kwargs)[source]

Основания: ContourLabeler, Collection

Хранит набор контурных линий или заполненных областей.

Метод, вызываемый пользователем: clabel

Параметры:

axAxes

levels[level0, level1, ..., leveln]

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

allsegs[level0segs, level1segs, ...]

Список всех сегментов многоугольников для всех уровней. Для контурных линий len(allsegs) == len(levels), а для заполненных контурных областей len(allsegs) = len(levels)-1. Списки должны выглядеть так

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkindsNone или [level0kinds, level1kinds, ...]

Необязательный список всех типов вершин многоугольника (коды типов), как описано и используется в Path. Это используется для разрешения многосвязных путей, таких как отверстия внутри заполненных многоугольников. Если не None, len(allkinds) == len(allsegs). Списки должны выглядеть так

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Если allkinds не None, обычно все многоугольники для определенного уровня контура группируются вместе, так что level0segs = [polygon0] и level0kinds = [polygon0kinds].

**kwargs

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

Атрибуты:

axAxes

Объект Axes, в котором нарисованы контуры.

collectionssilent_list PathCollection

[Устарело]

levelsмассив

Значения уровней контура.

layersмассив

То же, что и уровни, для линейных контуров; посередине между уровнями для заполненных контуров. См. ContourSet._process_colors.

Отрисовывает контурные линии или заполненные области в зависимости от того, является ли ключевой аргумент filled False (по умолчанию) или True.

Вызов функции:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Параметры:

axAxes

Объект Axes для отрисовки.

levels[level0, level1, ..., leveln]

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

allsegs[level0segs, level1segs, ...]

Список всех сегментов многоугольников для всех уровней. Для контурных линий len(allsegs) == len(levels), а для заполненных контурных областей len(allsegs) = len(levels)-1. Списки должны выглядеть так

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[level0kinds, level1kinds, ...], необязательно

Необязательный список всех типов вершин многоугольника (коды типов), как описано и используется в Path. Это используется для разрешения многосвязных путей, таких как отверстия внутри заполненных многоугольников. Если не None, len(allkinds) == len(allsegs). Списки должны выглядеть так

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Если allkinds не None, обычно все многоугольники для определенного уровня контура группируются вместе, так что level0segs = [polygon0] и level0kinds = [polygon0kinds].

**kwargs

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

свойствоallkinds

свойствоallsegs

свойствоalpha

свойствоantialiased[source]

changed()[source]

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

свойствоcollections[source]

[Устарело]

Замечания

Устарело начиная с версии 3.8:

draw(renderer)[source]

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

Это не имеет эффекта, если элемент не отображается (Artist.get_visible возвращает False).

Параметры:

rendererRendererBase подкласс.

Замечания

Этот метод переопределен в подклассах Artist.

find_nearest_contour(x, y, indices=None, pixel=True)[source]

Находит точку на графике контуров, которая находится ближе всего к (x, y).

Этот метод не поддерживает заполненные контуры.

Параметры:

x, yfloat

Точка отсчета.

indicesсписок целых чисел или None, по умолчанию: None

Индексы уровней контура для рассмотрения. Если None (по умолчанию), рассматриваются все уровни.

pixelbool, по умолчанию: True

Если True, измеряется расстояние в пикселях (на экране), что полезно для ручного маркирования контуров; иначе измеряется расстояние в пространстве осей.

Возвращает:

pathint

Индекс пути, который находится ближе всего к (x, y). Каждый путь соответствует одному уровню контура.

subpathint

Индекс в этом ближайшем пути подпути, который находится ближе всего к (x, y). Каждый подпуть соответствует одной непрерывной контурной линии.

indexint

Индекс вершин в этом подпути, которые находятся ближе всего к (x, y).

xmin, yminfloat

Точка на графике контуров, которая находится ближе всего к (x, y).

d2float

Квадрат расстояния от (xmin, ymin) до (x, y).

get_transform()[source]

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

legend_elements(variable_name='x', str_format=<class 'str'>)[source]

Возвращает список элементов графических объектов и подписей, подходящих для передачи в legend, которые представляют этот объект ContourSet.

Подписи имеют вид "0 < x <= 1", указывающий диапазоны данных, которые представляют графические объекты.

Параметры:

variable_namestr

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

str_formatfunction: float -> str

Функция, используемая для форматирования чисел в подписях.

Возвращаемое значение:

artistslist[Artist]

Список графических объектов.

labelslist[str]

Список подписей.

propertylinestyles

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

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

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

Свойство	Описание
agg_filter	Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массив-подобный объект или скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	массив-подобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
cmap	Colormap или строка или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	(N, 2) или (2,) массив-подобный объект
path_effects	список AbstractPathEffect
paths	неизвестно
picker	None или bool или число с плавающей точкой или вызываемая функция
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
visible	bool

zorder

вещественное число

свойствоtcolors[source]

[Устаревший]

Примечания

Устарело начиная с версии 3.8:

свойствоtlinewidths[source]

[Устаревший]

Примечания

Устарело начиная с версии 3.8:

classmatplotlib.contour.QuadContourSet(ax, *args, levels=None, filled=False, linewidths=None, linestyles=None, hatches=(None,), alpha=None, origin=None, extent=None, cmap=None, colors=None, norm=None, vmin=None, vmax=None, extend='neither', antialiased=None, nchunk=0, locator=None, transform=None, negative_linestyles=None, clip_path=None, **kwargs)[source]

Основывается на ContourSet

Создаёт и сохраняет набор линий контура или заполненных областей.

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

Атрибуты:

axAxes

Объект Axes, в котором рисуются контуры.

collectionssilent_list PathCollection

[Устарело]

levelsмассив

Значения уровней контура.

layersмассив

Аналогично уровням для линий контура; находится посредине уровней для заполненных контуров. См. ContourSet._process_colors.

Рисует линии контура или заполненные области, в зависимости от того, является ли ключевой аргумент filled False (по умолчанию) или True.

Вызов функции:

ContourSet(ax, levels, allsegs, [allkinds], **kwargs)

Параметры:

axAxes

Объект Axes, на котором будут нарисованы контуры.

levels[level0, level1, ..., leveln]

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

allsegs[level0segs, level1segs, ...]

Список всех сегментов многоугольников для всех уровней. Для линий контура len(allsegs) == len(levels), а для заполненных областей контура len(allsegs) = len(levels)-1. Списки должны выглядеть так

level0segs = [polygon0, polygon1, ...]
polygon0 = [[x0, y0], [x1, y1], ...]

allkinds[level0kinds, level1kinds, ...], необязательно

Необязательный список всех типов вершин многоугольников (коды типов), как описано и используется в Path. Используется для создания многосвязных путей, например, дыр внутри заполненных многоугольников. Если не None, len(allkinds) == len(allsegs). Списки должны выглядеть так

level0kinds = [polygon0kinds, ...]
polygon0kinds = [vertexcode0, vertexcode1, ...]

Если allkinds не None, обычно все многоугольники для определённого уровня контура группируются вместе, так что level0segs = [polygon0] и level0kinds = [polygon0kinds].

**kwargs

Ключевые аргументы такие же, как описано в документации contour.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

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

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

Свойство	Описание
agg_filter	Функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массив-подобный объект, скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	массив-подобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
cmap	Colormap или строка или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	массив (N, 2) или (2,) массивоподобный объект
path_effects	список AbstractPathEffect
paths	неизвестно
picker	None или bool или число с плавающей точкой или вызываемый объект
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
visible	bool

zorder

вещественное число