линии

matplotlib.линии

Этот модуль содержит все классы 2D линий, которые могут рисовать с различными стилями линий, маркерами и цветами.

class matplotlib.lines.Line2D(xdata, ydata, linewidth=None, linestyle=None, color=None, marker=None, markersize=None, markeredgewidth=None, markeredgecolor=None, markerfacecolor=None, markerfacecoloralt='none', fillstyle=None, antialiased=None, dash_capstyle=None, solid_capstyle=None, dash_joinstyle=None, solid_joinstyle=None, pickradius=5, drawstyle=None, markevery=None, **kwargs)

Bases: matplotlib.artist.Artist

Линия — линия может иметь как сплошную линию, соединяющую все вершины, так и маркер в каждой вершине. Кроме того, отрисовка сплошной линии зависит от стиля отрисовки, например, можно создать «ступенчатые» линии различными стилями.

Создайте экземпляр Line2D с данными x и y в последовательностях xdata, ydata.

Ключевые параметры (kwargs) являются свойствами Line2D:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	число с плавающей точкой (от 0,0 — прозрачный до 1,0 — непрозрачный)
`animated`	[Истина \| Ложь]
`antialiased` или aa	[Истина \| Ложь]
`axes`	экземпляр `Axes`
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[Истина \| Ложь]
`clip_path`	[ ( `Path`, `Transform`) \| `Patch` \| None ]
`color` или c	любой цвет matplotlib
`contains`	вызываемая функция
`dash_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`dash_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`dashes`	последовательность включения/выключения чернил в пунктах
`drawstyle`	[‘default’ \| ‘steps’ \| ‘steps-pre’ \| ‘steps-mid’ \| ‘steps-post’]
`figure`	экземпляр `matplotlib.figure.Figure`
`fillstyle`	[‘full’ \| ‘left’ \| ‘right’ \| ‘bottom’ \| ‘top’ \| ‘none’]
`gid`	строка-идентификатор
`label`	строка или что-либо печатаемое с помощью преобразования ‘%s’.
`linestyle` или ls	[‘solid’ \| ‘dashed’, ‘dashdot’, ‘dotted’ \| (смещение, последовательность включения/выключения штрихов) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	вещественное значение в пунктах
`marker`	`A valid marker style`
`markeredgecolor` или mec	любой цвет matplotlib
`markeredgewidth` или mew	вещественное значение в пунктах
`markerfacecolor` или mfc	любой цвет matplotlib
`markerfacecoloralt` или mfcalt	любой цвет matplotlib
`markersize` или ms	вещественное число
`markevery`	[None \| целое число \| кортеж длиной 2 из целых чисел \| срез \| список/массив целых чисел \| вещественное число \| кортеж длиной 2 из вещественных чисел]
`path_effects`	неизвестно
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	[Истина \| Ложь \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`solid_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`solid_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка URL
`visible`	[Истина \| Ложь]
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	любое число

END_OF_DOCUMENT_MARKER

См. set_linestyle() для описания стилей линий, set_marker() для описания маркеров и set_drawstyle() для описания стилей рисования.

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

contains(mouseevent)

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

Возвращает True, если какие-либо значения находятся в радиусе вместе с {'ind': pointlist}, где pointlist — это набор точек в пределах радиуса.

TODO: отсортировать возвращаемые индексы по расстоянию

draw(artist, renderer, *args, **kwargs): Отрисовать линию с renderer если видимость не равна False

drawStyleKeys = ['steps-post', 'steps-mid', 'steps-pre', 'default', 'steps']

drawStyles = {'steps': '_draw_steps_pre', 'default': '_draw_lines', 'steps-mid': '_draw_steps_mid', 'steps-post': '_draw_steps_post', 'steps-pre': '_draw_steps_pre'}

fillStyles = ('full', 'left', 'right', 'bottom', 'top', 'none')

filled_markers = ('o', 'v', '^', '', '8', 's', 'p', '*', 'h', 'H', 'D', 'd')

get_aa(): Псевдоним для get_antialiased

get_antialiased()

get_c(): Псевдоним для get_color

get_color()

get_dash_capstyle(): Получить стиль окончания штрихов для штриховых линий

get_dash_joinstyle(): Получить стиль соединения для штриховых линий

get_data(orig=True)

Возвращает xdata, ydata.

Если orig равно True, возвращает исходные данные.

get_drawstyle()

get_fillstyle(): возвращает стиль заполнения маркера

get_linestyle()

get_linewidth()

get_ls(): Псевдоним для get_linestyle

get_lw(): Псевдоним для get_linewidth

get_marker()

get_markeredgecolor()

get_markeredgewidth()

get_markerfacecolor()

get_markerfacecoloralt()

get_markersize()

get_markevery(): Возвращает установку markevery

get_mec(): Псевдоним для get_markeredgecolor

get_mew(): Псевдоним для get_markeredgewidth

get_mfc(): Псевдоним для get_markerfacecolor

get_mfcalt(alt=False): Псевдоним для get_markerfacecoloralt

get_ms(): Псевдоним для get_markersize

get_path(): Возвращает объект Path, связанный с этой линией.

get_pickradius(): возвращает радиус выбора, используемый для тестов на включение

get_solid_capstyle(): Получить стиль окончания для сплошных линий

get_solid_joinstyle(): Получить стиль соединения для сплошных линий

get_window_extent(renderer)

get_xdata(orig=True)

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

Если orig равно True, возвращает исходные данные, в противном случае — обработанные данные.

get_xydata(): Возвращает данные xy в виде Nx2 массива numpy.

get_ydata(orig=True)

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

Если orig равно True, возвращает исходные данные, в противном случае — обработанные данные.

is_dashed(): возвращает True, если стиль линии — пунктирная

lineStyles = {'': '_draw_nothing', '-.': '_draw_dash_dot', '--': '_draw_dashed', ' ': '_draw_nothing', ':': '_draw_dotted', '-': '_draw_solid', 'None': '_draw_nothing'}

markers = {0: 'tickleft', 1: 'tickright', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 'H': 'hexagon2', 'h': 'hexagon1', '1': 'tri_down', '4': 'tri_right', 'd': 'thin_diamond', '.': 'point', None: 'nothing', '^': 'triangle_up', '_': 'hline', 'o': 'circle', 'D': 'diamond', 's': 'square', ' ': 'nothing', 'x': 'x', '8': 'octagon', '': 'nothing', 'v': 'triangle_down', ',': 'pixel', 6: 'caretup', '2': 'tri_up', 'p': 'pentagon', 7: 'caretdown', '*': 'star', '>': 'triangle_right', '

recache(always=False)

recache_always()

set_aa(val): Псевдоним для set_antialiased

set_antialiased(b)

True, если линия должна отрисовываться с антиалиасингом

ПРИНИМАЕТ: [True | False]

set_c(val): Псевдоним для set_color

set_color(color)

Установить цвет линии

ПРИНИМАЕТ: любой цвет matplotlib

set_dash_capstyle(s)

Установить стиль окончания для штриховых линий

ПРИНИМАЕТ: [‘butt’ | ‘round’ | ‘projecting’]

set_dash_joinstyle(s): Установить стиль соединения для штриховых линий ПРИНИМАЕТ: [‘miter’ | ‘round’ | ‘bevel’]

set_dashes(seq)

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

ПРИНИМАЕТ: последовательность включения/выключения чернил в точках

set_data(*args)

Установить данные x и y

ПРИНИМАЕТ: 2D массив (строки x, y) или два 1D массива

set_drawstyle(drawstyle)

Установить стиль рисования графика

‘default’ соединяет точки линиями. Варианты steps создают пошаговые графики. ‘steps’ эквивалентно ‘steps-pre’ и сохраняется для обратной совместимости.

ПРИНИМАЕТ: [‘default’ | ‘steps’ | ‘steps-pre’ | ‘steps-mid’ |: ‘steps-post’]

set_fillstyle(fs)

Установить стиль заполнения маркера; ‘full’ означает заполнение всего маркера. ‘none’ означает отсутствие заполнения; другие варианты предназначены для заполнения половины маркеров.

END_OF_DOCUMENT_MARKER

set_linestyle(ls)

Установите стиль линии (также принимает стили рисования, например, 'steps--')

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

‘steps’ эквивалентно ‘steps-pre’ и сохраняется для обратной совместимости.

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

(offset, onoffseq),

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

ПРИНИМАЕТ: [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ |: (смещение, последовательность вкл-выкл-штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

См. также

set_drawstyle(): Для установки стиля рисования (ступенчатости) графика.

Параметры:

Параметры:	ls : { `'-'`, `'--'`, `'-.'`, `':'`} и более, см. описание Стиль линии.

ls : { '-', '--', '-.', ':'} и более, см. описание

Стиль линии.

set_linewidth(w)

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

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

set_ls(val): псевдоним для set_linestyle

set_lw(val): псевдоним для set_linewidth

set_marker(marker)

Установите маркер линии

ПРИНИМАЕТ: A valid marker style

Параметры:

Параметры:	marker: стиль маркера См. `markers` для полного описания возможных аргументов

marker: стиль маркера

См. markers для полного описания возможных аргументов

set_markeredgecolor(ec)

Установите цвет границы маркера

ПРИНИМАЕТ: любой цвет matplotlib

set_markeredgewidth(ew)

Установите ширину границы маркера в пунктах

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

set_markerfacecolor(fc)

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

ПРИНИМАЕТ: любой цвет matplotlib

set_markerfacecoloralt(fc)

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

ПРИНИМАЕТ: любой цвет matplotlib

set_markersize(sz)

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

ПРИНИМАЕТ: числовое значение

set_markevery(every)

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

Например, если every=5, будет нарисован каждый пятый маркер.

Параметры:

Параметры:	every: None \| int \| кортеж длины 2 из int \| срез \| список/массив из int \| float \| кортеж длины 2 из float Какие маркеры рисовать. every=None, будут нарисованы все точки. every=N, будет нарисован каждый N-й маркер, начиная с маркера 0. every=(start, N), будут нарисованы каждый N-й маркер, начиная с точки start. every=slice(start, end, N), будут нарисованы каждый N-й маркер, начиная с точки start до точки end (не включая). every=[i, j, m, n], будут нарисованы только маркеры в точках i, j, m и n. every=0.1, (т.е. число с плавающей точкой) маркеры будут размещены примерно на равных расстояниях вдоль линии; расстояние вдоль линии между маркерами определяется путём умножения расстояния по оси отображения диагонали области осей на значение every. every=(0.5, 0.1) (т.е. кортеж длины 2 из число с плавающей точкой), работает аналогично every=0.1, но первый маркер будет смещён на 0.5, умноженное на расстояние по оси отображения диагонали области осей.

float | кортеж длины 2 из float

Какие маркеры рисовать.

every=None, будут нарисованы все точки.
every=N, будет нарисован каждый N-й маркер, начиная с маркера 0.
every=(start, N), будут нарисованы каждый N-й маркер, начиная с точки start.
every=slice(start, end, N), будут нарисованы каждый N-й маркер, начиная с точки start до точки end (не включая).
every=[i, j, m, n], будут нарисованы только маркеры в точках i, j, m и n.
every=0.1, (т.е. число с плавающей точкой) маркеры будут размещены примерно на равных расстояниях вдоль линии; расстояние вдоль линии между маркерами определяется путём умножения расстояния по оси отображения диагонали области осей на значение every.
every=(0.5, 0.1) (т.е. кортеж длины 2 из число с плавающей точкой), работает аналогично every=0.1, но первый маркер будет смещён на 0.5, умноженное на расстояние по оси отображения диагонали области осей.

Примечания

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

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

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

set_mec(val): псевдоним для set_markeredgecolor

set_mew(val): псевдоним для set_markeredgewidth

set_mfc(val): псевдоним для set_markerfacecolor

set_mfcalt(val): псевдоним для set_markerfacecoloralt

set_ms(val): псевдоним для set_markersize

set_picker(p)

Устанавливает детали выбора событий для линии.

ПРИНИМАЕТ: расстояние в пунктах или вызываемую функцию pick fn(artist, event)

set_pickradius(d)

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

ПРИНИМАЕТ: расстояние в пунктах

set_solid_capstyle(s)

Установите стиль окончания для сплошных линий

ПРИНИМАЕТ: [‘butt’ | ‘round’ | ‘projecting’]

set_solid_joinstyle(s): Установите стиль соединения для сплошных линий ПРИНИМАЕТ: [‘miter’ | ‘round’ | ‘bevel’]

set_transform(t)

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

ПРИНИМАЕТ: экземпляр matplotlib.transforms.Transform

set_xdata(x)

Установите данные np.array для x

ПРИНИМАЕТ: одномерный массив

set_ydata(y)

Установите данные np.array для y

ПРИНИМАЕТ: одномерный массив

update_from(other): копировать свойства из other в self

validCap = ('butt', 'round', 'projecting')

validJoin = ('miter', 'round', 'bevel')

zorder = 2

class matplotlib.lines.VertexSelector(line)

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

Управляет обратными вызовами для поддержания списка выбранных вершин для matplotlib.lines.Line2D. Производные классы должны переопределять process_selected(), чтобы сделать что-то с выбором.

Вот пример, который выделяет выбранные вершины красными кружками:

import numpy as np
import matplotlib.pyplot as plt
import matplotlib.lines as lines

class HighlightSelected(lines.VertexSelector):
    def __init__(self, line, fmt='ro', **kwargs):
        lines.VertexSelector.__init__(self, line)
        self.markers, = self.axes.plot([], [], fmt, **kwargs)

    def process_selected(self, ind, xs, ys):
        self.markers.set_data(xs, ys)
        self.canvas.draw()

fig = plt.figure()
ax = fig.add_subplot(111)
x, y = np.random.rand(2, 30)
line, = ax.plot(x, y, 'bs-', picker=5)

selector = HighlightSelected(line)
plt.show()

Инициализируйте класс с экземпляром matplotlib.lines.Line2D. Линия должна быть уже добавлена к какому-либо экземпляру matplotlib.axes.Axes и должно быть установлено свойство picker.

onpick(event): При выборе линии обновите набор выбранных индексов.

process_selected(ind, xs, ys)

По умолчанию “не делать ничего” реализация метода process_selected().

ind — индексы выбранных вершин. xs и ys — координаты выбранных вершин.

matplotlib.lines.segment_hits(cx, cy, x, y, radius): Определить, находятся ли какие-либо отрезки прямых в радиусе точки. Возвращает список отрезков прямых, которые находятся в пределах этого радиуса.