matplotlib.lines.Line2D

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)

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

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

Параметры kwargs — это свойства Line2D:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	число с плавающей точкой (от 0,0 — прозрачный до 1,0 — непрозрачный)
`animated`	[True \| False]
`antialiased` или aa	[True \| False]
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`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 \| int \| пара значений int длиной 2 \| срез \| список/массив значений int \| число с плавающей точкой \| пара значений float длиной 2]
`path_effects`	неизвестно
`picker`	расстояние в пунктах или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в пунктах
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`solid_capstyle`	[‘butt’ \| ‘round’ \| ‘projecting’]
`solid_joinstyle`	[‘miter’ \| ‘round’ \| ‘bevel’]
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка url
`visible`	[True \| False]
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	любое число

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

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

contains(mouseevent)

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

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

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

draw(renderer): Отобразить линию с renderer , если видимость не False

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

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

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

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

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_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_draw_nothing', ' ': '_draw_nothing', '': '_draw_nothing'}

markers = {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left', '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', 's': 'square', 'p': 'pentagon', '*': 'star', 'h': 'hexagon1', 'H': 'hexagon2', '+': 'plus', 'x': 'x', 'D': 'diamond', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'caretupbase', 11: 'caretdownbase', 'None': 'nothing', None: 'nothing', ' ': 'nothing', '': 'nothing'}

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’ означает отсутствие заливки; другие варианты предназначены для заполненных наполовину маркеров.

set_linestyle(ls)

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

стиль линии	описание
`'-'` или `'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, будет отображаться каждый 5-й маркер.

Параметры:

Параметры:	every: None \| int \| пара целых чисел длиной 2 \| срез \| список/массив целых чисел \| число с плавающей точкой \| пара чисел с плавающей точкой длиной 2 Какие маркеры отображать. 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, умноженный на расстояние по диагонали области построения осей в координатах отображения вдоль линии.

число с плавающей точкой | пара чисел с плавающей точкой длиной 2

Какие маркеры отображать.

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 на нерегулярно расположенных данных, маркеры, вероятно, не будут отображаться равномерно, потому что фактические точки данных не совпадают с теоретическим расстоянием между маркерами.

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

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