Funkcje dotyczące wykresu |
Informacje o znaczniku
|
Omówienie
Możesz połączyć kilka typów wykresów ze znacznikami liniowymi lub świecowymi, aby wyróżnić trendy w danych lub pokazać wariancje. Gdy dodasz znaczniki liniowe lub świecowe do wykresów słupkowych, punktowych lub innych, wynikowy wykres będzie nazywany wykresem złożonym. Niektóre wykresy złożone wyglądają jak połączone 2 typy, na przykład wykres słupkowy z linią śledzenia:
Podczas gdy inne wyglądają jak zupełnie nowe typy wykresów, np. 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 jednym lub wieloma zestawami znaczników. Do umieszczenia tych znaczników na wykresie potrzebne są dane. 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 wykres przedstawiał różne serie danych dla wykresu podstawowego i znaczników, musisz ukryć dane znaczników na wykresie podstawowym (aby nie próbował narysować kolejnych słupków lub linii z tymi danymi). Oto jak to zrobić:
- Dodaj serię danych znacznika na końcu parametru
chd
. Jeśli na przykład na wykresie słupkowym znajdują się danechd=t:30,10,20
, możesz dodać nowe dane dla znacznika liniowego w ten sposób:chd=t:30,10,20|60,40,50
. - Ukryj dodatkowe dane znaczników na wykresie podstawowym. Jeśli po prostu dodasz dodatkową serię danych do wykresu słupkowego linii śledzenia, będzie on widoczny jako nowa seria słupków. Aby temu zapobiec, musisz ukryć tę dodatkową serię. Aby ukryć serię, umieść 1 cyfrę po deskryptorze formatu
chd
, np.chd=t1:30,10,20|60,40,50
. Ta cyfra informuje interfejs Chart API, ilu serii danych ma użyć do rysowania elementów tego typu wykresu podstawowego, zgodnie z definicją za pomocą parametrucht
(słupków na wykresach słupkowych, punktów danych na wykresach liniowych itd.). Wszystkie dodatkowe serie danych będą ignorowane przez ten typ wykresu podczas jego rysowania. Pamiętaj, że jest to liczba od 1, a nie od 0. Zatemt1
oznacza „użyj tylko pierwszej serii danych dla słupków”,t2
oznacza „użyj tylko 2 pierwszych serii dla słupków” itd.- Uwagi:
- Wykresy punktowe – wykresy punktowe ukrywają dane w inny sposób. Więcej informacji znajdziesz w dokumentacji.
- Wykresy liniowe xy – określ parzystą liczbę serii do wyświetlenia (
t0
,t2
,t4
itd.). Dzieje się tak, ponieważ każda linia na wykresielxy
jest opisana przez 2 serie danych – jedną dla wartości x, a drugą dla wartości y.
- Uwagi:
- Ukryta seria danych służy do rysowania znaczników świecowych, liniowych i innych znaczników. Sposób rysowania znaczników znajdziesz w sekcjach, do których prowadzą linki. Utwórz odwołanie do ukrytej serii danych jako źródła znaczników. Możesz dodać dowolną liczbę dodatkowych ukrytych serii danych i używać ich do tworzenia dodatkowych znaczników na wykresie.
Oto opisany przez nas wykres:
cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1
Typy wykresów
Oto lista typów znaczników i typów wykresów, których można używać:
Typ znacznika | Obsługiwane typy wykresów podstawowych |
---|---|
Liniowy | Linia, Punktowy, Barowy, Radar |
Lichtarz | Linia, Słupkowy |
Wszystkie inne | Linia, Punktowy, Barowy, Radar |
Oto kilka przykładów typów wykresów złożonych, które możesz utworzyć:
Typ wykresu | Opis | Przykład |
---|---|---|
Wykresy ze znacznikami liniowymi | Znaczników liniowych można używać do pokazywania trendów na wielu innych typach wykresów. | |
Wykresy świecowe | Wykresy świecowe są często używane do przedstawiania danych finansowych. | |
Wykresy punktowe | Wykresy skrzynkowe służą do wyświetlania danych pogrupowane według kwartyli zakresu. |
|
Wykresy umieszczone na stronie | Wykres możesz umieścić na innym wykresie. | |
Inne znaczniki | Dane znaczników możesz ukryć na dowolnym z dopuszczalnych typów wykresów podstawowych i używać ich z innymi typami znaczników. | chd=t1: |
Wykresy ze znacznikami liniowymi
Możesz dodawać linie do wykresów liniowych, scatter, słupkowych i radarowych, aby uwydatniać trendy.
Typ podstawy + typ znacznika | Opis | Przykład |
---|---|---|
Słupek + linia | Oto wykres słupkowy z linią logu czasu. Dwie pierwsze serie danych są używane dla słupków skumulowanych, a pozostałe – dla linii.
|
chm= |
Rozproszony + Liniowy | Do wykresu punktowego możesz dodać linię, aby pokazać średnie wartości. Pamiętaj, że na wykresach punktowych dane znaczników ukrywają się w inny sposób. Więcej informacji znajdziesz w artykule Wykresy punktowe. |
|
Słupek + linia | Oto kolejny skumulowany wykres słupkowy, na którym rysowana jest niezależna linia. |
cht=bvs |
Słupek + kółka | Taki sam jak poprzedni wykres, ale ze znacznikami kołowymi zamiast znaczników liniowych. Podaliśmy każdą wartość danych wynoszącą 0,5, co dodaje obliczone punkty pośrednie do linii przerywanej. | cht=bvs |
Wykresy świecowe
Wykresy świecowe wymagają co najmniej 4 serii danych do narysowania świecowych danych oraz dodatkowej serii na potrzeby pozostałych elementów wykresu. Na wykresach świecowych może być wyświetlany tylko zestaw znaczników świecowych albo ich połączenie z wykresami słupkowymi lub liniowymi:
Typ podstawy + typ znacznika | Opis | Przykład |
---|---|---|
Linia (ukryta) + świecznik | Ten przykład przedstawia wykres przedstawiający tylko znaczniki świecowe.
|
cht=lc |
Linia + świecznik | Oto przykład wykresu liniowego ze znacznikami świecowymi. Dostępnych jest 5 serii danych. Pierwsza jest używana do określania typu wykresu (linii), a pozostałe „ukryte” serie danych są używane na potrzeby znaczników świecowych. Parametr Pominęliśmy pierwszy i ostatni znaczniki świecowe, używając parametru Parametr |
|
Linia + świecznik | Inny przykład wykresu świecowego z niestandardowymi kolorami wypełnienia. |
chd=t1: |
Bar + świecznik | Oto przykład wykresu słupkowego ze znacznikami świecowymi. Widoczne są tu pierwsze i ostatnie znaczniki świecowe, ponieważ słupki mają odpowiednią ilość odstępu, aby nie zostały przycięte przez granice wykresu. |
cht=bvg |
Wykresy prostopadłościenne
Wykresy skrzydłowe, nazywane też wykresami boksowymi lub wykresy skrzyniowe, to typ wykresu pokazujący grupowanie według co najmniej 1 serii w kwartyle (kwartyle to grupy obejmujące 25% zakresu wartości, z możliwym wyjątkiem wartości odstających). Wykresy świecowe są podobne do wykresów świecowych, ale mają dodane znaczniki na dole i na górze świecowego oraz znacznik 50 centyla.
Wykres ramkowy składa się w całości ze znaczników, jak pokazano tutaj:
chm= |
chm= |
chm= |
|
Jeden zestaw znaczników świecowych (chm=F ) do wypełnienia pól: |
Jeden zestaw znaczników kształtu linii poziomej (chm=H ) o dowolnej długości dla linii minimalnego, 50. i 100. percentyla: |
Opcjonalnie użyj znaczników kształtu koła (chm=o ), by pokazać wartości odstające w zbiorze danych. |
Po połączeniu ich w ten sposób powstaje wykres ramkowy. |
Podstawowy typ wykresu słupkowego to dowolny z typów wykresów słupkowych (bhs
, bvs
, bhg
, bvg
) lub wykresów liniowych (lc
, ls
, lxy
). Jeśli jednak ukrywasz typ wykresu podstawowego, dodając zero w parametrze formatu danych (na przykład chd=t0:
lub chd=s0:
), wybrany typ wykresu nie ma znaczenia.
Wykres ramkowy musi zawierać co najmniej 5 serii danych: cztery pola oraz znaczniki wartości maksymalnej i minimalnej, po jednym dla znacznika 50% oraz wszelkie dodatkowe serie danych dotyczące dodatkowych wskaźników, takich jak znaczniki wyników odstających. Oto zalecana kolejność serii. Pamiętaj, że jeśli wartość w serii 1 jest większa niż wartość z serii 2, pole będzie wypełnione kolorem znacznika chm=F
. Jeśli wartość w serii 1 jest mniejsza niż wartość z serii 2, pole będzie niewypełnione.
Więcej informacji znajdziesz w artykule Znaczniki świecowe.
Kolejność w serii dla niewypełnionego pola:
- Wartość minimalna
- Znacznik 25% (75% dla wypełnionego pola)
- Znacznik 75% (25% dla wypełnionego pola)
- Wartość maksymalna
- Znacznik 50%
- Seria szósta i kolejne zawierają dodatkowe dane znaczników, takie jak wyniki odstające.
Dodatkowe serię znaczników możesz umieścić przed danymi znacznika świecowego lub za nimi, ale prościej jest umieścić je wszystkie na końcu.
Możesz tworzyć różne style wykresów skrzynkowych, określając różne znaczniki, różne typy wykresów podstawowych lub zmieniając kolejność danych.
Opis | Przykład | ||
---|---|---|---|
Jest to standardowy wykres ramkowy, w którym do różnych elementów wykresu przypisano różne kolory, które wskazują, który znacznik jest używany do tworzenia poszczególnych elementów wykresu.
|
|
||
Na wykresie LC zawsze wyświetlają się linie osi. Aby utworzyć wykres bez linii osi, wybierz typ wykresu ls. |
|
||
Aby utworzyć wypełnione pole, punkt drugiej serii powinien być większy niż odpowiadający mu punkt trzeciej serii. Większa wartość jest oznaczona na czerwono w kodzie wyświetlanym po prawej stronie. | chd=t0: |
Wykresy osadzone
Na wykresie słupkowym, liniowym, radarowym lub scatter możesz umieścić dowolny typ wykresu, korzystając z dynamicznych ikon. Zapoznaj się z sekcją Osadzone wykresy w dokumentacji znaczników ikon dynamicznych (chem
).
Funkcje standardowe
Pozostałe funkcje dostępne na tej stronie to standardowe funkcje wykresów.
Znaczniki linii chm=D
[pasek,
świecznik, linia, radar,
punktor]
Możesz dodać linię śledzącą dane na wykresie. Jest on najczęściej używany w wykresach złożonych.
Aby dodać wiele wierszy (lub połączyć je z innymi znacznikami chm
), rozdziel zestawy parametrów chm za pomocą separatora pionowej ( |
). Nie możesz używać tego parametru jako znacznika linii przerywanej.
Składnia
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- Wskazuje, że jest to znacznik liniowy.
- <color>
- Kolor linii w formacie szesnastkowym RRGGBB.
- <series_index>
- Indeks serii danych użyty do wytyczenia linii. Indeks serii danych to
0
dla pierwszej serii danych,1
dla drugiej serii danych itd. - <which_points>
- Których punktów w serii użyć do narysowania linii. Użyj jednej z tych wartości:
0
– wykorzystaj wszystkie punkty z serii.start:end
– użyj określonego zakresu punktów w serii, od początku do końca włącznie (indeks liczony od zera). Możesz też użyć wartości zmiennoprzecinkowych, aby określić punkty pośrednie, albo pozostawić pola start lub end puste, aby wskazać odpowiednio pierwszy lub ostatni punkt danych. Wartości start i end mogą być ujemne (jako odwrotny indeks od ostatniej wartości). Jeśli wartości start i end są ujemne, wpisz je w rosnącej wartości (np. -6:-1).
- <size>
- Szerokość linii w pikselach.
- <opt_z_order>
- [opcjonalny] – warstwa, na której chcesz narysować znacznik, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa od -1,0 do 1,0 włącznie, gdzie -1,0 to dół, a 1,0 góra. Elementy wykresu (linie i słupki) mają wartość tylko poniżej zera. Jeśli 2 znaczniki mają tę samą wartość, zostaną narysowane w kolejności podanej w adresie URL. Wartość domyślna to 0,0 (tuż nad elementami wykresu).
Przykłady
Opis | Przykład |
---|---|
Ten przykład pokazuje rysowanie linii znacznika na wykresie słupkowym.
Kolejność nakładania elementów jest ustawiona na |
chm=D,0033FF,0,0,5,1 |
Jest to ten sam wykres słupkowy, ale zawiera dodatkową serię danych dotyczących linii. To jest przykład wykresu złożonego.
Wykresy złożone są rysowane przez dodanie do parametru Więcej informacji znajdziesz w artykule Wykresy złożone. |
chm=D,0033FF,1,0,5,1 |
Znaczniki kształtów chm
[pasek, linia, radar, punktowy]
Na wykresie można określić znaczniki graficzne dla wszystkich lub poszczególnych punktów danych. Jeśli w tym samym punkcie znajdują się co najmniej 2 znaczniki, zostaną one wyświetlone w kolejności, w jakiej występują w parametrze chm
.
W punktach danych możesz też tworzyć znaczniki tekstowe, które są opisane w sekcji Znaczniki punktów danych.
Znaczniki kształtów możesz łączyć z dowolnymi innymi parametrami chm
za pomocą pionowej kreski ( |
), aby rozdzielić parametry chm
.
Składnia
Określ 1 zestaw poniższych parametrów dla każdej serii, którą chcesz oznaczyć. Aby oznaczyć wiele 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 będzie ona miała żadnych znaczników.
Na wykresach punktowych znaczniki kształtów zachowują się nieco inaczej. 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>
- @
- [Opcjonalny] Jeśli poprzedzasz typ znacznika opcjonalnym znakiem @, to parametr <opt_who_points> powinien mieć format x:y.
- <marker_type>
- Typ znacznika, którego należy użyć. Określ jeden z tych typów:
a
– strzałkac
– krzyżykC
– prostokąt. W przypadku znacznika prostokątnego wymagane są 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
– diamentE
– znacznik na pasku błędów ( ). Ten znacznik wymaga do utworzenia 2 serii danych: jednej wartości dla dołu i odpowiadającego mu punktu w drugiej serii dla góry. Wyświetla także rozszerzoną składnię atrybutu <size>: line_thickness[:top_and_bottom_width], gdzie top_and_bottom_width jest opcjonalny. Zobacz poniższe przykłady.h
– pozioma linia na wykresie o określonej wysokości. (Jedynym prawidłowym formatem parametru <opt_which_points> jest opt_which_points.H
– pozioma linia przecinająca określony znacznik danych. Ta składnia obsługuje rozszerzoną składnię <size>, która pozwala określić dokładną długość linii: line_thickness[:length], gdzie długość jest opcjonalna i domyślnie przedstawia pełną szerokość obszaru wykresu.o
– krągs
– kwadratv
– pionowa linia od osi X do punktu danychV
– pionowa linia o dostosowanej długości. Obsługuje rozszerzoną składnię wartości <size>, która pozwala określić dokładną długość linii: line_thickness[:length], gdzie :długość jest opcjonalna i domyślnie przedstawia pełną wysokość obszaru wykresu. Znacznik jest wyśrodkowany na punkcie danych.x
– An X
- <color>
- Kolor znaczników tej serii w formacie szesnastkowym RRGGBB.
- <series_index>
- Indeks (liczony od zera) serii danych, na podstawie którego mają być narysowane znaczniki. Ignorowany w przypadku znaczników
h
, które określają lokalizację według pozycji x/y (zaczyna się od znaku @). Ukryte serie danych mogą służyć jako źródło znaczników. Więcej informacji znajdziesz w artykule Wykresy złożone. Zgrupowane pionowe wykresy słupkowe obsługują specjalną rozszerzoną składnię, która pozwala wyrównywać znaczniki z konkretnymi słupkami. - <opt_which_points>
- [opcjonalny] – punkty, na których chcesz rysować znaczniki. Wartość domyślna to wszystkie znaczniki. Użyj jednej z tych wartości:
n.d
– gdzie chcesz narysować znacznik. Znaczenie zależy od typu znacznika:- Wszystkie typy oprócz h – punkt danych, w którym chcesz narysować znacznik, gdzie n.d to indeks w serii liczony od zera. Jeśli podasz wartość niebędącą liczbą całkowitą, ułamek będzie oznaczał obliczony punkt pośredni. Na przykład 3, 5 oznacza połowę drogi między punktem 3 a 4.
h
– liczba od 0,0 do 1,0, gdzie 0,0 to dół wykresu, a 1,0 – górna część wykresu.
-1
– narysuj znacznik na wszystkich punktach danych. Możesz też pozostawić ten parametr pusty, aby umożliwić rysowanie na wszystkich punktach danych.-n
– narysuj znacznik w każdym n-tym punkcie danych. Wartość zmiennoprzecinkowa; jeśli n jest mniejsza niż 1, wykres obliczy dodatkowe punkty pośrednie. Na przykład wartość -0,5 spowoduje umieszczenie dwukrotnie większej liczby znaczników niż punktów danych.start:end:n
– narysuj znacznik w każdym n-tym punkcie danych w zakresie od początku do końcowego wartości indeksu włącznie. Wszystkie parametry są opcjonalne (mogą być niedostępne), więc 3::1 będzie wskazywać ostatni element (krok 1), a pominięcie tego parametru spowoduje jego całkowite pominięcie domyślnie: first:last:1. Wszystkie wartości mogą być liczbami zmiennoprzecinkowym. start i end mogą być ujemne, by odliczać wstecz od ostatniej wartości. Jeśli wartości start i end są ujemne, pamiętaj, by podać je jako wartość rosnącą (np. -6:-1:1). Jeśli wartość kroku n jest mniejsza niż 1, oblicza dodatkowe punkty danych, interpolując podane wartości danych. Wartości domyślne to first:last:1x:y
– narysuj znacznik w określonym punkcie x/y na wykresie. Ten punkt nie musi być linią. Aby użyć tej opcji, dodaj znak @ przed typem znacznika. Określ współrzędne jako wartości zmiennoprzecinkowe, gdzie0:0
to lewy dolny róg wykresu, a1:1
to jego prawy górny róg. Aby na przykład dodać czerwony 15-pikselowy romb pośrodku wykresu, użyj funkcji@d,FF0000,0,0.5:0.5,15
.
- <size>
- Rozmiar znacznika w pikselach. W większości przypadków ten parametr przyjmuje jedną wartość liczbową. Znaczniki V, H i S obsługują składnię <size>[:width], gdzie opcjonalna część druga określa długość linii lub znacznika.
- <opt_z_order>
- [opcjonalny] – warstwa, na której chcesz narysować znacznik, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa od -1,0 do 1,0 włącznie, gdzie -1,0 to dół, a 1,0 góra. Elementy wykresu (linie i słupki) mają wartość tylko poniżej zera. Jeśli 2 znaczniki mają tę samą wartość, zostaną narysowane w kolejności podanej w adresie URL. Wartość domyślna to 0,0 (tuż nad elementami wykresu).
- <opt_offset>
- [opcjonalny] – pozwala określić odsunięcia w poziomie i w pionie od określonej lokalizacji. Oto składnia wykorzystująca separator „:”:
reserved:<horizontal_offset>:<vertical_offset>
. Jeśli podasz pustą wartość, w ciągu parametruchm
parametru <opt_z_order> możesz umieścić na niej pustą wartość. 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. Opcjonalne. Jeśli nie jest używane, pozostaw puste.<vertical_offset>
– liczba dodatnia lub ujemna w pikselach określająca przesunięcie w pionie. Opcjonalne. Jeśli nie jest używane, pozostaw puste.
Przykłady
Opis | Przykład |
---|---|
Oto przykład kilku znaczników kształtu i linii.
|
chm= |
Oto przykład użycia romb w jednej serii danych, a okręgów dla pozostałych serii danych. Jeśli w tym samym punkcie znajduje się co najmniej 2 znaczniki, zostaną one wyświetlone w kolejności, w jakiej występują w parametrze |
chm= |
Oto wykres liniowy ze znacznikiem w każdym drugim punkcie danych (–2 oznacza co drugi punkt). |
chd=t: |
Oto wykres liniowy z 2 razy większą liczbą znaczników niż punktów danych (-0,5 oznacza co pół punktu). | chd=t: |
Ten przykład pokazuje, jak używać znaczników h i v do tworzenia linii siatki o niestandardowych kolorach i grubości. Wartość kolejności nakładania elementów (ostatnia wartość) jest ustawiona na -1, dzięki czemu linie siatki są rysowane pod linią danych. |
chm= |
Ten wykres dodaje do wykresu liniowego pionowe linie wypełnienia:
|
chm= |
W tym przykładzie dodano do wykresu strzałkę i znacznik tekstowy z użyciem dokładnych współrzędnych. Pierwszy znacznik D to linia logu czasu pod słupkami. Drugi znacznik to strzałka, a trzeci – tekst strzałki. | chm= |
Pozioma linia ustalonego punktu danych (H ) może być przydatna do wskazywania wartości względnych lub podkreślania wysokości wartości danych na wykresie. |
chm=H,FF0000,0,18,1 |
Ten wykres pokazuje znaczniki, które mogą określać grubość i długość linii w parametrze <size>.
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,3.02,5:50%chm=
|
Znaczniki świecowe chm=F
[pasek,
linia]
Znaczniki świecowe wskazują wariancję i zmianę kierunku w serii danych. Często służą do wyświetlania wartości akcji w ciągu dnia. Znacznik zawiera segmenty pokazujące najwyższą i niską wartość, a także wartość otwarcia i zamknięcia w określonym przedziale czasu (zwykle w ciągu jednego dnia). Więcej informacji o znacznikach świecowych znajdziesz tutaj.
Znacznik świecy jest rysowany jako prostokąt przecięty pionową linią. Rysowanie znacznika świecowego wymaga 4 serii danych. Oto co oznaczają poszczególne serie:
- Seria 1 i 4 określają odpowiednio dolną i górną linię pionowej. Są to zwykle dolne i wysokie wartości obowiązujące w danym dniu.
- Seria 2 i 3 określają pionowe krawędzie prostokąta. Seria 2 to wartość otwarcia, a seria 3 to wartość zamknięcia. Kolor prostokąta zależy od tego, który jest wyższy: gdy wartość otwarcia (seria 2) jest niższa niż wartość zamknięcia (seria 3), cena wzrosła, a prostokąt jest domyślnie wypełniany stałym kolorem zielonym. Gdy wartość otwarcia (seria 2) jest wyższa niż wartość zamknięcia (seria 3), cena zmalała, a prostokąt jest domyślnie wypełniony kolorem czerwonym. Możesz określić tylko kolor wypełnienia prostokąta o malejącej wartości. Jeśli tak, prostokąt o rosnącej wartości będzie niewypełniony (pusty). Seria 2 może się znajdować u góry lub na dole prostokąta, w zależności od tego, czy cena wzrosła czy spadła.
Znaczniki świecowe można łączyć z dowolnymi innymi parametrami chm
za pomocą pionowej kreski ( |
), aby rozdzielić parametry chm
.
Uwaga: jeśli nie chcesz, aby linie danych używane do rysowania znaczników pojawiały się na wykresie, musisz wpisać 0 po typie formatu. Na przykład: chd=t0:10,20,30,40
w ciągu znaków danych w formacie tekstowym. Więcej informacji znajdziesz w artykule Wykresy złożone.
Oto przykład ilustrujący wiersze poszczególnych serii:
Składnia
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- F
- Wskazuje, że jest to znacznik świecowy.
- <opt_declining_color>
- [Opcjonalnie] Kolor wypełnienia prostokątów, gdy wartość się zmniejsza (gdy wartość serii 2 > odpowiadająca jej wartość serii 3). Jest to liczba szesnastkowa w formacie RRGGBB. Gdy wartości wzrosną, prostokąt staje się pusty. Domyślnym kolorem jest pełny zielony kolor, gdy rośnie, a kolor czerwony – malejący (nie można określić niestandardowego koloru wypełnienia dla wartości rosnących).
- <data_series_index>
- Indeks serii danych, która ma być używana jako pierwsza seria dla znaczników świecowych. Indeks jest liczony od zera. Jeśli więc podasz tutaj 1 i będziesz mieć sześć serii, druga, trzecia, czwarta i piąta zostaną użyte do narysowania znaczników świecowych.
- <opt_who_points>
- [opcjonalny] – określa punkty danych używane do rysowania znaczników. Wartość domyślna to wszystkie znaczniki. Użyj jednego z tych formatów:
n.d
– narysuj znacznik w pojedynczym punkcie serii, gdzie n.d to indeks punktu serii. Jeśli podasz wartość niebędącą liczbą całkowitą, ułamek będzie oznaczał obliczony punkt pośredni. Na przykład 3, 5 oznacza połowę drogi między punktem 3 a 4.-1
– narysuj znacznik na wszystkich punktach danych. Możesz też pozostawić ten parametr pusty, aby umożliwić rysowanie 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 początku do końcowego wartości indeksu włącznie. Wszystkie parametry są opcjonalne (mogą być niedostępne), więc 3::1 będzie wskazywać ostatni element (krok 1), a pominięcie tego parametru spowoduje jego całkowite pominięcie domyślnie: first:last:1. Wszystkie wartości mogą być liczbami zmiennoprzecinkowym. start i end mogą być ujemne, by odliczać wstecz od ostatniej wartości. Jeśli wartości start i end są ujemne, pamiętaj, by podać je jako wartość rosnącą (np. -6:-1:1). Jeśli wartość kroku n jest mniejsza niż 1, oblicza dodatkowe punkty danych, interpolując podane wartości danych. Wartości domyślne to first:last:1
- <width>
- Szerokość wszystkich prostokątów (w pikselach).
- <opt_z_order>
- [opcjonalny] – warstwa, na której chcesz narysować znacznik, w porównaniu z innymi znacznikami i wszystkimi innymi elementami wykresu. Jest to liczba zmiennoprzecinkowa od -1,0 do 1,0 włącznie, gdzie -1,0 to dół, a 1,0 góra. Elementy wykresu (linie i słupki) mają wartość tylko poniżej zera. Jeśli 2 znaczniki mają tę samą wartość, zostaną narysowane w kolejności podanej 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 Pierwszy i ostatni prostokąt są przycinane przez wykres. Aby wyeliminować te wartości, możesz określić 1:4 dla czwartego parametru chm. Zanotuj zero w ciągu danych, aby ukryć wiersze serii: Parametr <which_point> jest pusty, co powoduje wyświetlanie świec za pomocą wszystkich punktów danych. |
chd=t0: |
Oto przykład takiego samego wykresu z kolorami domyślnymi oraz z usunięciem pierwszego i ostatniego elementu. Ten wykres złożony jest połączeniem wykresu liniowego (typu podstawowego) i znaczników świecowych. Wartość 1 w |
|