matplotlib.lines.Line2D

класс 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)[source]

Базы: matplotlib.artist.Artist

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

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив
`alpha`	скаляр или None
`animated`	bool
`antialiased` или aa	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	неизвестно
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (чернила в/выкл в точках) или (None, None)
`data`	(2, N) массив или два одномерных массива
`drawstyle` или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gid`	строка
`in_layout`	bool
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
`linewidth` или lw	вещественное число
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	вещественное число
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	вещественное число
`markevery`	None или int или (int, int) или срез или список[int] или float или (float, float) или список[bool]
`path_effects`	`AbstractPathEffect`
`picker`	вещественное число или вызываемая функция[[Artist, Event], кортеж[bool, dict]]
`pickradius`	вещественное число
`rasterized`	bool
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	bool или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	вещественное число

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

__init__(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)[source]

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив
`alpha`	скаляр или None
`animated`	bool
`antialiased` или aa	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	неизвестно
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (чернила включены/выключены в пунктах) или (None, None)
`data`	(2, N) массив или два одномерных массива
`drawstyle` или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gid`	строка
`in_layout`	bool
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
`linewidth` или lw	вещественное число
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	вещественное число
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	вещественное число
`markevery`	None или int или (int, int) или slice или list[int] или float или (float, float) или list[bool]
`path_effects`	`AbstractPathEffect`
`picker`	вещественное число или вызываемая функция[[Artist, Event], tuple[bool, dict]]
`pickradius`	вещественное число
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	вещественное число

__module__ = 'matplotlib.lines'

__str__()[source]: Возвращает str(self).

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

contains(mouseevent)[source]

Проверяет, произошел ли mouseevent на линии.

Событие считается произошедшим "на" линии, если оно находится на расстоянии менее чем self.pickradius (по умолчанию: 5 точек) от неё. Используйте get_pickradius или set_pickradius для получения или установки радиуса выделения.

Параметры:	mouseevent`matplotlib.backend_bases.MouseEvent`
Возвращает:	containsbool Является ли значение в радиусе. detailsdict Словарь `{'ind': pointlist}`, где pointlist — список точек линии, находящихся в пределах pickradius от позиции события. TODO: отсортировать возвращаемые индексы по расстоянию

draw(renderer)[source]

Отрисовывает объект (и его потомков) с помощью заданного рендерера.

Не оказывает влияния, если объект не отображается (Artist.get_visible возвращает False).

Параметры:	renderer`RendererBase` подкласс.

Примечания

Этот метод переопределяется в подклассах Artist.

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

drawStyles = {'default': '_draw_lines', 'steps': '_draw_steps_pre', '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', 'P', 'X')

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

get_antialiased()[source]: Возвращает, используется ли антиалайзинг при отрисовке.

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

get_color()[source]

Возвращает цвет линии.

См. также set_color.

get_dash_capstyle()[source]

Возвращает CapStyle для штриховых линий.

См. также set_dash_capstyle.

get_dash_joinstyle()[source]

Возвращает JoinStyle для штриховых линий.

См. также set_dash_joinstyle.

get_data(orig=True)[source]

Возвращает данные линии как пару (xdata, ydata).

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

get_drawstyle()[source]

Возвращает стиль отрисовки.

См. также set_drawstyle.

get_ds(): Псевдоним для get_drawstyle.

get_fillstyle()[source]

Возвращает стиль заливки маркера.

См. также set_fillstyle.

get_linestyle()[source]

Возвращает стиль линии.

См. также set_linestyle.

get_linewidth()[source]

Возвращает ширину линии в пунктах.

См. также set_linewidth.

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

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

get_marker()[source]

Возвращает маркер линии.

См. также set_marker.

get_markeredgecolor()[source]

Возвращает цвет границы маркера.

См. также set_markeredgecolor.

get_markeredgewidth()[source]

Возвращает ширину границы маркера в пунктах.

См. также set_markeredgewidth.

get_markerfacecolor()[source]

Возвращает цвет заполнения маркера.

См. также set_markerfacecolor.

get_markerfacecoloralt()[source]

Возвращает альтернативный цвет заполнения маркера.

См. также set_markerfacecoloralt.

get_markersize()[source]

Возвращает размер маркера в пунктах.

См. также set_markersize.

get_markevery()[source]

Возвращает параметр markevery для подвыборки маркеров.

См. также set_markevery.

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

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

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

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

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

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

get_pickradius()[source]

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

См. contains для более подробной информации.

get_solid_capstyle()[source]

Возвращает CapStyle для сплошных линий.

См. также set_solid_capstyle.

get_solid_joinstyle()[source]

Возвращает JoinStyle для сплошных линий.

См. также set_solid_joinstyle.

get_window_extent(renderer)[source]

Получение прямоугольника области осей в пространстве отображения.

Ширина и высота прямоугольника неотрицательны.

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

Будьте внимательны при использовании этой функции, результаты не обновятся, если изменится область отображения объекта-графика. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но сохранятся неправильно.

get_xdata(orig=True)[source]

Возвращает данные по оси X.

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

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

get_ydata(orig=True)[source]

Возвращает данные по оси Y.

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

is_dashed()[source]

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

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

См. также set_linestyle.

lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted', 'None': '_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'}

свойствоpickradius

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

См. contains для получения дополнительной информации.

recache(always=False)[source]

recache_always()[source]

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

set_antialiased(b)[source]

Установить использование антиалиасинга для отрисовки.

Параметры:	bbool

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

set_color(color)[source]

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

Параметры:	colorцвет

set_dash_capstyle(s)[source]

Как рисовать концевые заглушки, если линия is_dashed.

Параметры:	s`CapStyle` или {'butt', 'projecting', 'round'}

set_dash_joinstyle(s)[source]

Как соединять отрезки линии, если она is_dashed.

Параметры:	s`JoinStyle` или {'miter', 'round', 'bevel'}

set_dashes(seq)[source]

Установить последовательность штриховки.

Последовательность штрихов — это последовательность чисел с плавающей точкой чётной длины, описывающая длину штрихов и пробелов в пунктах.

Например, (5, 2, 1, 2) описывает последовательность из 5 пунктов и 1 пункта штрихов, разделенных 2-мя пунктами пробела.

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

set_data(*args)[source]

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

Параметры:	*args(2, N) массив или два одномерных массива

set_drawstyle(drawstyle)[source]

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

Стиль рисования определяет, как соединяются точки.

Параметры:

Параметры:	drawstyle{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default' Для 'default' точки соединяются прямыми линиями. Варианты 'steps' соединяют точки ступенчатыми линиями, то есть горизонтальными линиями с вертикальными шагами. Они отличаются положением шага: 'steps-pre': Шаг находится в начале отрезка линии, то есть линия будет на значении y правой точки. 'steps-mid': Шаг находится посередине между точками. 'steps-post: Шаг находится в конце отрезка линии, то есть линия будет на значении y левой точки. 'steps' эквивалентно 'steps-pre' и поддерживается для обратной совместимости. Примеры см. Пример ступенчатой диаграммы.

drawstyle{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'

Для 'default' точки соединяются прямыми линиями.

Варианты 'steps' соединяют точки ступенчатыми линиями, то есть горизонтальными линиями с вертикальными шагами. Они отличаются положением шага:

'steps-pre': Шаг находится в начале отрезка линии, то есть линия будет на значении y правой точки.
'steps-mid': Шаг находится посередине между точками.
'steps-post: Шаг находится в конце отрезка линии, то есть линия будет на значении y левой точки.
'steps' эквивалентно 'steps-pre' и поддерживается для обратной совместимости.

Примеры см. Пример ступенчатой диаграммы.

set_ds(drawstyle): Псевдоним для set_drawstyle.

set_fillstyle(fs)[source]

Установить стиль заполнения маркера.

Параметры:

Параметры:	fs{'full', 'left', 'right', 'bottom', 'top', 'none'} Возможные значения: 'full': Заполнить весь маркер цветом markerfacecolor. 'left', 'right', 'bottom', 'top': Заполнить половину маркера на заданной стороне цветом markerfacecolor. Другая половина маркера заполняется цветом markerfacecoloralt. 'none': Не заполнять. Примеры см. на странице Стили заполнения маркеров.

fs{'full', 'left', 'right', 'bottom', 'top', 'none'}

Возможные значения:

'full': Заполнить весь маркер цветом markerfacecolor.
'left', 'right', 'bottom', 'top': Заполнить половину маркера на заданной стороне цветом markerfacecolor. Другая половина маркера заполняется цветом markerfacecoloralt.
'none': Не заполнять.

Примеры см. на странице Стили заполнения маркеров.

set_linestyle(ls)[source]

Установить стиль линии.

Параметры:

ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

Возможные значения:

Строка:

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

Также можно указать кортеж с параметрами пунктира в формате:
```
(offset, onoffseq)
```
где onoffseq — кортеж чётной длины, содержащий значения «включено» и «выключено» в пунктах. См. также set_dashes().

Примеры см. на странице Стили линий.

set_linewidth(w)[source]

Установить толщину линии в пунктах.

Параметры:	wfloat Толщина линии в пунктах.

set_ls(ls): Псевдоним для set_linestyle.

set_lw(w): Псевдоним для set_linewidth.

set_marker(marker)[source]

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

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

set_markeredgecolor(ec)[source]

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

Параметры:	ecцвет

set_markeredgewidth(ew)[source]

Установить толщину границы маркера в пунктах.

Параметры:	ewfloat Толщина границы маркера в пунктах.

set_markerfacecolor(fc)[source]

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

Параметры:	fcцвет

set_markerfacecoloralt(fc)[source]

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

Параметры:	fcцвет

set_markersize(sz)[source]

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

Параметры:	szfloat Размер маркера в пунктах.

set_markevery(every)[source]

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

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

Параметры:

Параметры:	everyNone или int или (int, int) или slice или list[int] или float или (float, float) или list[bool] Какие маркеры нужно отобразить. 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=[True, False, True], будут отображаться позиции, соответствующие True. every=0.1, (т.е. число с плавающей точкой) тогда маркеры будут размещены с приблизительно равными расстояниями по линии; расстояние по линии между маркерами определяется умножением расстояния в координатах отображения диагонали области отображения осей на значение every. every=(0.5, 0.1) (т.е. кортеж длины 2 с плавающей точкой), проявляется та же функциональность, что и при every=0.1, но первый маркер будет смещён на 0.5, умноженное на расстояние вдоль линии в координатах отображения диагонали. Примеры см. в Демонстрация Markevery.

everyNone или int или (int, int) или slice или list[int] или float или (float, float) или list[bool]

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

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=[True, False, True], будут отображаться позиции, соответствующие True.
every=0.1, (т.е. число с плавающей точкой) тогда маркеры будут размещены с приблизительно равными расстояниями по линии; расстояние по линии между маркерами определяется умножением расстояния в координатах отображения диагонали области отображения осей на значение every.
every=(0.5, 0.1) (т.е. кортеж длины 2 с плавающей точкой), проявляется та же функциональность, что и при every=0.1, но первый маркер будет смещён на 0.5, умноженное на расстояние вдоль линии в координатах отображения диагонали.

Примеры см. в Демонстрация Markevery.

Примечания

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

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

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

set_mec(ec): Псевдоним для set_markeredgecolor.

set_mew(ew): Псевдоним для set_markeredgewidth.

set_mfc(fc): Псевдоним для set_markerfacecolor.

set_mfcalt(fc): Псевдоним для set_markerfacecoloralt.

set_ms(sz): Псевдоним для set_markersize.

set_picker(p)[source]

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

Параметры:	pfloat или callable[[Artist, Event], tuple[bool, dict]] Если число с плавающей точкой, оно используется как радиус выделения в точках.