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`	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`	стиль маркера
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	число с плавающей точкой
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	число с плавающей точкой
`markevery`	None или целое число или (целое число, целое число) или срез или список [целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой)
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей точкой или вызываемый объект [[Artist, Event], Tuple[bool, dict]]
`pickradius`	число с плавающей точкой
`rasterized`	bool или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`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() для описания стилей отрисовки.

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

contains(self, mouseevent) [source]

Проверить, произошла ли событие мыши на линии. Радиус выбора определяет точность проверки расположения (обычно в пределах пяти точек от значения). Используйте 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'}

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'}` Примеры см. в Стили соединения и окончания.

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), ...}

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

Строка:

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

В качестве альтернативы можно указать кортеж делений, например:
```
(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` См. `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)` Какие маркеры отображать. 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.

everyNone or int or (int, int) or slice or List[int] or float or (float, 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 покажет маркеры только в фактических точках данных. При использовании числовых аргументов с плавающей точкой для задания свойства 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]

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

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

set_pickradius(self, d) [source]

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

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