Документация Engee

lines

Страница в процессе перевода.

lines(positions)
lines(x, y)
lines(x, y, z)

Создает связный линейный график для каждого элемента в (x, y, z), (x, y) или positions.

Значения NaN отображаются как разрывы в линии.

Тип графика

Псевдоним типа графика для функции lines — Lines.

Работа с артефактами контуров в GLMakie

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

  • fxaa = true отключит собственное сглаживание сегментов линий и будет использовать вместо него fxaa. В результате получаются менее детализированные линии.

  • transparency = true в некоторой степени отключит тестирование глубины, в результате чего все линии будут отображаться без артефактов. Однако при этом линии всегда будут иметь определенный уровень прозрачности.

  • overdraw = true полностью отключит тестирование глубины (чтение и запись) для графика и удалит артефакты. Однако при этом изменится z-порядок сегментов линий, и отрисованные позже графики будут отображаться поверх линейного графика.

using GLMakie
ps = rand(Point3f, 500)
cs = rand(500)
f = Figure(size = (600, 650))
Label(f[1, 1], "base", tellwidth = false)
lines(f[2, 1], ps, color = cs, fxaa = false)
Label(f[1, 2], "fxaa = true", tellwidth = false)
lines(f[2, 2], ps, color = cs, fxaa = true)
Label(f[3, 1], "transparency = true", tellwidth = false)
lines(f[4, 1], ps, color = cs, transparency = true)
Label(f[3, 2], "overdraw = true", tellwidth = false)
lines(f[4, 2], ps, color = cs, overdraw = true)
f
f0afb2b

Атрибуты

alpha

Значение по умолчанию: 1.0
альфа-значение цветовой карты или атрибута цвета. Несколько альфа-значений, как в plot(alpha=0.2, color=(:red, 0.5), перемножаются.

clip_planes

Значение по умолчанию: automatic
плоскости отсечения позволяют выполнять отсечение в трехмерном пространстве. Здесь можно указать вектор из 8 плоскостей Plane3f, за которыми графики будут отсечены (т. е. станут невидимыми). По умолчанию плоскости отсечения наследуются от родительского графика или сцены. Чтобы удалить родительский объект clip_planes, передайте Plane3f[].

color

Значение по умолчанию: @inherit linecolor
цвет линии.

colormap

Значение по умолчанию: @inherit colormap :viridis
задает цветовую карту, из которой производится выборка для числовых значений color. Также можно использовать PlotUtils.cgrad(...), Makie.Reverse(any_colormap) или любой символ из ColorBrewer или PlotUtils. Чтобы увидеть все доступные цветовые градиенты, можно вызвать Makie.available_gradients().

colorrange

Значение по умолчанию: automatic
значения, представляющие начальную и конечную точки colormap.

colorscale

Значение по умолчанию: identity
функция преобразования цвета. Может быть любой функцией, но с Colorbar хорошо работают только identity, log, log2, log10, sqrt, logit, Makie.pseudolog10 и Makie.Symlog10.

cycle

Значение по умолчанию: [:color]
определяет то, какие атрибуты следует использовать циклически при создании нескольких графиков.

depth_shift

Значение по умолчанию: 0.0
корректирует значение глубины графика после всех остальных преобразований, т. е. в пространстве отсечения, где 0 <= depth <= 1. Применимо только к GLMakie и WGLMakie и может использоваться для настройки порядка отрисовки (настраиваемая перерисовка).

fxaa

Значение по умолчанию: false
определяет то, будет ли график отрисовываться с помощью fxaa (сглаживание, только GLMakie).

highclip

Значение по умолчанию: automatic
цвет для любого значения выше цветового диапазона.

inspectable

Значение по умолчанию: true
определяет, должен ли график проверяться с помощью DataInspector.

inspector_clear

Значение по умолчанию: automatic
задает функцию обратного вызова (inspector, plot) -> ... для очистки пользовательских индикаторов в DataInspector.

inspector_hover

Значение по умолчанию: automatic
задает функцию обратного вызова (inspector, plot, index) -> ..., которая заменяет методы show_data по умолчанию.

inspector_label

Значение по умолчанию: automatic
задает функцию обратного вызова (plot, index, position) -> string, которая заменяет метку по умолчанию, сгенерированную DataInspector.

joinstyle

Значение по умолчанию: @inherit joinstyle
управляет отрисовкой в углах. Возможные значения: :miter для острых углов, :bevel для «обрезанных» углов и :round для закругленных углов. Если угол меньше miter_limit, значение :miter будет эквивалентно :bevel, что позволяет избежать длинных заострений.

linecap

Значение по умолчанию: @inherit linecap
задает используемый тип конца линии. Возможные значения: :butt (плоский без выступа), :square (плоский с выступом в половину толщины линии) или :round.

linestyle

Значение по умолчанию: nothing
задает стиль штриховой линии. Возможные значения: :solid (эквивалентно nothing), :dot, :dash, :dashdot и :dashdotdot. Можно также задать в виде кортежа с модификатором стиля пробела: :normal, :dense или :loose. Например, (:dot, :loose) или (:dashdot, :dense).

Если нужен пользовательский стиль, см. описание Makie.Linestyle.

linewidth

Значение по умолчанию: @inherit linewidth
задает толщину линии в единицах экрана.

lowclip

Значение по умолчанию: automatic
цвет для любого значения ниже цветового диапазона.

miter_limit

Значение по умолчанию: @inherit miter_limit
задает минимальный внутренний угол стыка, меньше которого угловые стыки обрезаются. См. также описание Makie.miter_distance_to_angle.

model

Значение по умолчанию: automatic
задает модельную матрицу для графика. Переопределяет настройки, выполненные с помощью translate!, rotate! и scale!.

nan_color

Значение по умолчанию: :transparent
цвет для значений NaN.

overdraw

Значение по умолчанию: false
определяет то, будет ли график отрисовываться поверх других графиков. В частности, это означает игнорирование проверок глубины в бэкендах GL.

space

Значение по умолчанию: :data
задает пространство преобразования для прямоугольника, охватывающего график. Возможные входные данные см. в описании Makie.spaces().

ssao

Значение по умолчанию: false
определяет то, будет ли график отрисовываться с использованием ssao (преграждение окружающего света в экранном пространстве). Обратите внимание, что это имеет смысл только для трехмерных графиков и применимо только с fxaa = true.

transformation

Значение по умолчанию: automatic
документация недоступна.

transparency

Значение по умолчанию: false
определяет то, как реализуется прозрачность графика. В GLMakie transparency = true приводит к использованию прозрачности, независимой от порядка.

visible

Значение по умолчанию: true
определяет то, будет ли отрисовываться график.