Zeitreihen-Diagramme

Image-Charts has no date axis. A time series is an ordinary line chart. You send the values in chronological order with chd, then write the x-axis labels yourself with chxl. Nothing in the API parses a date, so the labels are plain text and the points are always spaced evenly.

Wie stellt man eine Zeitreihe dar?

Vier Parameter genügen: der Diagrammtyp, die Werte, die Achsen, die gezeichnet werden sollen, und die Beschriftungen, die darunter stehen.

  1. Set cht=lc for a line chart.
  2. Send the values with chd=a:, oldest first. The a: format takes floating point numbers with no upper bound and scales the axis for you.
  3. Turn on the axes with chxt, where x names the bottom axis and y the left one. Most time series use chxt=x,y.
  4. Write the labels with chxl=0:|Jan|Feb|…, where 0 is the position of that axis in your chxt list.

https://image-charts.com/chart?cht=lc&chd=a:31,42,38,55,61,58,72,80,76,91,88,103&chs=700x300&chxt=x,y&chxl=0:%7CJan%7CFeb%7CMar%7CApr%7CMay%7CJun%7CJul%7CAug%7CSep%7COct%7CNov%7CDec&chls=3&chco=1F3B99&chg=1,1&chtt=Signups+per+month

Liniendiagramm mit zwölf Monatswerten, bei dem jeder Monat unter der x-Achse benannt ist
Zwölf Werte und zwölf Beschriftungen. Die Reihenfolge der Beschriftungen folgt der Reihenfolge der Werte, und die API rechnet selbst nicht mit Datumsangaben.

Weniger Beschriftungen als Datenpunkte

Zwölf Beschriftungen unter zwölf Punkten sind in Diagrammgröße oft zu viele zum Lesen. Geben Sie der Achse weniger Beschriftungen, und Image-Charts verteilt sie und füllt die Lücken mit leeren Beschriftungen auf, damit die erste und die letzte an den Enden der Achse bleiben.

Vier Quartalsbeschriftungen über denselben zwölf Monatspunkten ergeben Q1, drei Leerstellen, Q2, drei Leerstellen, Q3, zwei Leerstellen, Q4. Sie schreiben vier Beschriftungen, und die Achse bleibt an den Daten ausgerichtet.

https://image-charts.com/chart?cht=lc&chd=a:31,42,38,55,61,58,72,80,76,91,88,103&chs=700x300&chxt=x,y&chxl=0:%7CQ1%7CQ2%7CQ3%7CQ4&chls=3&chco=1F3B99&chg=1,1&chtt=Signups+per+month

Dieselben zwölf Monatswerte, beschriftet mit vier Quartalsmarken, die über die x-Achse verteilt sind
Die Daten sind unverändert. Nur die vier Beschriftungen ersetzen die zwölf, und der Abstand wird aus der Länge der längsten Datenreihe berechnet.

Eine Achse benennen statt ihrer Teilstriche

Eine Achse mit genau einer Beschriftung verwendet diese als Namen der Achse statt als Teilstrich-Beschriftung. chxl=1:|Signups schreibt Signups neben die zweite Achse der Liste, statt es neben einen einzelnen Teilstrich zu setzen. Fügen Sie einen zweiten Eintrag für dieselbe Achse hinzu, und beide werden wieder zu Teilstrich-Beschriftungen.

https://image-charts.com/chart?cht=lc&chd=a:31,42,38,55,61,58,72,80,76,91,88,103&chs=700x300&chxt=x,y&chxl=0:%7CQ1%7CQ2%7CQ3%7CQ4%7C1:%7CSignups&chls=3&chco=1F3B99&chg=1,1

Liniendiagramm mit Quartalsbeschriftungen auf der x-Achse und dem Wort Signups als Name der y-Achse
Ein einziger chxl Wert deckt beide Achsen ab, vier Beschriftungen für Achse 0 und einen einzelnen Namen für Achse 1.

Lücken in einer Datenreihe

Ein Unterstrich anstelle eines Wertes markiert diesen Punkt als fehlend, sodass chd=a:31,42,_,55 eine Lücke in der Linie lässt, statt sie bis auf null durchzuziehen. Das ist bei einer Zeitreihe wichtiger als anderswo, denn ein Monat ohne Messung ist kein Monat mit dem Wert null.

https://image-charts.com/chart?cht=lc&chd=a:31,42,_,55,61,58,72,80&chs=700x260&chxt=x,y&chls=3&chco=1F3B99&chg=1,1&chtt=A+month+with+no+data

Liniendiagramm, bei dem der dritte Punkt fehlt und eine sichtbare Unterbrechung in der Linie hinterlässt
Die Unterbrechung liegt zwischen dem zweiten und dem vierten Punkt. Ein leerer Wert zwischen zwei Kommas bewirkt dasselbe wie der Unterstrich.

Die Werteachse festlegen

Standardmäßig passt sich die Werteachse an die Daten an, sodass dieselbe URL im Abstand eines Monats gerendert ihre Zahlen anders einrahmen kann. chxr=<axis_index>,<start>,<end> legt sie stattdessen fest, und eine vierte Zahl bestimmt den Abstand zwischen den Teilstrichen. chxr=1,0,120,20 führt die zweite Achse von 0 bis 120 in Schritten von 20.

Wenn Sie den Bereich rückwärts schreiben, wie in chxr=1,120,0, dreht das die Achse um, was Sie für einen Rang oder eine Platzierung wollen, bei der die 1 oben stehen soll.

https://image-charts.com/chart?cht=lc&chd=a:31,42,38,55,61,58,72,80,76,91,88,103&chs=700x300&chxt=x,y&chxr=1,0,120,20&chxl=0:%7CQ1%7CQ2%7CQ3%7CQ4&chls=3&chco=1F3B99&chg=0,1

Liniendiagramm, dessen y-Achse von null bis einhundertzwanzig in Zwanzigerschritten verläuft
Die Achse beginnt jetzt bei null und endet bei einer runden Zahl, sodass dieselbe URL im nächsten Monat die Daten immer noch gleich einrahmt.

Gitternetzlinien

chg zeichnet das Gitternetz. Die ersten beiden Zahlen sind die Schrittweiten für x und y, die dritte und die vierte sind eine Strichlänge und eine Lückenlänge, wie in chg=1,1,4,3.

Die beiden Schrittweiten wirken als Schalter, nicht als Abstände. Jeder Wert über 0 und unter 100 schaltet dieses Gitternetz ein, und Image-Charts zeichnet die Linien an den Teilstrichen, die es bereits ermittelt hat. chg=1,1 und chg=20,20 erzeugen dasselbe Gitternetz. Setzt man eine der beiden auf 0, bleibt diese Hälfte des Gitternetzes aus, weshalb chg=0,1 nur waagerechte Linien ergibt.

https://image-charts.com/chart?cht=lc&chd=a:31,42,38,55,61,58,72,80,76,91,88,103&chs=700x300&chxt=x,y&chg=1,1,4,3&chxl=0:%7CQ1%7CQ2%7CQ3%7CQ4&chls=3&chco=1F3B99

Liniendiagramm mit gestricheltem Gitternetz auf beiden Achsen
Beide Gitternetze an, gezeichnet als vier Pixel lange Striche mit drei Pixel großen Lücken. Ein gestricheltes Gitternetz bleibt hinter den Daten, statt mit ihnen zu konkurrieren.

chl ist kein Achsenparameter

Der Parameter, der eine Achse beschriftet, ist chxl. chl macht etwas anderes. In einem Balkendiagramm beschriftet es die Balken, in einem Kreisdiagramm die Segmente, und in einem Liniendiagramm lässt es die Achse unberührt. Wenn Sie Ihre Monate in chl schicken, ist der übliche Grund dafür, dass eine Zeitreihe mit einer nackten numerischen x-Achse zurückkommt. Die Referenzdokumentation beschreibt beide.

Eine Zeitreihe darstellen

Ein Diagramm erstellen