{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到從無到有打造 A I 機器人。這一章我們進入模擬世界:用 Gazebo 讓機器人在虛擬場景裡跑起來,用 R viz 二看見機器人看到的東西,最後學 launch 檔和模擬時間。", "item": 0 }
  ],
  "原理:物理模擬的時間步進與即時因子#1": [
   { "say": "先用翻頁動畫來理解物理模擬。", "item": 0 },
   { "say": "翻頁動畫是由一張張靜止畫面組成的,翻得越快、畫面越多,動作越流暢。", "item": 1 },
   { "say": "物理模擬也是一樣,把連續的時間切成很小的時間步,每一步依當下的力,算出新的速度與位置。所以模擬時間和你手錶上的時間是兩回事,模擬器想算多慢都可以,算完一步才前進一步。", "item": 1 }
  ],
  "原理:物理模擬的時間步進與即時因子#2": [
   { "say": "一個模擬步驟,到底做了什麼事?", "item": 0 },
   { "say": "典型的順序是,先讀取最新的 cmd vel;接著物理引擎依力、摩擦、碰撞,把狀態推進一個時間步;然後感測器模型產生雷達、I M U、相機資料;最後把結果發布成 topic,並發布 clock,也就是模擬時間。", "item": 1 },
   { "say": "因為所有 node 都該使用模擬時間,整個系統的時間才會一致,而且暫停模擬的時候,整個機器人系統也會跟著暫停。", "item": 1 }
  ],
  "原理:物理模擬的時間步進與即時因子#3": [
   { "say": "這張圖畫的是一個模擬的時間步。", "item": 0 },
   { "say": "從左邊看起,先讀取速度指令,然後物理步進,接著產生感測器資料,再發布 topic 與時鐘,最後模擬時間前進一個時間步,然後重複。這是一個循環,一圈一圈地跑下去。", "item": 1 }
  ],
  "原理:物理模擬的時間步進與即時因子#4": [
   { "say": "為什麼步長會影響準確度?", "item": 0 },
   { "say": "最簡單的積分是歐拉法,速度加上加速度乘時間,位置加上速度乘時間。", "item": 1 },
   { "say": "以自由落體為例,加速度是九點八,精確解一秒下落四點九公尺。如果時間步取零點一秒,十步之後算出來是四點四一公尺,比精確值少了零點四九公尺,大約百分之十。把時間步縮小到零點零一秒,誤差會縮小約十倍。", "item": 1 },
   { "say": "所以物理引擎的步長,常設在一毫秒這類很小的量級,依引擎與設定而異。但步長越小,每秒要計算的步數就越多。", "item": 2 }
  ],
  "原理:物理模擬的時間步進與即時因子#5": [
   { "say": "這是步長與誤差的曲線圖。", "item": 0 },
   { "say": "綠色的線是精確的自由落體位移,紅色是步長零點一秒的歐拉積分,你可以看到紅色的位移偏低。步長越大,離精確的綠線越遠。", "item": 1 }
  ],
  "原理:物理模擬的時間步進與即時因子#6": [
   { "say": "接著是即時因子,簡稱 R T F。", "item": 0 },
   { "say": "即時因子等於模擬時間除以實際時間。如果步長是一毫秒,每秒要算一千步,而你的電腦算完一千步花了兩秒,那 R T F 就是零點五,模擬世界比現實慢一倍。", "item": 1 },
   { "say": "R T F 小於一,本身不是錯誤,因為所有 node 用同一個模擬時鐘。但如果 Nav 二的控制頻率、感測器頻率是以模擬時間計算,而電腦負載讓時鐘抖動,行為就會和真機不同。降低負擔的方法有,關掉圖形介面、簡化場景、降低相機解析度。", "item": 1 }
  ],
  "原理:物理模擬的時間步進與即時因子#7": [
   { "say": "最後,為什麼模擬和真機不同?", "item": 0 },
   { "say": "模擬器是用數學模型取代現實。摩擦係數是設定值,馬達沒有電壓降,感測器雜訊是理想化的高斯雜訊,通訊沒有延遲和掉包。", "item": 1 },
   { "say": "所以請記住這句話:模擬可以驗證邏輯與流程,不能驗證安全。", "item": 1 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#1": [
   { "say": "好,接下來進入 Gazebo。為什麼要先模擬?", "item": 0 },
   { "say": "真機測試要充電、清場、擔心撞壞,而且一次只能一個人用。模擬器可以重複測試相同場景、快速試錯,安全地測試危險情境,像撞牆、掉線,也讓一個班級每個人都有機器人。", "item": 1 },
   { "say": "缺點是模擬和真實不同,沒有真實的馬達打滑、雷達反光問題、電源與 Wi-Fi 延遲。原則是,演算法與流程在模擬驗證,安全與參數在真機重測。", "item": 1 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#2": [
   { "say": "Gazebo 是什麼?", "item": 0 },
   { "say": "它是機器人的物理模擬器,有物理引擎、感測器模擬,還有三 D 場景。R O S 二 node 透過外掛與橋接,和模擬器交換跟真機相同的 topic,像 scan、odom、cmd vel、T F,還有 clock。", "item": 0 },
   { "say": "版本要注意,依版本而異。Humble 時代常用 Gazebo Classic,搭配 gazebo ros pkgs。", "item": 1 },
   { "say": "較新的發行版,像 Jazzy,改用新一代的 Gazebo,舊稱 Ignition,搭配 ros gz 橋接套件。Gazebo Classic 已經停止維護。", "item": 2 },
   { "say": "兩者的世界檔格式、外掛名稱、啟動指令都不同。本課程的原則是講概念,指令以 Humble 加 TurtleBot 三為例,Jazzy 請查對應文件。", "item": 2 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#3": [
   { "say": "這張模擬與真機的架構圖,是本章最重要的觀念。", "item": 0 },
   { "say": "圖裡,Gazebo 或真實機器人二選一,它們輸出相同名稱的 topic,提供給 SLAM、Nav 二、R viz 二和 rosbag 使用。", "item": 1 },
   { "say": "上層的 node,包括你的 A I node,只看 topic,不知道也不在乎下面是模擬還是真機。所以在模擬裡跑通的軟體,搬到真機時,通常只需要換掉驅動並調整參數。", "item": 1 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#4": [
   { "say": "我們用 TurtleBot 三的模擬,在 Humble 上操作一遍。", "item": 0 },
   { "say": "步驟是,先安裝 turtlebot 三的 gazebo 套件,套件名依發行版而異;接著設定機型的環境變數,機型有 burger、waffle、waffle pi;最後用 launch 啟動 turtlebot 三的世界。", "item": 1 },
   { "say": "會開啟 Gazebo 視窗,有一個放著幾根圓柱的小世界,機器人在中間。另外還有空白世界和房子等場景,名稱依套件版本而異。", "item": 1 },
   { "say": "再開一個終端機,記得 source,並設定相同的機型,然後啟動鍵盤遙控,再用 topic list 看一下。你會看到 cmd vel、scan、odom、imu、T F、clock 等 topic。", "item": 2 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#5": [
   { "say": "畫面上是前半段的指令。", "item": 0 },
   { "say": "第一行,用 apt 安裝 turtlebot 三的 gazebo 套件。", "item": 1 },
   { "say": "第二行,把機型環境變數設成 burger。", "item": 2 },
   { "say": "第三行,用 ROS 二 launch,啟動 turtlebot 三的世界。", "item": 3 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#6": [
   { "say": "後半段是在第二個終端機執行。", "item": 0 },
   { "say": "第一行啟動鍵盤遙控,用方向鍵讓機器人在 Gazebo 裡動起來。", "item": 1 },
   { "say": "第二行用 topic list,確認模擬器發布了哪些 topic。", "item": 2 }
  ],
  "Gazebo 模擬:虛擬世界裡的機器人#7": [
   { "say": "再來談模擬的效能。", "item": 0 },
   { "say": "第一個是即時因子。六十秒的模擬花了一百二十秒才跑完,R T F 就是零點五。R T F 太低,會讓控制與導航行為失真。", "item": 1 },
   { "say": "降低負擔的方法有,不開圖形介面,只執行物理伺服器、簡化場景、縮小相機解析度,以及關掉不需要的感測器。", "item": 2 },
   { "say": "如果是在虛擬機裡沒有 G P U 加速,Gazebo 和 R viz 二可能很卡,可以考慮改用實機 Ubuntu,或降低畫質。", "item": 3 }
  ],
  "RViz2:看見機器人「看到」的世界#1": [
   { "say": "接下來認識 R viz 二,看見機器人看到的世界。", "item": 0 },
   { "say": "R viz 二是 R O S 二的三 D 視覺化工具,用來看資料,包括機器人模型、T F、雷達點、地圖、路徑、代價地圖。它只是訂閱 topic 和 T F 把東西畫出來,不會控制機器人,除非你用它的工具下達目標。", "item": 1 },
   { "say": "也可以用 減 d 載入設定檔。TurtleBot 三和 Nav 二套件都附有現成設定。", "item": 2 },
   { "say": "啟動只要執行 rviz2。", "item": 3 }
  ],
  "RViz2:看見機器人「看到」的世界#2": [
   { "say": "有一個一定要懂的設定,Fixed Frame。", "item": 0 },
   { "say": "左側 Global Options 的 Fixed Frame,是整個畫面的世界座標。所有資料都要能經過 T F 轉換到這個框架,才能顯示。", "item": 0 },
   { "say": "如果要看地圖與導航,Fixed Frame 選 map。", "item": 1 },
   { "say": "如果只有里程計、沒有定位,選 odom。", "item": 2 },
   { "say": "如果畫面都沒東西,狀態列顯示 Error,很可能是 Fixed Frame 不存在,也就是沒有該框架的 T F,請看 Global Status 的訊息。", "item": 3 }
  ],
  "RViz2:看見機器人「看到」的世界#3": [
   { "say": "再看常用的 Displays,在左下角按 Add 新增。", "item": 0 },
   { "say": "RobotModel 顯示 U R D F 的機器人模型,需要 robot description。", "item": 1 },
   { "say": "TF 顯示所有座標框架與關係。", "item": 2 },
   { "say": "LaserScan 選 scan 這個 topic,大小與樣式可以調大看清楚。", "item": 3 },
   { "say": "Map 選 map 這個 topic。重要的是,Durability Policy 要設為 Transient Local,否則可能看不到,這是第二章 QoS 學過的。", "item": 4 },
   { "say": "另外還有路徑、里程計、姿態、相機影像、點雲、標記陣列等。每個 Display 的狀態會顯示 OK、Warn 或 Error,滑開可以看訊息。如果看到 Could not transform 之類,多半是 T F 或時間問題。", "item": 5 }
  ],
  "RViz2:看見機器人「看到」的世界#4": [
   { "say": "這張是 Fixed Frame 的對比圖。", "item": 0 },
   { "say": "左側設定正確,點雲正常顯示;右側把框架名稱打錯了,畫面就顯示錯誤。所以看不到東西時,第一件事就是檢查 Fixed Frame 的名字。", "item": 1 }
  ],
  "RViz2:看見機器人「看到」的世界#5": [
   { "say": "R viz 二上方的工具列,有幾個互動工具。", "item": 0 },
   { "say": "Move Camera 是移動視角。", "item": 1 },
   { "say": "2D Pose Estimate 是在地圖上指定機器人大概在哪裡、朝哪個方向,第七章會用來給 AMCL 初始位置。", "item": 2 },
   { "say": "2D Goal Pose,舊版介面叫 2D Nav Goal,是在地圖上指定導航目標,Nav 二會用,第七章也會用到。", "item": 3 },
   { "say": "Publish Point 會發布一個點到 clicked point,常用來量位置。", "item": 4 },
   { "say": "這些工具會發布 topic,按下它們之前,先想清楚機器人真的會去那裡。", "item": 4 }
  ],
  "RViz2:看見機器人「看到」的世界#6": [
   { "say": "設定可以儲存與分享。", "item": 0 },
   { "say": "從 File 選單選 Save Config,把 Display 和視角存成 rviz 檔,下次用 減 d 載入。團隊分享專案時,把 rviz 設定放進套件的 rviz 目錄,避免每個人都要重設一次。", "item": 1 }
  ],
  "RViz2:看見機器人「看到」的世界#7": [
   { "say": "最後教你用 R viz 二除錯的方法。", "item": 0 },
   { "say": "原則是由下往上檢查,比一開始全部打開容易找出問題。", "item": 1 },
   { "say": "第一步,先加 TF,看樹是否完整、箭頭是否在合理位置。", "item": 2 },
   { "say": "第二步,加 RobotModel,看模型方向與尺寸是否正確。", "item": 3 },
   { "say": "第三步,加 LaserScan,看點雲是否貼著牆。轉動機器人時,如果點雲黏在牆上,表示里程計良好;如果亂飄,表示 T F 或時間有問題。", "item": 4 },
   { "say": "第四步,再加地圖、路徑、代價地圖等上層資料。", "item": 5 }
  ],
  "launch 檔與 use_sim_time#1": [
   { "say": "好,最後一個單元,launch 檔和模擬時間。先講 use sim time,時間是最容易出錯的環節。", "item": 0 },
   { "say": "模擬時,Gazebo 會發布 clock,代表模擬世界的時間。使用模擬時間的 node,必須把 use sim time 設成 true,這樣問現在幾點時,得到的是 clock 的時間,而不是電腦的牆上時間。", "item": 0 },
   { "say": "如果有的 node 用模擬時間、有的用牆上時間,T F 的時間戳就差了一個世紀,T F 查詢會失敗。", "item": 0 },
   { "say": "症狀有這幾種。一是看到訊息說,Lookup would require extrapolation,也就是要往未來或過去外插。", "item": 1 },
   { "say": "二是 R viz 二不顯示雷達,或地圖不更新。", "item": 2 },
   { "say": "三是 Nav 二一直在等待 transform。", "item": 3 },
   { "say": "規則是整個系統一致。模擬,或是播放 bag 並加上 clock 時,所有 node 設成 true;真機時全部設成 false,那是預設值。設定方式是在 run 指令後面加參數,把 use sim time 設成 true。", "item": 4 }
  ],
  "launch 檔與 use_sim_time#2": [
   { "say": "這張是 use sim time 的示意圖。", "item": 0 },
   { "say": "圖裡,Gazebo 發布 clock,設為 true 的 node,時間一致,可以查到 T F;沒有設定的 node 使用牆上時間,就會造成 T F 錯誤。", "item": 1 },
   { "say": "另外也可以在 launch 檔以參數傳入,許多官方 launch 檔都有 use sim time 參數。要查看某個 node 的設定,用 param get。", "item": 1 }
  ],
  "launch 檔與 use_sim_time#3": [
   { "say": "launch 檔可以一次啟動整個系統。", "item": 0 },
   { "say": "R O S 二的 launch 檔用 Python 寫,也支援 X M L 和 YAML。", "item": 1 },
   { "say": "畫面上這個範例,啟動你的 node 和 R viz 二,並把 use sim time 做成可從命令列調整的參數,預設是 true。每個 node 的參數都帶入這個值。", "item": 2 },
   { "say": "檔案放在套件的 launch 資料夾,檔名建議用 xxx 點 launch 點 py。要讓 colcon 安裝它,在 setup.py 的 data files 加入一行,並在 setup.py 開頭 import os 與 glob。", "item": 3 },
   { "say": "重新 build 之後,用 ros2 launch 執行,後面可以用參數把 use sim time 改成 false。", "item": 3 }
  ],
  "launch 檔與 use_sim_time#4": [
   { "say": "這是 launch 檔的開頭。", "item": 0 },
   { "say": "匯入 LaunchDescription,這是 launch 檔的主體。", "item": 1 },
   { "say": "匯入 DeclareLaunchArgument,用來宣告 launch 參數。", "item": 2 },
   { "say": "匯入 LaunchConfiguration,用來取用參數的值。", "item": 3 },
   { "say": "匯入 Node,用來啟動 node。", "item": 4 }
  ],
  "launch 檔與 use_sim_time#5": [
   { "say": "接著是 launch 檔的主函式,與安裝設定。", "item": 0 },
   { "say": "generate launch description 這個函式,回傳要啟動的所有東西。", "item": 1 },
   { "say": "下面這一行是寫在 setup.py 裡,讓 colcon 把 launch 資料夾裡的檔案安裝起來。", "item": 2 }
  ],
  "launch 檔與 use_sim_time#6": [
   { "say": "最後是執行這個 launch 檔。", "item": 0 },
   { "say": "用 ros2 launch,指定套件 robot basics 和 launch 檔名,並在後面把 use sim time 設成 false,代表用在真機上。", "item": 1 }
  ],
  "launch 檔與 use_sim_time#7": [
   { "say": "還有一個好習慣,把參數放在 YAML 檔裡。", "item": 0 },
   { "say": "把數值放 YAML 檔,而不是寫死在程式裡。", "item": 1 },
   { "say": "檔案內容是,node 名稱 front monitor 底下的 ros parameters,有一個警告距離零點三,還有 use sim time 設為 false。", "item": 2 },
   { "say": "在 launch 檔裡以 parameters 載入這個 YAML 路徑。Nav 二和 slam toolbox 都用這種方式設定,第六、七章會看到。", "item": 3 }
  ],
  "closing": [
   { "say": "好,這一章我們認識了物理模擬的時間步與即時因子、Gazebo 的模擬與真機架構、R viz 二的使用與除錯,還有 launch 檔和 use sim time。", "item": 0 },
   { "say": "請接著完成本章的實作,並做章末小測驗。下一章見。", "item": 1, "pause": 1 }
  ]
 }
}
