Personnaliser les points de données dans les graphiques Treemap et Sunburst en Python

Introduction

Parmi les autres types de graphiques PowerPoint, il en existe deux hiérarchiques — Treemap et Sunburst (également connu sous le nom de graphique Sunburst, diagramme Sunburst, graphique radial, diagramme radial ou diagramme à secteurs multiniveaux). Ces graphiques affichent des données hiérarchiques organisées sous forme d’arbre – des feuilles jusqu’au sommet d’une branche. Les feuilles sont définies par les points de données de la série, et chaque niveau de regroupement imbriqué suivant est défini par la catégorie correspondante. Aspose.Slides for Python via .NET vous permet de formater les points de données des graphiques Sunburst et Treemap en Python.

Voici un graphique Sunburst où les données de la colonne Series1 définissent les nœuds feuilles, tandis que les autres colonnes définissent les points de données hiérarchiques :

Commençons par ajouter un nouveau graphique Sunburst à la présentation :

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    chart = slide.shapes.add_chart(charts.ChartType.SUNBURST, 30, 30, 450, 400)

Voir aussi

• Créer des graphiques Sunburst

Si vous devez formater les points de données du graphique, utilisez les API suivantes : ChartDataPointLevelsManager, ChartDataPointLevel, et la propriété ChartDataPoint.data_point_levels . Elles donnent accès au formatage des points de données dans les graphiques Treemap et Sunburst. ChartDataPointLevelsManager est utilisé pour accéder aux catégories à plusieurs niveaux ; il représente un conteneur d’objets ChartDataPointLevel. C’est essentiellement un wrapper autour de ChartCategoryLevelsManager avec des propriétés supplémentaires spécifiques aux points de données. Le type ChartDataPointLevel expose deux propriétés—format et label—qui donnent accès aux paramètres correspondants.

Afficher les valeurs des points de données

Cette section montre comment afficher la valeur des points de données individuels dans les graphiques Treemap et Sunburst. Vous verrez comment activer les étiquettes de valeur pour les points sélectionnés.

Affichez la valeur du point de données “Leaf 4” :

data_points = chart.chart_data.series[0].data_points
data_points[3].data_point_levels[0].label.data_label_format.show_value = True

Définir les étiquettes et les couleurs pour les points de données

Cette section montre comment définir des étiquettes et des couleurs personnalisées pour les points de données individuels dans les graphiques Treemap et Sunburst. Vous apprendrez comment accéder à un point de données spécifique, attribuer une étiquette et appliquer un remplissage uni afin de mettre en évidence les nœuds importants.

Définissez l’étiquette de données “Branch 1” pour afficher le nom de la série (“Series1”) au lieu du nom de la catégorie, puis définissez la couleur du texte en jaune :

branch1_label = data_points[0].data_point_levels[2].label
branch1_label.data_label_format.show_category_name = False
branch1_label.data_label_format.show_series_name = True

branch1_label.data_label_format.text_format.portion_format.fill_format.fill_type = slides.FillType.SOLID
branch1_label.data_label_format.text_format.portion_format.fill_format.solid_fill_color.color = draw.Color.yellow

Définir les couleurs de branche pour les points de données

Utilisez les couleurs de branche pour contrôler la façon dont les nœuds parents et enfants sont regroupés visuellement dans les graphiques Treemap et Sunburst. Cette section montre comment définir une couleur de branche personnalisée pour un point de données spécifique afin de mettre en évidence les sous‑arbres importants et d’améliorer la lisibilité du graphique.

Modifiez la couleur de la branche “Stem 4” :

import aspose.slides as slides
import aspose.slides.charts as charts
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.SUNBURST, 30, 30, 450, 400)
    data_points = chart.chart_data.series[0].data_points

    stem4_branch = data_points[9].data_point_levels[1]
    
    stem4_branch.format.fill.fill_type = slides.FillType.SOLID
    stem4_branch.format.fill.solid_fill_color.color = draw.Color.red
      
    presentation.save("branch_color.pptx", slides.export.SaveFormat.PPTX)

FAQ

Puis-je modifier l’ordre (tri) des segments dans Sunburst/Treemap ?

Non. PowerPoint trie les segments automatiquement (généralement par valeurs décroissantes, dans le sens des aiguilles d’une montre). Aspose.Slides reproduit ce comportement : vous ne pouvez pas modifier l’ordre directement ; vous devez le faire en prétraitant les données.

Comment le thème de la présentation affecte-t-il les couleurs des segments et des étiquettes ?

Les couleurs du graphique héritent du theme/palette de la présentation, à moins que vous ne définissiez explicitement les remplissages ou les polices. Pour des résultats cohérents, fixez des remplissages unis et le formatage du texte aux niveaux requis.

L’exportation en PDF/PNG conservera-t-elle les couleurs de branche personnalisées et les paramètres des étiquettes ?

Oui. Lors de l’exportation de la présentation, les paramètres du graphique (remplissages, étiquettes) sont conservés dans les formats de sortie car Aspose.Slides rend le graphique avec le formatage appliqué.

Puis-je calculer les coordonnées réelles d’une étiquette/élément pour placer une superposition personnalisée au-dessus du graphique ?

Oui. Après validation de la disposition du graphique, les propriétés actual_x/actual_y sont disponibles pour les éléments (par exemple, un DataLabel), ce qui facilite le positionnement précis des superpositions.