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

;תיעוד הפרמטרים בדף "[[:de:Wikipedia:Lua/Modul/Graph|יחידת גרף בגרמנית]]" "([[:de:Wikipedia:Lua/Modul/Graph/en|תרגום התעוד לאנגלית]])".

==CSV2Chart==
בכדי לייבא גרפים ממסמך של תוכנת גיליון נתונים או מתוכנת סטטיסטיקה ניתן לעשות שימוש בכלי ליבוא של גרפים מקבצי CSV (
[niebert.github.io/csv2wikichart_app/ CSV2Chart])
CSV2WikiChart נוצר ככלי תמיכה עבור ויקיפדיה ועבור משאבי למידה של Wikiversity המכילים נתונים.

== פרמטרים ==
* {{פרמטר|'''width'''}} - רוחב התרשים. בפיקסלים. ברירת מחדל: 150.
* {{פרמטר|'''height'''}} - גובה התרשים. בפיקסלים. ברירת מחדל: 150.
* {{פרמטר|'''type'''}}: סוג התרשים. ברירת מחדל: line.
** line - תרשים רציף 
** area - תרשים שטח
** rect - תרשים עמודות
** pie - תרשים עוגה (וכעך)
** stacked - תרשים עמודות ערימה
** stackedarea - תרשים שטח מוערם
* {{פרמטר|'''interpolate'''}} - שיטה להחלקת לתרשימי קווים ושטחים. מומלץ להשתמש ב-'''monotone''' עבור אינטרפולציה מעוקבת מונוטונית. ערכים נתמכים נוספים מפורטים בכתובת github.com/nyurik/vega/wiki/Marks#line.
* {{פרמטר|'''colors'''}} - לוח צבעים. יש לרשום שם הצבע לערך y כמו (blue, red) (שמות צבעים: [www.w3schools.com/cssref/css_colors.asp css_colors]) או את קוד הצבע בפורמטים המקובלים <code>#rgb</code> /<code>#rrggbb</code>. הערכים צריכים להיות מופרדים בפסיקים. במידה ופרמטר זה יהיה ריק, המערכת תבחר צבעים מתוך רשימה שקיימת בה. יש להימנע מרווחים כפולים בערכי הצבעים.
*{{פרמטר|'''xAxisTitle'''}} {{פרמטר|'''yAxisTitle'''}}:  - כתוביות של הצירים
*{{פרמטר|'''xAxisMin, xAxisMax, yAxisMin, ו yAxisMax'''}}: ערכי מינימום ומקסימום של צירי x ו-y. הערכים מעוגלים למעלה ביחידות של 5. ניתן לבצע '''היפוך צירים''', בשימוש בפרמטרים אלה, בקביעת הערך הנמוך ביותר ל-Max והערך הגבוה ביותר ל-Min. (פרמטרים אלה עדיין לא נתמכים עבור תרשימי עמודות)
* {{פרמטר|'''xAxisFormat'''}} ו{{פרמטר|'''yAxisFormat'''}} : קובע את העיצוב של תוויות הציר. הערכים הנתמכים מפורטים בכתובת github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#numbers עבור מספרים.  לדוגמה, ניתן להשתמש בפורמט % לפלט אחוזים.  עבור מפרט תאריך/שעה של ערכים נתמכים הוא 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''': פרמט את הפלט  [github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#numbers למספרים], [github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md לתאריך/זמן] :
** '''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 פיקסלים. ובררת המחדל של צבע הקו הראשון הוא כחול.

<pre>
{{גרף
 |x = 1,2,3,4,5,6,7,8
 |y = 10,12,6,14,2,10,7,9
}}
</pre>

{{גרף
 |x = 1,2,3,4,5,6,7,8
 |y = 10,12,6,14,2,10,7,9
}}
שימו לב: ציר-Y לא מתחיל דווקא ב-0, אלא בערך הקטן ביותר בסדרת הערכים. אפשר לשנות זאת בעזרת פרמטר '''yAxisMin'''.

=== קנה מידה לוגריתמי ===
כדי ליצור גרף עם קנה מידה לוגריתמי בציר Y, משתמשים ב {{קוד|1=yScaleType=log}}.
<pre>
{{גרף
|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=
}}
</pre>

{{גרף
|width=400|height=250
|type=line
|yScaleType=log
|yAxisMax = 10000
|x=1947,1950,1955,1960,1965,1970,1975,1980,1985,1990
|y=12,120,130,260,400,950,1040,1500,5000,9000
|yGrid=
}}

=== שטח ===
<pre>
{{גרף
 |type = area
 |width = 400
 |height = 100
 |x = 1,2,3,4,5,6,7,8
 |y = 10,12,6,14,2,10,7,9
}}
</pre>
{{גרף
 |type = area
 |width = 400
 |height = 100
 |x = 1,2,3,4,5,6,7,8
 |y = 10,12,6,14,2,10,7,9
}}

;שימו לב: ציר Y מתחיל ב-0

=== עמודות ===
<pre>
{{גרף
 |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
}}
</pre>
{{גרף
 |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
}}

=== עוגה ===
<pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה
 |y1 = 100,200,150,300,100,100,150,50,200
}}
</pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה
 |y1 = 100,200,150,300,100,100,150,50,200
}}

=== קווים מרובים ===
<pre>
{{גרף
 |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
}}
</pre>
{{גרף
 |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
}}
ציר Y מתחיל בערך הנמוך ביותר בכל הסדרות.
=== שטחים מרובים, חופפים ===
<pre>
{{גרף
 |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
}}
</pre>
{{גרף
 |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
}}

=== עמודות מרובות ===
<pre>
{{גרף
 |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
}}
</pre>
{{גרף
 |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
}}

=== שטחים מצטברים, עם החלקה ובלעדיה ===
שימו לב לפרמטר interpolate, ששולט על ההחלקה
{|
|-
|
<pre>
{{גרף
 |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
}}
</pre>
| 
<pre>
{{גרף
 |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
}}
</pre>
|-
|
{{גרף
 |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
}}
|
{{גרף
 |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 = סדרה ב
 |interpolate = monotone
 |colors = seagreen, orchid
}}

|}

=== עמודות מצטברות, סיבוב כותרות בציר X ===
שימו לב. y1 יהיה העליון ביותר. y הגדול ביותר יהיה התחתון ביותר.
<pre>
{{גרף
 |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
}}
</pre>
{{גרף
 |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
}}

=== עמודות עם ערכים בעמודה או מעליה, פורמט תצוגת מספרים ===
;שימו לב לפרמטר showValues
{|
|-
|
<pre>
{{גרף
 |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
}}
</pre>
|
<pre>
{{גרף
 |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
}}
</pre>
|-
|
{{גרף
 |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. תיעוד של הגדרת אופן תצוגת מספרים נמצא ב-[github.com/mbostock/d3/wiki/Formatting#numbers]. בדוגמה נעשה שימוש ב-%. שימו לב ששימוש ב-% גורם להכפלת הערכים ב-100, כkומר, כדי להציג 20% יש להזין 0.2
<pre>
{{גרף
 |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%
}}
</pre>
|-
|
{{גרף
 |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%
}}
|}

=== עוגה עם ערכים בפלחים או לידם ===
{|
|-
|
<pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה
 |y1 = 100,200,150,300,100,100,150,50,200
 |showValues =
}}
</pre>
;ערכים מוצגים בפנים, באוריינטציה היקפית
|
<pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה
 |y1 = 100,200,150,300,100,100,150,50,200
 |showValues = angle:0,fontsize:19
}}
</pre>
;ערכים מוצגים מחוץ לפלח, במאוזן, גופן בגודל 19
|-
|
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה
 |y1 = 350,200,150,300,100,100,150
 |showValues =
}}
|
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה
 |y1 = 350,200,150,300,100,100,150
 |showValues = angle:0,fontsize:19
}}
|}

=== עוגה עם פלחים בעומק שונה ===
;סדרת הערכים הראשונה (y1) מייצגת את "רוחב" הפלחים (זווית הגזרה), והסדרה השנייה את "עומק" הפלחים, כלומר הרדיוס.
<pre>
{{גרף
 |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 =
}}
</pre>
{{גרף
 |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 =
}}

=== "עוגה עם חור", "כעך" או "טבעת" ===
;שימו לב לפרמטר innerRadius
<pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |innerRadius = 40
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה
 |y1 = 100,200,150,300,100,100,150,50,200
 }}
</pre>
{{גרף
 |type = pie
 |width = 100
 |height = 100
 |innerRadius = 40
 |legend = מקרא
 |x = תפוחים,תפוזים,בננות,אגוזים,אבוקדו,אורז,חיטה,אגסים,פפאיה
 |y1 = 100,200,150,300,100,100,150,50,200
 }}

===רשת===
פרמטרים xGrid yGrid יוצרים את הרשת. הראשון קובע את האנכי והשני קובע את האופקי.
<pre>
{{גרף
 | 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
}}
</pre>
{{גרף
 | 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
}}

===גרף עמודות משולב===
<pre>
{{גרף
  |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
  }}
</pre>

{{גרף
  |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
  }}

===גרף פיזור===
גרף פיזור מבוסס על גרף line, כאשר רוחב הקו הוא 0 ולכן מוסתר. גודל הנקודות בגרף נקבע על ידי showSymbols. בדוגמה ערכו 1. שימוש בפרמטר ללא ערך יציג את הנקודות בגודל ברירית מחדל - 2.5
<pre>
{{גרף
|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=
}}
</pre>

{{גרף
|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=
}}

=== גרף פיזור למספר סדרות ===
<pre>
{{גרף
|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}}
</pre>

{{גרף
|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}}

===אחוזים===
כאשר <code>xAxisFormat</code> או <code>yAxisFormat</code> מוגדרים ל-<code>%</code>, סימן אחוז יתווסף לסולם של הציר המתאים.
*ערך של <code>1</code> שווה ל-100%.  יש להוסיף נקודה עשרונית לפני אחוזים בין 0 ל-100, למשל <code>.25</code> עבור 25%.
*הקוד <code> yAxisMin=0 |  yAxisMax=1</code> יאלץ את קנה המידה של ציר ה-y לפעול מ-0% ל-100%.

<pre>
{{גרף
| 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
}}
</pre>

{{גרף
| 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
}}

===מקרא חלופי===
ערכי מקרא ארוכים יכולים להיראות מגושמים.  אולי עדיף להשמיט את פרמטר legend ולהשתמש במקום זאת ב-[[תבנית:מקרא]] (או בתבנית דומה).
<pre>
{{גרף
 | 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|זה עוד ערך ארוך למדי.}}
</pre>

{{גרף
 | 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|זה עוד ערך ארוך למדי.}}

אפשר להשתמש בשמות צבעים הבאים: [www.w3schools.com/cssref/css_colors.asp css_colors]

===הערות אופקיות===
פרמטרים:
* hAnnotatonsLine ו-hAnnotatonsLabel קובעים את מיקום ותוכן התויות.
* linewidths קובע את רוחב הקוים (הקו הכתום עובה והקו הירוק הועלם)
* showSymbols symbolsShape קובעים את צורת הסמלים שמצוירים. (משולש, משולש הפוך, צלב)
<pre>
{{גרף
| 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
}}
</pre>

{{גרף
| 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
}}

===הערות אנכיות===
פרמטרים vAnnotatonsLine vAnnotatonsLabel שולטים על ההערות.
<pre>
{{גרף
| 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
}}
</pre>
{{גרף
| 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
}}
<includeonly>

== ראו גם ==
* <big>'''[[יחידה:גרפים]]'''</big>
* '''[[תבנית:GraphMap]]''' - מפות
* '''[[תבנית:WikidataChart]]''' - גרפים דינמיים
----

למפתחים ראו גם [vega.github.io/editor/#/ שימוש בעורך של וגה]

[[קטגוריה:חב"דפדיה - תמיכה טכנית]]
</includeonly><noinclude>{{תיעוד תבנית}}</noinclude>