pie

pie gibt ein Kreisdiagramm aus (Kuchendiagramm, pie chart).

hText = pie(rvX)
hText = pie(rvX, options)

Returnwert

hText

Parameter

rvX

rvX ist ein reeller Vektor mit den Werten des Kreisdiagramms. Es werden nur die ersten 32 Werte berücksichtigt.

options

Der Parameter options ist ein Objekt, das Optionen enthalten kann. Die folgenden Optionen werden ausgewertet:

Name Typ Defaultwert Beschreibung
color_scale string "Paired" Name einer Farbskala. Defaultname ist Pastell. Siehe ColorScale_GetNames für eine Liste der verfügbaren Farbskalen.
colors real or string "" Farbe für jedes Element. Matrix mit drei Spalten. Falls der Parameter nicht definiert ist, wird der Parameter mit den Farben gefüllt, die über den Parameter color_scale definiert sind.
edge_color real oder string "black" Der Wert „auto“ gibt die Randlinie in der abgedunkelten Farbe des Kuchenstücks aus. Kann auch als RGB-Wert in der Form [255,0,0] angegeben werden.
edge_show real 1 Der Wert 1 legt fest, dass die Randlinie ausgegeben wird.
edge_width real 1 Linienbreite in 0.1 mm Einheiten.
explode real 0 Ist ein Vektor, der festlegt, wie weit die einzelnen Segmente aus dem Zentrum nach außen geschoben werden sollen. Die Werte werden in Prozent der Diagrammbreite definiert.
hPage real 0 Ist der Handle einer Seite, in die das Kreisdiagramm eingefügt werden soll. Falls der Parameter nichtexistiert oder den Wert 0 enthält, wird ein neues Dokument mit einer leeren Seite erzeugt.
labels string "" Ist ein Vektor mit einem Text für jeden Wert.
label_show real 1 Die Label werden ausserhalb des Kreisdiagramms angezeigt.
legend_show real 0 Anzeige einer Legende. In der Legende wird die Farbe, der Labeltext und optional der Wert angezeigt.
legend_values_show real 0 Legt fest, ob die Werte in der Legende angezeigt werden sollen.
subplot real vector [1,1,2,2] subplot ist ein Vektor mit 4 Elementen [iRow, iCol, nRows, nCols], mit dem die Position und Größe des Kreisdiagramms festgelegt werden kann. Dazu wird über die Seite ein gedachtes Gitter mit nRows Zeilen und nCols Spalten gelegt und das Kuchendiagramm in das Feld iRows, iCols gezeichnet. Beispiel: Ganze Seite verwenden: [1,1,1,1], untere Hälfte: [2,1,2,1]. Alternativ können die Parameter x, y, width, height verwendet werden.
sweep_angle real 360 Ist der Winkel, auf den die Segmente des Kreisdiagramms verteilt werden. Defaultwert ist 360°. Wertebereich 1° bis 360°
start_angle real 0 Legt den Startwinkel fest. Der Winkel 0° befindet sich bei 3 Uhr. Die Winkel steigen gegen den Uhrzeiger an.
x real 0 Mit x und y kann die untere linke Ecke des Diagramms in cm angegeben werden.
y real 0 Mit x und y kann die untere linke Ecke des Diagramms in cm angegeben werden.
width real 0 Breite des Diagramms in cm.
height real 0 Höhe des Diagramms in cm.
value_format string "%g %%" Ist ein Formatstring für die Formatierung der Werte. Format mit 2 Nachkommastellen und einem Prozentzeichen: „%.2lf %%“. „%%“ druckt das Prozentzeichen. Siehe printf.
value_percent real 1 Falls 1 werden die Werte in Prozent ausgegeben.
values real 0 Werte des Diagramms. Die Werte werden für die Darstellung in Prozent umgerechnet.
values_show real 1 Falls 1, werden die Stücke mit ihren Werten beschriftet.
transparency real 255 255: opaque, 127: halb transparent, 0: transparent
title string "" Ist der Diagrammtitel.
title_show real 1 Falls 1 wird der Titel angezeigt.

Beispiel

pie([0.1, 0.4, 0.2])
hPie = pie([72, 8, 20], [. title="2030", labels = ["Cat A", "Cat B", "Cat C"], color_scheme = "Blues", legend_show = 1])
../../_images/pie.png

pie_get_props

pie_get_props erfragt die Eigenschaften eines Kreisdiagramms.

props = pie_get_props(hText)

Returnwert

props ist ein Objekt mit den Parametern des Kreisdiagramm.

Parameter

hText

hText ist der Handle eines Textobjektes.

Beispiel

* h = pie([72, 8, 20], [. title="2030", labels = ["Cat A", "Cat B", "Cat C"], legend_show = 1])
* pie_get_props(h)
[.
    color_scheme = "Blues"
    colors = ""
    edge_color = "auto"
    edge_show = 1
    edge_width = 1
    explode[3;1] = [0, 0, 0]
    hPage = 29
    label_show = 1
    labels[3;1] = ["Cat A", "Cat B", "Cat C"]
    show_legend = 1
    show_legend_values = 0
    start_angle = 0
    subplot[1;4] = [1, 1, 2, 2]
    sweep_angle = 360
    table_uuid = "uuid:999ff6d8-c7a4-4a63-89ab-95570d17a1e2"
    title = "2030"
    title_show = 1
    transparency = 255
    value_format = "%g %%"
    value_percent = 1
    values[3;1] = [72, 8, 20]
    values_show = 1
]
object (obj at 0x72AEFF68)

pie_set_props

pie_set_props ändert die Eigenschaften eines Kreisdiagramms.

bool = pie_set_props(hText, props)

Returnwert

bool

Parameter

hText

hText ist der Handle eines Textobjektes.

props

props ist ein Objekt mit den Parametern des Kreisdiagramms.

History

Version Beschreibung
R2017 Neu.

id-1925613