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Линия — линия может иметь как сплошную линию, соединяющую все вершины, так и маркер в каждой вершине. Кроме того, рисование сплошной линии зависит от drawstyle, например, можно создать "ступенчатые" линии в различных стилях.
Создайте экземпляр
Line2Dс данными x и y в последовательностях xdata, ydata.Дополнительные ключевые аргументы являются свойствами
Line2D:
Свойство
Описание
функция-фильтр, которая принимает массив float (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
скаляр или None
bool
antialiasedили aabool
BboxBaseили Nonebool
Объект Patch или (Path, Transform) или None
colorили cCapStyleили {'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или mecmarkeredgewidthили mewчисло с плавающей точкой
markerfacecolorили mfcmarkerfacecoloraltили mfcaltmarkersizeили msчисло с плавающей точкой
None или целое число или пара целых чисел или срез или список целых чисел или число с плавающей точкой или пара чисел с плавающей точкой или список булевых значений
bool
список
AbstractPathEffectчисло с плавающей точкой или вызываемый объект [[Artist, Event], tuple[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для получения или задания радиуса выделения.- Parameters:
-
-
mouseevent
MouseEvent
-
mouseevent
- Returns:
-
- containsbool
-
Включает ли какое-либо значение радиус.
- detailsdict
-
Словарь
{'ind': pointlist}, где pointlist — список точек линии, которые находятся в пределах pickradius от позиции события.TODO: отсортировать возвращённые индексы по расстоянию
- draw(renderer)[source]
-
Отобразить объект-артист (и его дочерние элементы) с помощью заданного рендерера.
Это не оказывает никакого влияния, если художник не видим (
Artist.get_visibleвозвращает False).- Parameters:
-
-
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_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 как массив (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]
-
Установить несколько свойств сразу.
Поддерживаемые свойства:
Свойство
Описание
функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от левого нижнего угла изображения
скаляр или None
логическое значение
логическое значение
BboxBaseили Noneлогическое значение
объект 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
строка
логическое значение
объект
{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
число с плавающей точкой
строка стиля маркера,
PathилиMarkerStyleчисло с плавающей точкой
число с плавающей точкой
None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список логических значений
логическое значение
список
AbstractPathEffectчисло с плавающей точкой или вызываемый объект [[Artist, Event], кортеж[логическое значение, словарь]]
число с плавающей точкой
логическое значение
(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
логическое значение или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}неизвестно
строка
логическое значение
- 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последовательность чисел с плавающей точкой (чернила на/без чернил в пунктах) или (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': Не закрашивать.
Примеры см. в Стилях заливки маркеров.
- 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 or int or (int, int) or slice or list[int] or float or (float, float) or 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, (т.е. число с плавающей точкой): маркеры будут распределены с приблизительно равными визуальными расстояниями по линии; расстояние по линии между маркерами определяется путем умножения расстояния в координатах отображения диагонали области Axes на значение every. -
every=(0.5, 0.1)(т.е. кортеж длиной 2 из чисел с плавающей точкой): аналогичноevery=0.1, но первый маркер будет смещен по линии на 0,5, умноженное на расстояние по диагонали области Axes в координатах отображения.
Примеры см. в Демонстрация Markevery.
-
Примечания
Установка markevery по-прежнему будет рисовать маркеры только в фактических точках данных. Хотя форма с плавающей точкой направлена на равномерное визуальное распределение, ей необходимо привести идеальное распределение к ближайшей доступной точке данных. В зависимости от количества и распределения точек данных результат может все еще не выглядеть равномерно распределённым.
При использовании смещения start для указания первого маркера, смещение будет отсчитываться от первой точки данных, которая может отличаться от первой видимой точки данных, если график увеличен.
При увеличении графика при использовании аргументов с плавающей точкой фактические точки данных, имеющие маркеры, изменятся, поскольку расстояние между маркерами всегда определяется по диагонали области Axes в координатах отображения независимо от фактических пределов данных осей.
- 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: использование преобразований и пользовательских проекций
Пользовательский форматер делений для временных рядов
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.lines.Line2D.html