תרשימי מכ"ם

   

במאמר הזה נסביר איך ליצור תרשימי מכ"ם באמצעות Chart API.

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

תכונות שספציפיות לתרשים

  1. סקירה כללית
  2. סוגי תרשימים (cht)
  3. צבעי הסדרה (chco)

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

  1. כותרת התרשים (chtt, chts)
  2. טקסט וסגנון של מקרא התרשים (chdl, chdlp, chdls)
  3. שולי התרשים (chma)
  4. סגנונות ותוויות של צירים
    1. צירים גלויים (chxt)
    2. טווח ציר (chxr)
    3. תוויות ציר מותאמות אישית (chxl)
    4. מיקומי תוויות ציר (chxp)
    5. Axis Label Styles (chxs)
    6. סימני שנתות בצירים (chxtc)
  5. מילוי רקע (chf)
    1. Solid Fills (chf)
    2. Gradient Fills (chf)
    3. Striped Fills (chf)
  6. Grid קווי (chg)
  7. סמנים דינמיים (chem)
  8. סגנונות קו (chls)
  9. Line Fills (מילוי קו) (chm)
  10. סמני צורות (chm)
  11. סמנים של ערכי טקסט ונתונים (chm)
  12. סמני טווח (chm=r|R)
  13. סמני קו (chm=D)
  14. פונקציות נתונים (chfd)

סקירה כללית

בתרשים מכ"ם, נקודות הנתונים משורטטות במרווחים שווים, בכיוון השעון. הערך של הנקודה מיוצג כמרחק ממרכז התרשים, כאשר המרכז מייצג את הערך המינימלי וקצוות התרשים הוא הערך המקסימלי. כל סדרה משורטטת כמעגל שלם אחד בתרשים. התרשים מחבר את הנקודות האלה באמצעות קווים ישרים או מעוגלים, כפי שתבחרו. תרשים מכ"ם הוא למעשה תרשים קו שמוקף בעיגול כלשהו. ציר ה-Y עובר ממרכז התרשים להיקף, וציר ה-X הוא ההיקף של התרשים, שמתחיל ומסתיים בקו 12:00.

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

  • מספר התוויות + 1 (כפי שצוין על ידי chxl, אם יש), או
  • מספר ערכי הנתונים.

לדוגמה, אם יש לכם תרשים עם שמונה נקודות נתונים ללא תוויות, המרווח בין הנקודות על הגרף יהיה ב-45 מעלות (360 / 8).

אם יש כמה סדרות, הסדרה עם מספר הנקודות הגבוה ביותר תיספר. מספר הפלחים המינימלי הוא ארבעה. אם יש לכם פחות מ-4 תוויות או נקודות על הגרף, ברירת המחדל של התרשים היא ארבעה פלחים. צריך n+1 נקודות נתונים כדי ליצור מעגל מלא של התרשים, כאשר n הוא מספר הקטעים. ככל שיהיו יותר נקודות על הגרף, תהיה לכך רמת פירוט גבוהה יותר. הנתונים לעולם לא יסובבו בתרשים יותר מפעם אחת.

תרשים מכ"ם יכול לתמוך בסדרות מרובות. כל סדרה היא קו בתרשים.

תיאור דוגמה

 

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

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

תרשים מכ"ם
cht=r
chd=t:10,20,30,40,50,60,70,80,90
כשתוויות של ציר ה-X נכללות בתרשים מכ"ם, הריווח בין נקודות הנתונים סביב התרשים נקבע לפי מספר התוויות או מספר הנקודות (הגדול מביניהם). בשני התרשימים מספר הנקודות על הגרף זהה (חמש), אבל הראשונה כוללת פחות תוויות והשנייה כוללת יותר תוויות. בתרשים הראשון מוקצה מיקומי נתונים לפי מספר הנקודות, והשני לפי מספר התוויות. שימו לב שהתרשים השני כולל שישה פלחים, כך ששבע נקודות יוצרות מעגל שלם.


chd=t:10,20,30,40,50
chxl=0:|1|2|3|4
תרשים עם 5 נקודות על הגרף, 4 תוויות.
נתונים במרווחים של 360/5=72 מעלות


chd=t:10,20,30,40,50
chxl=0:|1|2|3|4|5|6
תרשים עם 6 תוויות, 5 נקודות על הגרף.
נתונים במרווחים של 360/6=60 מעלות.

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

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

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

תוויות צירים מצוינות באמצעות chxt, chxl ו-chxr, כפי שמתואר בקטע סגנונות ותוויות של צירים. בתרשימי מכ"ם, ציר ה-X משורטט במעגל סביב היקף התרשים, וציר ה-Y וציר ה-R עוברים ממרכז התרשים למעלה. המערכת מתעלמת מציר ה-t. התרשים הזה כולל תוויות של ציר ה-X שעשויות לציין ערכים במיקומים שונים של מצפן (לדוגמה, מהירות הרוח).

 

 תרשים מכ"ם
chco=FF0000,FF9900
chls=2.0,4.0,0.0|2.0,4.0,0.0
chxt=x
chxl=0:|0|45|90|135|180|225|270|315
chxr=0,0.0,360.0

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

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

בדוגמה הזו נכללים קווי רשת.

 

 תרשים מכ"ם עם מילויי קווים
chg=25.0,25.0,4.0,4.0
chm=
B,FF000080,0,1.0,5.0|
B,FF990080,1,1.0,5.0

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

  • chm=h,0000FF,... - העיגול הכחול הכהה. יש לשים לב איך סמנים של צורה אופקית מייצרים עיגול בתרשים מכ"ם.
  • chm=V,00FF0080,... – הקו הירוק בשעה 6:00.

מידע נוסף על הצורות הזמינות זמין במאמר סמני צורות.

 תרשים מכ"ם
chm=
h,0000FF,0,1.0,4.0
V,00FF00,0,4.0,5.0

חזרה למעלה

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

יש שני סוגים של תרשימי מכ"ם: תרשימי קו ישר (cht=r) תרשימי קו מעוגל (cht=rs).

פרמטר תיאור דוגמה
r

 

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

תרשים מכ"ם
cht=r
chd=t:10,20,30,40,50,60
rs סוג התרשים rs מחבר נקודות עם קווים מעוקלים. תרשים מכ"ם
cht=rs
chd=t:10,20,30,40,50,60,70,80,90

חזרה למעלה

צבעי הסדרה chco

אפשר לציין את צבעי השורות באמצעות הפרמטר chco.

תחביר

chco=<color_1>,...,<color_n>
<color>
יש לציין צבע אחד או יותר של צבעי שורה בפורמט הקסדצימלי של RRGGBB ולהפריד ביניהם באמצעות פסיקים. אם יש יותר קווים מאשר צבעים, הקווים הנוספים יופיעו במחזוריות בין רשימת הצבעים מההתחלה.

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

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

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

 תרשים עמודות אנכי עם כחול, 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

בתרשימי עמודות, קו, מכ"ם ופיזור ערכי ציר אחד או שניים כברירת מחדל, אבל הקווים האלה לא כוללים ערכים. כדי להציג ערכים בקווי הצירים או כדי לשנות את הצירים שיוצגו, צריך להשתמש בפרמטר 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 לכל הצירים.

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

תרשים קו עם התוויות: 0, 20, 40, 60, 80 ו-100 משמאל ומימין ותוויות: 0, 25, 50, 75 ו-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. התווית הראשונה ממורכזת בבסיס של העמודה הראשונה, התווית השנייה ממורכזת בבסיס העמודה השנייה, וכן הלאה.

תרשים קו עם התוויות: 0, 20, 40, 60, 80 ו-100 משמאל ומימין ותוויות: 0, 25, 50, 75 ו-100 מעל ומתחת
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>.

תרשים עמודות עם הערכים 200, 300 ו-400 בציר ה-X 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 לא מסתיים בקו ניצב.

 תרשים קו עם הערכים 0 ו-100 משמאל, A, B ו-C מימין, ינואר, יולי, ינואר, יולי וינואר על ציר ה-X ו-2005, 2006 ו-2007 מתחת
chxt=x,y
chxl=
0:|Jan|Feb|March|April|May|
1:|Min|Mid|Max

בדוגמה הזו מופיעות תוויות צירים בציר ה-Y ובציר ה-Y (y ו-r). כמו כן, היא כוללת שתי קבוצות של ערכים לציר ה-X (x). מומלץ להוסיף סימני שנתות בציר ה-Y באמצעות chxs.

תרשים קו עם הערכים 0 ו-100 משמאל, A, B ו-C מימין, ינואר, יולי, ינואר, יולי וינואר על ציר ה-X ו-2005, 2006 ו-2007 מתחת
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 השמאלי.

תרשים עמודות עם הערכים 0 ו-100 מצד שמאל, A, B ו-C מימין, ינואר, יולי, ינואר, יולי וינואר על ציר ה-X ו-2005, 2006 ו-2007 למטה
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.

Line chart with min, average, and max on the right, 20, 40, 60, 80, and 100 on the left, and 0, 25, 50, 75, and 100 along the x-axis
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 יחידות, כפי שמוצג בתרשים השני.

 Line chart with 10, 35, and 75 on the left, and 0, 25, 50, 75, and 100 along the x-axis
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 השני (ינואר, פברואר, מרץ).

תרשים קו עם נקודות, ממוצע ומקסימום בצד שמאל, 0, 1, 2, 3 ו-4 בצד ימין, 0 עד 100 לאורך ציר ה-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 הימני. משורטטים סימני וי, אך ללא קו ציר.

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

תרשים קו עם 0 עד 100 לאורך ציר ה-X, ינואר, פברואר, מרץ מתחת, 0 עד 4 בציר ה-Y, וסימני שנתות אדומים ארוכים עם טקסט כחול לציון מינימום, ממוצע ומקסימום בצד ימין.

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% שקיפות). שמים לב לרקע של התא בטבלה שמוצג דרך התרשים.

תרשים פיזור עם נקודות בכחול, ושקיפות של 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

חזרה למעלה

קווי רשת chg [קו, בר, מכ"ם, פיזור]

אפשר להשתמש בפרמטר 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>, <x_axis_step_size>
משמש לחישוב מספר קווי הרשת של X או Y שיוצגו בתרשים. 100 / Step_size = כמה קווי רשת יופיעו בתרשים. במילים אחרות: המספר 20,25 מייצג 5 קווי רשת אנכיים ו-4 קווי רשת אופקיים.
<opt_dash_length>, <opt_space_length>
[אופציונלי] משמש להגדרת קווי רשת מקווקוים. הפרמטר הראשון הוא האורך של כל קו מפריד, בפיקסלים. הפרמטר השני הוא הריווח בין קווים מפרידים, בפיקסלים. יש לציין 0 עבור <opt_space_length> עבור קו רצוף. ערכי ברירת המחדל הם 4,1.
<opt_x_offset>,<opt_y_offset>
[אופציונלי] מספר היחידות, בהתאם לקנה המידה בתרשים, כדי לקזז את קווי הרשת של ה-x וה-y, בהתאמה. יכול להיות ערך חיובי או שלילי. אם מציינים את הערך הזה, צריך לציין גם את כל הערכים הקודמים. ערכי ברירת המחדל הם 0.0.

 

דוגמאות

תיאור דוגמה

בדוגמאות האלה נעשה שימוש רק בפרמטרים <x_axis_step_size> ו-<y_axis_step_size>. כברירת מחדל, ב-Chart API מוצג קו רשת מקווקו.

 תרשים קו עם 5 קווי רשת אנכיים ושני קווי רשת מקווקוים בצבע אפור בהיר
chg=20,50
תרשים קו עם 5 קווי רשת אנכיים ושני קווי רשת מקווקוים בצבע אפור בהיר
chg=20,50

בדוגמה הזו נעשה שימוש ברווחים גדולים יותר כדי להציג קווי רשת בהירים יותר (1,5).

 תרשים קו עם 5 אנכיים ושני קווי רשת אופקיים בצבע אפור בהיר, קווי רשת מקווקוים
chg=20,50,1,5

כדי להציג קווי רשת מלאים, צריך לציין אפס (0) לפרמטר <opt_space_length>.

התרשים הזה גם מציין היסט של 10 בציר ה-X.

 תרשים קו עם 5 קווים אנכיים ושני קווים אופקיים בצבע אפור בהיר, ברשת
chg=20,50,1,0,10

בתרשים הזה מופיע היסט של 10 בציר ה-X וקיזוז של ציר Y 20.

 תרשים קו עם 5 קווים אנכיים ושני קווים אופקיים בצבע אפור בהיר, ברשת
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 (קו קבוע).

 

דוגמאות

תיאור דוגמה

כאן מציינים את הקו המקווקו על ידי 3,6,3, והקו האחיד והעבה יותר מצוין על ידי 5.

 תרשים קו עם קו אחד מלא וקו מקווקו אחד
chls=3,6,3|5

חזרה למעלה

סמנים של סמלים דינמיים chem [סרגל, קו, רדאר, פיזור]

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

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

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_string>
הנתונים הנדרשים לסוג הסמן הספציפי הזה. התנאי הזה כולל את אותה מחרוזת שתשמש בפרמטר chld לציון סמל עצמאי שווה ערך, למעט שכל תווי | המפרידים צריכים להיות מוחלפים בפסיקים (חשוב לזכור להשתמש בפסיקים במקום בסמני קו אנכי של טקסט מרובה שורות!). חשוב לשים לב שבתוך מחרוזת הנתונים צריך גם לסמן בתו בריחה (escape) את התווים הבאים באמצעות סימן @: קו אנכי ( | ) , ב- ( @ ) , שווה (= = ), פסיק ( , ), נקודה-פסיק ( ; ). דוגמאות: hello@,+world, 5@@10+cents+each.
ds=<which_series>
[אופציונלי] האינדקס מבוסס-אפס של סדרת הנתונים שהסמן הזה שייך אליה. ערך ברירת המחדל הוא 0.
dp=<which_points>
[אופציונלי] מציין אילו נקודות על הגרף ישמשו לציור סמנים. ערך ברירת המחדל הוא 0 (הנקודה הראשונה בסדרה). צריך להשתמש באחד מהפורמטים הבאים:
  • n.d – הנקודה שבה צריך לשרטט את הסמן, כאשר n.d מייצג את האינדקס המבוסס על אפסים בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי בין נקודה 3 לנקודה 4.
  • range,<start>,<end>,<step> - משרטטים סמן על כל נקודת נתונים שלב בטווח מהתחלה עד סיום, כולל. ההתחלה והסיום הם ערכי אינדקס, והם יכולים להיות מספרי נקודה צפה (floating-point) לציון ערכי ביניים. כל הערכים הם אופציונליים. ברירות המחדל הן: 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>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי התרשים (קווים ועמודות) נמצאים קצת מתחת לאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 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: https://chart.googleapis.com/chart?chs=300x140&cht=lc&chco=FF9900,224499&
chd=t:75,74,66,30,10,5,3,1&chls=1|1&
chem=y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0&chm=v,ccccFF,0,::.2,2

תרשים 2: https://chart.googleapis.com/chart?chst=d_bubble_icon_text_small&chld=ski|bb|Wheeee!|FFFFFF|000000

תרשים קו עם סמן סמל דינמי.
chem=
  y;s=bubble_icon_text_small;d=ski,bb,Wheeee!,FFFFFF;dp=2;ds=0

אותו סמן סמל דינמי כמו תמונה עצמאית.


chst=
  d_bubble_icon_text_small
chld=
  ski|bb|Wheeee!|FFFFFF|000000

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

בתרשים השני נעשה שימוש בערך of כדי להזיז את זנב הסמן מעל לנקודת הגרף הרצויה. קיזוז טוב לסיכה נטויה הוא -12,20.
chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1

chem=y;
  s=map_xpin_letter;
  d=pin_sleft,A,FF0000;
  dp=3;
  ds=1;
  of=-12,0

כדי לכלול כמה סמלים דינמיים, חוזרים על מחרוזת התחביר ומופרדים בתו |.

בדוגמה הזו מוצג טווח וגם שני סמנים בודדים.

צריך לשים לב שההפרשים האנכיים בין הסיכות האנכיות הם 0.22. ההבדל בסיכה הנטוי הוא 12,20, כדי להתאים את נקודות הסיכה לסדרה שהן מתארות.
chem=
  y;s=map_xpin_letter;d=pin_sright,A,FF0000;dp=4;ds=0;py=1;of=12,20|
  y;s=map_pin_icon;d=baby,FF5555;ds=1;dp=6;of=0,22|
  y;s=map_pin_icon;d=camping,DEF763;ds=2;dp=range,2,5
נראה סימון טקסט עם מספר שורות. צריך לקזז את הסמן אחרי הוספת הטקסט, כי גודל הבועה משתנה בהתאם לטקסט וכתוצאה מכך היא תופיע שוב במרכז התרשים. חשוב לשים לב איך השורות החדשות בטקסט מסומנות באמצעות פסיקים במחרוזת הנתונים d.
chem=y;
  s=bubble_texts_big;
  d=bbbr,FFC6A5,000000,Outlier,Forgot+to+feed;
  ds=0;
  dp=13;
  of=-120,2

תרשימים מוטמעים

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

יש שני סגנונות של סמני תרשימים מוטמעים: תרשימים מוטמעים בבועה ותרשימים מוטמעים ללא בועה. הנה דוגמאות של שני הסוגים:

תרשים ללא בועות
תרשים עם בועה
תרשים ללא בועה

פירטנו כאן הפרמטרים של 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? בכתובת ה-URL של התרשים שצריך להטמיע. אפשר להשתמש בכלי שלמטה או לפעול לפי הכללים שמפורטים מתחתיו.
frame_type
[בועה בלבד] אחד מקבועי הסגנון של הסמל הדינמי.
מרווח פנימי
[בועה בלבד] מרווח בתוך הבועה, בפיקסלים.
frame_color
[בועה בלבד] צבע המסגרת, כמחרוזת צבע HTML בת שש ספרות ללא הסימן #. דוגמה: FF00FF
fill_color
[בועה בלבד] צבע מילוי בועה, כמחרוזת צבע HTML בת שש ספרות ללא הסימן #. דוגמה: FF00FF

נתוני תרשים מוטמעים

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

כללים להמרה ידנית

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

החלפה באמצעות
%7C או %7c
|
@
@@
%
25%
,
@,
|
@|
;
@;
ו-
%26
=
%3D

2. לאחר מכן צריך להחליף את כל הערכים של & ו-= בזוגות של parameter1=value1&parameter2=value2... בפסיקים.

חזרה למעלה

מילוי קו chm [קו, מכ"ם]

אפשר למלא את האזור שמתחת לשורת הנתונים בצבע אחיד.

כדי להפריד בין הפרמטרים של 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>.
<color>
מספר הקסדצימלי בפורמט RRGGBB של צבע המילוי.
<start_line_index>
האינדקס של הקו שבו המילוי מתחיל. לסדרת הנתונים הראשונה שצוינה ב-chd יש אינדקס אפס (0), לסדרת הנתונים השנייה יש אינדקס של 1, וכן הלאה.
<end_line_index>
  • סוג המילוי 'b' - השורה שבה יש להפסיק את המילוי. השורה הזו צריכה להיות מתחת לשורה הנוכחית.
  • סוג מילוי 'B' – אחת מהאפשרויות הבאות:
    • any value - המערכת תתעלם מכל מספר בודד בפרמטר הזה, והמילוי יעבור מהקו שצוין לבסיס התרשים
    • start:end - כדי למלא פלח אנכי מתחת לתרשים, מציינים start:end, כאשר מדובר באינדקסים של נקודות על הגרף המתארים היכן להתחיל ולהפסיק את המילוי. שני הערכים הם אופציונליים, וברירת המחדל שלהם היא first_point:last_point. (ראו דוגמה למטה).
<0>
שמור – חייב להיות אפס.

 

דוגמאות

תיאור דוגמה

לסדרה אחת, קל יותר להשתמש בפונקציה chm=B. טקסט כזה ימלא את כל האזור שמתחת לקו.

זהו סוג אזור המילוי היחיד שזמין לתרשימי מכ"ם. chm=b לא פועל עם תרשימי מכ"ם.


chm=B,76A4FB,0,0,0

הנה תרשים עם שתי שורות ושני מילויים. מילוי האזור שמתחת לקו התחתון ומעל לקו העליון מחייב שיטה מיוחדת, שמתוארת בהמשך.


chd=s:
cefhjkqwrlgYcfgc,
QSSVXXdkfZUMRTUQ,
HJJMOOUbVPKDHKLH,

chm=
b,224499,0,1,0| (כחול)
b,FF0000,1,2,0| (אדום)

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

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

הקווים עצמם משורטטים בשחור, לפי chco.

 שלוש שורות בתרשים. התרשים מוצלל בירוק מהשורה התחתונה ועד השורה הראשונה, אדום מהשורה הראשונה לשורה השנייה, כחול כהה מהשורה השנייה וכחול בהיר מהשורה השלישית לראש התרשים
chd=e:
  ...., (הערך הגבוה ביותר)
  cefhjkqwrlgYcfgc,
  QSSVXXdkfZUMRTUQ,
  HJJMOOUbVPKDHKLH,
  AAAA (ערך אפס)
chm=
  b,76A4FB,0,1,0| (תכלת)
  b,224499,1,2,0| (כחול)
  b,FF0000,2,3,0| (אדום)
  b,80C65A,3,4,0 (ירוק)
chco=000000

לפניכם תרשים קו עם פלחי מילוי אנכיים. כדי לעשות זאת, מציינים צמד start:end עבור <end_line_index> עם סוג מילוי השורה 'B'.

  • B,76A4FB,0,0:3,0 - מילוי אנכי כחול מתחת לשורה 0, עם גבולות של נקודות נתונים 0-3.
  • B,990000,0,7:10,0 - מילוי אנכי אדום מתחת לשורה 0, עם גבולות של נקודות נתונים 7-10.
  • B,DEDC06,0,12:,0 - מילוי אנכי בצבע צהוב מתחת לשורה 0, מנקודת נתונים 12 עד סוף הסדרה.
chm=
  B,76A4FB,0,0:3,0|
  B,990000,0,7:10,0|
  B,DEDC06,0,12:,0

בדוגמה הזו מוצג שימוש במילוי קו בתרשים מכ"ם.

 תרשים מכ&quot;ם
chm=
  B,FF000080,0,1.0,5.0|
  B,FF990080,1,1.0,5.0

חזרה למעלה

סמני צורות 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>
@
[אופציונלי] אם לפני סוג הסמן מופיע תו @ אופציונלי, צריך להשתמש בפורמט x:y עבור <opt_what_points>.
<mark_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. ערך של נקודה צפה (floating-point). אם n קטן מ-1, התרשים יחשב עבורך נקודות ביניים נוספות . לדוגמה, הוספה של -0.5 תציב מספר כפול של סמנים מנקודות נתונים.
  • start:end:n - שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהאלמנט הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם הערך של השלב n קטן מ-1, המערכת תחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1
  • x:y - שרטט סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו @ לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודה צפה (floating-point). הערך 0:0 הוא הפינה הימנית התחתונה של התרשים ו-1:1 הוא הפינה השמאלית העליונה של התרשים. לדוגמה, כדי להוסיף יהלום אדום בגודל 15 פיקסלים למרכז תרשים, אפשר להשתמש בפונקציה @d,FF0000,0,0.5:0.5,15.
<size>
גודל הסמן, בפיקסלים. ברוב המקרים, הסמנים V , H ו-S תומכים בתחביר <size>[:width], כאשר החלק השני האופציונלי מציין את אורך הקו או הסמן.
<opt_z_order>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
<opt_offset>
[אופציונלי] הגדרת היסט אופקי ואנכי מהמיקום שצוין. הנה התחביר, שמשתמש במפריד : reserved:<horizontal_offset>:<vertical_offset>. אם מציינים את הפרמטר הזה, אפשר לכלול ערך ריק במחרוזת הפרמטר chm עבור <opt_z_order>. דוגמאות: 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> - מספר חיובי או שלילי לציון ההיסט האנכי, בפיקסלים. אופציונלי; אם לא נעשה שימוש, יש להשאיר ריק.

 

דוגמאות

תיאור דוגמה

כאן מוצגת דוגמה של כמה מסמני צורה וקווים.

  • a,990066,0,0.0,9.0 - חץ סגול, סדרה ראשונה, נקודה ראשונה, גודל 9.
  • c,FF0000,0,1.0,20.0 - צלב אדום, סדרה ראשונה, נקודה שנייה, גודל 9.
  • d,80C65A,0,2,20.0 – יהלום ירוק, סדרה ראשונה, נקודה שלישית, גודל 9.
  • H,000000,0,3,1:40 - קו אופקי שחור, סדרה ראשונה, נקודת נתונים 3, רוחב של פיקסל אחד, אורך ארבעים פיקסלים.
  • o,FF9900,0,4.0,12.0 - עיגול כתום, סדרה ראשונה, נקודה חמישית, גודל 12.
  • s,3399CC,0,5.0,11.0 - ריבוע כחול, סדרה ראשונה, נקודה שישית, גודל 11.
  • v,BBCCED,0,6.0,1.0 - קו אנכי עד לנקודה, סדרה ראשונה, נקודה שביעית, ברוחב פיקסל אחד.
  • V,3399CC,0,7.0,1.0 - קו אנכי מלמטה למעלה בתרשים, סדרה ראשונה, נקודה שמינית, ברוחב פיקסל אחד.
  • x,FFCC33,0,8.0,20.0 - 'X' צהוב, סדרה ראשונה, נקודה תשיעית, מידה 20.
  • H,FFFF00,0,9,2 - קו צהוב אופקי של רוחב התרשים בנקודת נתונים 9.
  • h,FF0000,0,0.5,1 - קו אופקי אדום בגובה שהוגדר, סדרה ראשונה, באמצע התרשים, ברוחב פיקסל אחד.
 תרשים קו עם סמנים
chm=
  a,990066,0,0.0,9.0|
  c,FF0000,0,1.0,20|
  d,80C65A,0,2.0,20.0|
  H,000000,0,3,1:40|
  o,FF9900,0,4.0,12.0|
  s,3399CC,0,5.0,11.0|
  v,BBCCED,0,6,1.0|
  V,3399CC,0,7,1.0|
  x,FFCC33,0,8,20|
  H,FFFF00,0,9,2|
  h,FF0000,0,0.5,1

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

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

 תרשים קו. בקו אחד יש עיגולים של 15 פיקסלים בכל נקודה על הגרף, ובקו השני יש 10 יהלומים. יהלום מצויר בנקודה המשותפת לשני הקווים
chm=
  o,FF9900,0,-1,15.0|
  d,FF0000,1,-1,10.0

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

 תרשים קו עם סמן בכל נקודה שנייה
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-2,6
לפניכם תרשים קו שמכיל מספר כפול של סמנים מנקודות נתונים ( -0.5 פירושו כל חצי נקודה). תרשים קו עם סמן בכל נקודה שנייה
chd=t:
  0,20,20,50,40,70,70,90,85,45,40,50
chm=
  o,0066FF,0,-.5,6
הדוגמה הזו מראה איך להשתמש בסמנים h ו-v כדי ליצור קווי רשת עם עובי וצבעים בהתאמה אישית. הערך של סדר ה-z (הערך האחרון) מוגדר ל-1-, כך שקווי הרשת ישורטטו מתחת לקו הנתונים.
תרשים קו עם סמן בכל נקודה שנייה
chm=
  h,76A4FB,0,0:1:.2,2,-1|
  V,76A4FB,0,::2,0.5,-1

בתרשים הזה מתווספים קווי מילוי אנכיים לתרשים קו:

  • v – קווים אנכיים לתרשים
  • FF0000 – קווים אדומים
  • 0 – אינדקס של סדרה
  • : :.5 - מציין הטווח: מההתחלה ועד הסוף, כל 0.5 נקודות.
  • 2 – עובי 2 פיקסלים.
 תרשים קו עם סמן בכל נקודה שנייה
chm=
  v,FF0000,0,::.5,2
בדוגמה הזו מתווסף חץ וסמני טקסט לתרשים באמצעות קואורדינטות מדויקות. סמן D הראשון הוא קו המעקב שמתחת לעמודות. הסמן השני הוא החץ והסמן השלישי הוא טקסט החץ.
chm=
  D,003971,1,0,3|
  @a,000000,0,.25:.75,7|
  @tExpected,000000,0,.35:.85,10
קו אופקי הקבוע לנקודה ספציפית על הגרף (H) יכול לעזור לך להציג ערכים יחסיים, או להדגיש את הגובה של ערך נתונים בתרשים.
chm=H,FF0000,0,18,1

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

  • E,000000,0,6,1:20 - סרגל שגיאה שחור עם קווים רחבים של פיקסל אחד, עמודות עליונות ותחתונות באורך 20 פיקסלים. החלק התחתון מעוגן לסדרה 0 נקודות 8, החלק העליון מעוגן לסדרה 1 נקודה 8.
  • H,990066,1,2,5:50 - סגול, קו אופקי ברוחב 5 פיקסלים, באורך 50 פיקסלים באורך 5 פיקסלים במרכז מעל נקודה 2.
  • V,3399CC,0,8,3:50- קו כחול אנכי ברוחב 3 פיקסלים, באורך 50 פיקסלים, במרכז נקודת הנתונים 8.
 title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5:50
chm=
  E,000000,0,6,1:20|
  H,990066,1,2,5:50|
  V,3399CC,0,8,3:50

חזרה למעלה

סמנים של ערכי טקסט ונתונים chm [סרגל, קו, מכ"ם, פיזור]

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

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

הערה לגבי ערכי מחרוזת: מותר להשתמש רק בתווים שמתאימים לכתובת URL במחרוזות תוויות. מטעמי אבטחה, יש לקודד כתובות URL של מחרוזות שמכילות תווים שלא נכללים בקבוצת התווים 0-9a-zA-Z. אפשר למצוא מקודד של כתובות URL במסמכי התיעוד של 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>
<mark_type>
סוג הסמן שבו יש להשתמש. אפשר לבחור מבין הסוגים הבאים:
  • f<text> – דגל שמכיל טקסט. צריך לציין את התו 'f' ואחריו טקסט בהתאמה אישית עם קידוד כתובת URL. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה: fHello\,+World!
  • t<text> - סמן טקסט פשוט. צריך לציין את התו 't' ואחריו טקסט מקודד בהתאמה אישית. כדי לסמן בתו בריחה (escape) פסיקים בסמני טקסט, צריך להוסיף את הסימן \ לפני הפסיק. דוגמה: tHello\,+World!
  • A<text> – סמן הערות. פעולה זו דומה לסמן דגל, אבל סמנים יתאמו את המיקום שלהם כך שלא תהיה חפיפה. הפורמט החוקי היחיד עבור <opt_which_points> הוא opt_which_points, לציון האינדקס של נקודה בסדרה.
  • N<formatting_string> - ערך הנתונים בשלב זה, עם עיצוב אופציונלי. אם לא משתמשים בפרמטר chds (התאמה אישית), הוא מספק את הערך המקודד המדויק. אם משתמשים בפרמטר הזה בכל סוג פורמט, הערך יותאם לטווח שתציינו. הנה דוגמה של chds עם סמנים מספריים. כשמציינים את סוג הסמן הזה בתרשים עמודות מוערם, אם מציינים -1 עבור <series_index>, נוצר סמן שמציג את סכום כל הערכים בעמודה המוערמת הזו. זהו התחביר של מחרוזת העיצוב:
           <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> - הטקסט שיופיע אחרי כל ערך.
<color>
צבע הסמנים עבור הקבוצה הזו, בפורמט הקסדצימלי של RRGGBB.
<series_index>
האינדקס מבוסס האפס של סדרת הנתונים שעליו משרטטים את הסמנים. אם מדובר בתרשים עמודות מוערם וסוג הסמן הוא N (ערכי נקודות על הגרף), אפשר לציין -1 כדי ליצור סמן ערכים מסכם לכל ערימת עמודות. אפשר לראות דוגמה בהמשך.
<opt_which_points>
[אופציונלי] על אילו נקודות לשרטט סמנים. ברירת המחדל היא כל הסמנים. צריך להשתמש באחד מהערכים הבאים:
  • n.d – נקודת הגרף שעליה משרטטים את הסמן, כאשר n.d הוא האינדקס המבוסס על אפס בסדרה. אם מציינים ערך שאינו מספר שלם, השבר מציין נקודת ביניים מחושבת. לדוגמה, 3.5 הוא חצי הדרך בין נקודה 3 לנקודה 4.
  • -1 - שרטט סמן בכל נקודות הנתונים. אפשר גם להשאיר את הפרמטר הזה ריק כדי לשרטט על כל נקודות הנתונים.
  • -n - שרטט סמן בכל נקודת נתונים n.
  • start:end:n - שרטט סמן על כל נקודת נתונים n בטווח, מערכי האינדקס התחלה עד סיום, כולל. כל הפרמטרים הם אופציונליים (ייתכן שחסר אותם), לכן 3::1 יופיע מהרכיב הרביעי עד האחרון, שלב 1, ואם משמיטים את הפרמטר הזה לחלוטין, ברירת המחדל תהיה first:last:1. כל הערכים יכולים להיות מספרים של נקודות צפות. start ו-end יכולים להיות שליליים, על מנת לספור לאחור מהערך האחרון. אם גם start וגם end הערכים שליליים, כדאי לוודא שהם רשומים בערך עולה (לדוגמה, -6:-1:1). אם ערך השלב n קטן מ-1, הוא יחשב נקודות נתונים נוספות באמצעות אינטרפולציה של ערכי הנתונים הנתונים. ערכי ברירת המחדל הם first:last:1
  • x:y - [התכונה לא נתמכת לסמנים מסוג N] משרטטים סמן בנקודת x/y ספציפית בתרשים. הנקודה הזו לא חייבת להיות על קו. כדי להשתמש באפשרות הזו, צריך להוסיף את התו (@) לפני סוג הסמן. אפשר לציין את הקואורדינטות כערכי נקודות צפה (floating-point). הערך 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>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).
<opt_placement>
[אופציונלי] פרטים נוספים על מיקום הסמן ביחס לנקודה על הגרף. אפשר לציין מיקום יחסי אופקי ו/או אנכי, וכן קיזוזים. תחביר המיקום הוא מחרוזת עם תווי הפרדה: , כפי שמוצג כאן. כל הרכיבים הם אופציונליים: <horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>. אם מציינים, אפשר לכלול ערך ריק במחרוזת הפרמטר chm עבור <opt_z_order>. לדוגמה: 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.

תיאור דוגמה

דוגמה לתוויות של ערכים בתרשים עמודות.

התרשים הראשון (N*p0*) מציין סמן של ערך נתונים. הערכים מוצגים כאחוז, ומעוגלים לאפס ספרות אחרי הנקודה העשרונית, בצבע שחור לכל הערכים, בטקסט של 11 נקודות. חשוב לשים לב שכל ערכי הנתונים הם בין 0.0 ל-1.0, בפורמט באחוזים נעים למעלה עם שתי ספרות אחרי הנקודה העשרונית.

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

תרשים עמודות עם תוויות של אחוזים מעל כל עמודה
chm=
  N*p0*,000000,0,-1,11
chd=t:
  0.4356,0.3562,0.4834,0.575,0.673,0.6091

תרשים עמודות עם תוויות אירו מעל כל עמודה


chm=
  N*cEUR1*,000000,0,-1,11

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

בדוגמה הזו מוצג תרשים עם הערכים בקידוד פשוט של 46, 39, 29, 30, 43, 41. טווח הקידוד הפשוט הוא 0-61 . הפרמטר chds מגדיר סולם סמנים מותאם אישית של 0 עד 1, כך שערכי הסמנים יותאמו לטווח הזה, אבל גובה העמודות לא יושפע (אם מדובר בנתונים של פורמט טקסט, גם העמודות יוגדלו).
chd=s:underp
chm=N,000000,0,-1,11
chds=0,1

בהמשך מוצגת דוגמה לתרשים עם תווית טקסט בנקודה המינימלית ותווית דגל בנקודה המקסימלית.

תרשים קו עם תווית טקסט כחולה של 10 נקודות ודגל עם טקסט אדום באורך 15 נקודות, שמשורטטים על נקודות הנתונים של קו ירוק מקווקו.
chm=
  tMin,0000FF,0,1,10|
  fMax,FF0000,0,3,15
בדוגמה הזו מוצג תרשים מוערם עם ערכים לסדרות בודדות, וגם הסכום הכולל של הסדרה. כדי להציג את ערכי הסדרות המוערם, עלינו להשתמש באפשרות המיקום 'c'. אם לא, ערך העמודה העליונה יחפוף לערך הסכום בראש כל עמודה.
chm=
  N,FF0000,-1,,12|
  N,000000,0,,12,,c|
  N,000000,1,,12,,c|
  N,ffffff,2,,12,,c
כמה הדגמות נוספות של אופן הפעולה של מיקומי מודעות אנכיים ואופקיים. בדוגמה הזו מוצגים שילובים שונים של ערכי עוגן לתרשימי עמודות (שבהם נעשה שימוש ב-s , c ו-e למיקום אנכי). שימו לב איך עוגן ימני מזיז סמן שמאלה ועוגן עליון מזיז סמן למטה ולהפך. הנקודות האדומות מייצגות את הבסיס, המרכז ובחלק העליון של כל עמודה. המספר הוא ערך הנתונים, שקבוע באמצעות ערכי עוגן שונים בכל עמודה.
chm=
  N,000000,0,0,10,,rs
  N,000000,0,1,10,,ls
  N,000000,0,2,10,,c
  N,000000,0,3,10,,e
  N,000000,0,4,10,,e::15
  N,000000,0,5,10,,e::-12
סמני הערה מתאימים אוטומטית את מיקום התווית כך שלא תהיה חפיפה. הערך הראשון של chm מיועד למילוי השורה. הערכים הבאים הם כל סמני ההערות.
chm=B,C5D4B5BB,0,0,0
  AA,666666,0,3,15
  AB,666666,0,5,15
  AC,666666,0,24,15
  AD,666666,0,25,15
  AE,666666,0,26,15
  AF,666666,0,51,15
  AG,666666,0,60,15
  AH,666666,0,73,15
  AI,666666,0,80,15
  AJ,666666,0,99,15
דוגמה נוספת לסמן הערה שמראה את הגובה של העיר בשוויץ.

חזרה למעלה

סמני טווח chm [בר, פמוט, קו, מכ"ם, פיזור]

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

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

 

דוגמאות

תיאור דוגמה

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

  • r,E5ECF9,0,0.75,0.25 - סמן טווח, תכלת בהיר, (שמור), 0.5 מגובה התרשים.
  • r,000000,0,0.1,0.11 - סמן טווח, שחור (שמור), מתחיל ב-0.1 מהדרך במעלה ציר ה-Y ומסתיים ב-0.11 מהדרך כלפי ציר ה-Y (קו שחור דק).
 תרשים קו עם רצועה אופקית בצבע תכלת שנמתח מ-25 אחוזים ל-75 אחוזים מהדרך במעלה ציר ה-Y, וקו אופקי דק ב-10% מהגובה של ציר ה-Y
chm=
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

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

 תרשים קו עם רצועה אנכית בצבע תכלת שנמתח מ-25 אחוזים ל-75 אחוזים מהאורך של ציר ה-X, וקו אנכי דק לאורך עשרה אחוזים מהאורך של ציר ה-X
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25

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

 תרשים קו עם רצועה אנכית כחולה ורצועה אופקית בצבע כחול בהיר הנמתח מ-25 אחוזים ל-75 אחוזים מהאורך של ציר ה-X וציר ה-Y, בהתאמה. קו אדום אנכי דק וקו שחור אופקי דק בעשרה אחוזים מהדרך לאורך ציר ה-X וציר ה-Y, בהתאמה
chm=
  R,FF0000,0,0.1,0.11|
  R,A0BAE9,0,0.75,0.25|
  r,E5ECF9,0,0.75,0.25|
  r,000000,0,0.1,0.11

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

 קו נוצץ עם קו צהוב אחד ושלושה קווים אופקיים המרווחים במידה שווה
chm=
  r,000000,0,0.499,0.501|
  r,000000,0,0.998,1.0|
  r,000000,0,0.0,0.002

חזרה למעלה

סמני קווים chm=D [סרגל, פמוט, קו, מכ"ם, פיזור]

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

כדי להוסיף כמה שורות (או לשלב את הטקסט הזה עם סמני 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 – משתמשים בטווח ספציפי של נקודות בסדרה, מהתחלה עד סיום, כולל (אינדקס מבוסס-אפס). אפשר גם להשתמש בערכים של נקודה צפה (floating-point) כדי לציין נקודות ביניים, או להשאיר את הערכים start או end ריקים כדי לציין את הנקודה הראשונה או האחרונה על הגרף, בהתאמה. start ו-end יכולים להיות שליליים, כאינדקס הפוך מהערך האחרון. אם גם start וגם end מציינים ערך שלילי, צריך לכתוב אותם בערך של עלייה (לדוגמה, -6:-1).
<size>
רוחב הקו בפיקסלים.
<opt_z_order>
[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).

 

דוגמאות

תיאור דוגמה

זוהי דוגמה לשרטוט קו של סמן בתרשים עמודות. סדר ה-z מוגדר ל-1, כך שהקו משורטט מעל העמודות.

בדוגמה הזו משתמשים באותם נתונים גם בעמודות וגם בקו הנתונים.		 תרשים עמודות עם סמן קו
chm=D,0033FF,0,0,5,1
chd=s:1XQbnf4

זהו אותו תרשים עמודות, אבל עם סדרת נתונים נוספת רק עבור הקו. זו דוגמה לתרשים מורכב. תרשימים מורכבים משורטטים על ידי הוספה של סדרות נתונים לפרמטר chd, בתוספת ערך ל-chd, שמורה לתרשים 'להתעלם' מסדרת הנתונים הנוספת.

מידע נוסף זמין בתרשימים מורכבים.

 תרשים עמודות עם סמן קו
chm=D,0033FF,1,0,5,1
chd=s1:1XQbnf4,43ksfg6

חזרה למעלה

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

 

 גל סינוס שצוין על ידי chfd
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.

 סדרה אחת עם chfd, ובסדרה אחרת נעשה שימוש ב-chd לנתונים.
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 באמת יכול לאפשר לכם לבטא את היצירתיות שלכם.

אפשר ללחוץ על התמונות האלה כדי לפתוח אותן ולשחק איתן במגרש המשחקים של התרשימים כדי להתחיל לשחק!

חזרה למעלה