Lavorare con i grafici

Il nuovo metodo insert_chart è stato aggiunto alla classe DocumentBuilder. Vediamo quindi come inserire un semplice istogramma nel documento utilizzando il metodo DocumentBuilder.insert_chart:

Come inserire un grafico

In questa sezione impareremo come inserire un grafico in un documento.

Inserisci grafico a colonne

L’esempio di codice seguente mostra come inserire un istogramma:

Il codice produce il seguente risultato:

Esistono metodi add, add_double e add_date, che sono stati esposti per coprire tutte le possibili varianti di origini dati per tutti i tipi di grafici:

Il codice produce il seguente risultato:

Inserisci grafico a dispersione

L’esempio seguente mostra come inserire un grafico a dispersione.

Il codice produce il seguente risultato:

Inserisci grafico ad area

L’esempio di codice seguente mostra come inserire un grafico ad area:

Il codice produce il seguente risultato:

Inserisci grafico a bolle

L’esempio di codice seguente mostra come inserire un grafico a bolle:

Il codice produce il seguente risultato:

Lavorare con i grafici tramite l’oggetto Shape.chart

Una volta inserito e riempito di dati il grafico, puoi modificarne l’aspetto. La proprietà Shape.chart contiene tutte le opzioni relative al grafico disponibili tramite il API pubblico.

Ad esempio, modifichiamo il comportamento del titolo Chart o della legenda:

Il codice genera i seguenti risultati:

Come lavorare con ChartSeriesCollection di grafici

Diamo un’occhiata alla raccolta ChartSeries. Tutte le serie di carte sono disponibili tramite la raccolta Chart.series:

Puoi rimuovere le serie una per una o cancellarle tutte e aggiungerne una nuova se necessario. Il grafico appena inserito presenta alcune serie predefinite aggiunte a questa raccolta. Per rimuoverli è necessario chiamare il metodo chart.series.clear().

Lavorare con la classe ChartSeries singola

Ecco come lavorare con una serie particolare.

Si prega di vedere il risultato qui sotto:

Tutti i singoli ChartSeries hanno opzioni ChartDataPoint predefinite, prova a utilizzare il seguente codice per modificarle:

Si prega di vedere il risultato qui sotto:

Come lavorare con il singolo ChartDataPoint di un ChartSeries

Utilizzando ChartDataPoint puoi personalizzare la formattazione di un singolo punto dati della serie di grafici:

Si prega di vedere il risultato qui sotto:

Come lavorare con ChartDataLabel di una singola ChartSeries

Utilizzando ChartDataLabel è possibile specificare la formattazione di una singola etichetta dati della serie di grafici, come mostrare/nascondere LegendKey, CategoryName, SeriesName, Value ecc.

Si prega di vedere il risultato qui sotto:

Come definire le opzioni predefinite per ChartDataLabels di ChartSeries

La classe ChartDataLabelCollection definisce le proprietà che possono essere utilizzate per impostare le opzioni predefinite per ChartDataLabels per le serie di grafici. Queste proprietà includono show_category_name, show_bubble_size, show_percentage, show_series_name, show_value ecc.

Si prega di vedere il risultato qui sotto:

Come formattare il numero dell’etichetta dei dati del grafico

Utilizzando ChartDataLabel.number_format è possibile specificare la formattazione numerica di una singola etichetta dati del grafico.

Il seguente esempio di codice mostra come formattare un numero dell’etichetta dati:

Come impostare le proprietà dell’asse del grafico

Se desideri lavorare con l’asse del grafico, il ridimensionamento e le unità di visualizzazione per l’asse dei valori, utilizza le classi ChartAxis, AxisDisplayUnit e AxisScaling.

Il seguente esempio di codice mostra come definire le proprietà degli assi X e Y:

Come impostare il valore temporale Date dell’asse

L’esempio di codice seguente mostra come impostare i valori di data/ora sulle proprietà dell’asse:

Come formattare il valore numerico dell’asse

L’esempio di codice seguente mostra come modificare il formato dei numeri sull’asse dei valori:

Come impostare i limiti dell’asse

La classe AxisBound rappresenta un limite minimo o massimo dei valori degli assi. Il limite può essere specificato come valore numerico, data-ora o speciale “automatico”.

L’esempio di codice seguente mostra come impostare i limiti di un asse:

Come impostare l’unità di intervallo tra le etichette

L’esempio di codice seguente mostra come impostare l’unità di intervallo tra le etichette su un asse:

Come nascondere l’asse del grafico

Se vuoi mostrare o nascondere l’asse del grafico, puoi semplicemente farlo impostando il valore della proprietà ChartAxis.hidden.

L’esempio di codice seguente mostra come nascondere l’asse Y del grafico:

Come allineare l’etichetta del grafico

Se desideri impostare un allineamento del testo per le etichette su più righe, puoi semplicemente ottenerlo impostando il valore della proprietà ChartAxis.tick_label_alignment.

L’esempio di codice seguente mostra come selezionare l’allineamento dell’etichetta:

MS Word allinea l’etichetta del grafico al centro per impostazione predefinita.

Come impostare la formattazione di riempimento e tratto

È possibile impostare la formattazione di riempimento e tratto per serie di grafici, punti dati e indicatori. A tale scopo è necessario utilizzare le proprietà del tipo ChartFormat nelle classi ChartSeries, ChartDataPoint e ChartMarker, nonché gli alias per alcune proprietà, come fore_color, back_color, visible e transparency nella classe Stroke.

L’esempio di codice seguente mostra come impostare il colore della serie:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.COLUMN, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Create category names array.
categories = [ "AW Category 1", "AW Category 2" ]

# Adding new series. Value and category arrays must be the same size.
series1 = seriesColl.add("AW Series 1", categories, [ 1, 2 ])
series2 = seriesColl.add("AW Series 2", categories, [ 3, 4 ])
series3 = seriesColl.add("AW Series 3", categories, [ 5, 6 ])

# Set series color.
series1.format.fill.fore_color = drawing.Color.red
series2.format.fill.fore_color = drawing.Color.yellow
series3.format.fill.fore_color = drawing.Color.blue

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.set_series_color.docx")

L’esempio di codice seguente mostra come impostare il colore e lo spessore della linea:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Adding new series.
series1 = seriesColl.add_double("AW Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
series2 = seriesColl.add_double("AW Series 2", [ 0.5, 1.5, 2.5 ], [ 3, 1, 2 ])

# Set series color.
series1.format.stroke.fore_color = drawing.Color.red
series1.format.stroke.weight = 5
series2.format.stroke.fore_color = drawing.Color.light_green
series2.format.stroke.weight = 5

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.line_color_and_weight.docx")