LeRobot documentation

원격 조작자

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

원격 조작자

텔레오퍼레이터(teleoperator)는 로봇이 따를 동작을 생성합니다 — 리더 암, 게임패드, 키보드, 스마트폰 등. 이 모든 것은 Teleoperator 인터페이스를 구현하므로, 해당 인터페이스를 기준으로 작성된 녹화 스크립트는 어떤 입력 장치와도 함께 작동합니다.

Phone teleoperation 및 Isaac Teleop에서 설정 가이드를, Imitation Learning for Robots에서 녹화 워크플로를 확인하세요. 코어 세트에 포함되지 않는 커뮤니티 관리 장치는 Third-Party Robots & Teleoperators에서 확인하세요. 자체 텔레오퍼레이터를 추가하려면 Bring Your Own Hardware를 참고하세요.

원격 조작

class lerobot.teleoperators.Teleoperator

< >

( config: TeleoperatorConfig )

매개변수

  • config_class (RobotConfig) — 이 텔레오퍼레이터에 대한 예상 구성 클래스입니다.
  • name (str) — 이 teleoperator 유형을 식별하는 데 사용되는 고유한 이름입니다.

모든 LeRobot 호환 텔레오퍼레이션 기기의 기본 추상 클래스입니다.

이 클래스는 물리적 텔레오퍼레이터와 상호작용하기 위한 표준화된 인터페이스를 제공합니다. 서브클래스는 사용 가능하도록 모든 추상 메서드와 프로퍼티를 구현해야 합니다.

connect

< >

( calibrate: bool = True )

매개변수

  • calibrate (bool) — True인 경우, 연결 후 텔레오퍼레이터가 아직 보정되지 않았거나 보정이 필요한 경우(하드웨어에 따라 다름) 자동으로 보정합니다.

원격 조작자와 통신을 설정합니다.

연결 해제

< >

( )

텔레오퍼레이터에서 연결을 해제하고 필요한 정리 작업을 수행합니다.

configure

< >

( )

원시 텔레오퍼레이터에 일회성 또는 런타임 구성을 적용합니다. 모터 매개변수, 제어 모드 또는 초기 상태 설정을 포함할 수 있습니다.

calibrate

< >

( )

적용 가능한 경우 텔레오퍼레이터를 보정합니다. 그렇지 않으면 이 작업은 아무 효과도 없습니다(no-op).

이 메서드는 필요한 데이터(예: 모터 오프셋)를 수집하고 calibration 사전에 따라 적절히 업데이트해야 합니다.

get_action

< >

( ) → RobotAction

반환값

RobotAction

텔레오퍼레이터의 현재 작업을 나타내는 평탄한 사전입니다. 구조는 observation_features와 일치해야 합니다.

텔레오퍼레이터에서 현재 액션을 가져옵니다.

피드백 보내기

< >

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

매개변수

  • feedback (dict[str, Any]) — 원하는 피드백을 나타내는 딕셔너리. 구조는 :pymeth:feedback_features와 일치해야 합니다.

반환값

dict[str, Any]

모터에 실제로 전송된 액션은 속도 안전 한계와 같은 요인에 의해 잘리거나 수정될 수 있습니다.

피드백 액션 명령을 텔레오퍼레이터에게 전송합니다.

action_features

< >

( )

텔레오퍼레이터가 생성하는 액션의 구조와 유형을 설명하는 딕셔너리입니다. 이 딕셔너리의 구조(키)는 get_action가 반환하는 값의 구조와 일치해야 합니다. 딕셔너리의 값은 단순한 값인 경우 해당 값의 유형이어야 하며, 예를 들어 단일 고유감각 값(관절의 목표 위치/속도)의 경우 float입니다.

참고: 이 속성은 로봇이 연결되어 있든 아니든 상관없이 호출할 수 있어야 합니다.

피드백 기능

< >

( )

로봇이 기대하는 피드백 액션의 구조와 유형을 설명하는 사전입니다. 이 사전의 구조(키)는 send_feedback에 전달되는 값의 구조와 일치해야 합니다. 사전의 값은 단순한 값인 경우 해당 값의 유형이어야 하며, 예를 들어 단일 고유감각 값(관절의 목표 위치/속도)의 경우 float입니다.

참고: 이 속성은 로봇이 연결되어 있든 아니든 상관없이 호출할 수 있어야 합니다.

is_connected

< >

( )

원격 조작자가 현재 연결되어 있는지 여부입니다. False인 경우, :pymeth:get_action 또는 :pymeth:send_feedback를 호출하면 오류가 발생해야 합니다.

is_calibrated

< >

( )

원격 조작자가 현재 보정되어 있는지 여부. 해당되지 않는 경우 항상 True여야 합니다

TeleoperatorConfig

class 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