יחידה:גרפים/תיעוד

זהו דף התיעוד עבור יחידה:גרפים

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

עמודות

פרמטרים

פרמטר	הסבר
תו הפרדה	כאשר פרמטר מסוים מורכב, מחרוזת זו מפרידה בין החלקים השונים. ברירת המחדל היא : (נקודתיים), אך בוויקיפדיה בעברית פעמים רבות נוח יותר להשתמש ב{{כ}}
רוחב	מספר, המתאר את רוחב הגרף בפיקסלים. ברירת המחדל היא 500
גובה	מספר, המתאר את גובה הגרף בפיקסלים. ברירת המחדל היא 350
קבוצה N	כאשר N הוא מספר, לדוגמה "קבוצה 1", "קבוצה 2" וכן הלאה. ערך הפרמטר הוא סדרת מספרים, מופרדים על ידי תו ההפרדה, שמתארים את הערכים השונים של העמודות בקבוצה
רמזים N	אפשרות להגדיר "רמז" לעמודה או עמודות מסוימות בגרף. ראו דוגמה למטה
קישורים N	אפשרות להגדיר קישורים מעמודות שונות. ראו דוגמה למטה
מאוחד	ניתן להגדיר פרמטר זה (עם ערך כלשהו) כדי להציג את העמודות בצורה מאוחדת, כלומר העמודות של הקבוצות השונות מונחות אחת על גבי השנייה.
צבעים	הגדרת צבעים לעמודות השונות. ניתן לא להגדיר, ואז הגרף יוצג עם צבעים לפי ברירת המחדל.
כותרות בציר האופקי	הכותרות לשנתות בציר X
סקאלה לכל קבוצה	שימוש בפרמטר זה, עם ערך כלשהו, יגרום לכך שלכל קבוצה תופיעה סקאלה אנכית נפרדת. לא ניתן להשתמש בפרמטר זה יחד עם "מאוחד"
קידומת יחידות	קידומת שתופיע לפני היחידות בכותרות. בהצגה, _ (קו תחתי) יוחלף ברווח. לדוגמה, $ יגרום לכך שבכותרות יופיע $100 במקום 100.
סיומת יחידות	סיומת שתופיע אחרי היחידות בכותרות. בהצגה, _ (קו תחתי) יוחלף ברווח. למשל _ק"ג יגרום לכך שבכותרות יופיע "45 ק"ג" במקום "45"
שמות הקבוצות	שמות הקבוצות השונות בגרף
סיבוב כותרות	שימוש בפרמטר זה, עם ערך כלשהו, יגרום לסיבוב הכותרות בציר האופקי 90°. עשוי להיות שימושי כשיש מספר גדול של כותרות.
הצגת הערך בעמודה	שימוש בפרמטר זה, עם ערך כלשהו, יגרום לערך המספרי להופיע בעמודה. הערך נכתב בגופן שחור, ואם משתמשים בפרמטר זה יש לשים לב להשתמש בצבעים בהירים מספיק לעמודות עצמן. אם חלק מהערכים ארוכים (כלומר דורשים ספרות רבות לכתיבתם, למשל 144.34567) יתכן שהערכים יחרגו מהעמודה - במקרה זה יש להימנע משימוש בפרמטר, משום שהערכים לא יוצגו נכון.

דוגמאות

פשוט

{{ #invoke:גרפים | עמודות
| תו הפרדה = {{כ}}
| קבוצה 1 = 40 {{כ}} 50 {{כ}} 60 {{כ}} 20
| קבוצה 2 = 20 {{כ}} 60 {{כ}} 12 {{כ}} 44
| קבוצה 3 = 55 {{כ}} 14 {{כ}} 33 {{כ}} 5
| קבוצה 4 = 33 {{כ}} 33 {{כ}} 33 {{כ}} 33
| קישורים 1 = תפוח {{כ}} תפוח#התפוח בתרבות {{כ}} דלישס
| רמזים 2 = רמז 1 {{כ}} רמז 2 {{כ}} רמז 3 {{כ}} רמז 4
| רמזים 4 = {{כ}} {{כ}} זהו שיר מאד עצוב, הנושא שלו כאוב. אם תשים תחבושת לא יעזור לך שנתיים.
| צבעים = green {{כ}} yellow {{כ}} orange {{כ}} black
| שמות הקבוצות = תפוח {{כ}} בננה {{כ}} אשכולית {{כ}} בן הרפה
| כותרות בציר האופקי = לפני {{כ}} בזמן {{כ}} אחרי {{כ}} נתיחה לאחר המוות
| סיומת יחידות = _ק"ג
}}

שימו לב ל"קישורים" ו"רמזים":

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

10

20

30

40

50

60

70

לפני

בזמן

אחרי

נתיחה לאחר המוות

תפוח
בננה
אשכולית
בן הרפה

מאוחד

אותו הגרף עצמו בצורה "מאוחדת", כלומר כאשר העמודות של הקבוצות השונות מונחות אחת על השנייה:


{{ #invoke:גרפים | עמודות
| תו הפרדה = {{כ}}
| קבוצה 1 = 40 {{כ}} 50 {{כ}} 60 {{כ}} 20
| קבוצה 2 = 20 {{כ}} 60 {{כ}} 12 {{כ}} 44
| קבוצה 3 = 55 {{כ}} 14 {{כ}} 33 {{כ}} 5
| קבוצה 4 = 33 {{כ}} 33 {{כ}} 33 {{כ}} 33
| קישורים 1 = תפוח {{כ}} אשכולית {{כ}} דלישס
| רמזים 2 = רמז 1 {{כ}} רמז 2 {{כ}} רמז 3 {{כ}} רמז 4
| רמזים 4 = {{כ}} {{כ}} זהו שיר מאד עצוב, 
הנושא שלו כאוב. 
אם תשים תחבושת לא יעזור לך שנתיים.
| צבעים = green {{כ}} yellow {{כ}} orange {{כ}} black
| שמות הקבוצות = תפוח {{כ}} בננה {{כ}} אשכולית {{כ}} בן הרפה
| כותרות בציר האופקי = לפני {{כ}} בזמן {{כ}} אחרי {{כ}} נתיחה לאחר המוות
| סיומת יחידות = _ק"ג
| מאוחד = כן
}}

50

100

150

200

לפני

בזמן

אחרי

נתיחה לאחר המוות

תפוח
בננה
אשכולית
בן הרפה

סקאלה לכל קבוצה

{{ #invoke:גרפים | עמודות
| רוחב = 800
| תו הפרדה = {{כ}}
| קבוצה 1 = 1500000 {{כ}} 2500000 {{כ}} 3500000
| קבוצה 2 = 200 {{כ}} 5000 {{כ}} 45000
| קבוצה 3 = 2000 {{כ}} 5000 {{כ}} 20000
| צבעים = red {{כ}} blue {{כ}} green
| שמות הקבוצות = אנשים {{כ}} מכוניות {{כ}} מחיר המכונית
| כותרות בציר האופקי = 1920 {{כ}} 1965 {{כ}} 2002
| רמזים 2 = {{כ}} {{כ}} אין נתונים טובים לשנה זו, המספרים נלקחו מהערכות של הד"ר רוני קרחוני
| קידומת יחידות = {{כ}} {{כ}} $
| סקאלה לכל קבוצה = 1
}}

500,000

1,000,000

1,500,000

2,000,000

2,500,000

3,000,000

3,500,000

4,000,000

10,000

20,000

30,000

40,000

50,000

2,500

5,000

7,500

10,000

12,500

15,000

17,500

20,000

22,500

25,000

1920

1965

2002

אנשים
מכוניות
מחיר המכונית

עוגה

פרמטרים

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

פרמטר	הסבר
תו הפרדה	ראו הסבר ב"עמודות"
רדיוס	מספר המתאר את רדיוס העוגה, בפיקסלים. ברירת המחדל - 150
פרוסות	רשימת הפרוסת השנות, כשכל פרוסה מוקפת בסוגריים. תוכן הפרוסה מורכב מארבעה חלקים, חלקם אופציונליים, מופרדים על ידי תווי הפרדה. החלקים הם: ערך. זהו נתון מספרי המתאר את הערך שפרוסה זו מייצגת. ניתן לכתוב את המספר בצורה נוחה להצגה, לדוגמה "1,240,000" או 1240000. אפשר להשתמש בסימון מדעי: 1.24e6. שלוש האפשרויות מייצגות את אותו המספר - מיליון ומאתיים וארבעים אלף. שם. שם זה מתאר את האובייקט שהפרוסה מייצגת צבע. נתון זה הוא אפציונלי - אם לא תבחרו צבע, ייעשה שימוש בצבע ברירת המחדל. מוגדרים 26 צבעי ברירת מחדל - אם תרצו להציג עוגה עם יותר מ-26 פרוסות, חובה להגדיר צבע לפרוסה 27 והלאה. קישור: נתון אופציונלי. שלא כמו ב"עמודות", הקישור אינו שם ערך, אלא יש להשתמש בקוד ויקי לקישור. ניתן להשתמש בקישורים פנימיים או חיצוניים, או לקשר לסעיף בערך בו מוצגת העוגה בעזרת קישור שנפתח ב-#. הרמז שיוצג כאשר מציפים את העכבר מעל לפרוסה הוא הטקסט של הקישור. דוגמה (ננית שתו ההפרדה הוא {{כ}}: \| פרוסות = ( 147 {{כ}} רובים ושושנים {{כ}} {{כ}} [[#אל תביא לי את הסעיף\|אקסל רוז מאבד את העשתונות]] ) ( 112 {{כ}} נירוונה ) התבנית מתעלמת מטקסט שמופיע בין הפרוסות השונות. ניתן לשבור את השורה אם הרשימה ארוכה.
פרוסה N	דרך אלטרנטיבית להזין את הפרמטרים. דרך זו אינה תואמת את השימוש ב"פרוסות=", ויש לבחור אחת מהשתיים. בדרך זו אין שימוש בסוגריים, ותוכן הפרוסה זהה למה שתואר לעיל. יש לתאר את כל הפרוסות, החל מ-1, ללא דילוגים. אם תגדירו "פרוסה 1", "פרוסה 2", "פרוסה 4" (בלי פרוסה 3), העוגה לא תוצג כראוי. דוגמה: \| פרוסה 1 = 147 {{כ}} רובים ושושנים {{כ}} {{כ}} [[#אל תביא לי את הסעיף\|אקסל רוז מאבד את העשתונות]] \| פרוסה 2 = 112 {{כ}} נירוונה
קידומת יחידות	קידומת שתופיע לפני הערך המספרי במקרא וברמזים. _ (קו תחתי) יוחלף ברווח. לדוגמה, $ יגרום לכך שבמקרא יופיע $100 במקום 100.
סיומת יחידות	בדומה לקידומת, אך מוצג אחרי הערך. לדוגמה _ק"ג יגרום לכך שבמקרא יופיע 100 ק"ג במקום 100
אחוזים	פרמטר אופציונלי. שימוש בו יגרום לחישוב החלק של כל פרוסה, באחוזים והצגתו בסוגריים אחרי הערך המספרי במקרא, לדוגמה, 100 (37%) במקום 100

דוגמאות

{{#invoke:גרפים|עוגה
| רדיוס = 150
| פרוסות = 
    ( 1000000 : תפוחים ) 
    ( 2000000 : בננות  : gold) 
    ( 1440000 : משמשים ) 
    ( 6.4e5 : אגסים :: [[אגס|אגסים]] )
    ( 750,000 : אננסים )
| סיומת יחידות = _טונות
| אחוזים = כן
}}

נקודות לעיון:
# הגדרנו צבע (gold) עבור בננות - שאר הפרוסות יוצגו בצבעי ברירת המחדל.
# בפרוסות שונות, נעשה שימוש בשלוש הצורות השונות להזין מספרים. במקרא המספרים יוצגו בצורה אחידה
# בפרוסה "אגסים" השתמשנו בקישור - הקשה על הפרוסה תעביר את הקוראים לערך [[אגס]]

תפוחים: 1,000,000 טונות (17.2%)
בננות: 2,000,000 טונות (34.3%)
משמשים: 1,440,000 טונות (24.7%)
אגסים: 640,000 טונות (11.0%)
אננסים: 750,000 טונות (12.9%)

זו הצורה האלטרנטיבית להגדיר פרוסות:

{{#invoke:גרפים|עוגה
|רדיוס = 200
|סיומת יחידות = _יחידות
| פרוסה 1 = 1 : 1
| פרוסה 2 = 7 : 7
| פרוסה 3 = 8 : 8
| פרוסה 4 = 9 : 9
| פרוסה 5 = 10 : 10
| פרוסה 6 = 11 : 11
| פרוסה 7  = 12 : 12
| פרוסה 8  = 13 : 13
| פרוסה 9  = 14 : 14
| פרוסה 10 = 15 : 15
| פרוסה 11 = 16 : 16
| פרוסה 12 = 17 : 17
| פרוסה 13 = 18 : 18
| פרוסה 14 = 19 : 19
| פרוסה 15 = 20 : 20
| פרוסה 16 = 21 : 21
| פרוסה 17 = 22 : 22
| פרוסה 18 = 23 : 23
| פרוסה 19 = 24 : 24
| פרוסה 20 = 25 : 25
| פרוסה 21 = 26 : 26
| פרוסה 22 = 27 : 27
| פרוסה 23 = 28 : 28
| פרוסה 24 = 29 : 29
| פרוסה 25 = 30 : 30
| פרוסה 26 = 31 : 31
| אחוזים = כן
}}

1: 1 יחידות (0.2%)
7: 7 יחידות (1.5%)
8: 8 יחידות (1.7%)
9: 9 יחידות (1.9%)
10: 10 יחידות (2.1%)
11: 11 יחידות (2.3%)
12: 12 יחידות (2.5%)
13: 13 יחידות (2.7%)
14: 14 יחידות (2.9%)
15: 15 יחידות (3.2%)
16: 16 יחידות (3.4%)
17: 17 יחידות (3.6%)
18: 18 יחידות (3.8%)
19: 19 יחידות (4.0%)
20: 20 יחידות (4.2%)
21: 21 יחידות (4.4%)
22: 22 יחידות (4.6%)
23: 23 יחידות (4.8%)
24: 24 יחידות (5.0%)
25: 25 יחידות (5.3%)
26: 26 יחידות (5.5%)
27: 27 יחידות (5.7%)
28: 28 יחידות (5.9%)
29: 29 יחידות (6.1%)
30: 30 יחידות (6.3%)
31: 31 יחידות (6.5%)