LeRobot documentation

Người vận hành từ xa

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v0.6.1).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Người vận hành từ xa

A teleoperator produces actions for a robot to follow — a leader arm, a gamepad, a keyboard, a phone. All of them implement the Teleoperator interface, so a recording script written against it works with any input device.

Xem Phone teleoperation và Isaac Teleop để biết hướng dẫn cài đặt, và Imitation Learning for Robots để biết quy trình ghi hình. Đối với các thiết bị do cộng đồng bảo trì nằm ngoài bộ thiết bị cốt lõi, xem Third-Party Robots & Teleoperators. Để thêm một teleoperator của riêng bạn, xem Bring Your Own Hardware.

Teleoperator

lớp lerobot.teleoperators.Teleoperator

< >

( config: TeleoperatorConfig )

Tham số

  • config_class (RobotConfig) — Lớp cấu hình dự kiến cho teleoperator này.
  • name (str) — Tên duy nhất được sử dụng để xác định loại teleoperator này.

Lớp trừu tượng cơ bản cho tất cả các thiết bị teleoperation tương thích với LeRobot.

Lớp này cung cấp một giao diện chuẩn hóa để tương tác với các thiết bị điều khiển từ xa vật lý. Các lớp con phải triển khai tất cả các phương thức và thuộc tính trừu tượng để có thể sử dụng được.

connect

< >

( calibrate: bool = True )

Tham số

  • calibrate (bool) — Nếu là True, tự động hiệu chuẩn teleoperator sau khi kết nối nếu nó chưa được hiệu chuẩn hoặc cần hiệu chuẩn (điều này phụ thuộc vào phần cứng).

Thiết lập liên lạc với người vận hành từ xa.

ngắt kết nối

< >

( )

Ngắt kết nối với teleoperator và thực hiện các bước dọn dẹp cần thiết.

cấu hình

< >

( )

Áp dụng bất kỳ cấu hình nào chỉ chạy một lần hoặc trong thời gian chạy cho teleoperator. Điều này có thể bao gồm việc thiết lập các tham số động cơ, chế độ điều khiển hoặc trạng thái ban đầu.

calibrate

< >

( )

Hiệu chuẩn thiết bị điều khiển từ xa nếu cần. Nếu không, đây sẽ là một thao tác không làm gì.

Phương pháp này nên thu thập bất kỳ dữ liệu cần thiết nào (ví dụ: độ lệch động cơ) và cập nhật từ điển :pyattr:calibration cho phù hợp.

get_action

< >

( ) → RobotAction

Trả về

RobotAction

Một từ điển phẳng đại diện cho các hành động hiện tại của người vận hành từ xa. Cấu trúc của nó phải khớp với :pymeth:observation_features.

Lấy hành động hiện tại từ người vận hành từ xa.

gửi phản hồi

< >

( feedback: dict ) → dict[str, Any]

Tham số

  • feedback (dict[str, Any]) — Từ điển đại diện cho phản hồi mong muốn. Cấu trúc của nó phải khớp với :pymeth:feedback_features.

Trả về

dict[str, Any]

Hành động thực tế được gửi đến động cơ, có thể đã bị cắt hoặc chỉnh sửa, ví dụ như do các giới hạn an toàn về tốc độ.

Gửi lệnh hành động phản hồi đến người vận hành từ xa.

action_features

< >

( )

Một từ điển mô tả cấu trúc và kiểu của các hành động do người vận hành từ xa tạo ra. Cấu trúc (các khóa) của nó phải khớp với cấu trúc của giá trị được trả về bởi :pymeth:get_action. Giá trị trong từ điển phải là kiểu của giá trị nếu đó là một giá trị đơn giản, ví dụ float cho một giá trị cảm nhận bản thân đơn lẻ (vị trí/tốc độ mục tiêu của một khớp)

Lưu ý: thuộc tính này phải có thể được gọi bất kể robot có được kết nối hay không.

feedback_features

< >

( )

Một từ điển mô tả cấu trúc và kiểu của các hành động phản hồi mà robot mong đợi. Cấu trúc (các khóa) của nó phải khớp với cấu trúc của đối tượng được truyền vào :pymeth:send_feedback. Giá trị trong từ điển phải là kiểu của giá trị nếu đó là giá trị đơn giản, ví dụ float cho một giá trị cảm nhận đơn lẻ (vị trí/tốc độ mục tiêu của một khớp)

Lưu ý: thuộc tính này phải có thể được gọi bất kể robot có được kết nối hay không.

is_connected

< >

( )

Trạng thái kết nối hiện tại của người vận hành từ xa. Nếu False, việc gọi :pymeth:get_action hoặc :pymeth:send_feedback phải gây ra lỗi.

is_calibrated

< >

( )

Trạng thái hiệu chuẩn hiện tại của người vận hành từ xa. Phải luôn là True nếu không áp dụng

TeleoperatorConfig

lớp lerobot.teleoperators.TeleoperatorConfig

< >

( id: str | None = Nonecalibration_dir: pathlib.Path | None = None )

make_teleoperator_from_config

lerobot.teleoperators.make_teleoperator_from_config

< >

( config: TeleoperatorConfig )

Update on GitHub