תבנית:גרף/תיעוד
- תיעוד הפרמטרים בדף "יחידת גרף בגרמנית" "(תרגום התעוד לאנגלית)".
CSV2Chart
[עריכת קוד מקור]בכדי לייבא גרפים ממסמך של תוכנת גיליון נתונים או מתוכנת סטטיסטיקה ניתן לעשות שימוש בכלי ליבוא של גרפים מקבצי CSV ( CSV2Chart) CSV2WikiChart נוצר ככלי תמיכה עבור ויקיפדיה ועבור משאבי למידה של Wikiversity המכילים נתונים.
פרמטרים
[עריכת קוד מקור]|width=
- רוחב התרשים. בפיקסלים. ברירת מחדל: 150.|height=
- גובה התרשים. בפיקסלים. ברירת מחדל: 150.|type=
: סוג התרשים. ברירת מחדל: line.- line - תרשים רציף
- area - תרשים שטח
- rect - תרשים עמודות
- pie - תרשים עוגה (וכעך)
- stacked - תרשים עמודות ערימה
- stackedarea - תרשים שטח מוערם
|interpolate=
- שיטה להחלקת לתרשימי קווים ושטחים. מומלץ להשתמש ב-monotone עבור אינטרפולציה מעוקבת מונוטונית. ערכים נתמכים נוספים מפורטים בכתובת https://github.com/nyurik/vega/wiki/Marks#line.|colors=
- לוח צבעים. יש לרשום שם הצבע לערך y כמו (blue, red) (שמות צבעים: css_colors) או את קוד הצבע בפורמטים המקובלים#rgb
/#rrggbb
. הערכים צריכים להיות מופרדים בפסיקים. במידה ופרמטר זה יהיה ריק, המערכת תבחר צבעים מתוך רשימה שקיימת בה. יש להימנע מרווחים כפולים בערכי הצבעים.|xAxisTitle=
|yAxisTitle=
: - כתוביות של הצירים|xAxisMin, xAxisMax, yAxisMin, ו yAxisMax=
: ערכי מינימום ומקסימום של צירי x ו-y. הערכים מעוגלים למעלה ביחידות של 5. ניתן לבצע היפוך צירים, בשימוש בפרמטרים אלה, בקביעת הערך הנמוך ביותר ל-Max והערך הגבוה ביותר ל-Min. (פרמטרים אלה עדיין לא נתמכים עבור תרשימי עמודות)|xAxisFormat=
ו|yAxisFormat=
: קובע את העיצוב של תוויות הציר. הערכים הנתמכים מפורטים בכתובת https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#numbers עבור מספרים. לדוגמה, ניתן להשתמש בפורמט % לפלט אחוזים. עבור מפרט תאריך/שעה של ערכים נתמכים הוא https://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md,
- למשל. xAxisFormat=%d-%m-%Y עבור תוצאה 13-01-1977.
|xAxisAngle=
: מסובב את תוויות ציר ה-X בזווית שצוינה. ערכים מומלצים הם: -45, +45, -90, +90.|xType=
ו|yType=
: סוגי נתונים של הערכים: integer למספר שלם, number למספר אמיתי (נקודה צפה). date לתאריך. string לערכים סידוריים. (השתמשו ב-string כדי למנוע חזרות על ערכי ציר, כאשר יש רק כמה ערכים).|xScaleType=
ו|yScaleType=
: סוגי קנה מידה של צירי x ו-y. ערכים אפשריים: linear (סולם ליניארי) או log (סולם לוגריתמי) או sqrt (סולם שורש ריבועי). ברירת מחדל - linear.|x=
: ערכי x כרשימה מופרדת בפסיקים, לתאריכים ושעה ראו הערה ב-xType ו yType.|y=
או y1, y2, …: ערכי y עבור סדרת נתונים אחת או כמה, בהתאמה. עבור תרשימי עוגה y2 מציין את הרדיוס של המגזרים המתאימים. לתאריכים ושעה ראו הערה ב-xType ו-yType. במידה ויש ערכים שערכם 0, אין לכתוב 0, אלא להשאיר אותם ריקים, מופרדים בין פסיקים, אחרת ה-0 יוצג בתוית העמודה.|legend=
: הצג מקרא. (פועל רק במקרה של מספר סדרות נתונים).|y1Title=
,|y2Title=
, …: מגדיר את התווית של סדרת הנתונים המתאימה במקרא.|linewidths=
: רוחב קו עבור תרשימי קו או מרחק בין מקטעי העוגה עבור תרשימי עוגה.|showSymbols=
: הצג סמל בנקודת הנתונים עבור גרפי קווים, אם סופק מספר, הוא יקבע את גודל הסמל, ברירת מחדל 2.5. ניתן להגדיר עבור כל סדרת נתונים עם csv, למשל: showSymbols=1, 2, 3, 4.|symbolsShape=
: צורה מותאמת אישית לסמלים שמצוירת בנקודות של הגרפים. הצורות יכולות להיות עיגול, x, ריבוע, צלב, יהלום, ומשולשים. ניתן להגדיר עבור כל סדרה של נתונים של csv. צורות אפשריות: circle, square, cross, diamond, triangle_up, triangle_down, triangle_right, triangle_left, banana|symbolsNoFill=
: אם true סמל יהיה מלא.|symbolsStroke=
: אם נעשה שימוש בסמל "x" או באופציה "symbolsNoFill" סמל רוחב קו, ברירת מחדל 2.5|showValues=
: תוספת. פלט של ערכי y כטקסט. (כרגע נתמכים רק תרשימי עמודות ועוגה.) ניתן להגדיר את הפלט באמצעות הפרמטרים הבאים המסופקים:
name1:value1, name2:value2 |showValues=fontcolor:blue,angle:0).
- format: פרמט את הפלט למספרים, לתאריך/זמן :
- fontcolor: צבע טקסט.
- fontsize: גודל טקסט.
- offset: הזזת טקסט לפי ההיסט הנתון. (לתרשימי עמוד ועוגה)
- angle: (תרשים עוגה בלבד):
|innerRadius=
: עבור תרשימי עוגה: מגדיר את הרדיוס הפנימי ליצירת תרשים כעך.|xGrid ו yGrid=
: הצגת קווי רשת על צירי x ו-y.- הערות (Annotations):
|vAnnotatonsLine ו hAnnotatonsLine:=
הצגת קווי הערה אנכיים או אופקיים על ערכים ספציפיים, למשל.hAnnotationsLine=4, 5, 6|vAnnotatonsLabel ו hAnnotatonsLabel:=
הצגת תוויות הערות אנכיות או אופקיות עבור קווים, למשל. hAnnotationLabel = תוית1, תוית2, תוית3.
דוגמאות
[עריכת קוד מקור]קו
[עריכת קוד מקור]הגרף המינימלי ביותר שניתן לכתוב בתבנית. רק ערכי הצירים. ניתן לראות בגרף זה שבררת המחדל של סוג הגרף (type) הוא line, בררת המחדל של פרמטרים height ו width שווה ל-150 פיקסלים. ובררת המחדל של צבע הקו הראשון הוא כחול.
{{גרף |x = 1,2,3,4,5,6,7,8 |y = 10,12,6,14,2,10,7,9 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
שימו לב: ציר-Y לא מתחיל דווקא ב-0, אלא בערך הקטן ביותר בסדרת הערכים. אפשר לשנות זאת בעזרת פרמטר yAxisMin.
קנה מידה לוגריתמי
[עריכת קוד מקור]כדי ליצור גרף עם קנה מידה לוגריתמי בציר Y, משתמשים ב yScaleType=log
.
{{גרף |width=400|height=250 |type=line |yScaleType=log |yAxisMax = 10000 |x=1947,1950,1955,1960,1965,1970,1975,1980,1985,1990 |y1=12,120,130,260,400,950,1040,1500,5000,9000 |yGrid= }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
שטח
[עריכת קוד מקור]{{גרף |type = area |width = 400 |height = 100 |x = 1,2,3,4,5,6,7,8 |y = 10,12,6,14,2,10,7,9 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
- שימו לב
- ציר Y מתחיל ב-0
עמודות
[עריכת קוד מקור]{{גרף |type = rect |width = 400 |height = 100 |xAxisTitle = X |yAxisTitle = Y |x = 1,2,3,4,5,6,7,8 |y = 10,12,6,14,2,10,7,9 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
עוגה
[עריכת קוד מקור]{{גרף |type = pie |width = 100 |height = 100 |legend = מקרא |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה |y1 = 100,200,150,300,100,100,150,50,200 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
קווים מרובים
[עריכת קוד מקור]{{גרף |type = line |width = 400 |height = 100 |xAxisTitle = X |yAxisTitle = Y |legend = מקרא |x = 1,2,3,4,5,6,7,8 |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = סדרה א |y2Title = סדרה ב |colors = #0000aa,#ff8000 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
ציר Y מתחיל בערך הנמוך ביותר בכל הסדרות.
שטחים מרובים, חופפים
[עריכת קוד מקור]{{גרף |type = area |width = 400 |height = 100 |xAxisTitle = X |yAxisTitle = Y |legend = מקרא |x = 1,2,3,4,5,6,7,8 |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = סדרה א |y2Title = סדרה ב |colors = #800000aa,#80ff8000 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
עמודות מרובות
[עריכת קוד מקור]{{גרף |type = rect |width = 400 |height = 100 |xAxisTitle = X |yAxisTitle = Y |legend = מקרא |x = 1,2,3,4,5,6,7,8 |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = סדרה א |y2Title = סדרה ב |colors = #800000aa,#80ff8000 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
שטחים מצטברים, עם החלקה ובלעדיה
[עריכת קוד מקור]שימו לב לפרמטר interpolate, ששולט על ההחלקה
{{גרף |type = stackedarea |width = 400 |height = 200 |xAxisTitle = X |yAxisTitle = Y |legend = מקרא |x = 1,2,3,4,5,6,7,8 |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = סדרה א |y2Title = סדרה ב | colors = #800000aa,#80ff8000 }} |
{{גרף |width = 400 |height = 200 |xAxisTitle = X |yAxisTitle = Y |legend = מקרא |type = stackedarea |x = 1,2,3,4,5,6,7,8 |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = סדרה א |y2Title = סדרה ב |interpolate = monotone |colors = seagreen, orchid }} |
|
|
עמודות מצטברות, סיבוב כותרות בציר X
[עריכת קוד מקור]שימו לב. y1 יהיה העליון ביותר. y הגדול ביותר יהיה התחתון ביותר.
{{גרף |type = stackedrect |width = 400 |height = 200 |xAxisAngle = -90 |xAxisTitle = יעד משלוח |yAxisTitle = משלוחים, באלפי טונות |legend = מקרא |x = ים,שוק,סופר,זבל,מכולת,יצוא,צה"ל,עיבוד,פחת |y1 = 10,12,6,14,2,10,7,9 |y2 = 2,4,6,8,13,11,9,2 |y1Title = פירות |y2Title = ירקות |colors = seagreen, orchid }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
עמודות עם ערכים בעמודה או מעליה, פורמט תצוגת מספרים
[עריכת קוד מקור]- שימו לב לפרמטר showValues
{{גרף |type = rect |width = 400 |height = 200 |xAxisTitle = X |yAxisTitle = Y |x = 1,2,3,4,5,6,7,8 |y = 10,12,6,14,2,10,7,9 |showValues = fontsize:12 }} |
{{גרף |type = rect |width = 400 |height = 200 |xAxisTitle = X |yAxisTitle = Y |x = 1,2,3,4,5,6,7,8 |y = 10,12,6,14,2,10,7,9 |showValues = fontsize:15,offset:1 }} |
|
|
שימוש ב-format עבור ציר Y והמספרים המוצגים בגוף הגרף. עבור ציר Y, הפרמטר הוא yAxisFormat. עבור המספרים בגוף הגרף, רכיב format של פרמטר showValues. תיעוד של הגדרת אופן תצוגת מספרים נמצא ב-[1]. בדוגמה נעשה שימוש ב-%. שימו לב ששימוש ב-% גורם להכפלת הערכים ב-100, כkומר, כדי להציג 20% יש להזין 0.2 {{גרף |type = rect |width = 400 |height = 200 |xAxisTitle = X |yAxisTitle = Y |x = 1,2,3,4,5,6,7,8 |y = 0.10,0.12,0.06,0.14,0.2,0.10,0.7,0.9 |showValues = fontsize:15,offset:1,format:2.0% |yAxisFormat= 2.0% }} | |
|
עוגה עם ערכים בפלחים או לידם
[עריכת קוד מקור]
{{גרף |type = pie |width = 100 |height = 100 |legend = מקרא |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה |y1 = 100,200,150,300,100,100,150,50,200 |showValues = }}
|
{{גרף |type = pie |width = 100 |height = 100 |legend = מקרא |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה |y1 = 100,200,150,300,100,100,150,50,200 |showValues = angle:0,fontsize:19 }}
|
|
|
עוגה עם פלחים בעומק שונה
[עריכת קוד מקור]- סדרת הערכים הראשונה (y1) מייצגת את "רוחב" הפלחים (זווית הגזרה), והסדרה השנייה את "עומק" הפלחים, כלומר הרדיוס.
{{גרף |type = pie |width = 100 |height = 100 |legend = מקרא |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה |y1 = 100,200,150,300,100,100,150,50,200 |y2 = 7,8,9,8,8,9,10,9,5 |showValues = }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
"עוגה עם חור", "כעך" או "טבעת"
[עריכת קוד מקור]- שימו לב לפרמטר innerRadius
{{גרף |type = pie |width = 100 |height = 100 |innerRadius = 40 |legend = מקרא |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה |y1 = 100,200,150,300,100,100,150,50,200 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
רשת
[עריכת קוד מקור]פרמטרים xGrid yGrid יוצרים את הרשת. הראשון קובע את האנכי והשני קובע את האופקי.
{{גרף | width=300 | height=150 | xGrid= | yGrid= | xAxisTitle=X | yAxisTitle=Y | legend=Legend | type=line | x=1,2,3,4,5,6,7,8 | y1=10,12,6,14,2,10,7,9 | y1Title=Y1 Series | y2=2,4,6,8,13,11,9,2 | y2Title=Y2 Series | colors=#0000aa,#ff8000 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
גרף עמודות משולב
[עריכת קוד מקור]{{גרף |height = 150 |width = 200 |xAxisTitle = Year |xAxisAngle = -40 |yAxisTitle = Units of something |yAxisMin = 0 |type = rect |showValues = offset:4 |x = 2011, 2012, 2013, 2014, 2015, 2016 |y1 = 1326, 145, 203, 377, 639, 306 |y2 = , , , 226, 208, 276 |colors = blue,grey }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
גרף פיזור
[עריכת קוד מקור]גרף פיזור מבוסס על גרף line, כאשר רוחב הקו הוא 0 ולכן מוסתר. גודל הנקודות בגרף נקבע על ידי showSymbols. בדוגמה ערכו 1. שימוש בפרמטר ללא ערך יציג את הנקודות בגודל ברירית מחדל - 2.5
{{גרף |width=400 |height=200 |type=line |x=15.7,10.8,68.5,33.4,23.8,42.2,27.1,38.2,13.5,74.3 |y1=1517,970,4075,3819,2106,2919,2428,2164,1393,7603 |showSymbols=1 |linewidths=0 | xGrid= | yGrid= }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
גרף פיזור למספר סדרות
[עריכת קוד מקור]{{גרף |width=400 |xAxisTitle=X |yAxisTitle=Y |xAxisMin=0 |legend=מקרא |type=line |x=1,2,3,4,5,8,9,10 |y1=10, 12, 6, 14, 2, 10, 7,5 |y2=2,4,6,8,13,11,9,2 |y3=10,3,5,1,7,3,1,11 |y4=5,7,6,8,5,4,8,6 |linewidths=0 |showSymbols=true}}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
אחוזים
[עריכת קוד מקור]כאשר xAxisFormat
או yAxisFormat
מוגדרים ל-%
, סימן אחוז יתווסף לסולם של הציר המתאים.
- ערך של
1
שווה ל-100%. יש להוסיף נקודה עשרונית לפני אחוזים בין 0 ל-100, למשל.25
עבור 25%. - הקוד
yAxisMin=0 | yAxisMax=1
יאלץ את קנה המידה של ציר ה-y לפעול מ-0% ל-100%.
{{גרף | width = 350 | height = 350 | x = 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23 | yAxisMin = 0 | yAxisMax = 1 | yAxisFormat = % | showSymbols = | y1 = , , , .43, , , , .39, .43, .38, .38, .40, .48, .54 , .42, .47, .45, .48, .44, .41, .41, .45, .46 | y2 = .40, .377, .38, , .39, .38, .419, .55, .60, .63 | y3 = .27, .311, .31, , .26, .28, .285 | y4 = ,,,,,,, .40, .44, .42, .47, .44, .43, .42 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
מקרא חלופי
[עריכת קוד מקור]ערכי מקרא ארוכים יכולים להיראות מגושמים. אולי עדיף להשמיט את פרמטר legend ולהשתמש במקום זאת ב-תבנית:מקרא (או בתבנית דומה).
{{גרף | width=400 | height=150 | xAxisTitle=X | yAxisTitle=Y | colors=darkred, gold | type=line | x=1,2,3,4,5,6,7,8 | y1=10,12,6,14,2,10,7,9 | y2=2,4,6,8,13,11,9,2 }} {{מקרא|darkred|זה הוא מקרא ארוך שלא יראה טוב אם היה חלק מהגרף עצמו}} {{מקרא|gold|זה עוד ערך ארוך למדי.}}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
אפשר להשתמש בשמות צבעים הבאים: css_colors
הערות אופקיות
[עריכת קוד מקור]פרמטרים:
- hAnnotatonsLine ו-hAnnotatonsLabel קובעים את מיקום ותוכן התויות.
- linewidths קובע את רוחב הקוים (הקו הכתום עובה והקו הירוק הועלם)
- showSymbols symbolsShape קובעים את צורת הסמלים שמצוירים. (משולש, משולש הפוך, צלב)
{{גרף | type = line | x = 0,1,2,3 | y1 = 0,3.342,2.3423,5.32423 | y2 = 1,2.342,4.63,2.32423 | y3 = 3,1.342,2.63,6.32423 | xType = string | linewidths = 2,4,0 | hAnnotatonsLine = 4, 5, 6 | hAnnotatonsLabel = label4, label5, label6 | showSymbols = 3,3,3 | symbolsShape = triangle_up, triangle_down, cross }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.
הערות אנכיות
[עריכת קוד מקור]פרמטרים vAnnotatonsLine vAnnotatonsLabel שולטים על ההערות.
{{גרף | type = area | x = 0,1,2,3 | y1 = 3,1.342,2.63,6.32423 | y2 = 1,2.342,4.63,2.32423 | y3 = 0,3.342,2.3423,5.32423 | xType = string | colors = #ffff5ba0, #641050ff, #ffaaff00 | vAnnotatonsLine = 1, 2, 3 | vAnnotatonsLabel = label1, label2, label3 }}
לא ניתן להציג את הגרף באופן זמני –
ההרחבה Graph
להצגת תרשימים מושבתת כרגע.