動 URDF 機器人模型實戰(zhàn)：內(nèi)置導入器、命名幀 Transform3D 與 rr.urdf 工具)
Rerun 加載與驅(qū)動 URDF 機器人模型實戰(zhàn)內(nèi)置導入器、命名幀 Transform3D 與 rr.urdf 工具【免費下載鏈接】rerunVisualize, query, and stream to train on multimodal robotics data.項目地址: https://gitcode.com/GitHub_Trending/re/rerunRerun 針對 ROS 生態(tài)中最常見的機器人描述格式 URDFUnified Robot Description Format內(nèi)置了一個文件導入器只要把.urdf文件交給日志 APIPython / Rust / C 的log_file_from_path它就會自動解析網(wǎng)格引用、加載幾何體為 Rerun 實體、并為每個 link 生成帶 frame ID 的關節(jié)變換。讀完本文你將掌握URDF 導入器在底層做了什么、如何在運行時用命名幀的Transform3D驅(qū)動關節(jié)運動、如何用rr.urdf.UrdfTree訪問關節(jié)/連桿結(jié)構(gòu)并計算關節(jié)變換以及如何把 URDF 合并進一個已經(jīng)打開的錄制例如 ROS 2 MCAP中。內(nèi)置 URDF 導入器與一次導入背后發(fā)生的事情Rerun 內(nèi)置了面向 URDF 的UrdfImporter導入器名稱為rerun.importers.Urdf實現(xiàn)在 crates/data_flow/re_importer/src/importer_urdf/mod.rs。在導入器框架中所有導入器都會被無條件通知待打開的文件路徑URDF 導入器通過檢查擴展名不區(qū)分大小寫的urdf決定是否接手該文件不匹配則返回ImporterError::Incompatible。這與 導入器總覽 中描述的內(nèi)置/外部/自定義三類導入器機制一致。在 Rerun 中使用 URDF 非常簡單——只需用日志 API 加載文件導入器會自動完成三件事解析網(wǎng)格mesh的路徑引用并加載它們把網(wǎng)格與基本幾何體box、cylinder、capsule、sphere作為 Rerun 實體加載加載各 link 的關節(jié)變換joint transforms以及對應的 frame ID。實體路徑布局從 urdf_tree.rs 中UrdfLogPaths::new的源碼可以看到模型被組織到幾個固定的實體路徑下entity_path_prefix可選內(nèi)容默認實體路徑說明機器人根坐標系{robot_name}可加前綴由CoordinateFrame標記值為 root link 的 frame ID視覺幾何體{prefix}{robot_name}/visual_geometries/{link}/{visual_name}便于整體切換視覺幾何體顯隱碰撞幾何體{prefix}{robot_name}/collision_geometries/{geometry_type}/{link}/{collision_name}按幾何類型分目錄可單獨隱藏某類碰撞體如只隱藏 mesh 保留基本體靜態(tài)關節(jié)變換/tf_static所有默認變換集中到同一個實體路徑且不受entity_path_prefix影響所有靜態(tài)關節(jié)變換會被合并為一個 chunk 批量寫入/tf_static見emit_static_transforms_batch。源碼注釋明確說明“對 URDF 總是以 static 方式寫入”這樣用戶后續(xù)可以在任意自己選擇的變換實體上覆蓋它們。網(wǎng)格資源如何被解析load_ros_resource支持四種資源尋址方式相對路徑相對.urdf文件所在目錄解析file://協(xié)議直接讀取本地絕對路徑package://協(xié)議在ROS_PACKAGE_PATHROS 1和AMENT_PREFIX_PATHROS 2中查找entry/pkg_name或entry/share/pkg_name適用于 ROS 包內(nèi)引用的網(wǎng)格見resolve_package_urihttp(s)://協(xié)議通過 HTTP 下載網(wǎng)格連接超時 30 秒且單次下載有 512 MiB 的內(nèi)存保護上限MAX_MESH_DOWNLOAD_SIZE。對于無法解析的網(wǎng)格資源導入不會整體失敗錯誤會被收集并按原因匯總、去重后以警告形式輸出例如“Could not resolve package URI…”其余 link、joint 與幾何體照常導入。這一點有端到端測試佐證test_urdf_importer.rs 中的test_urdf_importer_dangling_mesh專門驗證“網(wǎng)格無法加載時其余實體仍然全部產(chǎn)出且不會發(fā)出任何Asset3D”。另外在 WebAssembly 目標上ROS 資源加載不可用返回UnsupportedInWasm。幾何體與材質(zhì)的映射emit_geometry給出了 URDF 幾何類型到 Rerun 原語/資產(chǎn)的映射關系URDF 幾何Rerun 輸出meshAsset3D按擴展名猜測 MediaType支持albedo_factorboxBoxes3D帶顏色cylinderCylinders3DURDF 與 Rerun 都以 Z 為主軸capsuleCapsules3D同上sphereEllipsoids3D帶顏色材質(zhì)處理上優(yōu)先使用 visual 內(nèi)聯(lián)定義的 color/texture否則回退到按名稱查找全局material未指定顏色時回退為白色。紋理texture目前未支持會輸出一次性警告源碼中的warn_once!(Material texture not supported)。碰撞幾何體不攜帶材質(zhì)統(tǒng)一按白色渲染。用命名幀的 Transform3D 更新關節(jié)模型加載完成后關節(jié)的驅(qū)動方式是通過發(fā)送[Transform3D](https://link.gitcode.com/i/45e8ba7e4c8c00777da1c66c744bf20a)完成的關鍵要求是必須顯式設置parent_frame和child_frame為每個關節(jié)對應的 frame IDURDF 中即 parent link 與 child link 的名字。版本提示≥ 0.28 的行為變化0.28 之前的版本要求使用“隱式 frame ID”即把每個關節(jié)的變換分別發(fā)送到特定實體路徑上。該方案已被命名 frame ID取代這與 ROS 的 TF 語義更一致并且允許你在一個實體例如示例中的transforms實體上發(fā)送全部關節(jié)的變換更新。下面是一個最小可運行的加載并更新關節(jié)的 Python 示例來自文檔配套片段 docs/snippets/all/howto/load_urdf.pyfrom pathlib import Path import rerun as rr from rerun import RecordingStream with RecordingStream(rerun_example_load_urdf) as rec: rec.spawn() # log_file_from_path 會自動調(diào)用內(nèi)置的 URDF 導入器。 urdf_path Path(__file__).parent / minimal.urdf rec.log_file_from_path(urdf_path, staticTrue) # 可選的 flush確保 URDF 加載完成后再繼續(xù)后續(xù)日志。 rec.flush() # 后續(xù)在日志代碼中用 Transform3D 更新關節(jié)。 joint_axis [0, 0, 1] # 取自 URDF joint_angle 1.216 # 弧度 origin_xyz [0, 0, 0.1] # 取自 URDF # 務必保證 parent_frame / child_frame 與 URDF 中關節(jié)的 frame ID 一致。 rec.log( transforms, rr.Transform3D( rotationrr.RotationAxisAngle(axisjoint_axis, anglejoint_angle), translationorigin_xyz, parent_framebase_link, child_framechild_link, ), )Rust 與 C SDK 同樣通過RecordingStream::log_file_from_path觸發(fā)同一套內(nèi)置導入器之后也以Transform3D含parent_frame/child_frame更新關節(jié)。完整動畫示例animated_urdf文檔推薦了兩個可直接運行的動畫示例Python 版 animated_urdfpython -m animated_urdfRust 版 animated_urdf加載并驅(qū)動同一份so100.urdf機械臂以 Python 版為例它的核心循環(huán)展示了幾種典型用法一次性加載模型rec.log_file_from_path(urdf_path)然后用rr.urdf.UrdfTree.from_file_path(urdf_path)把 URDF 結(jié)構(gòu)讀入內(nèi)存隱藏碰撞幾何體通過 blueprint 對so_arm100/collision_geometries設置rrb.EntityBehavior(visibleFalse)這正是前文實體路徑布局中“視覺/碰撞分離”設計的目的逐關節(jié)驅(qū)動對每個revolute關節(jié)用joint.compute_transform(angle, clampTrue)計算變換并rec.log(transforms, transform)——compute_transform會自動填好 frame ID無需手動指定運行期修改材質(zhì)通過urdf_tree.get_joint_child(joint)拿到關節(jié)的子 link再對get_visual_geometry_paths(link)返回的每個視覺幾何體路徑用rr.Asset3D.from_fields(albedo_factorrgba)按關節(jié)角度動態(tài)改顏色/透明度示例中“jaw”關節(jié)的夾爪顏色隨角度從紅漸變到綠假關節(jié)角度_fake_angle使用joint.limit_lower/joint.limit_upper生成在限位內(nèi)振蕩的正弦角模擬真實測量數(shù)據(jù)。Python URDF 工具rr.urdf除了導入器Rerun 還在 Python 側(cè)提供了 rerun_py/rerun_sdk/rerun/urdf.py 模塊即rr.urdf可作為yourdfpy、pytransform3d等第三方包之外的輕量替代。它的底層是rerun_bindings中暴露的_UrdfTreeInternal/_UrdfJointInternal等原生綁定再封裝為符合 Rerun 日志語義的高層 API。UrdfTree加載并訪問模型結(jié)構(gòu)urdf_tree rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixNone) # 訪問屬性 robot_name urdf_tree.name root_link urdf_tree.root_link() joints urdf_tree.joints() # 按名字查找 urdf_tree.get_joint_by_name(shoulder) urdf_tree.get_link_by_name(base_link) # 獲取某個 link 的視覺/碰撞幾何體實體路徑 # 可用于運行期修改顏色/透明度 for visual_path in urdf_tree.get_visual_geometry_paths(gripper): rec.log(visual_path, rr.Asset3D.from_fields(albedo_factor[255, 0, 0, 100]), staticTrue)UrdfTree.from_file_path的完整簽名還支持三個配置參數(shù)源碼見 urdf.py參數(shù)作用entity_path_prefix可選給幾何體實體路徑加前綴frame_prefix可選給所有 frame ID 加前綴用于多次加載同一份 URDFstatic_transform_entity_path可選靜態(tài)變換寫入的實體路徑默認/tf_static不受entity_path_prefix影響UrdfTree還提供get_joint_child(joint)取關節(jié)子 link、log_urdf_to_recording()把完整模型——幾何體 靜態(tài)變換——寫入錄制是log_file_from_path在需要frame_prefix等額外配置時的替代方案、stream()實驗性的惰性 chunk 流等接口。多機器人場景frame prefix當需要把同一份 URDF 加載多次例如雙臂設置時用frame_prefix讓每份實例的 frame ID 唯一用entity_path_prefix在實體樹中隔離幾何體然后通過log_urdf_to_recording()寫入帶前綴 frame ID 的模型left rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixleft, frame_prefixleft/) right rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixright, frame_prefixright/) left.log_urdf_to_recording() right.log_urdf_to_recording()之后通過joint.compute_transform()計算出的變換會自動帶上前綴 frame ID例如left/base、right/shoulder。這正是 animated_urdf 示例中--dual模式的實現(xiàn)方式左右臂分別以left/、right/前綴加載再各自rec.log(left, rr.Transform3D(translation[-0.2, 0, 0]), staticTrue)平移錯開位置。UrdfJoint讀取關節(jié)屬性并計算變換每個關節(jié)都暴露了來自 URDF 文件的屬性namejoint_type如revolute、continuous、prismatic、fixedparent_link、child_linkaxis、origin_xyz、origin_rpylimit_lower、limit_upper、limit_effort、limit_velocitymimic若該關節(jié)帶mimic標簽返回UrdfMimic含joint、multiplier、offset語義為value multiplier * driver_value offset否則為None用compute_transform()得到Transform3D其parent_frame與child_frame已自動設置好# 對 revolute / continuous 關節(jié)傳入弧度角 # 對 prismatic 關節(jié)傳入平移距離米 transform joint.compute_transform(angle) rec.log(transforms, transform)compute_transform(value, clampTrue)的行為細節(jié)對應底層實現(xiàn) joint_transform.rsrevolute 關節(jié)在值超出[limit_lower, limit_upper]時會被鉗制clamp并產(chǎn)生一條警告clampFalse時不做鉗制、不警告continuous 關節(jié)沒有限位因此不檢查變換由 origin 姿態(tài)與繞關節(jié)軸axis的動態(tài)旋轉(zhuǎn)軸角組合而成prismatic 關節(jié)則在 origin 平移基礎上疊加沿軸的位移。此外UrdfJoint還提供面向批量數(shù)據(jù)的兩組方法compute_transform_columns(values, clampTrue)對同一關節(jié)的多個值批量計算返回列式columnar數(shù)據(jù)可直接配合rerun.send_columns使用適合一次性發(fā)送整段關節(jié)軌跡UrdfTree.compute_joint_transform_batches(names, values, clampFalse)接收 ArrowListArray關節(jié)名 關節(jié)值按行成對輸出包含translation、quaternion、parent_frame、child_frame的ListArray源碼注釋說明這是為 lens查詢/變換流水線設計的輔助接口——下游通常再接一個把每個 batch 展開成最終Transform3D行的 lens。把 URDF 加載進已有的錄制如果 Rerun 中已經(jīng)打開了一個帶變換的錄制想往里追加 URDF可以通過拖拽文件進 Viewer或使用菜單中的“Import into current recording”實現(xiàn)。一個典型場景加載 ROS 2 的.mcap文件時TF 消息會被自動翻譯為 Rerun 的Transform3D但示例 MCAP 的變換樹中會缺失一些連接Viewer 中會以錯誤形式提示這些缺失的靜態(tài)變換。這些缺失的靜態(tài)變換往往存放在與 MCAP 分離的 URDF 模型里。此時只需把對應的 URDF 文件直接拖入已加載 MCAP 的 Viewer 窗口缺失的靜態(tài) link 就會補上變換樹隨之閉合。參考與進一步閱讀三種語言統(tǒng)一的文件入口Pythonrerun.log_file_from_path、RustRecordingStream::log_file_from_path、CRecordingStream::log_file_from_path導入器框架總覽了解內(nèi)置/外部/自定義三類導入器及擴展方式Transform3D 原型參考parent_frame/child_frame/旋轉(zhuǎn)/平移的完整字段說明Rust 端導入器實現(xiàn) 與 URDF 樹構(gòu)造、關節(jié)變換計算導入器端到端測試驗證網(wǎng)格懸空dangling mesh時導入仍能容錯完成配套片段資源load_urdf.py 與 minimal.urdf倉庫中以 Git LFS 指針形式存儲完整動畫示例Python animated_urdf 與 Rust animated_urdf?！久赓M下載鏈接】rerunVisualize, query, and stream to train on multimodal robotics data.項目地址: https://gitcode.com/GitHub_Trending/re/rerun創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Rerun 加載與驅(qū)動 URDF 機器人模型實戰(zhàn)：內(nèi)置導入器、命名幀 Transform3D 與 rr.urdf 工具
Rerun 加載與驅(qū)動 URDF 機器人模型實戰(zhàn)內(nèi)置導入器、命名幀 Transform3D 與 rr.urdf 工具【免費下載鏈接】rerunVisualize, query, and stream to train on multimodal robotics data.項目地址: https://gitcode.com/GitHub_Trending/re/rerunRerun 針對 ROS 生態(tài)中最常見的機器人描述格式 URDFUnified Robot Description Format內(nèi)置了一個文件導入器只要把.urdf文件交給日志 APIPython / Rust / C 的log_file_from_path它就會自動解析網(wǎng)格引用、加載幾何體為 Rerun 實體、并為每個 link 生成帶 frame ID 的關節(jié)變換。讀完本文你將掌握URDF 導入器在底層做了什么、如何在運行時用命名幀的Transform3D驅(qū)動關節(jié)運動、如何用rr.urdf.UrdfTree訪問關節(jié)/連桿結(jié)構(gòu)并計算關節(jié)變換以及如何把 URDF 合并進一個已經(jīng)打開的錄制例如 ROS 2 MCAP中。內(nèi)置 URDF 導入器與一次導入背后發(fā)生的事情Rerun 內(nèi)置了面向 URDF 的UrdfImporter導入器名稱為rerun.importers.Urdf實現(xiàn)在 crates/data_flow/re_importer/src/importer_urdf/mod.rs。在導入器框架中所有導入器都會被無條件通知待打開的文件路徑URDF 導入器通過檢查擴展名不區(qū)分大小寫的urdf決定是否接手該文件不匹配則返回ImporterError::Incompatible。這與 導入器總覽 中描述的內(nèi)置/外部/自定義三類導入器機制一致。在 Rerun 中使用 URDF 非常簡單——只需用日志 API 加載文件導入器會自動完成三件事解析網(wǎng)格mesh的路徑引用并加載它們把網(wǎng)格與基本幾何體box、cylinder、capsule、sphere作為 Rerun 實體加載加載各 link 的關節(jié)變換joint transforms以及對應的 frame ID。實體路徑布局從 urdf_tree.rs 中UrdfLogPaths::new的源碼可以看到模型被組織到幾個固定的實體路徑下entity_path_prefix可選內(nèi)容默認實體路徑說明機器人根坐標系{robot_name}可加前綴由CoordinateFrame標記值為 root link 的 frame ID視覺幾何體{prefix}{robot_name}/visual_geometries/{link}/{visual_name}便于整體切換視覺幾何體顯隱碰撞幾何體{prefix}{robot_name}/collision_geometries/{geometry_type}/{link}/{collision_name}按幾何類型分目錄可單獨隱藏某類碰撞體如只隱藏 mesh 保留基本體靜態(tài)關節(jié)變換/tf_static所有默認變換集中到同一個實體路徑且不受entity_path_prefix影響所有靜態(tài)關節(jié)變換會被合并為一個 chunk 批量寫入/tf_static見emit_static_transforms_batch。源碼注釋明確說明“對 URDF 總是以 static 方式寫入”這樣用戶后續(xù)可以在任意自己選擇的變換實體上覆蓋它們。網(wǎng)格資源如何被解析load_ros_resource支持四種資源尋址方式相對路徑相對.urdf文件所在目錄解析file://協(xié)議直接讀取本地絕對路徑package://協(xié)議在ROS_PACKAGE_PATHROS 1和AMENT_PREFIX_PATHROS 2中查找entry/pkg_name或entry/share/pkg_name適用于 ROS 包內(nèi)引用的網(wǎng)格見resolve_package_urihttp(s)://協(xié)議通過 HTTP 下載網(wǎng)格連接超時 30 秒且單次下載有 512 MiB 的內(nèi)存保護上限MAX_MESH_DOWNLOAD_SIZE。對于無法解析的網(wǎng)格資源導入不會整體失敗錯誤會被收集并按原因匯總、去重后以警告形式輸出例如“Could not resolve package URI…”其余 link、joint 與幾何體照常導入。這一點有端到端測試佐證test_urdf_importer.rs 中的test_urdf_importer_dangling_mesh專門驗證“網(wǎng)格無法加載時其余實體仍然全部產(chǎn)出且不會發(fā)出任何Asset3D”。另外在 WebAssembly 目標上ROS 資源加載不可用返回UnsupportedInWasm。幾何體與材質(zhì)的映射emit_geometry給出了 URDF 幾何類型到 Rerun 原語/資產(chǎn)的映射關系URDF 幾何Rerun 輸出meshAsset3D按擴展名猜測 MediaType支持albedo_factorboxBoxes3D帶顏色cylinderCylinders3DURDF 與 Rerun 都以 Z 為主軸capsuleCapsules3D同上sphereEllipsoids3D帶顏色材質(zhì)處理上優(yōu)先使用 visual 內(nèi)聯(lián)定義的 color/texture否則回退到按名稱查找全局material未指定顏色時回退為白色。紋理texture目前未支持會輸出一次性警告源碼中的warn_once!(Material texture not supported)。碰撞幾何體不攜帶材質(zhì)統(tǒng)一按白色渲染。用命名幀的 Transform3D 更新關節(jié)模型加載完成后關節(jié)的驅(qū)動方式是通過發(fā)送[Transform3D](https://link.gitcode.com/i/45e8ba7e4c8c00777da1c66c744bf20a)完成的關鍵要求是必須顯式設置parent_frame和child_frame為每個關節(jié)對應的 frame IDURDF 中即 parent link 與 child link 的名字。版本提示≥ 0.28 的行為變化0.28 之前的版本要求使用“隱式 frame ID”即把每個關節(jié)的變換分別發(fā)送到特定實體路徑上。該方案已被命名 frame ID取代這與 ROS 的 TF 語義更一致并且允許你在一個實體例如示例中的transforms實體上發(fā)送全部關節(jié)的變換更新。下面是一個最小可運行的加載并更新關節(jié)的 Python 示例來自文檔配套片段 docs/snippets/all/howto/load_urdf.pyfrom pathlib import Path import rerun as rr from rerun import RecordingStream with RecordingStream(rerun_example_load_urdf) as rec: rec.spawn() # log_file_from_path 會自動調(diào)用內(nèi)置的 URDF 導入器。 urdf_path Path(__file__).parent / minimal.urdf rec.log_file_from_path(urdf_path, staticTrue) # 可選的 flush確保 URDF 加載完成后再繼續(xù)后續(xù)日志。 rec.flush() # 后續(xù)在日志代碼中用 Transform3D 更新關節(jié)。 joint_axis [0, 0, 1] # 取自 URDF joint_angle 1.216 # 弧度 origin_xyz [0, 0, 0.1] # 取自 URDF # 務必保證 parent_frame / child_frame 與 URDF 中關節(jié)的 frame ID 一致。 rec.log( transforms, rr.Transform3D( rotationrr.RotationAxisAngle(axisjoint_axis, anglejoint_angle), translationorigin_xyz, parent_framebase_link, child_framechild_link, ), )Rust 與 C SDK 同樣通過RecordingStream::log_file_from_path觸發(fā)同一套內(nèi)置導入器之后也以Transform3D含parent_frame/child_frame更新關節(jié)。完整動畫示例animated_urdf文檔推薦了兩個可直接運行的動畫示例Python 版 animated_urdfpython -m animated_urdfRust 版 animated_urdf加載并驅(qū)動同一份so100.urdf機械臂以 Python 版為例它的核心循環(huán)展示了幾種典型用法一次性加載模型rec.log_file_from_path(urdf_path)然后用rr.urdf.UrdfTree.from_file_path(urdf_path)把 URDF 結(jié)構(gòu)讀入內(nèi)存隱藏碰撞幾何體通過 blueprint 對so_arm100/collision_geometries設置rrb.EntityBehavior(visibleFalse)這正是前文實體路徑布局中“視覺/碰撞分離”設計的目的逐關節(jié)驅(qū)動對每個revolute關節(jié)用joint.compute_transform(angle, clampTrue)計算變換并rec.log(transforms, transform)——compute_transform會自動填好 frame ID無需手動指定運行期修改材質(zhì)通過urdf_tree.get_joint_child(joint)拿到關節(jié)的子 link再對get_visual_geometry_paths(link)返回的每個視覺幾何體路徑用rr.Asset3D.from_fields(albedo_factorrgba)按關節(jié)角度動態(tài)改顏色/透明度示例中“jaw”關節(jié)的夾爪顏色隨角度從紅漸變到綠假關節(jié)角度_fake_angle使用joint.limit_lower/joint.limit_upper生成在限位內(nèi)振蕩的正弦角模擬真實測量數(shù)據(jù)。Python URDF 工具rr.urdf除了導入器Rerun 還在 Python 側(cè)提供了 rerun_py/rerun_sdk/rerun/urdf.py 模塊即rr.urdf可作為yourdfpy、pytransform3d等第三方包之外的輕量替代。它的底層是rerun_bindings中暴露的_UrdfTreeInternal/_UrdfJointInternal等原生綁定再封裝為符合 Rerun 日志語義的高層 API。UrdfTree加載并訪問模型結(jié)構(gòu)urdf_tree rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixNone) # 訪問屬性 robot_name urdf_tree.name root_link urdf_tree.root_link() joints urdf_tree.joints() # 按名字查找 urdf_tree.get_joint_by_name(shoulder) urdf_tree.get_link_by_name(base_link) # 獲取某個 link 的視覺/碰撞幾何體實體路徑 # 可用于運行期修改顏色/透明度 for visual_path in urdf_tree.get_visual_geometry_paths(gripper): rec.log(visual_path, rr.Asset3D.from_fields(albedo_factor[255, 0, 0, 100]), staticTrue)UrdfTree.from_file_path的完整簽名還支持三個配置參數(shù)源碼見 urdf.py參數(shù)作用entity_path_prefix可選給幾何體實體路徑加前綴frame_prefix可選給所有 frame ID 加前綴用于多次加載同一份 URDFstatic_transform_entity_path可選靜態(tài)變換寫入的實體路徑默認/tf_static不受entity_path_prefix影響UrdfTree還提供get_joint_child(joint)取關節(jié)子 link、log_urdf_to_recording()把完整模型——幾何體 靜態(tài)變換——寫入錄制是log_file_from_path在需要frame_prefix等額外配置時的替代方案、stream()實驗性的惰性 chunk 流等接口。多機器人場景frame prefix當需要把同一份 URDF 加載多次例如雙臂設置時用frame_prefix讓每份實例的 frame ID 唯一用entity_path_prefix在實體樹中隔離幾何體然后通過log_urdf_to_recording()寫入帶前綴 frame ID 的模型left rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixleft, frame_prefixleft/) right rr.urdf.UrdfTree.from_file_path(robot.urdf, entity_path_prefixright, frame_prefixright/) left.log_urdf_to_recording() right.log_urdf_to_recording()之后通過joint.compute_transform()計算出的變換會自動帶上前綴 frame ID例如left/base、right/shoulder。這正是 animated_urdf 示例中--dual模式的實現(xiàn)方式左右臂分別以left/、right/前綴加載再各自rec.log(left, rr.Transform3D(translation[-0.2, 0, 0]), staticTrue)平移錯開位置。UrdfJoint讀取關節(jié)屬性并計算變換每個關節(jié)都暴露了來自 URDF 文件的屬性namejoint_type如revolute、continuous、prismatic、fixedparent_link、child_linkaxis、origin_xyz、origin_rpylimit_lower、limit_upper、limit_effort、limit_velocitymimic若該關節(jié)帶mimic標簽返回UrdfMimic含joint、multiplier、offset語義為value multiplier * driver_value offset否則為None用compute_transform()得到Transform3D其parent_frame與child_frame已自動設置好# 對 revolute / continuous 關節(jié)傳入弧度角 # 對 prismatic 關節(jié)傳入平移距離米 transform joint.compute_transform(angle) rec.log(transforms, transform)compute_transform(value, clampTrue)的行為細節(jié)對應底層實現(xiàn) joint_transform.rsrevolute 關節(jié)在值超出[limit_lower, limit_upper]時會被鉗制clamp并產(chǎn)生一條警告clampFalse時不做鉗制、不警告continuous 關節(jié)沒有限位因此不檢查變換由 origin 姿態(tài)與繞關節(jié)軸axis的動態(tài)旋轉(zhuǎn)軸角組合而成prismatic 關節(jié)則在 origin 平移基礎上疊加沿軸的位移。此外UrdfJoint還提供面向批量數(shù)據(jù)的兩組方法compute_transform_columns(values, clampTrue)對同一關節(jié)的多個值批量計算返回列式columnar數(shù)據(jù)可直接配合rerun.send_columns使用適合一次性發(fā)送整段關節(jié)軌跡UrdfTree.compute_joint_transform_batches(names, values, clampFalse)接收 ArrowListArray關節(jié)名 關節(jié)值按行成對輸出包含translation、quaternion、parent_frame、child_frame的ListArray源碼注釋說明這是為 lens查詢/變換流水線設計的輔助接口——下游通常再接一個把每個 batch 展開成最終Transform3D行的 lens。把 URDF 加載進已有的錄制如果 Rerun 中已經(jīng)打開了一個帶變換的錄制想往里追加 URDF可以通過拖拽文件進 Viewer或使用菜單中的“Import into current recording”實現(xiàn)。一個典型場景加載 ROS 2 的.mcap文件時TF 消息會被自動翻譯為 Rerun 的Transform3D但示例 MCAP 的變換樹中會缺失一些連接Viewer 中會以錯誤形式提示這些缺失的靜態(tài)變換。這些缺失的靜態(tài)變換往往存放在與 MCAP 分離的 URDF 模型里。此時只需把對應的 URDF 文件直接拖入已加載 MCAP 的 Viewer 窗口缺失的靜態(tài) link 就會補上變換樹隨之閉合。參考與進一步閱讀三種語言統(tǒng)一的文件入口Pythonrerun.log_file_from_path、RustRecordingStream::log_file_from_path、CRecordingStream::log_file_from_path導入器框架總覽了解內(nèi)置/外部/自定義三類導入器及擴展方式Transform3D 原型參考parent_frame/child_frame/旋轉(zhuǎn)/平移的完整字段說明Rust 端導入器實現(xiàn) 與 URDF 樹構(gòu)造、關節(jié)變換計算導入器端到端測試驗證網(wǎng)格懸空dangling mesh時導入仍能容錯完成配套片段資源load_urdf.py 與 minimal.urdf倉庫中以 Git LFS 指針形式存儲完整動畫示例Python animated_urdf 與 Rust animated_urdf?！久赓M下載鏈接】rerunVisualize, query, and stream to train on multimodal robotics data.項目地址: https://gitcode.com/GitHub_Trending/re/rerun創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考