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

Bases: matplotlib.artist.Artist

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

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
`alpha`	число с плавающей точкой или None
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (объект Path, преобразование) или None
`color` или c	цвет
`contains`	неизвестно
`dash_capstyle`	{'butt', 'round', 'projecting'}
`dash_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`	булево значение
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
`linewidth` или lw	число с плавающей точкой
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	число с плавающей точкой
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	число с плавающей точкой
`markevery`	None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
`path_effects`	`AbstractPathEffect`
`picker`	неизвестно
`pickradius`	число с плавающей точкой
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`solid_capstyle`	{'butt', 'round', 'projecting'}
`solid_joinstyle`	{'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	булево значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

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

END_OF_DOCUMENT_MARKER

__init__(self, 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`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	float или None
`animated`	bool
`antialiased` или aa	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color` или c	цвет
`contains`	неизвестно
`dash_capstyle`	{'butt', 'round', 'projecting'}
`dash_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) или срез или List[int] или float или (float, float) или List[bool]
`path_effects`	`AbstractPathEffect`
`picker`	неизвестно
`pickradius`	число с плавающей точкой
`rasterized`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`solid_capstyle`	{'butt', 'round', 'projecting'}
`solid_joinstyle`	{'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

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

__module__ = 'matplotlib.lines'

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

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

contains(self, mouseevent) [source]

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

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

Параметры:

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

mouseeventmatplotlib.backend_bases.MouseEvent

Возвращаемые значения:

containsbool

Были ли обнаружены какие-либо значения в радиусе.

detailsdict

Словарь {'ind': pointlist}, где pointlist — список точек линии, находящихся в пределах pickradius от позиции события.

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

draw(self, renderer) [source]

Отрисовывает элемент (и его дочерние элементы) с помощью заданного рендерера.

Это не имеет эффекта, если элемент не виден (Artist.get_visible возвращает False).

Параметры:	`rendererRendererBase subclass.`

Примечания

Этот метод переопределён в подклассах элемента.

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(self): Псевдоним для get_antialiased.

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

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

get_color(self) [source]

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

См. также set_color.

get_dash_capstyle(self) [source]

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

См. также set_dash_capstyle.

get_dash_joinstyle(self) [source]

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

См. также set_dash_joinstyle.

get_data(self, orig=True) [source]

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

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

get_drawstyle(self) [source]

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

См. также set_drawstyle.

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

get_fillstyle(self) [source]

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

См. также set_fillstyle.

get_linestyle(self) [source]

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

См. также set_linestyle.

get_linewidth(self) [source]

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

См. также set_linewidth.

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

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

get_marker(self) [source]

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

См. также set_marker.

get_markeredgecolor(self) [source]

Возвращает цвет края маркера.

См. также set_markeredgecolor.

get_markeredgewidth(self) [source]

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

См. также set_markeredgewidth.

get_markerfacecolor(self) [source]

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

См. также set_markerfacecolor.

get_markerfacecoloralt(self) [source]

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

См. также set_markerfacecoloralt.

get_markersize(self) [source]

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

См. также set_markersize.

get_markevery(self) [source]

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

См. также set_markevery.

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

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

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

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

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

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

get_pickradius(self) [source]

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

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

get_solid_capstyle(self) [source]

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

См. также set_solid_capstyle.

get_solid_joinstyle(self) [source]

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

См. также set_solid_joinstyle.

get_window_extent(self, renderer) [source]

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

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

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

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

get_xdata(self, orig=True) [source]

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

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

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

get_ydata(self, orig=True) [source]

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

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

is_dashed(self) [source]

Возвращает, является ли линия штриховой.

См. также 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'}

property pickradius

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

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

recache(self, always=False) [source]

recache_always(self) [source]

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

set_antialiased(self, b) [source]

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

Параметры:	`bbool`

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

set_color(self, color) [source]

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

Параметры:	`colorcolor`

set_dash_capstyle(self, s) [source]

Установить стиль обрезки для штриховых линий.

Параметры:	`s{'butt', 'round', 'projecting'}` Примеры см. в Стили соединения и обрезки.

set_dash_joinstyle(self, s) [source]

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

Параметры:	`s{'miter', 'round', 'bevel'}` Примеры см. в Стили соединения и обрезки.

END_OF_DOCUMENT_MARKER

set_dashes(self, seq) [source]

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

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

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

Параметры:	`seqsequence of floats (on/off ink in points) or (None, None)` Если seq пусто или `(None, None)`, стиль линии будет установлен в сплошной.

set_data(self, *args) [source]

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

Параметры:	`*args(2, N) array or two 1D arrays`

set_drawstyle(self, drawstyle) [source]

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

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

Параметры:

Параметры:	`drawstyle{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: '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'

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

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

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

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

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

set_fillstyle(self, 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(self, ls) [source]

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

Параметры:

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

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

Строка:

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

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

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

set_linewidth(self, w) [source]

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

Параметры:	`wfloat` Ширина линии в пунктах.

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

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

set_marker(self, marker) [source]

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

Параметры:	`markermarker style string, Path or MarkerStyle` См. `markers` для полного описания возможных аргументов.

set_markeredgecolor(self, ec) [source]

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

Параметры:	`eccolor`

set_markeredgewidth(self, ew) [source]

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

Параметры:	`ewfloat` Ширина края маркера в пунктах.

set_markerfacecolor(self, fc) [source]

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

Параметры:	`fccolor`

set_markerfacecoloralt(self, fc) [source]

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

Параметры:	`fccolor`

set_markersize(self, sz) [source]

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

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

set_markevery(self, every) [source]

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

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

Параметры:

Параметры:	`everyNone or int or (int, int) or slice or List[int] or float or (float, float) or 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 or int or (int, int) or slice or List[int] or float or (float, float) or 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(self, ec): Псевдоним для set_markeredgecolor.

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

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

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

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

set_picker(self, p) [source]

Определите поведение выбора для объекта.

Параметры:

Параметры:	`pickerNone or bool or callable` Это может быть одно из следующего: None: Выбор отключён для этого объекта (по умолчанию). Булево значение: Если True, то выбор будет включён, и объект будет генерировать событие выбора, если курсор мыши находится над ним. Функция: Если picker — вызываемая функция, это функция, предоставляемая пользователем, которая определяет, является ли объект объектом, на который наведена мышь: hit, props = picker(artist, mouseevent) для определения проверки попадания. Если курсор мыши находится над объектом, верните hit=True и props — словарь свойств, которые вы хотите добавить к атрибутам PickEvent. устарело: Только для `Line2D`, picker также может быть числом с плавающей точкой, которое задаёт погрешность для проверки, произошла ли наводка "на" линию; это устарело. Используйте `Line2D.set_pickradius` вместо этого.

pickerNone or bool or callable

Это может быть одно из следующего:

None: Выбор отключён для этого объекта (по умолчанию).
Булево значение: Если True, то выбор будет включён, и объект будет генерировать событие выбора, если курсор мыши находится над ним.
Функция: Если picker — вызываемая функция, это функция, предоставляемая пользователем, которая определяет, является ли объект объектом, на который наведена мышь:
```
hit, props = picker(artist, mouseevent)
```
для определения проверки попадания. Если курсор мыши находится над объектом, верните hit=True и props — словарь свойств, которые вы хотите добавить к атрибутам PickEvent.
устарело: Только для Line2D, picker также может быть числом с плавающей точкой, которое задаёт погрешность для проверки, произошла ли наводка "на" линию; это устарело. Используйте Line2D.set_pickradius вместо этого.