תרשימי ון

   

במסמך הזה נסביר איך ליצור דיאגרמות ון באמצעות Chart API.

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

תכונות שספציפיות לתרשים מבוא סוגי תרשימים (cht) צבעי הסדרה (chco)

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

הקדמה

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

סוגי תרשימים (cht)

כדי לציין דיאגרמת ון באמצעות התחביר הבא:

תחביר

cht=v

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

• שלושת הערכים הראשונים מציינים את הגדלים של שלושה מעגלים: A, B ו-C. בתרשים עם שני מעגלים בלבד, מציינים אפס עבור הערך השלישי.
• הערך הרביעי מציין את גודל ההצטלבות של A ו-B.
• הערך החמישי מציין את גודל ההצטלבות של A ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.
• הערך השישי מציין את גודל ההצטלבות של B ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.
• הערך השביעי מציין את גודל החיתוך המשותף של A, B ו-C. לתרשים עם שני מעגלים בלבד, אין לציין כאן ערך.

שימו לב שבתרשימים של דיאגרמות ון (Venn) כל הערכים הם יחסיים ולא מוחלטים. כלומר, תרשים עם הערכים 10,20,30 ייראה זהה לתרשים עם הערכים 100,200,300 (אם סוג הקידוד שלכם מקבל את הערכים האלה).

תיאור	דוגמה
תרשים ון שמורכב משלושה מעגלים.	cht=v chd=t:100,80,60,30,30,30,10
כדי ליצור תרשים עם שני מעגלים, צריך לציין אפס עבור מעגל C ואסור לציין ערכים חופפים שכוללים את C.	cht=v chd=t:100,100,0,50

צבעי הסדרה chco

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

תחביר

chco=<color_1>,...,<color_n>

<color>

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

תיאור	דוגמה
צבע שונה לכל עיגול.	chco=FF6342,ADDE63,63C6DE
אם יש פחות צבעים מאשר עיגולים, הצבע האחרון שצוין חוזר. עם זאת, הדבר מקשה על קריאת התרשים.	chco=00FF00,0000FF

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

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

פורמט צבע

צריך לציין צבעים באמצעות מחרוזת בת 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".

 

דוגמאות

תיאור	דוגמה
תרשים עם כותרת, עם צבע וגודל גופן שמוגדרים כברירת מחדל. צריך לציין רווח עם סימן חיבור (+). כדי לאלץ מעבר שורה, צריך להשתמש בתו קו אנכי (|). 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

חזרה למעלה

מילוי ברקע 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

חזרה למעלה