LeRobot documentation
البيئات
البيئات
تُهيّأ بيئات المحاكاة من خلال EnvConfig وتُبنى بواسطة make_env. ويعلن كل فرع فرعي عن gym_kwargs وكيفية بناء البيئات المتجهية.
راجع البيئات من المركز لاستخدام البيئات المنشورة، وراجع إضافة معيار جديد للمساهمة في إضافة معيار.
EnvConfig
فئة lerobot.envs.EnvConfig
< source >( task: str | None = Nonefps: int = 30features: dict[str, PolicyFeature] = <factory>features_map: dict[str, str] = <factory>max_parallel_tasks: int = 1disable_env_checker: bool = True )
إنشاء {suite: {task_id: VectorEnv}}.
الافتراضي: بيئة مهمة واحدة عبر gym.make(). تتجاوز معايير الأداء متعددة المهام هذا الافتراضي. AsyncVectorEnv هو الافتراضي عندما يكون n_envs > 1؛ يتم التحويل تلقائيًا إلى Sync عندما يكون n_envs=1.
يعيد (المعالج المسبق، المعالج اللاحق) لهذا البيئة. الافتراضي: الهوية.
make_env
lerobot.envs.make_env
< source >( cfg: EnvConfig | strn_envs: int = 1use_async_envs: bool = Falsehub_cache_dir: str | None = Nonetrust_remote_code: bool = False ) → dict[str, dict[int, gym.vector.VectorEnv]]
المعاملات
- cfg (EnvConfig | str) — إما كائن
EnvConfigيصف البيئة التي سيتم بناؤها محليًا، أو معرّف مستودع على Hugging Face Hub (مثل"username/repo"). في الحالة الأخيرة، يجب أن يتضمن المستودع ملف Python (عادةًenv.py). - n_envs (int, اختياري) — عدد البيئات المتوازية التي يجب إرجاعها. القيمة الافتراضية هي 1.
- use_async_envs (bool, اختياري) — ما إذا كان يجب إرجاع AsyncVectorEnv أو SyncVectorEnv. القيمة الافتراضية هي False.
- hub_cache_dir (str | None) — مسار تخزين مؤقت اختياري للملفات المحمّلة من الـ hub.
- trust_remote_code (bool) — موافقة صريحة لتنفيذ الأكواد البعيدة من Hub.
الافتراضي False — يجب تعيينه إلى True لاستيراد/تنفيذ
env.pyالخاص بـ hub.
يعيد
dict[str, dict[int, gym.vector.VectorEnv]]
خريطة من اسم المجموعة إلى بيئات متجهية مفهرسة.
- للمعايير متعددة المهام (مثل LIBERO): إدخال واحد لكل مجموعة، وبيئة متجهية واحدة لكل task_id.
- لبيئات المهام المفردة: إدخال واحد في المجموعة (cfg.type) بقيمة task_id=0.
يرفع
ValueError أو ModuleNotFoundError
ValueError— إذا كان n_envs < 1ModuleNotFoundError— إذا لم يتم تثبيت حزمة البيئة المطلوبة
ينشئ بيئة متجهية من نوع gym وفقاً للإعداد أو المرجع الخاص بـ Hub.