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]

Основы: matplotlib.artist.Artist

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

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

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

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

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

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

contains(self, mouseevent) [source]

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

Параметры:

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

mouseevent : matplotlib.backend_bases.MouseEvent

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

contains : bool

Наличие ли каких-либо значений в радиусе.

details : dict

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

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

draw(self, renderer) [source]

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

Этот метод будет переопределён в подклассах артиста. Обычно он реализуется таким образом, чтобы не иметь никакого эффекта, если объект-артист не видим (Artist.get_visible равен False).

Параметры:	`renderer : RendererBase 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]

Возвращает данные x.

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

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

get_ydata(self, orig=True) [source]

Возвращает данные y.

Если 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]

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

Параметры:	`b : bool`

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

set_color(self, color) [source]

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

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

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 пункта.

Параметры:	`seq : sequence 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'` или `' '` или `''`	без отрисовки

В строку можно добавить стиль рисования, например, 'steps--'. Подробности см. в set_drawstyle().

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

set_linewidth(self, w) [source]

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

Параметры:	`w : float`

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

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

set_marker(self, marker) [source]

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

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

set_markeredgecolor(self, ec) [source]

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

Параметры:	`ec : color`

set_markeredgewidth(self, ew) [source]

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

Параметры:	`ew : float`

set_markerfacecolor(self, fc) [source]

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

Параметры:	`fc : color`

set_markerfacecoloralt(self, fc) [source]

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

Параметры:	`fc : color`

set_markersize(self, sz) [source]

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

Параметры:	`sz : float`

set_markevery(self, every) [source]

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

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

Параметры:

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

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

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

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

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]

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

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

set_pickradius(self, d) [source]

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

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