matplotlib._enums

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

Matplotlib часто использует простые типы данных, такие как строки или кортежи, для определения концепции; например, стиль окончания линии может быть задан как один из 'butt', 'round' или 'projecting'. Классы в этом модуле используются внутри и служат для формального документирования этих концепций.

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

класс matplotlib._enums.JoinStyle(value)[source]

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

Для визуального представления каждого JoinStyle, view these docs online, или запустите JoinStyle.demo.

Линии в Matplotlib обычно определяются 1D Path и конечным linewidth, где лежащая в основе 1D Path представляет центр нарисованной линии.

По умолчанию, GraphicsContextBase определяет границы нарисованной линии как все точки в пределах некоторого радиуса, linewidth/2, от любой точки центральной линии. Однако это приводит к тому, что углы выглядят "сглаженными", что может быть нежелательным поведением, например, при рисовании многоугольника или острого треугольника.

Поддерживаемые значения:

'miter'

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

'round'

обводит все точки в радиусе linewidth/2 от центральной линии.

'bevel'

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

Примечание

Очень длинные наконечники миттера обрезаются (чтобы образовать bevel) после зависящей от бэкенда ограничения, называемой "пределом миттера", которое определяет максимальное допустимое отношение длины миттера к ширине линии. Например, бэкенд PDF использует значение по умолчанию 10, заданное стандартом PDF, а бэкенд SVG даже не определяет предел миттера, что приводит к значению по умолчанию 4 в соответствии со спецификацией SVG. В настоящее время Matplotlib не позволяет пользователю настраивать этот параметр.

Более подробное описание влияния предела миттера можно найти в документации Mozilla Developer Docs

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

статический demo()[source]

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

класс matplotlib._enums.CapStyle(value)[source]

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

Как рисовать начальные и конечные точки линий, которые представляют замкнутую кривую (т.е. заканчиваются в CLOSEPOLY), контролируется стилем соединения JoinStyle линии. Для всех остальных линий способ рисования начальных и конечных точек контролируется CapStyle.

Для визуального представления каждого CapStyle, view these docs online или запустите CapStyle.demo.

Поддерживаемые значения:

'butt'

линия обрезается в конечной точке.

'projecting'

линия обрезается, как в butt, но заполненная область простирается за пределы конечной точки на расстояние linewidth/2.

'round'

как butt, но к концу линии добавляется полукруглая заглушка радиусом linewidth/2.

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

статический demo()[source]

Демонстрация того, как каждый CapStyle выглядит для толстого отрезка линии.