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:
Свойство
Описание
функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения
скаляр или None
bool
antialiasedили aabool
bool
Объект Patch или (Path, Transform) или None
colorили cцвет
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}последовательность чисел с плавающей точкой (чернила включены/выключены в точках) или (None, None)
(2, N) массив или два одномерных массива
drawstyleили ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
цвет или None
строка
bool
объект
linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidthили lwчисло с плавающей точкой
строка стиля маркера,
PathилиMarkerStylemarkeredgecolorили mecцвет
markeredgewidthили mewчисло с плавающей точкой
markerfacecolorили mfcцвет
markerfacecoloraltили mfcaltцвет
markersizeили msчисло с плавающей точкой
None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
bool
число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж[bool, dict]]
неизвестно
bool
(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
bool или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}неизвестно
строка
bool
одномерный массив
одномерный массив
число с плавающей точкой
См.
set_linestyle()для описания стилей линий,set_marker()для описания маркеров иset_drawstyle()для описания стилей рисования.- contains(mouseevent)[source]
-
Проверка, произошла ли mouseevent на линии.
Событие считается произошедшим "на" линии, если оно находится на расстоянии менее
self.pickradius(по умолчанию: 5 точек) от неё. Используйтеget_pickradiusилиset_pickradiusдля получения или установки радиуса выделения.- Параметры:
-
-
mouseevent
MouseEvent
-
mouseevent
- Возвращаемые значения:
-
- containsbool
-
Является ли любое значение в радиусе.
- detailsdict
-
Словарь
{'ind': pointlist}, где pointlist — список точек линии, находящихся в пределах радиуса выделения от позиции события.TODO: отсортировать возвращённые индексы по расстоянию
- draw(renderer)[source]
-
Отображение элемента (и его дочерних элементов) с помощью заданного рендерера.
Это не имеет эффекта, если элемент не виден (
Artist.get_visibleвозвращает False).- Параметры:
-
-
renderer
RendererBaseподкласс.
-
renderer
Примечания
Этот метод переопределён в подклассах 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.
- 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 в виде Nx2 массива NumPy.
- 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]
-
Установить несколько свойств сразу.
Поддерживаемые свойства:
Свойство
Описание
Функция фильтра, которая принимает массив (m, n, 3) с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
скаляр или None
bool
bool
bool
Объект Patch или (Path, Transform) или None
цвет
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}последовательность чисел с плавающей точкой (чернила вкл/выкл в пунктах) или (None, None)
массив (2, N) или два одномерных массива
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
цвет или None
строка
bool
объект
{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
число с плавающей точкой
строка стиля маркера,
PathилиMarkerStyleцвет
число с плавающей точкой
цвет
цвет
число с плавающей точкой
None или int или (int, int) или срез или список[int] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список[bool]
bool
число с плавающей точкой или вызываемая функция [[Artist, Event], tuple[bool, dict]]
неизвестно
bool
(масштаб: float, длина: float, случайность: float)
bool или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}неизвестно
строка
bool
одномерный массив
одномерный массив
число с плавающей точкой
-
- 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'>).- Параметры:
-
-
s
CapStyleили {'butt', 'projecting', 'round'}
-
s
- set_dash_joinstyle(s)[source]
-
Как соединять сегменты линии, если она
is_dashed.По умолчанию стиль соединения —
rcParams["lines.dash_joinstyle"](по умолчанию:<JoinStyle.round: 'round'>).- Параметры:
-
-
s
JoinStyleили {'miter', 'round', 'bevel'}
-
s
- set_dashes(seq)[source]
-
Установить последовательность штрихов.
Последовательность штрихов — это последовательность чисел с плавающей запятой чётной длины, описывающая длину штрихов и пробелов в пунктах.
Например, (5, 2, 1, 2) описывает последовательность штрихов длиной 5 пунктов и 1 пункт, разделенных пробелами длиной 2 пункта.
См. также
set_gapcolor, которая позволяет заполнять эти пробелы цветом.- Параметры:
-
- seqпоследовательность чисел с плавающей запятой (чернила on/off в пунктах) или (None, None)
-
Если seq пуста или
(None, None), стиль линии будет сплошным.
- set_data(*args)[source]
-
Установить данные x и y.
- Параметры:
-
- *args(2, N) массив или два одномерных массива
- 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.
-
markerстрока стиля маркера,
- 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 по-прежнему будет рисовать маркеры только в фактических точках данных. В то время как форма аргумента с плавающей точкой нацелена на равномерное визуальное распределение, ей необходимо привести распределение к ближайшей доступной точке данных. В зависимости от количества и распределения точек данных, результат всё ещё может не выглядеть равномерно распределённым.
При использовании смещения start для указания первого маркера, смещение будет от первой точки данных, которая может отличаться от первой видимой точки данных, если график увеличен.
Если увеличивать график при использовании аргументов с плавающей точкой, фактические точки данных, которые имеют маркеры, изменятся, поскольку расстояние между маркерами всегда определяется из диагонали области осей в координатах отображения независимо от фактических пределов данных осей.
- 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'>).- Параметры:
-
-
s
CapStyleили {'butt', 'projecting', 'round'}
-
s
- set_solid_joinstyle(s)[source]
-
Как соединять отрезки, если линия сплошная (не
is_dashed).Стиль соединения по умолчанию -
rcParams["lines.solid_joinstyle"](по умолчанию:<JoinStyle.round: 'round'>).- Параметры:
-
-
s
JoinStyleили {'miter', 'round', 'bevel'}
-
s
- set_transform(t)[source]
-
Установить преобразование художника.
- Параметры:
-
-
t
Transform
-
t
- set_xdata(x)[source]
-
Установить массив данных для x.
- Параметры:
-
- xОдномерный массив
- set_ydata(y)[source]
-
Установить массив данных для y.
- Параметры:
-
- yОдномерный массив
- update_from(other)[source]
-
Копировать свойства из other в self.
- zorder=2
Примеры использования matplotlib.lines.Line2D
Диаграмма SkewT-logP: использование преобразований и пользовательских проекций
Пользовательский форматер меток для временных рядов
Более быстрое отображение с использованием blitting
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/_as_gen/matplotlib.lines.Line2D.html