matplotlib.contour

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

classmatplotlib.contour.ClabelText(x=0, y=0, text='', *, color=None, verticalalignment='baseline', horizontalalignment='left', multialignment=None, fontproperties=None, rotation=None, linespacing=None, rotation_mode=None, usetex=None, wrap=False, transform_rotates_text=False, parse_math=None, **kwargs)[source]

Базы: Text

[Устарело] В отличие от обычного текста, get_rotation возвращает обновлённый угол в пиксельных координатах, предполагая, что входной поворот является углом в координатах данных (или любым установленным преобразованием).

Примечания

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

Создаёт экземпляр Text в точке x, y со строкой text.

Текст выравнивается относительно точки якоря (x, y) в соответствии с horizontalalignment (по умолчанию: 'left') и verticalalignment (по умолчанию: 'bottom'). См. также Выравнивание текста.

Хотя Text принимает ключевое слово 'label', по умолчанию оно не добавляется в обработчики легенды.

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
animated	логическое значение
backgroundcolor	цвет
bbox	словарь с свойствами для patches.FancyBboxPatch
clip_box	неизвестно
clip_on	неизвестно
clip_path	неизвестно
color или c	цвет
figure	Figure
fontfamily или family	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	число с плавающей точкой или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style	{'normal', 'italic', 'oblique'}
fontvariant или variant	{'normal', 'small-caps'}
fontweight или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	строка
horizontalalignment или ha	{'left', 'center', 'right'}
in_layout	логическое значение
label	объект
linespacing	число с плавающей точкой (кратное размеру шрифта)
math_fontfamily	строка
mouseover	логическое значение
multialignment или ma	{'left', 'right', 'center'}
parse_math	логическое значение
path_effects	AbstractPathEffect
picker	None или логическое значение или число с плавающей точкой или вызываемая функция
position	(число с плавающей точкой, число с плавающей точкой)
rasterized	логическое значение
rotation	число с плавающей точкой или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	логическое значение или None
text	объект
transform	Transform
transform_rotates_text	логическое значение
url	строка
usetex	логическое значение или None
verticalalignment или va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	логическое значение
wrap	логическое значение
x	число с плавающей точкой

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

get_rotation()[source]

Возвращает угол текста в градусах в диапазоне от 0 до 360.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, backgroundcolor=<UNSET>, bbox=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, fontfamily=<UNSET>, fontproperties=<UNSET>, fontsize=<UNSET>, fontstretch=<UNSET>, fontstyle=<UNSET>, fontvariant=<UNSET>, fontweight=<UNSET>, gid=<UNSET>, horizontalalignment=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linespacing=<UNSET>, math_fontfamily=<UNSET>, mouseover=<UNSET>, multialignment=<UNSET>, parse_math=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, rasterized=<UNSET>, rotation=<UNSET>, rotation_mode=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, text=<UNSET>, transform=<UNSET>, transform_rotates_text=<UNSET>, url=<UNSET>, usetex=<UNSET>, verticalalignment=<UNSET>, visible=<UNSET>, wrap=<UNSET>, x=<UNSET>, y=<UNSET>, zorder=<UNSET>)[source]

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

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

Свойство	Описание
agg_filter	функция-фильтр, которая принимает массив float размером (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	скаляр или None
animated	bool
backgroundcolor	цвет
bbox	словарь с свойствами для patches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Объект Patch или (Path, Transform) или None
color или c	цвет
figure	Figure
fontfamily или family	{шрифт, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	числовое значение или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch	{числовое значение в диапазоне от 0 до 1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style	{'normal', 'italic', 'oblique'}
fontvariant или variant	{'normal', 'small-caps'}
fontweight или weight	{числовое значение в диапазоне от 0 до 1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	строка
horizontalalignment или ha	{'left', 'center', 'right'}
in_layout	bool
label	объект
linespacing	числовое значение (кратное размеру шрифта)
math_fontfamily	строка
mouseover	bool
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемая функция
position	(число с плавающей точкой, число с плавающей точкой)
rasterized	bool
rotation	число с плавающей точкой или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	строка
usetex	bool или None
verticalalignment или va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool

x	вещественное число
y	вещественное число
zorder	вещественное число

classmatplotlib.contour.ContourLabeler[source]

Bases: object

Компонент, предоставляющий возможности подписи для ContourSet.

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

Добавление метки контура без Text.set_transform_rotates_text.

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

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

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

Добавляет метку вблизи точки (x, y).

Параметры:

x, yfloat

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

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

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

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

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

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

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

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

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

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 (который наследует от этого смешанного класса).

Параметры:

levelsarray-like, необязательно

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

fontsizestr или float, по умолчанию: rcParams["font.size"] (по умолчанию: 10.0)

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

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

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

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

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

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

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

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

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

fmtFormatter или str или callable или dict, необязательно

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

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

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

manualbool или iterable, по умолчанию: False

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

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

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

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

use_clabeltextbool, по умолчанию: False

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

zorderfloat или None, по умолчанию: (2 + contour.get_zorder())

zorder подписей контура.

Возвращает:

labels

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

get_text(lev, fmt)[source]

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

propertylabelFontProps[source]

[Устарело]

Примечания

Устарело начиная с версии 3.7: Используйте cs.labelTexts[0].get_font() вместо этого.

propertylabelFontSizeList[source]

[Устарело]

Примечания

Устарело начиная с версии 3.7: Используйте [cs.labelTexts[0].get_font().get_size()] * len(cs.labelLevelList) вместо этого.

propertylabelTextsList[source]

[Устарело]

Примечания

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

labels(inline, inline_spacing)[source]

locate_label(linecontour, labelwidth)[source]

Находит подходящее место для размещения подписи (относительно плоская часть контура).

pop_label(index=-1)[source]

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

print_label(linecontour, labelwidth)[source]

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

remove()[source]

set_label_props(label, text, color)[source]

[Устарело] Установка свойств метки — цвет, размер шрифта, текст.

Примечания

Устарело начиная с версии 3.7: Используйте метод Artist.set.

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

Основы: ScalarMappable, ContourLabeler

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

Метод, вызываемый пользователем: 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

Объекты Artist, представляющие контур. Это список 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.

changed()[source]

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

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

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

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

Параметры:

x, yfloat

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

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

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

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

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

Возвращает:

contourCollection

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

segmentint

Индекс Path в contour, который находится ближе всего к (x, y).

indexint

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

xmin, yminfloat

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

d2float

Возведённое в квадрат расстояние от (xmin, ymin) до (x, y).

get_alpha()[source]

Возвращает альфа-значение, которое применяется ко всем объектам ContourSet.

get_transform()[source]

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

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

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

Подписи имеют вид «0 < variable_name> 1», указывая диапазоны данных, которые представляют элементы.

Параметры:

variable_namestr

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

str_formatфункция: float -> str

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

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

artistslist[Artist]

Список элементов.

labelslist[str]

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

remove()[source]

set_alpha(alpha)[source]

Устанавливает значение альфа-смешивания для всех элементов ContourSet. alpha должно быть в диапазоне от 0 (прозрачный) до 1 (непрозрачный).

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

Базируется на ContourSet

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

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

Атрибуты:

axAxes

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

collectionssilent_list из PathCollection

Элементы Artist, представляющие контур. Это список PathCollection для контурных линий и заполненных контуров.

levelsмассив

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

layersмассив

То же, что и levels для контурных линий; середина между уровнями для заполненных контуров. См. 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, ...], optional

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

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

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

**kwargs

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