Non sorprende quindi che potrebbe essere necessario convertire una specifica figura di Plotly in una stringa HTML.
In questo tutorial impareremo come utilizzare il modulo Plotly io per convertire una figura in una rappresentazione di stringa HTML.
Immergiamoci.
Funzione Plotly.io.to_html()
La funzione to_html() del modulo io di Plotly ti consente di passare una cifra specifica come parametro e convertirla in una stringa HTML.
La sintassi della funzione è espressa come mostrato di seguito:
tramare. questo . a_html ( Figura , config = Nessuno , riproduzione automatica = Vero , include_plotlyjs = Vero , include_mathjax = Falso , post_script = Nessuno , full_html = Vero , animazione_opts = Nessuno , larghezza_predefinita = '100%' , altezza_predefinita = '100%' , convalidare = Vero , div_id = Nessuno )
Esploriamo i parametri della funzione, di seguito:
- Fig – si riferisce all'oggetto figura o alla rappresentazione del dizionario della figura.
- Config: specifica le opzioni di configurazione di plotly.js. Passa le opzioni di configurazione come dizionario.
- Auto_play: determina se la sequenza di animazione deve essere riprodotta automaticamente al caricamento della pagina. Questo parametro è utile se si dispone di una figura contenente fotogrammi animati.
- Include_plotlyjs – questo parametro specifica come la libreria plotly.js è inclusa nell'HTML. I valori accettati in questo parametro includono:
- True: include la libreria plotly.js come tag di script nel documento HTML. Ciò aumenterà le dimensioni del file ma consentirà di utilizzare il file in ambienti offline.
- 'cdn': impostando il parametro include_plotlyjs su 'cdn' verrà aggiunto un tag di script che punta a un collegamento remoto per la libreria plotly.js. Utilizzare questa opzione in un ambiente di rete o in un ambiente sensibile alle dimensioni dei file.
- 'directory': include un tag di script che punta a un bundle plotly.min.js esterno situato nella stessa directory del documento HTML.
- 'require': l'impostazione del valore da richiedere caricherà la libreria plotly.js utilizzando require.js. Assicurati che require.js sia installato e disponibile a livello globale nel sistema.
- 'False': non include la libreria plotly.js. Evitare questo valore quando si imposta il parametro full_html su True poiché renderà inutilizzabile l'intero documento.
- include_mathjax – specifica se il file deve includere la libreria mathjax.js. I valori accettati sono simili a include_plotlyjs tranne il valore 'require'.
- Post_script: consente di includere frammenti di JavaScript che vengono eseguiti dopo la creazione della trama.
- Full_html – se true, la funzione restituirà una stringa contenente l'intero documento HTML, a partire dai tag . Se false, la funzione restituirà una stringa HTML che inizia con l'elemento .
- Animation_opts: consente di specificare proprietà di animazione personalizzate come dizionario. Questi valori vengono quindi passati alla funzione plotly.animate in plotly.js.
- Default_width – specifica la larghezza predefinita della figura risultante in pixel.
- Default_height – specifica l'altezza predefinita della figura in pixel.
- Convalida: determina se la cifra deve essere convalidata prima di essere convertita in una stringa HTML.
- Div_id – specifica un valore dell'attributo id del tag div in cui si trova il grafico.
Quindi, la funzione restituisce una rappresentazione di stringa della figura come stringa.
Esempio di utilizzo
Il codice seguente mostra come usare la funzione to_html per convertire una figura in una rappresentazione di stringa HTML.
importare tramare. esprimere come px
df = px. dati . scorte ( indicizzato = Vero )
Figura = px. la zona ( df , facet_col = 'azienda' , facet_col_wrap = Due )
Figura. mostrare ( )Nell'esempio sopra, iniziamo importando il modulo Plotly express come px. Quindi creiamo un frame di dati utilizzando i dati di stock di Plotly.
Infine, creiamo un grafico ad area sfaccettata usando la funzione px.area. Questo dovrebbe restituire una figura come mostrato di seguito:
Possiamo convertire la figura sopra in una rappresentazione di stringa HTML come mostrato nel codice seguente:
importare tramare. questo come questo
questo. a_html ( Figura , full_html = Falso )L'esecuzione del codice sopra dovrebbe restituire un'enorme stringa HTML come mostrato nello screenshot seguente:
Nota che il documento HTML inizia dall'elemento
. Se vuoi includere l'intero file HTML, imposta il parametro full_html=True come mostrato: importare tramare. questo come questo
questo. a_html ( Figura , full_html = Vero )
Notare che il markup inizia dal tag .
Per includere plotly.js, possiamo impostare il parametro come:
importare tramare. questo come questo
questo. a_html ( Figura , include_plotlyjs = 'cdn' , full_html = Vero )Nell'esempio sopra, diciamo alla funzione di includere la libreria plotly.js tramite un collegamento CDN.
Possiamo verificarlo dall'output di seguito:
Il modo migliore per utilizzare il documento to_html è esportare la stringa HTML in un file HTML.
Possiamo farlo eseguendo un semplice codice come mostrato di seguito:
importare tramare. questo come questo
insieme a aprire ( 'sfaccettato.html' , 'in' ) come f:
f. righe di scrittura ( questo. a_html ( Figura , include_plotlyjs = 'cnd' , full_html = Vero ) )In questo esempio, utilizziamo il modulo file in Python per scrivere la stringa HTML come un file N html.
Possiamo quindi aprire il documento HTML nel browser e visualizzare la figura come mostrato:
Conclusione
Congratulazioni, hai esportato con successo la tua figura Plotly come stringa HTML usando la funzione plotly.io.to_html.