本頁面說明 Chart API 支援的所有功能和參數。部分參數的行為會因圖表類型而異,在這種情況下,說明文件就會連結至相關圖表的說明文件。
參數
以下是 Google Chart API 支援的參數。
參數 | 說明與語法 | 圖表類型 |
---|---|---|
chbh | 長條寬度和間距
|
酒吧 |
chco | 系列顏色
chco= |
Bar、Google-o-meter、Line、Map、Pie、Radar、Scatter、Venn |
查德 | 圖表資料字串 chd= t:s,e,r,i,e,s,1|s,e,r,i,e,s,2|... 或 s:series1,series2,... 或 e:series1,series2,... |
所有圖表 |
chdl、chdlp、chdls | 圖表圖例文字和樣式
|
Bar、Candlestick、Google-o-meter、Line、Pie、Radar、Scatter、Venn |
黑人 | 使用自訂範圍調整文字格式chds= |
可接受「chd 」的所有圖表 |
化學 | 動態圖示標記
chem= |
Bar、Candlestick、Line、Radar、Scatter |
主席 | 漸層填滿
chf= |
Bar、Candlestick、Google-o-meter (僅限背景)、Line、Pie (僅限背景)、Radar、Scatter、Venn |
主席 | 條紋填滿
chf= |
Bar、Candlestick、Google-o-meter (僅限背景)、Line、Pie (僅限背景)、Radar、Scatter、Venn |
主席 | 單純填滿
chf= |
|
ChFd | 資料函式
chfd= |
可接受 chd 的所有圖表 |
查克 | 格線
chg= |
Bar、Candlestick、Line、Radar、Scatter |
Chl | 圓餅圖標籤、Google-o-meter 標籤chl=<label>|... |
Google-o-meter、Pie |
基爾德 | 圖表標籤資料 (各種類型)chld=<chart-specific_data>|<chart-specific_data>|... |
獨立式動態圖示 |
椅子 | 線條樣式
chls= |
Line、Radar |
chm=D | 折線標記
chm= |
Bar、Candlestick、Line、Radar、Scatter |
chm=r|R | 範圍標記chm= |
Bar、Candlestick、Line、Radar、Scatter |
chm= a|c|C d|E|o| h|H| s|S| v|V|x |
形狀標記
chm= |
Bar、Candlestick、Line、Radar、Scatter |
chm= f|t|A|N |
文字和資料值標記chm= |
Bar、Candlestick、Line、Radar、Scatter |
chm=F | K 線標記chm= |
Bar、Kdlestick、Line |
chm=b/B | 填滿線條
chm= |
Bar (僅限包含線條標記)、Line、Radar |
紅雀 | 圖表邊界
chma= |
Bar、Candlestick、Google-o-meter、Line、Map、Pie、Radar、Scatter、Venn |
吊帶 | 輸出格式
chof=<format> |
所有圖表 |
落後企業 | 長條圖零折線、圓餅圖方向
chp=<zero_val>,... |
Bar、Pie |
Ks | 圖表大小
chs=<width>x<height> |
所有圖表 |
chst | 動態圖示類型
chst=<icon_string_constant> |
獨立式動態圖示 |
椅子 | 圖表類型
cht=<chart_type> |
所有圖表 |
chtm | 地理區域
chtm=<zoom_area> |
地圖 |
chtt、chts | 圖表標題和樣式
|
Bar、Candlestick、Google-o-meter、Line、Pie、Radar、Scatter、Venn |
Chxt | 可見軸
chxt=<axis_1>,... |
Bar、Candlestick、Google-o-meter、Line、Radar、散佈圖 |
Chxr | 軸範圍chxr= |
Bar、Candlestick、Google-o-meter、Line、Radar、散佈圖 |
ChXl | 軸標籤chxl= |
Bar、Candlestick、Google-o-meter、Line、Radar、散佈圖 |
ChXp | 軸標籤位置chxp= |
Bar、Candlestick、Google-o-meter、Line、Radar、散佈圖 |
黑人 | 軸標籤樣式chxs= |
Bar、Candlestick、Google-o-meter (有限制)、Line、Radar、散佈圖 |
Chxtc | 軸線刻度標記樣式 chxtc= |
Bar、Candlestick、Line、Radar、Scatter |
使用 6 位數十六進位值字串和兩個選用透明度值指定顏色,格式為 RRGGBB[AA]
。例如:
FF0000
= 紅色00FF00
= 綠色0000FF
= 藍色000000
= 黑色FFFFFF
= 白色
AA
是選用的透明度值,其中 00
表示完全透明,FF
表示完全不透明。例如:
0000FFFF
= 亮藍色0000FF66
= 透明藍色
圖表大小 chs
[所有圖表]
所有圖表都必須指定大小。這個參數可以決定圖表圖片的總寬度和高度,包括圖例、邊界和標題。為了符合圖表整體大小,圖例、邊界和標題會裁剪。
除了地圖以外,所有圖表的圖表大小上限皆為 300,000 像素,寬度或長度上限為 1,000 像素。地圖的大小上限為 440x220。
值必須為整數。
語法
chs=<width>x<height>
- <width>
- 寬度,以像素為單位。最大值為 1,000。寬度 x 高度不得超過 300,000。
- <height>
- 高度,以像素為單位。最大值為 1,000。寬度 x 高度不得超過 300,000。
範例
說明 | 範例 |
---|---|
250 像素 x 100 像素圖表。 |
chs=250x100 |
圖表類型 cht
[所有動態圖示除外]
使用 cht
參數指定圖表類型。如需可用的圖表類型清單,請參閱個別圖表說明文件頁面。
語法
cht=<type>[:nda]
- <type>
- 這是圖表類型值之一。
- :nda
- [選用,僅限折線圖] 您可以在折線圖的圖表類型後方加上
:nda
來隱藏預設軸。
例子
說明 | 範例 |
---|---|
圓餅圖 |
cht=p |
文氏圖 | cht=v |
顯示及不含預設軸的折線圖。 | |
系列顏色 chco
[所有圖表]
您可以使用 chco
參數指定特定序列或系列的所有元素的顏色。確切的語法和意義可能會因圖表類型而異,詳情請參閱特定圖表類型。
語法
chco= <series_1_element_1>|...|<series_1_element_n>,<series_2>,...,<series_m>
此字串中的每個項目都是 RRGGBB 格式的十六進位數字。套用至整個系列的顏色會以半形逗號分隔,適用於系列中個別元素的顏色會以長條分隔。對大部分的圖表類型而言,您可以混合使用整個序列與個別系列元素的顏色說明。如果圖表中有超過序列或元素數量超過字串中指定的顏色,API 通常會從該序列的開頭 (針對元素) 或序列清單開頭循環切換元素顏色。詳情請參閱個別圖表的說明文件。
例子
說明 | 範例 |
---|---|
如果在折線圖中為每個序列指定單一顏色,每一行都會有對應的顏色。這個範例指定了三個資料序列和三種顏色。 |
|
這個折線圖也包含三個資料序列,但僅指定兩種顏色。由於未指定第三個序列的顏色,因此會使用第一個顏色 (紅色) 繪製第三條線。 |
|
這個範例說明如何為系列中的個別成員指定顏色 (這個範例中的長條)。 |
|
此操作說明如何指定序列顏色和個別元素顏色。第一個系列全為黑色 (000000)。第二個以半形逗號標示的序列則指派了個別顏色,並以 | 字元分隔。 |
|
輸出格式 chof
[所有圖表]
您可以使用 chof 參數選擇圖表的輸出格式。設計圖表時,這個參數也可以用來顯示偵錯資訊。請注意,部分輸出格式是圖形 (例如 PNG 和 GIF),但其他格式則不是。使用非圖形格式做為 <img> 標記的 src 參數時,會導致網頁上的圖片毀損。
語法
chof=png|gif|json|validate.
請指定以下其中一個字串:
- 「png」 - 以 PNG 圖片傳回圖表。
- 「gif」:將圖表傳回為 GIF 圖片。
- 「json」:以 JSON 字串表示圖表的圖片對應資料。這可用來產生圖表的圖片點擊區,讓多個區域可以點擊。如要瞭解這個字串的格式,並進一步瞭解如何使用這個字串,請參閱建立圖表圖片地圖。
- 「validate」- 傳回 HTML 網頁,並列出圖表網址中的所有錯誤。如需更多偵錯提示,請參閱「偵錯」一文。
例子
說明 | 範例 | |
---|---|---|
以下是同一份圖表的 PNG 和 GIF 範例: |
chof=png |
chof=gif |
含有無效網址的圖表: 指定 |
chof=validate 的錯誤網址示例 |
|
以下是在 |
<iframe> 中的有效圖表網址 |
圖表標題 chtt
,chts
[所有圖表]
您可以指定圖表的標題文字、顏色和字型大小。
語法
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
:指定圖表標題。
- <chart_title>
- 要在圖表中顯示的標題。您無法指定這個部分顯示的位置,但可以選擇指定字型大小和顏色。請使用 + 符號代表空格,並以直立線字元 (
|
) 表示換行。
chts
[選用]:chtt
參數的顏色和字型大小。
- <color>
- 標題顏色,採用 RRGGBB 十六進位格式。預設顏色為黑色。
- <font_size>
- 標題的字型大小,以點為單位。
- <opt_alignment>
- [選用] 標題對齊方式。請選擇下列其中一個區分大小寫的字串值:「l」(左側)、「c」(置中)「r」(右側)。預設值為「c」。
例子
說明 | 範例 |
---|---|
包含標題的圖表,使用預設顏色和字型大小。 請使用加號 ( 使用直立線字元 ( 此處並未指定「 |
chtt=Site+visitors+by+month| |
此圖表顯示藍色、靠右對齊且有 20 點的標題。 |
chtt=Site+visitors |
圖表圖例文字和樣式 chdl
、chdlp
、chdls
[所有圖表]
圖表的側邊部分會顯示每個序列的簡短文字說明。您可以指定與這個圖例中與每個序列相關聯的文字,並指定圖例在圖表中顯示的位置。
另請參閱 chma
,瞭解如何設定圖例周圍的邊界。
字串值的注意事項:標籤字串只能使用安全網址字元。為了安全起見,如果字串包含非字元集 0-9a-zA-Z
中的字元,您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。
語法
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
- 每個序列的文字,會顯示在圖例中。
- <data_series_label>
- 圖例項目的文字。每個標籤都會套用至
chd
陣列中的對應系列。使用「+」符號代表聊天室。如未指定這個參數,圖表將不會取得圖例。您無法在標籤中指定換行符號。圖例通常會展開,以顯示圖例文字,而圖表區域則會縮小以容納圖例。
chdlp
- [選用] 圖例的位置和圖例項目的順序。您可以指定 <position> 和/或 <label_order>。如果您同時指定兩者,請以長條字元分隔。如要讓圖例略過 chdl
中的空白圖例項目,您可以將「s」加到任何值。範例:chdlp=bv
、chdlp=r
、chdlp=bv|r
、chdlp=bvs|r
- <opt_position>
- [選用] 指定圖例在圖表中的位置。如要指定圖例與圖表區域或圖片邊框之間的其他邊框間距,請使用
chma
參數。 選擇下列其中一個值:b
- 圖表底部的圖例,以水平列顯示圖例項目。bv
- 圖表底部的圖例,垂直欄中的圖例項目。t
- 圖表頂端的圖例,水平列中顯示圖例項目。tv
- 圖表頂端的圖例,垂直欄中的圖例項目。r
- [預設] 圖表右側的圖例,垂直欄中的圖例項目。l
- 圖表左側的圖例,垂直欄中的圖例項目。
- <opt_label_order>
- [選用]
標籤在圖例中的顯示順序。
選擇下列其中一個值:
l
- [產業圖例的預設值] 依指定chdl
的順序顯示標籤。r
- 根據chdl
指定的順序,以反向順序顯示標籤。在堆疊長條圖中,這很實用,可以按照長條的顯示順序
顯示圖例。a
- [水平圖例的預設值] 自動排序:大致表示依長度,從短到長排序,以 10 個像素區塊進行測量。如果兩個元素的長度相同 (分割為 10 個像素區塊),系統會優先顯示第一個元素。0,1,2...
- 自訂標籤順序。這份清單包含從chdl
開始,以零為基準的標籤索引,並以半形逗號分隔。
chdls
- [選用] 指定圖例文字的顏色和字型大小。
- <color>
- 圖例文字顏色,採用 RRGGBB 十六進位格式。
- <size>
- 圖例文字的點大小。
例子
說明 | 範例 |
---|---|
請參閱兩個圖例範例。請按照資料序列的順序指定圖例文字。 |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
第一張圖表展示水平圖例項目 ( |
|
這個範例說明如何變更字型大小。 |
|
圖表利潤 chma
[所有圖表]
您可以用像素指定圖表邊界的大小。邊界是根據指定圖表大小 (chs
) 進行計算;增加邊界大小不會增加圖表總大小,而是會在必要時縮小圖表區域。
根據預設,邊界為計算圖表大小後剩餘的內容。 這個預設值會因圖表類型而異。您指定的邊界為「最小值」;如果圖表區域保留空間空間,邊界大小會是剩餘的內容;您無法擠壓小於任何圖例和標籤所需範圍的邊界。下圖顯示圖表的基本部分:
「圖表邊界」包括「軸標籤」和「圖例區域」。除非您使用 提示:在長條圖中,如果長條的尺寸固定 (預設值),就無法縮減圖表區域寬度。您必須使用 |
語法
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>、<right_margin>、<top_margin>、<bottom_margin>
- 圖表區域周圍的最小邊界大小 (以像素為單位)。增加這個值即可加入一些邊框間距,以免軸標籤與圖表邊界發生衝突。
- <opt_legend_width>、 <opt_legend_height>
- [選用] 圖例周圍的寬度,以像素為單位。這樣可以避免圖例出現在圖表區域或圖片邊緣上。
例子
說明 | 範例 |
---|---|
在這個範例中,圖表兩側的邊界至少為 30 像素。由於圖表圖例寬度超過 30 像素,因此右側邊界會設為圖表圖例的寬度,與其他邊界不同。 軸標籤位於繪製區域之外,因此會在邊界空間中繪製。 |
|
如要在圖例周圍新增邊界,請設定 在這個範例中,圖例的寬度約為 60 像素。如果您將 |
|
軸樣式和標籤 [Line, Bar, Google-o-meter, Radar, Scatter]
您可以指定要在圖表上顯示哪些軸,也可以為其自訂標籤、位置、範圍和樣式。
並非所有圖表預設顯示軸線。你可以使用 chxt
參數,精確指定圖表應顯示哪些軸。預設軸線不會顯示數字;您必須在 chxt
參數中指定軸才能顯示數字。
您可以選擇讓軸顯示代表資料值的數字,也可以指定自訂軸。預設值為顯示數值,且值會縮放為 0 至 100 之間的數值。不過,您可以使用 chxr
變更該範圍以顯示任何範圍,也可以使用 chxs
設定值的樣式 (例如顯示貨幣符號或小數位數)。
如果您選擇使用自訂值 (例如「Mon, Tues, Wed」),也可以使用 chxl
參數。如要將這些標籤沿著軸線的特定位置放置,請使用 chxp
參數。
最後,您可以使用 chxs
和 chxtc
參數,指定自訂和數值軸標籤的顏色、大小、對齊方式和其他屬性。
字串值的注意事項:標籤字串只能使用安全網址字元。為了安全起見,如果字串包含非字元集 0-9a-zA-Z
中的字元,您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。
本節涵蓋下列主題:
- 可見軸 (
chxt
):要顯示的軸。 - 軸範圍 (
chxr
):每個軸的值範圍。 - 自訂軸標籤 (
chxl
):要顯示在軸上的自訂值。 - 軸標籤位置 (
chxp
) - 自訂標籤在每個軸上的位置。 - 軸標籤樣式 (
chxs
) - 軸標籤的顏色、大小、對齊方式和格式設定。 - 軸刻度標記樣式 (
chxtc
) - 特定軸的刻度記號長度。
可見軸 chxt
根據預設,長條圖、折線圖、雷達圖和散佈圖會顯示一或兩條軸線,但這幾行不包含值。如要在軸線上顯示值或變更顯示的軸,您必須使用 chxt
參數。根據預設,除非您使用 chxr
屬性明確縮放軸值,否則軸值的範圍為 0 到 100。如要隱藏折線圖中的所有軸線,請在 cht
參數中的圖表類型值後方指定 :nda
(例如:cht=lc:nda
)。
根據預設,頂端和底部軸不會依數值顯示勾號,左右軸則會顯示勾號。您可以使用 chxs
參數變更這項行為。
語法
chxt= <axis_1> ,..., <axis_n>
- <axis>
- 要在圖表中顯示的軸。可用的軸如下:
x
- 底部 X 軸t
- 頂端 X 軸 [Google-o-Meter 不支援]y
- 左 Y 軸r
- 右側 Y 軸 [Google-o-Meter 不支援]
您可以指定多個相同類型的軸,例如:cht=x,x,y
。這會沿著圖表底部堆疊兩組 X 軸。如想沿著顯示數值的軸新增自訂標籤,這種做法就非常實用 (請參閱下例)。軸是從內部繪製而來,因此如果您有 x,x
,第一個 x 代表最內層的副本,下一個 x 是指下一個向外副本,依此類推。
例子
說明 | 範例 |
---|---|
這個範例顯示含有 X 軸、Y 軸、上軸 (t) 和右軸 (r) 的折線圖。 未指定任何標籤,因此圖表會預設為所有軸的 0 到 100 範圍。 請注意,根據預設,頂端和底部軸不會在標籤顯示勾號。 |
|
您可以重複加入相同的值,為每個軸加入多組標籤。這個範例顯示兩組 x 和兩組 y 軸。這在僅使用預設軸標籤時並不實用,如此處所示。不過,您可以使用 chxl 參數,為每個軸的每個副本指定自訂標籤。 |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=7"=20&hl=zh-Hant" /> <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chco=76A4FB&chls=2.0&chs=1"?hl=zh-Hant&hl=zh-Hant&hl=zh-Hant&hl=zh-TW|02030%30%27% |
這個範例顯示包含 X 軸、Y 軸、上 T 軸和右側 r 軸的水平長條圖。 系統會省略軸標籤,因此 Chart API 會在 X 軸和 T 軸顯示 0 到 100 的範圍。 Y 軸和 r 軸的範圍取決於長條數量。在本範例中,共有五個長條,因此圖表 API 會顯示 0 到 4 的範圍。第一個標籤會置於第一個長條的中心,第二個標籤則位於第二個長條的底部,以此類推。 |
|
只要在圖表類型後方指定 :nda ,即可隱藏折線圖中的預設軸。 |
cht=lc:nda |
軸範圍 chxr
您可以使用 chxr 參數,指定每個軸分別顯示的值範圍。請注意,這項操作「不會」 變更圖表元素的縮放,只會變更軸標籤的縮放。如要讓軸數字描述實際資料值,請分別將 <start_val> 和 <end_val> 分別設為資料格式範圍中下限和上限的值。詳情請參閱 Axis 資源調度相關說明。
如要指定軸範圍,請使用 chxt
參數顯示軸。
如要指定自訂軸值,請使用 chxl
參數。
語法
請使用直立線字元 ( |
) 分隔多個軸標籤範圍。
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <axis_index>
- 要套用標籤的軸。這是從
chxt
指定的軸陣列內,從零開始的索引。舉例來說,R 軸在chxt=x,r,y
中的是 1。 - <start_val>
- 數字,定義這個軸的最小值。
- <end_val>
- 數字,定義這個軸的最大值。
- <opt_step>
- [選用] 軸上刻點之間的計數步數。此步驟沒有預設的步驟值,系統會嘗試顯示一組適當的間距。
例子
說明 | 範例 |
---|---|
這個範例顯示左右 Y 軸 ( 每個軸都有定義的範圍。由於未指定任何標籤或位置,因此值會從指定範圍內取得,且會在該範圍內平均間距。在折線圖表中,各個值會沿著 X 軸平均分配。 r 軸 (索引 |
|
在本例中,X 軸指定的值。 軸標籤會沿著軸平均間隔。<opt_step> 參數的值為五 ( |
|
自訂軸標籤chxl
您可以使用 chxl
參數,在任何軸上指定自訂字串軸標籤。您可以視需要指定多個標籤,數量不限。如果您顯示軸 (使用 chxt
參數),且未指定自訂標籤,系統會套用標準的數值標籤。如要指定自訂數字範圍,請改用 chxr
參數。
如要設定標籤在軸上的特定位置,請使用 chxp
參數。
語法
為每個要加上標籤的軸指定一組參數。請使用直立線字元 (|
) 分隔多組標籤。
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <axis_index>
- 要套用標籤的軸。這是
chxt
參數陣列的索引。舉例來說,如果您有chxt=x,x,y,y
,那麼索引 0 會是第一個 x 軸,1 是第二個 X 軸。 - <label_1>| ... |<label_n>
- 要沿著這個軸放置的一或多個標籤。這些可以是字串或數字值;字串不一定要在引號中。label_1 會顯示在軸上的最低位置,而 label_n 會以最高位置顯示。其他標籤會在每個標籤之間平均間距。以 + 符號表示空格。您無法在標籤中指定換行符號。請使用直立線字元分隔標籤。注意: 請勿在
chxl
參數的最後一個標籤後方放置直立線。
例子
說明 | 範例 |
---|---|
這張圖表顯示如何在兩個軸上新增自訂標籤。請注意這些值的間距方式,以及最後一個 |
chxt=x,y |
這個範例包含左右 Y 軸 ( |
|
這個範例包含左右 Y 軸的軸標籤 ( 這個範例使用左側 Y 軸上的軸標籤預設值。 |
|
如果您想加入一般標籤來描述整個軸 (例如為某軸「費用」和「學生」加上標籤),請使用 |
chxt=x,x,y,y |
軸標籤位置 chxp
您可以使用 chxl
指定的預設標籤或自訂標籤,指定要顯示的軸標籤。如果不使用這個參數指定確切位置,標籤會沿著軸平均間隔且採用預設步驟值。如未指定 chxl
,勾號標籤就會為預設值 (通常是資料值或長條圖中的長條)。
語法
請使用直立線字元 (|
) 分隔多個位置集。
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <axis_index>
- 您要指定位置的軸。這是
chxt
參數陣列的索引。舉例來說,如果您有chxt=x,x,y,y
,則索引 0 是第一個 x 軸,1 是第二個 x 軸,以此類推。 - <label_1_position>,...,<label_n_position>
- 標籤沿著軸的位置。這是以半形逗號分隔的數值清單,其中每個值會設定
chxl
陣列中對應標籤的位置:第一個項目會套用至第一個標籤,依此類推。位置是該軸的範圍中的值。請注意,除非您已使用chxr
指定自訂範圍,否則這個值一律為 0 至 100。依據為該軸的標籤數量,您必須以標籤數量為準。
例子
說明 | 範例 |
---|---|
這個範例包含圖表上特定位置的 r 軸標籤。標籤文字是使用 指定位置為 指定位置為 |
|
這個範例說明顯示預設標籤值,但只會在指定位置顯示。
|
chxt=x,y
chxt=x,y 未指定 chxp |
軸標籤樣式chxs
您可以為軸標籤 (自訂標籤和預設標籤值) 指定字型大小、顏色和對齊方式。同一軸上的所有標籤格式皆相同。如果軸有多個副本,您可以用不同格式分別設定副本。您也可以指定標籤字串的格式,例如顯示貨幣符號或結尾的零。
根據預設,頂端和底部軸不會依值顯示勾號,左側和右側軸則顯示勾號。
語法
多個軸的值應以直立線字元 (|
) 分隔。
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_indexaxis_index>
- 要套用此項目的軸。這是匯入
chxt
參數,從零開始的索引。 - <opt_format_string>
- [選用] 這是選用格式字串,如果使用的話,該字串緊接在軸索引編號後面,且中間沒有半形逗號。開頭會以常值字母 N 開頭,後面接有下列值 (選用):
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
以下是每個元素的含義:<preceding_text>
- 每個值前面的常值。*...*
:以常值星號括住的選用區塊,您可以在其中指定數字的格式詳細資料。系統支援下列值,你不一定要使用這些值:<number_type>
- 數字格式的數字格式。選擇下列其中一種交通方式:f
- [預設] 浮點格式。建議您使用 <decimal_places> 值來指定精確度。p
- 百分比格式。系統會自動附加 % 符號。注意:使用這種格式時,資料值會從 0.0 - 1.0 對應至 0 - 100% (例如,0.43 會顯示為 43%)。e
- 科學記號格式。c<CUR>
:以指定幣別設定數字格式,並使用適當的貨幣標記。將<CUR>
替換為三個字母的貨幣代碼。例如:cEUR
代表歐元。您可以在 ISO 網站找到代碼清單,但系統僅支援部分符號。
<decimal_places>
- 一個整數,用來指定要顯示的小數位數。這個值會四捨五入 (不會截斷) 至這個長度。預設值為 2。z
- 顯示結尾的零。預設值為 no。s
- 顯示群組分隔符。預設值為 no。x
或y
:依指定顯示 x 或 y 座標的資料。x 資料的意義因圖表類型而異:您可以用圖表進行實驗,判斷資料的意義。預設值為 'y'。
<following_text>
:每個值接續的常值文字。
- <opt_label_color>
- 要套用至軸文字 (而非軸線) 的顏色,以 RRGGBB 十六進位格式。使用 opt_axis_color 可個別指定軸線顏色。預設值為灰色。
- <opt_font_size>
- [選用] 可指定字型大小 (以像素為單位)。這是選用參數。
- <opt_alignment>
- [選用] 標籤對齊設定。針對頂端或底部軸,這項資訊說明瞭標籤與上方或下方的刻點標記對齊的方式。如果是左側或右側軸,則說明在定界框內對齊時 (輕觸軸) 的方式。指定下列其中一個數字:
-1
- 頂端或底部:標籤在刻點的右側;向左或向右:標籤在所屬區域靠左對齊。R 軸標籤的預設值。0
- 頂端或底部:標籤位於刻點中央;向左或向右:標籤在其區域置中。X 軸和 T 軸標籤的預設設定。1
- 頂端或底部:標籤在刻點的左側;向左或向右:標籤在所屬區域靠右對齊。Y 軸標籤的預設值。
- <opt_axis_or_tick>
- [選用;Google-o-meter 不支援] 是否顯示這個軸的刻點標記和/或軸線。虛線標記和軸線僅適用於最內側的軸 (例如,兩個 X 軸的外側不支援)。請使用下列其中一個值:
l
(小寫「L」) - 僅繪製軸線。t
- 只畫出勾號。勾號是指軸標籤旁的小線條。lt
:[預設] 繪製所有標籤的軸線和刻點標記。_
- (底線) 不繪製軸線和刻點符號。如要隱藏軸線,請使用這個值。
- <tick_color>
- [optional; not 支援 in Google-o-meter] 刻點標記顏色,使用 RRGGBB 十六進位格式。預設值為灰色。
- <opt_axis_color>
- [選用] 這個軸線的顏色,使用 RRGGBB 十六進位格式。預設值為灰色。
例子
說明 | 範例 |
---|---|
第二個 X 軸 (1 月、2 月、3 月) 已指定字型大小和顏色。 |
|
字型大小、顏色和對齊方式是在右側 Y 軸上。繪製是沒有軸線的勾號。 |
|
這張圖表包含三個資料集,並顯示三組軸標籤 (每個序列一個)。每一組標籤都會使用自訂格式設定字串格式化,如下所示:
軸標籤範圍是使用 |
chd=s: |
軸線標記樣式chxtc
您可以為特定軸指定長刻度記號。通常用於延長圖表長度的勾號。使用 chxs
參數即可變更勾號顏色。
多個軸的值應以直立線字元 (|
) 分隔。系列中的值應以半形逗號分隔。
語法
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_indexaxis_index>
- 要套用此項目的軸。這是匯入
chxt
參數,從零開始的索引。使用長條符號分隔不同軸的值。 - <tick_length_1>,...,<tick_length_n>
- 該軸上的刻度標記長度,以像素為單位。如果指定單一值,這個值就會套用至所有值;如果指定了多個值,軸刻點標記會在該軸的值清單上循環播放。正值會在圖表區域外繪製,並由圖表邊框裁剪。正值的最大值為 25。負值會繪製在圖表區域內,並由圖表區域邊框裁剪。
例子
說明 | 範例 |
---|---|
使用
|
|
這張圖表顯示的是交替刻度長度。chxtc 會指定 Y 軸 (5 和 15) 的兩個刻點長度值,而圖表上繪製的刻度在兩個值之間會交替使用。 |
chxt=x,y |
背景填滿 chf
[所有圖表]
您可以指定圖表資料區域和/或整個圖表背景的填滿顏色和樣式。填滿類型包括單色、條紋填滿和漸層。您可以為不同區域指定不同的填滿 (例如整個圖表區域,或僅限資料區域)。圖表區域填滿會覆寫背景填滿效果。所有填滿效果都是使用 chf
參數指定,而且您可以在同一個圖表中混用不同的填滿類型 (單色、條紋、漸層)。以直線字元 ( | ) 分隔值。圖表區域會填滿圖表背景填滿效果。
填滿填滿chf
[所有圖表]
您可以為背景和/或圖表區域指定實心填滿,或為整個圖表指派透明度值。您可以使用直立線字元 (|
) 指定多個填色 (地圖:僅限背景)。
語法
chf=<fill_type>,s,<color>|...
- <填入類型fill_type>
- 圖表中填滿的部分。你可以指定下列其中一個值:
bg
- 背景填滿c
- 圖表區域填滿。不支援地圖圖表。a
- 將整個圖表 (包括背景) 設為透明。系統會忽略<color>
的前六位數,且只會將最後兩位數 (透明度值) 套用至整個圖表和所有填滿效果。b<index>
- 長條純填滿 (僅限長條圖)。將 <index> 替換為長條的序列索引,以填入單色。效果與在長條圖中指定chco
類似。如需範例,請參閱長條圖圖表系列顏色。
- 秒
- 代表實心或透明度填滿。
- <color>
- 填滿顏色,採用 RRGGBB 十六進位格式。如果是轉碼,系統會忽略前六位數,但仍必須加入。
例子
說明 | 範例 |
---|---|
這個範例會以灰色 ( |
|
這個範例會以淡灰色 ( |
|
這個範例對整個圖表套用 50% 的透明度 (128 十六進位數字 80 或約 50%)。請注意,透過圖表顯示的表格儲存格背景。 |
|
漸層填滿chf
[Line、Bar、Google-o-meter、Radar、Scatter、Venn]
您可以將一或多個漸層填滿效果套用至圖表區域或背景。漸層填滿效果會從一種顏色淡出。(圓餅圖、Google-公制圖表:僅限背景)。
每個漸層填滿會分別指定角度,以及錨定至指定位置的兩種以上顏色。不同錨點之間移動時,顏色各有不同。必須有至少兩種具有不同 <color_centerpoint> 值的顏色,才能淡入另一個顏色。每個其他漸層都由 <color>,<color_centerpoint> 配對指定。
語法
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <填入類型fill_type>
- 要填滿的圖表區域。下列其中一欄:
bg
- 背景填滿c
- 圖表區域填滿。b<index>
- 長條漸層填滿 (僅限長條圖)。將 <index> 換成長條的序列索引,以填入漸層。如需範例,請參閱長條圖圖表系列顏色。
- lg
- 指定漸層填滿。
- <角度>
- 這個數字可指定從 0 (水平) 到 90 (垂直) 的漸層角度。
- <color>
- 填滿顏色,以 RRGGBB 十六進位格式。
- <color_centerpoint>
- 指定顏色的錨點。接近另一個錨點時,顏色就會從這個點開始淡出。這個值範圍介於 0.0 (底部或左側) 到 1.0 (頂端或右側邊緣),並傾斜至 <angle> 指定的角度。
例子
說明 | 範例 |
---|---|
圖表區域具有水平線性漸層,並以零度 ( 顏色為桃紅色 ( 圖表背景會以灰色 ( |
|
圖表區域採用對角線 (從左下到右下方) 線性漸層,指定的角度為四十五度 ( 桃紅色 ( 藍色 ( 圖表背景會以灰色 ( |
|
圖表區域具有垂直 (由上至下) 線性漸層,其角度為九十度 ( 藍色 ( 桃紅色 ( 圖表背景會以灰色 ( |
|
條紋填滿chf
[Line, Bar, Google-o-meter, Radar, Scatter, Venn]
您可以為圖表區域或整個圖表指定條紋背景填滿效果。(圓餅圖、Google-公制圖表:僅限背景。)
語法
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <填入類型fill_type>
- 要填滿的圖表區域。下列其中一欄:
bg
- 背景填滿c
- 圖表區域填滿b<index>
- 條紋填滿 (僅限長條圖)。將 <index> 取代為要以條紋填滿的長條的序列索引。如需範例,請參閱長條圖系列顏色。
- ls
- 指定線性條紋填滿效果。
- <角度>
- 所有條紋的角度 (相對於 Y 軸)。使用
0
做為垂直條紋,使用90
做為水平條紋。 - <color>
- 此條紋的顏色,採用 RRGGBB 十六進位格式。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表,否則會進行替換。
- <width>
- 此條紋的寬度,從
0
到1
,其中1
是圖表的完整寬度。系統會重複新增線條,直到圖表填滿為止。針對每個其他條紋重複執行 <color> 與 <width>。至少須有兩條條紋。除非填滿圖表,否則會進行替換。
例子
說明 | 範例 |
---|---|
|
chf= |
|
chf= |
格線chg
[Line、Bar、Radar、Scatter]
您可以使用 chg
參數指定圖表上的實線或虛線格線。
但你無法指定線條的粗細或顏色。想瞭解更多在圖表上繪製線條的方法,請參閱形狀標記 (chm
類型 h、H、v 或 V)、範圍標記 (chm
) 和軸刻點標記 (chxtc
)。
語法
chg= <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
- <x_axis_step_size>、<y_axis_step_size>
- 用於計算圖表要顯示多少 x 或 Y 格線線。100 / step_size = 圖表中的格線數。因此,20,25 代表 5 個垂直格線和 4 條水平格線。
- <opt_dash_length>、 <opt_space_length>
- [選用] 用於定義虛線格線。第一個參數是每一行虛線的長度 (以像素為單位)。 第二個參數是虛線之間的間距 (以像素為單位)。將 <opt_space_length> 指定為 0,表示實線。預設值為 4,1。
- <opt_x_offset>,<opt_y_offset>
- [選用] 依圖表比例縮放的單位數量,分別用來偏移 x 和 y 格線線。可以是正值或負值。如果您要指定這個值,也必須一併指定所有先前的值。預設值為 0,0。
例子
說明 | 範例 |
---|---|
這些範例只會使用 |
chg=20,50 chg=20,50 |
此範例使用較大的空格來顯示較淺的格線 ( |
|
如要顯示實線格線,請將 此外,這張圖表的 X 軸偏移值是 10。 |
chg=20,50,1,0,10 |
此圖表顯示 X 軸偏移值 10,y 軸偏移為 20。 |
chg=20,50,3,3,10,20 |
線條樣式 chls
[線條、雷達]
可以使用 chls
參數指定線條粗細和實線/虛線樣式。這個參數只能用於設定折線圖或雷達圖中的線條樣式,而只有在複合圖表的基礎類型為折線圖時,才能使用這個參數設定線條樣式。
語法
以直立線字元 ( |
) 分隔多個行樣式;第一個樣式適用於第一行,第二個樣式則適用於下一行,依此類推。如果您擁有的樣式少於行數,系統會將預設樣式套用至所有未指定的行。
chls= <line_1_thickness>,<opt_dash_length>,<opt_space_length> |...| <line_n_thickness>,<opt_dash_length>,<opt_space_length>
- <line_1_thickness>
- 線條的粗細,以像素為單位。
- <opt_dash_length>、 <opt_space_length>
- [選用] 用於定義虛線格線。第一個參數是每一行虛線的長度 (以像素為單位)。 第二個參數是虛線之間的間距 (以像素為單位)。如果是實線,則未指定任何值。如果只指定 <opt_dash_length>,<opt_space_length> 就會設為 <opt_dash_length>。預設值為 1,0 (實線)。
例子
說明 | 範例 |
---|---|
這裡的虛線是由 |
chls=3,6,3|5 |
動態圖示標記 chem
[Bar、Line、Radar、Scatter]
建立圖表,並將一或多個動態圖示指定為化學值。chem
的語法如下。紫色以半形分號分隔的所有項目皆為選用,在網址中即可完全省略這些項目。如要加入多個標記,可以加入多個以 | 字元分隔的語法字串。如要進一步瞭解動態圖示,請參閱動態圖示頁面。
您也可以將圖表嵌入其他圖表,做為動態圖示。請參閱下方的「內嵌圖表」子章節。
chem= y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
|...| y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
- s=<icon_string_constant>
- 動態圖示的字串標記常數,來自動態圖示頁面。此常數與獨立圖示的
chst
參數「幾乎」相同。但若獨立圖示字串的開頭是「d_」,您應該移除這個前置字串,才能取得對等的動態圖示標記。範例:獨立圖示:d_bubble_icon_text_small
;對等的動態圖示標記:bubble_icon_text_small
。 - d=<marker_data_stringmarker_data_string>
- 這個特定標記類型需要的資料。這會保留用於在
chld
參數中用於對等獨立圖示的字串,不過 ,所有 | 分隔符號都應以半形逗號取代 (請記得使用半形逗號取代多行文字的直立線標記!)。請注意,在資料字串中,您也必須使用 @ 符號逸出下列字元:直立線 ( | )、 at ( @ )、等於 ( = )、半形逗號 ( , )、分號 ( ; )。 範例:hello@,+world
、5@@10+cents+each
。 - ds=<which_series>
- [選用] 這個標記所屬的資料序列索引,從零開始。預設值為 0。
- dp=<which_points>
- [選用] 指定用來繪製標記的資料點。預設值為 0 (系列的第一個點)。請使用下列其中一種格式:
n.d
- 要繪製標記的資料點,其中「n.d」n.d是序列中從零開始的索引。如果指定非整數值,分數則會指出計算的中繼點。例如,3.5 代表點 3 到點 4 之間的中段。range,<start>,<end>,<step>
- 在從 start 到 end (含) 之間的每個 step 資料點上繪製標記。起始和結束是索引值,可以是浮點數,用來表示中繼值。所有值皆為選用值,預設值為:start=0、end=last item、step=1。如果略過值,仍須加入任何中繼逗號,但不必加入空白的結尾半形逗號。例如:dp=range,0,4
會在元素 0 到 4 上繪製標記;dp=range,5,10,2
會在元素 5、7 和 9 上繪製標記;dp=range,2
會在第三個點和較晚的點上繪製點;dp=range,3,,1.5
會在從四個項目到最後一個項目之間的每 1.5 個資料點上繪製標記。all
- 為每個元素繪製標記。這相當於range,0,end_index
。範例:dp=all
every,n
- 在每個第 n 個標記上繪製標記。範例:dp=every,2
會在項目 0、2 和 4 上繪製標記。
- py=<z_order>
- [選用] 繪製標記的圖層,與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數,-1.0 為底部,而 1.0 為頂端。圖表元素 (折線圖和長條) 正低於零。如果兩個標記的值相同,則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
- po=<x,y>
- [選用] 圖表上繪製標記時的絕對位置。x 和 y 是兩個浮點數,其中 0.0,0.0 是左下角,1.0,1.0 代表右上角。
- =<x_offset,y_offset>
- [選用] 代表圖示與正常位置偏移的像素數量。x_offset 和 y_offset 為正整數或負整數。請務必在嵌入的動態圖示中指定這個值,因為標記會沿著該點的垂直和水平置中,也就是說,該點可能不會與資料標記對齊。直立圖釘的理想位移為
of=0,22
;傾斜圖釘的良好位移是of=-12,20
或of=12,20
,視斜面方向而定,但您可能必須進行實驗。預設值為 0,0。
例子
說明 | 範例 |
---|---|
在以下示例中,同樣的動態圖示是以獨立圖片的形式建立,並當做折線圖中的標記使用。 圖表 1: 圖表 2: |
|
請注意,動態圖示標記的水平和垂直置中。因此,如果您使用含有尾數的動態圖示,尾部並不會位於圖表點上,因此標記中心為。第一張圖表將標記置於資料點 3 的中心,該資料點實際上將尾部稍微放在線條上的標記右側。 第二個圖表使用 |
chem=y;
chem=y; |
如要加入多個動態圖示,請重複使用 | 字元分隔的語法字串。 這個範例顯示一個範圍以及兩個個別標記。 請注意垂直圖釘與 0,22 之間的位移,傾斜圖釘的偏移值則為 12,20,讓圖釘與所描述的序列對齊。 |
chem= |
這說明瞭多行文字標記。新增文字後,標記必須偏移,因為對話框會依照文字調整大小,進而在圖表上重新置中。請注意,在 d 資料字串中,文字中的換行符號會以半形逗號表示。 |
chem=y; |
內嵌圖表
您可以使用動態圖示語法,將圖表嵌入其他圖表。
嵌入圖表標記有兩種樣式:嵌入泡泡中的圖表,以及不含泡泡的嵌入式圖表。以下是這兩種網址的範例:
含有泡泡的圖表 |
不含泡泡的圖表 |
以下是 s=<icon_string_constant>;d=<marker_data_string>
參數的具體細節,適用於非對話框和泡泡內嵌圖表 (以上說明的參數不會再次說明):
語法
Non-bubble: chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset> Bubble: chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
- alignment_string
- [僅限非對話框] 無泡泡嵌入圖表的哪個部分會固定在資料點。請選擇下圖中的其中一個雙字母字串常數:
- chart_data
- 嵌入圖表的資料。以上就是要嵌入圖表網址
https://chart.googleapis.com/chart?
後方的所有內容。請使用下方的工具,或是遵循工具下方的規則。 - frame_type
- [Bubble only] 其中一個動態圖示框架樣式常數。
- 邊框間距
- [僅限對話框] 對話框中的邊框間距 (以像素為單位)。
- frame_color
- [僅限對話框] 影格顏色,以六位數 HTML 顏色字串表示,不含 # 標記。範例:
FF00FF
。 - fill_color
- [僅限對話框] 對話框內填充顏色的六位數 HTML 顏色字串,不含 # 標記。範例:
FF00FF
。
已嵌入圖表資料
請使用以下轉換工具來產生圖表字串,或按照工具隨後提供的規則,手動產生圖表字串。
手動轉換規則
1. 首先,依照顯示順序,將參數和值組合中的所有下列字元替換為下列值:
取代 | 有了 |
---|---|
%7C 或 %7c |
| |
@ |
@@ |
% |
%25 |
, |
@, |
| |
@| |
; |
@; |
& |
%26 |
= |
%3D |
2. 然後將 parameter1=value1¶meter2=value2...
組合中的所有 &
和 =
值替換為半形逗號。
換行 chm
[Line, Radar]
您可以使用單色填滿資料行下方的區域。
您可以使用直立線字元 ( |
) 結合行填入與任何其他 chm
參數,以分隔 chm
參數。
語法
chm= <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0> |...| <b_or_B>,<color>,<start_line_index>,<end_line_index>,<0>
- <b_or_B>
- 選擇要填滿圖表底部,還是只填滿下一行。
- B - 從
<start_line_index>
填滿圖表底部。<end_line_index>
支援特殊語法,可讓您填入圖表片段。最簡單的方法是在圖表中加入想填滿的單一線條。 - b - 填滿多線圖中的兩條線。起始行和結尾線會以
<start_line_index>
和<end_line_index>
表示。
- B - 從
- <color>
- 填滿顏色的 RRGGBB 格式十六進位數字。
- <start_line_index>
- 填入開始的行索引。
chd
中指定的第一個資料序列的索引為 0 (0
),第二個資料序列的索引為1
,依此類推。 - <end_line_index>
-
- 填入類型「b」- 要停止填滿的行。這一行必須低於目前行。
- 填入類型
「B」- 下列其中一個選項:
- any value - 系統會忽略這個參數中的所有單一數字,填入從指定線條到圖表底層的填滿效果
- start:end:如要填滿圖表下方的垂直區塊,請指定 start:end,其中這些資料點索引會說明開始和停止填滿的位置。這兩個值皆為選用值,預設為 first_point:last_point。 (請參閱以下範例)。
- <0>
- 預留項目 - 必須為零。
例子
說明 | 範例 |
---|---|
如果是單一系列叢書,最簡單的方法就是使用 雷達圖只能使用這個填滿區域類型。 |
|
以下是其中有兩條折線和兩條填滿的圖表。填寫底線下方的區域和第一行上方必須用到特殊技術,接下來我們會說明。 |
|
在多線圖中,如要從圖表頂端填滿第一行,您需包含的序列包含資料格式中最高資料值的兩個複本。因此,例如用於擴充編碼的「 如要填滿圖表的最後一行,請納入一系列的序列,其中包含資料格式最低資料值的兩個複本。例如,擴充編碼的 AAAA、基本文字格式 0,0 等等。 線條本身會以黑色繪製,並使用 |
chd=e: (最高值) (零值)chm= (淺藍色) b,224499,1,2,0| (藍色) b,FF0000,2,3,0| (紅色) b,80C65A,3,4,0 (綠色)chco=000000 |
以下是垂直填滿區塊的折線圖。方法是為 <end_line_index> 指定 start:end 組合,行填入類型「B」。
|
chm= |
以下範例說明如何在雷達圖中使用線條填滿。 |
chm= |
形狀標記 chm
[長條圖、線條、雷達、散佈圖]
您可以為圖表上的所有或個別資料點指定圖形標記。如果多個標記位於同一個點,則系統會依照標記在 chm
參數中顯示的順序繪製這些標記。您也可以針對資料點建立文字標記,詳情請參閱資料點標記。
您可以使用直立線字元 ( |
) 合併形狀標記與任何其他 chm
參數,藉此分隔 chm
參數。
語法
請為應標記的各個系列指定下列一組參數。如要標記多個系列,請建立其他參數組合,並以直立線字元分隔。您不必標記所有系列叢書。如果沒有為資料序列指派標記,該系列將不會取得任何標記。
形狀標記在散佈圖表中的行為略有不同。詳情請參閱相關說明文件。
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>
- @
- [選用] 如果您在標記類型前面加上選用的 @ 字元,則 <opt_ which_points> 應使用 x:y 格式。
- <marker_type>
- 要使用的標記類型。指定下列其中一種類型:
a
- 箭頭c
- 交叉C
- 矩形。如果有矩形標記,則必須有至少兩個資料序列,其中序列 0 指定底部邊緣,序列 1 則指定頂部邊緣。<size> 會指定矩形的寬度 (以像素為單位)。d
- 鑽石E
- 錯誤列標記 ( ) 建立這個標記需要兩個資料序列,一個值代表底部,而第二個序列中代表的對應點。此外,還會公開擴充的 <size> 語法:line_thickness[:top_and_bottom_width],其中 top_and_bottom_width 為選用項目。請參考下列範例。h
- 以指定高度在圖表中跨越的水平線。 (<opt_which_points> 參數的唯一有效格式為 opt_which_points)。H
- 水平線穿過指定的資料標記。這支援擴充的 <size> 語法,可讓您指定確切的行長度:line_thickness [:length],其中 :length 為選用設定,預設為整個圖表區域寬度。o
- 社交圈s
- 正方形v
- 從 X 軸到資料點的垂直線V
- 可調整長度的垂直線。這支援擴充的 <size> 值語法,可讓您指定確切的行長度:line_thickness[:length],其中 :length 為選用設定,預設為整個圖表區域高度。標記會設定在資料點中心。x
- 一個 X
- <color>
- 這個序列的標記顏色,採用 RRGGBB 十六進位格式。
- <series_index>
- 要繪製標記的資料序列的從零開始索引。如果
h
標記和標記是以 x/y 位置指定位置 (開頭為 @ 字元),系統會忽略這項設定。您可以使用隱藏的資料序列做為標記的來源,詳情請參閱複合圖表。分組的垂直長條圖支援特殊擴充語法,以便將標記與特定長條對齊。 - <opt_which_points>
- [選用] 要在哪些點上繪製標記。預設值為所有標記。請使用下列其中一個值:
n.d
:標記的繪製位置。意義視標記類型而定:- h 以外的所有類型:要繪製標記的資料點,其中「n.d」是序列中以零為基礎的索引。如果指定非整數值,分數則代表計算的中繼點。例如,3.5 代表點 3 到點 4 之間的中段。
h
- 介於 0.0 到 1.0 之間的數字,其中 0.0 代表圖表底部,而 1.0 位於圖表頂端。
-1
- 在所有資料點上繪製標記。您也可以將這個參數留空,以便在所有資料點上進行繪製。-n
- 在每個「n」n個資料點上繪製標記。浮點值;如果 n 小於 1,圖表會為您計算其他中介點。例如,-0.5 將放置的標記數量為資料點的兩倍。start:end:n
- 在範圍中的每「n」n個資料點上繪製標記,從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目,因此 3:1 會從第四個元素到最後一個元素,步驟 1 中完全省略這個參數,則會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值,從最後一個值反向計算。如果 start 和 end 均為負值,請確認這些項目都已列為遞增的值 (例如 -6:-1:1)。 如果 n 步值小於 1,它將透過內插指定資料值來計算其他資料點。預設值為 first:last:1x:y
:在圖表上的特定 x/y 點繪製標記。這個點不一定要位於線路上。如要在標記類型前加上 @ 字元,請使用這個選項。將座標指定為浮點值,其中0:0
是圖表左下角,1:1
是圖表右上角。舉例來說,如要將 15 像素的紅色菱形加入圖表中央,請使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- 標記的大小,以像素為單位。這個參數最多採用單一數字值;V、H 和 S 標記支援 <size>[:width] 語法,且選用的第二部分可指定行或標記長度。
- <opt_z_order>
- [選用] 繪製標記的圖層,與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數,-1.0 為底部,而 1.0 為頂端。圖表元素 (折線圖和長條) 小於零。如果兩個標記的值相同,則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
- <opt_offset>
- [選用] 可讓您指定與指定位置之間的水平和垂直偏移值。以下是使用 : 分隔符號的語法:
reserved:<horizontal_offset>:<vertical_offset>
。如果有指定,即可在 <opt_z_order> 的chm
參數字串中加入空白的 , 值。範例:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reserve (保留) - 留空。
<horizontal_offset>
:指定水平偏移的正數或負數,以像素為單位。選用;如未使用,請留空。<vertical_offset>
:指定垂直偏移的正數或負數,以像素為單位。選用;如未使用,請留空。
例子
說明 | 範例 |
---|---|
以下是幾種形狀和線條標記的範例。
|
chm= |
以下舉例說明一個資料序列使用菱形的方法,以及其他資料序列的圓形。 如果多個標記位於相同點,則系統會依照標記在 |
chm= |
折線圖是每秒一個資料點 (-2 代表所有其他點)。 |
chd=t: |
以下是折線圖,標記數量是資料點的兩倍 (-0.5 代表每半點)。 | chd=t: |
這個範例說明如何使用 h 和 v 標記,建立自訂顏色和粗細的格線。Z 軸值 (最後一個值) 會設為 -1,這樣就會在資料行下方繪製格線。 |
chm= |
這張圖表會在折線圖中加入垂直填滿線:
|
chm= |
這個範例會使用確切座標,在圖表中加入箭頭和文字標記。第一個 D 標記是長條下方的追蹤記錄行,第二個標記是箭頭,第三個標記是箭頭文字。 | chm= |
固定為特定資料點的水平線 (H ) 很適合用來顯示相對值,或強調圖表中資料值的高度。 |
chm=H,FF0000,0,18,1 |
這張圖表展示了可在 <size> 參數中指定線條粗細和長度的標記。
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,9900CV6,1,2,506"chm= |
文字和資料值標記 chm
[Bar、Line、Radar、Scatter]
您可以用自訂文字或當時的格式化版本資料,為圖表上的特定點加上標籤。
您可以使用直立線字元 ( |
) 合併任何 chm
標記,藉此分隔 chm
參數組合。
字串值的注意事項:標籤字串只能使用安全網址字元。為了安全起見,如果字串包含非字元集 0-9a-zA-Z
中的字元,您應該進行網址編碼。您可以在 Google 視覺化說明文件中找到網址編碼器。
語法
請為應標記的各個系列指定下列一組參數。如要標記多個系列,請建立其他參數組合,並以直立線字元分隔。您不必標記所有系列叢書。如果沒有為資料序列指派標記,該系列將不會收到任何標記。
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- 要使用的標記類型。可選用的類型如下:
f<text>
- 包含文字的旗標。請指定「f」字元,後面接著自訂網址編碼的文字。如要在文字標記中逸出半形逗號,請在半形逗號前方加上 \ 符號。範例:fHello\,+World!
t<text>
- 簡單的文字標記。請指定「t」字元後接自訂網址編碼文字。如要在文字標記中逸出半形逗號,請在半形逗號前方加上 \ 符號。範例:tHello\,+World!
A<text>
:註解標記。這與標記標記類似,但標記會協調位置,以免重疊。<opt_which_points> 的有效格式為 opt_which_points,用於表示序列中資料點的索引。N<formatting_string>
- 這個時間點的資料值,並可選擇套用格式。如果您並未使用chds
參數 (自訂縮放功能),則該參數會提供確切的編碼值;如果您將該參數用於「任何格式類型」,系統就會將值縮放為您指定的範圍。請參閱下方含有數值標記的chds
範例。在堆疊長條圖中,如果為 <series_index> 指定 -1,就會獲得顯示此堆疊長條中所有值總和的標記。格式化字串語法如下:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
。
這些元素全都為選用元素。以下是每個元素的意義:<preceding_text>
- 每個值前面的文字。*...*
:以常值星號括住的選用區塊,您可以在其中指定數字的格式詳細資料。系統支援下列值,你不一定要使用這些值:<number_type>
- 數字格式的數字格式。選擇下列其中一種交通方式:f
- [預設] 浮點格式。建議您使用 <decimal_places> 值來指定精確度。p
- 百分比格式。系統會自動附加 % 符號。注意:使用這種格式時,資料值會從 0.0 - 1.0 對應至 0 - 100% (例如,0.43 會顯示為 43%)。e
- 科學記號格式。c<CUR>
:以指定幣別設定數字格式,並使用適當的貨幣標記。 將<CUR>
替換為三個字母的貨幣代碼。例如:cEUR
代表歐元。您可以在 ISO 網站查看代碼清單,但系統僅支援部分符號。
<decimal_places>
- 一個整數,用來指定要顯示的小數位數。這個值會四捨五入 (不會截斷) 至這個長度。預設值為 2。z
- 顯示結尾的零。預設值為 no。s
- 顯示群組分隔符。預設值為 no。x
或y
:依指定顯示 x 或 y 座標的資料。x 資料的意義因圖表類型而異:您可以用圖表進行實驗,判斷資料的意義。預設值為 'y'。
<following_text>
- 接續各個值的文字。
- <color>
- 此組合的標記顏色,以 RRGGBB 十六進位格式。
- <series_index>
- 要繪製標記的資料序列的從零開始索引。如果這是堆疊長條圖,且標記類型為 N (資料點值),您可以指定 -1 來為每個長條堆疊建立加總值標記。請參閱以下範例。
- <opt_which_points>
- [選用] 要在哪些點上繪製標記。預設值為所有標記。請使用下列其中一個值:
n.d
- 要繪製標記的資料點,其中「n.d」n.d是序列中從零開始的索引。如果您指定非整數值,分數則代表計算的中繼點。例如,3.5 代表點 3 到點 4 之間的中段。-1
- 在所有資料點上繪製標記。您也可以將這個參數留空,以便在所有資料點上進行繪製。-n
- 在每個「n」n個資料點上繪製標記。start:end:n
- 在範圍中的每「n」n個資料點上繪製標記,從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目,因此 3:1 會從第四個元素到最後一個元素,步驟 1 完全省略這個參數,並完全省略這個參數,會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值,從最後一個值反向計算。如果 start 和 end 均為負值,請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1,系統會透過內插資料值來計算其他資料點。預設值是 first:last:1x:y
- [N 類型標記不支援]] 在圖表上的特定 x/y 點繪製標記。這個點不必位於線條上。如要在標記類型前加上 in 字元 (@
),請使用這個選項。將座標指定為浮點值,其中0:0
是圖表左角,0.5:0.5
是圖表的中央,1:1
則是圖表右上角。舉例來說,如要將 15 像素的紅色鑽石加入圖表中央,請使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- 標記的大小,以像素為單位。如果這是包含第三個資料序列的散佈圖 (用來指定點大小),這個值將依據資料範圍縮放。也就是說,如果資料範圍是 0—100,<size> 為 30,則資料值為 100 的寬度就會是 30 像素,則資料值 50 會寬度為 15 像素,依此類推。
- <opt_z_order>
- [選用] 繪製標記的圖層,與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數,-1.0 為底部,而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同,則會按照網址指定的順序繪製。預設值為 0.0 (接近圖表元素上方)。
- <opt_placement>
- [選用] 其他刊登位置詳細資料,說明標記放置位置 (相對於資料點)。您可以指定水平和/或垂直的相對位置以及偏移值。刊登位置語法是一種字串,其中含有分隔符號,如下所示。所有元素皆為選用元素:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
。如果有指定,您可以在 <opt_z_order> 的chm
參數字串中加入空白的 , 值。範例:N,000000,0,1,10,,b
、N,000000,0,1,10,,lv
和N,000000,0,1,10,,r::10
。- horizontal_and_vertical_justification
- 標記的錨點。這的作用與對齊方式相反,因此左側錨點會將標記置於資料點的「右」。您可以從下列清單中選擇水平和/或垂直方向化器:
- 水平配置:「l」、「h」或「r」:靠左、置中或右錨定,水平位置。預設值為「l」。
- 垂直放置:「b」、「v」、「t」- 下、中間或頂端錨定廣告。預設值為「b」。
- 長條圖相關位置 [僅限長條圖]:「s」、「c」、「e」- 基準、中央或頂端長條。以堆疊圖表來說,這是相對於每個系列項目的長條區段,而非整個長條。如果指定的系列索引為 -1 (堆疊總數),表示該序列與整個長條有關。這可以與直向刊登位置值合併使用,例如「be」或「vs」。 預設值為「e」。
- horizontal_offset
- 此標記的水平偏移,以像素為單位。預設值為 0。
- vertical_offset
- 這個標記的垂直偏移,以像素為單位。非長條圖預設:15;長條圖預設:2。
說明 | 範例 | |
---|---|---|
以下是長條圖上值標籤的範例。 第一個圖表 ( 第二個圖表 ( |
|
|
您可以使用 這個範例顯示含有 46、39、29、30、43、41 等簡單編碼值的圖表。簡易編碼範圍介於 0 至 61 之間。 |
chd=s:underp |
|
以下圖表範例在最小點包含文字標籤,並在最大點加入標記標籤。 |
|
|
這個範例顯示了堆疊圖表,其中含有個別序列的值,以及序列總計。如要顯示堆疊序列值,必須使用「c」定位選項。如未顯示,頂端長條的值會與每個長條頂端的總和值重疊。 | chm= |
|
直向和橫向刊登位置運作方式的更多示範。 這個範例說明長條圖 (使用 s、c 和 e 代表垂直刊登位置) 錨定值的各種組合。請注意右錨點將標記向左移動,頂錨點會將標記向下移動,反之亦然。紅點代表每個長條的底座、中央和頂端。數字是資料值,每個長條使用不同的錨定值固定。 | chm= |
|
註解標記會自動調整標籤位置,以免重疊。第一個 chm 值適用於線條填滿,下列值皆為註解標記。 |
chm=B,C5D4B5BB,0,0,0 |
|
另一個顯示瑞士城市海拔高度的註解標記範例。 |
範圍標記 chm
[長條圖、K 線圖、線條、雷達、散佈圖]
您可以為背景的水平或垂直錶帶加上顏色,藉此凸顯圖表中的特定區域。
您可以使用直立線字元 ( |
) 合併任何 chm
標記,藉此分隔 chm
參數組合。
語法
請為每個要繪製的錶帶指定下列一組參數。如要繪製多個頻帶,請建立其他參數組合,並以直立線字元分隔。這些範圍會按照指定的順序繪製,因此最後一個繪製的範圍會繪製在先前範圍的上方。
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- 指定水平或垂直陰影。使用
r
做為水平範圍,使用R
表示垂直範圍。 - <color>
- 以 RRGGBB 格式的十六進位數字表示範圍顏色。
- 0
- 預留項目 - 必須為零。
- <start_point>
- 範圍的起始位置。
- 對於「水平」範圍標記,這是 Y 軸上的位置,其中
0.00
是圖表底部,而1.00
位於圖表頂端。 - 以「垂直」範圍標記來說,這是 X 軸上的位置,其中
0.00
是圖表的左側,1.00
代表圖表右側。
- <end_point>
- 範圍的結束位置。
- 對於「水平」範圍標記,這是 Y 軸上的位置,其中
0.00
是圖表底部,而1.00
位於圖表頂端。 - 以「垂直」範圍標記來說,這是 X 軸上的位置,其中
0.00
是圖表的左側,1.00
代表圖表右側。
例子
說明 | 範例 |
---|---|
範圍標記可以是細線或一種顏色。
|
|
這個範例顯示垂直範圍標記。第一個標記是紅線 ( |
|
標記會按照指定的順序繪製。在這個範例中,您可以看到垂直紅色標記在淡藍色水平標記之前繪製。 |
chm= |
以下折線圖範例使用範圍標記繪製圖表的零線、中點線和頂部較淡的水平線。 |
|
K 線標記 chm=F
[Bar, Line]
K 線標記表示資料序列中的變異數和方向變化。經常用於顯示一天內的股價。標記中有顯示高和低值的路段,以及特定時間範圍 (通常是一天) 的開盤和結束值。如要進一步瞭解 K 線標記,請參閱這個網頁。
K 線標記是一個由垂直分隔的矩形繪製而成。我們需要四個資料序列來繪製一個 K 線標記,以下是每個序列指定的內容:
- 系列 1 和 4 分別指定垂直線的底部和頂端。這些數值通常代表當天的低值和最高值。
- 系列 2 和 3:指定矩形的垂直框線。第 2 層是開盤價,第 3 系列則是結尾值。矩形的顏色取決於高度:當開盤值 (第 2 號) 低於最終值 (第 3 輪) 時,價格會增加,且矩形會預設為實心綠色;開盤值 (第 2 輪) 高於收尾值 (第 3 輪) 時,價格會降低,而矩形會填滿紅色。您只能針對要縮小的矩形指定填滿顏色。指定這個值時,值為增加的矩形會是未填滿 (空白)。請注意,序列 2 可以是矩形頂端或底部,取決於價格上漲或下跌。
您也可以使用直立線字元 ( |
) 合併 K 線標記與其他 chm
參數,藉此分隔 chm
參數。
注意:如果您不希望繪製標記時呈現的資料線條,就必須在格式類型後方加上 0。例如:文字格式資料字串中的 chd=t0:10,20,30,40
。詳情請參閱複合圖表。
以下範例顯示每個系列叢書的行:
語法
chm= F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>
- F
- 表示這是 K 線標記。
- <opt_declining_color>
- [選用] 值降低時,矩形的填滿顏色 (當序列 2 值 > 對應的序列 3 值時)。此為 RRGGBB 格式的十六進位數字。值增加時,矩形會是空白。預設為恆亮綠燈,以恆亮紅色以減少數值 (不得針對增加的值指定自訂填滿顏色)。
- <data_series_index>
- 資料序列索引,為 K 線標記的第一個序列。這個索引從零開始。因此,如果您在此處指定 1,而您有六個序列,那麼第二個、第三、第四和第五種就會用來繪製 K 線標記。
- <opt_what_points>
- [選用] 指定用來繪製標記的資料點。預設值為所有標記。請使用下列其中一種格式:
n.d
:在系列的單一點上繪製標記,其中「n.d」n.d是序列中點的索引。如果指定非整數值,分數則代表計算的中繼點。例如,3.5 代表點 3 到點 4 之間的中段。-1
- 在所有資料點上繪製標記。您也可以將這個參數留空,以便在所有標記上繪圖。-n
- 在每個「n」n個資料點上繪製標記。start:end:n
- 在範圍中的每「n」n個資料點上繪製標記,從 n 到 n 索引值 (含頭尾)。所有參數不一定都是選用項目,因此 3:1 會從第四個元素到最後一個元素,步驟 1 中完全省略這個參數,則會預設為 first:last:1。所有值都可以是浮點數。start 和 end 可以是負值,從最後一個值反向計算。如果 start 和 end 均為負值,請確認這些值列於遞增值 (例如 -6:-1:1)。如果 n 步值小於 1,系統會透過內插資料值來計算其他資料點。預設值是 first:last:1
- <寬>
- 所有矩形的寬度,以像素為單位。
- <opt_z_order>
- [選用] 繪製標記的圖層,與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數,-1.0 為底部,而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同,則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
例子
說明 | 範例 |
---|---|
以下是折線圖中含有四個序列的 K 線標記範例。已指定自訂填滿顏色 圖表會剪輯第一個和最後一個矩形。如要去除這些值,您可以在第四個 chm 參數中指定 1:4。 請注意,如要隱藏序列行,請注意資料字串中的零: <which_point> 參數為空白,會在所有資料點上繪製 K 線。 |
chd=t0: |
以下是相同的圖表範例,使用預設顏色並移除第一個和最後一個項目。 這是複合圖表,這是折線圖 (基本圖表類型) 和 K 線標記的組合。 |
|
線條標記 chm=D
[長條圖、K 線圖、線條、雷達、散佈圖]
您可以在圖表中新增用來追蹤資料的線條。這類圖表最常用於複合圖表。
如要新增多行 (或與其他 chm
標記合併),請使用直立線 ( |
) 分隔符號分隔 chm 參數集。您無法使用這項參數製作虛線標記。
語法
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- 代表這是線條標記。
- <color>
- 線條的顏色,採用 RRGGBB 十六進位格式。
- <series_index>
- 用於繪製線條的資料序列索引。第一個資料序列的資料序列索引為
0
,第二個資料序列的1
,依此類推。 - <which_points>
- 序列中要用來繪製線條的點。請使用下列其中一個值:
0
- 使用系列中的所有分數。start:end
- 使用從 start 到 end (從零開始計算) 之間的特定範圍點。您也可以使用浮點值指定中繼點,或將 start 或 end 留空,分別表示第一個或最後一個資料點。start 和 end 可以是負值,做為從最後一個值開始的反向索引。如果 start 和 end 均為負值,請務必以遞增的值寫入 (例如 -6:-1)。
- <size>
- 線條的寬度 (以像素為單位)。
- <opt_z_order>
- [選用] 繪製標記的圖層,與其他標記和所有其他圖表元素相比。這是介於 -1.0 到 1.0 (含) 之間的浮點數,-1.0 為底部,而 1.0 為頂端。圖表元素 (折線和長條) 小於零。如果兩個標記的值相同,則會按照網址指定的順序繪製。預設值為 0.0 (在圖表元素上方)。
例子
說明 | 範例 |
---|---|
以下是在長條圖上繪製標記線條的範例。Z 軸順序設為 |
chm=D,0033FF,0,0,5,1 |
這和相同的長條圖,但包含折線專用的額外資料序列。以下為複合圖表範例。藉由在 詳情請參閱複合圖表。 |
chm=D,0033FF,1,0,5,1 |
資料函式chfd
[全部
chd
圖表]
您可以使用 muParser 函式語法,指定要對圖表資料執行的自訂函式。函式使用的資料可能來自以下兩個來源之一:
- 來自
chd
的資料序列 - 系統會從chd
的指定序列中提取資料。 chfd
參數本身宣告的值範圍 - 您可宣告任意資料範圍的開始、停止和步驟值。
請務必注意,在所有情況下,您必須將輸出內容指派給 chd
中的現有系列,該序列將由函式輸出覆寫。只有在所有函式都經過處理之後,系統才會顯示圖表。因此,如果您將多個函式指派給輸出至同一個資料序列,系統會依指定順序執行函式,但圖表上只會顯示最終函式的輸出內容。請注意,您可以鏈結函式,讓一個函式可做為輸入序列的輸入序列 (由先前函式輸出)。
如要為函式行指派顏色或 chm
標記,請將顏色或標記指派給函式的序列索引。請注意,系統會根據函式處理後的資料來放置標記。
語法
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_index>
chd
中的資料序列索引 (從零開始),用於寫入函式輸出內容。函式輸出將完全覆寫任何現有資料。如果某個系列並非函式的輸入內容,最佳做法是為該序列指派一個虛擬值。- <function_data>
- 要繪製的變數和資料。資料可以來自您定義的範圍,或來自其中一個
chd
資料序列。您可以為每個函式指定多個變數,也可以使用多個變數的 ; (分號) 分隔符號。請注意,如果您為單一函式定義了多個變數,且這些變數的點數不同,則該函式會在到達第一個端點時停止。例如,如果函式定義了 x=1 至 5 步驟 1 和 y=1 至 10 步驟 1,則函式會在到達第五點時結束。
<variable_name>,<input_series_index>
或
<variable_name>,<start>,<end>,<step>
- variable_name - 變數的任意字串名稱。請在 function_string 定義的函式中使用這項參數。
- input_series_index - 要做為輸入資料的
chd
資料序列索引。 - start:範圍中的數值起始值。
- end:範圍的結束數值。
- step - start 到 end 之間的數字步驟值。 可以是正數或負數,但不能為零。
x,0,100,1
宣告了名為x
的變數,值為 0、1、2、... 100。x,0,100,1;r,0,3.1,.1
會宣告相同的x
變數,以及名為r
的變數,值為 0、0.1、0.2、...、3.0、3.1。x,0
會宣告名為 x 的變數,這個變數會使用第一個chd
系列中的資料。function_string 會使用這些變數。除非您在 function_string 中指定這些變數,否則圖表不會標示這些字元。步數越小,圖表就會越順暢。 - <function_stringfunction_string>
- 您的函式 (以 muParser 語法 編寫)。該函式適用於 variable_data 中指定的變數和資料。您只能參照這個本機函式集中宣告的變數,無法參照其他管道式
chfd
參數組合中宣告的變數。不支援匯總 muParser 函式 (最小值、最大值、平均值)。重要事項:請記得在您的函式中使用%2B
,而不是+
!
例子
說明 | 範例 |
---|---|
簡單的正弦波。請注意以下事項:
|
cht=lc |
這一行使用來自 chd 參數的資料。 |
chd=t:5,10 |
混合函式和非函式行。 請注意系列顏色參數 請注意函式輸出中標記的位置;資料點從「start」、「end」和「step」開始計算,因此如果範圍是 0 到 11 步驟 0.1,點 0 為 0,點 1 為 0.1,依此類推,直到第 110 點的值為 11。 |
chd=t: |
如要以兩個維度定義函式,請使用
|
cht=lxy |
請嘗試點選這些圖片,以便在圖表遊樂場中開啟並暢玩這些圖片,一探究竟! |