In diesem Dokument wird beschrieben, wie Sie mit der Chart API Kreisdiagramme erstellen.

Inhaltsverzeichnis

Übersicht

Kreisdiagramme eignen sich gut für die Darstellung einfacher proportionaler Teile zum Ganzen. Sie können ein einzelnes Reihen-Kreisdiagramm erstellen, bei dem jede Reihe aus mehreren Segmenten besteht, oder konzentrische Mehrfachreihendiagramme.

Jede Reihe beschreibt einen Kreis und jeder Datenwert gibt ein Segment an. Verwenden Sie bei verschachtelten Kreisdiagrammen (siehe unten) mehrere Reihen.

Wenn Sie den Text eines Kreissegments anzeigen lassen möchten, müssen Sie entweder Kreisdiagramme oder eine Diagrammlegende verwenden. Die Beschriftungen von Kreisdiagrammen sind Text um das Diagramm herum mit Linien, die auf das Segment zeigen. Legenden sind Text, der farblich markiert ist.

Labels	Legende	Beschriftungen und Legende
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

Die Werte werden relativ zueinander angezeigt: Ein Diagramm mit den Werten 1,2,3 sieht also genauso aus wie ein Diagramm mit den Werten 100,200,300. Wenn Sie jedoch Daten im Textformat verwenden, werden Werte über 100 auf 100 gekürzt. Daher müssen Sie Textformat mit benutzerdefinierter Skalierung verwenden, um Segmente über 100 korrekt darzustellen. Verwenden Sie den Parameter chds mit den Mindest- und Höchstwerten von chds=0,<max-slice-size>.

Negative Werte werden als leere Segmente mit der entsprechenden Größe angezeigt.

Diagrammtypen

Sie können grundsätzlich drei Arten von Kreisdiagrammen erstellen: flach, konzentrisch und 3D. Geben Sie ein Kreisdiagramm mit der folgenden Syntax an:

Syntax

cht=<chart_type>

Dabei steht <chart_type> für einen der folgenden Typen:

Parameter	Beschreibung	Beispiel
p	Zweidimensionales Kreisdiagramm. Geben Sie nur eine Datenreihe an. Nachfolgende Datenreihen werden ignoriert. Standardmäßig werden die Farben der Kreissegmente von Dunkelorange zu Hellgelb interpoliert. Geben Sie andere Farben an, wie unter Farben für Reihen beschrieben. Geben Sie Labels mit chl an, wie unter Kreisdiagramm-Labels beschrieben. Die Google Chart API berechnet den Radius des Kreises auf der Grundlage der Mindestbreite und -höhe, die im Parameter für die Diagrammgröße (chs) angegeben sind. Wenn Sie Labels verwenden, müssen Sie die Breite wahrscheinlich doppelt so groß wie die Höhe verwenden, damit Ihre Labels vollständig sichtbar sind.	cht=p chs=200x100
p3	Ein dreidimensionales Kreisdiagramm. Geben Sie Daten und Formatierungen auf die gleiche Weise an wie bei zweidimensionalen Kreisdiagrammen oben. Wenn Sie Beschriftungen in ein dreidimensionales Kreisdiagramm verwenden, müssen Sie wahrscheinlich für die Breite das 2,5-fache der Höhe angeben, damit die Beschriftungen vollständig sichtbar sind.	cht=p3 chs=250x100
pc	Ein konzentrisches Kreisdiagramm. Geben Sie mindestens zwei Datenreihen an.	cht=pc chd=s:Helo,Wrld
Alle Typen	Negative Zahlen in den Daten führen zu „leeren“ Segmenten.	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

Farben für Reihen chco

Mit dem Parameter chco können Sie die Farben aller Werte, jedes Werts oder bestimmter Werte angeben.

Syntax

chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>

<color>

Teilen Sie Farben im Hexadezimalformat RRGGBB aus. Geben Sie eine einzelne Reihenfarbe an. Alle Segmente in dieser Reihe werden dann in Abstufungen dieser Farbe von der dunkelsten (ersten Datengruppe) bis zur hellsten (letztes Datenelement) eingefärbt. Geben Sie zwei oder mehr Farben an, die durch einen | voneinander getrennt sind, um einzelne Segmentfarben zu beschreiben. Wenn Sie mehrere Reihen haben (d. h. ein Diagramm mit konzentrischen Ringen), können Sie Werte für verschiedene Reihen angeben, indem Sie die Werte durch ein Komma trennen. Wenn weniger Kreis-/Reihenfarben angegeben sind als die Segmente/Reihen, die angezeigt werden, wird das Diagramm vom Anfang der Kreissegmentliste für die Reihe bzw. der Reihenliste für das Diagramm abwechselnd durchlaufen. In einem Diagramm mit mehreren Reihen können Sie nicht für jede Reihe einen eigenen Farbverlauf angeben.

Beschreibung	Beispiel
Geben Sie eine einzelne Farbe mit Abstufungen vom dunkelsten (ersten Segment) zum hellsten (letzten Segment) an.	chco=0000FF
Definieren eines Farbverlaufs, hier von Gelb zu Rot.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
Definieren einzelner Segmentfarben. Geben Sie eine Farbe pro Segment an.	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
Dieses Diagramm umfasst zwei Datenreihen, aber die Farbe wird als einzelner Farbverlauf für alle Segmente von gelb nach Rot angegeben (BBBB00–BB0000).	chco=BBBB00,BB0000
Hier ist ein konzentrisches Diagramm, das sowohl Reihenfarben als auch einzelne Kreisfarben enthält. Das Diagramm umfasst zwei konzentrische Datenreihen. In visuell lesbarer Form sind die Farben chco=grün|rot,blau|gelb. Mit dem Komma wird dies in zwei Reihen unterteilt: grün|rot - Grüne und rote Segmente abwechselnd. blau|gelb - Blaue und gelbe Segmente abwechselnd.	chd=s:eYY,ORVM chco=008800|880000,000088|888800

Nach oben

Kreisdiagramm-Labels chl

Mit dem Parameter chl können Sie Labels für einzelne Segmente von Kreisdiagrammen festlegen. Sie können auch eine Legende mit denselben oder unterschiedlichen Werten anzeigen (ein Legendeneintrag pro Segment).

Hinweis zu Stringwerten:In Labelstrings sind nur URL-sichere Zeichen zulässig. Um sicherzugehen, solltest du alle Strings, die Zeichen enthalten, die nicht im Zeichensatz 0-9a-zA-Z enthalten sind, URL-codieren. Einen URL-Encoder findest du hier.

Syntax

chl=
  <label_value>|
    ...
  <label_value>

<label_value>

Ein Stringwert, der auf ein Segment angewendet werden soll. Labels werden nacheinander auf die Datenpunkte in chd angewendet. Wenn Sie mehrere Reihen haben (z. B. für ein konzentrisches Kreisdiagramm), werden Labels auf alle Punkte in allen Sequenzen in der in chd angegebenen Reihenfolge angewendet. Verwenden Sie zwischen den einzelnen Labels ein Pipe-Trennzeichen ( | ). Geben Sie einen fehlenden dazwischenliegenden Wert an. Verwenden Sie dazu zwei aufeinanderfolgende Pipe-Zeichen ohne Leerzeichen dazwischen: || . Sie müssen nicht alle Segmente mit Labels versehen.

 

Beispiele

Beschreibung	Beispiel
Beschriftungen für ein dreidimensionales Kreisdiagramm.	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
Berücksichtigen Sie beim Angeben der Größe Ihres Diagramms mit chs, wie viel Platz Ihre Labels benötigen. Im Allgemeinen muss ein zweidimensionales Kreisdiagramm ungefähr doppelt so breit wie hoch sein, und ein dreidimensionales Kreisdiagramm etwa zweieinhalb Mal breiter als hoch, damit Labels richtig angezeigt werden. Im ersten Beispiel werden die Labels nur teilweise angezeigt, da das Diagramm nicht breit genug ist. Das zweite Beispiel zeigt, dass das Diagramm eine Breite von 280 Pixeln benötigt, um die Labels vollständig darzustellen. (Rahmen, die dem <img>-Element explizit hinzugefügt wurden)	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

Nach oben

Drehung des Kreisdiagramms chp

Standardmäßig wird die erste Reihe ab 3:00 Uhr im Uhrzeigersinn um das Diagramm herum gezeichnet. Sie können jedoch mit dem Parameter chp eine benutzerdefinierte Rotation angeben.

Syntax

chp=<radians>
  

<radians>

Ein Gleitkommawert, der angibt, um wie viel Bogenmaß das Diagramm im Uhrzeigersinn gedreht werden soll. Eine vollständige Drehung ist 2π (2 Pi – ca.6,28) Radiant.

Beispiele

Beschreibung	Beispiel
Um die Ausrichtung eines Kreisdiagramms zu ändern, verwenden Sie chp=<angle_in_radians>.	chd=t:20,80 chd=t:80,20 chp=0.628
Hier ist ein weiteres Beispiel für Rotationen in Kreisdiagrammen. Diese können mit Diagrammformmarkierungen kombiniert werden, um interessante Effekte zu erzeugen.

 

Nach oben

Standardfunktionen

Bei den übrigen Elementen auf dieser Seite handelt es sich um Standardelemente in Diagrammen.

Diagrammtitel chtt, chts [Alle Diagramme]

Sie können den Titeltext, die Farbe und die Schriftgröße für Ihr Diagramm festlegen.

Syntax

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt: Gibt den Diagrammtitel an.

<chart_title>

Der für das Diagramm anzuzeigende Titel. Sie können nicht festlegen, wo dies angezeigt wird. Sie haben aber die Möglichkeit, die Schriftgröße und -farbe anzugeben. Verwenden Sie ein Pluszeichen, um Leerzeichen anzugeben, und ein senkrechter Strich ( |) für Zeilenumbrüche.

 

chts [optional]: Farben und Schriftgröße für den Parameter chtt.

<color>

Die Titelfarbe im Hexadezimalformat RRGGBB. Die Standardfarbe ist Schwarz.

<font_size>

Schriftgröße des Titels in Punkten.

<opt_alignment>

[Optional] Ausrichtung des Titels. Wählen Sie einen der folgenden Stringwerte aus. Dabei ist auf die Groß- und Kleinschreibung zu achten: „l“ (links), „c“ (mittig) „r“ (rechts). Die Standardeinstellung ist „c“.

 

Beispiele

Beschreibung	Beispiel
Ein Diagramm mit einem Titel, in der Standardfarbe und -schriftgröße verwendet werden. Geben Sie ein Leerzeichen mit einem Pluszeichen (+) ein. Verwenden Sie einen senkrechten Strich (|), um einen Zeilenumbruch zu erzwingen. chts ist hier nicht angegeben.	chtt=Site+visitors+by+month| January+to+July
Ein Diagramm mit einem blauen, rechts ausgerichteten Titel mit 20 Punkten.	chtt=Site+visitors chts=FF0000,20,r

Nach oben

Text und Stil für Diagrammlegende chdl, chdlp, chdls [Alle Diagramme]

Die Legende ist ein Seitenbereich des Diagramms, der eine kurze Beschreibung jeder Reihe enthält. Sie können den Text angeben, der mit jeder Reihe in dieser Legende verknüpft ist, und angeben, wo er im Diagramm angezeigt werden soll.

Informationen zum Festlegen der Ränder um die Legende finden Sie unter chma.

Hinweis zu Stringwerten:In Labelstrings sind nur URL-sichere Zeichen zulässig. Um sicherzugehen, solltest du alle Strings, die Zeichen enthalten, die nicht im Zeichensatz 0-9a-zA-Z enthalten sind, URL-codieren. Einen URL-Encoder finden Sie in der Dokumentation zur Google-Visualisierung.

Syntax

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl: Text für jede Reihe, der in der Legende angezeigt wird

<data_series_label

Der Text für die Legendeneinträge. Jedes Label gilt für die entsprechende Reihe im Array chd. Verwenden Sie +-Zeichen für Leerzeichen. Wenn Sie diesen Parameter nicht angeben, wird für das Diagramm keine Legende angezeigt. In einem Label kann kein Zeilenumbruch angegeben werden. Die Legende wird in der Regel so erweitert, dass sie den Legendentext enthält, und der Diagrammbereich wird verkleinert, um die Legende unterzubringen.

chdlp : [optional] Die Position der Legende und die Reihenfolge der Legendeneinträge. Sie können <position> und/oder <label_order> angeben. Wenn Sie beide angeben, trennen Sie sie durch ein Strichzeichen. Sie können jedem Wert ein „s“ hinzufügen, wenn leere Legendeneinträge in chdl in der Legende übersprungen werden sollen. Beispiele: chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

<opt_position>

[Optional] Gibt die Position der Legende im Diagramm an. Mit dem Parameter chma können Sie einen zusätzlichen Abstand zwischen der Legende und dem Diagrammbereich oder dem Bildrand festlegen. Wählen Sie einen der folgenden Werte aus:

• b: Legende unten im Diagramm, Legendeneinträge in einer horizontalen Zeile.
• bv: Legende unten im Diagramm, Legendeneinträge in einer vertikalen Spalte.
• t: Legende oben im Diagramm, Legendeneinträge in einer horizontalen Zeile.
• tv: Legende oben im Diagramm, Legendeneinträge in einer vertikalen Spalte.
• r: [Standard] Legende rechts neben dem Diagramm, Legendeneinträge in einer vertikalen Spalte.
• l: Legende links neben dem Diagramm, Legendeneinträge in einer vertikalen Spalte.

<opt_label_order>

[optional] Die Reihenfolge, in der die Labels in der Legende angezeigt werden. Wählen Sie einen der folgenden Werte aus:

• l: [Standard für vertikale Legenden] Die Labels werden in der Reihenfolge angezeigt, die chdl zugewiesen wurde.
• r: Labels wie chdl gegeben in umgekehrter Reihenfolge anzeigen. Dies ist bei gestapelten Balkendiagrammen nützlich, da die Legende
  in derselben Reihenfolge wie die Balken angezeigt wird.
• a – [Standard für horizontale Legenden] Automatische Sortierung: Bedeutet in etwa das Sortieren nach Länge, kürzester zuerst, gemessen in 10-Pixel-Blöcken. Wenn zwei Elemente die gleiche Länge haben (in zehn Pixelblöcke unterteilt), wird das zuerst aufgeführte Element zuerst angezeigt.
• 0,1,2... – Reihenfolge der benutzerdefinierten Labels. Dies ist eine Liste von nullbasierten Labelindexen aus chdl, die durch Kommas getrennt sind.

chdls: [optional]: Gibt die Farbe und die Schriftgröße des Legendentexts an.

<color>

Die Farbe des Legendentexts im Hexadezimalformat RRGGBB.

<size>

Die Punktgröße der Legende.

 

Beispiele

Beschreibung	Beispiel
Zwei Beispiele für Legenden. Geben Sie den Legendentext in derselben Reihenfolge wie die Datenreihen an.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
Das erste Diagramm enthält horizontale Legendeneinträge (chdlp=t, das Standardlayout ist horizontal) und das zweite Diagramm enthält horizontale Legendeneinträge (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
In diesem Beispiel wird das Ändern der Schriftgröße veranschaulicht.	chdls=0000CC,14

Nach oben

Ränder in Diagramm chma [alle Diagramme]

Sie können die Größe der Ränder des Diagramms in Pixeln angeben. Ränder werden ausgehend von der angegebenen Diagrammgröße (chs) berechnet. Eine Erhöhung der Ränder erhöht nicht die Gesamtgröße des Diagramms, sondern verkleinert gegebenenfalls den Diagrammbereich.

Die Ränder entsprechen standardmäßig dem, was nach der Berechnung der Diagrammgröße übrig bleibt. Dieser Standardwert variiert je nach Diagrammtyp. Die von Ihnen angegebenen Ränder sind ein Mindestwert. Wenn im Diagrammbereich Platz für Ränder bleibt, bleibt die Ränder übrig, die übrig bleibt. Sie können die Ränder nicht kleiner zusammendrücken, als für Legenden und Labels erforderlich ist. Das folgende Diagramm zeigt die grundlegenden Bestandteile eines Diagramms:

Die Ränder des Diagramms umfassen die Achsenlabels und den Legendenbereich. Die Größe des Legendenbereichs wird automatisch an den Text angepasst, es sei denn, Sie geben mit chma eine größere Breite an. In diesem Fall wird der Rand vergrößert und der Diagrammbereich kleiner. Sie können eine Legende nicht durch Angabe einer zu kleinen Größe zuschneiden, Sie können jedoch festlegen, dass sie mehr Platz einnimmt, als erforderlich ist. Tipp: Wenn die Balken in einem Balkendiagramm eine feste Größe (Standardeinstellung) haben, kann die Breite des Diagrammbereichs nicht verringert werden. Sie müssen mit chbh eine kleinere oder anpassbare Balkengröße angeben.

 

Syntax

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>, <right_margin>, <top_margin>, <bottom_margin>

Minimale Randgröße um den Diagrammbereich in Pixeln Erhöhen Sie diesen Wert, um einen Innenrand hinzuzufügen, damit Achsenbeschriftungen nicht über den Rahmen des Diagramms stoßen.

<opt_legend_width>, <opt_legend_height>

[Optional] Breite des Rands um die Legende in Pixeln. Damit vermeiden Sie, dass die Legende gegen den Diagrammbereich oder die Ränder des Bildes ragt.

 

Beispiele

Beschreibung	Beispiel
In diesem Beispiel hat das Diagramm einen Mindestrand von 30 Pixeln auf jeder Seite. Da die Diagrammlegende mehr als 30 Pixel breit ist, wird der Rand auf der rechten Seite auf die Breite der Diagrammlegende festgelegt und unterscheidet sich von den anderen Rändern. Achsenbeschriftungen befinden sich außerhalb des Diagrammbereichs und werden daher innerhalb des Randbereichs gezeichnet.	chma=30,30,30,30
Wenn Sie einen Rand um die Legende hinzufügen möchten, legen Sie einen Wert für die Parameter <opt_legend_width> und <opt_legend_height> fest. In diesem Beispiel ist die Legende etwa 60 Pixel breit. Wenn Sie die <opt_legend_width> auf 80 Pixel festlegen, erweitert sich der Rand bis zu 20 Pixel außerhalb der Legende.	chma=20,20,20,30|80,20

Nach oben

Achsenstile und ‐labels [Linie, Balken, Google-O-Meter, Radar, Streudiagramm]

Sie können festlegen, welche Achsen im Diagramm angezeigt werden sollen, und ihnen benutzerdefinierte Labels, Positionen, Bereiche und Stile zuweisen.

Nicht in allen Diagrammen werden standardmäßig Achsenlinien angezeigt. Mit dem Parameter chxt können Sie genau festlegen, welche Achsen im Diagramm angezeigt werden sollen. Die Standardachsenlinien stellen keine Zahlen dar. Sie müssen im Parameter chxt eine Achse angeben, um Zahlen darzustellen.

Sie können festlegen, dass Ihre Achsen Zahlen anzeigen, die die Datenwerte widerspiegeln, oder Sie können benutzerdefinierte Achsen angeben. Standardmäßig werden numerische Werte angezeigt, wobei Werte auf einen Bereich von 0–100 skaliert werden. Sie können diesen Bereich jedoch mit chxr ändern, um einen beliebigen Bereich anzuzeigen, und die Werte mit chxs gestalten (z. B. um Währungssymbole oder Dezimalstellen anzuzeigen).

Wenn Sie benutzerdefinierte Werte verwenden möchten, z. B. „Mo, Dis, Mi“, können Sie den Parameter chxl verwenden. Wenn Sie diese Labels an bestimmten Positionen entlang der Achse platzieren möchten, verwenden Sie den Parameter chxp.

Schließlich können Sie mit den Parametern chxs und chxtc Farbe, Größe, Ausrichtung und andere Eigenschaften von Labels für benutzerdefinierte und numerische Achsen angeben.

Hinweis zu Stringwerten:In Labelstrings sind nur URL-sichere Zeichen zulässig. Um sicherzugehen, solltest du alle Strings, die Zeichen enthalten, die nicht im Zeichensatz 0-9a-zA-Z enthalten sind, URL-codieren. Einen URL-Encoder finden Sie in der Dokumentation zur Google-Visualisierung.

In diesem Abschnitt werden die folgenden Themen behandelt:

• Sichtbare Achsen (chxt) gibt an, welche Achsen angezeigt werden sollen.
• Achsenbereich (chxr) – Wertebereich für jede Achse.
• Benutzerdefinierte Achsenlabels (chxl) – benutzerdefinierte Werte, die auf der Achse angezeigt werden sollen.
• Positionen von Achsenlabels (chxp) – Platzierung benutzerdefinierter Labels entlang jeder Achse.
• Achsenlabelstile (chxs) – Farbe, Größe, Ausrichtung und Formatierung von Achsenlabels
• Achsen-Teilstrich-Stile (chxtc) – Länge von Teilstrichen einer bestimmten Achse.

---

Sichtbare Achsen chxt

Balken-, Linien-, Radar- und Streudiagramme zeigen standardmäßig ein oder zwei Achsenlinien an. Diese Linien enthalten jedoch keine Werte. Wenn Sie Werte auf den Achsenlinien anzeigen oder die angezeigten Achsen ändern möchten, müssen Sie den Parameter chxt verwenden. Standardmäßig reichen die Achsenwerte von 0 bis 100, es sei denn, Sie skalieren sie explizit mit dem Attribut chxr. Wenn Sie alle Achsenlinien in einem Liniendiagramm ausblenden möchten, geben Sie im cht-Parameter :nda nach dem Wert des Diagrammtyps an (Beispiel: cht=lc:nda).

Standardmäßig zeigen die obere und untere Achse keine Teilstriche der Werte an, die linke und rechte Achse dagegen schon. Sie können dieses Verhalten mithilfe des Parameters chxs ändern.

Syntax

chxt=
  <axis_1>
    ,...,
  <axis_n>

<axis>

Eine Achse, die im Diagramm angezeigt werden soll. Verfügbare Achsen sind:

• x: Untere X-Achse
• t – Obere x-Achse [von Google-o-Meter nicht unterstützt]
• y: linke Y-Achse
• r – Rechte Y-Achse [nicht von Google-o-Meter unterstützt]

Sie können mehrere Achsen desselben Typs angeben, z. B. cht=x,x,y. Dadurch werden unten im Diagramm zwei Sätze von x-Achsen gestapelt. Dies ist nützlich, wenn Sie benutzerdefinierte Labels entlang einer Achse mit numerischen Werten hinzufügen möchten (siehe Beispiel unten). Achsen werden von innen nach außen gezeichnet. Wenn Sie also x,x haben, bezieht sich das erste x auf die innerste Kopie, das nächste x auf die nächste nach außen gerichtete Kopie und so weiter.

 

Beispiele

Beschreibung	Beispiel
Dieses Beispiel zeigt ein Liniendiagramm mit einer x-Achse, einer y-Achse, einer oberen Achse (t) und einer rechten Achse (r). Da keine Labels angegeben sind, wird im Diagramm standardmäßig für alle Achsen ein Bereich von 0 bis 100 verwendet. Standardmäßig werden auf der oberen und unteren Achse keine Teilstriche der Labels angezeigt.	chxt=x,y,r,t
Sie können für jede Achse mehrere Gruppen von Labels angeben, indem Sie denselben Wert mehrmals angeben. Dieses Beispiel zeigt zwei Sets von x- und zwei Sets von y-Achsen. Dies ist nicht besonders nützlich, wenn nur die Standardachsenlabels verwendet werden, wie hier gezeigt. Mit dem Parameter chxl können Sie jedoch benutzerdefinierte Labels für jede Kopie jeder Achse angeben.	<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x125" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uXUc&chco=76A4FB&chls=2.0&chs=200x125&chs=200x125
Dieses Beispiel zeigt ein horizontales Balkendiagramm mit einer X-Achse, einer Y-Achse, einer oberen T-Achse und einer rechten R-Achse. Achsenbeschriftungen werden weggelassen. Daher zeigt die Chart API einen Bereich von 0 bis 100 für die X-Achse und die T-Achse an. Der Bereich für die Y-Achse und für die R-Achse wird durch die Anzahl der Balken bestimmt. In diesem Fall gibt es fünf Balken, sodass die Chart API einen Bereich von 0 bis 4 anzeigt. Das erste Label ist am unteren Rand des ersten Balkens zentriert, das zweite Label am unteren Rand des zweiten Balkens und so weiter.	chxt=x,y,r,t
Sie können Standardachsen in einem Liniendiagramm unterdrücken, indem Sie :nda nach dem Diagrammtyp angeben.	cht=lc:nda

Nach oben

Achsenbereich chxr

Mit dem Parameter „chxr“ können Sie den Wertebereich angeben, der auf jeder Achse einzeln angezeigt wird. Dadurch ändert sich nicht die Größe der Diagrammelemente, sondern nur die Größe der Achsenbeschriftungen. Wenn die Achsennummern die tatsächlichen Datenwerte beschreiben sollen, legen Sie für <start_val> und <end_val> den unteren bzw. den höchsten Wert des Datenformatbereichs fest. Weitere Informationen finden Sie unter Achsenskalierung.

Wenn Sie einen Bereich angeben möchten, müssen Sie eine Achse mit dem Parameter chxt sichtbar machen.

Verwenden Sie den Parameter chxl, um benutzerdefinierte Achsenwerte anzugeben.

Syntax

Trennen Sie Labelbereiche auf mehreren Achsen durch einen senkrechten Strich ( |) voneinander.

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>

<axis_index>.

Achse, auf die die Labels angewendet werden sollen. Dies ist ein nullbasierter Index für das durch chxt angegebene Achsenarray. In chxt=x,r,y wäre die R-Achse beispielsweise „1“.

<start_val>

Eine Zahl, die den unteren Wert für diese Achse definiert.

<end_val>

Eine Zahl, die den hohen Wert für diese Achse definiert.

<opt_step>

[Optional] Der Zählschritt zwischen den Teilstrichen auf der Achse. Es gibt keinen Standardwert für den Schritt. Der Schritt wird so berechnet, dass eine Reihe von Labels in engem Abstand angezeigt werden soll.

 

Beispiele

Beschreibung	Beispiel
Dieses Beispiel zeigt die linke und rechte Y-Achse (y und r) und eine X-Achse (x). Für jede Achse ist ein Bereich definiert. Da keine Labels oder Positionen angegeben sind, werden Werte aus dem angegebenen Bereich übernommen und sind in gleichmäßigen Abständen innerhalb dieses Bereichs verteilt. Im Liniendiagramm sind die Werte gleichmäßig entlang der x-Achse verteilt. Die Achsenrichtung für die r-Achse wird umgekehrt (Index 2), da der erste Wert (1000) größer als der letzte Wert (0) ist.	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
In diesem Beispiel werden Werte für die x-Achse angegeben. Die Achsenlabels sind gleichmäßig entlang der Achse verteilt. Für den Parameter <opt_step> wird ein Wert von fünf (5) angegeben.	chxt=x chxr=0,10,50,5

Nach oben

Benutzerdefinierte Achsenlabels chxl

Mit dem Parameter chxl können Sie auf jeder Achse benutzerdefinierte Labels der Stringachse angeben. Sie können beliebig viele Labels angeben. Wenn Sie eine Achse mithilfe des Parameters chxt anzeigen und keine benutzerdefinierten Labels angeben, werden die standardmäßigen numerischen Labels angewendet. Wenn Sie einen benutzerdefinierten numerischen Bereich angeben möchten, verwenden Sie stattdessen den Parameter chxr.

Um bestimmte Standorte entlang der Achse für Ihre Labels festzulegen, verwenden Sie den Parameter chxp.

Syntax

Geben Sie einen Parametersatz für jede Achse an, der Sie ein Label hinzufügen möchten. Trennen Sie mehrere Labelsätze durch einen senkrechten Strich (|).

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>

<axis_index>.

Achse, auf die Labels angewendet werden sollen. Dies ist ein Index im Parameter-Array chxt. Wenn Sie beispielsweise chxt=x,x,y,y haben, wäre Index 0 die erste X-Achse, 1 die zweite X-Achse.

<label_1>| ... |<label_n>

Ein oder mehrere Labels, die entlang dieser Achse platziert werden sollen. Dies kann String- oder Zahlenwerte sein. Strings müssen nicht in Anführungszeichen gesetzt werden. label_1 wird an der untersten Position auf der Achse angezeigt, label_n an der höchsten Position. Weitere Labels sind gleichmäßig verteilt. Leerzeichen werden mit einem Pluszeichen gekennzeichnet. In einem Label kann kein Zeilenumbruch angegeben werden. Trennen Sie Labels durch einen senkrechten Strich voneinander. Hinweis : Setzen Sie im Parameter chxl keinen senkrechten Strich nach dem letzten Label.

 

Beispiele

Beschreibung	Beispiel
In diesem Diagramm wird gezeigt, wie zwei Achsen benutzerdefinierte Labels hinzugefügt werden. Beachten Sie, dass die Werte gleichmäßig verteilt sind und der letzte chxl-Wert nicht mit einem senkrechten Strich endet.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
Dieses Beispiel umfasst Achsenlabels auf der linken und rechten Y-Achse (y und r). Es enthält auch zwei Wertesätze für die X-Achse (x). Sie können mithilfe von chxs auch Teilstriche auf der Y-Achse hinzufügen.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
Dieses Beispiel umfasst Achsenlabels auf der linken und rechten Y-Achse (y und r). Es enthält auch zwei Wertesätze für die X-Achse (x). Beachten Sie die leeren Labels für die untere X-Achse, die zum Abstand der Werte verwendet werden. In diesem Beispiel werden Standardwerte für die Achsenbeschriftungen auf der linken Y-Achse verwendet.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
Wenn Sie ein generisches Label hinzufügen möchten, um eine ganze Achse zu beschreiben (z. B. um eine Achse mit „Kosten“ und eine andere „Schüler/Student“ zu beschriften), verwenden Sie die Eigenschaft chxt, um auf jeder Seite eine zusätzliche Achse hinzuzufügen. Fügen Sie dann mit chxl auf jeder Seite ein einzelnes benutzerdefiniertes Label hinzu und chxp, um ihn in der Mitte der Achse zu platzieren.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

Nach oben

Achsenlabel-Positionen chxp

Sie können angeben, welche Achsenlabels angezeigt werden sollen. Dabei können Sie die Standardlabels oder benutzerdefinierte Labels verwenden, die mit chxl angegeben werden. Wenn Sie mit diesem Parameter keine genauen Positionen angeben, werden die Labels gleichmäßig verteilt und haben einen Standardschrittwert entlang der Achsen. Wenn Sie chxl nicht angeben, entsprechen die Backticks-Labels den Standardwerten (in der Regel Datenwerte oder in Balkendiagrammen die Balkennummern).

Syntax

Trennen Sie mehrere Positionierungssätze durch einen senkrechten Strich (|).

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>

<axis_index>.

Die Achse, für die Sie Positionen festlegen. Dies ist ein Index im Parameter-Array chxt. Wenn Sie beispielsweise chxt=x,x,y,y haben, wäre Index 0 die erste X-Achse, 1 die zweite X-Achse und so weiter.

<label_1_position>,...,<label_n_position>

Die Position des Labels entlang der Achse. Dies ist eine durch Kommas getrennte Liste numerischer Werte, wobei jeder Wert die Position des entsprechenden Labels im Array chxl festlegt. Der erste Eintrag gilt für das erste Label usw. Die Position ist ein Wert im Bereich für diese Achse. Dieser Wert liegt immer zwischen 0 und 100, es sei denn, Sie haben mit chxr einen benutzerdefinierten Bereich angegeben. Sie müssen genauso viele Positionen haben wie Labels für diese Achse.

 

Beispiele

Beschreibung	Beispiel
Dieses Beispiel enthält Labels der R-Achsen an bestimmten Positionen im Diagramm. Der Labeltext wird mithilfe des Parameters chxl angegeben. Labels mit der angegebenen Position 0 werden unten auf der Y- oder R-Achse bzw. links von der X- oder T-Achse platziert. Labels mit der angegebenen Position 100 werden oben auf der Y- oder R-Achse oder rechts von der X- oder T-Achse platziert.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
In diesem Beispiel wird gezeigt, wie die Standardlabelwerte angezeigt werden, allerdings nur an bestimmten Positionen. chxp=1,10,35,75: Auf der Y-Achse sollten nur drei Labels angezeigt werden: 10, 35 und 75. Da kein Text für das benutzerdefinierte Label angegeben ist, werden diese Achsenwerte angezeigt. Wenn Sie chxp verwenden, müssen Sie Labels nicht gleichmäßig verteilen. Wäre chxp hier nicht angegeben, würde der Standard-Labelwertabstand auf der Y-Achse alle 20 Einheiten betragen, wie im zweiten Diagramm gezeigt.	chxt=x,y chxp=1,10,35,75 chxt=x,y chxp nicht angegeben

Nach oben

Achsenlabel-Stile chxs

Sie können die Schriftgröße, -farbe und -ausrichtung für Achsenlabels angeben, sowohl für benutzerdefinierte Labels als auch für Standardlabelwerte. Alle Labels auf derselben Achse haben das gleiche Format. Wenn Sie mehrere Kopien einer Achse haben, können Sie jede davon unterschiedlich formatieren. Sie können auch das Format eines Labelstrings angeben, um beispielsweise Währungssymbole oder nachgestellte Nullen anzuzeigen.

Standardmäßig zeigen die obere und untere Achse keine Teilstriche der Werte an, während die linke und rechte Achse bereits zeigen.

Syntax

Werte für mehrere Achsen sollten durch ein Pipe-Zeichen (|) getrennt werden.

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>

<axis_index>.

Die Achse, auf die dies zutrifft. Dabei handelt es sich um einen nullbasierten Index für den Parameter chxt.

<opt_format_string>

[Optional] Dies ist ein optionaler Formatstring, der bei Verwendung direkt nach der Achsenindexnummer ohne Komma folgt. Er beginnt mit einem Literalbuchstaben N, gefolgt von den folgenden optionalen Werten: Die Syntax des Formatierungsstrings sieht so aus:
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
Die einzelnen Elemente haben folgende Bedeutung:

• <preceding_text>: Literaltext, der jedem Wert vorangestellt wird.
• *...*: Ein optionaler Block, der in buchstäbliche Sternchen eingebettet ist, in dem Sie Formatierungsdetails für Zahlen angeben können. Die folgenden Werte werden unterstützt und sind alle optional:
  • <number_type>: Das Zahlenformat für numerische Werte. Wählen Sie eine der folgenden Optionen aus:
    • f: [Standard] Gleitkommaformat. Sie sollten auch die Genauigkeit mit dem Wert <decimal_places> angeben.
    • p – Prozentsatzformat. Es wird automatisch ein %-Zeichen angehängt. Hinweis:Bei diesem Format werden Datenwerte von 0,0 bis 1,0 zwischen 0 und 100 % zugeordnet. (0,43 wird beispielsweise als 43 % angezeigt).
    • e: Format der wissenschaftlichen Schreibweise.
    • c<CUR>: Die Zahl in der angegebenen Währung mit der entsprechenden Währungsmarkierung formatieren. Ersetzen Sie <CUR> durch einen aus drei Buchstaben bestehenden Währungscode. Beispiel: cEUR für Euro. Eine Liste der Codes findest du auf der ISO-Website. Allerdings werden nicht alle Symbole unterstützt.
  • <decimal_places>: Eine Ganzzahl, die angibt, wie viele Dezimalstellen angezeigt werden sollen. Der Wert wird auf diese Länge gerundet (nicht gekürzt). Der Standardwert ist 2.
  • z: Nachgestellte Nullen werden angezeigt. Der Standardwert ist „Nein“.
  • s – Trennzeichen für Gruppen anzeigen. Der Standardwert ist „Nein“.
  • x oder y: zeigt die Daten aus der X- oder Y-Koordinate an. Die Bedeutung von x-Daten variiert je nach Diagrammtyp: Experimentieren Sie mit dem Diagramm, um herauszufinden, was es bedeutet. Der Standardwert ist „y“.
• <following_text> – Literaltext, der auf jeden Wert folgt.

<opt_label_color>

Die Farbe, die auf den Achsentext (aber nicht auf die Achsenlinie) angewendet werden soll, im Hexadezimalformat RRGGBB. Die Farbe der Achsenlinie wird separat mit opt_axis_color angegeben. Die Standardeinstellung ist Grau.

<opt_font_size>

[Optional] gibt die Schriftgröße in Pixeln an. Der Parameter ist optional.

<opt_alignment>

[Optional] Labelausrichtung. Für die obere oder untere Achse beschreibt dies, wie das Label an der darüber oder darunterliegenden Teilstriche ausgerichtet wird. Für die linke oder rechte Achse beschreibt dies, wie das Label innerhalb des Begrenzungsrahmens ausgerichtet wird, der die Achse berührt. Geben Sie eine der folgenden Zahlen an:

• -1 – Oben oder unten: Labels befinden sich rechts neben den Zwischenstrichen. Links oder rechts: Labels werden in ihrem Bereich linksbündig ausgerichtet. Standardeinstellung für Labels der R-Achse.
• 0 – Oben oder unten: Labels werden mittig auf den Zwischenstrichen angezeigt. Links oder rechts: Labels werden in ihrem Bereich zentriert. Standardeinstellung für Labels der X- und T-Achse.
• 1 – Oben oder unten: Labels befinden sich links neben den Teilstrichen; Links oder rechts: Die Labels werden in ihrem Bereich rechtsbündig ausgerichtet. Standardeinstellung für Labels der Y-Achse.

<opt_axis_or_tick>

[Optional; not supported in Google-o-meter] Gibt an, ob Teilstriche und/oder Achsenlinien für diese Achse angezeigt werden sollen. Teilstriche und Achsenlinien sind nur für die innersten Achsen verfügbar. Sie werden beispielsweise nicht für die äußere von zwei x-Achsen unterstützt. Verwenden Sie einen der folgenden Werte:

• l (kleingeschriebenes L): Nur Achsenlinie zeichnen.
• t: Nur Teilstriche zeichnen. Backticks sind die kleinen Linien neben den Achsenbeschriftungen.
• lt: [Standard] Zeichnen Sie sowohl eine Achsenlinie als auch Teilstriche für alle Labels.
• _: (Unterstrich) Weder Achsenlinie noch Teilstriche zeichnen. Verwenden Sie diesen Wert, wenn Sie eine Achsenlinie ausblenden möchten.

<tick_color>

[Optional; not supported in Google-o-meter] Die Farbe des Häkchens im Hexadezimalformat RRGGBB. Die Standardeinstellung ist Grau.

<opt_axis_color>

[Optional] Die Farbe dieser Achsenlinie im Hexadezimalformat RRGGBB. Die Standardeinstellung ist Grau.

 

Beispiele

Beschreibung	Beispiel
Schriftgröße und -farbe werden für die zweite X-Achse (Januar, Februar, März) angegeben.	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar|      1:|min|average|max chxp=1,10,35,75 chxs=3,0000DD,13,0,t
Schriftgröße, -farbe und -ausrichtung werden für die rechte Y-Achse angegeben. Teilstriche, aber keine Achsenlinie werden gezeichnet.	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar|      2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
Dieses Diagramm enthält drei Datasets und drei Sätze von Achsenbeschriftungen, eines pro Reihe. Jeder Satz von Labels wird mit einem benutzerdefinierten Formatierungsstring formatiert, wie hier beschrieben: 0N*e,000000| 0 steht für die erste Datenreihe N steht für einen Formatierungsstring. * steht für den Anfang der Formatspezifizierer. e steht für die wissenschaftliche Schreibweise * steht für das Ende der Formatspezifizierer. 000000 steht für schwarzen Text. 1N*cUSD*Mil,FF0000| 1 steht für die zweite Reihe N steht für einen Formatierungsstring. * steht für den Anfang der Formatspezifizierer. c steht für eine Währungsmarkierung. USD gibt US-Dollar als Währungsmarkierung an. * steht für das Ende der Formatspezifizierer. Mil ist ein literaler String FF0000 bedeutet roter Text. 2N*sz2*,0000FF 2 steht für die dritte Reihe N steht für einen Formatierungsstring. * steht für den Anfang der Formatspezifizierer. s bedeutet, dass Gruppierungsspezifizierer angezeigt werden (im US-Englisch, also ein Komma alle drei Nullen). z2 bedeutet, dass zwei nachgestellte Nullen angezeigt werden 0000FF steht für blauer Text. Die Bereiche für Achsenlabels werden mit dem Parameter chxr (axis_index, start, end, step) festgelegt. Wenn sie nicht konfiguriert ist, liegen sie standardmäßig zwischen 0 und 100.	chd=s:   984sttvuvkQIBLKNCAIi,   DEJPgq0uov17zwopQODS,   AFLPTXaflptx159gsDrn chxr=   0,0,1000000,250000|   1,0,60|   2,0,5000 chxs=   0N*e,000000|   1N*cUSD*Mil,FF0000|   2N*sz2*,0000FF

Nach oben

Stile für Teilstriche der Achse chxtc

Für bestimmte Achsen können Sie lange Teilstriche angeben. In der Regel wird dies verwendet, um eine Markierung über die Länge eines Diagramms zu verlängern. Verwenden Sie den Parameter chxs, um die Farbe der Teilstriche zu ändern.

Werte für mehrere Achsen sollten durch ein Pipe-Zeichen (|) getrennt werden. Werte innerhalb einer Reihe sollten durch ein Komma getrennt werden.

Syntax

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>

<axis_index>.

Die Achse, auf die dies zutrifft. Dabei handelt es sich um einen nullbasierten Index im chxt-Parameter. Trennen Sie Werte für verschiedene Achsen mithilfe eines Balkentrennzeichens.

<tick_length_1>,...,<tick_length_n>

Länge der Teilstriche auf dieser Achse in Pixeln. Wenn ein einzelner Wert angegeben wird, gilt er für alle Werte. Wenn mehr als ein Wert angegeben ist, blättern die Teilstriche der Achse durch die Liste der Werte für diese Achse. Positive Werte werden außerhalb des Diagrammbereichs gezeichnet und durch die Diagrammränder abgeschnitten. Der maximal zulässige positive Wert ist 25. Negative Werte werden innerhalb des Diagrammbereichs gezeichnet und durch die Ränder des Diagrammbereichs zugeschnitten.

 

Beispiele

Beschreibung	Beispiel
Beispiel für die Verwendung von chxtc zum Erstellen langer roter Teilstriche. Die Länge der Teilstriche überschreitet die Breite des Diagrammbereichs, wird aber so zugeschnitten, dass sie in das Diagramm passt. chxt=x,y,r,x: zeigt eine linke Achse, eine rechte Achse und zwei untere Achsen an. chxl=2:|min|average|max|3:|Jan|Feb|Mar: Der Labeltext, der dem „r“ (rechte Seite) und den äußeren x-Achsen zugewiesen ist. chxp=2,10,35,95: Positionen der benutzerdefinierten Labels entlang der R-Achse (Index=2) für die drei Labels chxs=2,0000dd,13,-1,t,FF0000: Achsenlabel-Stile für die R-Achse: Textfarbe, Textgröße, linksbündig, mit roten Teilstrichen. chxtc=1,10|2,-180: Die Teilstrichlänge der Achse für die Y- und R-Achse. Der erste Wert gibt 10 Pixel lange Teilstriche außerhalb der Achse an. Der zweite Wert gibt 180 Pixel lange Teilstriche innerhalb der Achse an. Die negative Zahl bedeutet, dass der Teilstrich innerhalb der Achse verläuft und der Teilstrich so zugeschnitten wird, dass er in das Diagramm passt.	chxt=x,y,r,x chxl=   2:|min|average|max|   3:|Jan|Feb|Mar chxp=2,10,35,95 chxs=   2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
Dieses Diagramm zeigt abwechselnde Ticklängen. chxtc gibt zwei Werte für die Teilstrichlänge für die Y-Achse an (5 und 15). Die im Diagramm gezeichneten Teilstriche wechseln zwischen den beiden Werten.	chxt=x,y chxtc=   1,5,15

Nach oben

Hintergrundfüllungen chf [alle Diagramme]

Sie können Füllfarben und -stile für den Datenbereich des Diagramms und/oder den gesamten Diagrammhintergrund angeben. Zu den Fülltypen gehören durchgehende Füllungen, gestreifte Füllungen und Farbverläufe. Sie können unterschiedliche Füllungen für verschiedene Bereiche angeben, z. B. den gesamten Diagrammbereich oder nur den Datenbereich. Die Füllung des Diagrammbereichs überschreibt die Hintergrundfüllung. Alle Füllungen werden mit dem Parameter chf angegeben. Sie können verschiedene Fülltypen (Festkörper, Streifen, Farbverläufe) im selben Diagramm mischen, indem Sie die Werte durch ein Pipe-Zeichen ( | ) trennen. Diagrammflächenfüllungen überschreiben Füllungen im Diagrammhintergrund.

Durchgängige Füllungen chf [alle Diagramme]

Sie können eine durchgehende Füllung für den Hintergrund und/oder den Diagrammbereich angeben oder dem gesamten Diagramm einen Transparenzwert zuweisen. Mit dem senkrechten Strich (|) können Sie mehrere Füllungen angeben (Maps: nur Hintergrund).

Syntax

chf=<fill_type>,s,<color>|...

<fill_type>

Der Teil des Diagramms, der ausgefüllt wird. Geben Sie einen der folgenden Werte an:

• bg – Hintergrundfüllung
• c: Flächenfüllung des Diagramms. Diese Option wird für Kartendiagramme nicht unterstützt.
• a: Das gesamte Diagramm einschließlich der Hintergründe transparent machen. Die ersten sechs Ziffern von <color> werden ignoriert und nur die letzten beiden (der Transparenzwert) werden auf das gesamte Diagramm und alle Füllungen angewendet.
• b<index>: ausgefüllte Balken (nur Balkendiagramme) Ersetzen Sie <index> durch den Reihenindex der Balken, die mit einer Volltonfarbe gefüllt werden sollen. Der Effekt ähnelt der Angabe von chco in einem Balkendiagramm. Ein Beispiel finden Sie unter Farben für Balkendiagrammreihen.

s

Gibt eine durchgehende Füllung oder eine transparente Füllung an.

<color>

Die Füllfarbe im Hexadezimalformat RRGGBB. Bei Transparenzen werden die ersten sechs Ziffern ignoriert, müssen aber trotzdem angegeben werden.

 

Beispiele

Beschreibung	Beispiel
In diesem Beispiel wird der Diagrammhintergrund mit einem hellen Grau gefüllt (EFEFEF).	chf=bg,s,EFEFEF
In diesem Beispiel wird der Diagrammhintergrund mit einem hellen Grau (EFEFEF) gefüllt und der Diagrammbereich schwarz (000000).	chf=c,s,000000| bg,s,EFEFEF
In diesem Beispiel wird eine Transparenz von 50% auf das gesamte Diagramm angewendet (80 im hexadezimalen Wert entspricht 128 oder etwa 50% Transparenz). Beachten Sie, dass der Hintergrund der Tabellenzelle durch das Diagramm durchscheint.	chf=a,s,00000080

Nach oben

Farbverlaufsfüllung chf [Linie, Balken, Google-O-Meter, Radar, Streu,Venn]

Sie können eine oder mehrere Farbverlaufsfüllungen auf Diagrammbereiche oder Hintergründe anwenden. Farbverlaufsfüllungen sind Übergänge von einer Farbe in eine andere. (Kreisdiagramm, Google-Meter-Diagramme: nur im Hintergrund.)

Mit jeder Farbverlaufsfüllung wird ein Winkel gefolgt von zwei oder mehr Farben angegeben, die an einem bestimmten Ort verankert sind. Die Farbe variiert, wenn sie sich von einem Anker zum anderen bewegt. Es müssen mindestens zwei Farben mit unterschiedlichen <color_centerpoint>-Werten vorhanden sein, damit eine übergangen werden kann. Jeder zusätzliche Farbverlauf wird durch ein <color>,<color_centerpoint>-Paar angegeben.

Syntax

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>

<fill_type>

Der Diagrammbereich, der ausgefüllt werden soll. Einen der folgenden Werte:

• bg – Hintergrundfüllung
• c: Flächenfüllung des Diagramms.
• b<index>: Farbverlaufsfüllungen (nur Balkendiagramme). Ersetzen Sie <index> durch den Reihenindex der Balken, die mit einem Farbverlauf gefüllt werden sollen. Ein Beispiel finden Sie unter Farben für Balkendiagrammreihen.

lg

Gibt eine Farbverlaufsfüllung an.

<Winkel>

Eine Zahl, die den Winkel des Farbverlaufs von 0 (horizontal) bis 90 (vertikal) angibt.

<color>

Die Farbe der Füllung im Hexadezimalformat RRGGBB.

<color_centerpoint>

Gibt den Ankerpunkt für die Farbe an. Die Farbe beginnt an diesem Punkt zu verblassen, wenn sie sich einem anderen Anker nähert. Der Wertebereich liegt zwischen 0,0 (unterer oder linker Rand) und 1,0 (oberer oder rechten Rand), geneigt im durch <angle> angegebenen Winkel.

 

Beispiele

Beschreibung	Beispiel
Der Diagrammbereich hat einen horizontalen linearen Farbverlauf, der mit einem Winkel von null Grad (0) angegeben wurde. Die Farben sind pfirsichfarben (FFE7C6), mittig auf der linken Seite (Position 0.0) und Blau (76A4FB) mittig auf der rechten Seite (Position 1.0). Der Diagrammhintergrund ist grau gezeichnet (EFEFEF).	chf=   c,lg,0,   FFE7C6,0,(Pfirsich)   76A4FB,1 (Blau)
Der Diagrammbereich hat einen diagonalen linearen Farbverlauf von unten links nach oben rechts, der mit einem Winkel von fünfundvierzig Grad (45) angegeben wurde. Pfirsich (FFE7C6) ist die erste angegebene Farbe. Links unten im Diagramm ist die Farbe pfirsichfarben. Blau (6A4FB) ist die zweite angegebene Farbe. Oben rechts im Diagramm ist ein reines Blau. Wie Sie sehen, legen wir einen Versatz von 0,75 fest, um einen Blaupunkt zu erhalten, der in Richtung der oberen rechten Ecke abfällt. Der Diagrammhintergrund ist grau gezeichnet (EFEFEF).	chf=   c,lg,45,   FFE7C6,0, (Pfirsich)   76A4FB,0.75 (Blau)
Der Diagrammbereich hat einen vertikalen linearen Farbverlauf (von oben nach unten), der mit einem Winkel von neunzig Grad (90) angegeben wurde. Blau (76A4FB) ist die erste angegebene Farbe. Der obere Bereich des Diagramms ist rein blau. Pfirsich (FFE7C6) ist die zweite angegebene Farbe. Am unteren Rand des Diagramms steht reines Pfirsich. Der Diagrammhintergrund ist grau gezeichnet (EFEFEF).	chf=   c,lg,90,   FFE7C6,0, (Pfirsich)   76A4FB,0.5 (Blau)

Nach oben

 

Gestreifte Füllungen chf [Linie, Bar, Google-O-Meter, Radar, Streu, Venn]

Sie können eine gestreifte Hintergrundfüllung für den Diagrammbereich oder für das gesamte Diagramm festlegen. (Kreisdiagramme, Google-Meter-Diagramme: nur im Hintergrund.)

Syntax

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>

<fill_type>

Der Diagrammbereich, der ausgefüllt werden soll. Einen der folgenden Werte:

• bg – Hintergrundfüllung
• c – Diagrammbereich
• b<index>: gestreifte Füllungen mit Balken (nur Balkendiagramme). Ersetzen Sie <index> durch den Reihenindex der Balken, die mit Streifen zu füllen sind. Ein Beispiel finden Sie unter Farben für Balkendiagrammreihen.

ls

Gibt eine lineare Streifenfüllung an.

<Winkel>

Der Winkel aller Streifen relativ zur Y-Achse. Verwende 0 für vertikale Streifen oder 90 für horizontale Streifen.

<color>

Die Farbe des Streifens im Hexadezimalformat RRGGBB. Wiederholen Sie für jeden weiteren Streifen <color> und <width>. Du musst mindestens zwei Streifen haben. Die Streifen wechseln, bis das Diagramm gefüllt ist.

<width>

Die Breite dieses Streifens von 0 bis 1, wobei 1 die volle Breite des Diagramms ist. Die Streifen werden so lange wiederholt, bis das Diagramm gefüllt ist. Wiederhole <color> und <width> für jeden weiteren Streifen. Du musst mindestens zwei Streifen haben. Die Streifen wechseln, bis das Diagramm gefüllt ist.

 

Beispiele

Beschreibung	Beispiel
bg,ls,0: Streifenfüllung im Hintergrund mit Streifen in einem Winkel von 0 Grad zur Y-Achse (parallel zur Y-Achse). Die Streifen füllen den Diagrammhintergrund und den Diagrammbereich aus. CCCCCC,0.15: Der erste Streifen ist dunkelgrau, 15% so breit wie das Diagramm. FFFFFF,0.1: Der zweite Streifen ist weiß und 10% so breit wie das Diagramm.	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90: Diagrammbereich mit horizontalen Streifen in einem Winkel von neunzig Grad zur Y-Achse. Die Streifen füllen den Diagrammbereich, aber der Diagrammhintergrund wird weggelassen. 999999,0.25: Der erste Streifen ist dunkelgrau, 25% so breit wie das Diagramm. CCCCCC,0.25: Wie der erste Streifen, aber ein helles Grau. FFFFFF,0.25: Wie der erste Streifen, aber weiß.	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

Nach oben

Datenfunktionen chfd [alle chd Diagramme]

Sie können eine benutzerdefinierte Funktion angeben, die mit der muParser-Funktionssyntax für Diagrammdaten ausgeführt werden soll. Die in der Funktion verwendeten Daten können aus einer von zwei Quellen stammen:

• Datenreihe aus chd: Die Daten werden aus der angegebenen Reihe in chd abgerufen.
• Ein Wertebereich, der im Parameter chfd selbst deklariert ist: Sie legen einen Start-, Stopp- und Schrittwert für einen beliebigen Datenbereich fest.

Beachten Sie, dass Sie die Ausgabe in jedem Fall einer vorhandenen Reihe in chd zuweisen müssen. Diese Reihe wird dann von der Funktionsausgabe überschrieben. Das Diagramm wird erst gerendert, nachdem alle Funktionen verarbeitet wurden. Wenn Sie also mehrere Funktionen für die Ausgabe derselben Datenreihe zuweisen, werden die Funktionen in der angegebenen Reihenfolge ausgeführt, aber nur die Ausgabe der endgültigen Funktion wird im Diagramm dargestellt. Beachten Sie, dass Sie Funktionen verketten können, sodass eine Funktion als Eingabe eine Reihe annehmen kann, die von einer vorherigen Funktion ausgegeben wurde.

Wenn Sie einer Funktionszeile Farben oder chm-Markierungen zuweisen möchten, weisen Sie die Farben oder Markierungen dem Reihenindex der Funktion zu. Markierungen werden gemäß den Daten platziert, nachdem sie durch die Funktion geändert wurden.

Syntax

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>

<output_series_index>

Nullbasierter Index einer Datenreihe in chd, in die die Funktionsausgabe geschrieben wird. Alle vorhandenen Daten werden von der Funktionsausgabe vollständig überschrieben. Wenn eine Reihe nicht als Eingabe für eine Funktion verwendet wird, empfiehlt es sich, dieser Reihe einen einzelnen Dummy-Wert zuzuweisen.

<function_data>

Die Variablen und Daten, die dargestellt werden sollen. Die Daten können aus einem von Ihnen definierten Bereich oder aus einer der chd-Datenreihen stammen. Sie können für jede Funktion mehrere Variablen angeben, indem Sie für mehrere Variablen ein Semikolon (;) verwenden. Wenn Sie mehrere Variablen für eine einzelne Funktion definieren und diese Variablen eine unterschiedliche Anzahl von Punkten haben, wird die Funktion beendet, wenn sie den ersten Endpunkt erreicht. Wenn eine Funktion beispielsweise x=1–5 Schritt 1 und y=1–10 Schritt 1 definiert, endet die Funktion, wenn sie den fünften Punkt erreicht.
    <variable_name>,<input_series_index>
         ODER
    <variable_name>,<start>,<end>,<step>

• variable_name – Beliebiger Stringname für die Variable. Verwenden Sie diesen in der durch function_string definierten Funktion.
• input_series_index – Der Index einer chd-Datenreihe, die als Eingabedaten verwendet werden soll.
• start – numerischer Startwert eines Bereichs.
• end: Numerischer Endwert eines Bereichs.
• step – numerischer Schrittwert von start bis end Kann positiv oder negativ sein, darf aber nicht null sein.

Beispiele : x,0,100,1 deklariert eine Variable namens x mit den Werten 0, 1, 2, ... 100. x,0,100,1;r,0,3.1,.1 deklariert dieselbe Variable x plus eine Variable namens r mit den Werten 0, 0,1, 0,2, ..., 3,0, 3,1. x,0 deklariert eine Variable mit dem Namen „x“, die die Daten aus der ersten chd-Reihe verwendet. Diese Variablen werden von function_string verwendet. Sie werden nur dann in der Grafik dargestellt, wenn Sie sie in function_string angeben. Je kleiner der Schritt, desto flüssiger wird das Diagramm.

<function_string>

Ihre Funktion, geschrieben in der muParser-Syntax. Die Funktion wird auf die in variable_data angegebenen Variablen und Daten angewendet. Sie können nur auf die Variablen verweisen, die in diesem lokalen Funktionssatz deklariert sind, nicht in einem anderen Satz von chfd-Parametern. muParser-Zusammenfassungsfunktionen (Min., Max., Summe, Durchschn.) werden nicht unterstützt. WICHTIG: Denken Sie daran, in Ihren Funktionen %2B anstelle von + zu verwenden.

 

Beispiele

Beschreibung	Beispiel
Eine einfache Sinuswelle. Beachten Sie Folgendes: chd=t:-1: Für die Diagrammdaten wird eine Dummy-Variable verwendet, da unsere Daten im chfd-Parameter deklariert sind. chco=FF0000: Die erste Serie wird rot angegeben. Auch wenn wir die Daten aus chd nicht verwenden, wird für die dargestellte Funktion die entsprechende Farbe der Reihe verwendet. chfd=0,x,0,11,0.1,sin(x)*50%2B50: Wir deklarieren eine Variable namens x mit den Werten 0–11, inkrementiert um 0,1. Sie ist der ersten Reihe zugewiesen, d. h., sie erhält die Farbe der ersten Reihe (FF0000). Die auf x angewendete Funktion lautet sin(x) * 50 + 50. Wie Sie sehen, muss das + in dieser Funktion codiert werden.	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
In dieser Zeile werden Daten aus dem Parameter chd verwendet.	chd=t:5,10 chfd=0,x,0,x*4
Eine Mischung aus Funktions- und Nichtfunktionslinien. Beachten Sie, wie die Farben durch den Farbparameter chco für die Reihe angegeben werden. Beachten Sie die Position der Markierungen in der Funktionsausgabe. Die Datenpunkte werden ab start, end und step berechnet. Wenn Ihr Bereich also 0–11 Schritt 0.1 ist, Punkt 0 ist 0, Punkt 1 ist 0,1 und so weiter, bis Punkt 110, der den Wert 11 hat.	chd=t:   -1   15,45 chco=   FF0000,000000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chm=   c,00A5C6,0,110,10   a,00A5C6,0,60,10
Wenn Sie eine Funktion in zwei Dimensionen definieren möchten, verwenden Sie ein lxy-Diagramm, weisen Sie zwei Dummy-Serien zu und weisen Sie jeder eine Funktion zu. 0,x,0,10,0.1,sin(x)*50%2B50 – Reihe 0 (Werte der x-Achse) hat eine Variable namens x mit Werten von 0–10, Schritt 0.1 und die Funktion sin(x)*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 – Reihe 0 (die Werte der Y-Achse) hat eine Variable namens y mit Werten von 0–10, Schritt 0.1 und die Funktion sin(x)*50 + 50	cht=lxy chd=t:-1|-1 chfd=   0,x,0,10,0.1,sin(x)*50%2B50|   1,y,0,10,0.1,cos(y)*50%2B50
Mit dem Parameter chfd können Sie Ihrer Kreativität Ausdruck verleihen. Klicken Sie auf diese Bilder, um sie zu öffnen, und spielen Sie mit ihnen im Chart-Playground. Sie werden fesselt!

Nach oben