matplotlib.lines.Line2D

classmatplotlib.lines.Line2D(xdata, ydata, *, linewidth=None, linestyle=None, color=None, gapcolor=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: Artist

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

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`animated`	bool
`antialiased` или aa	bool
`clip_box`	`BboxBase` или None
`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'}
`gapcolor`	цвет или 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 или целое число или (целое число, целое число) или срез или список [целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список [bool]
`mouseover`	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`	неизвестно
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

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

contains(mouseevent)[source]

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

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

Parameters:

mouseeventMouseEvent

Returns:

containsbool

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

detailsdict

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

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

draw(renderer)[source]

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

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

Parameters:

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_bbox()[source]: Получение рамки области отображения этой линии.

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

get_fillstyle()[source]

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

См. также set_fillstyle.

END_OF_DOCUMENT_MARKER ```

get_gapcolor()[source]

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

См. также set_gapcolor.

get_linestyle()[source]

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

См. также set_linestyle.

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

Получить область отображения объекта.

Ширина и высота области отображения неотрицательны.

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

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

get_xdata(orig=True)[source]

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

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

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

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={' ': 'nothing', '': 'nothing', '*': 'star', '+': 'plus', ',': 'pixel', '.': 'point', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon', '<': 'triangle_left', '>': 'triangle_right', 'D': 'diamond', 'H': 'hexagon2', 'None': 'nothing', 'P': 'plus_filled', 'X': 'x_filled', '^': 'triangle_up', '_': 'hline', 'd': 'thin_diamond', 'h': 'hexagon1', 'none': 'nothing', 'o': 'circle', 'p': 'pentagon', 's': 'square', 'v': 'triangle_down', 'x': 'x', '|': 'vline', 0: 'tickleft', 1: 'tickright', 10: 'caretupbase', 11: 'caretdownbase', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase'}

свойство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>, gapcolor=<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>, mouseover=<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`	функция фильтра, принимающая массив чисел с плавающей запятой (m, n, 3) и значение dpi, и возвращающая массив чисел с плавающей запятой (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	скаляр или None
`animated`	bool
`antialiased`	bool
`clip_box`	`BboxBase` или None
`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'}
`gapcolor`	цвет или None
`gid`	строка
`in_layout`	bool
`label`	объект
`linestyle`	{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
`linewidth`	число с плавающей запятой
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor`	цвет
`markeredgewidth`	число с плавающей запятой
`markerfacecolor`	цвет
`markerfacecoloralt`	цвет
`markersize`	число с плавающей запятой
`markevery`	None или целое число или пара целых чисел или срез или список целых чисел или число с плавающей запятой или пара чисел с плавающей запятой или список булевых значений
`mouseover`	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`	неизвестно
`url`	строка
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей запятой

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.

Стиль заглушки по умолчанию — rcParams["lines.dash_capstyle"] (значение по умолчанию: <CapStyle.butt: 'butt'>).

Параметры:

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

set_dash_joinstyle(s)[source]

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

Стиль соединения по умолчанию — rcParams["lines.dash_joinstyle"] (значение по умолчанию: <JoinStyle.round: 'round'>).

Параметры:

sJoinStyle или {'miter', 'round', 'bevel'}

set_dashes(seq)[source]

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

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

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

См. также set_gapcolor, который позволяет заполнить эти пробелы цветом.

Параметры:

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': Без заливки.

Примеры см. в Marker fill styles.

set_gapcolor(gapcolor)[source]

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

Примечание

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

Эта функция экспериментальная и может измениться.

Параметры:

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

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

Примечания

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

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

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

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

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

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

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

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

set_picker(p)[source]

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

Параметры:

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

set_pickradius(pickradius)[source]

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

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

Параметры:

pickradiusfloat: Радиус выбора в точках.

set_solid_capstyle(s)[source]

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

Стиль заглушки по умолчанию — rcParams["lines.solid_capstyle"] (по умолчанию: <CapStyle.projecting: 'projecting'>).

Параметры:

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

set_solid_joinstyle(s)[source]

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

Стиль соединения по умолчанию — rcParams["lines.solid_joinstyle"] (по умолчанию: <JoinStyle.round: 'round'>).

Параметры:

sJoinStyle или {'miter', 'round', 'bevel'}

set_transform(t)[source]

Установите преобразование объекта.

Параметры:

tTransform

set_xdata(x)[source]

Установить массив данных для x.

Параметры:

xОдномерный массив

set_ydata(y)[source]

Установить массив данных для y.

Параметры:

yОдномерный массив

update_from(other)[source]: Скопировать свойства из other в self.

zorder=2

Примеры использования `matplotlib.lines.Line2D`

Настройка стилей штриховой линии

Диаграмма столбиков с линиями

Метки графиков: suptitle, supxlabel, supylabel

Диаграммы размаха

Метка угла, инвариантная к масштабу

Добавление аннотаций к графику

Добавление аннотаций к графикам

Аннотация для полярного графика

Создание пользовательских легенд

Справочник по стилям стрелок аннотаций

Демонстрация легенды для всей фигуры

Демонстрация легенды

Элемент-контейнер внутри элемента

Справочник по элементам Matplotlib

Объект PathPatch

Простой паразитный график

Демонстрация паразитных осей

Демонстрация паразитной оси

Цены акций за 32 года

Затухание

Задача о двойном маятнике

Анимация на нескольких осях

Анимированная линия графика

Демонстрация события выбора

Демонстрация события выбора 2

Редактор многоугольников

Ресемплирование данных

Привязанные объекты

Добавление линий в фигуры

Демонстрация эффекта траектории

Установление и получение свойств

SVG фильтр линии

Диаграмма SkewT-logP: использование преобразований и пользовательских проекций

Несколько осей y с отметками

Пользовательский форматчик меток для временных рядов

Настройка фигуры и осей

Тесты объектов

Комментируемый указатель

Кнопки

Флажки

Радиокнопки

Пороговое значение изображения с помощью RangeSlider

Ползунок

Фиксация значений ползунков на дискретных значениях

Учебник по объектам Artist

Быстрый старт

Анимации с использованием Matplotlib

Ускоренное отображение с помощью blitting

Учебник по преобразованиям

Руководство по легендам

Аннотации

matplotlib.lines.Line2D

Примечания

Примечания

Примеры использования matplotlib.lines.Line2D

Примеры использования `matplotlib.lines.Line2D`