Adicionar linhas de tendência a gráficos de apresentação em Python

Sobre o que é esta página

Adicione e personalize rapidamente linhas de tendência em gráficos do PowerPoint com Aspose.Slides para Python via Java — um guia prático para envolver seu público.

Visão geral

Este artigo explica como adicionar linhas de tendência a gráficos de apresentação usando Aspose.Slides. Ele mostra como criar um gráfico, adicionar linhas de tendência às séries do gráfico e trabalhar com vários tipos de linha de tendência, incluindo exponencial, linear, logarítmica, média móvel, polinomial e potência.

Ele também descreve como adicionar uma linha personalizada a um gráfico inserindo uma forma de linha e inclui uma breve FAQ sobre valores de projeção da linha de tendência para frente e para trás e se as linhas de tendência são preservadas ao exportar para PDF ou SVG e ao renderizar gráficos como imagens.

Adicionar uma linha de tendência

Aspose.Slides for Python via Java fornece uma API simples para gerenciar diferentes linhas de tendência de gráficos:

Crie uma instância da classe Presentation.
Obtenha uma referência a um slide pelo seu índice.
Adicione um gráfico com dados padrão e o tipo desejado (este exemplo usa ChartType.ClusteredColumn).
Adicionar uma linha de tendência exponencial à série 1 do gráfico.
Adicionar uma linha de tendência linear à série 1 do gráfico.
Adicionar uma linha de tendência logarítmica à série 2 do gráfico.
Adicionar uma linha de tendência de média móvel à série 2 do gráfico.
Adicionar uma linha de tendência polinomial à série 3 do gráfico.
Adicionar uma linha de tendência de potência à série 3 do gráfico.
Salvar a apresentação modificada em um arquivo PPTX.

O código a seguir cria um gráfico com linhas de tendência.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, FillType, Presentation, SaveFormat, TrendlineType
from java.awt import Color

# Crie uma instância da classe Presentation.
presentation = Presentation()
try:
    # Crie um gráfico de colunas agrupadas.
    chart = presentation.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 400)

    # Adicione uma linha de tendência exponencial à série 1 do gráfico.
    exponential_trend_line = chart.getChartData().getSeries().get_Item(0).getTrendLines().add(TrendlineType.Exponential)
    exponential_trend_line.setDisplayEquation(False)
    exponential_trend_line.setDisplayRSquaredValue(False)

    # Adicione uma linha de tendência linear à série 1 do gráfico.
    linear_trend_line = chart.getChartData().getSeries().get_Item(0).getTrendLines().add(TrendlineType.Linear)
    linear_trend_line.setTrendlineType(TrendlineType.Linear)
    linear_trend_line.getFormat().getLine().getFillFormat().setFillType(FillType.Solid)
    linear_trend_line.getFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.RED)

    # Adicione uma linha de tendência logarítmica à série 2 do gráfico.
    logarithmic_trend_line = chart.getChartData().getSeries().get_Item(1).getTrendLines().add(TrendlineType.Logarithmic)
    logarithmic_trend_line.setTrendlineType(TrendlineType.Logarithmic)
    logarithmic_trend_line.addTextFrameForOverriding("New log trend line")

    # Adicione uma linha de tendência de média móvel à série 2 do gráfico.
    moving_average_trend_line = chart.getChartData().getSeries().get_Item(1).getTrendLines().add(TrendlineType.MovingAverage)
    moving_average_trend_line.setTrendlineType(TrendlineType.MovingAverage)
    moving_average_trend_line.setPeriod(jpype.JByte(3))
    moving_average_trend_line.setTrendlineName("New TrendLine Name")

    # Adicione uma linha de tendência polinomial à série 3 do gráfico.
    polynomial_trend_line = chart.getChartData().getSeries().get_Item(2).getTrendLines().add(TrendlineType.Polynomial)
    polynomial_trend_line.setTrendlineType(TrendlineType.Polynomial)
    polynomial_trend_line.setForward(1)
    polynomial_trend_line.setOrder(jpype.JByte(3))

    # Adicione uma linha de tendência de potência à série 3 do gráfico.
    power_trend_line = chart.getChartData().getSeries().get_Item(2).getTrendLines().add(TrendlineType.Power)
    power_trend_line.setTrendlineType(TrendlineType.Power)
    power_trend_line.setBackward(1)

    # Salve a apresentação.
    presentation.save("ChartTrendLines_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Adicionar uma linha personalizada

Aspose.Slides for Python via Java fornece uma API simples para adicionar linhas personalizadas a um gráfico. Para adicionar uma linha simples a um gráfico em um slide selecionado, siga estas etapas:

Criar uma instância da classe Presentation.
Obter uma referência a um slide pelo seu índice.
Criar um novo gráfico usando o método addChart da classe ShapeCollection.
Adicionar uma forma de linha usando o método addAutoShape com ShapeType.Line.
Definir a cor da linha da forma.
Salvar a apresentação modificada em um arquivo PPTX.

O código a seguir cria um gráfico com uma linha personalizada.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

# Crie uma instância da classe Presentation.
presentation = Presentation()
try:
    chart = presentation.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 500, 400)
    shape = chart.getUserShapes().getShapes().addAutoShape(ShapeType.Line, 0, chart.getHeight() / 2, chart.getWidth(), 0)

    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.RED)

    presentation.save("Presentation.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Perguntas frequentes

O que significam ‘forward’ e ‘backward’ para uma linha de tendência?

São os comprimentos da linha de tendência projetados para a frente ou para trás: para gráficos de dispersão (XY), são medidos em unidades dos eixos; para gráficos que não são de dispersão, são medidos no número de categorias. Apenas valores não negativos são permitidos.

A linha de tendência será preservada ao exportar a apresentação para PDF ou SVG, ou ao renderizar um slide como imagem?

Sim. Aspose.Slides converte apresentações para PDF/SVG e renderiza gráficos em imagens; as linhas de tendência, como parte do gráfico, são preservadas durante essas operações. Também há um método disponível para exportar uma imagem do gráfico propriamente dito.