Python Academy · Lezione

Esportazione e incorporamento

Salvare e condividere le figure

Esportazione e incorporamento è una lezione Python Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Python Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Python Academy include 4 lezioni in totale.

Condividere il proprio lavoro

Un grafico finito è utile solo se altre persone possono vederlo. Le figure Plotly possono essere salvate come HTML interattivo, esportate come immagini statiche oppure incorporate in pagine web e report.

La scelta del formato appropriato dipende dal fatto che il pubblico abbia bisogno dell'interattività.

Salvare HTML interattivo

fig.write_html('chart.html') scrive un file autonomo che conserva tutta l'interattività. Aprendolo in un qualsiasi browser si possono usare zoom, hover e pan senza bisogno di Python.

È il formato migliore per condividere un grafico interattivo da esplorare.

Scegliere il nome del file

Il nome è importante quando si generano molte esportazioni. Un nome con timestamp e slug evita conflitti. Si tratta della normale gestione delle stringhe.

title = 'Q3 Sales Report!'
slug = ''.join(ch.lower() if ch.isalnum() else '_' for ch in title)
slug = '_'.join(p for p in slug.split('_') if p)
print(slug + '.html')

Esportazione di immagini statiche

Per PDF, presentazioni o messaggi email serve un'immagine statica. fig.write_image('chart.png') produce file PNG, JPEG, SVG o PDF. È necessario che sia installato il motore kaleido.

Le immagini statiche perdono l'interattività, ma possono essere incorporate ovunque.

Scegliere un formato

Abbinate il formato all'utilizzo:

HTML esplorazione interattiva, pagine web
PNG/JPEG raster, adatto a presentazioni e messaggi email
SVG vettoriale, si adatta alla stampa senza sfocarsi
PDF documenti

Una piccola tabella decisionale rende rapida la scelta.

use_case = 'print'
format_map = {'web': 'html', 'slides': 'png', 'print': 'svg', 'document': 'pdf'}
print('Best format for', use_case, '->', format_map[use_case])

Incorporare in una pagina

Per incorporare un grafico in un sito esistente senza un file HTML completo, usate fig.to_html(full_html=False, include_plotlyjs='cdn'). Restituisce solo il frammento HTML del grafico, che potete incollare nel template.

Caricare plotly.js da una CDN mantiene leggera la pagina.

Includere la libreria

L'HTML interattivo necessita della libreria plotly.js. Per include_plotlyjs sono disponibili queste opzioni:

True includerla nel file (dimensioni maggiori, funziona offline)
'cdn' collegarsi a una CDN (dimensioni ridotte, richiede Internet)
False presupporre che la pagina l'abbia già caricata

Scegliete in base alla necessità di lavorare offline e al peso della pagina.

Risoluzione dell'esportazione

Per le immagini statiche, controllate dimensioni e nitidezza con width, height e scale. Un valore scale=2 raddoppia la densità dei pixel, producendo immagini nitide sugli schermi ad alta risoluzione.

width, height, scale = 800, 600, 2
print('Output pixels:', width * scale, 'x', height * scale)

Round-trip JSON

Una figura può essere serializzata con fig.to_json() e ricostruita con plotly.io.from_json(). È utile per memorizzare nella cache le figure o inviarle tra un server e un browser.

Il JSON descrive completamente i dati e il layout.

Riproducibilità

Quando condividete un'esportazione, conservate anche lo script che l'ha prodotta. Un PNG non può essere modificato nuovamente, ma il codice può rigenerare il grafico con dati nuovi. Considerate il codice, non l'immagine, come la fonte di verità.

Incorporare in notebook e Markdown

In Jupyter, un grafico viene visualizzato automaticamente direttamente nella cella quando è l'ultima espressione della cella. Per la documentazione statica, esporti un'immagine e vi faccia riferimento da Markdown. Per la documentazione dinamica, incorpori invece il frammento HTML.

Scelga l'HTML interattivo quando il lettore trae vantaggio dall'esplorazione, e un'immagine statica quando deve solo osservarla.

Controllo rapido

Metta alla prova le Sue conoscenze sull'esportazione.

Riepilogo

Ha imparato a condividere i grafici:

write_html per file autonomi interattivi
write_image (con kaleido) per PNG/SVG/PDF
to_html(full_html=False) per incorporare un frammento, con include_plotlyjs che controlla la libreria
Usi scale per immagini ad alta risoluzione e conservi il codice sorgente per garantire la riproducibilità

Domande Frequenti

La lezione «Esportazione e incorporamento» è gratuita?

Sì — il testo completo di «Esportazione e incorporamento» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Python Academy, passa a CoddyKit PRO. Il corso Python Academy include 4 lezioni in totale.

Cosa imparerò in «Esportazione e incorporamento»?

Salvare e condividere le figure Eserciti Python Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Python Academy?

Non è richiesta alcuna esperienza precedente. Python Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Esportazione e incorporamento»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Python Academy?

Sì. Ogni lezione Python Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Python Academy