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
matplotlib.backend_bases.MouseEvent
-
mouseevent
- Возвращаемые значения:
-
- containsbool
-
Являются ли какие-либо значения внутри радиуса.
- detailsdict
-
Словарь
{'ind': pointlist}, где pointlist — список точек линии, которые находятся внутри радиуса выбора вокруг позиции события.TODO: отсортировать возвращаемые индексы по расстоянию
- draw(renderer)[source]
-
Отрисовка объекта Artist (и его дочерних элементов) с помощью данного рендерера.
Это не имеет эффекта, если объект-артист не виден (
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 в виде массива NumPy Nx2.
- 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={'.': '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'}
- propertypickradius
-
Возвращает радиус выбора, используемый для тестов принадлежности.
См.
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последовательность чисел с плавающей точкой (чернила/пробелы в точках) или (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' и поддерживается для обратной совместимости.
Примеры см. в Демонстрация шага.
- 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 или 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, (т.е. число с плавающей точкой): маркеры будут размещены с приблизительно равными визуальными расстояниями вдоль линии; расстояние вдоль линии между маркерами определяется умножением расстояния в координатах отображения диагонали области отображения осей на значение every. -
every=(0.5, 0.1)(т.е. кортеж длиной 2 из чисел с плавающей точкой): аналогично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'>).- Параметры:
-
-
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/3.6.0/api/_as_gen/matplotlib.lines.Line2D.html