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]

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

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi и возвращает (m, n, 3) массив
`alpha`	число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный)
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	экземпляр `Bbox`
`clip_on`	булево значение
`clip_path`	[(`Path`, `Transform`) \| `Patch` \| None]
`color` или c	любой цвет matplotlib
`contains`	вызываемая функция
`dash_capstyle`	['butt' \| 'round' \| 'projecting']
`dash_joinstyle`	['miter' \| 'round' \| 'bevel']
`dashes`	последовательность чернил включения/выключения в точках
`drawstyle`	['default' \| 'steps' \| 'steps-pre' \| 'steps-mid' \| 'steps-post']
`figure`	экземпляр `Figure`
`fillstyle`	['full' \| 'left' \| 'right' \| 'bottom' \| 'top' \| 'none']
`gid`	строка идентификатора
`label`	объект
`linestyle` или ls	['solid' \| 'dashed', 'dashdot', 'dotted' \| (смещение, последовательность включения-выключения) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	вещественное значение в точках
`marker`	`A valid marker style`
`markeredgecolor` или mec	любой цвет matplotlib
`markeredgewidth` или mew	вещественное значение в точках
`markerfacecolor` или mfc	любой цвет matplotlib
`markerfacecoloralt` или mfcalt	любой цвет matplotlib
`markersize` или ms	вещественное значение
`markevery`	[None \| int \| пара из двух чисел типа int \| срез \| список/массив целых чисел \| число с плавающей точкой \| пара из двух чисел с плавающей точкой]
`path_effects`	`AbstractPathEffect`
`picker`	расстояние в точках или вызываемая функция выбора `fn(artist, event)`
`pickradius`	расстояние в точках
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`solid_capstyle`	['butt' \| 'round' \| 'projecting']
`solid_joinstyle`	['miter' \| 'round' \| 'bevel']
`transform`	экземпляр `matplotlib.transforms.Transform`
`url`	строка 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() [source]: Псевдоним для get_antialiased

get_antialiased() [source]

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

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

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

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

get_mfcalt(alt=False) [source]: псевдоним для get_markerfacecoloralt

get_ms() [source]: псевдоним для get_markersize

get_path() Path [source]: Возвращает объект Path, связанный с этой линией.

get_pickradius() [source]: возвращает радиус выбора, используемый для проверок соприкасания

get_solid_capstyle() [source]: Получение стиля окончания для сплошных линий

get_solid_joinstyle() [source]: Получение стиля соединения для сплошных линий

get_window_extent(renderer) [source]

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

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

get_xdata(orig=True) [source]

Возвращает данные по оси X.

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

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

get_ydata(orig=True) [source]

Возвращает данные по оси Y.

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

set_antialiased(b) [source]

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

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

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

set_color(color) [source]

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

ПРИНИМАЕТ: любой цвет matplotlib.

set_dash_capstyle(s) [source]

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

ПРИНИМАЕТ: ['butt' | 'round' | 'projecting']

set_dash_joinstyle(s) [source]: Устанавливает стиль соединения прерывистых линий. ПРИНИМАЕТ: ['miter' | 'round' | 'bevel']

set_dashes(seq) [source]

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

ПРИНИМАЕТ: последовательность чернил включения/выключения в точках.

set_data(*args) [source]

Устанавливает данные по осям X и Y.

ПРИНИМАЕТ: двумерный массив (строки — X, Y) или два одномерных массива.

set_drawstyle(drawstyle) [source]

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

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

ПРИНИМАЕТ: ['default' | 'steps' | 'steps-pre' | 'steps-mid' |: 'steps-post']

set_fillstyle(fs) [source]

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

set_linestyle(ls) [source]

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

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

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

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

(offset, onoffseq),

где onoffseq — кортеж чётной длины с включениями и выключениями чернил в точках.

ПРИНИМАЕТ: ['solid' | 'dashed', 'dashdot', 'dotted' |: (смещение, последовательность штрихов) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']

См. также

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

Параметры:	`ls : { '-', '--', '-.', ':'} and more see description` Стиль линии.

set_linewidth(w) [source]

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

ПРИНИМАЕТ: числовое значение в точках.

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

set_lw(val) [source]: Псевдоним для set_linewidth.

set_marker(marker) [source]

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

ПРИНИМАЕТ: A valid marker style

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

set_markeredgecolor(ec) [source]

Устанавливает цвет границы маркера.

ПРИНИМАЕТ: любой цвет matplotlib.

set_markeredgewidth(ew) [source]

Устанавливает ширину границы маркера в точках.

ПРИНИМАЕТ: числовое значение в точках.

set_markerfacecolor(fc) [source]

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

ПРИНИМАЕТ: любой цвет matplotlib.

END_OF_DOCUMENT_MARKER

set_markerfacecoloralt(fc) [source]

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

ПРИНИМАЕТ: любой цвет matplotlib

set_markersize(sz) [source]

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

ПРИНИМАЕТ: float

set_markevery(every) [source]

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

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

Параметры:

Параметры:	every: None \| int \| кортеж длиной 2 из int \| срез \| список/массив из int \| float \| кортеж длиной 2 из 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, каждый элемент будет нарисован.
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 на неравномерно распределенных данных, маркеры, скорее всего, не будут отображаться равномерно, поскольку фактические точки данных не совпадают с теоретическим интервалом между маркерами.

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

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