תבנית:גרף/תיעוד

תיעוד הפרמטרים בדף "יחידת גרף בגרמנית" "(תרגום התעוד לאנגלית)".

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 }}
לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.	לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.

עמודות מצטברות, סיבוב כותרות בציר 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 }}
לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.	לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.
שימוש ב-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% }}
לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.

עוגה עם ערכים בפלחים או לידם

{{גרף |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 }} ערכים מוצגים מחוץ לפלח, במאוזן, גופן בגודל 19
לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.	לא ניתן להציג את הגרף באופן זמני – ההרחבה Graph להצגת תרשימים מושבתת כרגע.

עוגה עם פלחים בעומק שונה

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