Dash.jl

Dash For Julia

Crear hermosas aplicaciones analíticas en Julia

Construido en la parte superior de Plotly.js, React y Http.jl, ata los elementos de interfaz de usuario modernos como menores, controles deslizantes y gráficos directamente a su código analítico de Julia.

¿Acabo de empezar? ¡Mira la Guía del usuario de Julia para Julia! Si no puede encontrar documentación allí, consulte los ejemplos no oficiales contribuyados o consulte el código fuente de las aplicaciones de demostración en Python y luego haga referencia al estilo de sintaxis de Julia.

Otros recursos

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

Estado del proyecto

Los componentes de Julia se pueden generar en conjunto con los componentes Python y R. ¿Interesado en involucrarse con el proyecto? El patrocinio es una excelente manera de acelerar el progreso de proyectos de código abierto como este; ¡No dude en comunicarse con nosotros!

Instalación

Para instalar la versión lanzada más recientemente:

pkg > add Dash

Para instalar la última versión de desarrollo (estable) en su lugar:

pkg > add Dash # dev 

Uso

Aplicación 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)

¡Luego vaya a http://127.0.0.1:8050 en su navegador para ver la aplicación Dash!

Devolución de llamada 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)

• ¡Puede hacer que su aplicación Dash sea interactiva registrando devoluciones de llamada con la callback! función.
• Las salidas y las entradas (y los estados, ver más abajo) de la devolución de llamada pueden ser Output , Input , objetos State o salpicaduras / vectores de estos objetos.
• Las funciones de devolución de llamada deben tener la firma (inputs..., states...) , y proporcionar un valor de retorno con los mismos elementos de número que el número de Output para actualizar.

Estados y múltiples salidas

 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)

Comparación con la sintaxis original de Python

Nombramiento de componentes

• Pitón:

 import dash

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

• Dash.jl:

 using Dash

html_div
dcc_graph
dash_datatable

Creación de componentes

Al igual que en Python, las funciones para declarar componentes tienen argumentos de palabras clave, que son los mismos que en Python. html_div(id = "my-id", children = "Simple text") .

Para los componentes que declaran children , hay dos firmas adicionales disponibles:

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

Entonces se puede escribir html_div("Simple text", id = "my-id") para elementos simples, o elegir una sintaxis abreviada con sintaxis do para elementos complejos:

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

Aplicación y diseño

• Pitón:

 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

Devoluciones de llamada

• Pitón:

 @ 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

Las aplicaciones de DASH transfieren datos entre el navegador (también conocido como el frontend) y el proceso Julia que ejecuta la aplicación (también conocido como el backend) en JSON. Dash.jl usa json3.jl para la serialización/deserialización de JSON.

Tenga en cuenta que JSON3.JL se convierte

• Vector S y Tuple S a JSON Matrices
• Dict s y NamedTuple s a los objetos json