{
 "原理:座標變換與 LiDAR 測距#1": {
  "type": "flow",
  "reveal": [
   0,
   1,
   4
  ],
  "nodes": [
   {
    "label": "同一個點",
    "sub": "不同座標系數字不同"
   },
   {
    "label": "先旋轉"
   },
   {
    "label": "再平移"
   },
   {
    "label": "換算完成",
    "sub": "另一個座標系的數字"
   }
  ]
 },
 "原理:座標變換與 LiDAR 測距#2": {
  "type": "table",
  "head": [
   "項目",
   "內容"
  ],
  "rows": [
   [
    "約定",
    "機器人位置 (x, y),航向 θ 逆時針為正"
   ],
   [
    "做法",
    "旋轉矩陣乘上點,再加機器人位置"
   ],
   [
    "世界 x",
    "x + xr·cosθ − yr·sinθ"
   ],
   [
    "世界 y",
    "y + xr·sinθ + yr·cosθ"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3,
   4
  ],
  "widths": [
   0.8,
   2.4
  ]
 },
 "原理:座標變換與 LiDAR 測距#4": {
  "type": "waterfall",
  "unit": "公尺",
  "reveal": [
   0,
   1,
   4,
   4
  ],
  "items": [
   {
    "label": "機器人 y",
    "value": 1,
    "kind": "total"
   },
   {
    "label": "xr·sinθ",
    "value": 1.1
   },
   {
    "label": "yr·cosθ",
    "value": 0
   },
   {
    "label": "世界 y",
    "value": 2.1,
    "kind": "total"
   }
  ]
 },
 "原理:座標變換與 LiDAR 測距#5": {
  "type": "flow",
  "reveal": [
   0,
   4,
   5,
   5
  ],
  "nodes": [
   {
    "label": "發射光脈衝"
   },
   {
    "label": "打到物體反射"
   },
   {
    "label": "量往返時間"
   },
   {
    "label": "距離",
    "sub": "光速×時間÷2"
   },
   {
    "label": "旋轉一圈掃描",
    "sub": "角度加距離,轉成點"
   }
  ]
 },
 "原理:座標變換與 LiDAR 測距#6": {
  "type": "table",
  "head": [
   "項目",
   "數值"
  ],
  "rows": [
   [
    "物體距離",
    "3 公尺"
   ],
   [
    "往返時間",
    "20 奈秒"
   ],
   [
    "分辨 1 公分的時間差",
    "約 67 皮秒"
   ]
  ],
  "reveal": [
   0,
   3
  ]
 },
 "原理:座標變換與 LiDAR 測距#7": {
  "type": "table",
  "head": [
   "常見迷思",
   "事實"
  ],
  "rows": [
   [
    "雷達看到的是真實距離",
    "黑色吸光面、玻璃、鏡面、強光會影響;無回波可能是無限大"
   ],
   [
    "變換順序可以隨便換",
    "不行,旋轉與平移不可交換"
   ],
   [
    "航向用度數就好",
    "ROS 一律公尺與弧度"
   ],
   [
    "限制",
    "2D 雷達只量一個水平切面"
   ],
   [
    "限制",
    "TF 樹每個框架只能有一個父框架"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3,
   5
  ],
  "widths": [
   1.2,
   2.4
  ]
 },
 "tf2:座標框架與座標變換#1": {
  "type": "flow",
  "reveal": [
   0,
   1,
   3
  ],
  "nodes": [
   {
    "label": "雷達座標",
    "sub": "前方 1 公尺有牆"
   },
   {
    "label": "機器人座標",
    "sub": "雷達在前 10 公分、高 18 公分"
   },
   {
    "label": "地圖座標",
    "sub": "導航需要的位置"
   }
  ]
 },
 "tf2:座標框架與座標變換#2": {
  "type": "table",
  "head": [
   "框架",
   "特性"
  ],
  "rows": [
   [
    "map",
    "全域固定,不跳動;定位更新時機器人位置可能跳一下"
   ],
   [
    "odom",
    "連續、平滑,但會隨時間漂移"
   ],
   [
    "base_link / base_footprint",
    "固定在機器人身上"
   ],
   [
    "base_scan、imu_link、camera_link",
    "感測器框架,相對 base_link 固定"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3,
   4,
   4
  ],
  "widths": [
   1.5,
   2.6
  ]
 },
 "tf2:座標框架與座標變換#3": {
  "type": "flow",
  "layout": "row",
  "reveal": [
   0,
   4
  ],
  "nodes": [
   {
    "label": "map"
   },
   {
    "label": "odom"
   },
   {
    "label": "base_footprint",
    "sub": "base_link"
   },
   {
    "label": "感測器與輪子"
   }
  ]
 },
 "tf2:座標框架與座標變換#4": {
  "type": "table",
  "head": [
   "這一段變換",
   "由誰發布"
  ],
  "rows": [
   [
    "map → odom",
    "定位的 AMCL 或 SLAM"
   ],
   [
    "odom → base_footprint",
    "底盤驅動的里程計"
   ],
   [
    "其餘固定關係",
    "robot_state_publisher 依 URDF"
   ]
  ],
  "reveal": [
   0,
   1,
   3
  ],
  "widths": [
   1.3,
   1.6
  ]
 },
 "tf2:座標框架與座標變換#6": {
  "type": "cards",
  "reveal": [
   0,
   3
  ],
  "cards": [
   {
    "title": "odom",
    "points": [
     "連續但會漂移",
     "局部避障用平滑的 odom"
    ]
   },
   {
    "title": "map",
    "points": [
     "定位準確",
     "可能突然修正",
     "全域導航用 map"
    ]
   },
   {
    "title": "map 到 odom",
    "points": [
     "這一段負責吸收",
     "漂移的修正"
    ]
   }
  ]
 },
 "tf2:座標框架與座標變換#7": {
  "type": "table",
  "head": [
   "指令",
   "說明"
  ],
  "rows": [
   [
    "tf2_tools view_frames",
    "在目前目錄產生 PDF,畫出整棵 TF 樹"
   ],
   [
    "tf2_echo",
    "指定兩個框架,持續顯示位移與旋轉"
   ],
   [
    "/tf_static topic",
    "顯示固定的靜態變換"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3
  ],
  "widths": [
   1.2,
   2.2
  ]
 },
 "URDF:用檔案描述機器人身體#1": {
  "type": "cards",
  "reveal": [
   0,
   1,
   4
  ],
  "cards": [
   {
    "title": "URDF",
    "points": [
     "描述機器人結構的 XML 檔",
     "連桿、關節、尺寸、位置",
     "外觀、碰撞形狀、質量"
    ]
   },
   {
    "title": "robot_state_publisher",
    "points": [
     "讀取 URDF",
     "依關節狀態發布 TF"
    ]
   },
   {
    "title": "RViz2",
    "points": [
     "用它畫出機器人模型"
    ]
   },
   {
    "title": "Gazebo",
    "points": [
     "用它產生模擬機器人"
    ]
   }
  ]
 },
 "URDF:用檔案描述機器人身體#2": {
  "type": "table",
  "head": [
   "零件",
   "形狀與關節",
   "位置"
  ],
  "rows": [
   [
    "車身 base_link",
    "方塊 0.2×0.15×0.05 公尺",
    "—"
   ],
   [
    "左輪",
    "圓柱 半徑 0.033、寬 0.02;continuous",
    "左側 0.08、下 0.02;轉軸 y"
   ],
   [
    "雷達 base_scan",
    "fixed 固定關節",
    "前方 0.05、上方 0.1"
   ],
   [
    "右輪",
    "同左輪",
    "y 為 −0.08"
   ]
  ],
  "reveal": [
   0,
   0,
   1,
   2,
   3,
   4
  ],
  "widths": [
   1.1,
   2,
   1.8
  ]
 },
 "URDF:用檔案描述機器人身體#4": {
  "type": "flow",
  "reveal": [
   0,
   0,
   1,
   2
  ],
  "nodes": [
   {
    "label": "check_urdf",
    "sub": "檢查檔案語法"
   },
   {
    "label": "urdf_tutorial display",
    "sub": "RViz2 與關節滑桿視窗"
   }
  ]
 },
 "URDF:用檔案描述機器人身體#5": {
  "type": "flow",
  "reveal": [
   0,
   3,
   3,
   4
  ],
  "nodes": [
   {
    "label": "讀成文字",
    "sub": "URDF 檔案內容"
   },
   {
    "label": "robot_state_publisher",
    "sub": "啟動並傳入"
   },
   {
    "label": "robot_description",
    "sub": "當成參數傳入"
   },
   {
    "label": "輪子需 joint_states",
    "sub": "真機由驅動發布"
   }
  ]
 },
 "URDF:用檔案描述機器人身體#6": {
  "type": "cards",
  "reveal": [
   0,
   2,
   3
  ],
  "cards": [
   {
    "title": "模擬用 URDF",
    "points": [
     "完整質量與慣性",
     "碰撞形狀",
     "外掛設定"
    ]
   },
   {
    "title": "現成模型",
    "points": [
     "TurtleBot 3 已提供",
     "改感測器位置要同時改 URDF"
    ]
   },
   {
    "title": "xacro",
    "points": [
     "巨集擴充的 URDF",
     "執行 xacro 會輸出 URDF"
    ]
   }
  ]
 },
 "URDF:用檔案描述機器人身體#7": {
  "type": "table",
  "head": [
   "情況",
   "影響"
  ],
  "rows": [
   [
    "雷達位置差 5 公分",
    "還算小"
   ],
   [
    "雷達裝反(偏航差 180 度)",
    "地圖完全顛倒"
   ]
  ],
  "reveal": [
   0,
   2
  ],
  "widths": [
   1.4,
   1.4
  ]
 },
 "感測器資料格式:LaserScan、Imu、Image#1": {
  "type": "table",
  "head": [
   "訊息",
   "用途"
  ],
  "rows": [
   [
    "LaserScan",
    "平面雷射"
   ],
   [
    "Imu",
    "慣性"
   ],
   [
    "Image / CompressedImage",
    "影像"
   ],
   [
    "CameraInfo",
    "相機內參"
   ],
   [
    "PointCloud2",
    "點雲"
   ],
   [
    "BatteryState",
    "電池"
   ]
  ],
  "reveal": [
   0,
   6,
   6
  ],
  "widths": [
   1.5,
   1
  ]
 },
 "感測器資料格式:LaserScan、Imu、Image#2": {
  "type": "table",
  "head": [
   "欄位",
   "說明"
  ],
  "rows": [
   [
    "angle_min / max / increment",
    "起訖角度與相鄰間隔(弧度)"
   ],
   [
    "range_min / max",
    "有效距離(公尺),範圍外不可信"
   ],
   [
    "ranges",
    "距離陣列;無回波常為無限大或 NaN"
   ],
   [
    "第 i 筆角度",
    "angle_min + i × angle_increment"
   ],
   [
    "360 筆為例",
    "間隔約 0.01745 弧度,也就是 1 度"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3,
   4,
   5
  ],
  "widths": [
   1.4,
   2.2
  ]
 },
 "感測器資料格式:LaserScan、Imu、Image#4": {
  "type": "flow",
  "reveal": [
   0,
   1,
   6,
   6
  ],
  "nodes": [
   {
    "label": "訂閱 scan",
    "sub": "感測器資料 QoS"
   },
   {
    "label": "15 度換弧度",
    "sub": "逐筆檢查距離"
   },
   {
    "label": "略過無效值",
    "sub": "非有限或超出範圍"
   },
   {
    "label": "角度正規化",
    "sub": "−π 到 π"
   },
   {
    "label": "±15 度內",
    "sub": "更新最近距離"
   },
   {
    "label": "小於 0.3 公尺",
    "sub": "印出警告"
   }
  ]
 },
 "感測器資料格式:LaserScan、Imu、Image#6": {
  "type": "table",
  "head": [
   "欄位",
   "說明"
  ],
  "rows": [
   [
    "orientation",
    "四元數姿態;低價 IMU 常沒有(covariance 第一個元素 −1)"
   ],
   [
    "angular_velocity",
    "陀螺儀,弧度/秒"
   ],
   [
    "linear_acceleration",
    "加速度計,公尺/秒²;靜止時 z 約 9.8"
   ],
   [
    "四元數轉偏航角",
    "(0, 0, 0.7071, 0.7071) 得 90 度"
   ],
   [
    "漂移",
    "陀螺儀積分會漂移,常與里程計融合"
   ]
  ],
  "reveal": [
   0,
   1,
   2,
   3,
   4,
   5
  ],
  "widths": [
   1.2,
   2.6
  ]
 },
 "感測器資料格式:LaserScan、Imu、Image#7": {
  "type": "flow",
  "reveal": [
   0,
   1,
   4
  ],
  "nodes": [
   {
    "label": "Image 欄位",
    "sub": "高度、寬度、編碼、step、資料"
   },
   {
    "label": "640×480 rgb8"
   },
   {
    "label": "step",
    "sub": "640×3=1,920"
   },
   {
    "label": "資料長度",
    "sub": "921,600 位元組"
   }
  ]
 }
}