תרשימי מתחם

  

תכונות שספציפיות לתרשים סקירה כללית יצירת תרשים מורכב סוגי תרשימים תרשימים של סמני קו תרשימי פמוט תרשימי קופסה תרשימים מוטמעים

פרטי הסמן סמני קו (chm=D) סמני צורות (chm) סמני פמוט (chm=F)

 

סקירה כללית

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

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

.

יצירת תרשים מורכב

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

1. מוסיפים את סדרת נתוני הסמנים בסוף הפרמטר chd. לדוגמה, אם תרשים העמודות מכיל נתונים chd=t:30,10,20, אפשר להוסיף נתונים חדשים לסמן קו באופן הבא: chd=t:30,10,20|60,40,50.
2. הסתרת נתוני הסמנים הנוספים מתרשים הבסיס. אם מוסיפים סדרת נתונים נוספת לתרשים העמודות של קו המעקב, בתרשים היא תוצג כסדרה חדשה של עמודות. כדי למנוע את זה, יש להסתיר את הסדרה הנוספת הזו. כדי להסתיר סדרה, צריך לכלול ספרה אחת אחרי התיאור של הפורמט chd: לדוגמה, chd=t1:30,10,20|60,40,50. הספרה הזו מציינת ל-Chart API בכמה סדרות נתונים להשתמש כדי לצייר רכיבים בהתאם לסוג של תרשים הבסיס, כפי שמוגדר בפרמטר cht (עמודות לתרשימי עמודות, נקודות על הגרף בתרשימי קו וכו'). סוג התרשים הזה יתעלם מכל סדרות נתונים נוספות בזמן שרטוט התרשים. חשוב לשים לב שזהו מספר שמבוסס על 1 ולא על בסיס 0. כלומר, המשמעות של t1 היא "להשתמש רק בסדרת הנתונים הראשונה לעמודות," t2 פירושו "יש להשתמש רק בשתי הסדרות הראשונות של העמודות", וכו'.
   1. הערות:
      1. תרשימי פיזור – תרשימי פיזור מסתירים נתונים בדרך אחרת. לפרטים נוספים, אפשר לעיין במסמכי התיעוד.
      2. תרשימי קו lxy – יש לציין מספר זוגי של סדרות להצגה (t0, t2, t4 וכו'). הסיבה לכך היא שכל קו בתרשים lxy מתוארת על ידי שתי סדרות נתונים: אחת לערכי x ואחת לערכי y.
3. משתמשים בסדרת הנתונים המוסתרת כדי לצייר סמנים בפמוט, סמני קווים או סמנים אחרים. בקטעים המקושרים מוסבר איך לצייר סמנים. מפנים את סדרת הנתונים המוסתרת כמקור של הסמנים. אפשר להוסיף כמה סדרות של נתונים מוסתרים שרוצים, ולהשתמש בהם כדי להוסיף סמני תרשימים.

זהו התרשים שתיארנו קודם:

cht=bvg
chd=t1:30,10,20|60,40,50
chm=D,0033FF,1,0,5,1

 

סוגי תרשימים

הנה רשימה של סוגי סמנים וסוגי התרשימים שבהם ניתן להשתמש:

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

הנה כמה דוגמאות לסוגי תרשימים מורכבים שאפשר ליצור:

סוג תרשים	תיאור	דוגמה
תרשימים של סמני קו	ניתן להשתמש בסמני קו כדי להציג מגמות בסוגי תרשימים רבים אחרים.
תרשימי פמוט	תרשימי פמוט משמשים בדרך כלל להצגת נתונים פיננסיים.
תרשימי תיבה	תרשימי תיבה משמשים להצגת נתונים שמקובצים לפי רבעונים של טווח.
תרשימים מוטמעים	אפשר להטמיע תרשים בתוך תרשים אחר.
סמנים אחרים	אפשר להסתיר נתוני סמנים בכל אחד מסוגי תרשימי הבסיס הקבילים, ולהשתמש בהם עם כל סוג אחר של סמנים.	chd=t1:   10,20,30,40,50,60,70,80   5,10,15,20,25,30,35,40,45,50 chm=o,000000,1,-1,5

חזרה למעלה

 

תרשימים של סמני קו

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

סוג הבסיס + סוג הסמן	תיאור	דוגמה
בר + קו	כאן מוצג תרשים עמודות עם קו מעקב. שתי סדרות הנתונים הראשונות משמשות לעמודות המוערם, ושאר הסדרות משמשות ליצירת הקו. chd=s2 מציין שבתרשים יש להשתמש רק בשתי הסדרות הראשונות של העמודות. הקו משתמש בסדרה השלישית לנתונים. chd=s2:1XQbnf4,EWoQMUB,9halxp9 - קידוד פשוט, שבו שתי הסדרות הראשונות משמשות לציור העמודות והסדרה האחרונה משמשת את הקו. chm=D,0033FF,2,0,5,1 - קו מעקב (D), כחול, נתונים מאינדקס 2 של סדרה, כל הנקודות (0), קו ברוחב 5 פיקסלים ובסדר z של 1.	chm=   D,0033FF,2,0,5,1 chd=s2:   1XQbnf4,   EWoQMUB,   9halxp9
פיזור וקו	אפשר להוסיף קו לתרשים פיזור כדי להציג ממוצעים. לתשומת ליבכם: תרשימי פיזור מסתירים את נתוני הסמנים בדרך אחרת. פרטים נוספים זמינים במאמר תרשימי פיזור.	chd=t:   12,16,16,24,26,28,41,51,66,68,13,45,81|   16,14,22,34,22,31,31,48,71,64,15,38,84 chm=   o,0000FF,0,-1,0|   o,FF0000,0,0:9:,5|   D,000000,1,10:,1,-1
בר + קו	כאן מוצג תרשים עמודות מוערם נוסף עם קו עצמאי מעליו.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=D,76A4FB,2,0,3
עמודה + עיגולים	זהה לתרשים הקודם, אבל עם סמני עיגול במקום סמני קו. ציינו כל ערך נתונים של 0.5, שמוסיף נקודות ביניים מחושבות בקו המקווקו.	cht=bvs chd=t2:   0,10,20,30,20,70,80|   0,20,10,5,20,30,10|   10,0,20,15,60,40,30 chm=o,76A4FB,2,-.5,10

חזרה למעלה

 

תרשימי פמוט

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

סוג הבסיס + סוג הסמן	תיאור	דוגמה
קו (מוסתר) + פמוט	בדוגמה הזו מוצג תרשים שבו מוצגים רק סמני פמוט. chd=t0 - המשמעות של 0 היא שכל סדרות הנתונים מוסתרות מסוג התרשים הבסיסי (כאן, תרשים קו), ולכן משורטטים רק את הפמוטים. הערך הראשון והערך האחרון בכל סדרה הם -1 כדי לציין ערכים חסרים, וכך להימנע מציור של הפמוט הראשון או האחרון, דבר שיסתיר את שולי הציר או את שולי התרשים וייחתך. chm=F,0000FF,0,-1,20 - F מציין סמני פמוט (במקור 'סמנים פיננסיים'); 0000FF פירושו שהסמנים כחולים כאשר הערך יורד; 0 מציין שנתוני הפמוט מתחילים מסדרה 0; -1 מציין סמנים בכל הנקודות (אפשר גם לציין כאן 0:4 כדי להסתיר את הסמנים של פמוט הנר הראשון והאחרון במקום להשתמש בערכי הנתונים של 20.-1	cht=lc chd=t0:   -1,5,10,7,12,-1|   -1,25,45,47,24,-1|   -1,40,30,27,39,-1|   -1,55,63,59,80,-1 chm=F,0000FF,0,-1,20
קו + פמוט	הנה דוגמה לתרשים קו עם סמני פמוט. מוצגות חמש סדרות נתונים. הראשונה משמשת לסוג התרשים (קו), וסדרות הנתונים ה'מוסתרות' הנותרות משמשות לסמני פמוט. הפרמטר chd=t1 מציין שנעשה שימוש רק בסדרה הראשונה לאותו סוג תרשים (תרשים קו). השמטנו את סמני הפמוט הראשון והאחרון באמצעות הערך 1:4 בערך <which_points>, מפני שהפמוט הראשון והאחרון נחתכים על ידי גבולות האזור של התרשים. הפרמטר chm מציין את סמני הפמוט, עם התחביר F,<declining_color>,<data_series_index>,<which_points>,<width>,<order>	cht=lc chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20
קו + פמוט	דוגמה נוספת לתרשים פמוט, אבל עם צבעי מילוי מותאמים אישית.	chd=t1: t1:   90,80,70,50,40,30,20,10|   0,5,10,0,5,10,0|2,15,20,5,15,40,0|   5,35,20,2,35,20,0|   15,40,30,15,40,50,0 chm=   F,000000,1,1:-2,20
בר + פמוט	בהמשך מוצגת דוגמה לתרשים עמודות עם סמני פמוט. כאן אנחנו מציגים את סמני הפמוט הראשון והאחרון, כי בין העמודות יש רווחים מספיקים כדי למנוע חיתוך שלהם בהתאם לגבולות התרשים.	cht=bvg chd=t1:   20,10,15,25,17,30|   0,5,10,7,12,6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,6 chm=   F,,1,1:4,20

חזרה למעלה

 

תרשימי קופסה

תרשימי תיבות, שנקראים גם תרשימי תיבה או תרשימי תיבה, הם סוג של תרשים שמציג קיבוץ של סדרה אחת או יותר לרבעונים (רבעונים הם קבוצות שמשתרעות על פני 25% מטווח הערכים, למעט ערכים חריגים). תרשימי 'תיבה' דומים לתרשימי פמוט, אלא שיש בהם סמנים נוספים לחלק התחתון ולחלק העליון של הפמוט, וכן סמן של האחוזון ה-50.

תרשים תיבה מורכב לגמרי מסמנים, כפי שמוצג כאן:

chm=   F,0000FF,0,1,10	chm=   H,0000FF,0,1,1:10|   H,0000FF,3,1,1:10|   H,0000FF,4,1,1:10	chm=   o,FF0000,5,,5|   o,FF0000,6,,5
קבוצה אחת של סמני פמוט (chm=F) לגוף התיבות:	קבוצה אחת של סמני צורה של קו אופקי באורך ניתן להתאמה (chm=H) עבור הקווים באחוזון המינימום, ה-50 וה-100:	אפשר גם להוסיף סמני צורה של עיגול (chm=o) כדי להציג יוצאי דופן במערך הנתונים.	מחברים את כולם יחד ומקבלים תרשים תיבה!

סוג תרשים הבסיס לתרשימי תיבה הוא כל אחד מסוגי תרשים העמודות (bhs, bvs, bhg, bvg) או סוגי תרשים קו (lc, ls, lxy). אבל אם מסתירים את סוג תרשים הבסיס על ידי הוספת אפס בפרמטר של פורמט הנתונים (לדוגמה: chd=t0: או chd=s0:), לא חשוב איזה סוג תרשים בוחרים.

תרשים תיבה חייב לכלול לפחות חמש סדרות נתונים: ארבעה לתיבות ומספר הסמנים המקסימליים והמינימליים; אחת לסמן 50%; וכן סדרת נתונים נוספת, לסמנים נוספים, כמו סמנים קיצוניים. ריכזנו כאן את הסדר המומלץ של הסדרה. לתשומת ליבך, אם הערך בסדרה 1 גבוה מהערך התואם בסדרה 2, התיבה תמלא את צבע הסמן chm=F. אם הערך בסדרה 1 נמוך מהערך שבסדרה 2, התיבה לא תמלא. למידע נוסף, ראה סמני פמוט.

סדר הספרים בסדרה שלא מולאה:

0. הגעת לערך המינימלי
1. סמן 25% (75% לתיבה שמולאה)
2. סמן 75% (25% לתיבה שמולאה)
3. הגעת לערך המקסימלי
4. סמן 50%
5. נתונים מסדרה שש ואילך מיועדים לנתוני סמנים נוספים, כגון יוצאים מן הכלל.

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

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

תיאור	דוגמה
זהו תרשים תיבה סטנדרטי, אבל הצבעים בו מוקצים לרכיבים השונים בתרשים כדי להדגיש את הסמן שמשמש ליצירה של כל רכיב בתרשים. cht=bvs – הסוג של תרשים הבסיס הוא bvs, אבל לא מוצגות עמודות מתרשים הבסיס הזה בפועל. יכולנו לציין כאן כל סוג של תרשים מורכב. chd=t0: - t0 מסתיר את כל הקווים בתרשים הקו הזה. כל הנתונים ישמשו לסמנים בלבד. בנתונים, הערך הראשון והערך האחרון הם -1, כדי למנוע סמנים שחופפים לקצה השמאלי והימני של התרשים. כל הערכים בסדרה השנייה נמוכים מהערכים התואמים בסדרה השלישית, ולכן כל התיבות לא מולאו. -1,5,10,7,12,-1 - הערך המינימלי: הנקודה התחתונה של מקלות כתומים נמוכים יותר, וגם גובה הקווים הירוקים האופקיים. -1,25,30,27,24,-1 - ערך של 25%: הקצה האופקי התחתון של תיבות כתומות. -1,40,45,47,39,-1 - ערך של 75%: הקצה האופקי העליון של תיבות כתומות. -1,55,63,59,80,-1 - הערך המקסימלי: הנקודה העליונה של המקלות הכתומים העליונים; וגם גובה הקווים הכחולים האופקיים. -1,30,40,35,30,-1 - קווים 'חציוניים' אופקיים בצבע שחור בתוך הפמוטים. -1,-1,5,70,90,-1 - נתונים חיצוניים (מעגלים אדומים) -1,-1,-1,80,5,-1 - נתוני חריגים נוספים (מעגלים אדומים). נתוני הגורמים החריגים מתחלקים לשתי קבוצות כי לא ניתן לציין באותה סדרה שני סמנים – אחד מעל השני, בלי להשתמש בקיזוזים או בטריקים מסובכים אחרים. chm= - נתוני סמנים, כפי שמתואר בהמשך: F,FF9900,0,1:4,40 - סמני פמוט כתומים (F) באמצעות ארבע סדרות נתונים המתחילות מהסדרה הראשונה (0), בנקודות 1-4, בגודל 40. H,0CBF0B,0,1:4,1:20 - סמני קו אופקי ירוקים שמראים את הערך המינימלי. הן מגיעות מהסדרה הראשונה. H,0000FF,3,1:4,1:20 - סמני קו אופקי כחולים שמציגים את הערך המקסימלי. הן מגיעות מסדרה 3. H,000000,4,1:4,1:40 - סמני קו אופקי שחורים שמייצגים את הערך 50%. הן מגיעות מסדרה 4. o,FF0000,5,-1,7 - עיגולים אדומים שהוקצו לסדרת הנתונים השישית ליוצאים מן הכלל. סמנים מוקצים לכל הרכיבים בסדרה הזו, שבהם נעשה שימוש ב- -1 לתיבות ללא יוצא מן הכלל. o,FF0000,6,-1,7 – עוד יוצאי דופן. נדרשת סדרת נתונים נוספת כדי לקבץ ערכים חריגים זה על זה, סביב אותה תיבה.	cht=bvs chd=t0:   -1,5,10,7,12,-1|   -1,25,30,27,24,-1|   -1,40,45,47,39,-1|   -1,55,63,59,80,-1|   -1,30,40,35,30,-1|   -1,-1,5,70,90,-1|   -1,-1,-1,80,5,-1 chm=   F,FF9900,0,1:4,40|   H,0CBF0B,0,1:4,1:20|   H,000000,4,1:4,1:40|   H,0000FF,3,1:4,1:20|   o,FF0000,5,-1,7|   o,FF0000,6,-1,7
בתרשים מסוג LC תמיד יוצגו קווים של ציר. כדי ליצור תרשים בלי קווי ציר, צריך לציין סוג תרשים של ls.	cht=lc    cht=ls
כדי ליצור תיבה שמולאה, צריך לוודא שהנקודה בסדרה השנייה תהיה גדולה מהנקודה המתאימה בסדרה השלישית. הערך הגדול יותר מסומן באדום בקוד שמוצג משמאל.	chd=t0:   -1,5,10,7,12,-1   -1,40,30,27,24,-1   -1,25,45,47,39,-1   -1,55,63,59,80,-1

חזרה למעלה

 

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

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

חזרה למעלה

 

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

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

סמני קווים 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

חזרה למעלה

סמני צורות 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, ולכן הוא משורטט ראשון. היהלום מצוין וציור שני, וכתוצאה מכך הוא משורטט על גבי העיגול.	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=F [סרגל, קו]

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

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

• סדרה 1 ו-4 מציינים את החלק התחתון והחלק העליון של הקו האנכי, בהתאמה. בדרך כלל הם מייצגים את הערכים הנמוכים והגבוהים של היום.
• סדרה 2 ו-3 מציינים את הגבולות האנכיים של המלבן. סדרה 2 היא ערך הפתיחה וסדרה 3 היא ערך הסגירה. צבע המלבן יהיה גבוה יותר: כשערך הפתיחה (סדרה 2) נמוך מערך הסגירה (סדרה 3), המחיר עלה והמלבן מאוכלס בירוק מלא כברירת מחדל. כשערך הפתיחה (סדרה 2) גבוה מערך הסגירה (סדרה 3), המחיר ירד והמלבן התמלא באדום מלא כברירת מחדל. אפשר לציין למלבן רק צבע מילוי שהערך שלו יורד. כשמציינים זאת, המלבן עם הערך ההולך וגדל לא מולא (ריק). חשוב לשים לב שסדרה 2 יכולה להיות בחלק העליון או בחלק התחתון של המלבן, בהתאם לעלייה או לירידה במחיר.

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

הערה: אם לא רוצים שהקווים של הנתונים שישמשו לשרטוט יופיעו בתרשים, צריך להוסיף 0 אחרי סוג הפורמט. לדוגמה: chd=t0:10,20,30,40 במחרוזת נתונים של פורמט טקסט. מידע נוסף זמין בתרשימים מורכבים.

לדוגמה, הצגת השורות בכל סדרה:

תחביר

chm=
  F,<opt_declining_color>,<data_series_index>,<opt_which_points>,<width>,<opt_z_order>

F

מציין שזהו סמן של פמוט.

<opt_declining_color>

[אופציונלי] צבע המילוי של המלבנים כאשר הערך יורד (כאשר הערך של סדרה 2 > הערך של סדרה 3 המתאימה). זהו מספר הקסדצימלי בפורמט RRGGBB. כשהערכים יעלו, המלבן יהיה ריק. ברירת המחדל היא ירוק מלא עבור עלייה, אדום מלא עבור ירידה (לא ניתן לציין צבע מילוי מותאם אישית עבור העלאת ערכים).

<data_series_index>

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

<opt_what_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

<width>

הרוחב של כל המלבנים, בפיקסלים.

<opt_z_order>

[אופציונלי] השכבה שבה יש לצייר את הסמן, בהשוואה לסמנים אחרים ולכל שאר האלמנטים בתרשים. זהו מספר נקודה צפה (floating-point) מ-1.0- עד 1.0, כולל, כאשר -1.0 הוא החלק התחתון ו-1.0 הוא החלק העליון. רכיבי תרשים (קווים ועמודות) נמוכים מאפס. אם לשני סמנים יש ערך זהה, הם ישורטטו לפי הסדר שנקבע על ידי כתובת ה-URL. ערך ברירת המחדל הוא 0.0 (מעל רכיבי התרשים).

 

דוגמאות

תיאור	דוגמה
דוגמה לסמני פמוט בתרשים קו עם ארבע סדרות. צבע המילוי המותאם אישית 0000FF (כחול) צוין, והצבע הזה משמש למילוי המלבנים כאשר הנקודה בסדרה 3 קטנה מהנקודה המקבילה בסדרה 2. המלבן הראשון והמלבן האחרון נחתכים על ידי התרשים. כדי לבטל את הערכים האלה, אפשר לציין 1:4 עבור הפרמטר הרביעי של chm. יש לשים לב לאפס במחרוזת הנתונים כדי להסתיר את השורות של הסדרה: chd=t0. האפשרות הזו מציינת שכל נתוני התרשים נועדו לשמש לסמנים. הפרמטר <which_point> ריק, והמערכת מושכת פמוטות בכל נקודות הנתונים.	chd=t0:   0, 5,10, 7,12, 6|   35,25,45,47,24,46|   15,40,30,27,39,54|   70,55,63,59,80,60 chm=F,0000FF,0,,20
בהמשך מוצגת דוגמה לאותו תרשים, תוך שימוש בצבעי ברירת המחדל והסרת הפריט הראשון והפריט האחרון. זהו תרשים מורכב: שילוב של תרשים קו (סוג תרשים הבסיס) וסמני פמוט. המשמעות של 1 בעמודה cht=t:1 היא שכל סדרות הנתונים שמופיעות אחרי הסדרה הראשונה צריכות להיות מוסתרות מסוג התרשים הבסיסי (תרשים קו). המשמעות של הערך 1 הראשון ב-chm=F,,1,1:4,20 היא שנתוני הפמוט מגיעים מסדרות 2, 3, 4 ו-5 (ה-1 מבוסס על אפס). בקטע תרשימים מורכבים מוסבר איך לשרטט תרשים מורכב כזה.	cht=lc chm=   F,,1,1:4,20 chd=t1:   15,40,30,27,39,54|   ...

חזרה למעלה