LeRobot documentation
البيئات
البيئات
تُهيّأ بيئات المحاكاة من خلال EnvConfig وتُبنى بواسطة make_env، أو make_task_env لمهمة واحدة. تحتوي الإعدادات على الخيارات فقط؛ حيث تُحوّل دالتها sim_settings() هذه الخيارات إلى معاملات الكلمات المفتاحية الخاصة بتكامل المحاكي الخاص بها.
راجع Simulation لمعرفة كيفية استخدام البيئات، وEnvHub لاستخدام البيئات ونشرها على Hub، وAdding a Benchmark للمساهمة بإضافة واحدة.
HubEnvConfig
فئة lerobot.envs.HubEnvConfig
< 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 = 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
< 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 = Trueserver: EnvClientConfig | None = None )
خيارات البيئة. يبني make_env البيئة من sim_settings() الخاص بها.
تمت الإزالة: بناء بيئة مهمة واحدة باستخدام lerobot.envs.make_task_env(config, task_group, task_id, ...).
تمت الإزالة: أنشئ البيئات باستخدام lerobot.envs.make_env(config, n_envs, use_async_envs).
يعيد (المعالج المسبق، المعالج اللاحق) لهذا البيئة. الافتراضي: الهوية.
أعد sim_settings() مع الإعدادات الافتراضية للمحاكاة، كما تُنفَّذ في البيئات المحلية وخادم البيئة.
أعد إعدادات المحاكاة، كما في قسم sim في ملف YAML الخاص بالخادم؛ وتُستخدم القيم الافتراضية للمحاكاة لأي إعدادات مفقودة.
الافتراضي هو بيئة Gymnasium gym_id مع gym_kwargs وإجراءات دلتا؛ تجاوز ذلك في حال العكس.
make_env
lerobot.envs.make_env
< source >( 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
< source >( cfg: EnvConfigtask_group: str | None = Nonetask_id: int | None = Nonen_envs: int = 1use_async_envs: bool = False )
أنشئ بيئة المتجهات المحلية أو المُقدَّمة لمهمة واحدة؛ عدم تحديد task_id يعني استخدام المهمة الأولى في المجموعة.