Dash.jl

Traço para Julia

Crie lindos aplicações analíticas em Julia

Construído em cima de Plotly.js, React e http.jl, o traço amarra elementos modernos da interface do usuário, como suspensos, controles deslizantes e gráficos diretamente ao seu código Julia analítico.

Apenas começando? Confira o Guia do usuário do Dash for Julia! Se você não conseguir encontrar documentação lá, confira os exemplos não oficiais ou confira o código -fonte dos aplicativos de demonstração no Python e faça referenciar o estilo de sintaxe Julia.

Outros recursos

• https://community.plotly.com/c/plotly--matlab-julia-nalt/julia/23
• https://discourse.julialang.org/tag/dash

Status do projeto

Os componentes de Julia podem ser gerados em conjunto com os componentes Python e R. Interessado em se envolver com o projeto? O patrocínio é uma ótima maneira de acelerar o progresso de projetos de código aberto como este; Por favor, sinta -se à vontade para nos alcançar!

Instalação

Para instalar a versão mais recentemente lançada:

pkg > add Dash

Para instalar a mais recente versão de desenvolvimento (estável):

pkg > add Dash # dev 

Uso

Aplicação básica

 using Dash

app = dash (external_stylesheets = [ " https://codepen.io/chriddyp/pen/bWLwgP.css " ])

app . layout = html_div () do
    html_h1 ( " Hello Dash " ),
    html_div ( " Dash.jl: Julia interface for Dash " ),
    dcc_graph (id = " example-graph " ,
              figure = (
                  data = [
                      (x = [ 1 , 2 , 3 ], y = [ 4 , 1 , 2 ], type = " bar " , name = " SF " ),
                      (x = [ 1 , 2 , 3 ], y = [ 2 , 4 , 5 ], type = " bar " , name = " Montréal " ),
                  ],
                  layout = (title = " Dash Data Visualization " ,)
              ))
end

run_server (app)

Em seguida, vá para http://127.0.0.1:8050 no seu navegador para visualizar o aplicativo DASH!

Retorno de chamada básica

 using Dash

app = dash (external_stylesheets = [ " https://codepen.io/chriddyp/pen/bWLwgP.css " ])

app . layout = html_div () do
    dcc_input (id = " my-id " , value = " initial value " , type = " text " ),
    html_div (id = " my-div " )
end

callback! (app, Output ( " my-div " , " children " ), Input ( " my-id " , " value " )) do input_value
    " You've entered $(input_value) "
end

run_server (app)

• Você pode tornar seu aplicativo Dash Interactive registrando retornos de chamada com o callback! função.
• Saídas e entradas (e estados, veja abaixo) do retorno de chamada pode ser Output , Input , objetos State ou splats / vetores desses objetos.
• As funções de retorno de chamada devem ter a assinatura (inputs..., states...) e fornecer um valor de retorno com os mesmos elementos do número que o número de Output s para atualizar.

Estados e vários resultados

 using Dash

app = dash (external_stylesheets = [ " https://codepen.io/chriddyp/pen/bWLwgP.css " ])

app . layout = html_div () do
    dcc_input (id = " my-id " , value = " initial value " , type = " text " ),
    html_div (id = " my-div " ),
    html_div (id = " my-div2 " )
end

callback! (app,
          Output ( " my-div " , " children " ),
          Output ( " my-div2 " , " children " ),
          Input ( " my-id " , " value " ),
          State ( " my-id " , " type " )) do input_value, state_value
    return ( " You've entered $(input_value) in input with type $(state_value) " ,
            " You've entered $(input_value) " )
end

run_server (app)

Comparação com a sintaxe Python original

Nomeação do componente

• Python:

 import dash

dash . html . Div
dash . dcc . Graph
dash . dash_table . DataTable

• DASH.JL:

 using Dash

html_div
dcc_graph
dash_datatable

Criação de componentes

Assim como em Python, as funções para declarar componentes têm argumentos de palavras -chave, que são as mesmas do Python. html_div(id = "my-id", children = "Simple text") .

Para componentes que declaram children , duas assinaturas adicionais estão disponíveis:

• (children; kwargs..) e
• (children_maker::Function; kwargs...)

Portanto, pode-se escrever html_div("Simple text", id = "my-id") para elementos simples ou escolher uma sintaxe abreviada com a sintaxe do para elementos complexos:

 html_div (id = " outer-div " ) do
    html_h1 ( " Welcome " ),
    html_div (id = " inner-div " ) do
        #= inner content =#
    end
end

Aplicação e layout

• Python:

 app = dash . Dash ( external_stylesheets = [ "https://codepen.io/chriddyp/pen/bWLwgP.css" ])

app . layout = html . Div ( children = [....])

• DASH.JL:

app = dash (external_stylesheets = [ " https://codepen.io/chriddyp/pen/bWLwgP.css " ])

app . layout = html_div () do
    #= inner content =#
end

Retornos de chamada

• Python:

 @ app . callback ( Output ( 'output' , 'children' ),
              Input ( 'submit-button' , 'n_clicks' )],
              State ( 'state-1' , 'value' ),
              State ( 'state-2' , 'value' ))
def update_output ( n_clicks , state1 , state2 ):
    # logic

• DASH.JL:

 callback! (app,
          Output ( " output " , " children " ),
          Input ( " submit-button " , " n_clicks " )],
          State ( " state-1 " , " value " ),
          State ( " state-2 " , " value " )) do n_clicks, state1, state2
    # logic
end

JSON

Os aplicativos DASH transferem dados entre o navegador (também conhecido como o front -end) e o processo Julia executando o aplicativo (também conhecido como back -end) no JSON. Dash.jl usa JSON3.JL para serialização/deserialização JSON.

Observe que JSON3.JL converte

• Vector s e Tuple s para JSON Arrays
• Dict s e NamedTuple para objetos JSON