matplotlib._enums

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

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

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

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

staticdemo()[source]

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

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

staticdemo()[source]

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