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

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

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

Параметры kwargs соответствуют свойствам Line2D:

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

axes

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

contains(mouseevent) [source]

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

Возвращает True, если какие-либо значения находятся в радиусе вместе с {'ind': pointlist}, где pointlist — набор точек в радиусе.

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

draw(renderer) [source]

Отрисовка линии с renderer , если видимость не False

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(*args, **kwargs)

псевдоним для get_antialiased

get_antialiased() [source]

get_c(*args, **kwargs)

псевдоним для get_color

get_color() [source]

get_dash_capstyle() [source]

Получение стиля окончания для штриховых линий

get_dash_joinstyle() [source]

Получение стиля соединения для штриховых линий

get_data(orig=True) [source]

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

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

get_drawstyle() [source]

get_fillstyle() [source]

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

get_linestyle() [source]

get_linewidth() [source]

get_ls(*args, **kwargs)

псевдоним для get_linestyle

get_lw(*args, **kwargs)

псевдоним для get_linewidth

get_marker() [source]

get_markeredgecolor() [source]

get_markeredgewidth() [source]

get_markerfacecolor() [source]

get_markerfacecoloralt() [source]

get_markersize() [source]

get_markevery() [source]

Возвращает значение markevery

get_mec(*args, **kwargs)

псевдоним для get_markeredgecolor

get_mew(*args, **kwargs)

псевдоним для get_markeredgewidth

get_mfc(*args, **kwargs)

псевдоним для get_markerfacecolor

get_mfcalt(*args, **kwargs)

псевдоним для get_markerfacecoloralt

get_ms(*args, **kwargs)

псевдоним для get_markersize

get_path() [source]

Возвращает объект Path, связанный с этой линией.

get_pickradius() [source]

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

get_solid_capstyle() [source]

Получение стиля окончания для сплошных линий

get_solid_joinstyle() [source]

Получение стиля соединения для сплошных линий

get_window_extent(renderer) [source]

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

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

get_xdata(orig=True) [source]

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

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

get_xydata() [source]

Возвращает данные xy в виде массива NumPy Nx2.

get_ydata(orig=True) [source]

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

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

is_dashed() [source]

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

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(always=False) [source]

recache_always() [source]

set_aa(*args, **kwargs)

Псевдоним для set_antialiased

set_antialiased(b) [source]

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

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

set_c(*args, **kwargs)

Псевдоним для set_color

set_color(color) [source]

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

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

set_dash_capstyle(s) [source]

Установить стиль окончания пунктирной линии.

Параметры:	s : {'butt', 'round', 'projecting'}

set_dash_joinstyle(s) [source]

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

Параметры:	s : {'miter', 'round', 'bevel'}

set_dashes(seq) [source]

Установить последовательность пунктира, последовательность тире и пробелов в пунктах. Если seq пуста или seq = (None, None), стиль линии будет сплошным.

Параметры:	seq : sequence of floats (on/off ink in points) or (None, None)

set_data(*args) [source]

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

ПРИНИМАЕТ: 2D массив (строки — x, y) или два 1D массива

set_drawstyle(drawstyle) [source]

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

'default' соединяет точки линиями. Варианты 'steps' производят графики ступенчатой функции. 'steps' эквивалентен 'steps-pre' и поддерживается для обратной совместимости.

Параметры:	drawstyle : {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}

set_fillstyle(fs) [source]

Установить стиль заливки маркера; 'full' означает заполнение всего маркера. 'none' означает отсутствие заливки; другие варианты предназначены для маркеров с половинным заполнением.

Параметры:	fs : {'full', 'left', 'right', 'bottom', 'top', 'none'}

set_linestyle(ls) [source]

Установить стиль линии (также принимает стили отрисовки, например, 'steps--')

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

'steps' эквивалентен 'steps-pre' и поддерживается для обратной совместимости.

В качестве альтернативы можно указать кортеж пунктира следующего вида:

(offset, onoffseq),

где onoffseq — кортеж чётной длины, содержащий длины тире и пробелов в пунктах.

См. также

set_drawstyle()

Для установки стиля отрисовки (ступенчатого) графика.

Параметры:	ls : {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} Стиль линии.

set_linewidth(w) [source]

Установить толщину линии в пунктах

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

set_ls(*args, **kwargs)

Псевдоним для set_linestyle

set_lw(*args, **kwargs)

Псевдоним для set_linewidth

set_marker(marker) [source]

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

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

set_markeredgecolor(ec) [source]

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

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

set_markeredgewidth(ew) [source]

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

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

set_markerfacecolor(fc) [source]

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

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

set_markerfacecoloralt(fc) [source]

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

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

set_markersize(sz) [source]

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

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

set_markevery(every) [source]

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

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

Параметры:

every: None или int или (int, int) или срез или Список[int] или float или (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(*args, **kwargs)

псевдоним для set_markeredgecolor

set_mew(*args, **kwargs)

псевдоним для set_markeredgewidth

set_mfc(*args, **kwargs)

псевдоним для set_markerfacecolor

set_mfcalt(*args, **kwargs)

псевдоним для set_markerfacecoloralt

set_ms(*args, **kwargs)

псевдоним для set_markersize

set_picker(p) [source]

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

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

set_pickradius(d) [source]

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

Параметры:	d : float Радиус выделения в пунктах.

set_solid_capstyle(s) [source]

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

Параметры:	s : {'butt', 'round', 'projecting'}

set_solid_joinstyle(s) [source]

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

Параметры:	s : {'miter', 'round', 'bevel'}

set_transform(t) [source]

устанавливает экземпляр преобразования, используемый этим объектом

Параметры:	t : matplotlib.transforms.Transform

set_xdata(x) [source]

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

Параметры:	x : 1D array

set_ydata(y) [source]

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

Параметры:	y : 1D array

update_from(other) [source]

копирует свойства из other в self

validCap = ('butt', 'round', 'projecting')

validJoin = ('miter', 'round', 'bevel')

zorder = 2

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

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

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

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

Простой пример настройки графиков

Фигура X

Справочник по элементам-объектам matplotlib

Осциллограф

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

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

Тесты элементов-объектов

Учебник по элементам-объектам

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