matplotlib.lines.Line2D

classmatplotlib.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`	bool
`antialiased` или aa	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`color` или c	цвет
`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] или число с плавающей запятой или (число с плавающей запятой, число с плавающей запятой) или список[bool]
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей запятой или вызываемая функция [[Художник, Событие], кортеж[bool, словарь]]
`pickradius`	число с плавающей запятой
`rasterized`	bool
`sketch_params`	(масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой)
`snap`	bool или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	неизвестно
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей запятой

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

contains(mouseevent)[source]

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

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

Параметры

mouseeventmatplotlib.backend_bases.MouseEvent

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

containsbool

Являются ли какие-либо значения в радиусе.

detailsdict

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

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

draw(renderer)[source]

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

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

Параметры

rendererRendererBase подкласс.

Примечания

Этот метод переопределяется в подклассах 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()[source]: Псевдоним для get_antialiased.

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

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

get_color()[source]

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

См. также set_color.

get_linewidth()[source]

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

См. также set_linewidth.

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

get_lw()[source]: Псевдоним для 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()[source]: Псевдоним для get_markeredgecolor.

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

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

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

get_ms()[source]: Псевдоним для 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(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, dash_capstyle=<UNSET>, dash_joinstyle=<UNSET>, dashes=<UNSET>, data=<UNSET>, drawstyle=<UNSET>, fillstyle=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, marker=<UNSET>, markeredgecolor=<UNSET>, markeredgewidth=<UNSET>, markerfacecolor=<UNSET>, markerfacecoloralt=<UNSET>, markersize=<UNSET>, markevery=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, solid_capstyle=<UNSET>, solid_joinstyle=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, xdata=<UNSET>, ydata=<UNSET>, zorder=<UNSET>)[source]

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

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, принимающая массив float (m, n, 3) и значение dpi, и возвращающая массив (m, n, 3)
`alpha`	скаляр или None
`animated`	bool
`antialiased`	bool
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color`	цвет
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (чернила включено/выключено в точках) или (None, None)
`data`	массив (2, N) или два одномерных массива
`drawstyle`	{'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`	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
`linewidth`	float
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor`	цвет
`markeredgewidth`	float
`markerfacecolor`	цвет
`markerfacecoloralt`	цвет
`markersize`	float
`markevery`	None или int или (int, int) или срез или список[int] или float или (float, float) или список[bool]
`path_effects`	`AbstractPathEffect`
`picker`	float или вызываемая функция[[Artist, Event], кортеж[bool, dict]]
`pickradius`	float
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	неизвестно
`url`	str
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	float

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

set_antialiased(b)[source]

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

Параметры

bbool

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

set_color(color)[source]

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

Параметры

colorцвет

set_dash_capstyle(s)[source]

Как рисовать колпачки концов, если линия is_dashed.

Параметры

sCapStyle или {'butt', 'projecting', 'round'}

set_dash_joinstyle(s)[source]

Как соединять сегменты линии, если она is_dashed.

Параметры

sJoinStyle или {'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) массив или два 1D массива

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' и сохраняется для обратной совместимости.

Примеры см. в Step Demo.

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

set_fillstyle(fs)[source]

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

Параметры

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'`, `'None'`, `' '`, или `''`	ничего не рисовать

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

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

set_linewidth(w)[source]

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

Параметры

wfloat: Ширина линии в пунктах.

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

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

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

Примечания

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

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

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