Omówienie

Możesz połączyć kilka typów wykresów za pomocą znaczników liniowych lub świecowych, aby wyróżniać trendy w danych lub pokazywać wariancję. Gdy dodasz znaczniki liniowe lub świecowe do wykresu słupkowego, punktowego lub innego, wynikowy wykres nosi nazwę wykresu złożonego. Niektóre wykresy złożone wyglądają jak połączenie 2 typów wykresów – na przykład wykres słupkowy z linią śledzenia:

a inne wyglądają jak zupełnie nowe typy wykresów – na przykład wykres ramkowy:

.

Tworzenie wykresu złożonego

Wszystkie wykresy złożone składają się z co najmniej jednego typu wykresu podstawowego (liniowego, punktowego, słupkowego lub radarowego) połączonego z co najmniej jednym zestawem znaczników. Te znaczniki wymagają danych, aby można było je umieścić na wykresie. Czasami możesz użyć tej samej serii danych, która służy do rysowania słupków lub punktów na wykresie, ale zwykle chcesz, aby znaczniki miały własne, niezależne zbiory danych. Jeśli chcesz, aby na wykresie występowały różne serie danych dla wykresu podstawowego i dla znaczników, musisz ukryć dane znacznika na wykresie podstawowym, aby na jego podstawie nie było prób narysowania kolejnych słupków lub linii. Oto jak to zrobić:

1. Dodaj serię danych znaczników na końcu parametru chd. Jeśli np. na wykresie słupkowym znajdują się dane chd=t:30,10,20, możesz dodać nowe dane do znacznika linii w ten sposób: chd=t:30,10,20|60,40,50.
2. Ukryj dodatkowe dane znaczników na wykresie podstawowym. Jeśli po prostu dodasz dodatkową serię danych do wykresu słupkowego dla linii śledzenia, będzie to widoczne na wykresie jako nowa seria słupków. Aby temu zapobiec, musisz ukryć tę dodatkową serię. Aby ukryć serię, dodaj 1 cyfrę po deskryptorze formatu chd, np. chd=t1:30,10,20|60,40,50. Ta cyfra informuje interfejs Chart API, ile serii danych użyć do narysowania elementów dla tego typu wykresu podstawowego zgodnie z parametrem cht (słupki dla wykresów słupkowych, punkty danych dla wykresów liniowych itd.). Wszystkie dodatkowe serie danych będą ignorowane przez dany typ wykresu podczas jego rysowania. Pamiętaj, że liczy się od 1, a nie od 0. Zatem t1 oznacza „użyj tylko pierwszej serii danych na słupki”, t2 oznacza „użyj słupków tylko dla dwóch pierwszych serii” itd.
   1. Uwagi:
      1. Wykresy punktowe – wykresy punktowe ukrywają dane w inny sposób. Więcej informacji znajdziesz w dokumentacji.
      2. Wykresy liniowe lxy – określ parzystą liczbę serii do wyświetlenia (t0, t2, t4 itp.). Dzieje się tak, ponieważ każda linia na wykresie lxy jest opisana za pomocą 2 serii danych: jednej dla wartości x i drugiej dla wartości y.
3. Używaj serii ukrytych danych, aby rysować znaczniki świeczek, znaczniki linii lub inne znaczniki. Informacje o tym, jak rysować znaczniki, znajdziesz w powiązanych sekcjach. Wskaż serie ukrytych danych jako źródło znaczników. Możesz uwzględnić dowolną liczbę dodatkowych serii ukrytych danych i używać ich jako dodatkowych znaczników wykresu.

Oto wykres, który właśnie omówiliśmy:

cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1

 

Typy wykresów

Poniżej znajduje się lista typów znaczników oraz typów wykresów, których można ich używać:

Typ znacznika	Obsługiwane typy wykresów podstawowych
Liniowy	Liniowy, Punktowy, Pasek, Radar
Lichtarz	Linia, Pasek
Wszystkie inne	Liniowy, Punktowy, Pasek, Radar

Oto kilka przykładów typów wykresów złożonych:

Typ wykresu	Opis	Przykład
Wykresy ze znacznikami liniowymi	Znaczniki linii pozwalają pokazywać trendy na wielu innych typach wykresów.
Wykresy świecowe	Wykresy świecowe są często używane do przedstawiania danych finansowych.
Wykresy pudełkowe	Wykresy ramkowe służą do wyświetlania danych w podziale na kwartyle.
Umieszczone wykresy	Wykres możesz umieścić w innym wykresie.
Inne znaczniki	Możesz ukryć dane znaczników na dowolnym z akceptowanych typów wykresów podstawowych i używać ich z dowolnymi innymi typami znaczników.	chd=t1:   10,20,30,40,50,60,70,80   5,10,15,20,25,30,35,40,45,50 chm=o,000000,1,-1,5

Powrót do góry

 

Wykresy ze znacznikami liniowymi

Możesz dodawać linie do wykresów liniowych, scatter, słupkowych i radarowych, aby wyróżniać trendy.

Typ podstawy + typ znacznika	Opis	Przykład
Pasek + linia	Oto wykres słupkowy z linią logu czasu. Pierwsze 2 serie danych są używane jako słupki skumulowane, a pozostałe są używane jako linia. chd=s2 oznacza, że na wykresie powinny być używane tylko 2 pierwsze serie jako słupki. W wierszu dane wykorzystuje trzecia seria. chd=s2:1XQbnf4,EWoQMUB,9halxp9 – proste kodowanie, w którym 2 pierwsze serie są używane do rysowania słupków, a ostatnia seria jest używana jako linia. chm=D,0033FF,2,0,5,1 – linia logu czasu (D), niebieska, dane z indeksu serii 2, wszystkie punkty (0), linia ma 5 pikseli szerokości, rząd linii wynosi 1.	chm=   D,0033FF,2,0,5,1 chd=s2:   1XQbnf4,   EWoQMUB,   9halxp9
Punktowy + liniowy	Do wykresu punktowego możesz dodać linię, aby pokazać średnie wartości. Pamiętaj, że na wykresach punktowych dane znaczników ukrywają dane znaczników w inny sposób. Więcej informacji znajdziesz na stronie Wykresy punktowe.	chd=t:   12,16,16,24,26,28,41,51,66,68,13,45,81|   16,14,22,34,22,31,31,48,71,64,15,38,84 chm=   o,0000FF,0,-1,0|   o,FF0000,0,0:9:,5|   D,000000,1,10:,1,-1
Pasek + linia	Oto kolejny skumulowany wykres słupkowy z nakreśloną niezależną linią.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=D,76A4FB,2,0,3
Słupek + Kręgi	Taki sam jak na poprzednim wykresie, ale ze znacznikami okręgu zamiast znacznika linii. Podaliśmy co 0,5 wartości danych, co powoduje dodanie obliczonych punktów pośrednich na kropkowaną linię.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=o,76A4FB,2,-.5,10

Powrót do góry

 

Wykresy świecowe

Wykresy świecowe wymagają co najmniej 4 serii danych do rysowania świec oraz dodatkowych serii dla pozostałych elementów wykresu. Wykresy świecowe mogą pokazywać tylko zestaw znaczników świecowych albo być kombinacją znaczników świecowych oraz wykresów słupkowych i liniowych, jak pokazano tutaj:

Typ podstawy + typ znacznika	Opis	Przykład
Linia (ukryta) + świecowy	Ten przykład pokazuje wykres, który zawiera tylko znaczniki świecznika. chd=t0 – wartość 0 oznacza, że wszystkie serie danych są ukryte przed podstawowym typem wykresu (w tym przypadku na wykresie liniowym), więc rysowane są tylko świece. Pierwsza i ostatnia wartość w każdej serii to -1, aby wskazać brakujące wartości. Pozwoli to uniknąć rysowania pierwszego lub ostatniego świecznika, który zasłaniałby oś lub margines wykresu i zostałby obcięty. chm=F,0000FF,0,-1,20 – element F wskazuje znaczniki świecowe (pierwotnie „znaczniki finansowe”). 0000FF oznacza, że znaczniki są niebieskie, gdy wartość się zmniejsza; 0 wskazuje, że dane świecowe zaczynają się od serii 0; -1 wskazuje znaczniki we wszystkich punktach (moglibyśmy również określić 0:4 tutaj, aby ukryć pierwszą i ostatnią świecę, zamiast używać wartości danych -1); 20 to szerokość świec świecowych.	cht=lc chd=t0:   -1,5,10,7,12,-1|   -1,25,45,47,24,-1|   -1,40,30,27,39,-1|   -1,55,63,59,80,-1 chm=F,0000FF,0,-1,20
Linia + świeca	Oto przykład wykresu liniowego ze znacznikami świecznik. Dostępnych jest 5 serii danych. Pierwsza z nich służy do typu wykresu (linia), a pozostałe „ukryte” serie danych są używane do użycia znaczników świecowych. Parametr chd=t1 określa, że na wykresie tego typu (wykres liniowy) jest używana tylko pierwsza seria. Pominęliśmy pierwszy i ostatni znacznik świecy za pomocą parametru 1:4 w wartości <which_points>, ponieważ pierwszy i ostatni świecznik jest przycinany zgodnie z obramowaniem obszaru wykresu. Parametr chm określa znaczniki świecy za pomocą składni F,<declining_color>,<data_series_index>,<which_points>,<width>,<order>	cht=lc chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20
Linia + świeca	Kolejny przykład wykresu świecowego z niestandardowymi kolorami wypełnienia.	chd=t1: t1:   90,80,70,50,40,30,20,10|   0,5,10,0,5,10,0|2,15,20,5,15,40,0|   5,35,20,2,35,20,0|   15,40,30,15,40,50,0 chm=   F,000000,1,1:-2,20
Bar + świecznik	Oto przykład wykresu słupkowego ze znacznikami świeczników. Tutaj wyświetlamy pierwszy i ostatni znaczniki świecy, ponieważ słupki zapewniają wystarczającą liczbę odstępów, aby zapobiec przycięciu ich poza granice wykresu.	cht=bvg chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20

Powrót do góry

 

Wykresy pudełkowe

Wykresy pudełkowe, nazywane też wykresami ramkowymi lub wykresami skrzynkami i whiskerem, to typ wykresu, który pokazuje grupowanie co najmniej 1 serii w kwartyle (kwartyle to grupy obejmujące 25% zakresu wartości z wyjątkiem wartości odstających). Wykresy ramkowe są podobne do wykresów świecowych, ale mają dodatkowe znaczniki dla dolnej i górnej części świecy oraz 50 centyl.

Wykres blokowy składa się w całości ze znaczników, jak pokazano tutaj:

chm=   F,0000FF,0,1,10	chm=   H,0000FF,0,1,1:10|   H,0000FF,3,1,1:10|   H,0000FF,4,1,1:10	chm=   o,FF0000,5,,5|   o,FF0000,6,,5
Jeden zestaw znaczników świecowych (chm=F) na treść pól:	Jeden zestaw znaczników kształtu poziomych linii o regulowanej długości (chm=H) dla linii minimalnego, 50 i 100 centyla:	Opcjonalnie możesz dodać znaczniki kształtu koła (chm=o), by pokazać elementy odstające w zbiorze danych.	Jeśli połączysz te elementy, powstanie wykres blokowy.

Typ wykresu podstawowego dla wykresów blokowych to dowolny typ wykresu słupkowego (bhs, bvs, bhg, bvg) lub wykres liniowy (lc, ls, lxy). Jeśli jednak ukrywasz typ wykresu podstawowego, dodając zero w parametrze formatu danych (np. chd=t0: lub chd=s0:), nie ma znaczenia, jaki wybierzesz.

Wykres ramowy musi zawierać co najmniej 5 serii danych: 4 dla pól oraz znaczniki maksymalnej i minimalnej; jedną dla znacznika 50% oraz wszelkie dodatkowe serie danych dla wszelkich dodatkowych znaczników, które mogą być potrzebne, takich jak znaczniki wyników odstających. Oto zalecana kolejność serii. Pamiętaj, że jeśli wartość w serii 1 jest większa niż odpowiednia wartość w serii 2, pole zostanie wypełnione kolorem znacznika chm=F. Jeśli wartość w serii 1 jest mniejsza od wartości w serii 2, pole będzie niewypełnione. Więcej informacji znajdziesz w artykule Znaczniki świecowe.

Kolejność w serii w przypadku niewypełnionego pola:

0. Wartość minimalna
1. 25% znacznik (75% dla wypełnionego pola)
2. 75% znacznik (25% dla wypełnionego pola)
3. Wartość maksymalna
4. Znacznik 50%
5. Seria 6 i kolejne służą do podawania dodatkowych danych znaczników, takich jak wyniki odstające.

Dodatkową serię znaczników możesz umieścić przed danymi znaczników świecowych lub po nich, ale prościej jest umieścić je wszystkie na końcu.

Możesz tworzyć różne style wykresów blokowych, określając różne znaczniki, różne typy wykresów podstawowych lub porządkując dane

Opis	Przykład
To standardowy wykres blokowy, w którym różnym elementom wykresu są przypisane różne kolory, aby można było pokazać, który znacznik jest używany do tworzenia poszczególnych elementów wykresu. cht=bvs – typ wykresu podstawowego to bvs, ale słupki z tego wykresu podstawowego nie są wyświetlane. Mogliśmy tu określić dowolny typ wykresu złożonego. chd=t0: – element t0 ukrywa wszystkie linie na tym wykresie liniowym. Wszystkie dane będą używane tylko do tworzenia znaczników. W danych pierwsza i ostatnia wartość wynosi -1, aby uniknąć pokrywania się znaczników na lewą i prawą krawędź wykresu. Wszystkie wartości w drugiej serii są niższe niż odpowiednie wartości w trzeciej serii, więc wszystkie pola będą niewypełnione. -1,5,10,7,12,-1 – wartość minimalna: dolny punkt pomarańczowych drążków dolnych oraz wysokość poziomych zielonych linii. -1,25,30,27,24,-1 – wartość 25%: dolna, pozioma krawędź pomarańczowych pól. -1,40,45,47,39,-1 – wartość 75%: górna pozioma krawędź pomarańczowych pól. -1,55,63,59,80,-1 – maksymalna wartość: górny punkt pomarańczowych pałeczek oraz wysokość poziomych niebieskich linii. -1,30,40,35,30,-1 – czarne poziome linie „Mediana” wewnątrz świec -1,-1,5,70,90,-1 – dane odstające (czerwone okręgi) -1,-1,-1,80,5,-1 – więcej danych odstających (czerwone okręgi). Dane z wynikami odstającymi są podzielone na 2 zbiory, ponieważ nie można mieć 2 znaczników, jednego nad drugim, określonych w tej samej serii bez użycia przesunięcia lub innych skomplikowanych sztuczek. chm= – Znaczniki w sposób opisany poniżej: F,FF9900,0,1:4,40 – pomarańczowe znaczniki świecznika (F) korzystające z 4 serii danych, zaczynając od pierwszej serii (0), w punktach 1–4, rozmiar 40. H,0CBF0B,0,1:4,1:20 – zielone poziome znaczniki linii wskazujące wartość minimalną. Pochodzą one z pierwszej serii. H,0000FF,3,1:4,1:20 – niebieskie poziome znaczniki linii wskazujące wartość maksymalną. pochodzą z serii 3. H,000000,4,1:4,1:40 – czarne poziome znaczniki linii pokazujące wartość 50%. Pochodzą z serii 4. o,FF0000,5,-1,7 – czerwone okręgi przypisane do szóstej serii danych dla wyników odstających. Znaczniki są przypisane do wszystkich elementów w tej serii. W polach bez wartości odstających są używane -1. o,FF0000,6,-1,7 – więcej wyników odstających. Gdy chcesz nakładać na siebie wartości odstające wokół tego samego pola, wymagana jest inna seria danych.	cht=bvs chd=t0:   -1,5,10,7,12,-1|   -1,25,30,27,24,-1|   -1,40,45,47,39,-1|   -1,55,63,59,80,-1|   -1,30,40,35,30,-1|   -1,-1,5,70,90,-1|   -1,-1,-1,80,5,-1 chm=   F,FF9900,0,1:4,40|   H,0CBF0B,0,1:4,1:20|   H,000000,4,1:4,1:40|   H,0000FF,3,1:4,1:20|   o,FF0000,5,-1,7|   o,FF0000,6,-1,7
Na wykresie LCD zawsze są wyświetlane linie osi. Aby utworzyć wykres bez linii osi, jako typ wykresu wybierz ls.	cht=lc    cht=ls
Aby utworzyć wypełnione pole, punkt drugiej serii musi być większy niż odpowiadający jej punkt w trzeciej serii. Większa wartość jest oznaczona na czerwono w kodzie pokazanym po prawej stronie.	chd=t0:   -1,5,10,7,12,-1   -1,40,30,27,24,-1   -1,25,45,47,39,-1   -1,55,63,59,80,-1

Powrót do góry

 

Osadzone wykresy

W wykresie słupkowym, liniowym, radarze lub scatter możesz umieścić dowolny typ wykresu za pomocą ikon dynamicznych. Zapoznaj się z sekcją Umieszczone wykresy w dokumentacji znaczników dynamicznych (chem).

Powrót do góry

 

Funkcje standardowe

Pozostałe funkcje na tej stronie to standardowe funkcje wykresu.

Znaczniki linii chm=D [słupkowy, świecowy, linia, radar, punktowy]

Możesz dodać linię śledzącą dane na wykresie. Najczęściej jest on używany w wykresach złożonych.

Aby dodać wiele linii (lub połączyć je z innymi znacznikami chm), rozdziel zestawy parametrów chm pionową kreską ( | ). Z tym parametrem nie można utworzyć znacznika linii przerywanej.

Składnia

chm=
  D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>

D

Wskazuje, że jest to znacznik linii.

<color>

Kolor linii w formacie szesnastkowym RRGGBB.

<series_index>

Indeks serii danych użyty do narysowania linii. Indeks serii danych wynosi 0 dla pierwszej serii danych, 1 dla drugiej itd.

<which_points>

Punkty w serii, których należy użyć do narysowania linii. Użyj jednej z tych wartości:

• 0 – wykorzystaj wszystkie punkty w serii.
• start:end – użyj określonego zakresu punktów w serii, od start do end włącznie (indeks liczony od zera). Możesz też użyć wartości zmiennoprzecinkowych, aby określić punkty pośrednie, lub pozostawić pole start lub end puste, aby wskazać odpowiednio pierwszy lub ostatni punkt danych. Wartości start i end mogą być ujemne, ponieważ indeksy są odwrotne od ostatniej wartości. Jeśli zarówno start, jak i end są ujemne, zapisz je rosnącą wartością (np. -6:-1).

<size>

Szerokość linii w pikselach.

<opt_z_order>

[Opcjonalnie] Warstwa, w której służy do rysowania znacznika, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa z zakresu od -1,0 do 1,0 włącznie, gdzie -1,0 oznacza dół, a 1,0 – górną. Wskaźniki liczby elementów wykresu (linii i słupków) mają wartość mniejszą niż 0. Jeśli dwa znaczniki mają tę samą wartość, są rysowane w kolejności określonej w adresie URL. Wartość domyślna to 0,0 (tuż nad elementami wykresu).

 

Przykłady

Opis	Przykład
Oto przykład narysowania linii znacznika na wykresie słupkowym. Kolejność nakładania elementów jest ustawiona na 1, więc linia jest rysowana na słupkach. W tym przykładzie użyto tych samych danych dla słupków i linii danych.	chm=D,0033FF,0,0,5,1 chd=s:1XQbnf4
To ten sam wykres słupkowy, ale z dodatkową serią danych tylko dla linii. To jest przykład wykresu złożonego. Wykresy złożone są rysowane przez dodanie dodatkowej serii danych do parametru chd oraz wartości chd, która informuje wykres, aby „ignorował” dodatkowe serie danych. Więcej informacji znajdziesz w sekcji Wykresy zbiorcze.	chm=D,0033FF,1,0,5,1 chd=s1:1XQbnf4,43ksfg6

Powrót do góry

Znaczniki kształtów chm [pasek, linia, radar, punktowy]

Możesz określić znaczniki graficzne dla wszystkich lub poszczególnych punktów danych na wykresie. Jeśli co najmniej 2 znaczniki znajdują się w tym samym punkcie, są rysowane w takiej kolejności, w jakiej występują w parametrze chm. W punktach danych możesz też tworzyć znaczniki tekstowe. Odpowiednie informacje znajdziesz w sekcji Znaczniki punktów danych.

Znaczniki kształtu możesz łączyć z dowolnymi innymi parametrami chm, korzystając z pionowej kreski ( |), aby rozdzielić parametry chm.

Składnia

Określ jeden zbiór parametrów poniżej dla każdej serii, którą chcesz oznaczyć. Aby oznaczyć kilka serii, utwórz dodatkowe zestawy parametrów rozdzielone pionową kreską. Nie musisz zaznaczać wszystkich serii. Jeśli nie przypiszesz znaczników do serii danych, nie otrzyma ona żadnych znaczników.

Znaczniki kształtu działają nieco inaczej na wykresach punktowych. Więcej informacji znajdziesz w dokumentacji.

chm=
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
    |...|
  [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>

@

[opcjonalnie] jeśli poprzedzisz typ znacznika opcjonalnym znakiem @, w elementach <opt_Który_punkt> należy użyć formatu x:y.

<marker_type>

Typ znacznika do użycia. Określ jeden z tych typów:

• a – strzałka
• c – krzyż
• C – prostokąt. W przypadku znacznika prostokątnego musisz mieć co najmniej 2 serie danych, gdzie seria 0 określa dolną krawędź, a seria 1 – górną. <size> określa szerokość prostokąta w pikselach.
• d – diamentowy
• E – znacznik błędu ( ) Ten znacznik wymaga do utworzenia 2 serii danych: 1 wartości dla dołu i odpowiadającego mu punktu drugiej serii w przypadku wierzchołków. Udostępnia też rozszerzoną składnię <size>: line_thickness[:top_and_bottom_width], gdzie top_and_bottom_width jest opcjonalna. Zobacz poniższe przykłady.
• h – pozioma linia na wykresie na określonej wysokości. (Jedynym prawidłowym formatem parametru <opt_which_points> jest opt_which_points).
• H – linia pozioma przebiegająca przez określony znacznik danych. Obsługuje rozszerzoną składnię <size>, która pozwala określić dokładną długość wiersza: line_thickness[:length], gdzie :length jest opcjonalny. Domyślnym ustawieniem jest pełna szerokość obszaru wykresu.
• o – krąg
• s – kwadrat
• v – pionowa linia od osi X do punktu danych.
• V – pionowa linia o regulowanej długości. Obsługuje rozszerzoną składnię wartości <size>, która pozwala określić dokładną długość wiersza: line_thickness[:length], gdzie :length jest opcjonalny. Domyślnie wybierana jest wysokość pełnego obszaru wykresu. Znacznik jest wyśrodkowany w punkcie danych.
• x – X

<color>

Kolor znaczników tej serii w formacie szesnastkowym RRGGBB.

<series_index>

Indeks serii danych liczony od zera, na podstawie którego mają zostać rysowane znaczniki. Ignorowana w przypadku znaczników h i znaczników określających lokalizację na podstawie pozycji x/y (zaczyna się od znaku @). Jako źródła znaczników możesz używać ukrytych serii danych. Więcej informacji znajdziesz w sekcji Wykresy złożone. Pogrupowane pionowe wykresy słupkowe obsługują specjalną rozszerzoną składnię, która pozwala wyrównywać znaczniki do określonych słupków.

<opt_which_points>

[Opcjonalnie] Wskaż punkty, w których chcesz rysować znaczniki. Wartość domyślna to wszystkie znaczniki. Użyj jednej z tych wartości:

• n.d – gdzie narysować znacznik. Znaczenie zależy od typu znacznika:
  • Wszystkie typy oprócz h – punkt danych, na którym ma być rysowany znacznik, gdzie n.d to indeks w serii liczony od zera. Jeśli podasz wartość niebędącą liczbą całkowitą, ułamek wskazuje obliczony punkt pośredni. Na przykład liczba 3, 5 oznacza połowę drogi między punktami 3 i 4.
  • h – liczba z zakresu od 0,0 do 1,0, gdzie 0,0 oznacza dół wykresu, a 1,0 – jego górną część.
• -1 – narysuj znacznik na wszystkich punktach danych. Możesz też pozostawić ten parametr pusty, by rysować na wszystkich punktach danych.
• -n – narysuj znacznik w każdym n-tym punkcie danych. Wartość zmiennoprzecinkowa. Jeśli n jest mniejsze od 1, wykres obliczy za Ciebie dodatkowe punkty pośrednie. Na przykład wartość -0,5 spowoduje umieszczenie 2 razy więcej znaczników niż punktów danych.
• start:end:n – narysuj znacznik w każdym n-tym punkcie danych w zakresie, od wartości indeksu start do końca włącznie. Wszystkie parametry są opcjonalne (może ich brakować), więc 3::1 będzie prowadzić od czwartego do ostatniego, kroku 1. Pominięcie tego parametru domyślnie spowoduje użycie parametru first:last:1. Wszystkie wartości mogą być liczbami zmiennoprzecinkowymi. Wartości start i end mogą być ujemne, ponieważ będą odliczane wstecz od ostatniej wartości. Jeśli zarówno argument start, jak i koniec jest ujemny, upewnij się, że są one wyrażone rosnącą wartością (np. -6:-1:1). Jeśli wartość kroku n jest mniejsza niż 1, dodatkowe punkty danych zostaną obliczone przez interpolację podanych wartości danych. Wartości domyślne to first:last:1
• x:y – rysuj znacznik w określonym punkcie x/y na wykresie. Ten punkt nie musi znajdować się na linii. Aby użyć tej opcji, dodaj znak @ przed typem znacznika. Podaj współrzędne jako wartości zmiennoprzecinkowe, gdzie 0:0 jest lewym dolnym rogiem wykresu, a 1:1 jest jego prawym górnym rogiem. Aby na przykład dodać czerwony romb o szerokości 15 pikseli na środku wykresu, użyj właściwości @d,FF0000,0,0.5:0.5,15.

<size>

Rozmiar znacznika w pikselach. Większość tego parametru przyjmuje pojedynczą wartość liczbową. Znaczniki V, H i S obsługują składnię <size>[:width], gdzie opcjonalna druga część określa długość linii lub znacznika.

<opt_z_order>

[Opcjonalnie] Warstwa, w której służy do rysowania znacznika, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa z zakresu od -1,0 do 1,0 włącznie, gdzie -1,0 oznacza dół, a 1,0 – górną. Wskaźniki elementów wykresu (linie i słupki) mają wartość mniejszą niż 0. Jeśli dwa znaczniki mają tę samą wartość, są rysowane w kolejności określonej w adresie URL. Wartość domyślna to 0,0 (tuż nad elementami wykresu).

<opt_offset>

[Opcjonalnie] Umożliwia określenie odsunięcia w pionie i poziomie od określonej lokalizacji. Tak wygląda składnia, w której używany jest separator :: reserved:<horizontal_offset>:<vertical_offset>. Jeśli została określona, możesz dodać pustą wartość , w ciągu parametru chm dla parametru <opt_z_order>. Przykłady: o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20

• reserve (zarezerwowane) – pozostaw puste.
• <horizontal_offset> – liczba dodatnia lub ujemna określająca przesunięcie w poziomie (w pikselach). Opcjonalny. Jeśli nie jest używany, pozostaw to pole puste.
• <vertical_offset> – liczba dodatnia lub ujemna, która określa przesunięcie w pionie (w pikselach). Opcjonalny. Jeśli nie jest używany, pozostaw to pole puste.

 

Przykłady

Opis	Przykład
Oto przykład kilku znaczników kształtu i linii. a,990066,0,0.0,9.0 – fioletowa strzałka, pierwsza seria, pierwszy punkt, rozmiar 9. c,FF0000,0,1.0,20.0 – czerwony krzyżyk, pierwsza seria, drugi punkt, rozmiar 9. d,80C65A,0,2,20.0 – zielony romb, pierwsza seria, trzeci punkt, rozmiar 9. H,000000,0,3,1:40 – czarna linia pozioma, pierwsza seria, punkt danych 3, szerokość 1 piksela, długość 40 pikseli. o,FF9900,0,4.0,12.0 – pomarańczowe koło, pierwsza seria, piąty punkt, rozmiar 12. s,3399CC,0,5.0,11.0 – niebieski kwadrat, pierwsza seria, 6 punkt, rozmiar 11. v,BBCCED,0,6.0,1.0 – linia pionowa do punktu, pierwszej serii, 7. punkt, szerokość 1 piksela. V,3399CC,0,7.0,1.0 – pionowa linia od dołu do góry wykresu, pierwszej serii, ósmego punktu, szerokości 1 piksela. x,FFCC33,0,8.0,20.0 – żółty „X”, pierwsza seria, 9 punkt, rozmiar 20. H,FFFF00,0,9,2 – pozioma żółta linia szerokości wykresu w punkcie danych 9. h,FF0000,0,0.5,1 – czerwona pozioma linia na określonej wysokości, pierwsza seria, połowa w górę wykresu, szerokość 1 piksela.	chm=   a,990066,0,0.0,9.0|   c,FF0000,0,1.0,20|   d,80C65A,0,2.0,20.0|   H,000000,0,3,1:40|   o,FF9900,0,4.0,12.0|   s,3399CC,0,5.0,11.0|   v,BBCCED,0,6,1.0|   V,3399CC,0,7,1.0|   x,FFCC33,0,8,20|   H,FFFF00,0,9,2|   h,FF0000,0,0.5,1
Oto przykład użycia romb w przypadku jednej serii danych i okręgów w przypadku drugiej. Jeśli co najmniej 2 znaczniki znajdują się w tym samym punkcie, są rysowane w kolejności, w jakiej występują w parametrze chm. W tym przypadku okrąg jest pierwszym znacznikiem określonym za pomocą funkcji chm, więc jest on rysowany jako pierwszy. Romb jest zaznaczany i rysowany w drugiej kolejności, co powoduje, że jest on narysowany nad okręgiem.	chm=   o,FF9900,0,-1,15.0|   d,FF0000,1,-1,10.0
Oto wykres liniowy ze znacznikiem w każdym drugim punkcie danych (-2 oznacza co drugi punkt).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-2,6
Ten wykres liniowy zawiera 2 razy więcej znaczników niż punktów danych (-0,5 oznacza każdą połową punktu).	chd=t:   0,20,20,50,40,70,70,90,85,45,40,50 chm=   o,0066FF,0,-.5,6
Ten przykład pokazuje, jak używać znaczników h i v do tworzenia linii siatki o niestandardowych kolorach i grubości. Kolejność nakładania elementów (ostatnia wartość) wynosi -1, dzięki czemu linie siatki są rysowane poniżej linii danych.	chm=   h,76A4FB,0,0:1:.2,2,-1|   V,76A4FB,0,::2,0.5,-1
Ten wykres dodaje pionowe linie wypełnienia do wykresu liniowego: v – pionowe linie na wykresie. FF0000 – czerwone linie 0 – indeks serii : :.5 – specyfikator zakresu: od początku do końca co 0, 5 punktu. 2 – grubość 2 piksele.	chm=   v,FF0000,0,::.5,2
W tym przykładzie do wykresu dodaje się strzałkę i znacznik tekstu z wykorzystaniem dokładnych współrzędnych. Pierwszy znacznik D to linia logu poniżej słupków. Drugim jest strzałka, a trzeci – jej tekst.	chm=   D,003971,1,0,3|   @a,000000,0,.25:.75,7|   @tExpected,000000,0,.35:.85,10
Linia pozioma przymocowana do konkretnego punktu danych (H) może być przydatna przy przedstawianiu wartości względnych lub podkreślaniu wysokości wartości danych na wykresie.	chm=H,FF0000,0,18,1
Ten wykres przedstawia znaczniki, które mogą określać grubość i długość linii w parametrze <size>. E,000000,0,6,1:20 – czarny pasek błędów z liniami o szerokości 1 piksela oraz pasami górnymi i dolnymi o długości 20 pikseli. Dolna część jest zakotwiczona do serii 0 punkt 8, a górna jest zakotwiczona do serii 1 punkt 8. H,990066,1,2,5:50 – fioletowa linia pozioma o szerokości 5 pikseli i długości 50 pikseli wyśrodkowana w punkcie danych 2. V,3399CC,0,8,3:50– Niebieska, pionowa linia o szerokości 3 pikseli i długości 50 pikseli, wyśrodkowana w punkcie danych 8.	title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,9CCC,image3,1,2,5:50% chm=   E,000000,0,6,1:20|   H,990066,1,2,5:50|   V,3399CC,0,8,3:50

Powrót do góry

Znaczniki świecowe chm=F [paskowe, liniowe]

Znaczniki świeczki wskazują wariancję i zmianę kierunku w serii danych. Często są używane do pokazywania wartości akcji w ciągu dnia. Znacznik zawiera segmenty, które pokazują najwyższą i niską wartość, a także wartość otwarcia i zamykania w określonym przedziale czasu (zwykle 1 dzień). Więcej informacji o znacznikach świeczników znajdziesz tutaj.

Znacznik świecy jest rysowany jako prostokąt podzielony na pół przez pionową linię. Do narysowania znacznika świecy potrzebne są 4 serie danych:

• Seria 1 i 4 określają odpowiednio dolną i górną linię pionowej. Zazwyczaj są to niskie i wysokie wartości w danym dniu.
• Seria 2 i 3 określają pionowe krawędzie prostokąta. Seria 2 to wartość otwarcia, a seria 3 – wartość zamknięcia. Kolor prostokąta zależy od tego, który z nich jest wyższy: gdy wartość otwarcia (seria 2) jest niższa od wartości zamknięcia (seria 3), cena wzrosła, a prostokąt jest domyślnie wypełniony kolorem zielonym. Kiedy wartość otwarcia (seria 2) jest wyższa niż wartość zamknięcia (seria 3), cena zmalała, a prostokąt jest domyślnie wypełniany kolorem pełnym czerwonym. Kolor wypełnienia możesz określić tylko w przypadku prostokątów ze malejącą wartością. Jeśli wybierzesz tę opcję, prostokąt o rosnącej wartości będzie niewypełniony (pusty). Pamiętaj, że seria 2 może być u góry lub u dołu prostokąta w zależności od tego, czy cena wzrosła, czy spadła.

Znaczniki świecznika możesz łączyć z dowolnymi innymi parametrami chm, korzystając z pionowej kreski ( |) do rozdzielania parametrów chm.

Uwaga: jeśli nie chcesz, by na wykresie wyświetlały się linie danych użytych do rysowania znaczników, musisz dodać 0 po typie formatu. Na przykład: chd=t0:10,20,30,40 w ciągu tekstowym w formacie tekstowym. Więcej informacji znajdziesz w sekcji Wykresy złożone.

Oto przykład ilustrujący wiersze każdej serii:

Składnia

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>

F

Wskazuje, że jest to znacznik świecy.

<opt_declining_color>

[Opcjonalnie] Kolor wypełnienia prostokątów, gdy wartość maleje (gdy wartość serii 2 jest > odpowiadająca jej wartość serii 3). Jest to liczba szesnastkowa RRGGBB. Gdy wartości zwiększą się, prostokąt stanie się pusty. Domyślnie świeci się na zielono, jeśli rośnie, a czerwony – maleje (nie możesz określić niestandardowego koloru wypełnienia dla rosnących wartości).

<data_series_index>

Indeks serii danych, która zostanie użyta jako pierwsza seria dla znaczników świecowych. Wartości indeksu liczone są od zera. Jeśli więc określisz tutaj 1, a masz 6 serii, do rysowania znaczników świecowych zostanie użyta druga, trzecia, czwarta i piąta.

<opt_Które_punkty>

[Opcjonalnie] Określa, które punkty danych są używane do rysowania znaczników. Domyślnie wszystkie są znaczniki. Użyj jednego z tych formatów:

• n.d – narysuj znacznik w pojedynczym punkcie w serii, gdzie n.d to indeks punktu w ciągu. Jeśli podasz wartość niebędącą liczbą całkowitą, ułamek wskazuje obliczony punkt pośredni. Na przykład liczba 3, 5 oznacza połowę drogi między punktami 3 i 4.
• -1 – narysuj znacznik na wszystkich punktach danych. Możesz też pozostawić ten parametr pusty, by rysować na wszystkich znacznikach.
• -n – narysuj znacznik w każdym n-tym punkcie danych.
• start:end:n – narysuj znacznik w każdym n-tym punkcie danych w zakresie, od wartości indeksu start do końca włącznie. Wszystkie parametry są opcjonalne (może ich brakować), więc 3::1 będzie prowadzić od czwartego do ostatniego, kroku 1. Pominięcie tego parametru domyślnie spowoduje użycie parametru first:last:1. Wszystkie wartości mogą być liczbami zmiennoprzecinkowymi. Wartości start i end mogą być ujemne, ponieważ będą odliczane wstecz od ostatniej wartości. Jeśli zarówno argument start, jak i koniec jest ujemny, upewnij się, że są one wyrażone rosnącą wartością (np. -6:-1:1). Jeśli wartość kroku n jest mniejsza niż 1, dodatkowe punkty danych zostaną obliczone przez interpolację podanych wartości danych. Wartości domyślne to first:last:1

<width>

Szerokość wszystkich prostokątów w pikselach.

<opt_z_order>

[Opcjonalnie] Warstwa, w której służy do rysowania znacznika, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa z zakresu od -1,0 do 1,0 włącznie, gdzie -1,0 oznacza dół, a 1,0 – górną. Wskaźniki liczby elementów wykresu (linii i słupków) mają wartość mniejszą niż 0. Jeśli dwa znaczniki mają tę samą wartość, są rysowane w kolejności określonej w adresie URL. Wartość domyślna to 0,0 (tuż nad elementami wykresu).

 

Przykłady

Opis	Przykład
Oto przykład znaczników świecowych na wykresie liniowym z 4 seriami. Określono niestandardowy kolor wypełnienia 0000FF (niebieski), który jest używany do wypełnienia prostokątów, gdy punkt w serii 3 jest mniejszy od równoważnego punktu w serii 2. Pierwszy i ostatni prostokąt są przycinane na wykresie. Aby je wyeliminować, możesz ustawić format 1:4 dla czwartego parametru chm. Zwróć uwagę na zero w ciągu danych, by ukryć wiersze serii: chd=t0. Oznacza to, że wszystkie dane wykresu mają być używane jako znaczniki. Parametr <which_point> jest pusty, co powoduje wyświetlenie świec we wszystkich punktach danych.	chd=t0:   0, 5,10, 7,12, 6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,60 chm=F,0000FF,0,,20
Oto przykład tego samego wykresu z wykorzystaniem kolorów domyślnych i usunięciem pierwszego i ostatniego elementu. To wykres złożony: łączy wykres liniowy (typ podstawowego) i znaczniki świecowe. Wartość 1 w cht=t:1 oznacza, że wszystkie serie danych następujące po pierwszej powinny być ukryte na wykresie podstawowym (wykresie liniowym). Pierwsza wartość w polu chm=F,,1,1:4,20 oznacza, że dane świecowe pochodzą z serii 2, 3, 4 i 5 (1 to liczna od zera). Więcej informacji o rysowaniu takiego wykresu znajdziesz w sekcji Wykresy złożone.	cht=lc chm=   F,,1,1:4,20 chd=t1:   15,40,30,27,39,54|   ...

Powrót do góry