תרשימי עוגה

   

במאמר הזה נסביר איך ליצור תרשימי עוגה באמצעות ממשק ה-API של Chart.

תוכן העניינים

תכונות שספציפיות לתרשים סקירה כללית סוגי תרשימים (cht) צבעי הסדרה (chco) Pie Chart Labels (chl) סבב של תרשים עוגה (chp)

תכונות רגילות כותרת התרשים (chtt, chts) טקסט וסגנון של מקרא התרשים (chdl, chdlp, chdls) שולי התרשים (chma) מילוי רקע (chf) Solid Fills (chf) Gradient Fills (chf) Striped Fills (chf) פונקציות נתונים (chfd)

סקירה כללית

תרשימי עוגה מתאימים להצגת מידע פרופורציונלי פשוט מתחילתו ועד סופו. אפשר ליצור תרשים עוגה של סדרה אחת, שבו כל סדרה מורכבת מכמה פרוסות, או מתרשימים קוצנטריים שכוללים כמה סדרות.

כל סדרה מתארת עוגה אחת, וכל ערך נתונים מציין פרוסה אחת. כשמשתמשים בתרשימי עוגה מקננים (מתוארים בהמשך), מומלץ להשתמש במספר סדרות.

כדי להציג את הטקסט שמשויך לפרוסה מסוימת, צריך להשתמש בתוויות של תרשים עוגה או במקרא של תרשים. תוויות של תרשים עוגה הן טקסט מסביב לתרשים עם קווים שמצביעים לכיוון הפרוסה. מקרא הוא טקסט שמשויך לצבע.

Labels (תוויות)	מקרא	תוויות ומקרא
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

הערכים מוצגים ביחס לזה: כך שתרשים עם הערכים 1,2,3 ייראה זהה לתרשים עם הערכים 100,200,300. עם זאת, כשמשתמשים בנתונים של פורמט טקסט, ערכים גדולים מ-100 חתוכים ל-100, לכן צריך להשתמש בפורמט טקסט עם שינוי קנה מידה בהתאמה אישית כדי להציג חלקים שגדולים מ-100 (צריך להשתמש בפרמטר chds עם ערכי מינימום/מקסימום של chds=0,<max-slice-size>).

ערכים שליליים מוצגים כפרוסות ריקות בגודל המתאים.

סוגי תרשימים

יש שלושה סוגים כלליים של תרשימי עוגה שאפשר ליצור: שטוח, קוצנטרי או תלת-ממד. מציינים תרשים עוגה עם התחביר הבא:

תחביר

cht=<chart_type>

כאשר <chart_type> הוא אחד מהסוגים הבאים:

פרמטר	תיאור	דוגמה
p	תרשים עוגה דו-מימדי. עליכם לספק סדרת נתונים אחת בלבד, ותתעלם מסדרות הנתונים הבאות. כברירת מחדל, צבעי פלחי העוגה עוברים אינטרפולציה מכתום כהה לצהוב בהיר. מציינים צבעים אחרים כפי שמתואר בצבעי הסדרה. יש לציין תוויות עם chl כפי שמתואר בתוויות של תרשים עוגה. Google Chart API מחשב את רדיוס העיגול מתוך הרוחב והגובה המינימליים שצוינו בפרמטר של גודל התרשים (chs). כשכוללים תוויות, כנראה צריך לציין את גודל הרוחב כך שיהיה גדול פי שניים מהגובה, כדי להבטיח שהתוויות יהיו גלויות במלואן.	cht=p chs=200x100
p3	תרשים עוגה תלת-ממדי. מציינים את הנתונים והעיצוב באותו אופן כמו שמתואר למעלה בתרשימי עוגה דו-ממדיים. אם כוללים תוויות בתרשים עוגה תלת-מימדי, כנראה צריך להגדיר רוחב פי 2.5 מהגובה, כדי להבטיח שהתוויות יהיו גלויות במלואן.	cht=p3 chs=250x100
pc	תרשים עוגה קוצנטרי. צריך לספק שתי סדרות נתונים או יותר.	cht=pc chd=s:Helo,Wrld
כל הסוגים	מספרים שליליים בנתונים גורמים לפלחים "ריקים".	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

צבעי הסדרה chco

אפשר לציין את הצבעים של כל הערכים, של כל ערך או של ערכים מסוימים באמצעות הפרמטר chco.

תחביר

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

<color>

פריסה של צבעים בפורמט הקסדצימלי של RRGGBB. מציינים צבע סדרה אחד, וכל החלקים בסדרה הזו ייצבעו בהדרגה של הצבע הזה, מהכהה ביותר (חבר הנתונים הראשון) ועד לבהיר ביותר (חבר הנתונים האחרון). יש לציין שני צבעים או יותר שמופרדים באמצעות הסימן | כדי לתאר את צבעי הפלחים. כשיש כמה סדרות (כלומר, תרשים עם טבעות קוצנטריות), אפשר לציין ערכים לסדרות שונות על ידי הפרדת הערכים באמצעות פסיק. אם מוצגים פחות צבעים של פרוסות או סדרות מאשר קטעים או סדרות מוצגים, התרשים עובר מתחילת רשימת הפלחים של הסדרה או מרשימת הסדרות של התרשים. לא ניתן לציין הדרגה נפרדת לכל סדרה בתרשים מרובה סדרות.

תיאור	דוגמה
יש לציין צבע אחד כדי שיהיו הדרגתיים – מהכהה (פרוסה ראשונה) לבהירה ביותר (פרוסה אחרונה).	chco=0000FF
הגדרת הדרגה; כאן, מצהוב לאדום.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
הגדרה של צבעי פרוסה נפרדים. יש לציין צבע אחד לכל פרוסה.	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
בתרשים הזה יש שתי סדרות נתונים, אבל הוא מציין את הצבע בתור הדרגתי יחיד בכל המקטעים, מצהוב לאדום (BBBB00—BB0000).	chco=BBBB00,BB0000
לפניכם תרשים קוצנטרי שכולל גם צבעי סדרה וגם צבעי פרוסות בודדים. בתרשים יש שתי סדרות נתונים קוצנטריות. הצבעים הם chco=green|red,blue|צהוב. הפסיק מפצל את קטע הקוד לשתי סדרות: ירוק|אדום - ירוק מתחלף ופרוסות אדומות. כחול|צהוב - פרוסות כחולות וצהובות.	chd=s:eYY,ORVM chco=008800|880000,000088|888800

חזרה למעלה

תוויות לתרשים עוגה chl

אפשר לציין תוויות לפרוסות נפרדות של תרשים עוגה באמצעות הפרמטר chl. אפשר גם להציג מקרא עם ערכים זהים או שונים, רשומת מקרא אחת לכל פרוסה.

הערה לגבי ערכי מחרוזת: במחרוזות תוויות מותר להשתמש רק בתווים שמתאימים לכתובת URL. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z. מקודד של כתובות URL נמצא כאן.

תחביר

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

<label_value>

ערך מחרוזת שיש להחיל על פלח. התוויות מוחלות ברצף על הנקודות על הגרף ב-chd. אם יש לכם כמה סדרות (לדוגמה, בתרשים עוגה קוצנטרי), התוויות מוחלות על כל הנקודות בכל הרצפים, לפי הסדר שצוין ב-chd. צריך להשתמש בתו מפריד ( | ) בין כל תווית. צריך לציין ערך ביניים חסר על ידי שימוש בשני תווי קו אנכי רצופים ללא רווח: || . אין צורך להוסיף תוויות לכל הפרוסות.

 

דוגמאות

תיאור	דוגמה
תוויות לתרשים עוגה תלת-ממדי.	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
כשמציינים את גודל התרשים באמצעות chs, חשוב להביא בחשבון את השטח הדרוש לתוויות. באופן כללי, תרשים עוגה דו-ממדי צריך להיות ברוחב כפול (כ-2) מהגובה שלו, ותרשים עוגה תלת-ממדי צריך להיות רחב בערך פי שניים וחצי מהגבוה כדי להציג את התוויות בצורה נכונה. בדוגמה הראשונה, התוויות מוצגות באופן חלקי בלבד, מפני שהתרשים לא רחב מספיק. הדוגמה השנייה מראה שהתרשים צריך להיות ברוחב 280 פיקסלים כדי להציג את התוויות במלואן. (גבולות נוספו במפורש לרכיב <img>.)	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

חזרה למעלה

סבב של תרשים עוגה chp

כברירת מחדל, הסדרה הראשונה משרטטת החל משעה 3:00 ונמשכת בכיוון השעון סביב התרשים, אבל אפשר לציין סיבוב מותאם אישית באמצעות הפרמטר chp.

תחביר

chp=<radians>
  

<radians>

ערך נקודה צפה שמתארת כמה רדיאנים צריך לסובב את התרשים בכיוון השעון. פנייה אחת שלמה היא 2π (2 פאי - כ-6.28) רדיאנים.

דוגמאות

תיאור	דוגמה
כדי לשנות את הכיוון של תרשים עוגה צריך להשתמש בפונקציה chp=<angle_in_radians>	chd=t:20,80 chd=t:80,20 chp=0.628
הנה דוגמה נוספת לסיבובים בתרשים עוגה. אפשר לשלב את האפקטים האלה עם סמני צורה בתרשים כדי ליצור אפקטים מעניינים.

 

חזרה למעלה

תכונות רגילות

שאר התכונות בדף הזה הן תכונות רגילות של תרשים.

כותרת התרשים 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".

 

דוגמאות

תיאור	דוגמה
תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל. צריך לציין רווח עם סימן חיבור (+). כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (|). chts לא צוין כאן.	chtt=Site+visitors+by+month| January+to+July
תרשים עם כותרת כחולה ביישור לימין של 20 נקודות.	chtt=Site+visitors chts=FF0000,20,r

חזרה למעלה

טקסט וסגנון של מקרא התרשים 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 chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
בתרשים הראשון מוצגים פריטים מהמקרא האופקי (chdlp=t, פריסת ברירת המחדל היא אופקית), והתרשים השני כולל רשומות מקרא אנכיות תחתונות (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
בדוגמה הזו אפשר לראות את שינוי גודל הגופן.	chdls=0000CC,14

חזרה למעלה

שולי התרשים chma [כל התרשימים]

אפשר לציין את גודל השוליים של התרשים, בפיקסלים. השוליים מחושבים פנימה מהגודל שצוין בתרשים (chs). הגדלה של השוליים לא מגדילה את הגודל הכולל של התרשים, אלא רק מכווצת את שטח התרשים, במקרה הצורך.

כברירת מחדל, השוליים הם כל מה שנותר אחרי חישוב גודל התרשים. ערך ברירת המחדל משתנה לפי סוג התרשים. השוליים שציינתם הם ערך מינימלי. אם אזור התרשים מותיר מקום לשוליים, גודל השוליים יהיה כל מה שנשאר. לא ניתן לכווץ את השוליים שקטנים ממה שנדרש למקרא ולתוויות. זהו תרשים שמציג את החלקים הבסיסיים של התרשים:

שולי התרשים כוללים את תוויות הצירים ואת אזור המקרא. גודל האזור של המקרא משתנה באופן אוטומטי כך שיתאים בדיוק לטקסט, אלא אם מציינים רוחב גדול יותר באמצעות chma. במקרה כזה הוא מרחיבים את השוליים ומכווצים את שטח התרשים. לא ניתן לחתוך מקרא על ידי ציון גודל קטן מדי, אבל אפשר לתפוס יותר מקום מהנדרש. טיפ: בתרשים עמודות, אם לעמודות יש גודל קבוע (ברירת המחדל), לא ניתן להקטין את רוחב האזור בתרשים. צריך לציין פס קטן יותר או עמודה שניתן לשנות את הגודל שלה באמצעות chbh.

 

תחביר

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 פיקסלים, ולכן השוליים שבצד שמאל מוגדרים לרוחב של מקרא התרשים, והם שונים מהשוליים האחרים. תוויות הצירים נמצאות מחוץ לאזור התרשים, ולכן הן משורטטות בתוך שטח השוליים.	chma=30,30,30,30
כדי להוסיף שוליים סביב המקרא, מגדירים ערך לפרמטרים <opt_legend_width> ו-<opt_legend_height>. בדוגמה הזו, המקרא הוא ברוחב של כ-60 פיקסלים. אם תגדירו את <opt_legend_width> ל-80 פיקסלים, השוליים יורחבו ל-20 פיקסלים מחוץ למקרא.	chma=20,20,20,30|80,20

חזרה למעלה

סגנונות ותוויות של צירים [קו, בר, 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 לכל הצירים. חשוב לשים לב שכברירת מחדל, בציר העליון ובציר התחתון לא מוצגים סימני וי לפי התוויות.	chxt=x,y,r,t
אפשר לכלול כמה קבוצות של תוויות עבור כל ציר על ידי הכללת ערך זהה יותר מפעם אחת. בדוגמה הזו מוצגות שתי קבוצות של צירי 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. התווית הראשונה ממורכזת בבסיס של העמודה הראשונה, התווית השנייה ממורכזת בבסיס העמודה השנייה, וכן הלאה.	chxt=x,y,r,t
אפשר להסתיר צירים שמוגדרים כברירת מחדל בתרשים קו על ידי ציון הערך :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 ימני ושמאלי (y ו-r) וציר X אחד (x). לכל ציר יש טווח מוגדר. מאחר שלא צוינו תוויות או מיקומים, הערכים נלקחים מהטווח הנתון ומרווחים באופן שווה בתוך הטווח הזה. בתרשים הקו, הערכים מחולקים באופן שווה לאורך ציר ה-X. הכיוון של הציר הפוך בציר ה-R (אינדקס 2), כי הערך הראשון (1000) גדול מהערך האחרון (0).	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
בדוגמה הזו, הערכים מצוינים עבור ציר ה-x. תוויות של צירים מפוזרות באופן שווה לאורך הציר. צוין ערך של 5 (5) בפרמטר <opt_step>.	chxt=x chxr=0,10,50,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.

 

דוגמאות

תיאור	דוגמה
בתרשים הזה מוסבר איך להוסיף תוויות מותאמות אישית לשני צירים. שימו לב איך הערכים מתחלקים באופן שווה, ואיך הערך האחרון של chxl לא מסתיים בקו ניצב.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
בדוגמה הזו מופיעות תוויות צירים בציר ה-Y ובציר ה-Y (y ו-r). כמו כן, היא כוללת שתי קבוצות של ערכים לציר ה-X (x). מומלץ להוסיף סימני שנתות בציר ה-Y באמצעות 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
בדוגמה הזו מופיעות תוויות של צירים בציר ה-x השמאלי ובציר הימני (y ו-r). היא כוללת גם שתי קבוצות של ערכים לציר ה-X (x). חשוב לשים לב לתוויות הריקות של ציר ה-X של ציר ה-X, שמשמש לרווח בין הערכים. בדוגמה הזו נעשה שימוש בערכי ברירת המחדל של התוויות של הצירים בציר ה-Y השמאלי.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
אם רוצים להוסיף תווית כללית לתיאור ציר שלם (לדוגמה, כדי להוסיף תווית לציר אחד כ'עלות' ולציר אחר כ'סטודנט'), אפשר להשתמש במאפיין chxt כדי להוסיף ציר נוסף מכל צד, ואז להשתמש ב-chxl כדי להוסיף תווית מותאמת אישית אחת בכל צד וב-chxp כדי להוסיף אותה באמצע הציר.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

חזרה למעלה

מיקומי תוויות הצירים 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 במיקומים מסוימים בתרשים. טקסט התווית מצוין באמצעות הפרמטר chxl. תוויות שהמיקום שצוין להן הוא 0 ממוקמות בחלק התחתון של ציר ה-Y או ציר ה-R, או בצד שמאל של ציר ה-X או ה-T. תוויות שהמיקום שצוין להן הוא 100 ממוקמות בחלק העליון של ציר ה-Y או ציר ה-R, או מימין לציר ה-X או לציר ה-T.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
בדוגמה הזו מוצגים ערכי ברירת המחדל של תוויות, אבל רק במיקומים שצוינו. chxp=1,10,35,75 - ציר ה-Y צריך להציג רק שלוש תוויות: 10, 35 ו-75. מאחר שלא צוין טקסט של תווית מותאמת אישית, ערכי הצירים האלה מוצגים. חשוב לשים לב שאין צורך להפריד בין תוויות הרווח באופן שווה כשמשתמשים ב-chxp. אם לא צוין כאן chxp, מרחק הערך של התווית כברירת מחדל בציר ה-Y יהיה כל 20 יחידות, כפי שמוצג בתרשים השני.	chxt=x,y chxp=1,10,35,75 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 השני (ינואר, פברואר, מרץ).	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
גודל הגופן, הצבע והיישור מצוינים עבור ציר ה-Y הימני. משורטטים סימני וי, אך ללא קו ציר.	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
התרשים הזה כולל שלוש קבוצות נתונים ומציג שלוש קבוצות של תוויות צירים, אחת לכל סדרה. כל קבוצת תוויות מעוצבת באמצעות מחרוזת עיצוב מותאמת אישית, כפי שמתואר כאן: 0N*e,000000| 0 פירושו סדרת הנתונים הראשונה הערך N הוא מחרוזת עיצוב הערך * פירושו ההתחלה של מציין הפורמט e פירושו סימון מדעי המשמעות של * היא הסיום של תוחמי הפורמט 000000 פירושו טקסט שחור. 1N*cUSD*Mil,FF0000| 1 הוא הסדרה השנייה הערך N הוא מחרוזת עיצוב הערך * פירושו ההתחלה של מציין הפורמט c פירושו סמן מטבע USD מציין דולר ארה"ב כסמן המטבע לשימוש * פירושו הסוף של המאפיינים המציינים את הפורמט Mil הוא המחרוזת ליטרלית הבאה FF0000 הוא טקסט אדום. 2N*sz2*,0000FF 2 פירושו הסדרה השלישית הערך N הוא מחרוזת עיצוב הערך * פירושו ההתחלה של מציין הפורמט המשמעות של s היא להציג מציין קיבוץ (בלוקאל אנגלית של ארה"ב, יש להשתמש בפסיק כל שלושה אפסים) z2 פירושו להציג שני אפסים בסוף 0000FF זה טקסט כחול. הטווחים של תוויות הציר מוגדרים באמצעות הפרמטר chxr (axis_index, axis_index, axis_index, axis_index). אם היא לא מוגדרת, הערכים צריכים להיות 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

חזרה למעלה

סגנונות של סימון ציר 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 כדי ליצור סימונים אדומים ארוכים. האורך של סימן הווי שמופיע כאן חורג מרוחב האזור בתרשים, אבל הוא נחתך כדי להתאים לתרשים. chxt=x,y,r,x - הצגת ציר שמאלי, ציר ימני ושני צירים תחתונים. chxl=2:|min|average|max|3:|Jan|Feb|Mar - טקסט התווית שהוקצה ל-'r' (צד ימין) ולציר ה-X החיצוני. chxp=2,10,35,95 - מיקומים של תוויות מותאמות אישית לאורך ציר ה-R (index=2) בשלוש התוויות. chxs=2,0000dd,13,-1,t,FF0000 - סגנונות של תוויות ציר עבור ציר ה-R: צבע הטקסט, גודל הטקסט, יישור לשמאל, עם סימני וי אדומים. chxtc=1,10|2,-180 - אורכי הציר של ציר Y וציר ה-R. הערך הראשון מציין סימונים באורך 10 פיקסלים, מחוץ לציר. הערך השני מציין סימונים באורך של 180 פיקסלים בתוך הציר. המספר השלילי פירושו שהסימון נכנס לתוך הציר והסימון נחתך כך שיתאים לתרשים.	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
בתרשים הזה מוצגים אורכים מתחלפים של שנתות. chxtc מציין שני ערכים של אורך שנתות בציר ה-Y (5 ו-15), וסימני שנתקים שמסומנים בתרשים מתחלפים בין שני הערכים.	chxt=x,y chxtc=   1,5,15

חזרה למעלה

מילוי ברקע chf [כל התרשימים]

אפשר לציין צבעים וסגנונות מילוי לאזור הנתונים של התרשים ו/או לכל הרקע של התרשים. סוגי המילוי כוללים מילויים מלאים, מילויים מפוספסים והדרגה. אפשר לציין מילויים שונים לאזורים שונים (לדוגמה, לכל אזור התרשים או רק לאזור הנתונים). מילוי השטח של התרשים יחליף את המילוי ברקע. כל המילויים מצוינים באמצעות הפרמטר chf, וניתן לשלב סוגי מילוי שונים (מלאים, פסים, צבעים הדרגתיים) באותו תרשים, על ידי הפרדה בין ערכים באמצעות קו אנכי ( | ). מילוי אזור התרשים מחליף את מילויי הרקע של התרשים.

מילוי מלא chf [כל התרשימים]

אפשר לציין מילוי מלא לרקע ו/או לאזור התרשים, או להקצות ערך שקיפות לכל התרשים. אפשר לציין מספר מילויים באמצעות התו בצינורות (|). (מפות: רקע בלבד).

תחביר

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

<fill_type>

החלק בתרשים שממלא. אפשר לציין את אחד מהערכים הבאים:

• bg - מילוי רקע
• c – מילוי אזור התרשים. האפשרות הזו לא נתמכת בתרשימי מפה.
• a - הגדרת כל התרשים (כולל רקעים) שקופים. המערכת מתעלמת משש הספרות הראשונות של <color>, ורק שתי הספרות האחרונות (ערך השקיפות) חלות על התרשים כולו ועל כל המילוי.
• b<index> - מילויים מלאים בעמודות (בתרשימי עמודות בלבד). מחליפים את <index> באינדקס הסדרה של העמודות שיתמלאו בצבע אחיד. האפקט דומה לציון הערך chco בתרשים עמודות. מידע נוסף מופיע בקטע צבעי סדרת העמודות.

שנ'

מציין מילוי מלא או שקיפות.

<color>

צבע המילוי, בפורמט הקסדצימלי של RRGGBB. במקרה של שקפים, המערכת מתעלמת משש הספרות הראשונות, אבל בכל זאת צריך לכלול אותן.

 

דוגמאות

תיאור	דוגמה
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF).	chf=bg,s,EFEFEF
הדוגמה הזו ממלאת את רקע התרשים בצבע אפור בהיר (EFEFEF) וממלאת את אזור התרשים בשחור (000000).	chf=c,s,000000| bg,s,EFEFEF
בדוגמה הזו ניתן להחיל שקיפות של 50% על כל התרשים (80 בהקסדצימליים הם 128, או כ-50% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים.	chf=a,s,00000080

חזרה למעלה

מילוי הדרגתי 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>.

 

דוגמאות

תיאור	דוגמה
באזור התרשים יש שיפוע לינארי אופקי, שצוין בזווית של אפס מעלות (0). הצבעים הם אפרסק (FFE7C6), ממורכזים בצד שמאל (מיקום 0.0) וכחול (76A4FB) במרכז בצד ימין (במיקום 1.0). רקע התרשים משורטט בצבע אפור (EFEFEF).	chf=   c,lg,0,   FFE7C6,0,(אפרסק)   76A4FB,1 (כחול)
באזור התרשים יש שיפוע לינארי באלכסון (משמאל למעלה מימין) לינארי, שמצוין בזווית של ארבעים וחמש מעלות (45). אפרסק (FFE7C6) הוא הצבע הראשון שצוין. החלק השמאלי התחתון של התרשים הוא אפרסק טהור. כחול (6A4FB) הוא הצבע השני שצוין. החלק השמאלי העליון של התרשים הוא כחול טהור. שימו לב איך אנחנו מציינים קיזוז של 0.75 כדי לספק שיא של כחול שמתעמעם לקראת הפינה הימנית העליונה. רקע התרשים משורטט בצבע אפור (EFEFEF).	chf=   c,lg,45,   FFE7C6,0, (אפרסק)   76A4FB,0.75 (כחול)
באזור התרשים יש שיפוע לינארי אנכי (מלמעלה למטה) שצוין בזווית של תשעים מעלות (90). כחול (76A4FB) הוא הצבע הראשון שצוין. החלק העליון של התרשים הוא כחול טהור. אפרסק (FFE7C6) הוא הצבע השני שצוין. החלק התחתון של התרשים הוא אפרסק טהור. רקע התרשים משורטט בצבע אפור (EFEFEF).	chf=   c,lg,90,   FFE7C6,0, (אפרסק)   76A4FB,0.5 (כחול)

חזרה למעלה

 

מילויים מפסים 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> לכל פס נוסף. צריך שיהיו לך שני פסים לפחות. הפסים מתחלפים עד שהתרשים מתמלא.

 

דוגמאות

תיאור	דוגמה
bg,ls,0 - מילוי של פסים ברקע בפסים בזווית של אפס מעלות ביחס לציר ה-Y (במקביל לציר ה-Y). הפסים ממלאים את הרקע של התרשים וגם את שטח החלקה. CCCCCC,0.15 - הפס הראשון הוא אפור כהה, רוחב של 15% כמו התרשים. FFFFFF,0.1 - הפס השני הוא לבן, ורוחבו 10% כמו התרשים.	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90 - שטח תרשים עם פסים אופקיים בזווית של תשעים מעלות מציר ה-Y. הפסים ממלאים את שטח התרשים, אבל הרקע של התרשים אינו מוצג. 999999,0.25 - הפס הראשון הוא אפור כהה, רוחב של 25% כמו התרשים. CCCCCC,0.25 - זהה לפס הראשון, אבל אפור בהיר יותר. FFFFFF,0.25 – זהה לפס הראשון, אבל לבן.	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

חזרה למעלה

פונקציות נתונים 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_string>

הפונקציה, כתובה בתחביר muParser. הפונקציה חלה על המשתנים ועל הנתונים שצוינו ב-variable_data. אפשר להפנות רק למשתנים שהוצהרו בקבוצת הפונקציות המקומית הזו, ולא בקבוצה אחרת בעלת צינורות של chfd. אין תמיכה בפונקציות muParser של סיכום (מינימום, סכום מקסימלי, ממוצע). חשוב: חשוב להשתמש בפונקציות %2B במקום ב-+.

 

דוגמאות

תיאור	דוגמה
גל סינוס פשוט. דברים שצריך לשים לב אליהם: chd=t:-1 - אנחנו משתמשים במשתנה דמה עבור נתוני התרשים, כי הנתונים שלנו מוצהרים בפרמטר chfd. chco=FF0000 – צוין אדום לסדרה הראשונה. למרות שלא נעשה שימוש בנתונים מתוך chd, הצבע התואם לסדרה הזו ישמש לפונקציה שמופיעה בתרשים. chfd=0,x,0,11,0.1,sin(x)*50%2B50 - אנחנו מצהירים על משתנה אחד, שנקרא x, עם הערכים 0-11, שמגדילים ב-0.1. הוא מוקצי לסדרה הראשונה, כלומר הוא יקבל את הצבע של הסדרה הראשונה (FF0000). הפונקציה חלה על x היא sin(x) * 50 + 50. שימו לב איך אנחנו צריכים לקודד את הסימן + בפונקציה הזו.	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
בשורה הזו נעשה שימוש בנתונים מהפרמטר chd.	chd=t:5,10 chfd=0,x,0,x*4
שילוב של קווי פונקציה וקווים שאינם פונקציות. שימו לב איך הצבעים מצוינים באמצעות פרמטר הצבע של הסדרה chco. שימו לב למיקום של הסמנים בפלט של הפונקציה. הנקודות על הנתונים מחושבות מהתאריכים start, end ו-step. לכן, אם הטווח הוא 0 עד 11 שלב 0.1, נקודה 0 היא 0, נקודה 1 היא 0.1 וכן הלאה, עד נקודה 110, שהערך שלה הוא 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
כדי להגדיר פונקציה בשני מאפיינים, צריך להשתמש בתרשים lxy, להקצות שתי סדרות דמה ולהקצות פונקציה לכל אחד מהמאפיינים. 0,x,0,10,0.1,sin(x)*50%2B50 - סדרה 0 (הערכים של ציר ה-x) כוללת משתנה בשם x, עם ערכים בין 0 ל-10, שלב 0.1 ופונקציה sin(x)*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 - סדרה 0 (ערכי ציר ה-y) כוללת משתנה בשם y, עם ערכים מ-0 עד 10, שלב 0.1 והפונקציה 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
הפרמטר chfd באמת יכול לאפשר לכם לבטא את היצירתיות שלכם. אפשר ללחוץ על התמונות האלה כדי לפתוח אותן ולשחק איתן במגרש המשחקים של התרשימים כדי להתחיל לשחק!

חזרה למעלה