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.7.0).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

البيئات

تُهيّأ بيئات المحاكاة من خلال EnvConfig وتُبنى بواسطة make_env، أو make_task_env لمهمة واحدة. تحتوي الإعدادات على الخيارات فقط؛ حيث تُحوّل دالتها sim_settings() هذه الخيارات إلى معاملات الكلمات المفتاحية الخاصة بتكامل المحاكي الخاص بها.

راجع Simulation لمعرفة كيفية استخدام البيئات، وEnvHub لاستخدام البيئات ونشرها على Hub، وAdding a Benchmark للمساهمة بإضافة واحدة.

HubEnvConfig

فئة lerobot.envs.HubEnvConfig

< >

( task: str | None = Nonefps: int = 30features: dict[str, PolicyFeature] = <factory>features_map: dict[str, str] = <factory>max_parallel_tasks: int = 1disable_env_checker: bool = Trueserver: EnvClientConfig | None = Nonehub_path: str | None = Nonetrust_remote_code: bool = Falsemake_env_kwargs: dict[str, Any] = <factory>use_native_batch: bool = False )

بيئة من مستودع EnvHub في ملف env.py؛ تشغيلها يتطلب trust_remote_code.

EnvConfig

فئة lerobot.envs.EnvConfig

< >

( task: str | None = Nonefps: int = 30features: dict[str, PolicyFeature] = <factory>features_map: dict[str, str] = <factory>max_parallel_tasks: int = 1disable_env_checker: bool = Trueserver: EnvClientConfig | None = None )

خيارات البيئة. يبني make_env البيئة من sim_settings() الخاص بها.

create_env

< >

( *args: Any**kwargs: Any )

تمت الإزالة: بناء بيئة مهمة واحدة باستخدام lerobot.envs.make_task_env(config, task_group, task_id, ...).

create_envs

< >

( *args: Any**kwargs: Any )

تمت الإزالة: أنشئ البيئات باستخدام lerobot.envs.make_env(config, n_envs, use_async_envs).

get_env_processors

< >

( )

يعيد (المعالج المسبق، المعالج اللاحق) لهذا البيئة. الافتراضي: الهوية.

sim_config

< >

( )

أعد sim_settings() مع الإعدادات الافتراضية للمحاكاة، كما تُنفَّذ في البيئات المحلية وخادم البيئة.

sim_settings

< >

( )

أعد إعدادات المحاكاة، كما في قسم sim في ملف YAML الخاص بالخادم؛ وتُستخدم القيم الافتراضية للمحاكاة لأي إعدادات مفقودة.

الافتراضي هو بيئة Gymnasium gym_id مع gym_kwargs وإجراءات دلتا؛ تجاوز ذلك في حال العكس.

make_env

lerobot.envs.make_env

< >

( cfg: EnvConfign_envs: int = 1use_async_envs: bool = False ) → dict[str, dict[int, gym.vector.VectorEnv]]

المعاملات

  • cfg (EnvConfig) — إعدادات البيئة. مستودع EnvHub هو HubEnvConfig(hub_path="user/repo", trust_remote_code=True).
  • n_envs (int، اختياري، القيمة الافتراضية 1) — عدد البيئات في كل بيئة متجهية.
  • use_async_envs (bool، اختياري، القيمة الافتراضية False) — تشغيل كل بيئة في عملية عامل مستقلة.

يعيد

dict[str, dict[int, gym.vector.VectorEnv]]

بيئات المتجهات، على شكل {suite: {task_id: env}}. تحتوي بيئة مهمة واحدة على مجموعة واحدة، مع معرّف مهمة 0.

يرفع

ValueError أو RuntimeError أو ModuleNotFoundError

  • ValueError — إذا كان n_envs أقل من 1.
  • RuntimeError — إذا كان كود مستودع EnvHub يعمل دون إعداد trust_remote_code الخاص به.
  • ModuleNotFoundError — إذا لم يكن المُحاكي، أو الحزمة التي يحتاجها env.py في المستودع، مثبتًا.

إنشاء بيئات المتجهات (vector envs) من إعداد (config).

make_task_env

lerobot.envs.make_task_env

< >

( cfg: EnvConfigtask_group: str | None = Nonetask_id: int | None = Nonen_envs: int = 1use_async_envs: bool = False )

أنشئ بيئة المتجهات المحلية أو المُقدَّمة لمهمة واحدة؛ عدم تحديد task_id يعني استخدام المهمة الأولى في المجموعة.

make_env_config

lerobot.envs.make_env_config

< >

( env_type: str**kwargs )

Update on GitHub