Основы
Фигуры plotly.js
строятся путем вызова функции:
Plotly.newPlot(divid, data, layout, config, frames)
где
-
divid
— элементdiv
HTML, в котором должен появиться график. -
data
— массив JSON-объектов, описывающих различныеtrace
в визуализации. -
layout
— это JSON-объект, описывающий свойства макета визуализации. -
config
— это JSON-объект, описывающий свойства конфигурации визуализации. Дополнительные сведения см. здесь. -
frames
может содержать объекты data и layout, определяет любые изменения, подлежащие анимации, и объект traces, определяющий, какие линии следует анимировать.
Аргумент divid
автоматически обрабатывается одним из поддерживаемых фронтендов, поэтому пользователи данного пакета в основном будут заниматься построением аргументов data
, layout
, а также (необязательно) config
и frames
.
Полный список линий и их атрибутов приведен в [справочнике по атрибутам диаграмм plotly.js][_plotlyref].
Типы Julia
Существует несколько основных типов Julia для представления визуализации.
Они приведены ниже.
abstract type AbstractTrace end
abstract type AbstractLayout end
mutable struct GenericTrace{T <: AbstractDict{Symbol,Any}} <: AbstractTrace
fields::T
end
mutable struct Layout{T <: AbstractDict{Symbol,Any}} <: AbstractLayout
fields::T
subplots::_Maybe{Subplots}
end
mutable struct PlotlyFrame{T <: AbstractDict{Symbol,Any}} <: AbstractPlotlyAttribute
fields::T
end
mutable struct Plot{TT<:AbstractVector{<:AbstractTrace},TL<:AbstractLayout,TF<:AbstractVector{<:PlotlyFrame}}
data::TT
layout::TL
divid::UUID
config::PlotConfig
frames::TF
end
Поля data
, layout
, divid
, config
и frames
типа Plot
полностью соответствуют аргументам функции Plotly.newplot
.