Настройка точек данных в диаграммах Treemap и Sunburst на Python
Введение
Помимо других типов диаграмм PowerPoint, существуют два иерархических — Treemap и Sunburst (известные также как Sunburst Graph, Sunburst Diagram, Radial Chart, Radial Graph или Multi-Level Pie Chart). Эти диаграммы отображают иерархические данные, организованные в виде дерева — от листьев к вершине ветки. Листья задаются точками данных серии, а каждый последующий уровень вложенной группы определяется соответствующей категорией. Aspose.Slides for Python via .NET позволяет форматировать точки данных диаграмм Sunburst и Treemap в Python.
Начнём с добавления новой диаграммы Sunburst в презентацию:
with slides.Presentation() as presentation:
slide = presentation.slides[0]
chart = slide.shapes.add_chart(charts.ChartType.SUNBURST, 30, 30, 450, 400)
Смотрите также
Если вам требуется форматировать точки данных диаграммы, используйте следующие API:
ChartDataPointLevelsManager, ChartDataPointLevel, и свойство ChartDataPoint.data_point_levels. Они предоставляют доступ к форматированию точек данных в диаграммах Treemap и Sunburst. ChartDataPointLevelsManager используется для доступа к многоуровневым категориям; он представляет собой контейнер объектов ChartDataPointLevel. По сути, это обёртка над ChartCategoryLevelsManager с дополнительными свойствами, специфичными для точек данных. Тип ChartDataPointLevel раскрывает два свойства — format и label — которые предоставляют доступ к соответствующим настройкам.
Отображение значений точек данных
В этом разделе показано, как отобразить значение отдельной точки данных в диаграммах Treemap и Sunburst. Вы увидите, как включить подписи значений для выбранных точек.
Отобразить значение точки данных «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
Установка меток и цветов для точек данных
В этом разделе показано, как задать пользовательские метки и цвета для отдельных точек данных в диаграммах Treemap и Sunburst. Вы узнаете, как получить доступ к конкретной точке данных, назначить метку и применить сплошную заливку для выделения важных узлов.
Установить метку данных «Branch 1», чтобы отображалось имя серии («Series1») вместо имени категории, а затем задать цвет текста — желтый:
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
Установка цветов веток для точек данных
Используйте цвета веток, чтобы управлять визуальной группировкой родительских и дочерних узлов в диаграммах Treemap и Sunburst. Этот раздел демонстрирует, как задать пользовательский цвет ветки для конкретной точки данных, чтобы выделить важные поддеревья и повысить читаемость диаграммы.
Изменить цвет ветки «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)
Вопросы и ответы
Можно ли изменить порядок (сортировку) сегментов в диаграммах Sunburst/Treemap?
Нет. PowerPoint сортирует сегменты автоматически (обычно по убыванию значений по часовой стрелке). Aspose.Slides повторяет это поведение: изменить порядок напрямую нельзя; это достигается предварительной обработкой данных.
Как тема презентации влияет на цвета сегментов и меток?
Цвета диаграмм наследуют тему/палитру презентации, если только вы явно не задаёте заливки/шрифты. Для получения предсказуемых результатов закрепите сплошные заливки и форматирование текста на нужных уровнях.
Сохранятся ли пользовательские цвета веток и настройки меток при экспорте в PDF/PNG?
Да. При экспорте презентации настройки диаграммы (заливки, метки) сохраняются в выходных форматах, поскольку Aspose.Slides рендерит их с учётом применённого форматирования.
Можно ли вычислить фактические координаты метки/элемента для размещения пользовательского наложения поверх диаграммы?
Да. После того как макет диаграммы валидирован, доступны свойства actual_x/actual_y для элементов (например, у DataLabel), что упрощает точное позиционирование наложений.