Anpassa felstaplar i presentationsdiagram med Python

Översikt

Denna artikel förklarar hur man arbetar med felstaplar i presentationsdiagram med hjälp av Aspose.Slides. Den visar hur man lägger till felstaplar i en diagramserie, konfigurerar X- och Y-felstaplar, och använder olika värdetyper såsom fast, procentuell och anpassade värden.

Den visar också hur man tilldelar anpassade felstaplarsvärden för enskilda datapunkter i en serie genom att använda motsvarande datapunktssamling. Dessutom innehåller artikeln korta anteckningar om hur felstaplar beter sig vid export, deras kompatibilitet med markörer och datatetiketter, samt var man hittar de relaterade API‑referensklasserna och enumen.

Lägg till felstaplar

Aspose.Slides for Python via Java erbjuder ett enkelt API för att hantera felstaplarsvärden. Följande exempelprogram använder fasta och procentuella värdetyper.

  1. Skapa en instans av klassen Presentation.
  2. Lägg till ett bubbeldiagram på den önskade bilden.
  3. Åtkomst till den första diagramserien och ange felstapelformatet för X.
  4. Åtkomst till den första diagramserien och ange felstapelformatet för Y.
  5. Ange felstaplarnas värden och formatering.
  6. Skriv den ändrade presentationen till en PPTX‑fil.
import jpype
import asposeslides

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

from asposeslides.api import ChartType, DataSourceType, ErrorBarType, ErrorBarValueType, Presentation, SaveFormat

# Skapa en instans av Presentation-klassen.
presentation = Presentation()
try:
    # Skapa ett bubbeldiagram.
    chart = presentation.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, True)

    # Lägg till felstaplar och ange deras formatering.
    series = chart.getChartData().getSeries().get_Item(0)
    error_bar_x = series.getErrorBarsXFormat()
    error_bar_y = series.getErrorBarsYFormat()

    error_bar_x.setVisible(True)
    error_bar_y.setVisible(True)
    error_bar_x.setValueType(ErrorBarValueType.Fixed)
    error_bar_x.setValue(0.1)
    error_bar_y.setValueType(ErrorBarValueType.Percentage)
    error_bar_y.setValue(5)
    error_bar_x.setType(ErrorBarType.Plus)
    error_bar_y.getFormat().getLine().setWidth(2.0)
    error_bar_x.setEndCap(True)

    # Spara presentationen.
    presentation.save("ErrorBars.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Lägg till anpassade felstaplarsvärden

Aspose.Slides for Python via Java erbjuder ett enkelt API för att hantera anpassade felstaplarsvärden. Följande exempelprogram gäller när getValueType returnerar ErrorBarValueType.Custom. För att ange ett värde, använd getErrorBarsCustomValues för en specifik datapunkt i samlingen som returneras av serie‑metoden getDataPoints.

  1. Skapa en instans av klassen Presentation.
  2. Lägg till ett bubbeldiagram på den önskade bilden.
  3. Åtkomst till den första diagramserien och ange felstapelformatet för X.
  4. Åtkomst till den första diagramserien och ange felstapelformatet för Y.
  5. Åtkomst till de enskilda datapunkterna i diagramserien och ange deras felstaplarsvärden.
  6. Ange felstaplarnas värden och formatering.
  7. Skriv den ändrade presentationen till en PPTX‑fil.
import jpype
import asposeslides

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

from asposeslides.api import ChartType, DataSourceType, ErrorBarType, ErrorBarValueType, Presentation, SaveFormat

# Skapa en instans av Presentation-klassen.
presentation = Presentation()
try:
    # Skapa ett bubbeldiagram.
    chart = presentation.getSlides().get_Item(0).getShapes().addChart(ChartType.Bubble, 50, 50, 400, 300, True)

    # Lägg till anpassade felstaplar och ange deras formatering.
    series = chart.getChartData().getSeries().get_Item(0)
    error_bar_x = series.getErrorBarsXFormat()
    error_bar_y = series.getErrorBarsYFormat()
    error_bar_x.setVisible(True)
    error_bar_y.setVisible(True)
    error_bar_x.setValueType(ErrorBarValueType.Custom)
    error_bar_y.setValueType(ErrorBarValueType.Custom)

    # Åtkomst till diagramseriens datapunkter och konfigurera deras felstaplars värde‑källor.
    points = series.getDataPoints()
    data_source = points.getDataSourceTypeForErrorBarsCustomValues()
    data_source.setDataSourceTypeForXPlusValues(jpype.JByte(DataSourceType.DoubleLiterals))
    data_source.setDataSourceTypeForXMinusValues(jpype.JByte(DataSourceType.DoubleLiterals))
    data_source.setDataSourceTypeForYPlusValues(jpype.JByte(DataSourceType.DoubleLiterals))
    data_source.setDataSourceTypeForYMinusValues(jpype.JByte(DataSourceType.DoubleLiterals))

    # Ange felstaplarsvärden för diagramseriens datapunkter.
    for i in range(points.size()):
        custom_values = points.get_Item(i).getErrorBarsCustomValues()
        custom_values.getXMinus().setAsLiteralDouble(i + 1)
        custom_values.getXPlus().setAsLiteralDouble(i + 1)
        custom_values.getYMinus().setAsLiteralDouble(i + 1)
        custom_values.getYPlus().setAsLiteralDouble(i + 1)

    # Spara presentationen.
    presentation.save("ErrorBarsCustomValues.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Vad händer med felstaplar när man exporterar en presentation till PDF eller bilder?

De renderas som en del av diagrammet och bevaras vid konverteringen tillsammans med resten av diagramformateringen, förutsatt att en kompatibel version eller renderare används.

Kan felstaplar kombineras med markörer och datatetiketter?

Ja. Felstaplar är ett separat element och är kompatibla med markörer och datatetiketter; om elementen överlappar kan du behöva justera formateringen.

Var kan jag hitta listan över egenskaper och klasser för att arbeta med felstaplar i API:et?

I API‑referensen: klassen ErrorBarsFormat och de relaterade klasserna ErrorBarType och ErrorBarValueType.