W tym dokumencie opisujemy, jak tworzyć wykresy kołowe za pomocą interfejsu Chart API.

Spis treści

Omówienie

Wykresy kołowe nadają się do przedstawienia prostych proporcjonalnych części informacji. Możesz utworzyć wykres kołowy z 1 serią, gdzie każda seria jest złożona z wielu wycinków lub wykresów koncentrycznych z wieloma seriami.

Każda seria opisuje jeden kołowy, a każda wartość danych określa jeden wycinek. Gdy używasz zagnieżdżonych wykresów kołowych (opisanych poniżej), używaj wielu serii.

Aby wyświetlić tekst powiązany z wycinkiem, musisz użyć etykiet wykresu kołowego lub legendy wykresu. Etykiety wykresu kołowego to tekst wokół wykresu, który wskazuje linie wskazujące ten wycinek. Legendy to tekst powiązany z kolorem.

Etykiety	Legenda	Etykiety i legenda
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

Wartości są wyświetlane względem siebie nawzajem, więc wykres z wartościami 1, 2 i 3 będzie wyglądać tak samo jak wykres z wartościami 100 200 300. Jednak podczas korzystania z danych w formacie tekstowym wartości większe niż 100 są przycinane do 100, dlatego musisz użyć formatu tekstowego ze skalowaniem niestandardowym, aby prawidłowo wyświetlić wycinki większe niż 100 (użyj parametru chds z wartościami minimalnymi i maksymalnymi chds=0,<max-slice-size>).

Wartości ujemne są wyświetlane jako puste wycinki odpowiedniego rozmiaru.

Typy wykresów

Istnieją 3 ogólne typy wykresów kołowych: płaski, koncentryczny i 3D. Określ wykres kołowy o następującej składni:

Składnia

cht=<chart_type>

Gdzie <chart_type> należy do tych typów:

Parametr	Opis	Przykład
p	Dwuwymiarowy wykres kołowy. Podaj tylko jedną serię danych, kolejne serie są ignorowane. Domyślnie kolory segmentów kołowych są interpolowane od ciemnopomarańczowego do jasnopomarańczowego. Określ inne kolory zgodnie z opisem w sekcji Kolory serii. Określ etykiety za pomocą atrybutu chl zgodnie z opisem w sekcji Etykiety wykresu kołowego. Interfejs Google Chart API oblicza promień okręgu na podstawie minimalnej szerokości i wysokości określonej w parametrze rozmiaru wykresu (chs). Jeśli dodajesz etykiety, prawdopodobnie musisz ustawić szerokość, by była dwa razy większa niż wysokość, aby etykiety były w pełni widoczne.	cht=p chs=200x100
p3	Trójwymiarowy wykres kołowy. Dane i formatowanie możesz określić w ten sam sposób, jak w przypadku dwuwymiarowych wykresów kołowych. Jeśli umieszczasz etykiety w trójwymiarowym wykresie kołowym, prawdopodobnie konieczne będzie określenie szerokości do 2,5 raza większej niż wysokość, aby etykiety były w pełni widoczne.	cht=p3 chs=250x100
pc	Koncentryczny wykres kołowy. Podaj co najmniej dwie serie danych.	cht=pc chd=s:Helo,Wrld
Wszystkie typy	Liczby ujemne w danych powodują „puste” wycinki.	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

Kolory serii chco

Możesz określić kolory wszystkich lub poszczególnych wartości albo niektóre wartości, używając parametru chco.

Składnia

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

<color>

Wycinanie kolorów w formacie szesnastkowym RRGGBB. Określ jeden kolor serii, a wszystkie wycinki w tej serii będą pokolorowane według stopni od najciemniejszego (pierwszy członek danych) do najjaśniejszego (ostatniego członka danych). Aby opisać poszczególne kolory wycinków, podaj co najmniej 2 kolory rozdzielone znakiem |. Jeśli masz wiele serii (czyli wykres ze współśrodkowymi pierścieniami), możesz określić wartości dla różnych serii, rozdzielając je przecinkami. Jeśli kolorów wycinków lub serii jest wyświetlanych mniej, wykres będzie cyklicznie wyświetlany od początku listy wycinków serii lub listy serii na wykresie. Nie możesz określić osobnego gradientu dla każdej serii na wykresie wieloseriaowym.

Opis	Przykład
Określ jeden kolor, aby zastosować różnice od najciemniejszego (pierwszy wycinek) do najjaśniejszego (ostatni wycinek).	chco=0000FF
Definiowanie gradientu, czyli od żółtego do czerwonego.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
Definiowanie kolorów wycinków; określ jeden kolor dla każdego wycinka.	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
Ten wykres ma 2 serie danych, ale określa kolor jako pojedynczy gradient na wszystkich wycinkach, od żółtego do czerwonego (BBBB00–BB0000).	chco=BBBB00,BB0000
Oto wykres koncentryczny, który zawiera kolory zarówno serii, jak i poszczególnych kolorów wycinków. Wykres ma 2 koncentryczne serie danych. W postaci zrozumiałej dla człowieka kolory to chco=green|red, blue|żółty. Przecinek dzieli tę wartość na 2 serie: zielony|czerwony – wycinki naprzemiennie zielone i czerwone. niebieski|żółty – paski naprzemiennie niebieskie i żółte.	chd=s:eYY,ORVM chco=008800|880000,000088|888800

Powrót do góry

Etykiety wykresu kołowego chl

Etykiety poszczególnych wycinków wykresu kołowego możesz określić za pomocą parametru chl. Możesz także wyświetlić legendę o takich samych lub różnych wartościach, z 1 wpisem legendy na wycinek.

Uwaga o wartościach ciągów: w ciągach etykiet można używać tylko znaków, które można używać w adresach URL. Dla bezpieczeństwa najlepiej zakoduj w adresie URL ciągi zawierające znaki, których nie ma w zestawie znaków 0-9a-zA-Z. Koder adresów URL znajdziesz tutaj.

Składnia

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

<label_value>

Wartość ciągu znaków do zastosowania do wycinka. Etykiety są stosowane kolejno do punktów danych w funkcji chd. Jeśli masz wiele serii (np. koncentryczny wykres kołowy), etykiety będą stosowane do wszystkich punktów we wszystkich ciągach w kolejności określonej w funkcji chd. Między poszczególnymi etykietami umieść separator pionowy ( |). Określ brakującą wartość interwencji, używając 2 kolejnych kreski pionowej bez spacji: || . Nie musisz oznaczać etykietami wszystkich wycinków.

 

Przykłady

Opis	Przykład
Etykiety trójwymiarowego wykresu kołowego.	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
Określając rozmiar wykresu za pomocą funkcji chs, zastanów się, ile miejsca potrzebują etykiety. Aby etykiety były prawidłowo wyświetlane, dwuwymiarowy wykres kołowy musi być około dwa razy szerszy niż wysoki, a trójwymiarowy wykres kołowy musi być około dwa i pół raza szerszy niż wysoki. W pierwszym przykładzie etykiety są wyświetlane tylko częściowo, ponieważ wykres nie jest wystarczająco szeroki. Drugi przykład pokazuje, że aby etykiety były wyświetlane w całości, wykres musi mieć szerokość 280 pikseli. (Granice dodane bezpośrednio do elementu <img>).	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

Powrót do góry

Rotacja wykresu kołowego chp

Domyślnie pierwsza seria jest rysowana od godz. 3:00 i kontynuuje wzdłuż wykresu w prawo. Możesz jednak określić rotację niestandardową za pomocą parametru chp.

Składnia

chp=<radians>
  

<radians>

Wartość zmiennoprzecinkowa określająca, ile radianów ma być obrócony wykres w prawo. Jeden pełny obrót to 2π (2 pi, czyli około 6,28) radiana.

Przykłady

Opis	Przykład
Aby zmienić orientację wykresu kołowego, użyj funkcji chp=<angle_in_radians>	chd=t:20,80 chd=t:80,20 chp=0.628
Oto kolejny przykład obrotu wykresu kołowego. Możesz je połączyć ze znacznikami kształtu wykresu, aby uzyskać ciekawe efekty.

 

Powrót do góry

Funkcje standardowe

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

Tytuł wykresu chtt, chts [Wszystkie wykresy]

Możesz określić tekst tytułu, kolor i rozmiar czcionki wykresu.

Składnia

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

 

chtt – określa tytuł wykresu.

<chart_title>

Tytuł do wyświetlenia na wykresie. Nie możesz określić, gdzie będzie ona widoczna, ale możesz opcjonalnie określić rozmiar i kolor czcionki. Użyj znaku + do oznaczenia spacji oraz kreski pionowej ( |) do oznaczenia podziałów wiersza.

 

chts [opcjonalny] – kolory i rozmiar czcionki w parametrze chtt.

<color>

Kolor tytułu w formacie szesnastkowym RRGGBB. Domyślny kolor to czarny.

<font_size>

Rozmiar czcionki tytułu (w punktach).

<opt_alignment>

[Opcjonalnie] Wyrównanie tytułu. Wybierz jedną z tych wartości ciągu znaków (z uwzględnieniem wielkości liter): „l” (po lewej), „c” (na środku) „r” (po prawej). Wartość domyślna to „c”.

 

Przykłady

Opis	Przykład
Wykres z tytułem, z domyślnym kolorem i rozmiarem czcionki. Wpisz spację za pomocą znaku plusa (+). Aby wymusić podział wiersza, użyj pionowej kreski (|). Nie określono tutaj: chts.	chtt=Site+visitors+by+month| January+to+July
Wykres z 20-punktowym tytułem niebieskim wyrównanym do prawej.	chtt=Site+visitors chts=FF0000,20,r

Powrót do góry

Tekst i styl legendy wykresu chdl, chdlp, chdls [Wszystkie wykresy]

Legenda to boczna sekcja wykresu, która zawiera krótki opis każdej serii. W legendzie możesz podać tekst powiązany z każdą serią i wskazać miejsce na wykresie, w którym ma się ona pojawić.

Aby dowiedzieć się, jak ustawić marginesy legendy, zapoznaj się z artykułem chma.

Uwaga na temat wartości ciągów: w ciągach etykiet dozwolone są tylko znaki, które można używać w adresach URL. Dla bezpieczeństwa najlepiej zakoduj w adresie URL ciągi zawierające znaki, których nie ma w zestawie znaków 0-9a-zA-Z. Koder adresów URL znajdziesz w dokumentacji wizualizacji Google.

Składnia

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

 

chdl – tekst każdej serii do wyświetlenia w legendzie.

<data_series_label>

Tekst wpisów legendy. Każda etykieta ma zastosowanie do odpowiedniej serii w tablicy chd. Użyj znaku + jako spacji. Jeśli nie określisz tego parametru, na wykresie nie pojawi się legenda. Nie ma możliwości określenia podziału wiersza w etykiecie. Legenda zazwyczaj rozwija się, by umieścić w niej tekst, a obszar wykresu jest pomniejszony, by zmieścić legendę.

chdlp – [opcjonalnie] pozycja legendy i kolejność wpisów legendy. Możesz określić elementy <position> lub <label_order>. Jeśli podasz obie te wartości, rozdziel je znakiem słupka. Możesz dodać „s” do dowolnej wartości, jeśli chcesz, aby puste pozycje legendy z zakresu chdl były pomijane w legendzie. Przykłady: chdlp=bv, chdlp=r, chdlp=bv|r, chdlp=bvs|r

<opt_position>

[Opcjonalnie] Określa pozycję legendy na wykresie. Aby określić dodatkowe dopełnienie między legendą a obszarem wykresu lub obramowaniem obrazu, użyj parametru chma. Wybierz jedną z tych wartości:

• b – legenda u dołu wykresu, wpisy legendy w poziomym wierszu.
• bv – legenda u dołu wykresu, wpisy legendy w pionowej kolumnie.
• t – legenda u góry wykresu, wpisy legendy w poziomym wierszu.
• tv – legenda u góry wykresu, wpisy legendy w pionowej kolumnie.
• r – [wartość domyślna] legenda z prawej strony wykresu, wpisy legendy w pionowej kolumnie.
• l – legenda z lewej strony wykresu, wpisy legendy w pionowej kolumnie.

<opt_label_order>

[opcjonalny] Kolejność, w jakiej etykiety są wyświetlane w legendzie. Wybierz jedną z tych wartości:

• l – [domyślnie dla legend pionowych] wyświetlaj etykiety w kolejności podanej w polu chdl.
• r – etykiety wyświetlają się w odwrotnej kolejności, w jakiej podano w polu chdl. Przydaje się to na skumulowanych wykresach słupkowych, by pokazać legendę
  w tej samej kolejności, w jakiej pojawiają się słupki.
• a – [Domyślnie dla legend poziomych] Sortowanie automatyczne: oznacza sortowanie według długości, zaczynając od najkrótszej (mierzonej na 10 pikselowych bloków). Gdy 2 elementy są tej samej długości (podzielone na bloki po 10 pikseli), jako pierwszy wyświetli się ten wymieniony jako pierwszy.
• 0,1,2... – kolejność etykiet własnych. To jest lista indeksów etykiet liczonych od zera z pola chdl, rozdzielonych przecinkami.

chdls – [opcjonalny] – określa kolor i rozmiar czcionki tekstu legendy.

<color>

Kolor tekstu legendy w formacie szesnastkowym RRGGBB.

<size>

Rozmiar punktu w tekście legendy.

 

Przykłady

Opis	Przykład
Dwa przykłady legend. Wpisz tekst legendy w tej samej kolejności co w serii danych.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
Pierwszy wykres przedstawia poziome wpisy legendy (chdlp=t, domyślny układ to poziomy), a na drugim znajdują się dolne wpisy legendy pionowej (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
Ten przykład pokazuje zmianę rozmiaru czcionki.	chdls=0000CC,14

Powrót do góry

Marginesy wykresu chma [Wszystkie wykresy]

Możesz określić rozmiar marginesów wykresu w pikselach. Marginesy są obliczane do wewnątrz od określonego rozmiaru wykresu (chs). Jeśli to konieczne, zwiększenie marginesu nie zwiększy łącznego rozmiaru wykresu, ale w razie potrzeby zmniejszy jego obszar.

Domyślnie marginesy są pozostawione po obliczeniu rozmiaru wykresu. Ta wartość domyślna różni się w zależności od typu wykresu. Określone marginesy są wartością minimalną. Jeśli w obszarze wykresu pozostawia miejsce na marginesy, rozmiar marginesu będzie wynosić tyle, ile zostało. Nie możesz ściśnąć marginesów mniejszych niż wymagane w przypadku legend i etykiet. Oto schemat przedstawiający podstawowe elementy wykresu:

Marginesy wykresu obejmują etykiety osi i obszar legendy. Rozmiar obszaru legendy zmienia się automatycznie, aby dokładnie pasował do tekstu, chyba że określisz większą szerokość za pomocą parametru chma. W takim przypadku margines zostanie poszerzony, a obszar wykresu zostanie zmniejszony. Nie można przyciąć legendy przez określenie zbyt małego rozmiaru, ale można zmniejszyć, aby zajmowała więcej miejsca. Wskazówka: jeśli słupki na wykresie słupkowym mają stały rozmiar (domyślnie), nie można zmniejszyć szerokości obszaru wykresu. Musisz określić mniejszy lub możliwy do zmiany rozmiar paska za pomocą właściwości chbh.

 

Składnia

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

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

Minimalny rozmiar marginesu wokół obszaru wykresu (w pikselach). Zwiększ tę wartość, aby uwzględnić pewne dopełnienie, dzięki czemu etykiety osi nie zderzają się z granicami wykresu.

<opt_legend_width>, <opt_legend_height>

[Opcjonalnie] Szerokość marginesów wokół legendy (w pikselach). Korzystaj z tej opcji, aby legenda nie zsunęła się o obszar wykresu ani na krawędzie obrazu.

 

Przykłady

Opis	Przykład
W tym przykładzie minimalny margines to 30 pikseli z każdej strony. Legenda wykresu ma ponad 30 pikseli szerokości, dlatego margines po prawej stronie jest ustawiony na szerokość legendy wykresu i różni się od pozostałych. Etykiety osi są poza obszarem wykresu, dlatego są rysowane w marginesie.	chma=30,30,30,30
Aby dodać margines do legendy, ustaw wartości parametrów <opt_legend_width> i <opt_legend_height>. W tym przykładzie legenda ma około 60 pikseli szerokości. Jeśli ustawisz <opt_legend_width> na 80 pikseli, margines będzie się wydłużać o 20 pikseli poza legendą.	chma=20,20,20,30|80,20

Powrót do góry

Style osi i etykiety [linia, słupkowy, wymiar Google, radar, punktowy]

Możesz określić, które osie mają być wyświetlane na wykresie, i nadać im własne etykiety oraz pozycje, zakresy i style.

Nie wszystkie wykresy domyślnie pokazują linie osi. Za pomocą parametru chxt możesz dokładnie określić osie, które mają być widoczne na wykresie. Domyślne linie osi nie pokazują liczb. Aby wyświetlać liczby, musisz określić oś w parametrze chxt.

Możesz zdecydować, czy osie mają być wyświetlane liczby odzwierciedlające wartości danych, czy też określić osie niestandardowe. Domyślnie wyświetlane są wartości liczbowe ze skalowaniem w zakresie od 0 do 100. Możesz jednak zmienić ten zakres za pomocą funkcji chxr, aby wyświetlić dowolny zakres, a styl wartości (np. aby pokazać symbole walut lub miejsca po przecinku) za pomocą chxs.

Jeśli chcesz użyć wartości niestandardowych, np. „Pn., Wt., Śr.”, możesz użyć parametru chxl. Aby umieścić te etykiety w określonych miejscach na osi, użyj parametru chxp.

Za pomocą parametrów chxs i chxtc możesz określić kolor, rozmiar, wyrównanie i inne właściwości zarówno niestandardowych, jak i liczbowych etykiet osi.

Uwaga na temat wartości ciągów: w ciągach etykiet dozwolone są tylko znaki, które można używać w adresach URL. Dla bezpieczeństwa najlepiej zakoduj w adresie URL ciągi zawierające znaki, których nie ma w zestawie znaków 0-9a-zA-Z. Koder adresów URL znajdziesz w dokumentacji wizualizacji Google.

W tej sekcji omówiono następujące tematy:

• Widoczne osie (chxt) – osie do wyświetlenia.
• Zakres osi (chxr) – zakres wartości dla każdej osi.
• Niestandardowe etykiety osi (chxl) – wartości niestandardowe wyświetlane na osi.
• Pozycje etykiet osi (chxp) – umieszczanie etykiet własnych wzdłuż każdej osi.
• Style etykiet osi (chxs) – kolor, rozmiar, wyrównanie i formatowanie etykiet osi.
• Style znaczników osi (chxtc) – długość znaczników dla konkretnej osi.

---

Widoczne osie chxt

Wykresy słupkowe, liniowe, radarowe i punktowe domyślnie pokazują jedną lub dwie linie osi, ale nie zawierają one żadnych wartości. Aby wyświetlić wartości na liniach osi lub zmienić wyświetlane osie, musisz użyć parametru chxt. Domyślnie wartości na osi czasu mieszczą się w zakresie od 0 do 100, chyba że samodzielnie skalujesz je za pomocą właściwości chxr. Aby ukryć wszystkie linie osi na wykresie liniowym, wpisz :nda po wartości typu wykresu w parametrze cht (np. cht=lc:nda).

Domyślnie na osiach górnej i dolnej nie są wyświetlane znaczniki wartości, ale są one widoczne dla lewej i prawej osi. Możesz zmienić to działanie za pomocą parametru chxs.

Składnia

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

<axis>

Osie wyświetlane na wykresie. Dostępne osie:

• x – dolna oś X
• t – górna oś X [nieobsługiwana przez Google-o-Meter]
• y – lewa oś Y
• r – Prawa oś Y [obsługa nieobsługiwana przez Google-o-Meter]

Możesz podać wiele osi tego samego typu, na przykład: cht=x,x,y. Spowoduje to stos 2 zestawów osi X na dole wykresu. Jest to przydatne przy dodawaniu etykiet własnych na osi, która zawiera wartości liczbowe (zobacz przykład poniżej). Osie są rysowane od wewnątrz, więc jeśli masz x,x, pierwszy znak x odnosi się do najbardziej wewnętrznej kopii, kolejny znak X odnosi się do kolejnej kopii na zewnątrz itd.

 

Przykłady

Opis	Przykład
Ten przykład przedstawia wykres liniowy z osią X, osią Y, górną (T) i prawą osią (R). Nie określono żadnych etykiet, dlatego domyślnie dla wszystkich osi wykresu jest ustawiony zakres od 0 do 100. Pamiętaj, że domyślnie górna i dolna osie nie pokazują znaczników przy etykietach.	chxt=x,y,r,t
Możesz dodać wiele zestawów etykiet dla każdej osi, podając tę samą wartość więcej niż raz. Ten przykład pokazuje 2 zestawy osi x i 2 zestawy osi y. Jest to szczególnie przydatne, gdy używasz tylko domyślnych etykiet osi, jak tu pokazano. Możesz jednak określić etykiety własne dla każdej kopii każdej osi, korzystając z parametru chxl.	<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHHKUju9uuXUc&chco=76A4FB&chls=2.0xy"20",translate="xyx"20" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHHKUju9uuXUc&chco=76A4FB&chls=2.0x1chs=20%&chls=2.0x2%High%5
Ten przykład przedstawia poziomy wykres słupkowy z osią X, Y, górną i prawą osią R. Etykiety osi są pomijane, więc interfejs Chart API wyświetla zakres od 0 do 100 dla osi X i osi T. Zakres dla osi Y i R jest określany na podstawie liczby słupków. W tym przypadku ma 5 słupków, więc interfejs Chart API wyświetla zakres od 0 do 4. Pierwsza etykieta jest wyśrodkowana u podstawy pierwszego słupka, druga jest wyśrodkowana u podstawy drugiego słupka itd.	chxt=x,y,r,t
Możesz pominąć osie domyślne na wykresie liniowym, określając :nda za typem wykresu.	cht=lc:nda

Powrót do góry

Zakres osi chxr

Zakres wartości wyświetlanych na każdej osi możesz określić niezależnie za pomocą parametru chxr. Pamiętaj, że nie zmienia to skali elementów wykresu, a jedynie skali etykiet osi. Jeśli liczby na osi mają opisywać rzeczywiste wartości danych, ustaw parametry <start_val> i <end_val> odpowiednio na dolną i górną wartość zakresu formatów danych. Więcej informacji znajdziesz w artykule Skalowanie osi.

Aby określić zakres osi, musisz ustawić ją tak, aby była widoczna za pomocą parametru chxt.

Aby określić wartości osi niestandardowych, użyj parametru chxl.

Składnia

Zakresy etykiet wielu osi oddziel pionową kreską ( |).

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

<axis_index>

Na którą oś chcesz zastosować etykiety. Jest to liczony od zera indeks do tablicy osi określonej przez funkcję chxt. Na przykład oś r miałaby wartość 1 w polu chxt=x,r,y.

<start_val>

Liczba określająca niską wartość dla tej osi.

<end_val>

Liczba określająca wysoką wartość dla tej osi.

<opt_step>

[Opcjonalnie] Liczba kroków między znacznikami na osi. Nie ma domyślnej wartości kroku. Kroki mają na celu wyświetlenie zestawu odpowiednio rozmieszczonych etykiet.

 

Przykłady

Opis	Przykład
W tym przykładzie pokazano lewą i prawą osie Y (y i r) oraz 1 oś X (x). Każda oś ma zdefiniowany zakres. Nie określono żadnych etykiet ani pozycji, dlatego wartości są pobierane z podanego zakresu i są w nim równomiernie rozmieszczone. Na wykresie liniowym wartości są równomiernie rozłożone na osi X. Kierunek osi r jest odwrócony dla osi r (indeks 2), ponieważ pierwsza wartość (1000) jest większa od ostatniej wartości (0).	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
W tym przykładzie podano wartości dla osi X. Etykiety osi są rozmieszczone równomiernie wzdłuż osi. Parametr <opt_step> podaje wartość 5 (5).	chxt=x chxr=0,10,50,5

Powrót do góry

Niestandardowe etykiety osi chxl

Za pomocą parametru chxl możesz określić niestandardowe etykiety osi ciągu znaków na dowolnej osi. Możesz określić dowolną liczbę etykiet. Jeśli wyświetlisz oś (z użyciem parametru chxt) i nie określisz etykiet własnych, zostaną zastosowane etykiety standardowe. Aby określić niestandardowy zakres liczbowy, użyj parametru chxr.

Aby ustawić określone lokalizacje etykiet na osi, użyj parametru chxp.

Składnia

Określ jeden zestaw parametrów dla każdej osi, którą chcesz oznaczyć etykietą. Kolejne zestawy etykiet rozdziel pionową kreską (|).

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

<axis_index>

Do której osi zastosować etykiety. To jest indeks w tablicy parametrów chxt. Jeśli na przykład masz obiekt chxt=x,x,y,y, indeks 0 byłby pierwszą osią X, a 1 to druga oś X.

<label_1>| ... |<etykieta_n>

Co najmniej 1 etykieta do umieszczenia wzdłuż tej osi. Mogą to być wartości numeryczne i ciągi tekstowe. Ciągi nie muszą być ujęte w cudzysłów. Ciąg label_1 jest wyświetlany na najniższej pozycji na osi, a label_n na najwyższej. Dodatkowe etykiety są rozmieszczone równomiernie między nimi. Spacje są oznaczone znakiem +. Nie ma możliwości określenia podziału wiersza w etykiecie. Oddziel etykiety pionową kreską. Uwaga: nie umieszczaj kreski pionowej za końcową etykietą w parametrze chxl.

 

Przykłady

Opis	Przykład
Ten wykres pokazuje, jak dodawać etykiety własne do 2 osi. Zwróć uwagę, że wartości są rozłożone równomiernie i jak ostatnia wartość chxl nie kończy się pionową kreską.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
W tym przykładzie uwzględniono etykiety osi na lewej i prawej osi Y (y i r). Obejmuje on też 2 zestawy wartości na osi X (x). Możesz dodać znaczniki osi na osi Y za pomocą funkcji chxs.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
Ten przykład obejmuje etykiety osi na lewej i prawej osi Y (y i r). Obejmuje on też 2 zestawy wartości na osi X (x). Zwróć uwagę na puste etykiety dolnego zestawu osi X, które służą do rozdzielania wartości. W tym przykładzie użyto domyślnych wartości etykiet osi na lewej osi Y.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
Jeśli chcesz dodać ogólną etykietę opisującą całą oś (np. aby oznaczyć jedną oś „koszt” a drugą „student”), użyj właściwości chxt, aby dodać dodatkową oś po każdej stronie, a potem użyj właściwości chxl, aby dodać pojedynczą etykietę niestandardową po każdej stronie, a następnie użyj uprawnienia chxp, aby rozmieścić ją na środku osi.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

Powrót do góry

Pozycje etykiet osi chxp

Możesz określić, które etykiety osi mają być wyświetlane: używane są etykiety domyślne czy własne określone za pomocą funkcji chxl. Jeśli nie określisz dokładnych pozycji za pomocą tego parametru, etykiety zostaną rozmieszczone równomiernie i z domyślną wartością kroku wzdłuż osi. Jeśli nie określisz wartości chxl, etykiety znaczników będą wartościami domyślnymi (zwykle są to wartości danych lub numery słupkowe na wykresach słupkowych).

Składnia

Różne zestawy pozycjonowania rozdziel pionową kreską (|).

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

<axis_index>

Oś, dla której określasz pozycje. To jest indeks w tablicy parametrów chxt. Jeśli na przykład masz obiekt chxt=x,x,y,y, indeks 0 byłby pierwszą osią X, 1 był drugą osią X i tak dalej.

<label_1_position>,...,<label_n_position>

Położenie etykiety wzdłuż osi. Jest to rozdzielana przecinkami lista wartości liczbowych, gdzie każda z nich określa pozycję odpowiedniej etykiety w tablicy chxl: pierwszy wpis dotyczy pierwszej etykiety i tak dalej. Pozycja to wartość w zakresie danej osi. Pamiętaj, że zawsze będzie wynosić 0–100, chyba że określisz zakres niestandardowy za pomocą funkcji chxr. Musisz mieć tyle pozycji, ile masz etykiet dla tej osi.

 

Przykłady

Opis	Przykład
W tym przykładzie uwzględniono etykiety osi R w określonych pozycjach na wykresie. Tekst etykiety jest określany za pomocą parametru chxl. Etykiety z określoną pozycją 0 są umieszczane u dołu osi Y lub R albo po lewej stronie osi X lub T. Etykiety z określoną pozycją 100 są umieszczane u góry osi Y lub R albo po prawej stronie osi X lub T.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
Ten przykład pokazuje wyświetlanie domyślnych wartości etykiet, ale tylko w określonych lokalizacjach. chxp=1,10,35,75 – oś Y powinna wyświetlać tylko 3 etykiety: 10, 35 i 75. Nie określono tekstu etykiety własnej, dlatego wartości osi są wyświetlane. Pamiętaj, że gdy używasz chxp, nie musisz rozdzielać etykiet równomiernie w różne miejsca. Gdyby tutaj nie określono parametru chxp, domyślna odległość wartości etykiety na osi Y wynosiłaby co 20 jednostek, jak pokazano na 2 wykresie.	chxt=x,y chxp=1,10,35,75 chxt=x,y chxp nie został określony

Powrót do góry

Style etykiet osi chxs

Możesz określić rozmiar, kolor i wyrównanie etykiet osi zarówno w przypadku etykiet własnych, jak i domyślnych wartości etykiet. Wszystkie etykiety na tej samej osi mają ten sam format. Jeśli masz wiele kopii osi, możesz sformatować każdą z nich w inny sposób. Możesz też określić format ciągu etykiety, aby np. pokazywać symbole walut lub końcowe zera.

Domyślnie przy osiach górnych i dolnych nie są widoczne znaczniki wyboru wartości, a osie lewa i prawa je wskazują.

Składnia

Wartości wielu osi powinny być rozdzielone pionową kreską (|).

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>

Oś, do której ma to zastosowanie. Jest to indeks liczony od zera dla parametru chxt.

<opt_format_string>

[Opcjonalnie] Opcjonalny format ciągu znaków. Jeśli jest używany, występuje tuż po numerze indeksu osi bez poprzedzającego przecinka. Zaczyna się od literału N, po której następują te wartości (wszystkie opcjonalne): Składnia ciągu formatowania jest następująca:
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
Oto znaczenie poszczególnych elementów:

• <preceding_text> – tekst literału poprzedzającego każdą wartość.
• *...* – opcjonalny blok otoczony dosłownymi gwiazdkami, w którym możesz określić szczegóły formatowania liczb. Te wartości są obsługiwane, ale wszystkie są opcjonalne:
  • <number_type> – format liczbowy dla wartości liczbowych. Wybierz jedną z tych opcji:
    • f – [domyślny] format zmiennoprzecinkowy. Rozważ też określenie precyzji za pomocą wartości <decimal_places>.
    • p – format procentowy. Znak % jest dołączany automatycznie. Uwaga: gdy używasz tego formatu, wartości danych z zakresu 0,0–1,0 są mapowane na 0–100% (na przykład 0,43 będzie wyświetlane jako 43%).
    • e – format zapisu naukowego.
    • c<CUR> – sformatuj liczbę w podanej walucie, używając odpowiedniego znacznika waluty. Zastąp <CUR> trzyliterowym kodem waluty. Przykład: cEUR oznacza euro. Listę kodów znajdziesz na stronie ISO, jednak nie wszystkie symbole są obsługiwane.
  • <decimal_places> – liczba całkowita określająca, ile miejsc po przecinku ma być wyświetlane. Wartość jest zaokrąglana (nie obcinana) do tej długości. Wartość domyślna to 2.
  • z – wyświetl końcowe zera. Wartość domyślna to no.
  • s – wyświetl separatory grup. Wartość domyślna to no.
  • x lub y – wyświetla dane ze współrzędnej X lub Y zgodnie z wymaganiami. Znaczenie danych „x” zależy od typu wykresu. Przetestuj wykres, aby sprawdzić, co oznaczają. Domyślna wartość to „y”.
• <following_text> – tekst literału, który będzie następował po każdej wartości.

<opt_label_color>

Kolor, który zostanie zastosowany do tekstu osi (ale nie do linii osi) w formacie szesnastkowym RRGGBB. Kolor linii osi jest określany oddzielnie za pomocą parametru opt_axis_color. Domyślny to szary.

<opt_font_size>

[Opcjonalny] określa rozmiar czcionki w pikselach. Ten parametr jest opcjonalny.

<opt_alignment>

[Opcjonalnie] Wyrównanie etykiety. Dla osi górnej lub dolnej jest to informacja o tym, jak etykieta wyrównuje się ze znacznikiem wyboru umieszczonym nad lub pod nią. W przypadku lewej lub prawej osi odnosi się do wyrównania wewnątrz ramki ograniczającej, która styka się z tą osią. Podaj jedną z tych liczb:

• -1 – u góry lub na dole: etykiety są po prawej stronie znaczników; do lewej lub do prawej: etykiety są wyrównane do lewej krawędzi w ich obszarze. Domyślnie dla etykiet osi R.
• 0 – Góra lub dół: etykiety są wyśrodkowane na znacznikach; Do lewej lub Po prawej: etykiety są wyśrodkowane w obszarze. Domyślnie dla etykiet osi X i T.
• 1 – u góry lub na dole: etykiety są po lewej stronie znaczników; do lewej lub do prawej – etykiety są wyrównane do prawej krawędzi w danym obszarze. Domyślnie dla etykiet osi Y.

<opt_axis_or_tick>

[Opcjonalny; nieobsługiwany przez Google-o-meter] Określa, czy na tej osi mają być wyświetlane znaczniki lub linie osi. Znaczniki i linie osi są dostępne tylko dla najbardziej wewnętrznych osi (np. nie są obsługiwane dla zewnętrznych 2 osi X). Użyj jednej z tych wartości:

• l (małymi literami) – rysuj tylko linię osi.
• t – rysuj tylko znaczniki. Znaczniki to małe linie obok etykiet osi.
• lt – [wartość domyślna] – narysuj linię osi i znaczniki wyboru dla wszystkich etykiet.
• _ – (podkreślenie): nie rysuj linii osi ani znaczników. Użyj tej wartości, jeśli chcesz ukryć linię osi.

<tick_color>

[Opcjonalny; nieobsługiwany w Google-o-meter] Kolor znacznika wyboru w formacie szesnastkowym RRGGBB. Domyślny to szary.

<opt_axis_color>

[Opcjonalnie] Kolor tej linii osi w formacie szesnastkowym RRGGBB. Domyślny to szary.

 

Przykłady

Opis	Przykład
Rozmiar i kolor czcionki określa się dla drugiej osi X (styczeń, luty, marzec).	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
Rozmiar, kolor i wyrównanie czcionki są określone dla prawej osi Y. Narysowane są znaczniki, ale nie widać linii osi.	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
Ten wykres obejmuje 3 zbiory danych i pokazuje 3 zbiory etykiet osi, po 1 na serie. Każdy zestaw etykiet jest sformatowany za pomocą niestandardowego ciągu formatowania, jak opisano w tym artykule: 0N*e,000000| 0 oznacza pierwszą serię danych N oznacza ciąg formatowania * oznacza początek specyfikatorów formatu e oznacza zapis naukowy * oznacza koniec specyfikatorów formatu 000000 oznacza czarny tekst. 1N*cUSD*Mil,FF0000| 1 oznacza drugą serię N oznacza ciąg formatowania * oznacza początek specyfikatorów formatu c oznacza znacznik waluty. USD określa dolar amerykański jako znacznik waluty, którego chcesz użyć * oznacza koniec specyfikatorów formatu Mil jest literałem następującym ciągiem znaków FF0000 oznacza czerwony tekst. 2N*sz2*,0000FF 2 oznacza trzecią serię N oznacza ciąg formatowania * oznacza początek specyfikatorów formatu s oznacza specyfikatory grup (w języku angielskim (USA) – co 3 zera stosuje się przecinek). z2 oznacza 2 końcowe zera 0000FF oznacza niebieski tekst. Zakresy etykiet osi ustawia się za pomocą parametru chxr (axis_index, start, end, step). Jeśli nie jest skonfigurowana, domyślnie mieści się w zakresie 0–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

Powrót do góry

Style znaczników osi chxtc

Dla określonych osi możesz określić długie znaczniki. Zwykle służy do przedłużania znacznika na całej długości wykresu. Aby zmienić kolor znacznika wyboru, użyj parametru chxs.

Wartości wielu osi powinny być rozdzielone pionową kreską (|). Wartości z serii powinny być rozdzielone przecinkami.

Składnia

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

<axis_index>

Oś, do której ma to zastosowanie. Jest to indeks liczony od zera dla parametru chxt. Rozdziel wartości dla różnych osi za pomocą separatora słupkowego.

<tick_length_1>,...,<tick_length_n>

Długość znaczników na tej osi (w pikselach). Jeśli podasz jedną wartość, będzie ona stosowana do wszystkich wartości. Jeśli podasz więcej niż 1 wartość, kreski na osi będą przewijać listę wartości dla tej osi. Wartości dodatnie są rysowane poza obszarem wykresu i przycinane zgodnie z obramowaniem wykresu. Maksymalna wartość dodatnia to 25. Wartości ujemne są rysowane wewnątrz obszaru wykresu i przycinane zgodnie z obramowaniem obszaru wykresu.

 

Przykłady

Opis	Przykład
Przykład użycia chxtc do utworzenia długich czerwonych znaczników wyboru. Długość znacznika wyboru przekracza szerokość obszaru wykresu, ale jest przycięty, by pasował do wykresu. chxt=x,y,r,x – pokazuje lewą, prawą oś i 2 dolne osie. chxl=2:|min|average|max|3:|Jan|Feb|Mar – tekst etykiety przypisany do osi „r” (po prawej) i zewnętrznych osi X. chxp=2,10,35,95 – położenie etykiet własnych na osi r (indeks=2) dla 3 etykiet. chxs=2,0000dd,13,-1,t,FF0000 – style etykiet osi R dla osi R: kolor tekstu, rozmiar tekstu, wyrównanie do lewej, z czerwonymi znacznikami. chxtc=1,10|2,-180 – długości osi y dla osi y i r. Pierwsza wartość określa znaczniki o długości 10 pikseli poza osią. Druga wartość określa znaczniki o długości 180 pikseli wewnątrz osi. Liczba ujemna oznacza, że znacznik zostaje umieszczony wewnątrz osi, a znacznik jest przycięty tak, aby pasował do wykresu.	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
Ten wykres przedstawia naprzemienne długości osi czasu. chxtc określa 2 długości osi Y (5 i 15), a znaczniki zaznaczone na wykresie zmieniają się między 2 wartościami.	chxt=x,y chxtc=   1,5,15

Powrót do góry

Wypełnienie tła chf [Wszystkie wykresy]

Możesz określić kolory i style wypełnienia dla obszaru danych wykresu lub całego tła wykresu. Typy wypełnienia obejmują: pełne wypełnienia, paski i gradienty. Możesz określić różne wypełnienia dla różnych obszarów (np. całego obszaru wykresu lub tylko obszaru danych). Wypełnienie obszaru wykresu zastępuje wypełnienie tła. Wszystkie wypełnienia są określane za pomocą parametru chf. Możesz mieszać różne typy wypełnienia na tym samym wykresie, rozdzielając wartości pionową kreską ( | ). Wypełnienia obszaru wykresu zastępują wypełnienia tła wykresu.

Wypełnienie jednolite chf [Wszystkie wykresy]

Możesz określić pełne wypełnienie dla tła lub obszaru wykresu albo przypisać wartość przezroczystości do całego wykresu. Możesz określić wiele wypełnienia, używając pionowej kreski (|). (Mapy: tylko tło).

Składnia

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

<fill_type>

Część wykresu jest wypełniana. Podaj jedną z tych wartości:

• bg – wypełnienie tła
• c – wypełnienie obszaru wykresu. Nieobsługiwany w przypadku wykresów map.
• a – zadbaj o przezroczystość całego wykresu (w tym tła). Pierwsze 6 cyfr wartości <color> jest ignorowanych, a tylko ostatnie 2 (wartość przezroczystości) są stosowane do całego wykresu i wszystkich wypełnienia.
• b<index> – wypełnienia słupkowe (tylko wykresy słupkowe). Zastąp ciąg <indeks> indeksem serii słupków, aby wypełnić go jednolitym kolorem. Efekt jest podobny do właściwości chco na wykresie słupkowym. Przykład znajdziesz w sekcji Kolory serii na wykresie słupkowym.

s

Oznacza wypełnienie pełne lub przezroczyste.

<color>

Kolor wypełnienia w formacie szesnastkowym RRGGBB. W przypadku przezroczystości pierwsze 6 cyfr jest ignorowanych, ale i tak trzeba je uwzględnić.

 

Przykłady

Opis	Przykład
W tym przykładzie tło wykresu wypełnia się jasnoszarym kolorem (EFEFEF).	chf=bg,s,EFEFEF
W tym przykładzie tło wykresu wypełnia jasnoszary (EFEFEF) i czarny (000000).	chf=c,s,000000| bg,s,EFEFEF
W tym przykładzie przezroczystość całego wykresu wynosi 50% (80 w zapisie szesnastkowym to 128, czyli około 50% przezroczystości). Zwróć uwagę na tło komórki tabeli widoczne na wykresie.	chf=a,s,00000080

Powrót do góry

Wypełnienie gradientu chf [linia, słupek, metr w Google, radar, punkt,weranda]

Do obszarów lub tła wykresów możesz zastosować pojedyncze wypełnienie gradientem. Wypełnienia gradientem to przejścia z jednego koloru na inny. (wykresy kołowe, wykresy Google: tylko w tle).

Każde wypełnienie gradientem określa kąt, a następnie dwa lub więcej kolorów zakotwiczonych w określonej lokalizacji. Kolor zmienia się w zależności od kotwicy. Musisz mieć co najmniej dwa kolory z różnymi wartościami parametru <color_centerpoint>, aby jeden z nich przenikał na drugi. Każdy dodatkowy gradient jest określany za pomocą pary <color>,<color_centerpoint>.

Składnia

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

<fill_type>

Obszar wykresu do wypełnienia. Jedna z tych wartości:

• bg – wypełnienie tła
• c – wypełnienie obszaru wykresu.
• b<index> – wypełnienie gradientem słupkowym (tylko wykresy słupkowe). Zastąp ciąg <indeks> indeksem serii słupków, aby wypełnić gradientem. Przykład znajdziesz w sekcji Kolory serii na wykresie słupkowym.

lg

Określa wypełnienie gradientowe.

<angle>

Liczba określająca kąt gradientu od 0 (w poziomie) do 90 (pionowy).

<color>

Kolor wypełnienia w formacie szesnastkowym RRGGBB.

<color_centerpoint>

Określa punkt zakotwiczenia koloru. Kolor zacznie zanikać w tym punkcie, gdy będzie zbliżał się do kolejnej kotwicy. Zakres wartości wynosi od 0,0 (dolna lub lewa krawędź) do 1,0 (górna lub prawa krawędź) i przechylona pod kątem określonym przez <kąt>.

 

Przykłady

Opis	Przykład
Obszar wykresu zawiera poziomy gradient liniowy, którego kąt wynosi zero stopni (0). Kolory to brzoskwiniowy (FFE7C6), wyśrodkowany po lewej stronie (pozycja 0.0) i niebieski (76A4FB) wyśrodkowany po prawej stronie (pozycja 1.0). Tło wykresu jest zaznaczone na szaro (EFEFEF).	chf=   c,lg,0,   FFE7C6,0,(brzoskwiniowy)   76A4FB,1 (niebieski)
Obszar wykresu zawiera gradient liniowy (od lewej do prawej strony) po przekątnej, który wynosi czterdzieści pięć stopni (45). Pierwszy podany kolor to brzoskwiniowy (FFE7C6). Lewy dolny róg wykresu jest w kolorze brzoskwiniowym. Niebieski (6A4FB) jest drugim podanym kolorem. Prawy górny róg wykresu jest w kolorze niebieskim. Zwróć uwagę na to, jak określamy przesunięcie o 0,75, aby podać szczyt niebieskiego zanikania w kierunku prawego górnego rogu. Tło wykresu jest zaznaczone na szaro (EFEFEF).	chf=   c,lg,45,   FFE7C6,0, (brzoskwiniowy)   76A4FB,0.75 (niebieski)
Obszar wykresu zawiera pionowy gradient liniowy (od góry do dołu) określony pod kątem 90 stopni (90). Pierwszym określonym kolorem jest niebieski (76A4FB). Górna część wykresu jest w kolorze błękitnym. Brzoskwiniowy (FFE7C6) jest drugim podanym kolorem. Dolna część wykresu jest w kolorze brzoskwiniowym. Tło wykresu jest zaznaczone na szaro (EFEFEF).	chf=   c,lg,90,   FFE7C6,0, (brzoskwiniowy)   76A4FB,0.5 (niebieski)

Powrót do góry

 

Paski – wypełnienie chf [Linia, Słupek, Google-metr, Radar, Punktowy, Wenecja]

Możesz ustawić paskowe wypełnienie tła dla obszaru wykresu lub całego wykresu. (Wykres kołowy, wykresy Google – tylko w tle).

Składnia

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

<fill_type>

Obszar wykresu do wypełnienia. Jedna z tych wartości:

• bg – wypełnienie tła
• c – wypełnienie obszaru wykresu
• b<index> – wypełnienie pasków (tylko wykresy słupkowe). Zastąp ciąg <index> indeksem serii słupków, aby wypełnić je paskami. Przykład znajdziesz w sekcji Kolory serii na wykresie słupkowym.

ls

Określa wypełnienie liniowego pasa.

<angle>

Kąt wszystkich pasków względem osi Y. Użyj wartości 0 w przypadku pionowych pasków lub 90 w przypadku poziomych pasków.

<color>

Kolor paska w formacie szesnastkowym RRGGBB. Powtórz elementy <color> i <width> w przypadku każdego dodatkowego paska. Musisz mieć co najmniej 2 paski. Paski zmieniają się, dopóki wykres nie zostanie wypełniony.

<width>

Szerokość tego paska, od 0 do 1, gdzie 1 to pełna szerokość wykresu. Paski powtarzają się, dopóki wykres nie zostanie wypełniony. Powtórz <color> i <width> w przypadku każdego dodatkowego paska. Musisz mieć co najmniej 2 paski. Paski zmieniają się, dopóki wykres nie zostanie wypełniony.

 

Przykłady

Opis	Przykład
bg,ls,0 – wypełnienie pasków w tle paskami pod kątem 0 stopni względem osi Y (równolegle do osi Y). Paski wypełniają tło wykresu i obszar wykresu. CCCCCC,0.15 – pierwszy pasek jest ciemnoszary i jest o 15% szerszy niż wykres. FFFFFF,0.1 – drugi pasek jest biały i szerokości 10% szerokości wykresu.	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90 – obszar wykresu z poziomymi paskami pod kątem 90 stopni od osi Y. Paski wypełniają obszar wykresu, ale tło wykresu jest pominięte. 999999,0.25 – pierwszy pasek jest ciemnoszary i jest o 25% szerszy niż wykres. CCCCCC,0.25 – taki sam jak pierwszy pasek, ale jaśniejszy odcień szarości. FFFFFF,0.25 – taki sam jak pierwszy pasek, ale biały.	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

Powrót do góry

Funkcje danych chfd [wszystkie wykresy chd]

Możesz określić funkcję niestandardową, która będzie uruchamiać dane wykresu przy użyciu składni funkcji muParser. Dane używane w funkcji mogą pochodzić z jednego z dwóch źródeł:

• Seria danych z chd – dane są pobierane ze określonej serii w funkcji chd.
• Zakres wartości zadeklarowanych w samym parametrze chfd – deklarujesz wartości rozpoczęcia, zatrzymania i kroku dla dowolnego zakresu danych.

Warto pamiętać, że we wszystkich przypadkach musisz przypisać dane wyjściowe do istniejącej serii w funkcji chd. Zostanie ona zastąpiona przez dane wyjściowe funkcji. Wykres jest renderowany dopiero po zakończeniu przetwarzania wszystkich funkcji. Jeśli więc przypiszesz wiele funkcji do tych samych serii danych, funkcje będą uruchamiane w podanej kolejności, ale na wykresie zostaną pokazane tylko wyniki ostatniej funkcji. Pamiętaj, że możesz tworzyć łańcuchy funkcji, tak aby jedna z nich mogła przyjąć jako dane wejściowe serię wyjściową przez poprzednią funkcję.

Aby przypisać kolory lub znaczniki chm do linii funkcji, przypisz kolory lub znaczniki do indeksu serii funkcji. Pamiętaj, że znaczniki są umieszczane zgodnie z danymi po wykonaniu działań przez funkcję.

Składnia

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

<output_series_index>

Indeks liczony od zera dla serii danych w chd, w której będą zapisywane dane wyjściowe funkcji. Wszystkie istniejące dane zostaną całkowicie zastąpione danymi wyjściowymi funkcji. Jeśli seria nie jest używana jako dane wejściowe funkcji, sprawdzoną metodą jest przypisanie do niej jednej wartości zastępczej.

<function_data>

Zmienne i dane do wykreślenia. Dane mogą pochodzić ze zdefiniowanego zakresu lub z jednej z serii danych chd. Dla każdej funkcji możesz określić wiele zmiennych, korzystając z separatora „;” (średnika) dla wielu zmiennych. Pamiętaj, że jeśli zdefiniujesz wiele zmiennych dla jednej funkcji, a te zmienne mają różną liczbę punktów, funkcja zatrzyma się po osiągnięciu pierwszego punktu końcowego. Jeśli na przykład funkcja definiuje zarówno krok 1 – 5, jak i y=1–10 krok 1, zakończy się, gdy dojdzie do piątego punktu.
    <variable_name>,<input_series_index>
         LUB
    <variable_name>,<start>,<end>,<step>

• variable_name – dowolna nazwa ciągu tekstowego zmiennej. Używaj go w funkcji zdefiniowanej przez parametr function_string.
• input_series_index – indeks serii danych chd, która ma być używana jako dane wejściowe.
• start – liczbowa wartość początkowa zakresu.
• koniec – liczbowa wartość końcowa zakresu.
• step – liczbowa wartość kroku od start do end. Może być dodatnia lub ujemna, ale nie może wynosić zero.

Przykłady: x,0,100,1 deklaruje zmienną o nazwie x z wartościami 0, 1, 2, ... 100. x,0,100,1;r,0,3.1,.1 deklaruje tę samą zmienną x oraz zmienną o nazwie r z wartościami 0, 0,1, 0,2, ..., 3.0, 3.1. Funkcja x,0 deklaruje zmienną o nazwie x, która korzysta z danych z pierwszej serii chd. Te zmienne zostaną używane przez parametr function_string. Nie zostaną one pokazane na wykresie, chyba że określisz je w parametrze function_string. Im mniejszy krok, tym płynniejszy wykres.

<function_string>

Twoja funkcja zapisana w składni muParser. Funkcja jest stosowana do zmiennych i danych określonych w parametrze variable_data. Możesz odwoływać się tylko do zmiennych zadeklarowanych w tym lokalnym zbiorze funkcji, a nie w innym potokowym zbiorze parametrów chfd. Funkcje podsumowania muParser (min., max sum, avg) nie są obsługiwane. WAŻNE: pamiętaj, aby używać w funkcjach %2B zamiast +.

 

Przykłady

Opis	Przykład
Prosta fala sinusoidalna. Warto zwrócić uwagę: chd=t:-1 – do danych na wykresie używamy zmiennej przykładowej, ponieważ nasze dane są deklarowane w parametrze chfd. chco=FF0000 – dla pierwszej serii jest określony kolor czerwony. Mimo że nie będziemy używać danych z kolumny chd, na potrzeby naniesionej funkcji zostanie użyty odpowiadający jej kolor dla tej serii. chfd=0,x,0,11,0.1,sin(x)*50%2B50 – deklarujemy jedną zmienną o nazwie x z wartościami z zakresu 0–11, które są przyrostowe o 0,1. Jest przypisany do pierwszej serii, co oznacza, że otrzyma pierwszy kolor (FF0000). Funkcja stosowana do argumentu x to sin(x) * 50 + 50. Pamiętaj, że musimy zakodować znak + w tej funkcji.	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
Ten wiersz korzysta z danych z parametru chd.	chd=t:5,10 chfd=0,x,0,x*4
Połączenie wierszy funkcji i niezawierających funkcji. Zwróć uwagę, że kolory są określane przez parametr koloru serii chco. Zwróć uwagę na miejsce znaczników na danych wyjściowych funkcji. Punkty danych są obliczane od start, end i step. Jeśli zakres to 0–11, krok 0, 1, punkt 0 to 0, punkt 1 to 0, 1 itd. aż do punktu 110, który ma wartość 11.	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
Aby zdefiniować funkcję w 2 wymiarach, użyj wykresu lxy, przypisz 2 przykładowe ciągi i do każdego z nich przypisz funkcję. 0,x,0,10,0.1,sin(x)*50%2B50 – seria 0 (wartości na osi X) zawiera zmienną o nazwie x z wartościami z zakresu 0–10, krok 0.1 oraz funkcję sin(x)*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 – seria 0 (wartości na osi Y) zawiera zmienną o nazwie y z wartościami z zakresu 0–10, krok 0.1 oraz funkcję 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
Parametr chfd pozwala wyrazić kreatywność. Klikaj obrazy, aby je otwierać i bawić się z nimi na placu zabaw z wykresami – po prostu się wciągniesz.

Powrót do góry