[go: up one dir, main page]

לדלג לתוכן

תבנית:גרף

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

תבנית זו משתמשת ביחידה:Graph.

המידע מטה מוצג מתוך הדף תבנית:גרף/תיעוד.


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

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


ראו גם


למפתחים ראו גם שימוש בעורך של וגה

תבנית זו יוצרת גרף מתוך סדרות נתונים המוזנות לתוכה. יכולה ליצור גרף מתוך כמה סוגים: גרף רציף, גרף שטח, גרף עמודות וגרף עוגה.

פרמטרים של תבניות[עריכת נתוני תבנית]

התבנית הזאת מעדיפה עיצוב פרמטרים בתור פסקה.

פרמטרתיאורסוגמצב
סוג הגרף (קו, שטח, עמודות, עוגה)type

חייב לקבל את אחד הערכים הבאים: line, area, rect, pie, stackedrect, stackedarea. ארבעת הראשונים עבור קו, שטח, עמודות ועוגה. שני הבאים עבור עמודות ושטח כאשר סדרת ערכים אחת מוצגת מעל השנייה.

ערכים מוצעים
pie rect area line stackedarea stackedrect
דוגמה
area
מחרוזתלא חובה
xx

כותרות השנתות בציר האופקי (x), מופרדים בפסיקים

דוגמה
1980,1985,1990,1995,2000,2005,2010,2015
מחרוזתדרוש
yy

ערכי סדרת הנתונים בציר האנכי (y), מופרדים בפסיקים. עבור יותר מסדרת נתונים אחת, יש להשתמש ב־y1, y2 וכו'

דוגמה
10,12,6,14,2,10,7,9
בלתי־ידועמוצע
שם ציר xxAxisTitle

תיאור הציר האופקי, כפי שיופיע בגרף

דוגמה
זמן (שניות)
מחרוזתמוצע
שם ציר yyAxisTitle

תיאור הציר האנכי, כפי שיופיע בגרף

דוגמה
ערך ($)
מחרוזתמוצע
y1y1

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

מחרוזתלא חובה
y2y2

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

מחרוזתלא חובה
y3y3

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

מחרוזתלא חובה
y4y4

ערכי סדרת נתונים רביעית, מופרדים בפסיקים ביניהם.

מחרוזתלא חובה
y5y5

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

מחרוזתלא חובה
y6y6

ערכי סדרת נתונים ששית, מופרדים בפסיקים ביניהם.

מחרוזתלא חובה
y7y7

ערכי סדרת נתונים שביעית, מופרדים בפסיקים ביניהם.

מחרוזתלא חובה
כותרת מקראlegend

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

דוגמה
מקרא
מחרוזתלא חובה
כותרת y1y1Title

השם שיופיע במקרא לסדרת הנתונים הראשונה

מחרוזתלא חובה
כותרת y2y2Title

השם שיופיע במקרא לסדרת הנתונים השנייה

מחרוזתלא חובה
כותרת y3y3Title

השם שיופיע במקרא לסדרת הנתונים השלישית

מחרוזתלא חובה
כותרת y4y4Title

השם שיופיע במקרא לסדרת הנתונים הרביעית

מחרוזתלא חובה
כותרת y5y5Title

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

מחרוזתלא חובה
כותרת y6y6Title

השם שיופיע במקרא לסדרת הנתונים הששית

מחרוזתלא חובה
כותרת y7y7Title

השם שיופיע במקרא לסדרת הנתונים הששית

מחרוזתלא חובה
רוחבwidth

רוחב הגרף, בפיקסלים. מספר בלבד.

מספרלא חובה
גובהheight

גובה הגרף, בפיקסלים. מספר בלבד.

מספרלא חובה
שיטת אינטרפולציהinterpolate

מיועד להחלקת גרף קו או שטח. לא בשימוש עבור עמודות או עוגה. אם לא מזינים, הגרף ישורטט ללא החלקה. מקבל את אחד מהערכים הבאים: linear, step-before,step-after, basis, basis-open, cardinal, cardinal-open, monotone

ערכים מוצעים
linear step-before step-after basis basis-open cardinal cardinal-open monotone
מחרוזתלא חובה
x מינימליxAxisMin

הערך הקטן ביותר שיפיע על הציר האופקי

מספרלא חובה
x מקסימליxAxisMax

הערך הגדול ביותר שיפיע על הציר האופקי

מספרלא חובה
y מינימליyAxisMin

הערך הקטן ביותר שיפיע על הציר האנכי

מספרלא חובה
y מקסימליyAxisMax

הערך הגדול ביותר שיפיע על הציר האנכי

מספרלא חובה
פורמט תווית בציר xxAxisFormat

פורמט לערכים בציר האופקי, בעזרת [https://github.com/mbostock/d3/wiki/Formatting] ו־[https://github.com/mbostock/d3/wiki/Time-Formatting].

דוגמה
% לפלט אחוזים. %d-%m-%Y לפלט 13-01-1977.
מחרוזתלא חובה
פורמט תווית בציר yyAxisFormat

פורמט לערכים בציר האנכי, בעזרת [https://github.com/mbostock/d3/wiki/Formatting] ו־[https://github.com/mbostock/d3/wiki/Time-Formatting].

דוגמה
% לפלט אחוזים. %d-%m-%Y לפלט 13-01-1977.
מחרוזתלא חובה
סוג xxType

סוג הערכים בציר האופקי: integer למספר שלם, number למספר ממשי, date לתאריך, string עבור משתנה שמי

מחרוזתלא חובה
סוג yyType

סוג הערכים בציר האופקי: integer למספר שלם, number למספר ממשי, date לתאריך, string עבור משתנה שמי

מחרוזתלא חובה
צבעיםcolors

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

דוגמה
red, blue,orange
מחרוזתלא חובה
רוחב קוlinewidths

מספר פיקסלים. בגרף רציף: רוחב הקו; בגרף עוגה: המרווח בין פרוסה לפרוסה.

מספרלא חובה
רדיוס פנימיinnerRadius

בגרף עוגה: מגדיר גודל רדיוס פנימי (בפיקסלים) לגרף בצורת דונאט.

מספרלא חובה
הצגת ערכיםshowValues

עבור גרף עמודות (לא נערם) וגרף עוגה: הצגת ערכי סדרת הנתונים כטקסט. ניתן להזין מאפיינים לטקסט בצורה name1:value1, name2:value2 וכו' (ראו פירוט בדף התיעוד)

דוגמה
fontsize:15,fontcolor:blue,offset:1,angle:0,
מחרוזתלא חובה
רשת אנכיתxGrid

הצגת קוי רשת אנכי שמתארים את ציר ה-x. ברירת מחדל true. כך שהוא יכול להיות ריק

דוגמה
true, false
בוליאנילא חובה
רשת אופקיתyGrid

הצגת קוי רשת אופקי שמתאר את ציר ה-y. ברירת מחדל true. כך שאין צורך למלא את הפרמטר.

דוגמה
true, false
בוליאנילא חובה
מיקום קו הערה אופקיhAnnotatonsLine

מיקום קו הערה אופקית. מספרים מופרדים בפסיקים.

בלתי־ידועלא חובה
תוית הערה אופקיתhAnnotatonsLabel

תוית ההערה האופקית שתוצג בסמוך לקו. תויות מופרדות בפסיקים.

דוגמה
"תוית1", "תוית2", "תוית3"
מחרוזתלא חובה
מיקום קו הערה אנכיvAnnotatonsLine

מיקום קו הערה אנכי. מופרד בפסיקים.

בלתי־ידועלא חובה
תוית הערה אנכיתvAnnotatonsLabel

תוית ההערה האנכית שתוצג בסמוך לקו. מופרד בפסיקים.

בלתי־ידועלא חובה
תצוגת סמלshowSymbols

גודל תצוגת סמל. סדרת מספרים מפוסקת.

בלתי־ידועלא חובה
צורת סמלsymbolsShape

צורת סמל. סדרת מחרוזות מפוסקת. צורות אפשריות: circle, x, square, cross, diamond, triangle_up, triangle_down, triangle_right, triangle_left, banana

בלתי־ידועלא חובה
סמל לא מלאsymbolsNoFill

אין תיאור

בוליאנילא חובה
symbolsStrokesymbolsStroke

אין תיאור

מספרלא חובה
סוג קנה מידה xxScaleType

סוגי קנה מידה של ציר x. אפשרויות: linear (סולם ליניארי) או log (סולם לוגריתמי) או sqrt (סולם שורש ריבועי). ברירת מחדל - linear.

ערכים מוצעים
linear log sqrt
ברירת מחדל
linear
מחרוזתלא חובה
סוג קנה מידה yyScaleType

סוגי קנה מידה של ציר y. אפשרויות: linear (סולם ליניארי) או log (סולם לוגריתמי) או sqrt (סולם שורש ריבועי). ברירת מחדל - linear.

ערכים מוצעים
linear log sqrt
ברירת מחדל
linear
מחרוזתלא חובה
זויתצירxxAxisAngle

מסובב את תוויות ציר ה-X בזווית שצוינה. ערכים מומלצים הם: -45, +45, -90, +90.

דוגמה
xAxisAngle=45
מספרלא חובה