.. highlightlang:: us .. index:: pie .. _pie: pie ==== .. us.tag pie GERMAN New5900 :ref:`pie` gibt ein Kreisdiagramm aus (Kuchendiagramm, pie chart). .. function:: hText = pie(rvX) hText = pie(rvX, options) .. us.return **Returnwert** *hText* .. us.params **Parameter** .. uparam:: rvX *rvX* ist ein reeller Vektor mit den Werten des Kreisdiagramms. Es werden nur die ersten 32 Werte berücksichtigt. .. uparam:: options Der Parameter *options* ist ein Objekt, das Optionen enthalten kann. Die folgenden Optionen werden ausgewertet: .. list-table:: :header-rows: 1 * - Name - Typ - Defaultwert - Beschreibung * - color_scale - string - ``"Paired"`` - Name einer Farbskala. Defaultname ist Pastell. Siehe :ref:`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 :ref:`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. .. us.example **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]) .. image:: S:/uniplot-obj/images/pie.* .. ------------------------------------------------------------------------------ .. index:: pie_get_props .. _pie_get_props: pie_get_props ============== .. us.tag pie_get_props GERMAN New5900 :ref:`pie_get_props` erfragt die Eigenschaften eines Kreisdiagramms. .. function:: props = pie_get_props(hText) .. us.return **Returnwert** *props* ist ein Objekt mit den Parametern des Kreisdiagramm. .. us.params **Parameter** .. uparam:: hText *hText* ist der Handle eines Textobjektes. .. us.example **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) .. ------------------------------------------------------------------------------ .. index:: pie_set_props .. _pie_set_props: pie_set_props ============== .. us.tag pie_set_props GERMAN New5900 :ref:`pie_set_props` ändert die Eigenschaften eines Kreisdiagramms. .. function:: bool = pie_set_props(hText, props) .. us.return **Returnwert** *bool* .. us.params **Parameter** .. uparam:: hText *hText* ist der Handle eines Textobjektes. .. uparam:: props *props* ist ein Objekt mit den Parametern des Kreisdiagramms. .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - R2017 - Neu. .. seealso:: :ref:`DocCreate`, :ref:`PageCreate`, :ref:`PageGetParentDocument`, :ref:`LayerCreate`, :ref:`XYCreate`, :ref:`plotcategory`, :ref:`NC_plotcategory`, :ref:`GetParent`, :ref:`plot`, :ref:`g_create` :sub:`id-1925613`