במסמך הזה נסביר איך ליצור תרשים מסוג חוגה שנקרא 'תרשים Google-o-Meter'.
תוכן העניינים
תכונות שספציפיות לתרשים
|
תכונות רגילות
|
סקירה כללית
Google-o-Meter הוא מדד שמפנה לערך יחיד בטווח.
ניתן לציין דרגת צבע של הטווח. אפשר גם לציין
טקסט מותאם אישית מעל המצביע. טווח החיוג הוא מהערך המינימלי של פורמט הנתונים לערך המקסימלי. צריך לציין ערך נתונים אחד בפרמטר chd
שהחץ יצביע עליו.
אפשר לציין מספר חיצים באותו תרשים, ולעצב באופן שונה את גוף החץ ואת גודל הנקודות בכל תרשים. אם רוצים להשתמש באותו סגנון חץ לכל החיצים, צריך לציין את הנקודות על הגרף כערכים באותה סדרה. כדי להחיל סגנונות שונים על חיצים שונים, צריך לקבץ את כל החיצים עם אותו סגנון באותה סדרה.
יש לציין תרשים של Google-O-Meter עם התחביר הבא:
תחביר
cht=gom
דוגמאות
תיאור | דוגמה |
---|---|
כך אפשר להשתמש ב- |
|
ניתן לציין חיצים מרובים עם נקודות נתונים מרובות. | chd=t:20,40,60 |
כדי להחיל סגנון על חיצים, צריך להשתמש בפרמטר ל- נבחן את הערך של
|
chd=t:20,40|60 |
צבעי הסדרה chco
אפשר לציין את צבעי החוגה באמצעות הפרמטר chco
.
אם לא מציינים שום אפשרות, המערכת משתמשת בהדרגתיות הדרגתית כברירת מחדל.
תחביר
chco=<color_1>,...,<color_n>
- <color>
- מציינים שני צבעים או יותר בפורמט הקסדצימלי של RRGGBB. הצבעים מיושמים בהדרגתיות משמאל לימין, כאשר הצבע הראשון משמאל לימין הוא האחרון מימין.
תיאור | דוגמה |
---|---|
בתרשים הזה מוצגת דרגה פשוטה, מלבן (FFFFFF) לשחור (000000) | chco=FFFFFF,000000 |
בתרשים הזה מוצגים כמה צבעים שהוקצו לחוגה. | chco=FF0000,FF8040,FFFF00, |
תוויות Google-o-Meter chl
אפשר לציין תווית מותאמת אישית שתוצג מעל החץ.
הערה לגבי ערכי מחרוזת: במחרוזות תוויות מותר להשתמש רק בתווים שמתאימים לכתובת URL. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
מקודד של כתובות URL נמצא כאן.
תחביר
chl=<label>
- <label>
- טקסט של התווית.
דוגמה
תיאור | דוגמה |
---|---|
הנה דוגמה של Google-o-Meter עם תווית. |
|
תכונות רגילות
שאר התכונות בדף הזה הן תכונות רגילות של תרשים.
צריך לציין צבעים באמצעות מחרוזת בת 6 תווים של ערכים הקסדצימליים, בתוספת שני ערכי שקיפות אופציונליים, בפורמט RRGGBB[AA]
.
לדוגמה:
FF0000
= אדום00FF00
= ירוק0000FF
= כחול000000
= שחורFFFFFF
= לבן
AA
הוא ערך שקיפות אופציונלי, שבו הערך 00
הוא שקיפות מלאה ו-FF
אטום לחלוטין. לדוגמה:
0000FFFF
= כחול מלא0000FF66
= כחול שקוף
כותרת התרשים 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
.
הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של 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>. אם מציינים את שניהם, צריך להפריד ביניהם באמצעות תו בר. אפשר להוסיף 's' לכל ערך אם רוצים לדלג על רשומות ריקות במקרא
chdl
במקרא. דוגמאות: 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>, <left_margin>, <left_margin>, <left_margin>
- גודל השוליים המינימלי מסביב לאזור התרשים, בפיקסלים. יש להגדיל את הערך כדי להוסיף מרווח פנימי מסוים כדי למנוע חפיפה בין תוויות הצירים לבין גבולות התרשים.
- <opt_legend_width>, <opt_legend_height>
- [אופציונלי] רוחב השוליים סביב המקרא, בפיקסלים. ניתן להשתמש באפשרות הזו כדי שהמקרא לא יקפוץ באזור התרשים או בקצוות התמונה.
דוגמאות
תיאור | דוגמה |
---|---|
בדוגמה הזו, בתרשים יש שוליים מינימליים של 30 פיקסלים בכל צד. המקרא של התרשים הוא ברוחב של יותר מ-30 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים. תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים. |
|
כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את |
|
סגנונות ותוויות של צירים [קו, בר, Google-o-Meter, מכ"ם, פיזור]
אפשר לציין אילו צירים להציג בתרשים ולהגדיר להם תוויות ומיקומים מותאמים אישית, טווחים וסגנונות.
לא בכל התרשימים מוצגים קווים של צירים כברירת מחדל. אפשר להשתמש בפרמטר chxt
כדי לציין בדיוק אילו צירים יוצגו בתרשים. בקווי ברירת המחדל של ציר
לא מופיעים מספרים. עליך לציין ציר בפרמטר chxt
כדי להציג מספרים.
אפשר לבחור אם להציג לצירים מספרים שמשקפים את ערכי הנתונים, או לציין צירים בהתאמה אישית.
ברירת המחדל היא להציג ערכים מספריים עם קנה מידה גדול מ-0 עד 100.
עם זאת, אפשר לשנות את הטווח הזה באמצעות הפונקציה chxr
כדי להציג כל טווח, וגם לעצב את הערכים (למשל, כדי להציג סמלי מטבע או ספרות אחרי הנקודה העשרונית) באמצעות chxs
.
אם בוחרים להשתמש בערכים
מותאמים אישית, כמו "יום שני, שלישי, רביעי", אפשר להשתמש בפרמטר chxl
.
כדי למקם את התוויות האלה במיקומים ספציפיים לאורך הציר, צריך להשתמש בפרמטר chxp
.
לבסוף, אפשר להשתמש בפרמטרים chxs
ו-chxtc
כדי לציין צבע, גודל, יישור ומאפיינים אחרים של תוויות ציר מותאם אישית וגם של תוויות ציר מספרי.
הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z
.
אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של Google החזותית.
בקטע הזה מופיעים הנושאים הבאים:
- צירים גלויים (
chxt
) - אילו צירים להציג. - טווח ציר (
chxr
) – טווח הערכים של כל ציר. - Custom Axis Labels (
chxl
) - ערכים מותאמים אישית שיוצגו בציר. - מיקומים של תוויות ציר (
chxp
) - מיקום של תוויות מותאמות אישית לאורך כל ציר. - סגנונות של תוויות ציר (
chxs
) - צבע, גודל, יישור ועיצוב של תוויות צירים. - סגנונות של סימני וי של ציר (
chxtc
) - משך הזמן של סימני שנתות בציר ספציפי.
צירים גלויים chxt
בתרשימי עמודות, קו, מכ"ם ופיזור ערכי ציר אחד או שניים כברירת מחדל, אבל הקווים האלה לא כוללים ערכים.
כדי להציג ערכים בקווי הצירים או כדי לשנות את הצירים שיוצגו, צריך להשתמש בפרמטר chxt
.
כברירת מחדל, הערכים של הציר נעים בין 0 ל-100, אלא אם משנים אותם באופן מפורש
באמצעות המאפיין chxr
. כדי להסתיר את כל קווי הצירים בתרשים קו, צריך לציין :nda
אחרי הערך של סוג התרשים בפרמטר cht
(לדוגמה: 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,noxty5x" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uXUc&chco=76A4FB&chls=2.0&ch1%xl |
בדוגמה הזו מוצג תרשים עמודות אופקי עם ציר ה-X, ציר ה-Y, ציר ה-Y וציר ה-R הימני. תוויות של צירים לא נכללות, ולכן Chart API מציג טווח של 0 עד 100 עבור ציר ה-X ועבור ציר ה-T. הטווח של ציר ה-Y ושל ציר ה-R נקבע לפי מספר העמודות. במקרה הזה יש חמש עמודות, ולכן Chart API מציג טווח של 0 עד 4. התווית הראשונה ממורכזת בבסיס של העמודה הראשונה, התווית השנייה ממורכזת בבסיס העמודה השנייה, וכן הלאה. |
|
אפשר להסתיר צירים שמוגדרים כברירת מחדל בתרשים קו על ידי ציון הערך :nda אחרי סוג התרשים. |
cht=lc:nda |
טווח ציר chxr
אפשר לציין את טווח הערכים שמופיעים בכל ציר בנפרד, באמצעות הפרמטר chxr. הערה: הפעולה הזו לא משנה את קנה המידה של רכיבי התרשים, אלא רק את קנה המידה של תוויות הצירים. אם רוצים שמספרי הצירים יתארו את ערכי הנתונים בפועל, צריך להגדיר את <start_val> ואת <end_val> לערכים התחתונים והעליון בטווח של פורמט הנתונים, בהתאמה. למידע נוסף, אפשר לעיין במאמר שינוי קנה מידה של צירים.
צריך להפוך ציר לגלוי באמצעות הפרמטר chxt
אם רוצים לציין את הטווח שלו.
כדי לציין ערכים של ציר מותאם אישית, משתמשים בפרמטר chxl
.
תחביר
יש להפריד בין טווחי תוויות של צירים מרובים באמצעות תו בקו אנכי ( |
).
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <x_index>
- על איזה ציר יש להחיל את התוויות. זהו אינדקס מבוסס-אפס למערך הציר שצוין על ידי
chxt
. לדוגמה, ציר ה-R יהיה 1 ב-chxt=x,r,y
. - <start_val>
- מספר, שמגדיר את הערך הנמוך של הציר הזה.
- <end_val>
- מספר, שמגדיר את הערך הגבוה של הציר הזה.
- <opt_step>
- [אופציונלי] שלב הספירה בין סימני שנתות בציר. אין ערך ברירת מחדל לשלב. מחושב השלב הזה כדי לנסות להציג קבוצה של תוויות עם רווח נעים.
דוגמאות
תיאור | דוגמה |
---|---|
בדוגמה הזו מוצגים ציר Y ימני ושמאלי ( לכל ציר יש טווח מוגדר. מאחר שלא צוינו תוויות או מיקומים, הערכים נלקחים מהטווח הנתון ומרווחים באופן שווה בתוך הטווח הזה. בתרשים הקו, הערכים מחולקים באופן שווה לאורך ציר ה-X. הכיוון של הציר הפוך בציר ה-R (אינדקס |
|
בדוגמה הזו, הערכים מצוינים עבור ציר ה-x. תוויות של צירים מפוזרות באופן שווה לאורך הציר. צוין ערך של 5 ( |
|
תוויות ציר מותאמות אישית chxl
אפשר לציין תוויות של צירים בהתאמה אישית בכל ציר באמצעות הפרמטר chxl
. אפשר לציין כמה תוויות שרוצים. אם תציג ציר (באמצעות הפרמטר chxt
) ולא תציינו תוויות מותאמות אישית, התוויות המספריות הרגילות יחולו.
כדי לציין טווח מספרי בהתאמה אישית, יש להשתמש במקום זאת בפרמטר chxr
.
כדי להגדיר מיקומים ספציפיים לאורך הציר של התוויות, משתמשים בפרמטר chxp
.
תחביר
צריך לציין קבוצת פרמטר אחת לכל ציר
שרוצים להוסיף לו תווית. יש להפריד בין כמה קבוצות של תוויות באמצעות קו אנכי ( |
).
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <x_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 ( |
|
בדוגמה הזו מופיעות תוויות של צירים בציר ה-x השמאלי ובציר הימני ( בדוגמה הזו נעשה שימוש בערכי ברירת המחדל של התוויות של הצירים בציר ה-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>
- <x_index>
- הציר שבו מציינים מיקומים. זהו אינדקס למערך הפרמטרים
chxt
. לדוגמה, אם יש לךchxt=x,x,y,y
, אינדקס 0 יהיה ציר ה-X הראשון, 1 יהיה ציר ה-X השני, וכן הלאה. - <label_1_position>,...,<label_n_position>
- המיקום של התווית לאורך הציר. זוהי רשימה של ערכים מספריים שמופרדים בפסיקים, שבה כל ערך מגדיר את מיקום התווית המתאימה במערך
chxl
: הרשומה הראשונה חלה על התווית הראשונה וכן הלאה. המיקום הוא ערך ב-range של הציר הזה. לתשומת ליבך, הערך תמיד יהיה 0-100, אלא אם ציינת טווח מותאם אישית באמצעותchxr
. מספר המיקומים חייב לכלול תוויות לציר הזה.
דוגמאות
תיאור | דוגמה |
---|---|
בדוגמה הזו מופיעות תוויות של ציר ה-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_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
- הצגת אפסים בסוף. ברירת המחדל היא לא.s
- הצגה של מפרידי קבוצות. ברירת המחדל היא לא.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>
- [אופציונלי; לא נתמך ב-Google-o-meter] הצבע של סימן הביקורת, בפורמט הקסדצימלי של RRGGBB. ברירת המחדל היא אפורה.
- <opt_axis_color>
- [אופציונלי] הצבע של קו הציר הזה, בפורמט הקסדצימלי של RRGGBB. ברירת המחדל היא אפורה.
דוגמאות
תיאור | דוגמה |
---|---|
הגודל והצבע של הגופן מצוינים בציר ה-X השני (ינואר, פברואר, מרץ). |
|
גודל הגופן, הצבע והיישור מצוינים עבור ציר ה-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_index>
- הציר שעליו חל הציר הזה. זהו אינדקס מבוסס-אפס לפרמטר
chxt
. יש להפריד בין ערכים לצירים שונים באמצעות מפריד עמודות. - <tick_length_1>,...,<tick_length_n>
- האורך של סימני הביקורת בציר הזה, בפיקסלים. אם תספקו ערך יחיד, הוא יחול על כל הערכים. אם תזינו יותר מערך אחד, סימני הסימון בציר יעברו דרך רשימת הערכים של הציר. ערכים חיוביים משורטטים מחוץ לאזור התרשים ונחתכים על ידי גבולות התרשים. הערך החיובי המקסימלי הוא 25. ערכים שליליים משורטטים בתוך אזור התרשים ונחתכים על ידי גבולות האזור של התרשים.
דוגמאות
תיאור | דוגמה |
---|---|
דוגמה לשימוש ב-
|
|
בתרשים הזה מוצגים אורכים מתחלפים של שנתות. chxtc מציין שני ערכים של אורך שנתות בציר ה-Y (5 ו-15), וסימני שנתקים שמסומנים בתרשים מתחלפים בין שני הערכים. |
chxt=x,y |
סגנונות קו 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 |
מילוי ברקע chf
[כל
התרשימים]
אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה.
אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים
יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf
,
וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים,
על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.
מילוי מלא chf
[כל
התרשימים]
אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות
ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|
). (מפות: רקע בלבד).
תחביר
chf=<fill_type>,s,<color>|...
- <fill_type>
- החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.a
- הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של<color>
, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.b<index>
- מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערךchco
בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.
- שנ'
- מציין מילוי מלא או שקיפות.
- <color>
- צבע המילוי, בפורמט הקסדצימלי של RRGGBB. במקרה של שקפים, המערכת מתעלמת משש הספרות הראשונות, אבל בכל זאת צריך לכלול אותן.
דוגמאות
תיאור | דוגמה |
---|---|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר ( |
|
בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים. |
|
מילוי הדרגתי chf
[Line,
Bar, Google-o-meter, רדאר, פיזור,וון]
ניתן להחיל מילוי אחד או יותר של צבעים הדרגתיים על אזורים או רקעים בתרשים. מילויים הדרגתיים משתנים בהדרגה מצבע אחד לצבע אחר. (עוגה, תרשימי Google-o-Meter: רקע בלבד).
כל מילוי הדרגתי מציין זווית, ולאחר מכן שני צבעים או יותר שמוצמדים למיקום שצוין. הצבע משתנה ברגע שהוא עובר מעוגן אחד לאחר. חייבים להיות לפחות שני צבעים עם ערכים שונים של <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
- מציין מילוי הדרגתי.
- <angle>
- מספר שמציין את הזווית של ההדרגתיות מ-0 (אופקי) עד 90 (אנכי).
- <color>
- צבע המילוי, בפורמט הקסדצימלי של RRGGBB.
- <color_centerpoint>
- קביעת נקודת העוגן של הצבע. הצבע יתחיל להתעמעם מהנקודה הזו כשהוא יתקרב לעוגן אחר. טווח הערכים הוא בין 0.0 (קצה תחתון או שמאלי) ל-1.0 (קצה עליון או ימני), בהטיה בזווית שצוינה באמצעות <angle>.
דוגמאות
תיאור | דוגמה |
---|---|
באזור התרשים יש שיפוע לינארי אופקי, שצוין בזווית של אפס מעלות ( הצבעים הם אפרסק ( רקע התרשים משורטט בצבע אפור ( |
|
באזור התרשים יש שיפוע לינארי באלכסון (משמאל למעלה מימין)
לינארי, שמצוין בזווית של ארבעים וחמש מעלות ( אפרסק ( כחול ( רקע התרשים משורטט בצבע אפור ( |
|
באזור התרשים יש שיפוע לינארי אנכי (מלמעלה למטה)
שצוין בזווית של תשעים מעלות ( כחול ( אפרסק ( רקע התרשים משורטט בצבע אפור ( |
|
מילויים מפסים chf
[קו,
בר, Google-o-meter, מכ"ם, פיזור, Venn]
אפשר לבחור מילוי של רקע מפוספס לאזור התרשים, או לכל התרשים. (עוגה, תרשימי Google-o-Meter: רקע בלבד.)
תחביר
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>
- אזור התרשים שיש למלא. אחד מהפרטים הבאים:
bg
- מילוי רקעc
– מילוי אזור התרשיםb<index>
– מילויים בפסים (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בפסים. אפשר לעיין בדוגמאות, בקטע צבעי סדרה של תרשים עמודות.
- ls
- קביעת מילוי של פס לינארי.
- <angle>
- הזווית של כל הפסים, ביחס לציר ה-Y. צריך להשתמש במאפיין
0
לפסים אנכיים או במאפיין90
לפסים אופקיים. - <color>
- הצבע של הפס הזה, בפורמט הקסדצימלי של RRGGBB. חוזרים על <color> ועל <width> לכל פס נוסף. צריך שיהיו לך שני פסים לפחות. הפסים מתחלפים עד שהתרשים מתמלא.
- <width>
- רוחב הפס הזה, מ-
0
עד1
, כאשר1
הוא לכל רוחב התרשים. הפסים חוזרים על עצמם עד שהתרשים מתמלא. חוזרים על התגים <color> ו-<width> לכל פס נוסף. צריך שיהיו לך שני פסים לפחות. הפסים מתחלפים עד שהתרשים מתמלא.
דוגמאות
תיאור | דוגמה |
---|---|
|
chf= |
|
chf= |