בדף הזה מתועדים פרמטרים של LookML להוספת קו ייחוס למשבצת של מרכז שליטה ב-LookML. הם פועלים בכל התרשימים, חוץ מתרשימי עמודות ובתרשימים שבהם הערך של swap_axes הוא true.
קווי ייחוס מאפשרים להציב קווים ואזורים בכל תרשים קרטזיאני ב-Looker. אפשר להשתמש בערכים סטטיים או בפונקציות סטטיסטיות מסוימות שמחושבות מנתוני התרשים.
הגדרות אישיות
אפשר לציין קווי ייחוס כאפשרות בהגדרת לוח הבקרה לתרשימי פיזור, שטח, קו, עמודות ועמודות אופקיות ב-Looker.
בשלב הזה, יש תמיכה בקווי ייחוס רק בסדרה הראשונה של התרשימים האלה.
אפשר להוסיף מספר בלתי מוגבל של קווי ייחוס לכל תרשים.
אפשרות ההגדרה reference_lines מקבלת מערך של קווי ייחוס, וכל פריט הוא גיבוב של אפשרויות.
לדוגמה, ההגדרה הבאה יוצרת קו ייחוס בצבע אדום עם התווית 'יעד מכירות' בערך 90 בציר ה-y:
reference_lines:
- value: 90
label: Sales Goal
color: crimson

ציור קו קבוע
value הוא שדה החובה היחיד לשורת הפניה. הוא מציין איפה לצייר את ההפניה.
כדי לצייר קו יחיד בסימן '50' בתרשים, מציינים את ההגדרה באופן הבא:
reference_lines:
- value: 50
חישובי ערכים
במקום לציין מספר בשדה של ערך קו ההשוואה, אפשר לציין שם חישוב.
כל חישובי הערכים מבוססים על מערך הנתונים שמוחזר מהשאילתה, ולא על מערך הנתונים המלא.
-
median– ערך החציון של מערך הנתונים. -
mean– הערך הממוצע של מערך הנתונים. -
max– הערך המקסימלי במערך הנתונים. -
min– הערך המינימלי במערך הנתונים. -
deviation- סטיית התקן של מערך הנתונים. -
variance– השונות הסטטיסטית של מערך הנתונים.
כדי לשרטט קו בערך החציון של מערך הנתונים, מציינים את זה.
reference_lines:
- value: median
כדי לשרטט שלוש שורות, אחת בחציון, אחת בערך קבוע ואחת במקסימום, מגדירים את ההגדרה כך:
reference_lines:
- value: median
- value: 25
- value: max
ציור של אזור
במקום לציין מספר יחיד או שם חישוב עבור קו ההפניה, אפשר לספק מערך.
אם המערך שצוין מכיל בדיוק שני ערכים, המערכת מתייחסת אליו כאל גבולות של טווח.
reference_lines:
- value: [60, 90]
label: Butter Zone
color: orange

ההגדרה הבאה יוצרת הצללה לאזור שמייצג אזור שבו נקודות הנתונים גבוהות מהממוצע.
reference_lines:
- value: [max, mean]
label: Above Average

שורות ושגיאות
אפשר לספק מערך של שלושה מספרים או שמות של חישובים לפרמטר value.
במקרה כזה, הערך הראשון נחשב לשגיאה 'מתחת' לקו הייחוס, הערך האמצעי נחשב לערך של הקו עצמו, והערך השלישי נחשב לשגיאה 'מעל' לקו הייחוס.
error below, reference line value, error above
נניח שיעד המכירות שלכם הוא 60 יחידות, אבל טווח של 5 יחידות יותר או פחות הוא טווח מקובל. אפשר להמחיש את זה בתרשים כזה:
reference_lines:
- value: [5, 60, 5]
label: Target Sales

כך אפשר לציין את הממוצע עם סטיית התקן:
reference_lines:
- value: [deviation, mean, deviation]

תוויות
אפשר להוסיף מאפיין label כדי לתייג את השורה עם טקסט שתבחרו.
reference_lines:
- value: 90
label: Sales Goal
אתם יכולים לבחור לכלול ערכים מחושבים בתווית, גם אם אתם לא משתמשים בהם בתרשים.
מזינים את שם החישוב בתוך סוגריים מסולסלים כפולים: {{median}}. אם עושים את זה, צריך להוסיף גרשיים סביב מחרוזת התווית.
reference_lines:
- value: 50
label: "Target (Average: {{mean}})"

צבעים
אפשר לכלול מאפיין color כדי להגדיר את הצבע של הקו והטקסט.
ערכי הצבע יכולים להיות מחרוזת הקסדצימלית כמו #2ca6cd או מחרוזת של שם צבע ב-CSS.