Tijdreeksgrafieken

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.

Hoe plot u een tijdreeks?

Vier parameters volstaan: het grafiektype, de waarden, de assen die u getekend wilt hebben en de labels die eronder komen.

  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

Lijngrafiek van twaalf maandwaarden met elke maand benoemd onder de x-as
Twaalf waarden en twaalf labels. De volgorde van de labels volgt de volgorde van de waarden, en de API doet zelf geen datumberekeningen.

Minder labels dan datapunten

Twaalf labels onder twaalf punten zijn op grafiekformaat vaak te veel om te lezen. Geef de as minder labels en Image-Charts verdeelt ze, met lege labels als opvulling zodat het eerste en het laatste aan de uiteinden van de as blijven staan.

Vier kwartaallabels over dezelfde twaalf maandpunten komen eruit als Q1, drie lege labels, Q2, drie lege labels, Q3, twee lege labels, Q4. U schrijft vier labels en de as blijft uitgelijnd met de gegevens.

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

Dezelfde twaalf maandwaarden, gelabeld met vier kwartaalmarkeringen verspreid over de x-as
De gegevens zijn ongewijzigd. Alleen de vier labels vervangen de twaalf, en de tussenruimte wordt berekend uit de lengte van de langste reeks.

Een as benoemen in plaats van de schaalstreepjes

Een as die precies één label krijgt, gebruikt dat als naam van de as in plaats van als schaallabel. chxl=1:|Signups schrijft Signups langs de tweede as in de lijst in plaats van het naast één schaalstreepje te zetten. Voeg een tweede item voor dezelfde as toe en beide worden weer schaallabels.

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

Lijngrafiek met kwartaallabels op de x-as en het woord Signups als naam van de y-as
Eén chxl waarde draagt beide assen, vier labels voor as 0 en één naam voor as 1.

Gaten in een reeks

Een underscore in plaats van een waarde markeert dat punt als ontbrekend, dus chd=a:31,42,_,55 laat een gat in de lijn in plaats van hem omlaag door nul te trekken. Dat is bij een tijdreeks belangrijker dan waar dan ook, want een maand zonder meting is niet een maand met waarde nul.

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

Lijngrafiek waarin het derde punt ontbreekt, met een zichtbare onderbreking in de lijn
De onderbreking zit tussen het tweede en het vierde punt. Een lege waarde tussen twee komma's doet hetzelfde als de underscore.

De waardeas vastzetten

Standaard past de waardeas zich aan de gegevens aan, dus dezelfde URL kan een maand later de getallen anders kaderen. chxr=<axis_index>,<start>,<end> zet hem juist vast, en een vierde getal bepaalt de afstand tussen de schaalstreepjes. chxr=1,0,120,20 laat de tweede as van 0 tot 120 lopen in stappen van 20.

Het bereik omgekeerd schrijven, zoals in chxr=1,120,0, zet de as ondersteboven, wat u wilt bij een rangorde of een positie waarbij 1 bovenaan hoort.

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

Lijngrafiek waarvan de y-as van nul tot honderdtwintig loopt in stappen van twintig
De as begint nu bij nul en eindigt op een rond getal, dus dezelfde URL kadert de gegevens volgende maand nog steeds op dezelfde manier.

Rasterlijnen

chg tekent het raster. De eerste twee getallen zijn de stapgroottes voor x en y, het derde en vierde zijn een streeplengte en een tussenruimte, zoals in chg=1,1,4,3.

De twee stapgroottes werken als schakelaars, niet als afstanden. Elke waarde boven 0 en onder 100 zet dat raster aan, en Image-Charts tekent de lijnen bij de schaalstreepjes die het al heeft bepaald, dus chg=1,1 en chg=20,20 leveren hetzelfde raster op. Een van beide op 0 zetten laat die helft van het raster weg, en zo geeft chg=0,1 geeft alleen horizontale lijnen.

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

Lijngrafiek met een gestreept raster op beide assen
Beide rasters aan, getekend als streepjes van vier pixels met tussenruimtes van drie pixels. Een gestreept raster blijft achter de gegevens in plaats van ermee te concurreren.

chl is geen asparameter

De parameter die een as van labels voorziet is chxl. chl doet iets anders. Op een staafdiagram labelt het de staven, op een taartdiagram de segmenten, en op een lijngrafiek laat het de as met rust. Uw maanden meesturen in chl is meestal de reden dat een tijdreeks terugkomt met een kale numerieke x-as. De referentiedocumentatie beschrijft beide.

Een tijdreeks plotten

Een grafiek bouwen