Signal Viewer – מדריך למשתמש

Signal Viewer מציג סיגנלים מוקלטים – ריצות ניסוי, לוגי טיסה, תוצאות סימולציה – כגרפים שאפשר להגדיל, למדוד ולהשוות. הכל רץ על המחשב שלך; שום דבר לא נשלח החוצה.

1. התחלה

• Windows: מתקינים את SignalViewer-Setup-X.Y.Z.exe (למשתמש שלך בלבד, בלי הרשאות מנהל), או מחלצים את ה־.zip הנייד ולוחצים פעמיים על Signal Viewer.bat.
• Linux / macOS: מחלצים את ה־-portable.7z ומריצים את SignalViewer/SignalViewer.
• המסך הראשון מציע דוגמאות (טיסת רחפן, אותה משימה פעמיים, שלוש ריצות רכב, לוג ArduPilot). לחיצה אחת פותחת דוגמה מוכנה לצפייה – הדרך המהירה ביותר להכיר את האפליקציה.

2. פתיחת קבצים

• + פתיחת קבצים ברשימת הקבצים (Ctrl+O), או גרירת קבצים לחלון. נקראים ישירות: CSV וטבלאות טקסט, MATLAB ‏.mat, ArduPilot ‏.bin, PX4 ‏.ulg, MAVLink ‏.tlog, ROS 2 ‏.mcap, HDF5 ו־Parquet.
• מסייר Windows: קליק ימני על קובץ ← פתח באמצעות ← Signal Viewer. אם האפליקציה כבר פתוחה, הקובץ נפתח בה.
• Ctrl+P (אחרונים ומועדפים) מציג את הקבצים והתיקיות שעבדת איתם לאחרונה.
• CSV במבנה לא רגיל: מסמנים הצגת הגדרות ייבוא לפני הפתיחה בחלון הפתיחה ובוחרים מפריד, עמודת זמן ושורת כותרות, עם תצוגה מקדימה חיה.

כל קובץ מקבל צבע ותג קצר (A, B, C…), כך שסיגנלים באותו שם מכמה קבצים מובחנים זה מזה.

3. המסך

• בצד: הלוחות – נתונים (הקבצים הפתוחים והסיגנלים שלהם), יצירת סיגנלים, השוואת ריצות, דוח, ובלוגי טיסה גם לוג טיסה וצי.
• במרכז: הגרפים של הטאב הנוכחי. הטאבים למעלה; כפתור הפריסה (1 × 1) מחלק טאב לשורות ועמודות.
• למטה: ציר הזמן – ניגון, הזמן המוצג, הסמן. הזמן כתוב בשניות כפי שהוקלטו, כמו בצירים; בהגדרות (גלגל השיניים, Ctrl+,) אפשר לבחור שעון מתחילת ההקלטה, וגם ערכת נושא וגודל טקסט.
• בצד השני: חלונית הפרטים – ערכים בסמן, סטטיסטיקה, הגדרות הסיגנל הנבחר.

4. גרפים

• לחיצה על סיגנל ברשימה מוסיפה אותו לגרף הפעיל (זה עם המסגרת הצבעונית), או גוררים אותו לכל גרף. שחרור על הקצה הימני או התחתון של גרף יוצר שם גרף חדש.
• הכפתור שליד כותרת הגרף (זמן ▾) מחליף את סוג הגרף: זמן, X-Y, XYZ, מפה, תלת־ממד, FFT, ספקטרוגרם, מעטפת (הרבה ריצות של אותו גודל), וידאו.
• קליק ימני על שבב במקרא: ציר ערכים שני, הצגה כמצבים, הזזה, הסרה…
• קליק ימני בתוך הגרף: סמן כאן, הערה כאן, הזום הקודם, הצגת הכל, ייצוא הנתונים, שמירה או העתקה של התמונה, גבולות צירים.

5. זום ותזוזה

פעולה	תוצאה
גרירה על גרף	זום לטווח הזמן הזה
גלגלת	זום סביב המצביע (Shift: ערכים בלבד, Ctrl: שניהם, Alt: זמן בלבד)
גלגלת מעל ציר	זום בציר הזה בלבד
Alt + גרירה, או גרירה בכפתור האמצעי	תזוזה לאורך ציר הזמן
לחיצה כפולה, או R	הצגת הכל
Backspace	הזום הקודם

כש־Link X פעיל (ברירת המחדל) כל הגרפים בטאב מציגים את אותו זמן; Link Y עושה אותו דבר לערכים.

6. מדידה

• רווח מדליק את הסמן; לחיצה ממקמת אותו; ← → זזים דגימה אחר דגימה.
• D מוסיף סמן שני: חלונית הפרטים מראה את ההפרש ואת הסטטיסטיקה ביניהם (מינימום, מקסימום, ממוצע, RMS…).
• מציבים את הסמן על רגע ולוחצים N כדי לכתוב שם הערה; עם שני סמנים ההערה מכסה את הזמן שביניהם (מוצלל). ההערות מופיעות בכל גרף זמן ובדוח.

7. השוואת ריצות

• פותחים את הריצות יחד; כל סיגנל מוצג פעם אחת לכל קובץ, בצבע הקובץ.
• השוואת ריצות משווה כל סיגנל לריצת בסיס (או לממוצע הריצות): RMS והפרש מרבי, מתאם, טולרנס; הטבלה שלה מציגה כל סיגנל שנמצא בשני קבצים או יותר, הגרוע ביותר ראשון.
• ריצות שהוקלטו בהיסט זמן: קליק ימני על קובץ ← יישור זמן מול קובץ אחר.
• העבודה שעשיתם על קובץ אחד, לקובץ אחר: קליק ימני על הקובץ שעבדתם עליו ← העתקת העבודה לקובץ אחר…, בוחרים קובץ שכבר פתוח או קובץ לפתיחה, ומה להעתיק: השינויים (ƒ), הסיגנלים שנוצרו ממנו, הסיגנלים שלו בגרפים (על אותם גרפים להשוואה, ליד כל גרף באותו טאב, או בעותק של כל טאב) - כל אחד מהם. אפשר לחזור על זה לקובץ שלישי ורביעי.
• ביטול העבודה של קובץ אחד בלבד: קליק ימני עליו ← ניקוי הקובץ הזה: הסיגנלים שלו מחוץ לגרפים, ביטול השינויים שלו, מחיקת הסיגנלים שנוצרו ממנו - אחד מהם או כולם. שאר הקבצים שומרים על שלהם.
• לשמור על הקבצים יחד עם שני כפתורי הקישור בראש רשימת הקבצים: קישור גרפים (סיגנל שנוסף או הוסר בקובץ אחד נוסף או מוסר בכולם) וקישור פעולות (שינוי של סיגנל, או סיגנל חדש שנוצר ממנו, נעשים על אותו סיגנל בכל הקבצים). כל אחד מהם פועל בנפרד.

8. יצירת סיגנלים

יצירת סיגנלים יוצרת סיגנלים חדשים מקיימים: נוסחה עם שמות הסיגנלים (Speed * 3.6, deriv(Altitude), lowpass(Roll, 5)…), מסננים, החלפת יחידות, המרות מערכות צירים, פונקציית Python משלך. הם מתנהגים כמו סיגנלים מוקלטים ונשמרים עם הסשן. עם שני סיגנלים ו־A − B הלוח גם מראה כמה רחוקים A ו־B – בסך הכל ולכל קטע של מצב, למשל מצב הטיסה (סימולציה מול טיסה, מודל מול ניסוי).

ביטוי ב-x עם סיגנלים אחרים: בכל מקום שכותבים ביטוי ב-x (שינוי הסיגנל…, או כאן סיגנל אחד ← ביטוי ב-x), סיגנל אחר נכתב לפי השם שלו: sin(x) + Speed. זה הסיגנל של אותו קובץ כמו x - בכמה סיגנלים נבחרים, הקובץ של כל אחד - כפי שנקרא מהקובץ, כך שבקבוצה שכוללת את Speed עצמו כולם רואים את אותו Speed. כשמעתיקים או מקשרים לקובץ אחר, נקרא ה-Speed של הקובץ ההוא. כדי לקחת אותו מקובץ מסוים לכולם, כותבים את שם הקובץ: x + {run_b.csv:Speed}. שם עם רווחים או סוגריים נכתב בסוגריים מסולסלים: {Speed [km/h]}.

סיגנל חדש שנוצר משני קבצים שייך לקובץ של x (או, בנוסחה, של השמות שנכתבו בלי קובץ); מקור שנכתב עם הקובץ שלו - ובסיס ההשוואה של הפרש מהשוואת ריצות - נשאר קבוע. כך, כשמעתיקים את העבודה לריצה חדשה, היא מקבלת סיגנל משלה מול אותו מקור קבוע.

9. שמירה ושיתוף

• שמירת סשן (סמל הדיסק בפינה העליונה, Ctrl+S; לפתיחה: סמל התיקייה שלידו, Ctrl+Shift+O) שומר הכל – קבצים, טאבים, גרפים, זום, הערות. בנוסף, האפליקציה משחזרת בעצמה את העבודה האחרונה כשהיא נפתחת.
• תבניות (בסרגל העליון): שמירת טאב או קבוצת טאבים כתבנית, ופתיחתה אחר כך על קבצים אחרים עם אותם סיגנלים.
• דוח: הגרפים, הסטטיסטיקה וההערות – תצוגה מקדימה באפליקציה, ושמירה כ־HTML אינטראקטיבי, PDF או Word.
• תפריט ⋯ של גרף: ייצוא הנתונים (CSV), שמירת התמונה (PNG, SVG), העתקת התמונה.
• ניקוי ▾ (בסרגל העליון): הגרפים של הטאב הזה, הטאבים האחרים, כל הטאבים, או כל העבודה על הנתונים – טאבים, הערות, סיגנלים נגזרים ועריכות – כשהקבצים נשארים פתוחים. כל אחד מהם מתבטל ב־ביטול בהודעה או ב־Ctrl+Z. הכל סוגר גם את הקבצים (ושואל קודם).

10. לוגי טיסה

לוגים של ArduPilot ו־PX4 נפתחים עם תצוגות מוכנות (זוויות, קצבים, ויברציות, סוללה, GPS, מפה, ומצבי הטיסה כפסים צבעוניים) ועם בדיקת תקינות שמצביעה על מה ששווה לבדוק. הלוח לוג טיסה מציג את ההודעות, האירועים והפרמטרים.

11. נתונים חיים

חי (בסרגל העליון) עוקב אחרי קבצים שעדיין נכתבים – CSV שגדל, קובץ MATLAB שנשמר שוב ושוב – ויכול להתחבר לזרם MAVLink. מ־Python, ‏signalviewer_push.show(...) שולח מערכים ישר לאפליקציה הפתוחה.

12. כשמשהו משתבש

• עזרה ← העתקת פרטי שגיאה מעתיק את הגרסה, המערכת וסוף הלוג; מדביקים בדיווח. שום דבר לא נשלח אוטומטית.
• עזרה ← דיווח על בעיה… מעתיק את אותם פרטים ופותח בדפדפן את טופס הדיווח ב־GitHub - מדביקים אותם שם.
• עזרה ← קיצורי מקלדת (?) מציג כל מקש ותנועת עכבר.
• ב־Windows, בהפעלה הראשונה, מופיעה אזהרה על מפרסם לא מוכר: מידע נוסף ← הפעל בכל זאת.
• ב־macOS, בפעם הראשונה: קליק ימני ← Open, או פעם אחת xattr -dr com.apple.quarantine SignalViewer.