Per tant, no és d'estranyar que hagis de convertir una figura de Plotly específica en una cadena HTML.
En aquest tutorial, aprendrem a utilitzar el mòdul Plotly io per convertir una figura en una representació de cadena HTML.
Submergem-nos.
Funció Plotly.io.to_html().
La funció to_html() del mòdul io de Plotly us permet passar una figura específica com a paràmetre i convertir-la en una cadena HTML.
La sintaxi de la funció s'expressa com es mostra a continuació:
trama. això . a_html ( fig , config = Cap , reproducció automàtica = És cert , include_plotlyjs = És cert , include_mathjax = Fals , post_script = Cap , full_html = És cert , animació_opcions = Cap , amplada_predeterminada = '100%' , alçada_predeterminada = '100%' , validar = És cert , div_id = Cap )
Explorem els paràmetres de la funció, a continuació:
- Fig: fa referència a l'objecte de la figura o a la representació de la figura en el diccionari.
- Config: especifica les opcions de configuració de plotly.js. Passeu les opcions de configuració com a diccionari.
- Auto_play: determina si la seqüència d'animació s'ha de reproduir automàticament a la càrrega de la pàgina. Aquest paràmetre és útil si teniu una figura que conté fotogrames animats.
- Include_plotlyjs: aquest paràmetre especifica com s'inclou la biblioteca plotly.js a l'HTML. Els valors acceptats en aquest paràmetre inclouen:
- True: inclou la biblioteca plotly.js com a etiqueta d'script al document HTML. Això augmentarà la mida del fitxer, però permetrà que el fitxer s'utilitzi en entorns fora de línia.
- 'cdn': establir el paràmetre include_plotlyjs a 'cdn' afegirà una etiqueta d'script que apuntarà a un enllaç remot per a la biblioteca plotly.js. Utilitzeu aquesta opció quan us trobeu en un entorn de xarxa o en un entorn sensible a la mida dels fitxers.
- 'directori': inclou una etiqueta d'script que apunta a un paquet extern plotly.min.js situat al mateix directori que el document HTML.
- 'require': establir el valor a requerir es carregarà la biblioteca plotly.js mitjançant require.js. Assegureu-vos que require.js estigui instal·lat i disponible globalment al sistema.
- 'Fals': no inclou la biblioteca plotly.js. Eviteu aquest valor quan configureu el paràmetre full_html com a True, ja que farà que tot el document sigui inutilitzable.
- include_mathjax: especifica si el fitxer ha d'incloure la biblioteca mathjax.js. Els valors acceptats són similars a include_plotlyjs excepte el valor 'require'.
- Post_script: us permet incloure fragments de JavaScript que s'executen després de la creació de la trama.
- Full_html: si és cert, la funció retornarà una cadena que conté tot el document HTML, començant per les etiquetes . Si és fals, la funció retornarà una cadena HTML que comença per l'element .
- Animation_opts: us permet especificar propietats d'animació personalitzades com a diccionari. A continuació, aquests valors es passen a la funció plotly.animate a plotly.js.
- Default_width: especifica l'amplada predeterminada de la figura resultant en píxels.
- Default_height: especifica l'alçada predeterminada de la figura en píxels.
- Valida: determina si la figura s'ha de validar abans de convertir-la en una cadena HTML.
- Div_id: especifica un valor de l'atribut id de l'etiqueta div on es troba la trama.
Aleshores, la funció retorna una representació de cadena de la figura com una cadena.
Exemple d'ús
El codi següent mostra com utilitzar la funció to_html per convertir una figura en una representació de cadena HTML.
importar trama. expressar com px
df = px. dades . estocs ( indexat = És cert )
fig = px. zona ( df , facet_col = 'empresa' , facet_col_wrap = 2 )
fig. espectacle ( )A l'exemple anterior, comencem important el mòdul Plotly express com a px. A continuació, creem un marc de dades utilitzant les dades d'estoc de Plotly.
Finalment, creem un gràfic d'àrea amb facetes mitjançant la funció px.area. Això hauria de tornar una xifra com es mostra a continuació:
Podem convertir la figura anterior en una representació de cadena HTML tal com es mostra al codi següent:
importar trama. això com això
això. a_html ( fig , full_html = Fals )L'execució del codi anterior hauria de retornar una cadena HTML massiva tal com es mostra a la captura de pantalla següent:
Tingueu en compte que el document HTML comença a l'element
. Si voleu incloure tot el fitxer HTML, configureu el paràmetre full_html=True tal com es mostra: importar trama. això com això
això. a_html ( fig , full_html = És cert )
Observeu que el marcatge comença a l'etiqueta .
Per incloure plotly.js, podem establir el paràmetre com:
importar trama. això com això
això. a_html ( fig , include_plotlyjs = 'cdn' , full_html = És cert )A l'exemple anterior, diem a la funció que inclogui la biblioteca plotly.js mitjançant un enllaç CDN.
Ho podem comprovar a partir de la sortida següent:
La millor manera d'utilitzar el document to_html és exportant la cadena HTML a un fitxer HTML.
Podem fer-ho executant un codi senzill com es mostra a continuació:
importar trama. això com això
amb obert ( 'facetted.html' , 'en' ) com f:
f. línies d'escriptura ( això. a_html ( fig , include_plotlyjs = 'cnd' , full_html = És cert ) )En aquest exemple, utilitzem el mòdul de fitxers a Python per escriure la cadena HTML com un fitxer HTML.
A continuació, podem obrir el document HTML al navegador i veure la figura tal com es mostra:
Conclusió
Enhorabona, heu exportat correctament la vostra figura de Plotly com a cadena HTML mitjançant la funció plotly.io.to_html.