From 15ef0041fb9e811df6f0adad91b25694ff7ebe09 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Wed, 18 Nov 2026 05:16:32 +0000 Subject: [PATCH 01/12] refactor(packaging)!: namespace the official extensions --- .../skills/add-embodiment-component/SKILL.md | 4 +- .agents/skills/add-robot/SKILL.md | 12 +- .agents/skills/add-task-env/SKILL.md | 6 +- .../references/handwritten-expert.md | 8 +- .agents/skills/add-task-env/references/rl.md | 4 +- .../references/task-program-expert.md | 2 +- .agents/skills/add-task-program/SKILL.md | 2 +- .../references/program-authoring.md | 2 +- .agents/skills/add-test/SKILL.md | 2 +- .../review-pr/references/review-matrix.md | 6 +- .ci/test-impact.toml | 4 +- .github/workflows/dataset-tooling.yml | 2 +- .github/workflows/main.yml | 46 +- AGENTS.md | 21 +- README.md | 28 +- agent_context/MAP.yaml | 48 +-- .../topics/assembly-assets/assembly-assets.md | 6 +- .../topics/atomic-actions/execution.md | 2 +- .../topics/data-assets/data-assets.md | 14 +- .../topics/data-pipeline/data-pipeline.md | 2 +- .../differentiable-env/differentiable-env.md | 4 +- .../topics/env-framework/configuration.md | 17 +- .../topics/env-framework/env-framework.md | 6 +- agent_context/topics/ik-solvers/ik-solvers.md | 2 +- .../topics/learning-layers/learning-layers.md | 2 +- .../topics/motion-planning/motion-planning.md | 8 +- .../topics/neural-dynamics/neural-dynamics.md | 14 +- .../topics/rl-learning/rl-learning.md | 2 +- agent_context/topics/rl-learning/training.md | 10 +- agent_context/topics/robot-system/catalogs.md | 4 +- .../topics/robot-system/robot-system.md | 16 +- .../robot-world-model/robot-world-model.md | 4 +- .../topics/simulation-system/fluids.md | 2 +- .../supervised-learning.md | 8 +- .../topics/task-programs/configuration.md | 4 +- .../topics/task-programs/task-programs.md | 8 +- docker/verify.py | 8 +- docs/architecture/curated.json | 43 +- docs/scripts/build_architecture.py | 5 - docs/scripts/check_api_docs.py | 24 +- docs/source/api_reference/agibot_g1.rst | 14 +- docs/source/api_reference/agibot_g2.rst | 8 +- docs/source/api_reference/aloha_mini.rst | 6 +- docs/source/api_reference/benchmarks.rst | 310 +++++++------- docs/source/api_reference/data/eef_assets.rst | 80 ++-- .../embodichain.lab.sim.robots.rst | 2 +- .../embodichain.learning.rl.algo.rst | 2 +- docs/source/api_reference/index.rst | 2 +- .../api_reference/locomotion_robots.rst | 64 +-- .../source/api_reference/locomotion_tasks.rst | 76 ++-- docs/source/api_reference/model_catalogs.rst | 40 +- .../api_reference/model_rigidformer.rst | 14 +- docs/source/api_reference/public_api.rst | 138 +++--- docs/source/api_reference/robot_catalogs.rst | 392 +++++++++--------- docs/source/api_reference/rwm.rst | 28 +- docs/source/api_reference/visual_act.rst | 32 +- docs/source/conf.py | 5 +- docs/source/features/neural_dynamics.md | 10 +- docs/source/features/neural_dynamics/nerd.md | 12 +- .../features/neural_dynamics/rigidformer.md | 6 +- docs/source/features/neural_dynamics/rwm.md | 8 +- .../features/neural_dynamics/worldparticle.md | 6 +- .../features/toolkits/grasp_generator.rst | 2 +- .../source/features/workspace_analyzer/cli.md | 2 +- .../workspace_analyzer/workspace_analyzer.md | 4 +- docs/source/guides/add_robot.rst | 8 +- docs/source/guides/cli.md | 12 +- docs/source/guides/configuration.md | 10 +- .../guides/configured_manipulation_rl.md | 2 +- docs/source/guides/expert_task_language.md | 4 +- docs/source/guides/lerobot.md | 2 +- docs/source/guides/offline_expert_datasets.md | 2 +- docs/source/guides/policy_evaluation.md | 2 +- docs/source/guides/rlinf.md | 4 +- docs/source/guides/robot_catalog.md | 6 +- docs/source/guides/run_task.md | 6 +- docs/source/guides/task_catalog.md | 8 +- docs/source/introduction.rst | 6 +- docs/source/overview/gym/env.md | 2 +- .../overview/learning/supervised_learning.md | 4 +- docs/source/overview/rl/index.rst | 2 +- docs/source/overview/rl/locomotion.md | 4 +- docs/source/overview/rl/multi_gpu.md | 2 +- docs/source/overview/rl/train_script.md | 6 +- .../overview/sim/motion/solvers/srs_solver.md | 4 +- .../sim/motion/solvers/ssik_solver.md | 6 +- .../overview/task_program/architecture.md | 4 +- docs/source/overview/task_program/index.md | 2 +- .../overview/task_program/quickstart.md | 10 +- docs/source/overview/task_program/recipes.md | 2 +- .../overview/task_program/troubleshooting.md | 2 +- .../overview/task_program/validation.md | 4 +- docs/source/quick_start/install.md | 10 +- docs/source/resources/publications/README.md | 6 +- docs/source/resources/robot/agibot/g2.md | 2 +- docs/source/resources/robot/agibot/index.rst | 2 +- .../resources/robot/agilex/cobotmagic.md | 4 +- .../robot/agilex/cobotmagic_gripper.md | 2 +- docs/source/resources/robot/agilex/index.rst | 2 +- docs/source/resources/robot/agilex/pika.md | 8 +- docs/source/resources/robot/agilex/piper_x.md | 4 +- .../resources/robot/alohamini/aloha_mini.md | 4 +- .../resources/robot/alohamini/index.rst | 2 +- .../resources/robot/anybotics/anymal_c.md | 4 +- .../resources/robot/anybotics/index.rst | 2 +- docs/source/resources/robot/arx/arx5.md | 6 +- docs/source/resources/robot/arx/index.rst | 2 +- docs/source/resources/robot/brainco/index.rst | 2 +- docs/source/resources/robot/brainco/revo1.md | 8 +- .../resources/robot/changingtek/ctm2f110.md | 6 +- .../resources/robot/changingtek/index.rst | 2 +- .../source/resources/robot/dexforce/index.rst | 2 +- docs/source/resources/robot/dexforce/w1.md | 6 +- .../resources/robot/dh_robotics/ag95.md | 6 +- .../resources/robot/dh_robotics/index.rst | 2 +- .../resources/robot/dh_robotics/pgc_140_50.md | 6 +- .../resources/robot/dh_robotics/pgi_140_80.md | 8 +- docs/source/resources/robot/dual_arm.md | 4 +- docs/source/resources/robot/end_effectors.md | 32 +- docs/source/resources/robot/flexiv/index.rst | 2 +- docs/source/resources/robot/flexiv/rizon4s.md | 2 +- docs/source/resources/robot/franka/cfg.md | 4 +- docs/source/resources/robot/franka/hand.md | 2 +- docs/source/resources/robot/franka/index.rst | 2 +- docs/source/resources/robot/franka/panda.md | 6 +- docs/source/resources/robot/i2rt/index.rst | 2 +- docs/source/resources/robot/i2rt/yam.md | 6 +- docs/source/resources/robot/index.rst | 2 +- docs/source/resources/robot/inspire/hand.md | 6 +- docs/source/resources/robot/inspire/index.rst | 2 +- .../resources/robot/pollen_robotics/index.rst | 2 +- .../robot/pollen_robotics/microduck.md | 4 +- .../resources/robot/robotiq/arg2f140.md | 2 +- .../source/resources/robot/robotiq/arg2f85.md | 2 +- docs/source/resources/robot/robotiq/assets.md | 6 +- docs/source/resources/robot/robotiq/index.rst | 2 +- .../resources/robot/robotiq/robotiq_2f85.md | 6 +- docs/source/resources/robot/sharpa/index.rst | 2 +- docs/source/resources/robot/sharpa/wave.md | 10 +- .../robot/the_robot_studio/index.rst | 2 +- .../resources/robot/the_robot_studio/so101.md | 2 +- docs/source/resources/robot/tianji/index.rst | 2 +- docs/source/resources/robot/tianji/marvin.md | 8 +- .../resources/robot/tianji/marvin_gripper.md | 2 +- docs/source/resources/robot/unitree/g1.md | 4 +- docs/source/resources/robot/unitree/go1.md | 4 +- docs/source/resources/robot/unitree/go2.md | 4 +- docs/source/resources/robot/unitree/h1_2.md | 4 +- docs/source/resources/robot/unitree/index.rst | 2 +- .../robot/universal_robots/index.rst | 2 +- .../robot/universal_robots/ur_robot.md | 2 +- docs/source/resources/robot/wheeltec/fa2f.md | 6 +- .../source/resources/robot/wheeltec/index.rst | 2 +- docs/source/resources/robot/wuji/hand.md | 10 +- docs/source/resources/robot/wuji/index.rst | 2 +- .../source/resources/task/classic_control.rst | 4 +- docs/source/resources/task/index.rst | 10 +- .../resources/task/locomotion/velocity.rst | 4 +- .../resources/task/manipulation/index.rst | 4 +- .../resources/task/manipulation/tableware.rst | 4 +- docs/source/resources/task/special.rst | 2 +- docs/source/tutorial/atomic_skills.rst | 2 +- docs/source/tutorial/data_expansion.rst | 14 +- docs/source/tutorial/modular_env.rst | 2 +- docs/source/tutorial/rl.rst | 16 +- docs/source/tutorial/task_program.rst | 22 +- embodichain/cli/_task_catalog.py | 20 +- embodichain/cli/benchmark.py | 6 +- embodichain/data/assets/locomotion_assets.py | 12 +- embodichain/data/assets/robot_assets.py | 16 +- embodichain/data/assets/so101_assets.py | 2 +- embodichain/data/assets/w1_assets.py | 20 +- embodichain/extensions/README.md | 32 ++ embodichain/extensions/__init__.py | 21 + .../extensions/benchmarks}/__init__.py | 0 .../benchmarks}/assembly/__init__.py | 0 .../benchmarks}/assembly/_many_metrics.py | 0 .../extensions/benchmarks}/assembly/_warp.py | 0 .../benchmarks}/assembly/precision.py | 0 .../extensions/benchmarks}/assembly/probes.py | 0 .../motion_generation/BENCHMARK_DESIGN.md | 4 +- .../benchmarks}/motion_generation/README.md | 83 ++-- .../benchmarks}/motion_generation/__init__.py | 0 .../benchmarks}/motion_generation/__main__.py | 0 .../motion_generation/_aggregation_policy.py | 0 .../motion_generation/_atomic_fixtures.py | 8 +- .../motion_generation/_case_preparation.py | 0 .../_paired_arm_performance.py | 0 .../motion_generation/_quality_batching.py | 0 .../motion_generation/_tcp_presets.py | 0 .../motion_generation/aggregation.py | 0 .../benchmarks}/motion_generation/api.py | 0 .../motion_generation/artifacts.py | 2 +- .../motion_generation/atomic_skill.py | 0 .../benchmarks}/motion_generation/cli.py | 0 .../benchmarks}/motion_generation/config.py | 0 .../motion_generation/contracts.py | 0 .../motion_generation/embodiments.py | 0 .../motion_generation/evaluation.py | 0 .../motion_generation/generalization.py | 0 .../benchmarks}/motion_generation/limits.py | 0 .../motion_generation/metrics/__init__.py | 0 .../motion_generation/metrics/_constraints.py | 0 .../motion_generation/metrics/performance.py | 0 .../motion_generation/metrics/stats.py | 0 .../motion_generation/metrics/trajectory.py | 0 .../benchmarks}/motion_generation/models.py | 0 .../benchmarks}/motion_generation/parallel.py | 0 .../motion_generation/planners/__init__.py | 0 .../planners/_constraints.py | 0 .../motion_generation/planners/base.py | 0 .../motion_generation/planners/curobo.py | 0 .../planners/ik_interpolate.py | 0 .../motion_generation/planners/nmg_onnx.py | 0 .../motion_generation/planners/toppra.py | 0 .../benchmarks}/motion_generation/registry.py | 0 .../motion_generation/reporting.py | 0 .../motion_generation/robots/__init__.py | 0 .../motion_generation/robots/base.py | 0 .../motion_generation/robots/dual_arm.py | 0 .../motion_generation/robots/franka.py | 0 .../motion_generation/robots/ur5.py | 2 +- .../benchmarks}/motion_generation/runner.py | 0 .../motion_generation/scenarios/__init__.py | 0 .../scenarios/_atomic_pose_sampling.py | 0 .../scenarios/_atomic_reference.py | 0 .../scenarios/_atomic_targets.py | 0 .../scenarios/_case_qualification.py | 0 .../scenarios/_free_space_proposals.py | 0 .../scenarios/_free_space_sampling.py | 0 .../scenarios/_grasp_contacts.py | 0 .../scenarios/_placement_geometry.py | 0 .../scenarios/_placement_qualification.py | 0 .../scenarios/_replay_diagnostics.py | 0 .../scenarios/atomic_case_utils.py | 0 .../scenarios/atomic_contact_cases.py | 0 .../scenarios/atomic_dual_arm_providers.py | 0 .../scenarios/atomic_evaluation.py | 0 .../scenarios/atomic_grasps.py | 0 .../scenarios/atomic_manipulation_cases.py | 0 .../scenarios/atomic_motion_cases.py | 0 .../scenarios/atomic_objects.py | 0 .../scenarios/atomic_policy.py | 0 .../scenarios/atomic_replay.py | 0 .../scenarios/atomic_skill.py | 0 .../scenarios/atomic_skill_providers.py | 0 .../motion_generation/scenarios/base.py | 0 .../motion_generation/scenarios/free_space.py | 0 ..._franka_robotiq_coordinated_placement.yaml | 0 .../atomic_dual_franka_robotiq_hand_over.yaml | 0 ...mic_dual_ur5_pgi_coordinated_pickment.yaml | 0 ...nated_pickment_spatial_generalization.yaml | 0 ...ic_dual_ur5_pgi_coordinated_placement.yaml | 0 ...ated_placement_spatial_generalization.yaml | 0 .../suites/atomic_dual_ur5_pgi_hand_over.yaml | 0 ..._pgi_hand_over_spatial_generalization.yaml | 0 ...c_franka_robotiq_door_pour_align_push.yaml | 0 .../atomic_franka_robotiq_pose_batch.yaml | 0 .../atomic_franka_robotiq_randomized.yaml | 0 .../suites/atomic_franka_robotiq_smoke.yaml | 0 ...franka_robotiq_spatial_generalization.yaml | 0 .../suites/atomic_ur5_embodiment.yaml | 2 +- .../suites/atomic_ur5_pgi_randomized.yaml | 0 .../motion_panda_free_space_coverage.yaml | 0 .../suites/motion_panda_free_space_smoke.yaml | 0 .../motion_ur5_free_space_coverage.yaml | 0 .../benchmarks}/motion_generation/video.py | 0 .../extensions/models}/README.md | 44 +- .../extensions/models}/__init__.py | 0 .../extensions/models}/dynamics/__init__.py | 0 .../dynamics/nerd/THIRD_PARTY_LICENSES | 0 .../models}/dynamics/nerd/__init__.py | 0 .../models}/dynamics/nerd/_numerics.py | 0 .../models}/dynamics/nerd/_resident.py | 0 .../models}/dynamics/nerd/checkpoint.py | 0 .../extensions/models}/dynamics/nerd/codec.py | 0 .../extensions/models}/dynamics/nerd/data.py | 0 .../models}/dynamics/nerd/geometry.py | 0 .../models}/dynamics/nerd/integration.py | 0 .../extensions/models}/dynamics/nerd/model.py | 0 .../models}/dynamics/nerd/sl_recipe.py | 0 .../models}/dynamics/nerd/supervised.py | 0 .../models}/dynamics/nerd/transition.py | 0 .../rigidformer/REFERENCE_SOURCES.json | 0 .../dynamics/rigidformer/THIRD_PARTY_LICENSES | 0 .../models}/dynamics/rigidformer/__init__.py | 0 .../dynamics/rigidformer/_native/__init__.py | 0 .../dynamics/rigidformer/_native/attention.py | 0 .../rigidformer/_native/data/__init__.py | 0 .../rigidformer/_native/data/_index.py | 0 .../rigidformer/_native/data/dataset.py | 0 .../_native/data/gpu_augmentation.py | 0 .../rigidformer/_native/data/object_scale.py | 0 .../rigidformer/_native/data/scene_frames.py | 0 .../rigidformer/_native/models/__init__.py | 0 .../_native/models/anchor_vertex_pooling.py | 0 .../rigidformer/_native/models/decoder.py | 6 +- .../rigidformer/_native/models/encoder.py | 0 .../_native/models/geometry_encoders.py | 0 .../_native/models/multi_scale_predictor.py | 2 +- .../_native/models/physformer_rope.py | 0 .../rigidformer/_native/models/predictor.py | 0 .../_native/models/se3_attention.py | 2 +- .../rigidformer/_native/models/state.py | 0 .../_native/models/transform_layer.py | 0 .../dynamics/rigidformer/_native/network.py | 16 +- .../rigidformer/_native/utils/__init__.py | 0 .../_native/utils/anchor_rotation.py | 0 .../rigidformer/_native/utils/cuda_knn.py | 0 .../_native/utils/intersection_handler.py | 0 .../rigidformer/_native/utils/weight_ema.py | 0 .../dynamics/rigidformer/checkpoint.py | 0 .../dynamics/rigidformer/configs/movi_a.yaml | 0 .../dynamics/rigidformer/configs/movi_b.yaml | 0 .../rigidformer/configs/movi_sphere.yaml | 0 .../models}/dynamics/rigidformer/data.py | 0 .../models}/dynamics/rigidformer/ema.py | 0 .../models}/dynamics/rigidformer/model.py | 0 .../models}/dynamics/rigidformer/sl_recipe.py | 0 .../dynamics/rigidformer/supervised.py | 0 .../models}/dynamics/rwm/__init__.py | 0 .../models}/dynamics/rwm/kinematic.py | 0 .../extensions/models}/dynamics/rwm/model.py | 2 +- .../models}/dynamics/rwm/predictor.py | 0 .../extensions/models}/dynamics/rwm/replay.py | 0 .../models}/dynamics/rwm/robot_state.py | 0 .../models}/dynamics/rwm/sl_recipe.py | 0 .../models}/dynamics/rwm/supervised.py | 0 .../dynamics/worldparticle/LICENSE.tome | 0 .../worldparticle/LICENSE.worldparticle | 0 .../dynamics/worldparticle/PROVENANCE.json | 0 .../dynamics/worldparticle/__init__.py | 0 .../dynamics/worldparticle/_network/_data.py | 0 .../worldparticle/_network/continuous_conv.py | 0 .../worldparticle/_network/cross_attn_feat.py | 0 .../_network/encodings/rms_norm.py | 0 .../worldparticle/_network/encodings/rope.py | 0 .../_network/layers/attention.py | 0 .../worldparticle/_network/layers/merge.py | 0 .../particle_network_cross_attn_feat.py | 0 .../_network/super_particle_layers.py | 0 .../dynamics/worldparticle/_runtime.py | 0 .../models}/dynamics/worldparticle/data.py | 0 .../models}/dynamics/worldparticle/model.py | 0 .../extensions/models}/policies/__init__.py | 0 .../models}/policies/motion_tracking.py | 0 .../extensions/models}/policy/__init__.py | 0 .../extensions/models}/policy/act/__init__.py | 0 .../extensions/models}/policy/act/runtime.py | 0 .../extensions/models}/policy/act/training.py | 0 .../extensions/robots}/README.md | 36 +- .../extensions/robots}/__init__.py | 0 .../extensions/robots/_asset_catalog.py | 194 +++++++++ .../extensions/robots}/_catalog.py | 74 ++-- .../extensions/robots}/_locomotion.py | 0 .../robots}/_ssik_artifacts/LICENSE.txt | 0 .../robots}/_ssik_artifacts/arx5.json | 0 .../robots}/_ssik_artifacts/arx5.py | 0 .../_ssik_artifacts/flexiv_rizon4s.json | 0 .../robots}/_ssik_artifacts/flexiv_rizon4s.py | 0 .../extensions/robots}/agibot/__init__.py | 0 .../extensions/robots}/agibot/g1/README.md | 0 .../extensions/robots}/agibot/g1/__init__.py | 0 .../extensions/robots}/agibot/g1/assets.py | 0 .../extensions/robots}/agibot/g1/cfg.py | 0 .../extensions/robots}/agibot/g1/preview.png | Bin .../extensions/robots}/agibot/g2/LICENSE | 0 .../extensions/robots}/agibot/g2/README.md | 6 +- .../extensions/robots}/agibot/g2/__init__.py | 0 .../extensions/robots}/agibot/g2/_generate.py | 0 .../extensions/robots}/agibot/g2/_preview.py | 0 .../extensions/robots}/agibot/g2/assets.py | 0 .../extensions/robots}/agibot/g2/cfg.py | 0 .../extensions/robots}/agibot/g2/g2.urdf | 0 .../extensions/robots}/agibot/g2/preview.png | Bin .../robots}/agibot/g2/preview.render.json | 0 .../robots}/agibot/g2/source.lock.json | 0 .../extensions/robots}/agilex/__init__.py | 0 .../extensions/robots}/agilex/_arm_assets.py | 0 .../robots}/agilex/agx_gripper/README.md | 0 .../robots}/agilex/agx_gripper/__init__.py | 0 .../robots}/agilex/agx_gripper/assets.py | 0 .../robots}/agilex/cobotmagic/__init__.py | 0 .../robots}/agilex/cobotmagic/assets.py | 0 .../robots}/agilex/cobotmagic/cfg.py | 2 +- .../agilex/cobotmagic/gripper/__init__.py | 0 .../cobotmagic/gripper/_gripper_defaults.py | 0 .../robots}/agilex/cobotmagic/gripper/cfg.py | 0 .../extensions/robots}/agilex/pika/README.md | 2 +- .../robots}/agilex/pika/__init__.py | 0 .../robots}/agilex/pika/_gripper_defaults.py | 0 .../extensions/robots}/agilex/pika/assets.py | 0 .../extensions/robots}/agilex/pika/cfg.py | 0 .../robots}/agilex/piper_x/README.md | 0 .../robots}/agilex/piper_x/__init__.py | 0 .../robots}/agilex/piper_x/assets.py | 0 .../extensions/robots}/agilex/piper_x/cfg.py | 0 .../extensions/robots}/alohamini/__init__.py | 0 .../robots}/alohamini/aloha_mini/__init__.py | 0 .../robots}/alohamini/aloha_mini/assets.py | 0 .../robots}/alohamini/aloha_mini/cfg.py | 0 .../extensions/robots}/anybotics/__init__.py | 0 .../robots}/anybotics/anymal_c/__init__.py | 0 .../robots}/anybotics/anymal_c/assets.py | 0 .../robots}/anybotics/anymal_c/cfg.py | 0 .../robots}/anybotics/anymal_c/profile.json | 0 .../extensions/robots}/arx/__init__.py | 0 .../extensions/robots}/arx/arx5/__init__.py | 0 .../extensions/robots}/arx/arx5/assets.py | 0 .../extensions/robots}/arx/arx5/cfg.py | 0 .../extensions/robots}/brainco/__init__.py | 0 .../robots}/brainco/revo1/README.md | 0 .../robots}/brainco/revo1/__init__.py | 0 .../robots}/brainco/revo1/_specs.py | 0 .../robots}/brainco/revo1/assets.py | 2 +- .../extensions/robots}/brainco/revo1/cfg.py | 0 .../robots}/changingtek/__init__.py | 0 .../robots}/changingtek/ctm2f110/README.md | 0 .../robots}/changingtek/ctm2f110/__init__.py | 0 .../robots}/changingtek/ctm2f110/assets.py | 2 +- .../extensions/robots}/dexforce/__init__.py | 0 .../robots}/dexforce/w1/__init__.py | 0 .../extensions/robots}/dexforce/w1/assets.py | 0 .../extensions/robots}/dexforce/w1/cfg.py | 15 +- .../robots}/dexforce/w1/hand_specs.py | 4 +- .../extensions/robots}/dexforce/w1/params.py | 4 +- .../extensions/robots}/dexforce/w1/specs.py | 0 .../extensions/robots}/dexforce/w1/types.py | 0 .../extensions/robots}/dexforce/w1/utils.py | 6 +- .../robots}/dh_robotics/__init__.py | 0 .../robots}/dh_robotics/ag95/README.md | 0 .../robots}/dh_robotics/ag95/__init__.py | 0 .../robots}/dh_robotics/ag95/assets.py | 2 +- .../robots}/dh_robotics/pgc_140_50/README.md | 0 .../dh_robotics/pgc_140_50/__init__.py | 0 .../robots}/dh_robotics/pgc_140_50/_specs.py | 0 .../robots}/dh_robotics/pgc_140_50/assets.py | 4 +- .../robots}/dh_robotics/pgi_140_80/README.md | 0 .../dh_robotics/pgi_140_80/__init__.py | 0 .../pgi_140_80/_gripper_defaults.py | 0 .../robots}/dh_robotics/pgi_140_80/assets.py | 2 +- .../robots}/dh_robotics/pgi_140_80/cfg.py | 0 .../extensions/robots}/flexiv/__init__.py | 0 .../robots}/flexiv/rizon4s/__init__.py | 0 .../robots}/flexiv/rizon4s/assets.py | 0 .../extensions/robots}/flexiv/rizon4s/cfg.py | 0 .../extensions/robots}/franka/README.md | 2 +- .../extensions/robots}/franka/__init__.py | 0 .../extensions/robots}/franka/_physics.py | 0 .../extensions/robots}/franka/_specs.py | 0 .../extensions/robots}/franka/assets.py | 0 .../extensions/robots}/franka/cfg.py | 0 .../robots}/franka/hand/__init__.py | 0 .../robots}/franka/hand/_gripper_defaults.py | 0 .../extensions/robots}/franka/hand/cfg.py | 0 .../extensions/robots}/franka/panda.py | 2 +- .../extensions/robots}/i2rt/__init__.py | 0 .../extensions/robots}/i2rt/yam/README.md | 0 .../extensions/robots}/i2rt/yam/__init__.py | 0 .../extensions/robots}/i2rt/yam/assets.py | 0 .../extensions/robots}/i2rt/yam/cfg.py | 0 .../extensions/robots}/inspire/__init__.py | 0 .../extensions/robots}/inspire/hand/README.md | 0 .../robots}/inspire/hand/__init__.py | 0 .../extensions/robots}/inspire/hand/assets.py | 2 +- .../extensions/robots}/locomotion_profiles.py | 12 +- .../robots}/pollen_robotics/__init__.py | 0 .../pollen_robotics/microduck/__init__.py | 0 .../pollen_robotics/microduck/assets.py | 0 .../robots}/pollen_robotics/microduck/cfg.py | 0 .../pollen_robotics/microduck/profile.json | 0 .../extensions/robots}/robotiq/README.md | 0 .../extensions/robots}/robotiq/__init__.py | 0 .../robots}/robotiq/arg2f140/__init__.py | 0 .../robotiq/arg2f140/_gripper_defaults.py | 0 .../robots}/robotiq/arg2f140/cfg.py | 0 .../robots}/robotiq/arg2f85/__init__.py | 0 .../robotiq/arg2f85/_gripper_defaults.py | 0 .../extensions/robots}/robotiq/arg2f85/cfg.py | 0 .../extensions/robots}/robotiq/assets.py | 2 +- .../robots}/robotiq/robotiq_2f85/README.md | 0 .../robots}/robotiq/robotiq_2f85/__init__.py | 0 .../robots}/robotiq/robotiq_2f85/assets.py | 2 +- .../extensions/robots}/robotiq/two_finger.py | 0 .../extensions/robots}/sharpa/__init__.py | 0 .../extensions/robots}/sharpa/wave/README.md | 0 .../robots}/sharpa/wave/__init__.py | 0 .../extensions/robots}/sharpa/wave/assets.py | 2 +- .../extensions/robots}/sharpa/wave/cfg.py | 0 .../robots}/the_robot_studio/__init__.py | 0 .../the_robot_studio/so101/__init__.py | 0 .../robots}/the_robot_studio/so101/assets.py | 0 .../robots}/the_robot_studio/so101/cfg.py | 0 .../extensions/robots}/tianji/__init__.py | 0 .../robots}/tianji/marvin/__init__.py | 0 .../robots}/tianji/marvin/assets.py | 0 .../extensions/robots}/tianji/marvin/cfg.py | 0 .../robots}/tianji/marvin/gripper/__init__.py | 0 .../marvin/gripper/_gripper_defaults.py | 0 .../robots}/tianji/marvin/gripper/cfg.py | 0 .../extensions/robots}/unitree/__init__.py | 0 .../extensions/robots}/unitree/g1/__init__.py | 0 .../extensions/robots}/unitree/g1/assets.py | 0 .../extensions/robots}/unitree/g1/cfg.py | 0 .../robots}/unitree/g1/profile.json | 0 .../robots}/unitree/go1/__init__.py | 0 .../extensions/robots}/unitree/go1/assets.py | 0 .../extensions/robots}/unitree/go1/cfg.py | 0 .../robots}/unitree/go1/profile.json | 0 .../robots}/unitree/go2/__init__.py | 0 .../extensions/robots}/unitree/go2/assets.py | 0 .../extensions/robots}/unitree/go2/cfg.py | 0 .../robots}/unitree/go2/profile.json | 0 .../robots}/unitree/h1_2/__init__.py | 0 .../extensions/robots}/unitree/h1_2/assets.py | 0 .../extensions/robots}/unitree/h1_2/cfg.py | 0 .../robots}/unitree/h1_2/profile.json | 0 .../robots}/universal_robots/__init__.py | 0 .../robots}/universal_robots/assets.py | 0 .../robots}/universal_robots/ur_robot.py | 0 .../extensions/robots}/wheeltec/__init__.py | 0 .../robots}/wheeltec/fa2f/README.md | 0 .../robots}/wheeltec/fa2f/__init__.py | 0 .../robots}/wheeltec/fa2f/assets.py | 2 +- .../extensions/robots}/wuji/__init__.py | 0 .../extensions/robots}/wuji/hand/README.md | 0 .../extensions/robots}/wuji/hand/__init__.py | 0 .../extensions/robots}/wuji/hand/assets.py | 2 +- .../extensions/robots}/wuji/hand/cfg.py | 0 .../extensions/solvers}/README.md | 22 +- .../extensions/solvers}/__init__.py | 0 .../extensions/solvers}/physics/__init__.py | 0 .../solvers}/physics/nerd/__init__.py | 0 .../solvers}/physics/nerd/_binding.py | 4 +- .../solvers}/physics/nerd/provider.py | 9 +- .../physics/worldparticle/__init__.py | 0 .../physics/worldparticle/provider.py | 10 +- .../extensions/tasks}/README.md | 57 +-- .../extensions/tasks}/__init__.py | 24 +- .../tasks}/classic_control/__init__.py | 0 .../tasks}/classic_control/cart_pole.py | 0 .../classic_control/humanoid/__init__.py | 0 .../classic_control/humanoid/humanoid_run.py | 2 +- .../tasks}/classic_control/humanoid/mdp.py | 0 .../tasks}/classic_control/point_mass.py | 0 .../extensions/tasks}/configs/__init__.py | 2 +- .../components/embodiments/cobotmagic.yaml | 0 .../dexforce_w1_030_cloth_fold.yaml | 0 .../embodiments/dexforce_w1_030_pika.md | 8 +- .../embodiments/dexforce_w1_030_pika.yaml | 0 .../dual_franka_robotiq_arg2f_140.yaml | 0 .../dual_franka_robotiq_arg2f_140_gensim.yaml | 0 ...ual_franka_robotiq_arg2f_140_handover.yaml | 0 .../dual_ur10_robotiq_arg2f_140.yaml | 0 .../dual_ur10_robotiq_arg2f_140_gensim.yaml | 0 .../embodiments/dual_ur5_dh_pgi_140_80.yaml | 0 .../embodiments/franka_gs_dual_camera.yaml | 0 .../components/embodiments/franka_panda.yaml | 0 .../embodiments/franka_panda_cartesian.yaml | 0 .../embodiments/franka_panda_fast_fluid.yaml | 0 .../embodiments/franka_panda_rgb_224.yaml | 0 .../embodiments/franka_panda_robotiq85.yaml | 0 .../franka_panda_robotiq85_rgbd.yaml | 0 .../embodiments/piper_x_agx_gripper.yaml | 0 .../components/embodiments/tianji_marvin.yaml | 2 +- .../embodiments/ur5_dh_pgi_140_80.yaml | 0 .../embodiments/ur5_dh_pgi_140_80_rgbd.yaml | 0 .../franka_gs_verified.yaml | 0 .../motion_gen_projected_manipulation.yaml | 0 .../motion_gen_verified.yaml | 0 .../execution_policies/real2sim_verified.yaml | 0 .../sequential_ik_projected_manipulation.yaml | 0 .../sequential_ik_verified.yaml | 0 .../trajectory_open_loop.yaml | 0 ...ctory_open_loop_dual_arm_manipulation.yaml | 0 .../trajectory_open_loop_fluid_pour.yaml | 0 .../task_program_episode.yaml | 2 +- .../cube_initial_pose.yaml | 0 .../randomization_profiles/rgb_visual.yaml | 0 .../cart_pole/agents/grpo.json | 2 +- .../cart_pole/agents/grpo.yaml | 2 +- .../classic_control/cart_pole/agents/ppo.json | 2 +- .../classic_control/cart_pole/agents/ppo.yaml | 2 +- .../classic_control/cart_pole/catalog.yaml | 0 .../tasks/classic_control/cart_pole/env.json | 0 .../tasks/classic_control/cart_pole/env.yaml | 0 .../tasks/classic_control/humanoid/README.md | 8 +- .../humanoid/agents/ppo.newton.yaml | 2 +- .../classic_control/humanoid/agents/ppo.yaml | 2 +- .../classic_control/humanoid/catalog.yaml | 0 .../classic_control/humanoid/env.newton.yaml | 0 .../tasks/classic_control/humanoid/env.yaml | 0 .../tasks/classic_control/humanoid/task.json | 0 .../point_mass/agents/apg.yaml | 0 .../point_mass/agents/apg_actor_critic.yaml | 0 .../point_mass/agents/ppo.yaml | 0 .../locomotion/tracking/g1_motion/README.md | 6 +- .../g1_motion/agents/model_based.yaml | 4 +- .../agents/model_based_development.yaml | 4 +- .../agents/model_based_fixed_wm.yaml | 4 +- .../g1_motion/agents/model_based_full.yaml | 4 +- .../tracking/g1_motion/agents/ppo.yaml | 2 +- .../tracking/g1_motion/env.dexuni.yaml | 0 .../tracking/g1_motion/env.newton.yaml | 0 .../velocity/anymal_c_flat/README.md | 6 +- .../anymal_c_flat/agents/ppo.newton.yaml | 2 +- .../velocity/anymal_c_flat/agents/ppo.yaml | 2 +- .../velocity/anymal_c_flat/catalog.yaml | 0 .../velocity/anymal_c_flat/env.newton.yaml | 0 .../velocity/anymal_c_flat/env.yaml | 0 .../velocity/anymal_c_flat/task.json | 0 .../locomotion/velocity/g1_flat/README.md | 6 +- .../velocity/g1_flat/agents/ppo.newton.yaml | 2 +- .../velocity/g1_flat/agents/ppo.yaml | 2 +- .../locomotion/velocity/g1_flat/catalog.yaml | 0 .../velocity/g1_flat/env.newton.yaml | 0 .../locomotion/velocity/g1_flat/env.yaml | 0 .../locomotion/velocity/g1_flat/task.json | 0 .../locomotion/velocity/go1_flat/README.md | 6 +- .../velocity/go1_flat/agents/ppo.newton.yaml | 2 +- .../velocity/go1_flat/agents/ppo.yaml | 2 +- .../locomotion/velocity/go1_flat/catalog.yaml | 0 .../velocity/go1_flat/env.newton.yaml | 0 .../locomotion/velocity/go1_flat/env.yaml | 0 .../locomotion/velocity/go1_flat/task.json | 0 .../locomotion/velocity/go2_flat/README.md | 6 +- .../velocity/go2_flat/agents/ppo.newton.yaml | 2 +- .../velocity/go2_flat/agents/ppo.yaml | 2 +- .../locomotion/velocity/go2_flat/catalog.yaml | 0 .../velocity/go2_flat/env.newton.yaml | 0 .../locomotion/velocity/go2_flat/env.yaml | 0 .../locomotion/velocity/go2_flat/task.json | 0 .../locomotion/velocity/h1_2_flat/README.md | 6 +- .../velocity/h1_2_flat/agents/ppo.newton.yaml | 2 +- .../velocity/h1_2_flat/agents/ppo.yaml | 2 +- .../velocity/h1_2_flat/catalog.yaml | 0 .../velocity/h1_2_flat/env.newton.yaml | 0 .../locomotion/velocity/h1_2_flat/env.yaml | 0 .../locomotion/velocity/h1_2_flat/task.json | 0 .../velocity/microduck_flat/README.md | 6 +- .../microduck_flat/agents/ppo.newton.yaml | 2 +- .../velocity/microduck_flat/agents/ppo.yaml | 2 +- .../velocity/microduck_flat/catalog.yaml | 0 .../velocity/microduck_flat/env.newton.yaml | 0 .../velocity/microduck_flat/env.yaml | 0 .../velocity/microduck_flat/task.json | 0 .../manipulation/carton_stocking/README.md | 2 +- .../manipulation/carton_stocking/catalog.yaml | 0 .../manipulation/carton_stocking/env.yaml | 0 .../carton_stocking/real2sim/collection.yaml | 0 .../carton_stocking/task.panda.rgbd.yaml | 0 .../carton_stocking/task.panda.yaml | 0 .../task_program/integration.ordinary.yaml | 0 .../task_program/integration.yaml | 0 .../carton_stocking/task_program/program.yaml | 0 .../tasks/manipulation/cloth_fold/README.md | 2 +- .../manipulation/cloth_fold/catalog.yaml | 0 .../tasks/manipulation/cloth_fold/env.yaml | 0 .../manipulation/cloth_fold/task.w1.yaml | 0 .../cloth_fold/task_program/evaluation.yaml | 0 .../cloth_fold/task_program/integration.yaml | 0 .../cloth_fold/task_program/program.yaml | 0 .../cloth_fold/task_program/trajectory.npz | Bin .../manipulation/drawer_storage/README.md | 6 +- .../manipulation/drawer_storage/catalog.yaml | 0 .../drawer_storage/env.long_horizon.yaml | 0 .../manipulation/drawer_storage/env.yaml | 0 .../drawer_storage/task.franka.yaml | 0 .../drawer_storage/task.ur5.long_horizon.yaml | 0 .../manipulation/drawer_storage/task.ur5.yaml | 0 .../task_program/evaluation.long_horizon.yaml | 0 .../task_program/evaluation.yaml | 0 .../task_program/execution_policy.franka.yaml | 0 .../execution_policy.long_horizon.yaml | 0 .../task_program/integration.franka.yaml | 0 .../integration.long_horizon.yaml | 0 .../task_program/integration.yaml | 0 .../task_program/program.long_horizon.yaml | 0 .../drawer_storage/task_program/program.yaml | 0 .../gaussian_pick_place/README.md | 4 +- .../gaussian_pick_place/catalog.yaml | 0 .../gaussian_pick_place/env.discoverse.yaml | 0 .../gaussian_pick_place/env.office.yaml | 0 .../gaussian_pick_place/env.robosimgs.yaml | 0 .../gaussian_pick_place/task.discoverse.yaml | 0 .../gaussian_pick_place/task.office.yaml | 0 .../gaussian_pick_place/task.robosimgs.yaml | 0 .../task_program/integration.yaml | 0 .../task_program/program.discoverse.yaml | 0 .../task_program/program.office.yaml | 0 .../task_program/program.robosimgs.yaml | 0 .../tasks/manipulation/hand_over/README.md | 2 +- .../tasks/manipulation/hand_over/catalog.yaml | 0 .../hand_over/env.dexforce_w1_030_pika.yaml | 0 .../tasks/manipulation/hand_over/env.yaml | 0 .../envs/dual_franka_robotiq140.default.yaml | 0 .../hand_over/envs/tabletop.default.yaml | 0 .../hand_over/task.dexforce_w1_030_pika.yaml | 0 .../task.dual_franka_robotiq_arg2f_140.yaml | 0 .../manipulation/hand_over/task.dual_ur5.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../hand_over/task.tianji_marvin.yaml | 0 .../integration.dexforce_w1_030_pika.yaml | 0 .../task_program/integration.robotiq140.yaml | 0 .../integration.tianji_marvin.yaml | 0 .../hand_over/task_program/integration.yaml | 0 .../hand_over/task_program/program.bar.yaml | 0 .../task_program/program.tabletop.yaml | 0 .../task_program/program.upright_can.yaml | 0 .../hand_over/task_program/program.yaml | 0 .../tasks/manipulation/open_drawer/README.md | 2 +- .../manipulation/open_drawer/catalog.yaml | 0 .../open_drawer/envs/default.yaml | 0 .../manipulation/open_drawer/envs/newton.yaml | 0 .../open_drawer/expansion/open_drawer.yaml | 0 .../manipulation/open_drawer/task.franka.yaml | 0 .../manipulation/open_drawer/task.ur5.yaml | 0 .../open_drawer/task_program/integration.yaml | 0 .../open_drawer/task_program/program.yaml | 0 .../tasks/manipulation/push_cube/README.md | 8 +- .../manipulation/push_cube/agents/grpo.json | 2 +- .../push_cube/agents/ppo.configured_rl.yaml | 2 +- .../manipulation/push_cube/agents/ppo.json | 2 +- .../tasks/manipulation/push_cube/catalog.yaml | 0 .../push_cube/env.configured_rl.yaml | 0 .../tasks/manipulation/push_cube/env.json | 0 .../manipulation/push_cube/env.visual.yaml | 0 .../push_cube/task.franka.visual.yaml | 0 .../repeated_pick_place/README.md | 12 +- .../repeated_pick_place/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../repeated_pick_place/envs/default.yaml | 0 .../envs/dual_franka_robotiq140.default.yaml | 0 .../envs/dual_ur10_robotiq140.default.yaml | 0 .../repeated_pick_place/envs/newton.yaml | 0 .../envs/tabletop.default.yaml | 0 .../expansion/repeated_pick_place.yaml | 0 .../repeated_pick_place/objective.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_franka_robotiq_arg2f_140.yaml | 0 ....dual_franka_robotiq_arg2f_140_gensim.yaml | 0 .../task.dual_ur10_robotiq_arg2f_140.yaml | 0 ...sk.dual_ur10_robotiq_arg2f_140_gensim.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../repeated_pick_place/task.franka.yaml | 0 .../task.tianji_marvin.yaml | 0 .../task.ur5.objective.yaml | 0 .../repeated_pick_place/task.ur5.yaml | 0 .../task_program/integration.robotiq140.yaml | 0 .../task_program/integration.tabletop.yaml | 0 .../task_program/integration.yaml | 0 .../program.robotiq_workbench.yaml | 0 .../task_program/program.tabletop.yaml | 0 .../task_program/program.workbench.yaml | 0 .../task_program/program.yaml | 0 .../rubiks_cube_pick_place/catalog.yaml | 0 .../rubiks_cube_pick_place/env.yaml | 0 .../rubiks_cube_pick_place/task.ur5.yaml | 0 .../task_program/integration.yaml | 0 .../task_program/program.yaml | 0 .../tableware/blocks_ranking_rgb/README.md | 2 +- .../tableware/blocks_ranking_rgb/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../tableware/blocks_ranking_rgb/env.yaml | 0 .../blocks_ranking_rgb/task.cobotmagic.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../task.tianji_marvin.yaml | 0 .../task_program/integration.yaml | 0 .../task_program/program.yaml | 0 .../blocks_ranking_size/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../tableware/blocks_ranking_size/env.json | 0 .../tableware/blocks_ranking_size/env.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../task.tianji_marvin.yaml | 0 .../match_object_container/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../tableware/match_object_container/env.json | 0 .../tableware/match_object_container/env.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../task.tianji_marvin.yaml | 0 .../place_object_drawer/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../tableware/place_object_drawer/env.json | 0 .../tableware/place_object_drawer/env.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../task.tianji_marvin.yaml | 0 .../manipulation/tableware/pour_cup/README.md | 6 +- .../tableware/pour_cup/env.fluid.yaml | 0 .../tableware/pour_cup/task.franka.fluid.yaml | 0 .../task_program/integration.fluid.yaml | 0 .../pour_cup/task_program/program.fluid.yaml | 0 .../tableware/pour_water/README.md | 8 +- .../tableware/pour_water/catalog.yaml | 0 .../pour_water/env.dexforce_w1_030_pika.yaml | 0 .../pour_water/env.tianji_marvin.yaml | 0 .../tableware/pour_water/env.yaml | 0 .../tableware/pour_water/task.cobotmagic.yaml | 0 .../pour_water/task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../pour_water/task.tianji_marvin.yaml | 0 .../pour_water/task_program/evaluation.yaml | 0 .../integration.dexforce_w1_030_pika.yaml | 0 .../task_program/integration.dual_arm.yaml | 0 .../pour_water/task_program/integration.yaml | 0 .../task_program/program.tianji_marvin.yaml | 0 .../task_program/program.workbench.yaml | 0 .../pour_water/task_program/program.yaml | 0 .../tableware/stack_blocks_two/README.md | 2 +- .../tableware/stack_blocks_two/catalog.yaml | 0 .../env.dexforce_w1_030_pika.yaml | 0 .../stack_blocks_two/env.policy.yaml | 0 .../tableware/stack_blocks_two/env.yaml | 0 .../stack_blocks_two/task.cobotmagic.yaml | 0 .../task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../task.policy.cobotmagic.yaml | 0 .../stack_blocks_two/task.tianji_marvin.yaml | 0 .../task_program/evaluation.measured.yaml | 0 .../task_program/evaluation.yaml | 0 .../task_program/integration.yaml | 0 .../task_program/program.measured.yaml | 0 .../task_program/program.yaml | 0 .../tableware/stack_cups/README.md | 4 +- .../tableware/stack_cups/catalog.yaml | 0 .../stack_cups/env.dexforce_w1_030_pika.yaml | 0 .../tableware/stack_cups/env.json | 0 .../tableware/stack_cups/env.yaml | 0 .../stack_cups/task.dexforce_w1_030_pika.yaml | 0 .../task.dual_ur5_dh_pgi_140_80.yaml | 0 .../stack_cups/task.tianji_marvin.yaml | 0 .../extensions/tasks}/locomotion/__init__.py | 0 .../tasks}/locomotion/managers/__init__.py | 0 .../tasks}/locomotion/managers/actions.py | 4 +- .../tasks}/locomotion/managers/events.py | 4 +- .../locomotion/managers/observations.py | 0 .../tasks}/locomotion/managers/rewards.py | 0 .../tasks}/locomotion/tracking/__init__.py | 0 .../tasks}/locomotion/tracking/_task.py | 0 .../tasks}/locomotion/tracking/g1_motion.py | 12 +- .../locomotion/tracking/motion_model.py | 7 +- .../tasks}/locomotion/velocity/__init__.py | 0 .../locomotion/velocity/_embodichain.py | 0 .../locomotion/velocity/anymal_c_flat.py | 0 .../locomotion/velocity/contracts/__init__.py | 0 .../locomotion/velocity/contracts/_config.py | 6 +- .../locomotion/velocity/contracts/_math.py | 0 .../velocity/contracts/_reward_terms.py | 0 .../velocity/contracts/anymal_c/__init__.py | 0 .../velocity/contracts/anymal_c/config.py | 0 .../velocity/contracts/anymal_c/mdp.py | 0 .../velocity/contracts/g1/__init__.py | 0 .../velocity/contracts/g1/config.py | 0 .../locomotion/velocity/contracts/g1/mdp.py | 0 .../velocity/contracts/go1/__init__.py | 0 .../velocity/contracts/go1/config.py | 0 .../locomotion/velocity/contracts/go1/mdp.py | 0 .../velocity/contracts/go2/__init__.py | 0 .../velocity/contracts/go2/config.py | 0 .../locomotion/velocity/contracts/go2/mdp.py | 0 .../velocity/contracts/h1_2/__init__.py | 0 .../velocity/contracts/h1_2/config.py | 0 .../locomotion/velocity/contracts/h1_2/mdp.py | 0 .../velocity/contracts/microduck/__init__.py | 0 .../velocity/contracts/microduck/config.py | 0 .../velocity/contracts/microduck/mdp.py | 0 .../tasks}/locomotion/velocity/g1_flat.py | 0 .../tasks}/locomotion/velocity/go1_flat.py | 0 .../tasks}/locomotion/velocity/go2_flat.py | 0 .../tasks}/locomotion/velocity/h1_2_flat.py | 0 .../locomotion/velocity/microduck_flat.py | 0 .../tasks}/manipulation/__init__.py | 0 .../tasks}/manipulation/push_cube.py | 0 .../tasks}/manipulation/tableware/__init__.py | 0 .../tableware/blocks_ranking_size.py | 0 .../tableware/match_object_container.py | 0 .../tableware/place_object_drawer.py | 0 .../manipulation/tableware/stack_cups.py | 0 .../extensions/tasks}/special/__init__.py | 0 .../tasks}/special/franka_reach_apg.py | 0 .../extensions/tasks}/utils/__init__.py | 0 .../extensions/tasks}/utils/importer.py | 2 +- embodichain/lab/gym/envs/__init__.py | 2 +- embodichain/lab/gym/utils/registration.py | 59 +-- .../lab/sim/motion/expansion/combined.py | 4 +- embodichain/lab/sim/robots/__init__.py | 2 +- embodichain/learning/rl/env.py | 4 +- embodichain/learning/rl/train.py | 2 +- embodichain/toolkits/graspkit/README.md | 4 +- embodichain/utils/config_paths.py | 42 +- embodichain/utils/utility.py | 3 +- examples/README.md | 4 +- examples/data_pipeline/online_dataset_demo.py | 2 +- examples/expansion/README.md | 2 +- .../cube_platform_pick_place/task.ur5.yaml | 4 +- .../configs/pour_water/task.cobotmagic.yaml | 4 +- .../asset_generalization/pour_water.py | 2 +- examples/expansion/demo_skill/__main__.py | 2 +- examples/expansion/demo_skill/present.py | 2 +- examples/expansion/engine/motion.yaml | 2 +- examples/expansion/engine/showcase/_cases.py | 4 +- .../engine/showcase/expand_ranges.py | 6 +- examples/expansion/engine/task.default.yaml | 8 +- examples/expansion/engine/task.newton.yaml | 8 +- .../scene_robot_feasibility/README.md | 2 +- .../hand_over/task.dual_ur5.yaml | 4 +- .../scene_robot_feasibility/preview.py | 2 +- .../scene_robot_feasibility/search.ur5.yaml | 2 +- .../trajectory/real2sim_carton/README.md | 4 +- .../trajectory/real2sim_carton/matrix.py | 7 +- .../trajectory/real2sim_carton/prepare.py | 4 +- .../trajectory/real2sim_carton/run.py | 7 +- .../repeated_pick_place_expansion_combined.py | 2 +- .../repeated_pick_place_expansion_showcase.py | 2 +- examples/gensim/goal_authoring/README.md | 2 +- examples/gensim/goal_authoring/fruit_pilot.py | 2 +- examples/gensim/goal_authoring/stack_pilot.py | 2 +- examples/gensim/run.yaml | 2 +- examples/gensim/runtime.dual_ur5.yaml | 2 +- .../gensim/scripted_pick_place/__main__.py | 2 +- .../gensim/scripted_pick_place/runtime.yaml | 2 +- .../gym/gaussian_pick_place/QUALIFICATION.md | 2 +- examples/gym/gaussian_pick_place/README.md | 10 +- examples/gym/gaussian_pick_place/_prepare.py | 2 +- examples/gym/library_pick_place/run.py | 2 +- .../usd_scene_pick_place/task.dual_ur5.yaml | 4 +- examples/learning/act/_environment.py | 14 +- examples/learning/act/evaluate.py | 4 +- examples/learning/act/train.py | 2 +- examples/learning/motion_tracking/README.md | 2 +- .../motion_tracking/evaluate_online.py | 8 +- .../motion_tracking/evaluate_world_model.py | 2 +- .../motion_tracking/fit_world_model.py | 8 +- .../motion_tracking/prepare_lafan1.py | 4 +- examples/learning/motion_tracking/train.py | 18 +- examples/learning/nerd/DEPLOYMENT.md | 2 +- examples/learning/nerd/README.md | 6 +- examples/learning/nerd/__main__.py | 4 +- .../learning/nerd/_support/_acceptance.py | 25 +- .../_support/_benchmark_dynamics_input.py | 6 +- .../_support/_benchmark_dynamics_training.py | 2 +- .../nerd/_support/_compare_official_model.py | 6 +- .../learning/nerd/_support/_comparison.py | 14 +- .../learning/nerd/_support/_generation.py | 4 +- .../nerd/_support/_matched_small_budget.py | 9 +- examples/learning/nerd/_support/_model_env.py | 7 +- .../learning/nerd/_support/_model_factory.py | 8 +- examples/learning/nerd/_support/_newton.py | 5 +- .../_support/_official_evaluation_data.py | 6 +- examples/learning/nerd/_support/_reference.py | 25 +- .../nerd/_support/_reference_rollout.py | 9 +- .../nerd/_support/_reference_traces.py | 2 +- examples/learning/nerd/_support/_report.py | 2 +- examples/learning/nerd/_support/_scene.py | 10 +- .../learning/nerd/_support/_task_reset.py | 2 +- .../learning/nerd/_support/_task_values.py | 2 +- examples/learning/nerd/_support/_trainer.py | 11 +- examples/learning/nerd/_support/_workflow.py | 28 +- examples/learning/nerd/configs/ant/README.md | 2 +- .../learning/nerd/configs/ant/sl.train.yaml | 2 +- .../learning/nerd/configs/cartpole/README.md | 2 +- .../nerd/configs/cartpole/sl.train.yaml | 2 +- examples/learning/nerd/research/acceptance.md | 2 +- examples/learning/rigidformer/README.md | 2 +- examples/learning/rigidformer/__main__.py | 12 +- examples/learning/rigidformer/_demo.py | 12 +- examples/learning/rigidformer/_prepare.py | 2 +- .../learning/rigidformer/_support/_compare.py | 17 +- .../rigidformer/_support/_evaluator.py | 12 +- .../rigidformer/_support/_evidence.py | 2 +- .../rigidformer/_support/_recovery.py | 2 +- .../rigidformer/configs/sl.movi_a.yaml | 2 +- .../rigidformer/configs/sl.movi_b.yaml | 2 +- .../rigidformer/configs/sl.movi_sphere.yaml | 2 +- examples/learning/rwm/README.md | 4 +- .../learning/rwm/_support/_controlled_fit.py | 18 +- examples/learning/sl_ddp/README.md | 2 +- .../task_program_progress/__main__.py | 2 +- examples/learning/worldparticle/DEPLOYMENT.md | 2 +- examples/learning/worldparticle/README.md | 6 +- examples/learning/worldparticle/__main__.py | 6 +- examples/ods/simple_bc_demo/README.md | 2 +- examples/ods/simple_bc_demo/evaluation.py | 6 +- examples/ods/simple_bc_demo/train.py | 2 - examples/sim/assembly/README.md | 4 +- examples/sim/assembly/_passive.py | 5 +- examples/sim/assembly/visual_demo.py | 2 +- .../sim/assets/gaussian_backgrounds/README.md | 2 +- .../sim/atomic_skill/coordinated_placement.py | 4 +- examples/sim/atomic_skill/embodiments.py | 6 +- examples/sim/atomic_skill/support.py | 6 +- examples/sim/demo/franka_dexuni_pour_demo.py | 2 +- examples/sim/demo/grasp_cup_to_caffe.py | 2 +- examples/sim/demo/pick_up_cloth.py | 2 +- examples/sim/demo/press_softbody.py | 2 +- examples/sim/demo/scoop_ice.py | 2 +- .../sim/motion/planners/curobo_planner.py | 4 +- .../sim/motion/planners/neural_planner.py | 2 +- examples/sim/motion/solvers/fep_solver.py | 2 +- .../sim/motion/solvers/neural_ik_solver.py | 2 +- examples/sim/motion/solvers/opw_solver.py | 2 +- examples/sim/motion/solvers/srs_solver.py | 2 +- .../motion/trajectory_velocity_tracking.py | 2 +- examples/sim/motion/workspace/_common.py | 2 +- examples/sim/robot/dexforce_w1.py | 2 +- examples/sim/scene/scene_demo.py | 2 +- extensions/README.md | 48 --- .../embodichain_robots/_asset_catalog.py | 194 --------- pyproject.toml | 12 +- scripts/benchmark/assembly/precision.py | 4 +- .../atomic_skill/BENCHMARK_STANDARD.md | 2 +- .../benchmark/learning/rigidformer_index.py | 4 +- scripts/benchmark/motion/observed_batch.py | 2 +- scripts/benchmark/motion_generation/README.md | 2 +- .../motion_generation/run_benchmark.py | 2 +- .../rendering/native_object_batches.py | 15 +- scripts/benchmark/rl/locomotion_ppo.py | 2 +- scripts/benchmark/rl/tasks/cart_pole.yaml | 2 +- scripts/benchmark/rl/tasks/push_cube.yaml | 2 +- .../benchmark/robotics/cobotmagic_drives.py | 2 +- .../robotics/kinematic_solver/agibot_g2.py | 2 +- .../kinematic_solver/run_benchmark.py | 2 +- .../robotics/kinematic_solver/srs_solver.py | 4 +- .../kinematic_solver/ssik_benchmark.py | 4 +- scripts/benchmark/sensors/contact_loss.md | 4 +- .../benchmark_robot_workspace.py | 2 +- scripts/ci/pytest_no_finalize.py | 8 +- scripts/ci/select_tests.py | 4 +- scripts/tools/rl/visualize_point_mass.py | 2 +- scripts/tutorials/atomic_skill/README.md | 2 +- .../atomic_skill/embodiment_switching.py | 5 +- scripts/tutorials/gym/modular_env.py | 2 +- scripts/tutorials/gym/simple_task_program.py | 2 +- .../tutorials/scene/_robot_workspace_scene.py | 4 +- .../tutorials/scene/_robot_workspace_task.py | 2 +- scripts/tutorials/sim/export_usd.py | 2 +- scripts/tutorials/sim/motion_generator.py | 2 +- scripts/tutorials/sim/open_drawer.py | 2 +- .../manipulability_augmentation_plot.py | 2 +- .../sim/planner/trapezoidal_planner.py | 2 +- .../sim/simple_newton_solver/README.md | 2 +- scripts/tutorials/sim/srs_solver.py | 2 +- .../workspace_manipulability_visualization.py | 2 +- setup.py | 80 +--- tests/benchmark/assembly/test_precision.py | 39 +- tests/benchmark/assembly/test_probes.py | 16 +- tests/benchmark/motion_generation/test_api.py | 62 ++- .../test_atomic_dual_arm_providers.py | 41 +- .../test_atomic_pose_config.py | 14 +- .../test_atomic_skill_benchmark.py | 129 +++--- .../test_atomic_skill_providers.py | 60 ++- .../motion_generation/test_benchmark_views.py | 18 +- .../test_constraint_sequences.py | 48 ++- .../motion_generation/test_contracts.py | 10 +- .../test_embodiment_runtime.py | 38 +- .../motion_generation/test_embodiments.py | 4 +- .../motion_generation/test_evaluation.py | 23 +- .../motion_generation/test_free_space.py | 30 +- .../motion_generation/test_generalization.py | 16 +- .../motion_generation/test_grasp_contacts.py | 10 +- .../test_motion_generation_benchmark.py | 179 +++++--- .../motion_generation/test_motion_limits.py | 35 +- .../test_motion_suite_families.py | 18 +- .../test_native_hand_collision_geometry.py | 12 +- .../test_paired_arm_performance.py | 8 +- .../test_placement_geometry.py | 10 +- .../test_quality_batching.py | 26 +- .../test_replay_diagnostics.py | 2 +- .../motion_generation/test_scenario_timing.py | 23 +- .../test_toppra_dependency.py | 4 +- .../test_demo_success_cube_sim.py | 2 +- .../test_demo_success_open_drawer_sim.py | 2 +- tests/benchmark/test_cobotmagic_drives.py | 2 +- tests/ci/test_container_verification.py | 18 +- tests/ci/test_select_tests.py | 4 +- tests/ci/test_workflows.py | 42 +- tests/cli/test_list_robot.py | 14 +- tests/compute/test_imports.py | 4 +- tests/conftest.py | 2 +- tests/data/assets/test_policy_assets.py | 4 +- tests/data/test_agibot_g2_assets.py | 2 +- tests/data/test_download.py | 28 +- tests/data/test_download_prefix.py | 8 +- tests/data/test_so101_assets.py | 2 +- tests/data/test_yam_i2rt_assets.py | 6 +- tests/data_pipeline/test_online_data.py | 2 +- tests/docs/test_build_architecture.py | 4 +- tests/docs/test_check_api_docs.py | 21 +- tests/examples/atomic_skill/test_run.py | 4 +- tests/fixtures/kinematics/panda_original.urdf | 2 +- .../kinematics/robotiq85_linkage.urdf | 2 +- .../services/test_wheel_configuration.py | 15 +- tests/gen_sim/task_engine/test_bundle.py | 2 +- .../task_engine/test_image_planning.py | 2 +- tests/gen_sim/test_workflow.py | 6 +- .../managers/test_observation_functors.py | 2 +- .../test_scene_layout_randomization.py | 2 +- .../test_asset_materialization.py | 2 +- .../test_asset_pouring_materialization.py | 2 +- tests/gym/envs/task_program/test_catalog.py | 2 +- .../test_configured_integration.py | 9 +- .../test_drawer_storage_long_horizon_sim.py | 2 +- .../task_program/test_dual_arm_variants.py | 4 +- .../envs/task_program/test_feasibility_sim.py | 11 +- .../task_program/test_policy_deployment.py | 2 +- .../envs/task_program/test_pour_water_sim.py | 2 +- .../task_program/test_scene_expansion_sim.py | 2 +- .../envs/task_program/test_tableware_sim.py | 2 +- .../envs/task_program/test_task_hand_over.py | 9 +- .../task_program/test_task_tianji_marvin.py | 13 +- .../task_program/test_task_vertical_slices.py | 8 +- .../envs/task_program/test_task_w1_pika.py | 10 +- .../task_program/test_usd_scene_import.py | 2 +- tests/gym/envs/tasks/test_cloth_fold.py | 2 +- tests/gym/envs/tasks/test_drawer_storage.py | 4 +- tests/gym/envs/tasks/test_humanoid_run.py | 6 +- tests/gym/envs/tasks/test_locomotion_cuda.py | 2 +- .../envs/tasks/test_locomotion_deployments.py | 8 +- .../gym/envs/tasks/test_locomotion_landing.py | 8 +- tests/gym/envs/tasks/test_motion_model.py | 23 +- tests/gym/envs/tasks/test_motion_tracking.py | 16 +- tests/gym/envs/tasks/test_push_cube.py | 4 +- .../envs/tasks/test_segmented_manipulation.py | 2 +- .../gym/envs/tasks/test_unitree_locomotion.py | 67 +-- tests/gym/envs/test_asset_generalization.py | 2 +- .../gym/envs/test_auto_renderer_lifecycle.py | 4 +- tests/gym/envs/test_configured_rl.py | 4 +- .../envs/test_differentiable_embodied_env.py | 8 +- tests/gym/envs/test_fluid_integration.py | 2 +- tests/gym/envs/test_modular_env_tutorial.py | 2 +- tests/gym/envs/test_official_task_layout.py | 30 +- tests/gym/utils/test_gym_utils.py | 12 +- tests/lab/expansion/test_program_sim.py | 10 +- tests/lab/scripts/test_preview_robot.py | 8 +- tests/lab/scripts/test_run_task_expansion.py | 12 +- tests/lab/task_program/test_loader.py | 2 +- .../test_semantic_executor_curobo_gpu.py | 2 +- tests/learning/test_point_mass.py | 2 +- tests/learning/test_rl.py | 4 +- tests/learning/test_rl_distributed.py | 2 +- tests/learning/test_rl_resume.py | 4 +- tests/learning/test_rl_resume_distributed.py | 2 +- tests/learning/test_shared_rollout.py | 2 +- .../models/dynamics/_rigidformer_fixtures.py | 2 +- .../models/dynamics/_rigidformer_training.py | 2 +- tests/models/dynamics/nerd/test_transition.py | 8 +- tests/models/dynamics/rwm/test_kinematic.py | 8 +- tests/models/dynamics/rwm/test_robot_state.py | 2 +- tests/models/dynamics/rwm/test_rwm.py | 14 +- .../dynamics/rwm/test_transition_replay.py | 2 +- .../dynamics/test_rigidformer_distributed.py | 8 +- .../dynamics/test_rigidformer_official.py | 15 +- .../dynamics/test_rigidformer_training.py | 30 +- .../dynamics/worldparticle/test_data.py | 2 +- .../worldparticle/test_worldparticle.py | 40 +- tests/models/policy/test_act.py | 6 +- tests/models/policy/test_act_data.py | 5 +- tests/nerd_support.py | 8 +- .../test_curobo_motion_strategy_e2e.py | 2 +- .../atomic_skills/test_motion_strategy_e2e.py | 2 +- tests/sim/motion/expansion/test_combined.py | 2 +- .../motion/expansion/test_combined_runtime.py | 2 +- .../planners/test_curobo_integration.py | 2 +- .../motion/planners/test_curobo_planner.py | 2 +- .../motion/planners/test_toppra_batched.py | 4 +- .../motion/planners/test_toppra_planner.py | 2 +- .../motion/solvers/test_analytic_batching.py | 2 +- tests/sim/motion/solvers/test_fep_solver.py | 2 +- .../motion/solvers/test_neural_ik_solver.py | 2 +- tests/sim/motion/solvers/test_opw_solver.py | 2 +- tests/sim/motion/solvers/test_srs_solver.py | 4 +- .../motion/solvers/test_ssik_near_parallel.py | 4 +- .../solvers/test_ssik_reference_models.py | 4 +- .../sim/motion/solvers/test_ssik_rr_solver.py | 2 +- tests/sim/motion/solvers/test_ssik_solver.py | 2 +- .../motion/solvers/test_ssik_srs_search.py | 2 +- .../test_ssik_warp_dependency_isolation.py | 4 +- tests/sim/motion/test_motion_generator.py | 2 +- tests/sim/motion/workspace/test_analyzer.py | 2 +- tests/sim/motion/workspace/test_cache.py | 6 +- .../motion/workspace/test_manipulability.py | 2 +- tests/sim/objects/test_dual_arm.py | 2 +- .../sim/objects/test_fluid_online_runtime.py | 4 +- tests/sim/objects/test_robot.py | 2 +- tests/sim/objects/test_robot_cfg.py | 60 +-- tests/sim/robots/test_agibot_g2.py | 6 +- tests/sim/robots/test_agilex_piper_x.py | 2 +- tests/sim/robots/test_brainco_revo1.py | 12 +- tests/sim/robots/test_dexforce_w1_v030.py | 10 +- tests/sim/robots/test_entrypoints.py | 8 +- tests/sim/robots/test_flexiv_rizon4s.py | 2 +- tests/sim/robots/test_imports.py | 48 +-- tests/sim/robots/test_sharpa_hand.py | 4 +- tests/sim/robots/test_so101.py | 4 +- .../sim/robots/test_tianji_marvin_sensors.py | 4 +- tests/sim/robots/test_wuji_hand.py | 4 +- tests/sim/robots/test_yam_i2rt.py | 4 +- tests/sim/scene/expansion/test_layout_sim.py | 2 +- tests/sim/sensors/test_contact.py | 2 +- tests/sim/sensors/test_contact_newton_e2e.py | 2 +- .../spawn/test_create_robot_integration.py | 2 +- tests/solvers/physics/nerd/test_provider.py | 4 +- tests/test_agent_context_map.py | 4 +- tests/test_benchmark_package.py | 63 ++- tests/test_example_package.py | 16 +- tests/test_gripper_defaults.py | 6 +- tests/test_locomotion_catalog.py | 12 +- tests/test_main.py | 8 +- tests/test_release_metadata.py | 90 ++-- tests/test_robot_package.py | 100 ++--- tests/test_robot_registry.py | 52 +-- tests/test_task_catalog.py | 52 +-- tests/test_task_program_package_data.py | 95 ++--- tests/toolkits/assembly/test_assets.py | 6 +- .../test_parallel_jaw_grasp_pose_generator.py | 4 +- tests/utils/test_config_paths.py | 35 +- tests/utils/test_utility.py | 2 +- 1221 files changed, 3388 insertions(+), 3290 deletions(-) create mode 100644 embodichain/extensions/README.md create mode 100644 embodichain/extensions/__init__.py rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/assembly/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/assembly/_many_metrics.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/assembly/_warp.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/assembly/precision.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/assembly/probes.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/BENCHMARK_DESIGN.md (99%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/README.md (88%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/__main__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_aggregation_policy.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_atomic_fixtures.py (99%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_case_preparation.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_paired_arm_performance.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_quality_batching.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/_tcp_presets.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/aggregation.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/api.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/artifacts.py (99%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/atomic_skill.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/cli.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/config.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/contracts.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/embodiments.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/evaluation.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/generalization.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/limits.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/metrics/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/metrics/_constraints.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/metrics/performance.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/metrics/stats.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/metrics/trajectory.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/models.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/parallel.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/_constraints.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/base.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/curobo.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/ik_interpolate.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/nmg_onnx.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/planners/toppra.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/registry.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/reporting.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/robots/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/robots/base.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/robots/dual_arm.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/robots/franka.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/robots/ur5.py (97%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/runner.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/__init__.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_atomic_pose_sampling.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_atomic_reference.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_atomic_targets.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_case_qualification.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_free_space_proposals.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_free_space_sampling.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_grasp_contacts.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_placement_geometry.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_placement_qualification.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/_replay_diagnostics.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_case_utils.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_contact_cases.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_dual_arm_providers.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_evaluation.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_grasps.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_manipulation_cases.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_motion_cases.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_objects.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_policy.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_replay.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_skill.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/atomic_skill_providers.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/base.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/scenarios/free_space.py (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_franka_robotiq_coordinated_placement.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_franka_robotiq_hand_over.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_hand_over.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_franka_robotiq_door_pour_align_push.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_franka_robotiq_pose_batch.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_franka_robotiq_randomized.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_franka_robotiq_smoke.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_franka_robotiq_spatial_generalization.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_ur5_embodiment.yaml (96%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/atomic_ur5_pgi_randomized.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/motion_panda_free_space_coverage.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/motion_panda_free_space_smoke.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/suites/motion_ur5_free_space_coverage.yaml (100%) rename {extensions/embodichain_benchmarks => embodichain/extensions/benchmarks}/motion_generation/video.py (100%) rename {extensions/embodichain_models => embodichain/extensions/models}/README.md (63%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/THIRD_PARTY_LICENSES (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/_numerics.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/_resident.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/checkpoint.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/codec.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/data.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/geometry.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/integration.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/model.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/sl_recipe.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/supervised.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/nerd/transition.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/REFERENCE_SOURCES.json (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/THIRD_PARTY_LICENSES (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/attention.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/_index.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/dataset.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/gpu_augmentation.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/object_scale.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/data/scene_frames.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/anchor_vertex_pooling.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/decoder.py (99%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/encoder.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/geometry_encoders.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/multi_scale_predictor.py (99%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/physformer_rope.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/predictor.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/se3_attention.py (99%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/state.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/models/transform_layer.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/network.py (99%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/utils/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/utils/anchor_rotation.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/utils/cuda_knn.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/utils/intersection_handler.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/_native/utils/weight_ema.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/checkpoint.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/configs/movi_a.yaml (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/configs/movi_b.yaml (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/configs/movi_sphere.yaml (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/data.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/ema.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/model.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/sl_recipe.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rigidformer/supervised.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/kinematic.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/model.py (99%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/predictor.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/replay.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/robot_state.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/sl_recipe.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/rwm/supervised.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/LICENSE.tome (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/LICENSE.worldparticle (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/PROVENANCE.json (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/_data.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/continuous_conv.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/cross_attn_feat.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/encodings/rms_norm.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/encodings/rope.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/layers/attention.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/layers/merge.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/particle_network_cross_attn_feat.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_network/super_particle_layers.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/_runtime.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/data.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/dynamics/worldparticle/model.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policies/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policies/motion_tracking.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policy/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policy/act/__init__.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policy/act/runtime.py (100%) rename {extensions/embodichain_models/embodichain_models => embodichain/extensions/models}/policy/act/training.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/README.md (89%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/__init__.py (100%) create mode 100644 embodichain/extensions/robots/_asset_catalog.py rename {extensions/embodichain_robots => embodichain/extensions/robots}/_catalog.py (83%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_locomotion.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_ssik_artifacts/LICENSE.txt (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_ssik_artifacts/arx5.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_ssik_artifacts/arx5.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_ssik_artifacts/flexiv_rizon4s.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/_ssik_artifacts/flexiv_rizon4s.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g1/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g1/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g1/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g1/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g1/preview.png (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/LICENSE (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/README.md (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/_generate.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/_preview.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/g2.urdf (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/preview.png (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/preview.render.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agibot/g2/source.lock.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/_arm_assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/agx_gripper/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/agx_gripper/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/agx_gripper/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/cfg.py (99%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/gripper/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/gripper/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/cobotmagic/gripper/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/pika/README.md (97%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/pika/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/pika/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/pika/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/pika/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/piper_x/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/piper_x/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/piper_x/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/agilex/piper_x/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/alohamini/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/alohamini/aloha_mini/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/alohamini/aloha_mini/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/alohamini/aloha_mini/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/anybotics/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/anybotics/anymal_c/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/anybotics/anymal_c/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/anybotics/anymal_c/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/anybotics/anymal_c/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/arx/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/arx/arx5/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/arx/arx5/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/arx/arx5/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/revo1/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/revo1/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/revo1/_specs.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/revo1/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/brainco/revo1/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/changingtek/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/changingtek/ctm2f110/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/changingtek/ctm2f110/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/changingtek/ctm2f110/assets.py (95%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/cfg.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/hand_specs.py (97%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/params.py (98%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/specs.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/types.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dexforce/w1/utils.py (98%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/ag95/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/ag95/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/ag95/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgc_140_50/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgc_140_50/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgc_140_50/_specs.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgc_140_50/assets.py (94%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgi_140_80/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgi_140_80/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgi_140_80/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgi_140_80/assets.py (95%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/dh_robotics/pgi_140_80/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/flexiv/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/flexiv/rizon4s/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/flexiv/rizon4s/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/flexiv/rizon4s/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/README.md (97%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/_physics.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/_specs.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/hand/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/hand/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/hand/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/franka/panda.py (97%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/i2rt/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/i2rt/yam/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/i2rt/yam/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/i2rt/yam/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/i2rt/yam/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/inspire/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/inspire/hand/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/inspire/hand/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/inspire/hand/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/locomotion_profiles.py (84%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/pollen_robotics/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/pollen_robotics/microduck/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/pollen_robotics/microduck/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/pollen_robotics/microduck/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/pollen_robotics/microduck/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f140/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f140/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f140/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f85/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f85/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/arg2f85/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/robotiq_2f85/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/robotiq_2f85/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/robotiq_2f85/assets.py (95%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/robotiq/two_finger.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/sharpa/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/sharpa/wave/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/sharpa/wave/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/sharpa/wave/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/sharpa/wave/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/the_robot_studio/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/the_robot_studio/so101/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/the_robot_studio/so101/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/the_robot_studio/so101/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/gripper/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/gripper/_gripper_defaults.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/tianji/marvin/gripper/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/g1/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/g1/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/g1/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/g1/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go1/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go1/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go1/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go1/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go2/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go2/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go2/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/go2/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/h1_2/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/h1_2/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/h1_2/cfg.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/unitree/h1_2/profile.json (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/universal_robots/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/universal_robots/assets.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/universal_robots/ur_robot.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wheeltec/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wheeltec/fa2f/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wheeltec/fa2f/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wheeltec/fa2f/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wuji/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wuji/hand/README.md (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wuji/hand/__init__.py (100%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wuji/hand/assets.py (96%) rename {extensions/embodichain_robots => embodichain/extensions/robots}/wuji/hand/cfg.py (100%) rename {extensions/embodichain_solvers => embodichain/extensions/solvers}/README.md (73%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/__init__.py (100%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/__init__.py (100%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/nerd/__init__.py (100%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/nerd/_binding.py (99%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/nerd/provider.py (98%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/worldparticle/__init__.py (100%) rename {extensions/embodichain_solvers/embodichain_solvers => embodichain/extensions/solvers}/physics/worldparticle/provider.py (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/README.md (89%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/__init__.py (55%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/cart_pole.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/humanoid/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/humanoid/humanoid_run.py (99%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/humanoid/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/classic_control/point_mass.py (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/__init__.py (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/cobotmagic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dexforce_w1_030_cloth_fold.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dexforce_w1_030_pika.md (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_franka_robotiq_arg2f_140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_franka_robotiq_arg2f_140_gensim.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_ur10_robotiq_arg2f_140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_ur10_robotiq_arg2f_140_gensim.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_gs_dual_camera.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda_cartesian.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda_fast_fluid.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda_rgb_224.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda_robotiq85.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/piper_x_agx_gripper.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/tianji_marvin.yaml (99%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/franka_gs_verified.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/motion_gen_projected_manipulation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/motion_gen_verified.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/real2sim_verified.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/sequential_ik_projected_manipulation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/sequential_ik_verified.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/trajectory_open_loop.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/trajectory_open_loop_dual_arm_manipulation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/execution_policies/trajectory_open_loop_fluid_pour.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/expansion_policies/task_program_episode.yaml (95%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/randomization_profiles/cube_initial_pose.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/components/randomization_profiles/rgb_visual.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/agents/grpo.json (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/agents/grpo.yaml (95%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/agents/ppo.json (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/agents/ppo.yaml (95%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/cart_pole/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/README.md (85%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/humanoid/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/point_mass/agents/apg.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/classic_control/point_mass/agents/ppo.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/README.md (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml (91%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml (92%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml (92%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml (92%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml (92%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/env.dexuni.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/anymal_c_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/g1_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go1_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/go2_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/h1_2_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/README.md (90%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/locomotion/velocity/microduck_flat/task.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/real2sim/collection.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/task.panda.rgbd.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/task.panda.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/task_program/integration.ordinary.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/carton_stocking/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/task.w1.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/task_program/evaluation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/env.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task.franka.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task.ur5.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/evaluation.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/evaluation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.franka.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/integration.franka.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/integration.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/drawer_storage/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/README.md (94%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/env.discoverse.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/env.office.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/env.robosimgs.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task_program/program.discoverse.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task_program/program.office.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/gaussian_pick_place/task_program/program.robosimgs.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/envs/dual_franka_robotiq140.default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/envs/tabletop.default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task.dual_franka_robotiq_arg2f_140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task.dual_ur5.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/integration.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/integration.robotiq140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/integration.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/program.bar.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/program.tabletop.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/program.upright_can.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/hand_over/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/README.md (96%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/envs/default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/envs/newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/expansion/open_drawer.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/task.franka.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/task.ur5.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/open_drawer/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/README.md (79%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/agents/grpo.json (96%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml (95%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/agents/ppo.json (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/env.configured_rl.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/env.visual.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/push_cube/task.franka.visual.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/README.md (96%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/envs/dual_franka_robotiq140.default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/envs/dual_ur10_robotiq140.default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/envs/tabletop.default.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/objective.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140_gensim.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140_gensim.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/integration.robotiq140.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/integration.tabletop.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/program.robotiq_workbench.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/program.tabletop.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/program.workbench.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/rubiks_cube_pick_place/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/rubiks_cube_pick_place/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/rubiks_cube_pick_place/task.ur5.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md (97%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/blocks_ranking_size/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/match_object_container/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/place_object_drawer/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_cup/README.md (96%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_cup/env.fluid.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_cup/task_program/integration.fluid.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_cup/task_program/program.fluid.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/env.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/evaluation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dual_arm.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/program.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/program.workbench.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/README.md (98%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/env.policy.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.measured.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/integration.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.measured.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/README.md (80%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/catalog.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/env.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/env.json (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/env.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/task.dexforce_w1_030_pika.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/task.dual_ur5_dh_pgi_140_80.yaml (100%) rename {extensions/embodichain_tasks => embodichain/extensions/tasks}/configs/tasks/manipulation/tableware/stack_cups/task.tianji_marvin.yaml (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/managers/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/managers/actions.py (95%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/managers/events.py (94%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/managers/observations.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/managers/rewards.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/tracking/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/tracking/_task.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/tracking/g1_motion.py (98%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/tracking/motion_model.py (98%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/_embodichain.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/anymal_c_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/_config.py (89%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/_math.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/_reward_terms.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/anymal_c/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/anymal_c/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/anymal_c/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/g1/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/g1/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/g1/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go1/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go1/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go1/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go2/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go2/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/go2/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/h1_2/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/h1_2/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/h1_2/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/microduck/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/microduck/config.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/contracts/microduck/mdp.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/g1_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/go1_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/go2_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/h1_2_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/locomotion/velocity/microduck_flat.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/push_cube.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/tableware/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/tableware/blocks_ranking_size.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/tableware/match_object_container.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/tableware/place_object_drawer.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/manipulation/tableware/stack_cups.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/special/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/special/franka_reach_apg.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/utils/__init__.py (100%) rename {extensions/embodichain_tasks/embodichain_tasks => embodichain/extensions/tasks}/utils/importer.py (98%) delete mode 100644 extensions/README.md delete mode 100644 extensions/embodichain_robots/_asset_catalog.py diff --git a/.agents/skills/add-embodiment-component/SKILL.md b/.agents/skills/add-embodiment-component/SKILL.md index ccf537f8d9..216337bd77 100644 --- a/.agents/skills/add-embodiment-component/SKILL.md +++ b/.agents/skills/add-embodiment-component/SKILL.md @@ -13,7 +13,7 @@ configuration serve many tasks. An embodiment component belongs at: ```text -extensions/embodichain_tasks/configs/components/embodiments/.yaml +embodichain/extensions/tasks/configs/components/embodiments/.yaml ``` It owns exactly: @@ -37,7 +37,7 @@ Read `agent_context/MAP.yaml`, then resolve: - `task-programs` when a `skill_profile` is requested. Inspect the closest current component under -`extensions/embodichain_tasks/configs/components/embodiments/` and the intended runnable +`embodichain/extensions/tasks/configs/components/embodiments/` and the intended runnable task deployment. ## Reuse or add the robot diff --git a/.agents/skills/add-robot/SKILL.md b/.agents/skills/add-robot/SKILL.md index ae34ced4a4..dfc23b0132 100644 --- a/.agents/skills/add-robot/SKILL.md +++ b/.agents/skills/add-robot/SKILL.md @@ -33,7 +33,7 @@ return merge_robot_cfg(cfg, init_dict) ## Two Layouts -Concrete configs live in the `extensions/embodichain_robots/` import package, bundled +Concrete configs live in the `embodichain/extensions/robots/` import package, bundled with the core distribution/version. Generic robot runtime, configuration, solvers, and composition stay in `embodichain/lab/sim/`. @@ -109,12 +109,12 @@ must match the matching `control_parts` entry (the test stub asserts this). 5. **Keep `from_dict` as the 3-line template** — do not reimplement it. 6. **Add `__all__` and register** the class in - `extensions/embodichain_robots/_catalog.py`, then add its lazy export to - `extensions/embodichain_robots/__init__.py` (`_EXPORTS` and `__all__`): + `embodichain/extensions/robots/_catalog.py`, then add its lazy export to + `embodichain/extensions/robots/__init__.py` (`_EXPORTS` and `__all__`): ```python # Catalog entry; importing the catalog must not import the robot module. - "MyRobot": {"class_path": "embodichain_robots.my_vendor.my_robot:MyRobotCfg"} + "MyRobot": {"class_path": "embodichain.extensions.robots.my_vendor.my_robot:MyRobotCfg"} ``` The main wheel already advertises this catalog through `embodichain.robots`. @@ -213,8 +213,8 @@ Do not copy those semantic declarations into the robot class. **File locations:** -- Config: `extensions/embodichain_robots//.py` or `//` -- Catalog / lazy exports: `extensions/embodichain_robots/_catalog.py`, `extensions/embodichain_robots/__init__.py` +- Config: `embodichain/extensions/robots//.py` or `//` +- Catalog / lazy exports: `embodichain/extensions/robots/_catalog.py`, `embodichain/extensions/robots/__init__.py` - Shared resolver: `embodichain/robot_registry.py` - Docs: `docs/source/resources/robot//.md` and the owning index - Tests: `tests/sim/objects/test_robot_cfg.py` diff --git a/.agents/skills/add-task-env/SKILL.md b/.agents/skills/add-task-env/SKILL.md index a0a9d1232e..7deb17ab0d 100644 --- a/.agents/skills/add-task-env/SKILL.md +++ b/.agents/skills/add-task-env/SKILL.md @@ -62,8 +62,8 @@ Resolve from the prompt or nearby conventions: Organize by task identity, never by solution method. Use: ```text -extensions/embodichain_tasks/embodichain_tasks//.py -extensions/embodichain_tasks/configs/tasks/// +embodichain/extensions/tasks//.py +embodichain/extensions/tasks/configs/tasks/// ``` Keep a single task Python entry point flat at `.py`. Do not create a @@ -127,7 +127,7 @@ deployment. Use separate environment files for backend-specific settings. ### Optional Python entry point Create -`extensions/embodichain_tasks/embodichain_tasks//.py` when the +`embodichain/extensions/tasks//.py` when the route requires import-owned behavior or registration: - an environment-only registered Gym task; diff --git a/.agents/skills/add-task-env/references/handwritten-expert.md b/.agents/skills/add-task-env/references/handwritten-expert.md index 670970b972..a321dc171f 100644 --- a/.agents/skills/add-task-env/references/handwritten-expert.md +++ b/.agents/skills/add-task-env/references/handwritten-expert.md @@ -8,8 +8,8 @@ scripted/handwritten demonstration. ## Owned files ```text -extensions/embodichain_tasks/embodichain_tasks//.py -extensions/embodichain_tasks/configs/tasks/// +embodichain/extensions/tasks//.py +embodichain/extensions/tasks/configs/tasks/// tests/gym/envs/tasks/test_.py ``` @@ -97,6 +97,6 @@ use the project's resource markers and clean up `SimulationManager`. Reference implementations: -- `extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/blocks_ranking_rgb.py` -- `extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/stack_blocks_two.py` +- `embodichain/extensions/tasks/manipulation/tableware/blocks_ranking_rgb.py` +- `embodichain/extensions/tasks/manipulation/tableware/stack_blocks_two.py` - `embodichain/lab/gym/envs/demo.py` diff --git a/.agents/skills/add-task-env/references/rl.md b/.agents/skills/add-task-env/references/rl.md index 04b62c57dc..f448ee64a2 100644 --- a/.agents/skills/add-task-env/references/rl.md +++ b/.agents/skills/add-task-env/references/rl.md @@ -56,7 +56,7 @@ Select it from the training config with: ```yaml trainer: - gym_config: extensions/embodichain_tasks/configs/tasks///.yaml + gym_config: embodichain/extensions/tasks/configs/tasks///.yaml ``` Simulator environments use standard rollouts. PPO and GRPO are current @@ -67,7 +67,7 @@ standard examples. Keep the task entry point flat: ```text -extensions/embodichain_tasks/embodichain_tasks//.py +embodichain/extensions/tasks//.py ``` Register the factory with `@register_learning_env` and implement the diff --git a/.agents/skills/add-task-env/references/task-program-expert.md b/.agents/skills/add-task-env/references/task-program-expert.md index c066c820a6..c58ad0bc7e 100644 --- a/.agents/skills/add-task-env/references/task-program-expert.md +++ b/.agents/skills/add-task-env/references/task-program-expert.md @@ -10,7 +10,7 @@ only the surrounding task/environment decisions. ## Canonical layout ```text -extensions/embodichain_tasks/configs/tasks/// +embodichain/extensions/tasks/configs/tasks/// ├── env.yaml ├── task..yaml └── task_program/ diff --git a/.agents/skills/add-task-program/SKILL.md b/.agents/skills/add-task-program/SKILL.md index be0788b180..abee0bd839 100644 --- a/.agents/skills/add-task-program/SKILL.md +++ b/.agents/skills/add-task-program/SKILL.md @@ -118,7 +118,7 @@ Run the bundled read-only inspector for complete configured deployments: ```bash python .agents/skills/add-task-program/scripts/inspect_deployment.py \ - extensions/embodichain_tasks/configs/tasks///task..yaml + embodichain/extensions/tasks/configs/tasks///task..yaml ``` This command performs levels 1-4 without constructing a simulator. It does not diff --git a/.agents/skills/add-task-program/references/program-authoring.md b/.agents/skills/add-task-program/references/program-authoring.md index 84279fb81d..3af0fd78b0 100644 --- a/.agents/skills/add-task-program/references/program-authoring.md +++ b/.agents/skills/add-task-program/references/program-authoring.md @@ -11,7 +11,7 @@ programmatic composition, reuse in code, or a typed tutorial/test. Serialized programs belong at: ```text -extensions/embodichain_tasks/configs/tasks///task_program/program.yaml +embodichain/extensions/tasks/configs/tasks///task_program/program.yaml ``` The public Python API is `embodichain.lab.task_program`. A provider-independent diff --git a/.agents/skills/add-test/SKILL.md b/.agents/skills/add-test/SKILL.md index 18939cedb8..fc72f5ad35 100644 --- a/.agents/skills/add-test/SKILL.md +++ b/.agents/skills/add-test/SKILL.md @@ -50,7 +50,7 @@ Tests mirror the source tree under `tests/`: embodichain/lab/sim/motion/solvers/pytorch_solver.py → tests/sim/motion/solvers/test_pytorch_solver.py embodichain/lab/gym/envs/managers/rewards.py → tests/gym/envs/managers/test_reward_functors.py embodichain/toolkits/graspkit/pg_grasp/foo.py → tests/toolkits/test_pg_grasp.py -extensions/embodichain_tasks/embodichain_tasks/manipulation/push_cube.py → tests/gym/envs/tasks/test_push_cube.py +embodichain/extensions/tasks/manipulation/push_cube.py → tests/gym/envs/tasks/test_push_cube.py ``` Rules: diff --git a/.agents/skills/review-pr/references/review-matrix.md b/.agents/skills/review-pr/references/review-matrix.md index 0174d563f5..019fbe1dd2 100644 --- a/.agents/skills/review-pr/references/review-matrix.md +++ b/.agents/skills/review-pr/references/review-matrix.md @@ -20,7 +20,7 @@ and current source code when this matrix and the repository diverge. ## Common checks - Preserve the distribution name `embodichain`, the core import package - `embodichain`, and the bundled task import package `embodichain_tasks`. + `embodichain`, and the bundled task import package `embodichain.extensions.tasks`. - Check the complete call or configuration-resolution path, not only the changed definition. Inspect its closest tests and at least one caller or consumer. @@ -212,7 +212,7 @@ tests. Run GPU/distributed tests serially and only when justified. ## Official tasks and configuration packages -**Paths:** `extensions/embodichain_tasks/**` and reusable task components. +**Paths:** `embodichain/extensions/tasks/**` and reusable task components. Check: @@ -230,7 +230,7 @@ Check: composition, not only `yaml.safe_load`. Relative files and scene targets must resolve after wheel installation. - New or moved config/assets are present in wheel contents; deleted files are - not retained accidentally. Imports use `embodichain_tasks`, not a repository + not retained accidentally. Imports use `embodichain.extensions.tasks`, not a repository folder assumption. Evidence surfaces: the task-named module, deployment/component files, diff --git a/.ci/test-impact.toml b/.ci/test-impact.toml index 137e69107b..396cccd3ee 100644 --- a/.ci/test-impact.toml +++ b/.ci/test-impact.toml @@ -275,7 +275,7 @@ risk = "medium" [[rules]] id = "robot-system" paths = [ - "extensions/embodichain_robots/**", + "embodichain/extensions/robots/**", "embodichain/lab/sim/robots/**", "embodichain/lab/sim/objects/robot.py", ] @@ -327,7 +327,7 @@ id = "task-program" paths = [ "embodichain/lab/task_program/**", "embodichain/lab/gym/envs/task_program/**", - "extensions/embodichain_tasks/**", + "embodichain/extensions/tasks/**", ] tests = [ "tests/lab/task_program/**", diff --git a/.github/workflows/dataset-tooling.yml b/.github/workflows/dataset-tooling.yml index af8cfa64a9..dfe47b8007 100644 --- a/.github/workflows/dataset-tooling.yml +++ b/.github/workflows/dataset-tooling.yml @@ -14,7 +14,7 @@ on: - 'tests/data_pipeline/**' - 'tests/test_lerobot_compatibility.py' - 'tests/models/policy/**' - - 'extensions/embodichain_models/embodichain_models/policy/act/**' + - 'embodichain/extensions/models/policy/act/**' - 'examples/learning/act/**' - 'tests/gym/envs/managers/**' - 'embodichain/lab/scripts/preview_lerobot_data.py' diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index e3536f7a39..7c7cc77ae9 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -66,7 +66,6 @@ jobs: docs: - 'docs/**' - 'embodichain/**' - - 'extensions/**' - 'examples/**' - 'README.md' - 'pyproject.toml' @@ -617,15 +616,18 @@ jobs: required = { "embodichain/VERSION", "embodichain/gen_sim/asset_engine/configs/gen_config.json", - "embodichain_tasks/__init__.py", - "embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml", - "embodichain_robots/__init__.py", - "embodichain_robots/_catalog.py", - "embodichain_models/__init__.py", - "embodichain_robots/_asset_catalog.py", + "embodichain/extensions/__init__.py", + "embodichain/extensions/benchmarks/__init__.py", + "embodichain/extensions/solvers/__init__.py", + "embodichain/extensions/tasks/__init__.py", + "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml", + "embodichain/extensions/robots/__init__.py", + "embodichain/extensions/robots/_catalog.py", + "embodichain/extensions/models/__init__.py", + "embodichain/extensions/robots/_asset_catalog.py", "embodichain/data/_asset_registry.py", - "embodichain_robots/franka/assets.py", - "embodichain_robots/dexforce/w1/assets.py", + "embodichain/extensions/robots/franka/assets.py", + "embodichain/extensions/robots/dexforce/w1/assets.py", } with ZipFile(wheels[0]) as wheel: members = set(wheel.namelist()) @@ -641,14 +643,14 @@ jobs: ) source_task_configs = { - path.relative_to("extensions").as_posix() - for path in Path("extensions/embodichain_tasks/configs").rglob("*") + path.as_posix() + for path in Path("embodichain/extensions/tasks/configs").rglob("*") if path.suffix in {".json", ".yaml", ".yml"} } wheel_task_configs = { member for member in members - if member.startswith("embodichain_tasks/configs/") + if member.startswith("embodichain/extensions/tasks/configs/") and member.endswith((".json", ".yaml", ".yml")) } unexpected = sorted( @@ -657,10 +659,6 @@ jobs: if not member.startswith( ( "embodichain/", - "embodichain_tasks/", - "embodichain_robots/", - "embodichain_benchmarks/", - "embodichain_models/", f"embodichain-{version}.data/data/share/embodichain/examples/", dist_info, ) @@ -670,7 +668,7 @@ jobs: ) missing = sorted(required - members) retired_robot_modules = { - f"embodichain_robots/{name}.py" + f"embodichain/extensions/robots/{name}.py" for name in ( "arx5", "aloha_mini", "cobotmagic", "franka_panda", "flexiv_rizon4s", "tianji_marvin", "ur_robot", "so101", @@ -679,24 +677,26 @@ jobs: stale_robot_modules = sorted( member for member in members if member in retired_robot_modules - or member.startswith("embodichain_robots/dexforce_w1/") + or member.startswith("embodichain/extensions/robots/dexforce_w1/") ) missing_task_configs = sorted(source_task_configs - wheel_task_configs) unexpected_task_configs = sorted(wheel_task_configs - source_task_configs) - task_entry_point = "embodichain_tasks = embodichain_tasks" + task_entry_point = entry_point_config.get( + "embodichain.tasks", "official_tasks", fallback=None + ) == "embodichain.extensions.tasks" robot_entry_point = entry_point_config.get( "embodichain.robots", "official", fallback=None - ) == "embodichain_robots._catalog:ROBOT_CONFIGS" + ) == "embodichain.extensions.robots._catalog:ROBOT_CONFIGS" asset_entry_point = entry_point_config.get( "embodichain.assets", "official_robots", fallback=None - ) == "embodichain_robots._asset_catalog:ROBOT_ASSETS" + ) == "embodichain.extensions.robots._asset_catalog:ROBOT_ASSETS" if ( unexpected or missing or stale_robot_modules or missing_task_configs or unexpected_task_configs - or task_entry_point not in entry_points + or not task_entry_point or not robot_entry_point or not asset_entry_point ): @@ -706,7 +706,7 @@ jobs: f"stale_robot_modules={stale_robot_modules}, " f"missing_task_configs={missing_task_configs}, " f"unexpected_task_configs={unexpected_task_configs}, " - f"task_entry_point={task_entry_point in entry_points}, " + f"task_entry_point={task_entry_point}, " f"robot_entry_point={robot_entry_point}, " f"asset_entry_point={asset_entry_point}" ) diff --git a/AGENTS.md b/AGENTS.md index 2879c586e4..d1c10ae55f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,11 +16,10 @@ Canonical skills live under `.agents/skills/`. `.claude/skills/` and ## Package and architecture The distribution and primary import package are **`embodichain`**, lowercase -and one word. The repository directory is `EmbodiChain`; the same wheel -bundles official tasks as **`embodichain_tasks`** and concrete robot presets as -**`embodichain_robots`**, with the same version and distribution metadata. -Their sources live under **`extensions/`**, a repository container rather than -a Python namespace. Keep the `embodichain_` prefix for bundled extension modules. +and one word. The repository directory is `EmbodiChain`. The same wheel bundles +the official `tasks`, `robots`, `models`, `solvers`, and `benchmarks` packages +under `embodichain.extensions`. Put their sources and resources in +`embodichain/extensions//` and import them as `embodichain.extensions.`. | Area | Owner | |---|---| @@ -36,16 +35,16 @@ a Python namespace. Keep the `embodichain_` prefix for bundled extension modules | RL algorithms, policies, collectors and trainers | `embodichain/learning/rl/` | | Real-device controllers / standalone tools | `embodichain/lab/devices/`, `embodichain/toolkits/` | | Shared config and math utilities | `embodichain/utils/` | -| Official task entry points / components / deployments | `extensions/embodichain_tasks/` | -| Concrete robot configurations / model-owned asset definitions / calibrated defaults | `extensions/embodichain_robots/` | +| Official task entry points / components / deployments | `embodichain/extensions/tasks/` | +| Concrete robot configurations / model-owned asset definitions / calibrated defaults | `embodichain/extensions/robots/` | Generic robot runtime/configuration and dual-arm composition remain in `embodichain/lab/sim/`; lightweight catalog resolution lives in `embodichain/robot_registry.py`. Concrete robot presets register through the `embodichain.robots` catalog entry point. Concrete presets and migrated model-owned asset definitions use vendor/model -namespaces in `embodichain_robots`. Shared download/cache machinery stays in +namespaces in `embodichain.extensions.robots`. Shared download/cache machinery stays in `embodichain/data`; the `embodichain.assets` entry point registers robot assets. -Concrete presets import from `embodichain_robots`; `embodichain.lab.sim.robots` owns only generic +Concrete presets import from `embodichain.extensions.robots`; `embodichain.lab.sim.robots` owns only generic dual-arm composition. Shared numerical algorithms belong to `compute//`, with Warp kernels @@ -73,8 +72,8 @@ asset-defined spelling. Capabilities come from explicit configuration, not names Organize official tasks by family, optional subdomain and task identity. Keep import registration in the task-named module at -`extensions/embodichain_tasks/embodichain_tasks//.py`; configs belong -under `extensions/embodichain_tasks/configs/tasks///`. Do not add a +`embodichain/extensions/tasks//.py`; configs belong +under `embodichain/extensions/tasks/configs/tasks///`. Do not add a same-named Python package for one entry point or `scenario` / `mdp` modules when existing config fields and manager functors express the task. diff --git a/README.md b/README.md index a92b307523..67a89b34d6 100644 --- a/README.md +++ b/README.md @@ -73,24 +73,22 @@ for dependency profiles, ownership and compatibility boundaries. ## Official Extensions -EmbodiChain bundles four extension modules alongside the core framework. They -provide reusable tasks, robot presets, models, and evaluation workflows, and -ship in the main `embodichain` distribution with the same version. +EmbodiChain bundles five official extensions under `embodichain.extensions` +in the main `embodichain` distribution. | Module | What it provides | Explore | | --- | --- | --- | -| `embodichain_tasks` | Official task environments, runnable deployments, and reusable scene and embodiment components for manipulation, locomotion, and classic control. | [Task configurations and authoring](extensions/embodichain_tasks/README.md) | -| `embodichain_robots` | Concrete robot presets, model assets, and calibrated defaults, organized by vendor and model. | [Robot catalog and configuration](extensions/embodichain_robots/README.md) | -| `embodichain_models` | Policy models for action prediction, and world models / neural dynamics models for predicting future states and environment dynamics. | [Model families and workflows](extensions/embodichain_models/README.md) | -| `embodichain_benchmarks` | Motion planning and Atomic Skill evaluation suites with scenarios, planner adapters, scoring, and reports. | [Benchmark suites and usage](extensions/embodichain_benchmarks/motion_generation/README.md) | - -The core provides shared simulation, data, and learning infrastructure; extensions -build on those APIs for specific robots, tasks, models, and evaluations. Import -modules by their `embodichain_*` names: `extensions/` is their source directory, -not a Python import prefix. Model weights, datasets, and optional runtime -dependencies are configured through each workflow's guide. - -See the [extension development guide](extensions/README.md) for package layout +| `embodichain.extensions.tasks` | Official task environments, runnable deployments, and reusable scene and embodiment components for manipulation, locomotion, and classic control. | [Task configurations and authoring](embodichain/extensions/tasks/README.md) | +| `embodichain.extensions.robots` | Concrete robot presets, model assets, and calibrated defaults, organized by vendor and model. | [Robot catalog and configuration](embodichain/extensions/robots/README.md) | +| `embodichain.extensions.models` | Policy models for action prediction, and world models / neural dynamics models for predicting future states and environment dynamics. | [Model families and workflows](embodichain/extensions/models/README.md) | +| `embodichain.extensions.solvers` | Native physics deployment adapters. | [Solver adapters](embodichain/extensions/solvers/README.md) | +| `embodichain.extensions.benchmarks` | Motion planning and Atomic Skill evaluation suites with scenarios, planner adapters, scoring, and reports. | [Benchmark suites and usage](embodichain/extensions/benchmarks/motion_generation/README.md) | + +The core provides shared simulation, data, and learning infrastructure. +Extensions build on those APIs for specific workflows. See each workflow's +guide for model weights, datasets, and optional runtime dependencies. + +See the [extension development guide](embodichain/extensions/README.md) for package layout and how to add a bundled extension. ## Contribution Guide diff --git a/agent_context/MAP.yaml b/agent_context/MAP.yaml index 6474bc5878..0b8a87dd64 100644 --- a/agent_context/MAP.yaml +++ b/agent_context/MAP.yaml @@ -84,8 +84,8 @@ topics: - embodichain/lab/gym/envs/managers/observation_types.py - embodichain/lab/gym/envs/demo.py - embodichain/lab/gym/utils/profiler.py - - extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/ - watch_paths: [embodichain/lab/gym/utils/, embodichain/lab/gym/envs/task_program/, embodichain/cli/, extensions/embodichain_tasks/, + - embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/ + watch_paths: [embodichain/lab/gym/utils/, embodichain/lab/gym/envs/task_program/, embodichain/cli/, embodichain/extensions/tasks/, tests/gym/envs/, embodichain/lab/evaluation/, tests/lab/evaluation/, tests/lab/scripts/test_evaluate_task_objective.py] related_topics: [simulation-system, manager-functor, sim-visualization, task-programs, data-pipeline] status: active @@ -136,7 +136,7 @@ topics: aliases: [robot system, robot config, robot catalog, list robot, robot preview, 机器人配置, 机器人系统, 机型解析, 列出机器人, 机器人预览] keywords: [AgibotG1, AgibotG1Cfg, UnitreeGo1Cfg, UnitreeGo2Cfg, UnitreeG1Cfg, UnitreeH12Cfg, ANYmalCCfg, MicroDuckCfg, load_locomotion_robot_profile, RobotCfg, RobotPresetCfg, control_parts, get_qvel_limits, build_pk_serial_chain, DexforceW1Cfg, CobotMagicCfg, ARX5Cfg, ARX5, FlexivRizon4SCfg, FlexivRizon4S, FrankaCfg, FrankaPandaCfg, YamI2rtCfg, URRobotCfg, BrainCoRevo1Cfg, DualArmRobotCfg, merge_robot_cfg, JointDrivePropertiesCfg, - asset_physics_mode, target_mode, mimic joint, quaternion, xyzw, embodichain_robots, resolve_robot_cfg, list-robot, preview-robot, + asset_physics_mode, target_mode, mimic joint, quaternion, xyzw, embodichain.extensions.robots, resolve_robot_cfg, list-robot, preview-robot, RobotHandGeometryCfg, RobotHandGeometryProvider, RobotCoordinatedGraspProvider, ParallelJawGripperCfg, resolve_gripper_defaults, 二指夹爪, 机器人手部几何采样] paths: [topics/robot-system/robot-system.md] source_of_truth: @@ -148,7 +148,7 @@ topics: - embodichain/lab/sim/utility/gripper_geometry.py - embodichain/cli/list_robot.py - embodichain/lab/scripts/preview_robot.py - - extensions/embodichain_robots/ + - embodichain/extensions/robots/ - embodichain/lab/sim/cfg/ - embodichain/lab/gym/envs/embodied_env.py watch_paths: [tests/sim/robots/, tests/test_robot_registry.py, tests/cli/test_list_robot.py, tests/lab/scripts/test_preview_robot.py, @@ -244,7 +244,7 @@ topics: - embodichain/lab/sim/motion/limits.py - embodichain/lab/sim/motion/search.py - embodichain/lab/sim/motion/refinement.py - - extensions/embodichain_benchmarks/motion_generation/ + - embodichain/extensions/benchmarks/motion_generation/ - embodichain/cli/benchmark.py - embodichain/lab/sim/motion/execution.py - embodichain/lab/sim/motion/planners/utils.py @@ -323,23 +323,23 @@ topics: title: Neural Dynamics Models and Training aliases: [neural dynamics, neural robot dynamics, NeRD, RigidFormer, WorldParticle, 神经动力学, 动力学模型训练, NeRD 示例, RigidFormer 示例] keywords: [NeRDStateCodec, NeRDModel, NeRDGeometry, NeRDState, NeRDTransition, NeRDModelEnv, DynamicsGenerationCfg, - DynamicsShardWriter, DynamicsWindowDataset, DynamicsTrainer, embodichain_models, + DynamicsShardWriter, DynamicsWindowDataset, DynamicsTrainer, embodichain.extensions.models, learning/nerd, nerd reference assets, RigidFormerModel, MOViSequenceSource, build_rigidformer_trainer, WorldParticleModel, WorldParticleProvider, learning/worldparticle, 官方训练精度对比] paths: [topics/neural-dynamics/neural-dynamics.md] source_of_truth: - - extensions/embodichain_models/embodichain_models/dynamics/nerd/ - - extensions/embodichain_solvers/embodichain_solvers/physics/nerd/ + - embodichain/extensions/models/dynamics/nerd/ + - embodichain/extensions/solvers/physics/nerd/ - examples/learning/nerd/__main__.py - examples/learning/nerd/_resources.py - examples/learning/nerd/_support/ - examples/learning/nerd/configs/ - - extensions/embodichain_models/embodichain_models/dynamics/rigidformer/ + - embodichain/extensions/models/dynamics/rigidformer/ - examples/learning/rigidformer/ - - extensions/embodichain_models/embodichain_models/dynamics/worldparticle/ - - extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/ + - embodichain/extensions/models/dynamics/worldparticle/ + - embodichain/extensions/solvers/physics/worldparticle/ - examples/learning/worldparticle/ - watch_paths: [extensions/embodichain_models/, examples/learning/nerd/, docs/source/features/neural_dynamics.md, + watch_paths: [embodichain/extensions/models/, examples/learning/nerd/, docs/source/features/neural_dynamics.md, docs/source/features/neural_dynamics/, docs/source/guides/neural_dynamics.md, docs/source/api_reference/model_catalogs.rst, docs/source/api_reference/model_rigidformer.rst] related_topics: [supervised-learning, robot-world-model, learning-layers, data-pipeline, data-assets] @@ -390,7 +390,7 @@ topics: - embodichain/learning/rl/policies/ - embodichain/learning/rl/experimental/ - embodichain/learning/models/ - - extensions/embodichain_tasks/configs/tasks/ + - embodichain/extensions/tasks/configs/tasks/ - examples/learning/sharpa_inhand/ - examples/learning/wuji_inhand/ watch_paths: [embodichain/learning/rl/, tests/learning/, examples/learning/sharpa_inhand/, @@ -408,7 +408,7 @@ topics: - embodichain/lab/gym/envs/differentiable_env.py - embodichain/lab/sim/cfg/simulation.py - embodichain/lab/sim/diff/ - - extensions/embodichain_tasks/embodichain_tasks/special/franka_reach_apg.py + - embodichain/extensions/tasks/special/franka_reach_apg.py related_topics: [env-framework, rl-learning] status: active - id: configclass-pattern @@ -491,8 +491,8 @@ topics: - .agents/skills/add-task-program/scripts/inspect_deployment.py - embodichain/lab/gym/envs/task_program/ - embodichain/agents/mllm/task_program.py - watch_paths: [extensions/embodichain_tasks/configs/components/embodiments/, extensions/embodichain_tasks/configs/components/execution_policies/, - extensions/embodichain_tasks/configs/components/expansion_policies/, extensions/embodichain_tasks/configs/tasks/manipulation/, + watch_paths: [embodichain/extensions/tasks/configs/components/embodiments/, embodichain/extensions/tasks/configs/components/execution_policies/, + embodichain/extensions/tasks/configs/components/expansion_policies/, embodichain/extensions/tasks/configs/tasks/manipulation/, tests/lab/task_program/] related_topics: [atomic-actions, env-framework, simulation-system, motion-planning, sensor-system, data-pipeline] status: active @@ -588,9 +588,9 @@ topics: paths: [topics/assembly-assets/assembly-assets.md] source_of_truth: - embodichain/toolkits/assembly/ - - extensions/embodichain_benchmarks/assembly/ + - embodichain/extensions/benchmarks/assembly/ watch_paths: [embodichain/toolkits/assembly/, - extensions/embodichain_benchmarks/assembly/, + embodichain/extensions/benchmarks/assembly/, examples/sim/assembly/, scripts/benchmark/assembly/, tests/toolkits/assembly/, tests/sim/assembly/, tests/benchmark/assembly/] related_topics: [gen-sim, data-assets, simulation-system, env-framework, rl-learning] @@ -606,7 +606,7 @@ topics: - embodichain/data/dataset.py - embodichain/data/_references.py - embodichain/data/_asset_registry.py - - extensions/embodichain_robots/_asset_catalog.py + - embodichain/extensions/robots/_asset_catalog.py - embodichain/data/constants.py - embodichain/data/download.py - embodichain/data/__init__.py @@ -620,7 +620,7 @@ topics: - embodichain/data/default_materials.py - embodichain/data/default_materials.json - embodichain/_material_catalog.py - watch_paths: [embodichain/data/, extensions/embodichain_robots/, embodichain/cli/main.py, tests/data/] + watch_paths: [embodichain/data/, embodichain/extensions/robots/, embodichain/cli/main.py, tests/data/] related_topics: [gen-sim, robot-system, data-pipeline] status: active - id: data-pipeline @@ -716,7 +716,7 @@ topics: source_of_truth: - embodichain/learning/sl/ - embodichain/cli/main.py - - extensions/embodichain_models/embodichain_models/policy/act/ + - embodichain/extensions/models/policy/act/ - examples/learning/act/ watch_paths: [tests/learning/sl/, tests/models/policy/] related_topics: [learning-layers, data-pipeline, rl-learning, neural-dynamics, robot-world-model] @@ -728,12 +728,12 @@ topics: replay_supervised_batch, learning/rwm] paths: [topics/robot-world-model/robot-world-model.md] source_of_truth: - - extensions/embodichain_models/embodichain_models/dynamics/rwm/ + - embodichain/extensions/models/dynamics/rwm/ - examples/learning/rwm/ - examples/learning/motion_tracking/ - embodichain/learning/dynamics/schedule.py - - extensions/embodichain_models/embodichain_models/policies/motion_tracking.py - - extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/motion_model.py + - embodichain/extensions/models/policies/motion_tracking.py + - embodichain/extensions/tasks/locomotion/tracking/motion_model.py watch_paths: [tests/models/dynamics/rwm/, embodichain/learning/dynamics/, tests/learning/test_online_schedule.py, tests/gym/envs/tasks/test_motion_model.py, docs/source/features/neural_dynamics/rwm.md, docs/source/api_reference/rwm.rst] diff --git a/agent_context/topics/assembly-assets/assembly-assets.md b/agent_context/topics/assembly-assets/assembly-assets.md index 5550a542c0..b964262e11 100644 --- a/agent_context/topics/assembly-assets/assembly-assets.md +++ b/agent_context/topics/assembly-assets/assembly-assets.md @@ -9,7 +9,7 @@ Native preparation is an explicit opt-in through `embodichain.toolkits.assembly. |---|---| | Pinned mjfit provider, manifests, sampling and USD format export | `embodichain/toolkits/assembly/` | | Native compound configs and actual hinge articulations | `embodichain/toolkits/assembly/native.py` | -| Reference execution, analytic probes and measurement | `extensions/embodichain_benchmarks/assembly/` | +| Reference execution, analytic probes and measurement | `embodichain/extensions/benchmarks/assembly/` | `build_assembly` produces source body-local geometry, independent visual parts, mass/COM/inertia, world attachments and source contact metadata. Loading a @@ -53,7 +53,7 @@ Rigid preview preparation validates every body name and OBJ/MTL destination before writing the batch. Cache symlinks cannot redirect output outside its preparation root; bodies with no visible surfaces retain empty appearance. -`embodichain_benchmarks.assembly.precision` checks geometry/USD ownership and runs passive source/native +`embodichain.extensions.benchmarks.assembly.precision` checks geometry/USD ownership and runs passive source/native comparisons. MuJoCo Warp references declare their constants protocol through `PrecisionRunCfg.warp_reference_initialization`: `cpu_compiled` preserves the imported reference baseline; `warp_recomputed` explicitly calls public @@ -82,7 +82,7 @@ contact/algorithm profile. Report grouping uses requested family/CPU identity, including unsuccessful cells; actual dispatch is shown independently. Every matrix cell owns its preparation directory. -`embodichain_benchmarks.assembly.probes` owns independent constrained circle/square clearance oracles. +`embodichain.extensions.benchmarks.assembly.probes` owns independent constrained circle/square clearance oracles. Many-pegs endpoint seating and gear ratios do not replace those independent measurements. Constrained `integration_substeps` defaults to four, resolving stiff float32 contacts with a finer interval on every reference/native route. diff --git a/agent_context/topics/atomic-actions/execution.md b/agent_context/topics/atomic-actions/execution.md index 1558b9efbf..766698eb19 100644 --- a/agent_context/topics/atomic-actions/execution.md +++ b/agent_context/topics/atomic-actions/execution.md @@ -213,7 +213,7 @@ configured minimum cycle up to an advertised clock quantum before sleeping. The benchmark extension's `scenarios/_replay_diagnostics.py` and `atomic_replay.py` collect optional Atomic replay evidence without changing stage scoring or controller commands. The -[benchmark README](../../../extensions/embodichain_benchmarks/motion_generation/README.md#physical-replay-diagnostics) +[benchmark README](../../../embodichain/extensions/benchmarks/motion_generation/README.md#physical-replay-diagnostics) owns the configuration, recorded fields and timing interpretation. ## Planning budgets and adoption diff --git a/agent_context/topics/data-assets/data-assets.md b/agent_context/topics/data-assets/data-assets.md index a9fbe231c5..39c5a5ad3c 100644 --- a/agent_context/topics/data-assets/data-assets.md +++ b/agent_context/topics/data-assets/data-assets.md @@ -14,7 +14,7 @@ Online sampling and demonstration persistence belong to | Cache roots / mirror prefix | `embodichain/data/constants.py` | | Locked download and ZIP integrity | `embodichain/data/dataset.py`: `EmbodiChainDataset`, `_dataset_download_lock()` | | Shared class discovery | `embodichain/data/_asset_registry.py`: core modules and `embodichain.assets` catalogs | -| Robot-owned asset definitions | `extensions/embodichain_robots/_asset_catalog.py` → vendor/model `assets.py` | +| Robot-owned asset definitions | `embodichain/extensions/robots/_asset_catalog.py` → vendor/model `assets.py` | | YAM source conversion and reproducible archive | `scripts/tools/prepare_yam_i2rt_assets.py` → [source and published assets](../../../docs/source/resources/robot/i2rt/yam.md#published-assets-and-offline-use) | | CLI list/download | `embodichain/data/download.py`: `get_registry()`, `download_asset()` | | Default material catalog / provenance | `embodichain/_material_catalog.py` → `embodichain/data/default_materials.py`; `embodichain/data/default_materials.json` | @@ -73,13 +73,13 @@ the public `CATEGORY_MODULES` mapping remains a single-module compatibility view Catalogs are cached for the process lifetime; refresh editable metadata and restart after changing entry points. -Migrated robot assets live in `embodichain_robots`, alongside each model or at +Migrated robot assets live in `embodichain.extensions.robots`, alongside each model or at vendor level for shared archives. The legacy `robot_assets`, `w1_assets`, `so101_assets` and migrated `locomotion_assets` names forward to the same class objects. Discovery excludes these imported aliases so IDs register once. Keep class names, asset IDs, URLs, digests and cache prefixes stable across ownership moves. EEF asset classes live in vendor/model `assets.py` modules -in `embodichain_robots`, registered once under category `eef` by the same +in `embodichain.extensions.robots`, registered once under category `eef` by the same catalog. Their former `embodichain.data.assets.eef_assets` module and aggregate class exports are removed; use the canonical modules or `get_data_class()`. String asset IDs and archive/cache paths remain unchanged. Pika belongs to @@ -99,7 +99,7 @@ and exits nonzero if any requested asset failed. `_ensure_extract()` copies non-ZIP downloads into the extract tree when needed. Solver/planner checkpoint download helpers can have separate paths. -`SO101FollowerAssets` in `embodichain_robots.the_robot_studio.so101.assets` also belongs to the robot CLI +`SO101FollowerAssets` in `embodichain.extensions.robots.the_robot_studio.so101.assets` also belongs to the robot CLI category. It resolves a pinned official URDF and individual STL/reference files, verifies every SHA256, and repairs dependencies under the shared dataset lock. Keep its source revision and complete file checksums together when updating it. @@ -117,7 +117,7 @@ evidence. These are visual-only scenes and supply no enclosing collision box. normal runtime consumers download the completed archive. Package admission and native RGB evidence do not certify metric Gaussian depth or industrial readiness. Official Task Program deployments live under -`extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/`. +`embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/`. `examples/gym/gaussian_pick_place/` consumes those definitions for RGB recording, video export and offline acceptance; it does not own another task configuration. @@ -127,11 +127,11 @@ resolve the existing `Panda/Panda.urdf`; embodiments mount the derived hand explicitly. Source and derived digests are recorded together. `FrankaPandaArm` is a separate pinned original-Panda asset in -`embodichain_robots.franka.assets`; `FrankaV4` remains the historical FR3 asset. +`embodichain.extensions.robots.franka.assets`; `FrankaV4` remains the historical FR3 asset. The original-Panda derivative normalizes only authored rounded right angles, checks the upstream URDF digest and writes derivation evidence under the shared dataset lock. Its identity must stay distinct from the FR3 archive; see the -[vendor provenance](../../../extensions/embodichain_robots/franka/README.md). +[vendor provenance](../../../embodichain/extensions/robots/franka/README.md). `UniversalRobots` selects the V4 archive with corrected UR3/UR3e material colors. Its versioned `UniversalRobotsV4` cache directory changes source paths diff --git a/agent_context/topics/data-pipeline/data-pipeline.md b/agent_context/topics/data-pipeline/data-pipeline.md index 44ff61c455..56b18c8bcf 100644 --- a/agent_context/topics/data-pipeline/data-pipeline.md +++ b/agent_context/topics/data-pipeline/data-pipeline.md @@ -24,7 +24,7 @@ belongs to [data-assets](../data-assets/data-assets.md). | File-only validation and grouped quality splits | `embodichain/data_pipeline/datasets/inspection.py`; `embodichain dataset validate\|split` | | Annotated real2sim source/prototype and task-specific DemoSkill preparation | `embodichain/data_pipeline/real2sim/`; `embodichain real2sim prepare\|validate` | | Durable commit diagnostics and metadata repair | `embodichain/data_pipeline/recording/journal.py`; `embodichain dataset recover` | -| NeRD-specific HDF5 windows and teacher collection | `extensions/embodichain_models/embodichain_models/dynamics/nerd/data.py` and `examples/learning/nerd/_support/_generation.py`; contracts in [neural dynamics](../neural-dynamics/neural-dynamics.md) | +| NeRD-specific HDF5 windows and teacher collection | `embodichain/extensions/models/dynamics/nerd/data.py` and `examples/learning/nerd/_support/_generation.py`; contracts in [neural dynamics](../neural-dynamics/neural-dynamics.md) | | Isolated LeRobot 0.6.1 language/depth conversion | `tools/lerobot_export/` (Python >=3.12, independent dependencies) | Real2Sim normalization keeps source qpos, raw velocity, optional command and diff --git a/agent_context/topics/differentiable-env/differentiable-env.md b/agent_context/topics/differentiable-env/differentiable-env.md index 924d7893fd..57320133d5 100644 --- a/agent_context/topics/differentiable-env/differentiable-env.md +++ b/agent_context/topics/differentiable-env/differentiable-env.md @@ -78,7 +78,7 @@ synchronously. ## Franka reference task -`embodichain_tasks.special.franka_reach_apg.FrankaReachApgEnv` is the canonical +`embodichain.extensions.tasks.special.franka_reach_apg.FrankaReachApgEnv` is the canonical example. Its path is: action → new_joint_q → newton.eval_fk → body_q → reward kernel → action.grad @@ -107,7 +107,7 @@ APIs remain in `compute.kinematics` and `learning.layers`. - `embodichain/lab/gym/envs/differentiable_env.py` - `embodichain/lab/sim/cfg/simulation.py` - `embodichain/lab/sim/diff/` -- `extensions/embodichain_tasks/embodichain_tasks/special/franka_reach_apg.py` +- `embodichain/extensions/tasks/special/franka_reach_apg.py` ## Focused validation diff --git a/agent_context/topics/env-framework/configuration.md b/agent_context/topics/env-framework/configuration.md index 7625bc99b3..f4bcb56da4 100644 --- a/agent_context/topics/env-framework/configuration.md +++ b/agent_context/topics/env-framework/configuration.md @@ -28,11 +28,9 @@ class MyTaskEnv(EmbodiedEnv): classes/types). A `RuntimeError` is raised otherwise. 6. Use `override=True` to re-register an existing uid (useful in scripts/tests). -In a source checkout, `embodichain_tasks/__init__.py` resolves the sibling -`configs` package before eager registration. This keeps task code and resources -in the same selected worktree even when an editable install maps configs to -another checkout. Its temporary search path is removed before walking task -modules; wheel installations retain their normal nested resource layout. +The official task package is `embodichain.extensions.tasks`. Task modules and the +`configs` package share the same directory in source checkouts and installed +wheels. The `embodichain.tasks` entry point runs automatic task registration. ### Gym ID convention @@ -132,9 +130,8 @@ an embodiment's simulation robot and sensor suite while keeping its events, observations, objects, and Python demo logic task-local. Ordinary component paths resolve relative to the runnable config that declares them (conventionally `task..yaml`). References starting with -`extensions/embodichain_tasks/configs/` or the legacy -`embodichain_tasks/configs/` resolve through the imported SDK's configs, including -from an external deployment or installed wheel; same-named CWD files do not +`embodichain/extensions/tasks/configs/` resolve through the imported SDK's +configs, including from an external deployment or installed wheel. Same-named CWD files do not override these selections. Both component resolvers reuse `resolve_config_path(..., base_dir=owner_directory)`. Calling that public helper without `base_dir` retains its ordinary filesystem/CWD behavior. @@ -243,7 +240,7 @@ The dual-UR5 and Marvin embodiments also own the shared `cam_high` view; Marvin retains its robot-owned wrist cameras. Their `left` / `right` resources expose primary/secondary manipulator aliases as composite resources with the same physical leaves, so both program naming conventions retain -physical conflict detection. See `extensions/embodichain_tasks/README.md` for +physical conflict detection. See `embodichain/extensions/tasks/README.md` for the supported task/deployment matrix and qualification boundaries. Gym copies the selected robot configuration @@ -383,7 +380,7 @@ See [execution](execution.md) for the separate result authority and reset contra Use the `/add-task-env` skill. It first selects one of two registration paths: 1. Import-backed handwritten or RL tasks add a task-named module at - `extensions/embodichain_tasks/embodichain_tasks//.py`, keep + `embodichain/extensions/tasks//.py`, keep `@register_env("")` and `__all__` there, and add a runnable config. 2. Supported configuration-defined manipulation RL deployments omit the Python module and declare `rl_task`; see the configuration-owned RL contract above. diff --git a/agent_context/topics/env-framework/env-framework.md b/agent_context/topics/env-framework/env-framework.md index 60a9956a6b..fec2d72a20 100644 --- a/agent_context/topics/env-framework/env-framework.md +++ b/agent_context/topics/env-framework/env-framework.md @@ -15,7 +15,7 @@ managers, demonstration collection and the opt-in Task Program bridge. | Public execution-free component expansion | `embodichain/lab/gym/utils/composition.py` → shared strict decoders | | Config decoding | `embodichain/lab/gym/utils/gym_utils.py` | | Robot selector decoding | `robot.class_type` → `embodichain/robot_registry.py`; catalog ownership is in [robot-system](../robot-system/robot-system.md) | -| Import registration | `embodichain/lab/gym/utils/registration.py`; official task imports under `extensions/embodichain_tasks/embodichain_tasks/` | +| Import registration | `embodichain/lab/gym/utils/registration.py`; official task imports under `embodichain/extensions/tasks/` | | Environment cadence resolution | `embodichain/lab/gym/utils/control_timing.py`: `resolve_control_timing`, `ControlTiming` | | Environment loop | `embodichain/lab/gym/envs/base_env.py`: `EnvCfg`, `BaseEnv` | | Scene, managers, RL outcomes and demonstration integration | `embodichain/lab/gym/envs/embodied_env.py` | @@ -26,7 +26,7 @@ managers, demonstration collection and the opt-in Task Program bridge. | Cable scene declarations and raw recording | `gym_utils.py` → `EmbodiedEnv._setup_interactive_objects()`; `trajectory_state.py` → `observations.get_entity_state` | | Demo segment execution / outcomes / collection qualification | `embodichain/lab/gym/envs/demo.py` | | Configured Task Program registration | `embodichain/lab/gym/envs/task_program/registration.py` | -| Captured-GS Pick/Place deployments | `extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/`; reusable components under `extensions/embodichain_tasks/configs/components/` | +| Captured-GS Pick/Place deployments | `embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/`; reusable components under `embodichain/extensions/tasks/configs/components/` | | Timing instrumentation | `embodichain/lab/gym/utils/profiler.py` | Read [configuration and registration](configuration.md) for task-first layout, @@ -37,7 +37,7 @@ Task Program execution, DexUni rigid/DFSPH dynamics and fluid coordinates. Official model defaults stay in the robot catalog; task contracts own locomotion actions, observations, rewards and termination. Reference-motion task state/snapshots live under -`embodichain_tasks/locomotion/tracking/`, with model rollout boundaries in +`embodichain/extensions/tasks/locomotion/tracking/`, with model rollout boundaries in [robot world model](../robot-world-model/robot-world-model.md). ## Launcher argument ownership diff --git a/agent_context/topics/ik-solvers/ik-solvers.md b/agent_context/topics/ik-solvers/ik-solvers.md index 7dcece4802..5233d1c4ba 100644 --- a/agent_context/topics/ik-solvers/ik-solvers.md +++ b/agent_context/topics/ik-solvers/ik-solvers.md @@ -141,7 +141,7 @@ CPU-only; general algebraic models require an explicitly built artifact and matching manifest before initialization. Its build/load boundary lives in `solvers/_ssik_reference.py`; Warp imports do not load that dependency. Explicit prepared ARX5/Rizon4S reference artifacts live in -`embodichain_robots/_ssik_artifacts/`; the former contains actual-model RR +`embodichain/extensions/robots/_ssik_artifacts/`; the former contains actual-model RR coefficients, while the latter certifies the pinned prebuilt joint prefix and bakes its terminal-frame correction. The offline builder's `--prebuilt-model` option verifies joint order, normalized axes and pre-terminal offsets before diff --git a/agent_context/topics/learning-layers/learning-layers.md b/agent_context/topics/learning-layers/learning-layers.md index 039a89773b..2510c52fd2 100644 --- a/agent_context/topics/learning-layers/learning-layers.md +++ b/agent_context/topics/learning-layers/learning-layers.md @@ -29,7 +29,7 @@ and configuration-driven MLP construction. `EmpiricalNormalizer.scale` exposes the configured additive or quadratic epsilon scale; clipping is optional. These shared components do not import RL, TensorDict or simulation. Concrete NeRD models, codecs and the shared-SL -recipe live in the bundled `embodichain_models.dynamics.nerd` extension; +recipe live in the bundled `embodichain.extensions.models.dynamics.nerd` extension; teacher collection, historical training and research belong to `examples/learning/nerd/`. See [neural dynamics](../neural-dynamics/neural-dynamics.md) for model, SL integration, diff --git a/agent_context/topics/motion-planning/motion-planning.md b/agent_context/topics/motion-planning/motion-planning.md index df16f69a42..ec015e72dd 100644 --- a/agent_context/topics/motion-planning/motion-planning.md +++ b/agent_context/topics/motion-planning/motion-planning.md @@ -17,7 +17,7 @@ collection belong to their hosts. | Sampled Cartesian geometry → timing → robot IK | `embodichain/lab/sim/motion/planners/_cartesian_profiles.py` (internal adapter) | | Collision planning and scene conversion | `embodichain/lab/sim/motion/planners/curobo/` | | NMG policy rollout and export metadata | `embodichain/lab/sim/motion/planners/neural_planner.py` | -| Installable evaluation suites and external planner adapters | `extensions/embodichain_benchmarks/motion_generation/api.py`, `planners/base.py` in that package | +| Installable evaluation suites and external planner adapters | `embodichain/extensions/benchmarks/motion_generation/api.py`, `planners/base.py` in that package | | Pure interpolation, resampling and retiming | `embodichain/compute/trajectory/` | | Contact-qualified paired grasp sampling and explicit URDF surfaces | `embodichain/toolkits/graspkit/pg_grasp/coordinated.py`, `urdf_surfaces.py` in that directory | | Bounded interaction pose refinement before expansion | `embodichain/lab/sim/motion/refinement.py`, with numeric fitting in `compute/trajectory/refinement.py`; [Real2Sim boundary](../data-pipeline/real2sim.md) | @@ -102,15 +102,15 @@ owns cross-domain collection; [scene expansion](../scene-expansion/scene-expansi owns layout proposals and host integration. [Real2Sim](../data-pipeline/real2sim.md) owns protected source mapping and retiming. -The installed benchmark host is `embodichain_benchmarks.motion_generation`. +The installed benchmark host is `embodichain.extensions.benchmarks.motion_generation`. It owns scene lifetime, frozen cases, evaluation and artifacts; adapters return `PlanResult` and expose `MotionGenerator` for Atomic evaluation. Configuration preflight and runtime capability declarations remain separate. Frozen inputs do not guarantee identical stochastic outcomes across schedules. Parallel quality work uses spawned processes; performance replay stays serial and excludes contended timing. Population, masked-constraint, contact-scoring and uncertainty -rules live in the [benchmark README](../../../extensions/embodichain_benchmarks/motion_generation/README.md) -and [design contract](../../../extensions/embodichain_benchmarks/motion_generation/BENCHMARK_DESIGN.md). +rules live in the [benchmark README](../../../embodichain/extensions/benchmarks/motion_generation/README.md) +and [design contract](../../../embodichain/extensions/benchmarks/motion_generation/BENCHMARK_DESIGN.md). ## Focused validation diff --git a/agent_context/topics/neural-dynamics/neural-dynamics.md b/agent_context/topics/neural-dynamics/neural-dynamics.md index 78a119fb38..195c205d54 100644 --- a/agent_context/topics/neural-dynamics/neural-dynamics.md +++ b/agent_context/topics/neural-dynamics/neural-dynamics.md @@ -2,13 +2,13 @@ ## Entry points and ownership -The main wheel bundles `embodichain_models` with the same version and dependencies. +The main wheel bundles `embodichain.extensions.models` with the same version and dependencies. It is an import package under `extensions/`, not a separate distribution or a runtime registry. Shared MLPs and feature normalization stay in core `embodichain.learning.models`; generic supervised orchestration stays in [SL](../supervised-learning/supervised-learning.md). -The [model catalog contract](../../../extensions/embodichain_models/README.md) +The [model catalog contract](../../../embodichain/extensions/models/README.md) owns domain and public-import naming. Policy models predict actions; dynamics models predict future state or geometry. Canonical RWM and RigidFormer paths are `dynamics.rwm` and `dynamics.rigidformer`; the catalog tracks implemented families. @@ -18,10 +18,10 @@ World-model naming does not introduce a parallel `world_models` domain. | Request | Owner | |---|---| -| NeRD network, portable checkpoint, physical codec | `extensions/embodichain_models/embodichain_models/dynamics/nerd/{model,checkpoint,codec}.py` | +| NeRD network, portable checkpoint, physical codec | `embodichain/extensions/models/dynamics/nerd/{model,checkpoint,codec}.py` | | Online canonical state/history, injected FK/contact geometry and prediction | Model package `transition.py`, `geometry.py` | | Lightweight Cartpole/Ant learning factories | Example `_support/{_cartpole_env,_ant_env,_model_env,_model_factory}.py` | -| Optional native Provider, indices and physics admission | `extensions/embodichain_solvers/embodichain_solvers/physics/nerd/` | +| Optional native Provider, indices and physics admission | `embodichain/extensions/solvers/physics/nerd/` | | Committed HDF5 shards and bounded windows | Model package `data.py`, private `_resident.py` | | Encoding, frozen moments and offline errors | Model package `integration.py` | | Objective and common trainer factory | Model package `supervised.py`, `sl_recipe.py` | @@ -32,7 +32,7 @@ World-model naming does not introduce a parallel `world_models` domain. | Original-repository comparison and acceptance | Example `_support/` runners; protocol in `research/` | The showcase defaults to `sl.train.yaml` and the installable -`embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer` factory. +`embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer` factory. Direct `embodichain train-sl --config FILE` works independently of example bootstrap. An explicitly selected `dynamics.train.*.yaml` uses the historical trainer for controlled comparisons and its legacy checkpoint contract. @@ -63,7 +63,7 @@ runtime identity and viewer limits. ## RigidFormer author model The native family lives in -`extensions/embodichain_models/embodichain_models/dynamics/rigidformer/`. +`embodichain/extensions/models/dynamics/rigidformer/`. `model.py` owns geometry/configuration; `_native/` preserves licensed author code. Checkpoint import validates recorded architecture and named tensors. The community `rigidformer` package is not a runtime dependency. @@ -93,7 +93,7 @@ loading and model-frame conversion. Its package imports neither simulation nor examples. Coordinate transport stays FP32 even under caller autocast; the original frozen network uses BF16. No learned-robot codec or history contract is shared with NeRD. Both families use the existing optional Newton -Provider lifecycle in `embodichain_solvers.physics` for native deployment. +Provider lifecycle in `embodichain.extensions.solvers.physics` for native deployment. `physics.worldparticle.provider.WorldParticleProvider` owns native admission and delegates stream/state/force/write/reset machinery to the SDK's generic diff --git a/agent_context/topics/rl-learning/rl-learning.md b/agent_context/topics/rl-learning/rl-learning.md index 6176c1e293..806d08fe86 100644 --- a/agent_context/topics/rl-learning/rl-learning.md +++ b/agent_context/topics/rl-learning/rl-learning.md @@ -17,7 +17,7 @@ lazy so lightweight APG imports do not initialize the simulator-backed Trainer. | Differentiable collection/training | `embodichain/learning/rl/differentiable_trainer.py`, `collector/` | | Completed-episode evaluation | `embodichain/learning/rl/evaluation.py` | | Checkpoint, manifest and policy Viewer | `embodichain/learning/rl/checkpoint.py`, `policy_evaluation/` | -| Official deployment/agent settings | `extensions/embodichain_tasks/configs/tasks///agents/` | +| Official deployment/agent settings | `embodichain/extensions/tasks/configs/tasks///agents/` | The module training entry remains a compatibility path. Concrete settings come from the selected config/classes, not example recipes. [Training details](training.md) diff --git a/agent_context/topics/rl-learning/training.md b/agent_context/topics/rl-learning/training.md index 23f03049d0..9527e13b8d 100644 --- a/agent_context/topics/rl-learning/training.md +++ b/agent_context/topics/rl-learning/training.md @@ -110,10 +110,10 @@ currently support this distributed path. | Example | Environment path | Config location | |---------|------------------|-----------------| -| CartPole | registered simulator Gym env | `extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/` | -| PushCube | registered simulator Gym env | `extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/` | -| PointMass PPO | registered lightweight env, standard rollout | `extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml` | -| PointMass APG | differentiable lightweight env | `extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml` | +| CartPole | registered simulator Gym env | `embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/` | +| PushCube | registered simulator Gym env | `embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/` | +| PointMass PPO | registered lightweight env, standard rollout | `embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml` | +| PointMass APG | differentiable lightweight env | `embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml` | | Newton planar reach | experimental differentiable FK reference | `embodichain/learning/rl/experimental/newton/` | `PointMassRL` is the reference environment for comparing standard and @@ -147,7 +147,7 @@ example is an experimental gradient reference, not a general simulator task. 5. Expose `observation_normalize_mask` when semantic dimensions must remain raw during normalization. 6. Add an official config under - `extensions/embodichain_tasks/configs/tasks///agents/` when it is a + `embodichain/extensions/tasks/configs/tasks///agents/` when it is a bundled task. Use `add-task-env` for simulator-backed task environments and diff --git a/agent_context/topics/robot-system/catalogs.md b/agent_context/topics/robot-system/catalogs.md index 57ae639aa9..43f87c463f 100644 --- a/agent_context/topics/robot-system/catalogs.md +++ b/agent_context/topics/robot-system/catalogs.md @@ -1,7 +1,7 @@ # Robot catalogs Catalog selection and display metadata are owned by `embodichain/robot_registry.py`, -`embodichain/cli/list_robot.py` and `extensions/embodichain_robots/_catalog.py`. +`embodichain/cli/list_robot.py` and `embodichain/extensions/robots/_catalog.py`. For runtime configuration, return to [robot-system](robot-system.md). The `embodichain.robots` entry points provide lightweight catalog mappings from @@ -114,7 +114,7 @@ one. Source URDFs, runtime joint names and PK chains must remain aligned. AgiBot G2 uses seed-local SRS search with its original 18 mm elbow offset and mounting-frame TCPs on CPU/CUDA. Its preset derives geometry from the URDF; see -the [G2 model notes](../../../extensions/embodichain_robots/agibot/g2/README.md) +the [G2 model notes](../../../embodichain/extensions/robots/agibot/g2/README.md) before introducing a legacy SRS DH calibration. Marvin catalog configs preserve source mass, inertia and COM. The bundled diff --git a/agent_context/topics/robot-system/robot-system.md b/agent_context/topics/robot-system/robot-system.md index fc845ef041..6236fda8c6 100644 --- a/agent_context/topics/robot-system/robot-system.md +++ b/agent_context/topics/robot-system/robot-system.md @@ -1,7 +1,7 @@ # Robot System Generic configuration/runtime belongs to `lab/sim`; concrete presets, asset -identity and calibrated defaults belong to `embodichain_robots`. +identity and calibrated defaults belong to `embodichain.extensions.robots`. ## Find the owner @@ -11,16 +11,16 @@ identity and calibrated defaults belong to `embodichain_robots`. | Pure parallel-jaw defaults, mounted/existing bindings and standalone hand configs | `embodichain/robot_registry.py` → `resolve_gripper_defaults`; `embodichain/lab/gym/utils/_gripper_composition.py`; `embodichain/lab/sim/cfg/gripper.py` | | Explicit hand geometry capture and lazy paired grasp ownership | `embodichain/lab/sim/utility/grasp_geometry.py` | | Config decoding, construction hooks, backend alternatives | `embodichain/lab/sim/cfg/robot.py` → `RobotCfg`, `RobotPresetCfg` | -| Available robot configs and variants | `extensions/embodichain_robots/_catalog.py`; `extensions/embodichain_robots/__init__.py` owns lazy exports | -| YAM dual-arm defaults and source-aligned FK/IK | `extensions/embodichain_robots/i2rt/yam/cfg.py` → [model and asset usage](../../../docs/source/resources/robot/i2rt/yam.md) | -| Locomotion assets, standing poses, drives and reference frames | `extensions/embodichain_robots/locomotion_profiles.py` reads each vendor/model's `profile.json`; model packages own `cfg.py` and `assets.py` | +| Available robot configs and variants | `embodichain/extensions/robots/_catalog.py`; `embodichain/extensions/robots/__init__.py` owns lazy exports | +| YAM dual-arm defaults and source-aligned FK/IK | `embodichain/extensions/robots/i2rt/yam/cfg.py` → [model and asset usage](../../../docs/source/resources/robot/i2rt/yam.md) | +| Locomotion assets, standing poses, drives and reference frames | `embodichain/extensions/robots/locomotion_profiles.py` reads each vendor/model's `profile.json`; model packages own `cfg.py` and `assets.py` | | Shared Gym/CLI/dual-arm selection | `embodichain/robot_registry.py` → `list_robot_cfgs`, `resolve_robot_cfg` | | Robot listing CLI | `embodichain/cli/list_robot.py` → `embodichain list-robot` | | Generic robot preview and standalone RobotCfg files | `embodichain/lab/scripts/preview_robot.py` → `embodichain preview-robot` | -| Bare Franka arm selection and explicit tool assembly | `extensions/embodichain_robots/franka/cfg.py`, `panda.py` → [catalog contracts](catalogs.md) | -| W1 variants and serialization | `extensions/embodichain_robots/dexforce/w1/` → `cfg.py`, `specs.py`, `hand_specs.py` | -| Independent Revo1 hand or shared hand asset names | `extensions/embodichain_robots/brainco/revo1/` → `cfg.py`, `_specs.py` | -| AgiBot G1 preset and pinned GenieSim USD | `extensions/embodichain_robots/agibot/g1/` → `cfg.py`, `assets.py` | +| Bare Franka arm selection and explicit tool assembly | `embodichain/extensions/robots/franka/cfg.py`, `panda.py` → [catalog contracts](catalogs.md) | +| W1 variants and serialization | `embodichain/extensions/robots/dexforce/w1/` → `cfg.py`, `specs.py`, `hand_specs.py` | +| Independent Revo1 hand or shared hand asset names | `embodichain/extensions/robots/brainco/revo1/` → `cfg.py`, `_specs.py` | +| AgiBot G1 preset and pinned GenieSim USD | `embodichain/extensions/robots/agibot/g1/` → `cfg.py`, `assets.py` | | Composed robot frames and joint-name mapping | `embodichain/lab/sim/robots/dual_arm.py` | | Shared articulation state and drive properties | `embodichain/lab/sim/objects/articulation.py`, `embodichain/lab/sim/cfg/articulation.py` | diff --git a/agent_context/topics/robot-world-model/robot-world-model.md b/agent_context/topics/robot-world-model/robot-world-model.md index 0743801beb..e9bc8a542d 100644 --- a/agent_context/topics/robot-world-model/robot-world-model.md +++ b/agent_context/topics/robot-world-model/robot-world-model.md @@ -2,7 +2,7 @@ ## Ownership and entry points -`embodichain_models.dynamics.rwm` is the canonical model package. Its `model.py` +`embodichain.extensions.models.dynamics.rwm` is the canonical model package. Its `model.py` owns body-frame state increments; `kinematic.py` owns `KinematicWorldModel`, with heading-frame increments and full-body FK features. `robot_state.py` owns the canonical state representation and SO(3) transforms. They have no simulation or example @@ -60,7 +60,7 @@ policy performance. ## Online motion learning -`embodichain_models.policies.motion_tracking` owns the goal encoder/decoder actor +`embodichain.extensions.models.policies.motion_tracking` owns the goal encoder/decoder actor and scalar critic. The official task's `tracking/motion_model.py` composes shared FK, reference queries and reward/continuation rules into a tensor-only environment. Replay starts include clean history, previous actions, physical context and frame diff --git a/agent_context/topics/simulation-system/fluids.md b/agent_context/topics/simulation-system/fluids.md index 39a8944f77..5c5c7378e5 100644 --- a/agent_context/topics/simulation-system/fluids.md +++ b/agent_context/topics/simulation-system/fluids.md @@ -112,4 +112,4 @@ belong to [fluid Gym integration](../env-framework/fluid-replay.md). The robot demonstrations, task assets, Gym declarations, observations, recording, Task Program runner and replay belong to the pouring task layer. See [fluid Gym integration](../env-framework/fluid-replay.md) and the task's -`extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/README.md`. +`embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/README.md`. diff --git a/agent_context/topics/supervised-learning/supervised-learning.md b/agent_context/topics/supervised-learning/supervised-learning.md index 5086ed9f44..1483999f88 100644 --- a/agent_context/topics/supervised-learning/supervised-learning.md +++ b/agent_context/topics/supervised-learning/supervised-learning.md @@ -3,7 +3,7 @@ `embodichain.learning.sl` owns common supervised optimizer updates and offline training orchestration. Shared MLPs and feature normalization remain in `learning.models`; concrete model families and their model-specific adapters live -in the bundled `embodichain_models` extension. Generic numerical state and geometry +in the bundled `embodichain.extensions.models` extension. Generic numerical state and geometry operations remain in `compute`; source storage belongs to data adapters. ## Entry points @@ -31,13 +31,13 @@ operations remain in `compute`; source storage belongs to data adapters. callers; it cleans up only groups it creates. Launch commands and a complete masked-regression factory live in `examples/learning/sl_ddp/`. - The [NeRD recipe](../neural-dynamics/neural-dynamics.md) is an installable factory - at `embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer`. + at `embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`. The core does not import the model extension or example helpers. The NeRD showcase's default `train` command uses this same common recipe. - The [RWM recipe](../robot-world-model/robot-world-model.md) is - `embodichain_models.dynamics.rwm.sl_recipe:build_rwm_trainer`. Its model, + `embodichain.extensions.models.dynamics.rwm.sl_recipe:build_rwm_trainer`. Its model, state codec, objective, predictor and replay belong to that model family. -- Visual ACT belongs to `embodichain_models.policy.act` and invokes LeRobot +- Visual ACT belongs to `embodichain.extensions.models.policy.act` and invokes LeRobot 0.6.1's official trainer rather than this SL trainer. `build_act_train_config` validates ordered data/control contracts; `load_act_policy` loads native weights and processors with a portable task/data manifest. The runtime uses diff --git a/agent_context/topics/task-programs/configuration.md b/agent_context/topics/task-programs/configuration.md index 941c80e510..66951705bc 100644 --- a/agent_context/topics/task-programs/configuration.md +++ b/agent_context/topics/task-programs/configuration.md @@ -131,7 +131,7 @@ three typed selections: `environment.component`, `embodiment.component`. The reusable `env.yaml` owns only embodiment-independent Gym values and physical simulation entities. All ordinary deployment component paths resolve from `task..yaml`. -Official `extensions/embodichain_tasks/configs/` references for program, integration and +Official `embodichain/extensions/tasks/configs/` references for program, integration and execution policy use the imported SDK's packaged configs. The shared [Gym component path contract](../env-framework/configuration.md#reusable-gym-deployment-components) defines the owner-directory and CWD-shadow behavior. @@ -245,7 +245,7 @@ normal policy decoders. Contracts, planner selection, tracking and effect assurance remain component-owned. Paths in either form resolve from the runnable deployment. Reuse the base policy and declare tuning in the selector instead of copying a policy for each robot or sampling rate; the supported fields and -example are in the [task package usage](../../../extensions/embodichain_tasks/README.md). +example are in the [task package usage](../../../embodichain/extensions/tasks/README.md). Configured `motion` policies accept optional finite, strictly positive `velocity_limit` and `acceleration_limit` values. Configured Pour action options diff --git a/agent_context/topics/task-programs/task-programs.md b/agent_context/topics/task-programs/task-programs.md index 0472457590..e323aa83b6 100644 --- a/agent_context/topics/task-programs/task-programs.md +++ b/agent_context/topics/task-programs/task-programs.md @@ -165,17 +165,17 @@ not by Task Program or Gym. ## Find a configured deployment Use `embodichain list-task` and the task-local `catalog.yaml` / runnable YAML -under `extensions/embodichain_tasks/configs/tasks/` for current IDs, embodiments +under `embodichain/extensions/tasks/configs/tasks/` for current IDs, embodiments and available deployments. The catalog implementation is `embodichain/cli/_task_catalog.py`; this overview does not maintain a second inventory of IDs or backend-specific defaults. For a minimal projected workflow, start with -[repeated pick/place](../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/README.md). +[repeated pick/place](../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/README.md). For measured handover, inspect the selected deployment and execution policy in -`extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/`. +`embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/`. For fixed real-motion source binding and qualified expansion, use -`extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml`. +`embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml`. It selects three real-source prototypes through verified asset references and the existing Real2Sim recorder owner; the example rebuilds sources from the same templates. Assurance belongs to that policy, not the task name or backend. Read the diff --git a/docker/verify.py b/docker/verify.py index dfa46f5fdc..e8cc74bc3f 100644 --- a/docker/verify.py +++ b/docker/verify.py @@ -269,8 +269,12 @@ def _installed_pytest(provenance: str, arguments: list[str]) -> int: sys.path.insert(0, str(Path.cwd())) installed = distribution("embodichain") roots = { - name: Path(installed.locate_file(name)).resolve() - for name in ("embodichain", "embodichain_tasks", "embodichain_robots") + name: Path(installed.locate_file(name.replace(".", "/"))).resolve() + for name in ( + "embodichain", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + ) } def check_imports() -> dict[str, str]: diff --git a/docs/architecture/curated.json b/docs/architecture/curated.json index 23cce03d11..e91944161b 100644 --- a/docs/architecture/curated.json +++ b/docs/architecture/curated.json @@ -286,7 +286,7 @@ ], "evidence": [ { - "path": "extensions/embodichain_benchmarks/motion_generation/__init__.py", + "path": "embodichain/extensions/benchmarks/motion_generation/__init__.py", "symbol": "", "start_line": 17, "end_line": 21, @@ -585,7 +585,7 @@ ], "evidence": [ { - "path": "extensions/embodichain_tasks/embodichain_tasks/__init__.py", + "path": "embodichain/extensions/tasks/__init__.py", "symbol": "", "start_line": 17, "end_line": 23, @@ -598,7 +598,7 @@ "label": "Supported tasks" } ], - "details": "Official tasks are bundled in the same distribution under the embodichain_tasks import package. Import-backed tasks register during discovery, while supported configuration-defined Task Programs register when their Gym configuration is loaded." + "details": "Official tasks are bundled in the same distribution under the embodichain.extensions.tasks import package. Import-backed tasks register during discovery, while supported configuration-defined Task Programs register when their Gym configuration is loaded." }, { "id": "components", @@ -3397,14 +3397,14 @@ "neural-dynamics" ], "summary": "Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel.", - "details": "embodichain_models.dynamics.nerd owns the concrete model, portable checkpoints, physical representations, HDF5 windows and installable SL recipe. Generic MLP/normalization and supervised orchestration stay in core. The model extension imports neither the showcase nor simulation; collection, historical training and reference research belong to the example.", + "details": "embodichain.extensions.models.dynamics.nerd owns the concrete model, portable checkpoints, physical representations, HDF5 windows and installable SL recipe. Generic MLP/normalization and supervised orchestration stay in core. The model extension imports neither the showcase nor simulation; collection, historical training and reference research belong to the example.", "boundaries": [ "The core does not import concrete model implementations.", "Data/model/reference-asset payloads are external resources; numerical and physical identities remain explicit." ], "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py", + "path": "embodichain/extensions/models/dynamics/nerd/model.py", "symbol": "NeRDModel", "start_line": 201, "end_line": 201, @@ -3488,7 +3488,7 @@ "robot-world-model" ], "summary": "Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay.", - "details": "embodichain_models.dynamics.rwm owns frame-local state increments and SO(3) integration, graph-connected prediction state, autoregressive objectives and fixed-byte-budget replay. Its installable build_rwm_trainer recipe composes these contracts with the shared SL learner and offline trainer. The learning/rwm example owns controlled corpus generation and fitting qualification.", + "details": "embodichain.extensions.models.dynamics.rwm owns frame-local state increments and SO(3) integration, graph-connected prediction state, autoregressive objectives and fixed-byte-budget replay. Its installable build_rwm_trainer recipe composes these contracts with the shared SL learner and offline trainer. The learning/rwm example owns controlled corpus generation and fitting qualification.", "boundaries": [ "The model family imports neither simulation nor example helpers; acquisition and execution remain caller-owned.", "Fixed control period, action semantics and ordered joints bind model and checkpoint identity.", @@ -3496,35 +3496,35 @@ ], "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py", + "path": "embodichain/extensions/models/dynamics/rwm/model.py", "symbol": "RobotWorldModel", "start_line": 73, "end_line": 73, "excerpt": "class RobotWorldModel(nn.Module):" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/predictor.py", + "path": "embodichain/extensions/models/dynamics/rwm/predictor.py", "symbol": "RWMPredictor", "start_line": 31, "end_line": 31, "excerpt": "class RWMPredictor:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/replay.py", + "path": "embodichain/extensions/models/dynamics/rwm/replay.py", "symbol": "TransitionReplay", "start_line": 35, "end_line": 35, "excerpt": "class TransitionReplay:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/supervised.py", + "path": "embodichain/extensions/models/dynamics/rwm/supervised.py", "symbol": "RobotWorldModelObjective", "start_line": 59, "end_line": 59, "excerpt": "class RobotWorldModelObjective:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 39, "end_line": 39, @@ -4208,7 +4208,7 @@ "symbol": "", "start_line": 79, "end_line": 80, - "excerpt": "[project.entry-points.\"embodichain.tasks\"]\nembodichain_tasks = \"embodichain_tasks\"" + "excerpt": "[project.entry-points.\"embodichain.tasks\"]\nofficial_tasks = \"embodichain.extensions.tasks\"" }, { "path": "embodichain/lab/gym/utils/registration.py", @@ -4222,14 +4222,7 @@ "symbol": "discover_task_packages", "start_line": 449, "end_line": 449, - "excerpt": " _import_task_package(ep)" - }, - { - "path": "embodichain/lab/gym/utils/registration.py", - "symbol": "_import_task_package", - "start_line": 400, - "end_line": 402, - "excerpt": " module_name = ep.value\n top_level = module_name.partition(\".\")[0]\n mod = importlib.import_module(module_name)" + "excerpt": " importlib.import_module(ep.value)" } ] }, @@ -5927,7 +5920,7 @@ "symbol": "_run_motion_generation_cli", "start_line": 57, "end_line": 59, - "excerpt": " from embodichain_benchmarks.motion_generation.cli import run_from_args\n\n run_from_args(args)" + "excerpt": " from embodichain.extensions.benchmarks.motion_generation.cli import run_from_args\n\n run_from_args(args)" } ] }, @@ -5941,7 +5934,7 @@ "scope": "BenchmarkRunner._create_simulation.", "evidence": [ { - "path": "extensions/embodichain_benchmarks/motion_generation/runner.py", + "path": "embodichain/extensions/benchmarks/motion_generation/runner.py", "symbol": "BenchmarkRunner._create_simulation", "start_line": 276, "end_line": 286, @@ -5959,7 +5952,7 @@ "scope": "The installable NeRD supervised recipe only; the core does not resolve or import model families eagerly.", "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/nerd/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/nerd/sl_recipe.py", "symbol": "build_supervised_trainer", "start_line": 167, "end_line": 167, @@ -5995,14 +5988,14 @@ "scope": "The installable RWM supervised recipe only; acquisition and simulation are outside this factory, and the core does not import the model family.", "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 108, "end_line": 108, "excerpt": " learner = SupervisedLearner(model, objective, optimizer, max_grad_norm=maximum_norm)" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 138, "end_line": 138, diff --git a/docs/scripts/build_architecture.py b/docs/scripts/build_architecture.py index 7af23ac160..4fe9bdfbe7 100644 --- a/docs/scripts/build_architecture.py +++ b/docs/scripts/build_architecture.py @@ -68,11 +68,6 @@ def _relocate(source: SourceRepository, proof: dict[str, Any], owner: str) -> No def _module_name(path: str) -> str: - path = path.removeprefix("extensions/") - if path.startswith("embodichain_tasks/embodichain_tasks/"): - path = path.removeprefix("embodichain_tasks/") - if path.startswith("embodichain_models/embodichain_models/"): - path = path.removeprefix("embodichain_models/") return path.removesuffix(".py").replace("/", ".").removesuffix(".__init__") diff --git a/docs/scripts/check_api_docs.py b/docs/scripts/check_api_docs.py index 9a6aa97451..93b6d3ac49 100644 --- a/docs/scripts/check_api_docs.py +++ b/docs/scripts/check_api_docs.py @@ -124,29 +124,7 @@ def is_aligned(self) -> bool: return not self.missing -DEFAULT_PACKAGE_ROOTS = ( - PackageRoot("embodichain", REPO_ROOT / "embodichain"), - PackageRoot( - "embodichain_models", - REPO_ROOT / "extensions" / "embodichain_models" / "embodichain_models", - ), - PackageRoot("embodichain_robots", REPO_ROOT / "extensions" / "embodichain_robots"), - PackageRoot( - "embodichain_solvers", - REPO_ROOT / "extensions" / "embodichain_solvers" / "embodichain_solvers", - ), - PackageRoot( - "embodichain_benchmarks", REPO_ROOT / "extensions" / "embodichain_benchmarks" - ), - PackageRoot( - "embodichain_tasks", - REPO_ROOT / "extensions" / "embodichain_tasks" / "embodichain_tasks", - ), - PackageRoot( - "embodichain_tasks.configs", - REPO_ROOT / "extensions" / "embodichain_tasks" / "configs", - ), -) +DEFAULT_PACKAGE_ROOTS = (PackageRoot("embodichain", REPO_ROOT / "embodichain"),) def _module_scope_statements(node: ast.AST) -> Iterator[ast.stmt]: diff --git a/docs/source/api_reference/agibot_g1.rst b/docs/source/api_reference/agibot_g1.rst index 5ff2b71284..77329e91c3 100644 --- a/docs/source/api_reference/agibot_g1.rst +++ b/docs/source/api_reference/agibot_g1.rst @@ -6,21 +6,21 @@ controls. It uses the source-authored mimic and gripper closure relationships on the Default physics backend. See :doc:`../resources/robot/agibot/g1` for preview and local source selection. -.. py:class:: embodichain_robots.AgibotG1Cfg +.. py:class:: embodichain.extensions.robots.AgibotG1Cfg Source-preserving USD robot configuration with torso, head, dual-arm and single-driver gripper control groups. Construct with ``from_dict()`` or resolve catalog ID ``AgibotG1`` to apply the preset defaults. Serial-chain construction is disabled; the preset supplies joint-space control. -.. automethod:: embodichain_robots.AgibotG1Cfg.from_dict +.. automethod:: embodichain.extensions.robots.AgibotG1Cfg.from_dict -.. py:class:: embodichain_robots.agibot.g1.AgibotG1Cfg +.. py:class:: embodichain.extensions.robots.agibot.g1.AgibotG1Cfg - Model namespace for :class:`embodichain_robots.AgibotG1Cfg`. + Model namespace for :class:`embodichain.extensions.robots.AgibotG1Cfg`. -.. py:class:: embodichain_robots.agibot.g1.cfg.AgibotG1Cfg +.. py:class:: embodichain.extensions.robots.agibot.g1.cfg.AgibotG1Cfg - Implementation of :class:`embodichain_robots.AgibotG1Cfg`. + Implementation of :class:`embodichain.extensions.robots.AgibotG1Cfg`. -.. autoclass:: embodichain_robots.agibot.g1.assets.AgibotG1 +.. autoclass:: embodichain.extensions.robots.agibot.g1.assets.AgibotG1 diff --git a/docs/source/api_reference/agibot_g2.rst b/docs/source/api_reference/agibot_g2.rst index 167a1b450d..dfda2d6f46 100644 --- a/docs/source/api_reference/agibot_g2.rst +++ b/docs/source/api_reference/agibot_g2.rst @@ -13,7 +13,7 @@ application configuration. Public configuration -------------------- -.. currentmodule:: embodichain_robots +.. currentmodule:: embodichain.extensions.robots .. autosummary:: @@ -26,7 +26,7 @@ Public configuration Model namespace --------------- -.. currentmodule:: embodichain_robots.agibot.g2 +.. currentmodule:: embodichain.extensions.robots.agibot.g2 .. autosummary:: @@ -38,7 +38,7 @@ Model namespace Configuration implementation ---------------------------- -.. currentmodule:: embodichain_robots.agibot.g2.cfg +.. currentmodule:: embodichain.extensions.robots.agibot.g2.cfg .. autosummary:: @@ -50,7 +50,7 @@ Configuration implementation Official asset cache -------------------- -.. currentmodule:: embodichain_robots.agibot.g2.assets +.. currentmodule:: embodichain.extensions.robots.agibot.g2.assets .. autosummary:: diff --git a/docs/source/api_reference/aloha_mini.rst b/docs/source/api_reference/aloha_mini.rst index e28d1f33c7..607b699ae9 100644 --- a/docs/source/api_reference/aloha_mini.rst +++ b/docs/source/api_reference/aloha_mini.rst @@ -9,7 +9,7 @@ parts, arm and torso solvers, and local serial chains for all five parts. Public import ------------- -.. currentmodule:: embodichain_robots +.. currentmodule:: embodichain.extensions.robots .. py:class:: AlohaMiniCfg @@ -23,9 +23,9 @@ Public import Implementation module --------------------- -.. currentmodule:: embodichain_robots.alohamini.aloha_mini.cfg +.. currentmodule:: embodichain.extensions.robots.alohamini.aloha_mini.cfg .. py:class:: AlohaMiniCfg :no-index: - Implementation of :class:`embodichain_robots.AlohaMiniCfg`. + Implementation of :class:`embodichain.extensions.robots.AlohaMiniCfg`. diff --git a/docs/source/api_reference/benchmarks.rst b/docs/source/api_reference/benchmarks.rst index 1364135e90..18180d86e4 100644 --- a/docs/source/api_reference/benchmarks.rst +++ b/docs/source/api_reference/benchmarks.rst @@ -1,7 +1,7 @@ Motion generation benchmarks ============================ -The bundled ``embodichain_benchmarks.motion_generation`` extension evaluates +The bundled ``embodichain.extensions.benchmarks.motion_generation`` extension evaluates Motion Planning and Atomic Skills suites from another Python project. The benchmark owns case generation, simulation, lifecycle timing, evaluation and artifact persistence. It consumes the simulation, planning and Atomic Skill @@ -13,7 +13,7 @@ Calling from another project .. code-block:: python - from embodichain_benchmarks.motion_generation import ( + from embodichain.extensions.benchmarks.motion_generation import ( PlannerSpecCfg, load_suite, run_benchmark, @@ -55,12 +55,12 @@ can change stochastic solver outputs across schedules despite matching inputs. Install the selected backend and resolve its robot assets as for ordinary EmbodiChain use. The installed command is ``embodichain benchmark motion-generation``; the module form is -``python -m embodichain_benchmarks.motion_generation``. +``python -m embodichain.extensions.benchmarks.motion_generation``. Public entry points ------------------- -.. currentmodule:: embodichain_benchmarks.motion_generation +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation .. autosummary:: @@ -76,17 +76,17 @@ Public entry points prepare_case_manifest resolve_quality_devices -.. autofunction:: embodichain_benchmarks.motion_generation.run_benchmark +.. autofunction:: embodichain.extensions.benchmarks.motion_generation.run_benchmark -.. autofunction:: embodichain_benchmarks.motion_generation.prepare_case_manifest +.. autofunction:: embodichain.extensions.benchmarks.motion_generation.prepare_case_manifest -.. autofunction:: embodichain_benchmarks.motion_generation.load_suite +.. autofunction:: embodichain.extensions.benchmarks.motion_generation.load_suite -.. autofunction:: embodichain_benchmarks.motion_generation.resolve_quality_devices +.. autofunction:: embodichain.extensions.benchmarks.motion_generation.resolve_quality_devices -.. autoclass:: embodichain_benchmarks.motion_generation.BenchmarkRunResult +.. autoclass:: embodichain.extensions.benchmarks.motion_generation.BenchmarkRunResult -.. autoclass:: embodichain_benchmarks.motion_generation.PlannerAdapter +.. autoclass:: embodichain.extensions.benchmarks.motion_generation.PlannerAdapter :members: Implementation reference @@ -100,27 +100,27 @@ the frozen case manifest, resolved suite, environment metadata and aggregate schema are persisted together with each report. -embodichain_benchmarks.motion_generation.aggregation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.aggregation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.aggregation +.. automodule:: embodichain.extensions.benchmarks.motion_generation.aggregation :members: :undoc-members: :exclude-members: aggregate_generalization -.. currentmodule:: embodichain_benchmarks.motion_generation.aggregation +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.aggregation .. autosummary:: aggregate_generalization -embodichain_benchmarks.motion_generation.api -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.api +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.api +.. automodule:: embodichain.extensions.benchmarks.motion_generation.api -.. currentmodule:: embodichain_benchmarks.motion_generation.api +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.api .. autosummary:: @@ -128,91 +128,91 @@ embodichain_benchmarks.motion_generation.api prepare_case_manifest -embodichain_benchmarks.motion_generation.artifacts -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.artifacts +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.artifacts +.. automodule:: embodichain.extensions.benchmarks.motion_generation.artifacts :members: :undoc-members: -embodichain_benchmarks.motion_generation.atomic_skill -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.atomic_skill +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.atomic_skill +.. automodule:: embodichain.extensions.benchmarks.motion_generation.atomic_skill :members: :undoc-members: -embodichain_benchmarks.motion_generation.cli -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.cli +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.cli +.. automodule:: embodichain.extensions.benchmarks.motion_generation.cli :members: :undoc-members: -embodichain_benchmarks.motion_generation.config -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.config +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.config +.. automodule:: embodichain.extensions.benchmarks.motion_generation.config :members: :undoc-members: :exclude-members: load_suite -.. currentmodule:: embodichain_benchmarks.motion_generation.config +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.config .. autosummary:: load_suite -embodichain_benchmarks.motion_generation.contracts -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.contracts +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.contracts +.. automodule:: embodichain.extensions.benchmarks.motion_generation.contracts :members: :undoc-members: -embodichain_benchmarks.motion_generation.embodiments -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.embodiments +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.embodiments +.. automodule:: embodichain.extensions.benchmarks.motion_generation.embodiments :members: :undoc-members: -embodichain_benchmarks.motion_generation.evaluation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.evaluation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.evaluation +.. automodule:: embodichain.extensions.benchmarks.motion_generation.evaluation :members: :undoc-members: -embodichain_benchmarks.motion_generation.generalization -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.generalization +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.generalization +.. automodule:: embodichain.extensions.benchmarks.motion_generation.generalization :members: :undoc-members: -embodichain_benchmarks.motion_generation.limits -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.limits +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.limits +.. automodule:: embodichain.extensions.benchmarks.motion_generation.limits :members: :undoc-members: -embodichain_benchmarks.motion_generation.metrics -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.metrics +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.metrics +.. automodule:: embodichain.extensions.benchmarks.motion_generation.metrics -.. currentmodule:: embodichain_benchmarks.motion_generation.metrics +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.metrics .. autosummary:: @@ -225,31 +225,31 @@ embodichain_benchmarks.motion_generation.metrics timed_call -embodichain_benchmarks.motion_generation.metrics.performance -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.metrics.performance +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.metrics.performance +.. automodule:: embodichain.extensions.benchmarks.motion_generation.metrics.performance :members: :undoc-members: -embodichain_benchmarks.motion_generation.metrics.stats -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.metrics.stats +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.metrics.stats +.. automodule:: embodichain.extensions.benchmarks.motion_generation.metrics.stats :members: :undoc-members: -embodichain_benchmarks.motion_generation.metrics.trajectory -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.metrics.trajectory +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.metrics.trajectory +.. automodule:: embodichain.extensions.benchmarks.motion_generation.metrics.trajectory :members: :undoc-members: :exclude-members: resolve_dynamic_limit, resolve_velocity_limits -.. currentmodule:: embodichain_benchmarks.motion_generation.metrics.trajectory +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.metrics.trajectory .. autosummary:: @@ -257,32 +257,32 @@ embodichain_benchmarks.motion_generation.metrics.trajectory resolve_velocity_limits -embodichain_benchmarks.motion_generation.models -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.models +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.models +.. automodule:: embodichain.extensions.benchmarks.motion_generation.models :members: :undoc-members: -embodichain_benchmarks.motion_generation.parallel -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.parallel +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Validate explicit visible CUDA devices before creating quality workers or a simulator. The package-level ``resolve_quality_devices`` export is the public entry point for external benchmark hosts. -.. automodule:: embodichain_benchmarks.motion_generation.parallel +.. automodule:: embodichain.extensions.benchmarks.motion_generation.parallel :members: :undoc-members: -embodichain_benchmarks.motion_generation.planners -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners -.. currentmodule:: embodichain_benchmarks.motion_generation.planners +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.planners .. autosummary:: @@ -294,75 +294,75 @@ embodichain_benchmarks.motion_generation.planners ToppraAdapter -embodichain_benchmarks.motion_generation.planners.base -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners.base +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners.base +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners.base :members: :undoc-members: :exclude-members: PlannerAdapter -.. currentmodule:: embodichain_benchmarks.motion_generation.planners.base +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.planners.base .. autosummary:: PlannerAdapter -embodichain_benchmarks.motion_generation.planners.curobo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners.curobo +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners.curobo +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners.curobo :members: :undoc-members: -embodichain_benchmarks.motion_generation.planners.ik_interpolate -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners.ik_interpolate +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners.ik_interpolate +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners.ik_interpolate :members: :undoc-members: -embodichain_benchmarks.motion_generation.planners.nmg_onnx -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners.nmg_onnx +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx :members: :undoc-members: -embodichain_benchmarks.motion_generation.planners.toppra -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.planners.toppra +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.planners.toppra +.. automodule:: embodichain.extensions.benchmarks.motion_generation.planners.toppra :members: :undoc-members: -embodichain_benchmarks.motion_generation.registry -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.registry +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.registry +.. automodule:: embodichain.extensions.benchmarks.motion_generation.registry :members: :undoc-members: -embodichain_benchmarks.motion_generation.reporting -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.reporting +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.reporting +.. automodule:: embodichain.extensions.benchmarks.motion_generation.reporting :members: :undoc-members: -embodichain_benchmarks.motion_generation.robots -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.robots +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.robots +.. automodule:: embodichain.extensions.benchmarks.motion_generation.robots -.. currentmodule:: embodichain_benchmarks.motion_generation.robots +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.robots .. autosummary:: @@ -375,59 +375,59 @@ embodichain_benchmarks.motion_generation.robots UR5Provider -embodichain_benchmarks.motion_generation.robots.base -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.robots.base +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.robots.base +.. automodule:: embodichain.extensions.benchmarks.motion_generation.robots.base :members: :undoc-members: -embodichain_benchmarks.motion_generation.robots.dual_arm -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.robots.dual_arm +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.robots.dual_arm +.. automodule:: embodichain.extensions.benchmarks.motion_generation.robots.dual_arm :members: :undoc-members: -embodichain_benchmarks.motion_generation.robots.franka -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.robots.franka +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.robots.franka +.. automodule:: embodichain.extensions.benchmarks.motion_generation.robots.franka :members: :undoc-members: -embodichain_benchmarks.motion_generation.robots.ur5 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.robots.ur5 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.robots.ur5 +.. automodule:: embodichain.extensions.benchmarks.motion_generation.robots.ur5 :members: :undoc-members: -embodichain_benchmarks.motion_generation.runner -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.runner +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.runner +.. automodule:: embodichain.extensions.benchmarks.motion_generation.runner :members: :undoc-members: :exclude-members: BenchmarkRunResult -.. currentmodule:: embodichain_benchmarks.motion_generation.runner +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.runner .. autosummary:: BenchmarkRunResult -embodichain_benchmarks.motion_generation.scenarios -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios -.. currentmodule:: embodichain_benchmarks.motion_generation.scenarios +.. currentmodule:: embodichain.extensions.benchmarks.motion_generation.scenarios .. autosummary:: @@ -445,106 +445,106 @@ embodichain_benchmarks.motion_generation.scenarios ScenarioProvider -embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_contact_cases -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_contact_cases +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_contact_cases +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_contact_cases :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_evaluation -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_evaluation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_evaluation +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_evaluation :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_grasps -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_grasps +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_manipulation_cases -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_manipulation_cases +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_manipulation_cases +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_manipulation_cases :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_motion_cases -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_motion_cases +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_motion_cases +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_motion_cases :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_objects -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_objects +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_objects +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_objects :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_policy -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_policy +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_replay -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_replay +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_replay +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_replay :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.atomic_skill -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.atomic_skill +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.base -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.base +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.base +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.base :members: :undoc-members: -embodichain_benchmarks.motion_generation.scenarios.free_space -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.scenarios.free_space +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.scenarios.free_space +.. automodule:: embodichain.extensions.benchmarks.motion_generation.scenarios.free_space :members: :undoc-members: -embodichain_benchmarks.motion_generation.video -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.benchmarks.motion_generation.video +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. automodule:: embodichain_benchmarks.motion_generation.video +.. automodule:: embodichain.extensions.benchmarks.motion_generation.video :members: :undoc-members: diff --git a/docs/source/api_reference/data/eef_assets.rst b/docs/source/api_reference/data/eef_assets.rst index 3fb6f8f183..8c852ff6e3 100644 --- a/docs/source/api_reference/data/eef_assets.rst +++ b/docs/source/api_reference/data/eef_assets.rst @@ -2,7 +2,7 @@ End-effector assets =================== Concrete download classes are owned by manufacturer/model modules in the -bundled ``embodichain_robots`` package. The former core EEF module and +bundled ``embodichain.extensions.robots`` package. The former core EEF module and aggregate class exports have been removed. Asset IDs, URL/checksum identities and cache prefixes remain stable. See :doc:`/resources/robot/end_effectors` for the import migration table, provenance boundaries and rendered models. @@ -12,10 +12,10 @@ Construct a dataset with optional ``data_root`` to select a cache, or use lookup alone does not construct datasets or download files. A download class provides an asset; it does not imply a standalone robot or grasping controller. -embodichain_robots.dh_robotics.pgc_140_50.assets ------------------------------------------------- +embodichain.extensions.robots.dh_robotics.pgc_140_50.assets +----------------------------------------------------------- -.. currentmodule:: embodichain_robots.dh_robotics.pgc_140_50.assets +.. currentmodule:: embodichain.extensions.robots.dh_robotics.pgc_140_50.assets .. autosummary:: :nosignatures: @@ -29,10 +29,10 @@ embodichain_robots.dh_robotics.pgc_140_50.assets .. autoclass:: DH_PGC_140_50_M :members: -embodichain_robots.dh_robotics.pgi_140_80.assets ------------------------------------------------- +embodichain.extensions.robots.dh_robotics.pgi_140_80.assets +----------------------------------------------------------- -.. currentmodule:: embodichain_robots.dh_robotics.pgi_140_80.assets +.. currentmodule:: embodichain.extensions.robots.dh_robotics.pgi_140_80.assets .. autosummary:: :nosignatures: @@ -42,10 +42,10 @@ embodichain_robots.dh_robotics.pgi_140_80.assets .. autoclass:: DH_PGI_140_80 :members: -embodichain_robots.dh_robotics.ag95.assets ------------------------------------------- +embodichain.extensions.robots.dh_robotics.ag95.assets +----------------------------------------------------- -.. currentmodule:: embodichain_robots.dh_robotics.ag95.assets +.. currentmodule:: embodichain.extensions.robots.dh_robotics.ag95.assets .. autosummary:: :nosignatures: @@ -55,10 +55,10 @@ embodichain_robots.dh_robotics.ag95.assets .. autoclass:: DH_AG95 :members: -embodichain_robots.changingtek.ctm2f110.assets ----------------------------------------------- +embodichain.extensions.robots.changingtek.ctm2f110.assets +--------------------------------------------------------- -.. currentmodule:: embodichain_robots.changingtek.ctm2f110.assets +.. currentmodule:: embodichain.extensions.robots.changingtek.ctm2f110.assets .. autosummary:: :nosignatures: @@ -68,10 +68,10 @@ embodichain_robots.changingtek.ctm2f110.assets .. autoclass:: ZH_CTM2F110 :members: -embodichain_robots.brainco.revo1.assets ---------------------------------------- +embodichain.extensions.robots.brainco.revo1.assets +-------------------------------------------------- -.. currentmodule:: embodichain_robots.brainco.revo1.assets +.. currentmodule:: embodichain.extensions.robots.brainco.revo1.assets .. autosummary:: :nosignatures: @@ -81,10 +81,10 @@ embodichain_robots.brainco.revo1.assets .. autoclass:: BrainCoHandRevo1 :members: -embodichain_robots.inspire.hand.assets --------------------------------------- +embodichain.extensions.robots.inspire.hand.assets +------------------------------------------------- -.. currentmodule:: embodichain_robots.inspire.hand.assets +.. currentmodule:: embodichain.extensions.robots.inspire.hand.assets .. autosummary:: :nosignatures: @@ -94,10 +94,10 @@ embodichain_robots.inspire.hand.assets .. autoclass:: InspireHand :members: -embodichain_robots.robotiq.assets ---------------------------------- +embodichain.extensions.robots.robotiq.assets +-------------------------------------------- -.. currentmodule:: embodichain_robots.robotiq.assets +.. currentmodule:: embodichain.extensions.robots.robotiq.assets .. autosummary:: :nosignatures: @@ -107,10 +107,10 @@ embodichain_robots.robotiq.assets .. autoclass:: Robotiq :members: -embodichain_robots.robotiq.robotiq_2f85.assets ----------------------------------------------- +embodichain.extensions.robots.robotiq.robotiq_2f85.assets +--------------------------------------------------------- -.. currentmodule:: embodichain_robots.robotiq.robotiq_2f85.assets +.. currentmodule:: embodichain.extensions.robots.robotiq.robotiq_2f85.assets .. autosummary:: :nosignatures: @@ -120,10 +120,10 @@ embodichain_robots.robotiq.robotiq_2f85.assets .. autoclass:: Robotiq2F85 :members: -embodichain_robots.wheeltec.fa2f.assets ---------------------------------------- +embodichain.extensions.robots.wheeltec.fa2f.assets +-------------------------------------------------- -.. currentmodule:: embodichain_robots.wheeltec.fa2f.assets +.. currentmodule:: embodichain.extensions.robots.wheeltec.fa2f.assets .. autosummary:: :nosignatures: @@ -133,14 +133,14 @@ embodichain_robots.wheeltec.fa2f.assets .. autoclass:: WheelTecFA2F :members: -embodichain_robots.agilex.agx_gripper.assets --------------------------------------------- +embodichain.extensions.robots.agilex.agx_gripper.assets +------------------------------------------------------- Pinned AGX two-finger gripper with a single opening command in meters and two source mimic joints. The asset provides a portable URDF and source meshes for explicit mounting in a robot embodiment. -.. currentmodule:: embodichain_robots.agilex.agx_gripper.assets +.. currentmodule:: embodichain.extensions.robots.agilex.agx_gripper.assets .. autosummary:: :nosignatures: @@ -150,10 +150,10 @@ meshes for explicit mounting in a robot embodiment. .. autoclass:: AgxGripper :members: -embodichain_robots.agilex.pika.assets -------------------------------------- +embodichain.extensions.robots.agilex.pika.assets +------------------------------------------------ -.. currentmodule:: embodichain_robots.agilex.pika.assets +.. currentmodule:: embodichain.extensions.robots.agilex.pika.assets .. autosummary:: :nosignatures: @@ -163,15 +163,15 @@ embodichain_robots.agilex.pika.assets .. autoclass:: PikaGripper :members: -embodichain_robots.sharpa.wave.assets -------------------------------------- +embodichain.extensions.robots.sharpa.wave.assets +------------------------------------------------ Pinned official left/right Sharpa Wave 01 descriptions and meshes. The asset includes 22 active joints per hand, upstream MJCF, licensing and a source manifest. It supplies model resources without registering a robot preset, tactile runtime or manipulation policy. -.. currentmodule:: embodichain_robots.sharpa.wave.assets +.. currentmodule:: embodichain.extensions.robots.sharpa.wave.assets .. autosummary:: :nosignatures: @@ -182,15 +182,15 @@ robot preset, tactile runtime or manipulation policy. :members: -embodichain_robots.wuji.hand.assets ------------------------------------ +embodichain.extensions.robots.wuji.hand.assets +---------------------------------------------- Pinned official left/right Wuji Hand descriptions and meshes. The asset includes 20 active joints per hand, upstream MJCF, licensing and a source manifest. It supplies model resources without registering a robot preset, tactile runtime or manipulation policy. -.. currentmodule:: embodichain_robots.wuji.hand.assets +.. currentmodule:: embodichain.extensions.robots.wuji.hand.assets .. autosummary:: :nosignatures: diff --git a/docs/source/api_reference/embodichain/embodichain.lab.sim.robots.rst b/docs/source/api_reference/embodichain/embodichain.lab.sim.robots.rst index 2ab8c44478..f9a5b335ca 100644 --- a/docs/source/api_reference/embodichain/embodichain.lab.sim.robots.rst +++ b/docs/source/api_reference/embodichain/embodichain.lab.sim.robots.rst @@ -8,7 +8,7 @@ Overview Generic dual-arm composition built from compatible single-arm configurations. :func:`build_dual_arm_cfg` assembles two single-arm configs into a synchronized -dual-arm robot. Concrete presets are imported from ``embodichain_robots``; +dual-arm robot. Concrete presets are imported from ``embodichain.extensions.robots``; see :doc:`/api_reference/robot_catalogs` for those configuration classes and :doc:`/guides/robot_catalog` for discovery and variant selection. diff --git a/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst b/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst index 123598165c..9adb829d58 100644 --- a/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst +++ b/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst @@ -67,4 +67,4 @@ unchanged. maintains counters and records metrics. Online model-learning workflows can call it between supervised updates. ``train()`` also manages periodic evaluation and checkpoints. The PointMass configuration is -``extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml``. +``embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml``. diff --git a/docs/source/api_reference/index.rst b/docs/source/api_reference/index.rst index 192155d230..559e92ab72 100644 --- a/docs/source/api_reference/index.rst +++ b/docs/source/api_reference/index.rst @@ -44,7 +44,7 @@ The core ``embodichain`` framework includes these top-level packages: Shared trainable components, supervised updates and offline orchestration, plus on-policy RL algorithms (PPO/GRPO), rollout buffers, collectors and RL policy builders. Concrete model families live in the bundled - ``embodichain_models`` library. + ``embodichain.extensions.models`` library. ``utils`` Shared utilities: the ``@configclass`` decorator, logging, math/tensor diff --git a/docs/source/api_reference/locomotion_robots.rst b/docs/source/api_reference/locomotion_robots.rst index 5aa4f45f13..ecd282d6ad 100644 --- a/docs/source/api_reference/locomotion_robots.rst +++ b/docs/source/api_reference/locomotion_robots.rst @@ -6,7 +6,7 @@ These presets construct the bundled locomotion models through the ordinary standing pose, the ``locomotion`` control group and the existing simulation PD drive defaults. They do not provide limb IK solvers or external actuator networks. -.. currentmodule:: embodichain_robots +.. currentmodule:: embodichain.extensions.robots .. autosummary:: @@ -54,7 +54,7 @@ the description's standing positions use its explicit joint-name order. Task-specific action scales, observations, rewards and fall rules remain in the task package. Explicit deployment drive overrides take precedence. -.. currentmodule:: embodichain_robots.locomotion_profiles +.. currentmodule:: embodichain.extensions.robots.locomotion_profiles .. autosummary:: @@ -67,41 +67,41 @@ Implementation module imports The same preset classes are available through their lazy vendor/model packages: -.. currentmodule:: embodichain_robots.anybotics.anymal_c +.. currentmodule:: embodichain.extensions.robots.anybotics.anymal_c .. py:class:: ANYmalCCfg - Defining-module import of :class:`embodichain_robots.ANYmalCCfg`. + Defining-module import of :class:`embodichain.extensions.robots.ANYmalCCfg`. -.. currentmodule:: embodichain_robots.pollen_robotics.microduck +.. currentmodule:: embodichain.extensions.robots.pollen_robotics.microduck .. py:class:: MicroDuckCfg - Defining-module import of :class:`embodichain_robots.MicroDuckCfg`. + Defining-module import of :class:`embodichain.extensions.robots.MicroDuckCfg`. -.. currentmodule:: embodichain_robots.unitree.g1 +.. currentmodule:: embodichain.extensions.robots.unitree.g1 .. py:class:: UnitreeG1Cfg - Defining-module import of :class:`embodichain_robots.UnitreeG1Cfg`. + Defining-module import of :class:`embodichain.extensions.robots.UnitreeG1Cfg`. -.. currentmodule:: embodichain_robots.unitree.go1 +.. currentmodule:: embodichain.extensions.robots.unitree.go1 .. py:class:: UnitreeGo1Cfg - Defining-module import of :class:`embodichain_robots.UnitreeGo1Cfg`. + Defining-module import of :class:`embodichain.extensions.robots.UnitreeGo1Cfg`. -.. currentmodule:: embodichain_robots.unitree.go2 +.. currentmodule:: embodichain.extensions.robots.unitree.go2 .. py:class:: UnitreeGo2Cfg - Defining-module import of :class:`embodichain_robots.UnitreeGo2Cfg`. + Defining-module import of :class:`embodichain.extensions.robots.UnitreeGo2Cfg`. -.. currentmodule:: embodichain_robots.unitree.h1_2 +.. currentmodule:: embodichain.extensions.robots.unitree.h1_2 .. py:class:: UnitreeH12Cfg - Defining-module import of :class:`embodichain_robots.UnitreeH12Cfg`. + Defining-module import of :class:`embodichain.extensions.robots.UnitreeH12Cfg`. Configuration implementations ----------------------------- @@ -109,41 +109,41 @@ Configuration implementations Each model package keeps its configuration implementation beside its model profile and asset definition. Package-root class imports remain supported. -.. currentmodule:: embodichain_robots.unitree.go1.cfg +.. currentmodule:: embodichain.extensions.robots.unitree.go1.cfg .. py:class:: UnitreeGo1Cfg - Configuration implementation exported by :class:`embodichain_robots.unitree.go1.UnitreeGo1Cfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.unitree.go1.UnitreeGo1Cfg`. -.. currentmodule:: embodichain_robots.unitree.go2.cfg +.. currentmodule:: embodichain.extensions.robots.unitree.go2.cfg .. py:class:: UnitreeGo2Cfg - Configuration implementation exported by :class:`embodichain_robots.unitree.go2.UnitreeGo2Cfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.unitree.go2.UnitreeGo2Cfg`. -.. currentmodule:: embodichain_robots.unitree.g1.cfg +.. currentmodule:: embodichain.extensions.robots.unitree.g1.cfg .. py:class:: UnitreeG1Cfg - Configuration implementation exported by :class:`embodichain_robots.unitree.g1.UnitreeG1Cfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.unitree.g1.UnitreeG1Cfg`. -.. currentmodule:: embodichain_robots.unitree.h1_2.cfg +.. currentmodule:: embodichain.extensions.robots.unitree.h1_2.cfg .. py:class:: UnitreeH12Cfg - Configuration implementation exported by :class:`embodichain_robots.unitree.h1_2.UnitreeH12Cfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.unitree.h1_2.UnitreeH12Cfg`. -.. currentmodule:: embodichain_robots.anybotics.anymal_c.cfg +.. currentmodule:: embodichain.extensions.robots.anybotics.anymal_c.cfg .. py:class:: ANYmalCCfg - Configuration implementation exported by :class:`embodichain_robots.anybotics.anymal_c.ANYmalCCfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.anybotics.anymal_c.ANYmalCCfg`. -.. currentmodule:: embodichain_robots.pollen_robotics.microduck.cfg +.. currentmodule:: embodichain.extensions.robots.pollen_robotics.microduck.cfg .. py:class:: MicroDuckCfg - Configuration implementation exported by :class:`embodichain_robots.pollen_robotics.microduck.MicroDuckCfg`. + Configuration implementation exported by :class:`embodichain.extensions.robots.pollen_robotics.microduck.MicroDuckCfg`. Model-owned assets ------------------ @@ -152,14 +152,14 @@ These archive definitions use the shared core downloader and preserve the existing asset IDs, checksums and cache prefixes. The legacy locomotion asset namespace forwards to these same classes. -.. autoclass:: embodichain_robots.unitree.go1.assets.UnitreeGo1Locomotion +.. autoclass:: embodichain.extensions.robots.unitree.go1.assets.UnitreeGo1Locomotion -.. autoclass:: embodichain_robots.unitree.go2.assets.UnitreeGo2Locomotion +.. autoclass:: embodichain.extensions.robots.unitree.go2.assets.UnitreeGo2Locomotion -.. autoclass:: embodichain_robots.unitree.g1.assets.UnitreeG1Locomotion +.. autoclass:: embodichain.extensions.robots.unitree.g1.assets.UnitreeG1Locomotion -.. autoclass:: embodichain_robots.unitree.h1_2.assets.UnitreeH1_2Locomotion +.. autoclass:: embodichain.extensions.robots.unitree.h1_2.assets.UnitreeH1_2Locomotion -.. autoclass:: embodichain_robots.anybotics.anymal_c.assets.ANYmalCLocomotion +.. autoclass:: embodichain.extensions.robots.anybotics.anymal_c.assets.ANYmalCLocomotion -.. autoclass:: embodichain_robots.pollen_robotics.microduck.assets.MicroDuckLocomotion +.. autoclass:: embodichain.extensions.robots.pollen_robotics.microduck.assets.MicroDuckLocomotion diff --git a/docs/source/api_reference/locomotion_tasks.rst b/docs/source/api_reference/locomotion_tasks.rst index d08b461814..2467b775e1 100644 --- a/docs/source/api_reference/locomotion_tasks.rst +++ b/docs/source/api_reference/locomotion_tasks.rst @@ -13,12 +13,12 @@ EmbodiChain manager components configured by these tasks. .. autosummary:: - embodichain_tasks.classic_control.humanoid.HumanoidRunEnv + embodichain.extensions.tasks.classic_control.humanoid.HumanoidRunEnv embodichain.lab.gym.envs.managers.actions.DefaultJointPositionAction embodichain.lab.gym.envs.managers.randomization.physics.push_articulation_by_setting_velocity - embodichain_tasks.locomotion.managers.velocity_locomotion_observation - embodichain_tasks.locomotion.managers.velocity_locomotion_reward - embodichain_tasks.locomotion.managers.velocity_locomotion_total_reward + embodichain.extensions.tasks.locomotion.managers.velocity_locomotion_observation + embodichain.extensions.tasks.locomotion.managers.velocity_locomotion_reward + embodichain.extensions.tasks.locomotion.managers.velocity_locomotion_total_reward Robot configuration loaders --------------------------- @@ -29,128 +29,128 @@ action scale, observation dimensions and control timing. .. autosummary:: - embodichain_tasks.locomotion.velocity.contracts.anymal_c.ANYmalCVelocityConfig - embodichain_tasks.locomotion.velocity.contracts.anymal_c.load_config - embodichain_tasks.locomotion.velocity.contracts.g1.G1VelocityConfig - embodichain_tasks.locomotion.velocity.contracts.g1.load_config - embodichain_tasks.locomotion.velocity.contracts.go1.Go1VelocityConfig - embodichain_tasks.locomotion.velocity.contracts.go1.load_config - embodichain_tasks.locomotion.velocity.contracts.go2.Go2VelocityConfig - embodichain_tasks.locomotion.velocity.contracts.go2.load_config - embodichain_tasks.locomotion.velocity.contracts.h1_2.H12VelocityConfig - embodichain_tasks.locomotion.velocity.contracts.h1_2.load_config - embodichain_tasks.locomotion.velocity.contracts.microduck.MicroDuckVelocityConfig - embodichain_tasks.locomotion.velocity.contracts.microduck.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.ANYmalCVelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.g1.G1VelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.g1.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.go1.Go1VelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.go1.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.go2.Go2VelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.go2.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2.H12VelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2.load_config + embodichain.extensions.tasks.locomotion.velocity.contracts.microduck.MicroDuckVelocityConfig + embodichain.extensions.tasks.locomotion.velocity.contracts.microduck.load_config Implementation reference ------------------------ -.. automodule:: embodichain_tasks.locomotion.managers.observations +.. automodule:: embodichain.extensions.tasks.locomotion.managers.observations :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.managers.rewards +.. automodule:: embodichain.extensions.tasks.locomotion.managers.rewards :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.anymal_c_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.anymal_c_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.anymal_c.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.anymal_c.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.g1.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.g1.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.g1.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.g1.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.go1.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.go1.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.go1.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.go1.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.go2.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.go2.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.go2.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.go2.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.h1_2.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.h1_2.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.microduck.config +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.microduck.config :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.contracts.microduck.mdp +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.contracts.microduck.mdp :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.g1_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.g1_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.go1_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.go1_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.go2_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.go2_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.h1_2_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.h1_2_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.locomotion.velocity.microduck_flat +.. automodule:: embodichain.extensions.tasks.locomotion.velocity.microduck_flat :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.classic_control.humanoid.humanoid_run +.. automodule:: embodichain.extensions.tasks.classic_control.humanoid.humanoid_run :members: :undoc-members: :show-inheritance: -.. automodule:: embodichain_tasks.classic_control.humanoid.mdp +.. automodule:: embodichain.extensions.tasks.classic_control.humanoid.mdp :members: :undoc-members: :show-inheritance: diff --git a/docs/source/api_reference/model_catalogs.rst b/docs/source/api_reference/model_catalogs.rst index 626acffcc1..3eaa4dc12b 100644 --- a/docs/source/api_reference/model_catalogs.rst +++ b/docs/source/api_reference/model_catalogs.rst @@ -1,7 +1,7 @@ Official model library ====================== -The main ``embodichain`` distribution bundles ``embodichain_models`` with the +The main ``embodichain`` distribution bundles ``embodichain.extensions.models`` with the same release version and dependencies. This package owns concrete model families, their physical representations, model-specific data adapters and supervised recipes. General MLPs and feature normalization remain in @@ -16,13 +16,13 @@ generation and original-repository comparison runners belong to the NeRD public entry points ------------------------- -``embodichain_models.dynamics.nerd`` lazily exposes the causal network, its +``embodichain.extensions.models.dynamics.nerd`` lazily exposes the causal network, its physical codec, portable checkpoints and shared-SL integration. Inputs are named history tensors; predictions are physical state-increment targets. Model evaluation retains input gradients. Frozen training statistics travel with the network as buffers. -.. currentmodule:: embodichain_models.dynamics.nerd +.. currentmodule:: embodichain.extensions.models.dynamics.nerd .. autosummary:: @@ -79,13 +79,13 @@ imports a simulator. State and history are explicit and treated as immutable. Learning environments own reset and TBPTT boundaries. Offline supervised objectives may continue using measured contact features. -.. currentmodule:: embodichain_models.dynamics.nerd.geometry +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.geometry .. autosummary:: NeRDGeometry -.. currentmodule:: embodichain_models.dynamics.nerd.transition +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.transition .. autosummary:: @@ -107,7 +107,7 @@ does not construct this solver. Support remains limited to the recorded Cartpole/Ant physical domains, without general contact-force reports or external wrenches. -.. currentmodule:: embodichain_solvers.physics.nerd.provider +.. currentmodule:: embodichain.extensions.solvers.physics.nerd.provider .. autosummary:: @@ -127,7 +127,7 @@ position for each row. Causal attention preserves valid prefix outputs under right padding; the objective owns the padded loss mask. Feature conversion follows the network's floating dtype without detaching input gradients. -.. currentmodule:: embodichain_models.dynamics.nerd.model +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.model .. autosummary:: @@ -152,7 +152,7 @@ floating precision and returns an evaluation-mode model. Legacy Python-object conversion requires explicit trust and accepts the supported official Transformer architecture. -.. currentmodule:: embodichain_models.dynamics.nerd.checkpoint +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.checkpoint .. autosummary:: @@ -175,7 +175,7 @@ frame. Quaternion helpers use xyzw ordering. Contact features use fixed plane slots; history append and reset return new tensors while retaining gradients through unaffected values. -.. currentmodule:: embodichain_models.dynamics.nerd.codec +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.codec .. autosummary:: @@ -211,7 +211,7 @@ and split boundaries; optional startup windows carry right-padding masks. Readers bound open shard handles and offer an explicitly budgeted resident cache. Operational generation progress is excluded from the data fingerprint. -.. currentmodule:: embodichain_models.dynamics.nerd.data +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.data .. autosummary:: @@ -242,7 +242,7 @@ valid overlapping-window occurrence; artifacts bind the dataset fingerprint. The normalized MSE uses frozen target variance. Offline evaluation reports valid-position prediction and decoded state errors without selecting on test. -.. currentmodule:: embodichain_models.dynamics.nerd.integration +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.integration .. autosummary:: @@ -273,7 +273,7 @@ The adapter preserves the raw reader's sampling contract when creating a state-increment loss and the number of valid positions used for aggregation. Computing the loss does not update normalization statistics. -.. currentmodule:: embodichain_models.dynamics.nerd.supervised +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.supervised .. autosummary:: @@ -295,11 +295,11 @@ the common SL trainer. Its checkpoints use the SL format; historical NeRD training checkpoints remain owned by the showcase's historical trainer. Use the installable factory path -``embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer`` in an +``embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`` in an ``embodichain train-sl`` configuration. It is available independently of the working directory and example-runner bootstrap. -.. currentmodule:: embodichain_models.dynamics.nerd.sl_recipe +.. currentmodule:: embodichain.extensions.models.dynamics.nerd.sl_recipe .. autosummary:: @@ -334,18 +334,18 @@ the complete native quickstart, standalone call, NPZ/frame contract, operator installation/preflight and measured execution record. Frozen inference does not establish a learning-env or functional-gradient contract. -.. autoclass:: embodichain_models.dynamics.worldparticle.WorldParticleModel +.. autoclass:: embodichain.extensions.models.dynamics.worldparticle.WorldParticleModel :noindex: -.. autofunction:: embodichain_models.dynamics.worldparticle.load_model +.. autofunction:: embodichain.extensions.models.dynamics.worldparticle.load_model :noindex: -.. autoclass:: embodichain_models.dynamics.worldparticle.model.WorldParticleModel +.. autoclass:: embodichain.extensions.models.dynamics.worldparticle.model.WorldParticleModel :noindex: -.. autofunction:: embodichain_models.dynamics.worldparticle.model.load_model +.. autofunction:: embodichain.extensions.models.dynamics.worldparticle.model.load_model :noindex: -.. autofunction:: embodichain_models.dynamics.worldparticle.data.load_sample +.. autofunction:: embodichain.extensions.models.dynamics.worldparticle.data.load_sample -.. autoclass:: embodichain_solvers.physics.worldparticle.provider.WorldParticleProvider +.. autoclass:: embodichain.extensions.solvers.physics.worldparticle.provider.WorldParticleProvider diff --git a/docs/source/api_reference/model_rigidformer.rst b/docs/source/api_reference/model_rigidformer.rst index 6176d85b8d..7020d33798 100644 --- a/docs/source/api_reference/model_rigidformer.rst +++ b/docs/source/api_reference/model_rigidformer.rst @@ -20,7 +20,7 @@ the caller's module modes and does not retain a gradient graph. Public model family ------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer .. autosummary:: @@ -58,7 +58,7 @@ Public model family Architecture and geometry contract ---------------------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.model +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.model .. autosummary:: @@ -76,7 +76,7 @@ Architecture and geometry contract Official weights and native SL export ------------------------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.checkpoint +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.checkpoint .. autosummary:: @@ -90,7 +90,7 @@ Official weights and native SL export Prepared packed scenes ---------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.data +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.data .. autosummary:: @@ -102,7 +102,7 @@ Prepared packed scenes Shifted supervision and anchor losses ------------------------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.supervised +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.supervised .. autosummary:: @@ -117,7 +117,7 @@ Shifted supervision and anchor losses Recoverable EMA state --------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.ema +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.ema .. autosummary:: @@ -129,7 +129,7 @@ Recoverable EMA state Shared SL training recipe ------------------------- -.. currentmodule:: embodichain_models.dynamics.rigidformer.sl_recipe +.. currentmodule:: embodichain.extensions.models.dynamics.rigidformer.sl_recipe .. autosummary:: diff --git a/docs/source/api_reference/public_api.rst b/docs/source/api_reference/public_api.rst index 4fc4219df0..5e0a6bc7b3 100644 --- a/docs/source/api_reference/public_api.rst +++ b/docs/source/api_reference/public_api.rst @@ -4769,128 +4769,128 @@ embodichain.toolkits.urdf_assembly.urdf_assembly_manager URDFAssemblyManager -embodichain_tasks.classic_control.cart_pole --------------------------------------------- +embodichain.extensions.tasks.classic_control.cart_pole +------------------------------------------------------ Cart-pole environment registration under the task-first import path. -.. currentmodule:: embodichain_tasks.classic_control.cart_pole +.. currentmodule:: embodichain.extensions.tasks.classic_control.cart_pole .. autosummary:: CartPoleEnv -embodichain_tasks.classic_control.point_mass ---------------------------------------------- +embodichain.extensions.tasks.classic_control.point_mass +------------------------------------------------------- Differentiable lightweight point-mass task and learning-environment registration. -.. currentmodule:: embodichain_tasks.classic_control.point_mass +.. currentmodule:: embodichain.extensions.tasks.classic_control.point_mass .. autosummary:: PointMassEnv -embodichain_tasks.configs -------------------------- +embodichain.extensions.tasks.configs +------------------------------------ -.. currentmodule:: embodichain_tasks.configs +.. currentmodule:: embodichain.extensions.tasks.configs .. autosummary:: get_config_path -embodichain_tasks.locomotion.managers.actions ----------------------------------------------- +embodichain.extensions.tasks.locomotion.managers.actions +-------------------------------------------------------- The reference position action combines a policy output with the next motion frame using the task's per-joint reference weights, then applies encoder bias. -.. automodule:: embodichain_tasks.locomotion.managers.actions +.. automodule:: embodichain.extensions.tasks.locomotion.managers.actions :members: -embodichain_tasks.locomotion.tracking.g1_motion ------------------------------------------------ +embodichain.extensions.tasks.locomotion.tracking.g1_motion +---------------------------------------------------------- The G1 motion task connects reference data and differentiable tracking calculations to the simulator Gym loop. It owns frame progress, history, reference-state resets and terminal snapshots before automatic row resets. -.. automodule:: embodichain_tasks.locomotion.tracking.g1_motion +.. automodule:: embodichain.extensions.tasks.locomotion.tracking.g1_motion :members: -embodichain_tasks.manipulation.push_cube ----------------------------------------- +embodichain.extensions.tasks.manipulation.push_cube +--------------------------------------------------- -.. currentmodule:: embodichain_tasks.manipulation.push_cube +.. currentmodule:: embodichain.extensions.tasks.manipulation.push_cube .. autosummary:: PushCubeEnv -embodichain_tasks.manipulation.repeated_pick_place --------------------------------------------------- +embodichain.extensions.tasks.manipulation.repeated_pick_place +------------------------------------------------------------- RLinf-facing repeated pick-and-place task registrations with explicit EEF and joint-position action variants. -.. currentmodule:: embodichain_tasks.manipulation.repeated_pick_place +.. currentmodule:: embodichain.extensions.tasks.manipulation.repeated_pick_place .. autosummary:: -embodichain_tasks.manipulation.tableware.blocks_ranking_size ------------------------------------------------------------- +embodichain.extensions.tasks.manipulation.tableware.blocks_ranking_size +----------------------------------------------------------------------- -.. currentmodule:: embodichain_tasks.manipulation.tableware.blocks_ranking_size +.. currentmodule:: embodichain.extensions.tasks.manipulation.tableware.blocks_ranking_size .. autosummary:: BlocksRankingSizeEnv -embodichain_tasks.manipulation.tableware.match_object_container ---------------------------------------------------------------- +embodichain.extensions.tasks.manipulation.tableware.match_object_container +-------------------------------------------------------------------------- -.. currentmodule:: embodichain_tasks.manipulation.tableware.match_object_container +.. currentmodule:: embodichain.extensions.tasks.manipulation.tableware.match_object_container .. autosummary:: MatchObjectContainerEnv -embodichain_tasks.manipulation.tableware.place_object_drawer ------------------------------------------------------------- +embodichain.extensions.tasks.manipulation.tableware.place_object_drawer +----------------------------------------------------------------------- -.. currentmodule:: embodichain_tasks.manipulation.tableware.place_object_drawer +.. currentmodule:: embodichain.extensions.tasks.manipulation.tableware.place_object_drawer .. autosummary:: PlaceObjectDrawerEnv -embodichain_tasks.manipulation.tableware.stack_cups ---------------------------------------------------- +embodichain.extensions.tasks.manipulation.tableware.stack_cups +-------------------------------------------------------------- -.. currentmodule:: embodichain_tasks.manipulation.tableware.stack_cups +.. currentmodule:: embodichain.extensions.tasks.manipulation.tableware.stack_cups .. autosummary:: StackCupsEnv -embodichain_tasks.special.franka_reach_apg -------------------------------------------- +embodichain.extensions.tasks.special.franka_reach_apg +----------------------------------------------------- Differentiable Franka FR3 reach environment that demonstrates the explicit kinematics route used by analytic policy-gradient experiments. -.. currentmodule:: embodichain_tasks.special.franka_reach_apg +.. currentmodule:: embodichain.extensions.tasks.special.franka_reach_apg .. autosummary:: FrankaReachApgEnv -embodichain_tasks.utils.importer --------------------------------- +embodichain.extensions.tasks.utils.importer +------------------------------------------- -.. currentmodule:: embodichain_tasks.utils.importer +.. currentmodule:: embodichain.extensions.tasks.utils.importer .. autosummary:: @@ -5255,12 +5255,12 @@ Self-contained body-local geometry, joint attachment and mass-property records w -embodichain_benchmarks.assembly.precision ------------------------------------------ +embodichain.extensions.benchmarks.assembly.precision +---------------------------------------------------- Independent USD geometry/mass acceptance and passive source/native simulation measurements. Missing overflow accounting remains unverified rather than a precision certification. ``PrecisionRunCfg.newton_solver`` explicitly selects MuJoCo Warp or DexUni; ``solver`` retains the MuJoCo algorithm. Native results retain the prepared family and actual SDK dispatch. -.. currentmodule:: embodichain_benchmarks.assembly.precision +.. currentmodule:: embodichain.extensions.benchmarks.assembly.precision .. autosummary:: @@ -5271,14 +5271,14 @@ Independent USD geometry/mass acceptance and passive source/native simulation me -embodichain_benchmarks.assembly.probes --------------------------------------- +embodichain.extensions.benchmarks.assembly.probes +------------------------------------------------- Circle/square analytic clearance oracles, state-controlled S0 contact scans and real slide/hinge S2-S4 equilibrium probes. Native and source runners preserve the same force/torque and geometry; unmeasured health limits qualification. -.. currentmodule:: embodichain_benchmarks.assembly.probes +.. currentmodule:: embodichain.extensions.benchmarks.assembly.probes .. autosummary:: @@ -5935,10 +5935,10 @@ embodichain.robot_registry .. autofunction:: resolve_gripper_defaults -embodichain_robots -~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots +.. currentmodule:: embodichain.extensions.robots .. autosummary:: :nosignatures: @@ -5979,10 +5979,10 @@ embodichain_robots :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.agilex.cobotmagic.gripper.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.agilex.cobotmagic.gripper.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.agilex.cobotmagic.gripper.cfg +.. currentmodule:: embodichain.extensions.robots.agilex.cobotmagic.gripper.cfg .. autosummary:: :nosignatures: @@ -5993,10 +5993,10 @@ embodichain_robots.agilex.cobotmagic.gripper.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.agilex.pika.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.agilex.pika.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.agilex.pika.cfg +.. currentmodule:: embodichain.extensions.robots.agilex.pika.cfg .. autosummary:: :nosignatures: @@ -6007,10 +6007,10 @@ embodichain_robots.agilex.pika.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.dh_robotics.pgi_140_80.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.dh_robotics.pgi_140_80.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.dh_robotics.pgi_140_80.cfg +.. currentmodule:: embodichain.extensions.robots.dh_robotics.pgi_140_80.cfg .. autosummary:: :nosignatures: @@ -6021,10 +6021,10 @@ embodichain_robots.dh_robotics.pgi_140_80.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.franka.hand.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.franka.hand.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.franka.hand.cfg +.. currentmodule:: embodichain.extensions.robots.franka.hand.cfg .. autosummary:: :nosignatures: @@ -6035,10 +6035,10 @@ embodichain_robots.franka.hand.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.robotiq.arg2f140.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.robotiq.arg2f140.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.robotiq.arg2f140.cfg +.. currentmodule:: embodichain.extensions.robots.robotiq.arg2f140.cfg .. autosummary:: :nosignatures: @@ -6049,10 +6049,10 @@ embodichain_robots.robotiq.arg2f140.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.robotiq.arg2f85.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.robotiq.arg2f85.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.robotiq.arg2f85.cfg +.. currentmodule:: embodichain.extensions.robots.robotiq.arg2f85.cfg .. autosummary:: :nosignatures: @@ -6063,10 +6063,10 @@ embodichain_robots.robotiq.arg2f85.cfg :members: model_id, catalog_id, root_link, collision_links, pad_links, root_from_contact_frame, min_opening_width, max_opening_width, grasp_generators, joint_commands, default_root_from_tcp, variant, get_gripper_defaults, from_dict :show-inheritance: -embodichain_robots.tianji.marvin.gripper.cfg -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +embodichain.extensions.robots.tianji.marvin.gripper.cfg +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. currentmodule:: embodichain_robots.tianji.marvin.gripper.cfg +.. currentmodule:: embodichain.extensions.robots.tianji.marvin.gripper.cfg .. autosummary:: :nosignatures: diff --git a/docs/source/api_reference/robot_catalogs.rst b/docs/source/api_reference/robot_catalogs.rst index 9179bd9eff..2b35b6ad29 100644 --- a/docs/source/api_reference/robot_catalogs.rst +++ b/docs/source/api_reference/robot_catalogs.rst @@ -1,7 +1,7 @@ Robot catalogs and configurations ================================= -The main ``embodichain`` distribution bundles ``embodichain_robots`` with the +The main ``embodichain`` distribution bundles ``embodichain.extensions.robots`` with the same release version. Concrete robot defaults and W1 hardware specifications live in that import package; generic simulation, solver, and dual-arm APIs remain in the core. @@ -17,7 +17,7 @@ the CLI, variant selection, and provider registration. Official configurations provide the existing ``RobotCfg.from_dict()`` and ``build_pk_serial_chain()`` contracts. Import concrete configurations from -``embodichain_robots`` and generic dual-arm helpers from +``embodichain.extensions.robots`` and generic dual-arm helpers from ``embodichain.lab.sim.robots``. Concrete configuration modules follow vendor/model ownership. Former flat robot configuration modules and historical selector aliases have been removed. The stock Panda hand is the sole official Panda preset; Panda/PGI assemblies @@ -42,12 +42,12 @@ variant. All merges preserve the catalog and caller mappings. .. autofunction:: embodichain.robot_registry.resolve_robot_cfg -embodichain_robots ------------------- +embodichain.extensions.robots +----------------------------- Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.YamI2rtCfg +.. py:class:: embodichain.extensions.robots.YamI2rtCfg Configure the source-aligned YAM dual-arm assembly with sixteen independent arm/finger joints. ``from_dict()`` applies caller overrides and supports a @@ -55,7 +55,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. six-joint arm's base-to-TCP chain from the same simulation URDF. See :doc:`/resources/robot/i2rt/yam`. -.. py:class:: embodichain_robots.BrainCoRevo1Cfg +.. py:class:: embodichain.extensions.robots.BrainCoRevo1Cfg Standalone fixed-base left/right BrainCo Revo 1 hand. Construct with ``from_dict({"side": "left"})`` or select catalog ID ``BrainCoRevo1`` with @@ -65,7 +65,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. values, not manufacturer specifications. See :doc:`/resources/robot/brainco/revo1`. -.. py:class:: embodichain_robots.ARX5Cfg +.. py:class:: embodichain.extensions.robots.ARX5Cfg Configure the X5A arm and its two independently actuated parallel fingers. Construct with ``from_dict()``; ``build_pk_serial_chain()`` returns the @@ -76,7 +76,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. An explicit SSIK CPU reference can use the prepared actual-model artifact; see :doc:`/overview/sim/motion/solvers/ssik_solver`. -.. py:class:: embodichain_robots.AlohaMiniCfg +.. py:class:: embodichain.extensions.robots.AlohaMiniCfg :no-index: Configure Aloha Mini 2 Pro from its complete, source-named URDF. @@ -85,7 +85,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.TianjiMarvinCfg +.. py:class:: embodichain.extensions.robots.TianjiMarvinCfg Configure Tianji Marvin with or without its parallel-jaw grippers. @@ -93,7 +93,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.DexforceW1Cfg +.. py:class:: embodichain.extensions.robots.DexforceW1Cfg DexforceW1 specific configuration, inherits from RobotCfg and allows custom parameters. @@ -101,7 +101,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.CobotMagicCfg +.. py:class:: embodichain.extensions.robots.CobotMagicCfg Dual-arm CobotMagic with source arm limits and calibrated gripper drives. @@ -109,22 +109,22 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.AgilexPiperXCfg +.. py:class:: embodichain.extensions.robots.AgilexPiperXCfg Fixed-base PiPER-X bare arm with six joints in the ``arm`` control group. Construct with ``from_dict()`` to apply the catalog defaults. ``build_pk_serial_chain()`` builds the arm chain through the tool flange. The AGX gripper embodiment supplies the mount, gripper control and TCP. -.. py:class:: embodichain_robots.FrankaPandaCfg +.. py:class:: embodichain.extensions.robots.FrankaPandaCfg Legacy selector for the historical bare seven-DOF FR3 arm. Compatibility entry retaining the historical FR3 model and legacy ``robot_type`` selector. Mount tools explicitly; new model selections use - :class:`embodichain_robots.FrankaCfg`. + :class:`embodichain.extensions.robots.FrankaCfg`. -.. py:class:: embodichain_robots.FrankaCfg +.. py:class:: embodichain.extensions.robots.FrankaCfg Bare seven-DOF Franka configuration selected by ``arm_model``: ``fr3`` (default) or ``panda``. End effectors use ordinary URDF component, @@ -134,7 +134,7 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.URRobotCfg +.. py:class:: embodichain.extensions.robots.URRobotCfg Configuration for the UR family of robots. @@ -142,18 +142,18 @@ Concrete robot configurations, exposed lazily from the bundled robot package. the robot-specific differentiable kinematic chains. Generic runtime fields and backend selection follow ``RobotCfg``. -.. py:class:: embodichain_robots.SO101FollowerCfg +.. py:class:: embodichain.extensions.robots.SO101FollowerCfg SO101 follower with five arm joints, one actuated jaw, official CAD inertials and published STS3215 simulation drives. Both serial chains use the same source URDF as simulation; arm IK constrains position. See :doc:`/resources/robot/the_robot_studio/so101` for frames, units and source limitations. -.. automethod:: embodichain_robots.SO101FollowerCfg.from_dict +.. automethod:: embodichain.extensions.robots.SO101FollowerCfg.from_dict -.. automethod:: embodichain_robots.SO101FollowerCfg.build_pk_serial_chain +.. automethod:: embodichain.extensions.robots.SO101FollowerCfg.build_pk_serial_chain -.. py:class:: embodichain_robots.FlexivRizon4SCfg +.. py:class:: embodichain.extensions.robots.FlexivRizon4SCfg Seven-axis bare Rizon 4S arm with published Flexiv dynamics, tuned simulation damping and a Warp RR flange IK solver on CPU/CUDA. Construct with ``from_dict()`` and use @@ -162,12 +162,12 @@ Concrete robot configurations, exposed lazily from the bundled robot package. See :doc:`/resources/robot/flexiv/rizon4s` for units and pinned provenance. -embodichain_robots.alohamini.aloha_mini.cfg -------------------------------------------- +embodichain.extensions.robots.alohamini.aloha_mini.cfg +------------------------------------------------------ Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.alohamini.aloha_mini.cfg.AlohaMiniCfg +.. py:class:: embodichain.extensions.robots.alohamini.aloha_mini.cfg.AlohaMiniCfg :no-index: Configure Aloha Mini 2 Pro from its complete, source-named URDF. @@ -177,22 +177,22 @@ Concrete robot configurations, exposed lazily from the bundled robot package. fields and backend selection follow ``RobotCfg``. -embodichain_robots.arx.arx5.cfg -------------------------------- +embodichain.extensions.robots.arx.arx5.cfg +------------------------------------------ -.. py:class:: embodichain_robots.arx.arx5.cfg.ARX5Cfg +.. py:class:: embodichain.extensions.robots.arx.arx5.cfg.ARX5Cfg :no-index: - Implementation of :class:`embodichain_robots.ARX5Cfg`, using the bundled + Implementation of :class:`embodichain.extensions.robots.ARX5Cfg`, using the bundled X5A asset and a six-joint numerical kinematic chain. -embodichain_robots.agilex.cobotmagic.cfg ----------------------------------------- +embodichain.extensions.robots.agilex.cobotmagic.cfg +--------------------------------------------------- Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.agilex.cobotmagic.cfg.CobotMagicCfg +.. py:class:: embodichain.extensions.robots.agilex.cobotmagic.cfg.CobotMagicCfg :no-index: Dual-arm CobotMagic with source arm limits and calibrated gripper drives. @@ -202,36 +202,36 @@ Concrete robot configurations, exposed lazily from the bundled robot package. fields and backend selection follow ``RobotCfg``. -embodichain_robots.brainco.revo1 --------------------------------- +embodichain.extensions.robots.brainco.revo1 +------------------------------------------- -.. py:class:: embodichain_robots.brainco.revo1.BrainCoRevo1Cfg +.. py:class:: embodichain.extensions.robots.brainco.revo1.BrainCoRevo1Cfg :no-index: - Model-local lazy export of :class:`embodichain_robots.BrainCoRevo1Cfg`. + Model-local lazy export of :class:`embodichain.extensions.robots.BrainCoRevo1Cfg`. Importing its asset module does not load the configuration class. -embodichain_robots.brainco.revo1.cfg ------------------------------------- +embodichain.extensions.robots.brainco.revo1.cfg +----------------------------------------------- -.. py:class:: embodichain_robots.brainco.revo1.cfg.BrainCoRevo1Cfg +.. py:class:: embodichain.extensions.robots.brainco.revo1.cfg.BrainCoRevo1Cfg :no-index: - Implementation of :class:`embodichain_robots.BrainCoRevo1Cfg`; native model + Implementation of :class:`embodichain.extensions.robots.BrainCoRevo1Cfg`; native model information is shared with the W1 mounting adapter. -.. automethod:: embodichain_robots.brainco.revo1.cfg.BrainCoRevo1Cfg.from_dict +.. automethod:: embodichain.extensions.robots.brainco.revo1.cfg.BrainCoRevo1Cfg.from_dict -.. automethod:: embodichain_robots.brainco.revo1.cfg.BrainCoRevo1Cfg.build_pk_serial_chain +.. automethod:: embodichain.extensions.robots.brainco.revo1.cfg.BrainCoRevo1Cfg.build_pk_serial_chain -embodichain_robots.dexforce.w1 ------------------------------- +embodichain.extensions.robots.dexforce.w1 +----------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.DexforceW1Cfg +.. py:class:: embodichain.extensions.robots.dexforce.w1.DexforceW1Cfg :no-index: DexforceW1 specific configuration, inherits from RobotCfg and allows custom parameters. @@ -241,12 +241,12 @@ W1 configuration, hardware revisions, calibrated transforms, hand specifications fields and backend selection follow ``RobotCfg``. -embodichain_robots.dexforce.w1.cfg ----------------------------------- +embodichain.extensions.robots.dexforce.w1.cfg +--------------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.cfg.DexforceW1Cfg +.. py:class:: embodichain.extensions.robots.dexforce.w1.cfg.DexforceW1Cfg :no-index: DexforceW1 specific configuration, inherits from RobotCfg and allows custom parameters. @@ -256,135 +256,135 @@ W1 configuration, hardware revisions, calibrated transforms, hand specifications fields and backend selection follow ``RobotCfg``. -embodichain_robots.dexforce.w1.hand_specs ------------------------------------------ +embodichain.extensions.robots.dexforce.w1.hand_specs +---------------------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.hand_specs.W1HandSideSpec +.. py:class:: embodichain.extensions.robots.dexforce.w1.hand_specs.W1HandSideSpec Side-specific asset metadata for one hand release. -.. py:class:: embodichain_robots.dexforce.w1.hand_specs.W1HandSpec +.. py:class:: embodichain.extensions.robots.dexforce.w1.hand_specs.W1HandSpec A hand release independent of the W1 body/arm version. -.. autofunction:: embodichain_robots.dexforce.w1.hand_specs.get_default_w1_hand_version +.. autofunction:: embodichain.extensions.robots.dexforce.w1.hand_specs.get_default_w1_hand_version -.. autofunction:: embodichain_robots.dexforce.w1.hand_specs.get_w1_hand_spec +.. autofunction:: embodichain.extensions.robots.dexforce.w1.hand_specs.get_w1_hand_spec -.. autofunction:: embodichain_robots.dexforce.w1.hand_specs.normalize_w1_hand_mappings +.. autofunction:: embodichain.extensions.robots.dexforce.w1.hand_specs.normalize_w1_hand_mappings -embodichain_robots.dexforce.w1.params -------------------------------------- +embodichain.extensions.robots.dexforce.w1.params +------------------------------------------------ W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.params.W1ArmKineParams +.. py:class:: embodichain.extensions.robots.dexforce.w1.params.W1ArmKineParams Kinematics parameters for a W1 arm. -embodichain_robots.dexforce.w1.specs ------------------------------------- +embodichain.extensions.robots.dexforce.w1.specs +----------------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.specs.W1VersionSpec +.. py:class:: embodichain.extensions.robots.dexforce.w1.specs.W1VersionSpec Asset layout and calibrated defaults belonging to one W1 revision. -.. autofunction:: embodichain_robots.dexforce.w1.specs.get_w1_version_spec +.. autofunction:: embodichain.extensions.robots.dexforce.w1.specs.get_w1_version_spec -embodichain_robots.dexforce.w1.types ------------------------------------- +embodichain.extensions.robots.dexforce.w1.types +----------------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.types.DexforceW1Version +.. py:class:: embodichain.extensions.robots.dexforce.w1.types.DexforceW1Version Released W1 body revision identifiers. -.. py:class:: embodichain_robots.dexforce.w1.types.DexforceW1HandVersion +.. py:class:: embodichain.extensions.robots.dexforce.w1.types.DexforceW1HandVersion W1 end-effector revision identifiers, independent of the body revision. -.. py:class:: embodichain_robots.dexforce.w1.types.DexforceW1ArmSide +.. py:class:: embodichain.extensions.robots.dexforce.w1.types.DexforceW1ArmSide Left/right side identifiers for W1 assembly and calibration. -.. py:class:: embodichain_robots.dexforce.w1.types.DexforceW1Type +.. py:class:: embodichain.extensions.robots.dexforce.w1.types.DexforceW1Type Physical W1 component identifiers used by the assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.types.DexforceW1HandBrand +.. py:class:: embodichain.extensions.robots.dexforce.w1.types.DexforceW1HandBrand Supported W1 end-effector model identifiers. -embodichain_robots.dexforce.w1.utils ------------------------------------- +embodichain.extensions.robots.dexforce.w1.utils +----------------------------------------------- W1 configuration, hardware revisions, calibrated transforms, hand specifications, and assembly helpers. -.. py:class:: embodichain_robots.dexforce.w1.utils.ChassisManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.ChassisManager Robot hardware configuration and assembly helper. -.. py:class:: embodichain_robots.dexforce.w1.utils.TorsoManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.TorsoManager Robot hardware configuration and assembly helper. -.. py:class:: embodichain_robots.dexforce.w1.utils.HeadManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.HeadManager Robot hardware configuration and assembly helper. -.. py:class:: embodichain_robots.dexforce.w1.utils.ArmManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.ArmManager Robot hardware configuration and assembly helper. -.. py:class:: embodichain_robots.dexforce.w1.utils.HandManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.HandManager Robot hardware configuration and assembly helper. -.. py:class:: embodichain_robots.dexforce.w1.utils.EyesManager +.. py:class:: embodichain.extensions.robots.dexforce.w1.utils.EyesManager Robot hardware configuration and assembly helper. -.. autofunction:: embodichain_robots.dexforce.w1.utils.build_dexforce_w1_assembly_urdf_cfg +.. autofunction:: embodichain.extensions.robots.dexforce.w1.utils.build_dexforce_w1_assembly_urdf_cfg -embodichain_robots.flexiv.rizon4s.cfg -------------------------------------- +embodichain.extensions.robots.flexiv.rizon4s.cfg +------------------------------------------------ -.. py:class:: embodichain_robots.flexiv.rizon4s.cfg.FlexivRizon4SCfg +.. py:class:: embodichain.extensions.robots.flexiv.rizon4s.cfg.FlexivRizon4SCfg :no-index: - Implementation of :class:`embodichain_robots.FlexivRizon4SCfg`. + Implementation of :class:`embodichain.extensions.robots.FlexivRizon4SCfg`. An explicit URDF ``fpath`` is shared by simulation and serial-chain FK/IK. -embodichain_robots.franka.cfg ------------------------------ +embodichain.extensions.robots.franka.cfg +---------------------------------------- -.. py:class:: embodichain_robots.franka.cfg.FrankaCfg +.. py:class:: embodichain.extensions.robots.franka.cfg.FrankaCfg :no-index: - Implementation of :class:`embodichain_robots.FrankaCfg`. + Implementation of :class:`embodichain.extensions.robots.FrankaCfg`. ``from_dict()`` selects the bare arm model before applying ordinary robot overrides. ``build_pk_serial_chain()`` shares that arm's source URDF; the solver applies the configured mounted-tool TCP once. See :doc:`/resources/robot/franka/cfg` for selections and calibration. -embodichain_robots.franka.panda -------------------------------- +embodichain.extensions.robots.franka.panda +------------------------------------------ Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.franka.panda.FrankaPandaCfg +.. py:class:: embodichain.extensions.robots.franka.panda.FrankaPandaCfg :no-index: Legacy selector for the historical bare seven-DOF FR3 arm. @@ -394,21 +394,21 @@ Concrete robot configurations, exposed lazily from the bundled robot package. fields and backend selection follow ``RobotCfg``. -embodichain_robots.the_robot_studio.so101.cfg ---------------------------------------------- +embodichain.extensions.robots.the_robot_studio.so101.cfg +-------------------------------------------------------- -.. py:class:: embodichain_robots.the_robot_studio.so101.cfg.SO101FollowerCfg +.. py:class:: embodichain.extensions.robots.the_robot_studio.so101.cfg.SO101FollowerCfg :no-index: - Implementation of :class:`embodichain_robots.SO101FollowerCfg`. + Implementation of :class:`embodichain.extensions.robots.SO101FollowerCfg`. -embodichain_robots.tianji.marvin.cfg ------------------------------------- +embodichain.extensions.robots.tianji.marvin.cfg +----------------------------------------------- Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.tianji.marvin.cfg.TianjiMarvinCfg +.. py:class:: embodichain.extensions.robots.tianji.marvin.cfg.TianjiMarvinCfg :no-index: Configure Tianji Marvin with or without its parallel-jaw grippers. @@ -418,12 +418,12 @@ Concrete robot configurations, exposed lazily from the bundled robot package. fields and backend selection follow ``RobotCfg``. -embodichain_robots.universal_robots.ur_robot --------------------------------------------- +embodichain.extensions.robots.universal_robots.ur_robot +------------------------------------------------------- Concrete robot configurations, exposed lazily from the bundled robot package. -.. py:class:: embodichain_robots.universal_robots.ur_robot.URRobotCfg +.. py:class:: embodichain.extensions.robots.universal_robots.ur_robot.URRobotCfg :no-index: Configuration for the UR family of robots. @@ -433,53 +433,53 @@ Concrete robot configurations, exposed lazily from the bundled robot package. fields and backend selection follow ``RobotCfg``. -embodichain_robots.agilex.cobotmagic ------------------------------------- +embodichain.extensions.robots.agilex.cobotmagic +----------------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.agilex.cobotmagic.CobotMagicCfg +.. py:class:: embodichain.extensions.robots.agilex.cobotmagic.CobotMagicCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.CobotMagicCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.CobotMagicCfg`. -embodichain_robots.agilex.cobotmagic.assets -------------------------------------------- +embodichain.extensions.robots.agilex.cobotmagic.assets +------------------------------------------------------ Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.agilex.cobotmagic.assets.CobotMagicArm +.. py:class:: embodichain.extensions.robots.agilex.cobotmagic.assets.CobotMagicArm :no-index: Dataset class for the Cobot Magic Arm robot. -embodichain_robots.agilex.piper_x ---------------------------------- +embodichain.extensions.robots.agilex.piper_x +-------------------------------------------- -.. py:class:: embodichain_robots.agilex.piper_x.AgilexPiperXCfg +.. py:class:: embodichain.extensions.robots.agilex.piper_x.AgilexPiperXCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.AgilexPiperXCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.AgilexPiperXCfg`. -embodichain_robots.agilex.piper_x.cfg -------------------------------------- +embodichain.extensions.robots.agilex.piper_x.cfg +------------------------------------------------ -.. py:class:: embodichain_robots.agilex.piper_x.cfg.AgilexPiperXCfg +.. py:class:: embodichain.extensions.robots.agilex.piper_x.cfg.AgilexPiperXCfg :no-index: - Implementation of :class:`embodichain_robots.AgilexPiperXCfg`. The arm + Implementation of :class:`embodichain.extensions.robots.AgilexPiperXCfg`. The arm solver uses the same portable URDF as simulation. -embodichain_robots.agilex.piper_x.assets ----------------------------------------- +embodichain.extensions.robots.agilex.piper_x.assets +--------------------------------------------------- -.. py:class:: embodichain_robots.agilex.piper_x.assets.AgilexPiperX(data_root=None) +.. py:class:: embodichain.extensions.robots.agilex.piper_x.assets.AgilexPiperX(data_root=None) :no-index: Resolve the official bare-arm meshes and portable URDF, including the @@ -487,283 +487,283 @@ embodichain_robots.agilex.piper_x.assets the source files by SHA-256 and exposes ``piper_x.urdf`` under ``extract_dir``. -embodichain_robots.alohamini.aloha_mini ---------------------------------------- +embodichain.extensions.robots.alohamini.aloha_mini +-------------------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.alohamini.aloha_mini.AlohaMiniCfg +.. py:class:: embodichain.extensions.robots.alohamini.aloha_mini.AlohaMiniCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.AlohaMiniCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.AlohaMiniCfg`. -embodichain_robots.alohamini.aloha_mini.assets ----------------------------------------------- +embodichain.extensions.robots.alohamini.aloha_mini.assets +--------------------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.alohamini.aloha_mini.assets.AlohaMini +.. py:class:: embodichain.extensions.robots.alohamini.aloha_mini.assets.AlohaMini :no-index: Dataset class for the Aloha Mini robot. -embodichain_robots.arx.arx5 ---------------------------- +embodichain.extensions.robots.arx.arx5 +-------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.arx.arx5.ARX5Cfg +.. py:class:: embodichain.extensions.robots.arx.arx5.ARX5Cfg :no-index: - Lazy model-level export of :class:`embodichain_robots.ARX5Cfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.ARX5Cfg`. -embodichain_robots.arx.arx5.assets ----------------------------------- +embodichain.extensions.robots.arx.arx5.assets +--------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.arx.arx5.assets.ARX5 +.. py:class:: embodichain.extensions.robots.arx.arx5.assets.ARX5 :no-index: Dataset class for the ARX5 robot. -embodichain_robots.dexforce.w1.assets -------------------------------------- +embodichain.extensions.robots.dexforce.w1.assets +------------------------------------------------ Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1V021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1V021 :no-index: Dataset class for the Dexforce W1 V021. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1V022 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1V022 :no-index: Dataset class for the unified Dexforce W1 V022 release archive. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1V025 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1V025 :no-index: Dataset class for the unified Dexforce W1 V025 release archive. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1V030 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1V030 :no-index: Standard V030 body archive, excluding detachable end effectors. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1ChassisV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1ChassisV021 :no-index: Resolve the DexforceW1ChassisV021 resource bundle through the shared data cache. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1TorsoV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1TorsoV021 :no-index: Resolve the DexforceW1TorsoV021 resource bundle through the shared data cache. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1EyesV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1EyesV021 :no-index: Resolve the DexforceW1EyesV021 resource bundle through the shared data cache. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1HeadV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1HeadV021 :no-index: Resolve the DexforceW1HeadV021 resource bundle through the shared data cache. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1LeftArmV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1LeftArmV021 :no-index: Resolve the DexforceW1LeftArmV021 resource bundle through the shared data cache. -.. py:class:: embodichain_robots.dexforce.w1.assets.DexforceW1RightArmV021 +.. py:class:: embodichain.extensions.robots.dexforce.w1.assets.DexforceW1RightArmV021 :no-index: Resolve the DexforceW1RightArmV021 resource bundle through the shared data cache. -embodichain_robots.flexiv.rizon4s ---------------------------------- +embodichain.extensions.robots.flexiv.rizon4s +-------------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.flexiv.rizon4s.FlexivRizon4SCfg +.. py:class:: embodichain.extensions.robots.flexiv.rizon4s.FlexivRizon4SCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.FlexivRizon4SCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.FlexivRizon4SCfg`. -embodichain_robots.flexiv.rizon4s.assets ----------------------------------------- +embodichain.extensions.robots.flexiv.rizon4s.assets +--------------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.flexiv.rizon4s.assets.FlexivRizon4S +.. py:class:: embodichain.extensions.robots.flexiv.rizon4s.assets.FlexivRizon4S :no-index: Download the Apache-2.0 Flexiv Rizon 4S description from Hugging Face. -embodichain_robots.franka.assets --------------------------------- +embodichain.extensions.robots.franka.assets +------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.franka.assets.Franka +.. py:class:: embodichain.extensions.robots.franka.assets.Franka :no-index: Dataset class for the Franka robots. -.. autoclass:: embodichain_robots.franka.assets.FrankaPandaArm +.. autoclass:: embodichain.extensions.robots.franka.assets.FrankaPandaArm -.. autofunction:: embodichain_robots.robotiq.two_finger.robotiq85_joint_positions +.. autofunction:: embodichain.extensions.robots.robotiq.two_finger.robotiq85_joint_positions -embodichain_robots.i2rt.yam ---------------------------- +embodichain.extensions.robots.i2rt.yam +-------------------------------------- -.. py:class:: embodichain_robots.i2rt.yam.YamI2rtCfg +.. py:class:: embodichain.extensions.robots.i2rt.yam.YamI2rtCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.YamI2rtCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.YamI2rtCfg`. -.. py:class:: embodichain_robots.i2rt.yam.cfg.YamI2rtCfg +.. py:class:: embodichain.extensions.robots.i2rt.yam.cfg.YamI2rtCfg :no-index: Implementation of the dual-arm preset with source joint names and numerical arm solvers. Shared runtime fields follow ``RobotCfg``. -.. automethod:: embodichain_robots.i2rt.yam.cfg.YamI2rtCfg.from_dict +.. automethod:: embodichain.extensions.robots.i2rt.yam.cfg.YamI2rtCfg.from_dict -.. automethod:: embodichain_robots.i2rt.yam.cfg.YamI2rtCfg.build_pk_serial_chain +.. automethod:: embodichain.extensions.robots.i2rt.yam.cfg.YamI2rtCfg.build_pk_serial_chain -embodichain_robots.i2rt.yam.assets ----------------------------------- +embodichain.extensions.robots.i2rt.yam.assets +--------------------------------------------- -.. py:class:: embodichain_robots.i2rt.yam.assets.YamI2rt +.. py:class:: embodichain.extensions.robots.i2rt.yam.assets.YamI2rt :no-index: Download the checked ``YamI2rtV1`` archive through the shared download/cache services, preserving its MIT license and conversion provenance. -embodichain_robots.the_robot_studio.so101 ------------------------------------------ +embodichain.extensions.robots.the_robot_studio.so101 +---------------------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.the_robot_studio.so101.SO101FollowerCfg +.. py:class:: embodichain.extensions.robots.the_robot_studio.so101.SO101FollowerCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.SO101FollowerCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.SO101FollowerCfg`. -embodichain_robots.the_robot_studio.so101.assets ------------------------------------------------- +embodichain.extensions.robots.the_robot_studio.so101.assets +----------------------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.the_robot_studio.so101.assets.SO101FollowerAssets +.. py:class:: embodichain.extensions.robots.the_robot_studio.so101.assets.SO101FollowerAssets :no-index: Download the official follower URDF and its dependencies at a fixed revision. -embodichain_robots.tianji.marvin --------------------------------- +embodichain.extensions.robots.tianji.marvin +------------------------------------------- The model package exposes its configuration lazily; accessing asset definitions does not import this configuration implementation. -.. py:class:: embodichain_robots.tianji.marvin.TianjiMarvinCfg +.. py:class:: embodichain.extensions.robots.tianji.marvin.TianjiMarvinCfg :no-index: - Lazy model-level export of :class:`embodichain_robots.TianjiMarvinCfg`. + Lazy model-level export of :class:`embodichain.extensions.robots.TianjiMarvinCfg`. -embodichain_robots.tianji.marvin.assets ---------------------------------------- +embodichain.extensions.robots.tianji.marvin.assets +-------------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.tianji.marvin.assets.TianjiMarvin +.. py:class:: embodichain.extensions.robots.tianji.marvin.assets.TianjiMarvin :no-index: Dataset class for the Tianji Marvin robot. -embodichain_robots.universal_robots.assets ------------------------------------------- +embodichain.extensions.robots.universal_robots.assets +----------------------------------------------------- Model-owned download definitions preserve their asset IDs, archive checksums and cache prefixes while using the shared core download and locking services. -.. py:class:: embodichain_robots.universal_robots.assets.UniversalRobots +.. py:class:: embodichain.extensions.robots.universal_robots.assets.UniversalRobots :no-index: Dataset class for the Universal Robots. -embodichain_robots.sharpa.wave -------------------------------- +embodichain.extensions.robots.sharpa.wave +----------------------------------------- -.. py:class:: embodichain_robots.SharpaWaveCfg +.. py:class:: embodichain.extensions.robots.SharpaWaveCfg :no-index: Standalone fixed-base Sharpa Wave 01, with left/right variants and 22 independent joint commands. No serial-chain solver or single TCP is declared. -.. py:class:: embodichain_robots.sharpa.wave.SharpaWaveCfg +.. py:class:: embodichain.extensions.robots.sharpa.wave.SharpaWaveCfg :no-index: - Model-local lazy export of :class:`embodichain_robots.SharpaWaveCfg`. + Model-local lazy export of :class:`embodichain.extensions.robots.SharpaWaveCfg`. -.. py:class:: embodichain_robots.sharpa.wave.cfg.SharpaWaveCfg +.. py:class:: embodichain.extensions.robots.sharpa.wave.cfg.SharpaWaveCfg :no-index: Implementation of the source-preserving standalone hand configuration. -.. automethod:: embodichain_robots.sharpa.wave.cfg.SharpaWaveCfg.from_dict +.. automethod:: embodichain.extensions.robots.sharpa.wave.cfg.SharpaWaveCfg.from_dict -.. automethod:: embodichain_robots.sharpa.wave.cfg.SharpaWaveCfg.build_pk_serial_chain +.. automethod:: embodichain.extensions.robots.sharpa.wave.cfg.SharpaWaveCfg.build_pk_serial_chain -embodichain_robots.wuji.hand ------------------------------ +embodichain.extensions.robots.wuji.hand +--------------------------------------- -.. py:class:: embodichain_robots.WujiHandCfg +.. py:class:: embodichain.extensions.robots.WujiHandCfg :no-index: Standalone fixed-base Wuji Hand, with left/right variants and 20 independent joint commands. No serial-chain solver or single TCP is declared. -.. py:class:: embodichain_robots.wuji.hand.WujiHandCfg +.. py:class:: embodichain.extensions.robots.wuji.hand.WujiHandCfg :no-index: - Model-local lazy export of :class:`embodichain_robots.WujiHandCfg`. + Model-local lazy export of :class:`embodichain.extensions.robots.WujiHandCfg`. -.. py:class:: embodichain_robots.wuji.hand.cfg.WujiHandCfg +.. py:class:: embodichain.extensions.robots.wuji.hand.cfg.WujiHandCfg :no-index: Implementation of the source-preserving standalone hand configuration. -.. automethod:: embodichain_robots.wuji.hand.cfg.WujiHandCfg.from_dict +.. automethod:: embodichain.extensions.robots.wuji.hand.cfg.WujiHandCfg.from_dict -.. automethod:: embodichain_robots.wuji.hand.cfg.WujiHandCfg.build_pk_serial_chain +.. automethod:: embodichain.extensions.robots.wuji.hand.cfg.WujiHandCfg.build_pk_serial_chain diff --git a/docs/source/api_reference/rwm.rst b/docs/source/api_reference/rwm.rst index 328b61b83f..a182ad77a8 100644 --- a/docs/source/api_reference/rwm.rst +++ b/docs/source/api_reference/rwm.rst @@ -1,7 +1,7 @@ Robot world model ================= -``embodichain_models.dynamics.rwm`` predicts action-conditioned robot states +``embodichain.extensions.models.dynamics.rwm`` predicts action-conditioned robot states using frame-local increments and FP32 integration. It owns the model, state representation, autoregressive objective, prediction state, replay and offline recipe. Shared optimizer updates and recovery use @@ -12,10 +12,10 @@ Public entry points The named family lazily exports the model and its supervised integration. ``build_rwm_trainer`` retains its public symbol name at this canonical import -path and at ``embodichain_models.dynamics.rwm.sl_recipe``. The family does not +path and at ``embodichain.extensions.models.dynamics.rwm.sl_recipe``. The family does not initialize simulation or import example helpers. -.. currentmodule:: embodichain_models.dynamics.rwm +.. currentmodule:: embodichain.extensions.models.dynamics.rwm .. autosummary:: @@ -59,7 +59,7 @@ Increments use the current body frame and right-multiplied exponential rotation coordinates. The logarithm selects the shortest rotation; first-order derivatives away from its pi branch cut are supported. -.. currentmodule:: embodichain_models.dynamics.rwm.robot_state +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.robot_state .. autosummary:: @@ -97,7 +97,7 @@ identity retains the fixed control period, action semantics and ordered joints. ``frozen_world_model`` freezes parameters and statistics while preserving state/action gradients through dependent rollout and backward work. -.. currentmodule:: embodichain_models.dynamics.rwm.model +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.model .. autosummary:: @@ -130,7 +130,7 @@ Both models accept the canonical matrix-based state and preserve state/action input gradients when frozen. Geometry XML and the complete model configuration are included in checkpoint identity. -.. currentmodule:: embodichain_models.dynamics.rwm.kinematic +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.kinematic .. autosummary:: @@ -162,7 +162,7 @@ state when beginning a new graph. The objective accepts feature weights and window adaptation excludes episode-crossing windows and optional false ``usable`` transition flags before constructing the prediction graph. -.. currentmodule:: embodichain_models.dynamics.rwm.supervised +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.supervised .. autosummary:: @@ -174,7 +174,7 @@ window adaptation excludes episode-crossing windows and optional false .. autofunction:: replay_supervised_batch -.. currentmodule:: embodichain_models.dynamics.rwm.predictor +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.predictor .. autosummary:: @@ -196,7 +196,7 @@ include ``history_complete``: reset padding is complete, while missing rows lost to ring overwrite are not. Version-1 snapshots remain loadable for layouts with no auxiliary fields. -.. currentmodule:: embodichain_models.dynamics.rwm.replay +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.replay .. autosummary:: @@ -208,14 +208,14 @@ no auxiliary fields. Offline SL recipe ----------------- -Use ``embodichain_models.dynamics.rwm.sl_recipe:build_rwm_trainer`` as the factory +Use ``embodichain.extensions.models.dynamics.rwm.sl_recipe:build_rwm_trainer`` as the factory for ``embodichain train-sl``. Tensor corpora declare their split, action semantics, control period and ordered joints. Normalization uses valid measured training transitions. The resulting common SL checkpoint preserves corpus identity, normalization, optimizer, RNG and the sampling cursor. The controlled fitting example runs through ``embodichain run-example learning/rwm``. -.. currentmodule:: embodichain_models.dynamics.rwm.sl_recipe +.. currentmodule:: embodichain.extensions.models.dynamics.rwm.sl_recipe .. autosummary:: @@ -230,7 +230,7 @@ The motion actor concatenates proprioceptive history with an encoded reference goal. Its scalar critic consumes separate privileged state features. Actor and critic normalizers are updated explicitly at their respective learning phases. -.. automodule:: embodichain_models.policies.motion_tracking +.. automodule:: embodichain.extensions.models.policies.motion_tracking :members: The tensor-only motion environment starts from measured replay states, clean @@ -238,8 +238,8 @@ history and reference progress. It preserves action/state derivatives across a fixed horizon and reports invalid clip suffixes through validity masks. The workflow freezes model parameters until policy backpropagation completes. -.. automodule:: embodichain_tasks.locomotion.tracking.motion_model +.. automodule:: embodichain.extensions.tasks.locomotion.tracking.motion_model :members: -.. automodule:: embodichain_tasks.locomotion.managers.events +.. automodule:: embodichain.extensions.tasks.locomotion.managers.events :members: diff --git a/docs/source/api_reference/visual_act.rst b/docs/source/api_reference/visual_act.rst index 89fa281638..c5fc7508b0 100644 --- a/docs/source/api_reference/visual_act.rst +++ b/docs/source/api_reference/visual_act.rst @@ -16,24 +16,24 @@ Historical EmbodiChain ACT ``.pt`` checkpoints require retraining. .. autosummary:: - embodichain_models.policy.act.ACTInferencePolicy - embodichain_models.policy.act.build_act_train_config - embodichain_models.policy.act.dataset_fingerprint - embodichain_models.policy.act.load_act_policy - embodichain_models.policy.act.policy_fingerprint - embodichain_models.policy.act.runtime.ACTInferencePolicy - embodichain_models.policy.act.runtime.load_act_policy - embodichain_models.policy.act.runtime.policy_fingerprint - embodichain_models.policy.act.training.build_act_train_config - embodichain_models.policy.act.training.dataset_fingerprint - -.. autoclass:: embodichain_models.policy.act.ACTInferencePolicy + embodichain.extensions.models.policy.act.ACTInferencePolicy + embodichain.extensions.models.policy.act.build_act_train_config + embodichain.extensions.models.policy.act.dataset_fingerprint + embodichain.extensions.models.policy.act.load_act_policy + embodichain.extensions.models.policy.act.policy_fingerprint + embodichain.extensions.models.policy.act.runtime.ACTInferencePolicy + embodichain.extensions.models.policy.act.runtime.load_act_policy + embodichain.extensions.models.policy.act.runtime.policy_fingerprint + embodichain.extensions.models.policy.act.training.build_act_train_config + embodichain.extensions.models.policy.act.training.dataset_fingerprint + +.. autoclass:: embodichain.extensions.models.policy.act.ACTInferencePolicy :members: -.. autofunction:: embodichain_models.policy.act.build_act_train_config +.. autofunction:: embodichain.extensions.models.policy.act.build_act_train_config -.. autofunction:: embodichain_models.policy.act.dataset_fingerprint +.. autofunction:: embodichain.extensions.models.policy.act.dataset_fingerprint -.. autofunction:: embodichain_models.policy.act.load_act_policy +.. autofunction:: embodichain.extensions.models.policy.act.load_act_policy -.. autofunction:: embodichain_models.policy.act.policy_fingerprint +.. autofunction:: embodichain.extensions.models.policy.act.policy_fingerprint diff --git a/docs/source/conf.py b/docs/source/conf.py index 687d5a7cb5..e2423e0e6e 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -35,10 +35,7 @@ ) os.environ.setdefault("AZURE_OPENAI_API_KEY", "mock-api-key-for-docs-build") -sys.path.insert(0, os.path.abspath("../..")) -sys.path.insert( - 0, str(Path(__file__).resolve().parents[2] / "extensions" / "embodichain_models") -) +sys.path.insert(0, str(Path(__file__).resolve().parents[2])) sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "scripts")) diff --git a/docs/source/features/neural_dynamics.md b/docs/source/features/neural_dynamics.md index be43cae1bc..7be1adf5f8 100644 --- a/docs/source/features/neural_dynamics.md +++ b/docs/source/features/neural_dynamics.md @@ -7,7 +7,7 @@ action-conditioned robot state prediction, and **RigidFormer** for the motion of interacting rigid geometry. **WorldParticle** provides frozen particle prediction and optional native forward-inference deployment. -The models ship as `embodichain_models.dynamics.` in the main +The models ship as `embodichain.extensions.models.dynamics.` in the main `embodichain` wheel. Import the family you need explicitly. Model imports do not start a simulator; datasets, reference assets and pretrained weights are prepared separately by each example. @@ -54,9 +54,9 @@ NeRD, RWM and RigidFormer provide installable factories for the common | Model | Recipe factory | | --- | --- | -| NeRD | `embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer` | -| RWM | `embodichain_models.dynamics.rwm.sl_recipe:build_rwm_trainer` | -| RigidFormer | `embodichain_models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer` | +| NeRD | `embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer` | +| RWM | `embodichain.extensions.models.dynamics.rwm.sl_recipe:build_rwm_trainer` | +| RigidFormer | `embodichain.extensions.models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer` | WorldParticle currently has no shared-SL recipe, learning-env or APG entry point. @@ -106,5 +106,5 @@ reference workflow for published-weight or retraining comparisons. and supervised training. - [RigidFormer API](../api_reference/model_rigidformer.rst): geometry inputs, checkpoint loading, MOVi source, objective and trainer factory. -- [Model catalog](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_models/README.md): +- [Model catalog](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/models/README.md): model families and public import conventions. diff --git a/docs/source/features/neural_dynamics/nerd.md b/docs/source/features/neural_dynamics/nerd.md index 2c075d031f..23474f12b3 100644 --- a/docs/source/features/neural_dynamics/nerd.md +++ b/docs/source/features/neural_dynamics/nerd.md @@ -9,7 +9,7 @@ Choose it when the transition depends on recent motion and applied efforts, using a dataset and codec that match the physical system. The simulation-independent network, codec, trajectory reader and SL recipe live -in `embodichain_models.dynamics.nerd`. The `learning/nerd` example prepares +in `embodichain.extensions.models.dynamics.nerd`. The `learning/nerd` example prepares resources and provides collection, training, export and evaluation commands. Native simulation deployment is a separate consumer of the model and codec. @@ -125,9 +125,9 @@ from pathlib import Path import torch -from embodichain_models.dynamics.nerd import NeRDStateCodec, load_model -from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset -from embodichain_models.dynamics.nerd.integration import encode_batch +from embodichain.extensions.models.dynamics.nerd import NeRDStateCodec, load_model +from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset +from embodichain.extensions.models.dynamics.nerd.integration import encode_batch root = Path("outputs/nerd-resources") model, manifest = load_model( @@ -171,7 +171,7 @@ These are separate consumers of the same `NeRDTransition`: | --- | --- | --- | | Online tensor rollout | `NeRDState` plus `NeRDTransition.step(state, effort)` | State/history are explicit; the caller owns detach and reset | | Policy learning | `trainer.learning_env`, bootstrapped by `run-example learning/nerd train-policy` | Environment owns reward, terminal observations, row reset and `detach_state()` | -| Native scene inference | `embodichain_solvers.physics.nerd.provider.NeRDProvider` | SDK owns buffers/step/reset/close; native prediction uses `no_grad` | +| Native scene inference | `embodichain.extensions.solvers.physics.nerd.provider.NeRDProvider` | SDK owns buffers/step/reset/close; native prediction uses `no_grad` | Online `step` computes current-state FK/contact features through its injected `NeRDGeometry`, appends history, predicts and decodes the next state. Offline @@ -281,7 +281,7 @@ Relative paths in a common SL recipe resolve from the working directory. Its installable factory is: ```text -embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer +embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer ``` Export accepts both SL checkpoints and historical NeRD checkpoints and preserves diff --git a/docs/source/features/neural_dynamics/rigidformer.md b/docs/source/features/neural_dynamics/rigidformer.md index 27ee6885a5..ab69664d83 100644 --- a/docs/source/features/neural_dynamics/rigidformer.md +++ b/docs/source/features/neural_dynamics/rigidformer.md @@ -7,7 +7,7 @@ rigid objects from observed geometry and physical properties. Use it when your observations are aligned material points on rigid bodies and you want a free rollout after several warmup frames. The current adapter has no action input. -`embodichain_models.dynamics.rigidformer` integrates the native author +`embodichain.extensions.models.dynamics.rigidformer` integrates the native author architecture, official weights and a shared-SL training recipe for MOVi-Sphere, MOVi-A and MOVi-B. The example provides resource preparation, an engine comparison, fixed-checkpoint evaluation and independent reference checks. @@ -169,7 +169,7 @@ from pathlib import Path import torch -from embodichain_models.dynamics.rigidformer import ( +from embodichain.extensions.models.dynamics.rigidformer import ( MOViSequenceSource, load_rigidformer_checkpoint, ) @@ -307,7 +307,7 @@ Matusik. **RigidFormer: Learning Rigid Dynamics using Transformers.** 2026. independent author comparison and exact recovery commands. - [Acceptance protocol](https://github.com/DexForce/EmbodiChain/blob/main/examples/learning/rigidformer/research/acceptance.md): frozen sources, numerical checks, evaluation and retraining requirements. -- [Public model package](https://github.com/DexForce/EmbodiChain/tree/main/extensions/embodichain_models/embodichain_models/dynamics/rigidformer): +- [Public model package](https://github.com/DexForce/EmbodiChain/tree/main/embodichain/extensions/models/dynamics/rigidformer): model/config, checkpoint, source, objective and trainer APIs. - [All neural dynamics models](../neural_dynamics.md). diff --git a/docs/source/features/neural_dynamics/rwm.md b/docs/source/features/neural_dynamics/rwm.md index 7c9edf4ae0..b59e0c2591 100644 --- a/docs/source/features/neural_dynamics/rwm.md +++ b/docs/source/features/neural_dynamics/rwm.md @@ -6,7 +6,7 @@ RWM predicts a robot's next state from its current state, an action and optional physical context. Use it to fit measured transitions at a fixed control period or to differentiate a sequence of predictions with respect to states/actions. The model, predictor, transition replay and SL recipe are available in -`embodichain_models.dynamics.rwm` and work on CPU or CUDA without a simulator. +`embodichain.extensions.models.dynamics.rwm` and work on CPU or CUDA without a simulator. Its state-increment formulation is inspired by [SuperMimic](https://arxiv.org/abs/2610.28480); the implementation lineage is documented in [References](#references). @@ -141,7 +141,7 @@ from pathlib import Path import torch -from embodichain_models.dynamics.rwm import ( +from embodichain.extensions.models.dynamics.rwm import ( RWMPredictor, build_rwm_trainer, frozen_world_model, @@ -177,7 +177,7 @@ ring. For example, reuse the measured validation window above to demonstrate the data adapter: ```python -from embodichain_models.dynamics.rwm import TransitionReplay, replay_supervised_batch +from embodichain.extensions.models.dynamics.rwm import TransitionReplay, replay_supervised_batch replay = TransitionReplay( capacity=64, @@ -272,6 +272,6 @@ in this guide; the paper also studies policy learning and humanoid control. - [RWM API](../../api_reference/rwm.rst): state transforms, model, predictor, replay, objective and trainer factory. - [Example and fitting protocol](https://github.com/DexForce/EmbodiChain/blob/main/examples/learning/rwm/README.md). -- [Model implementation](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py): +- [Model implementation](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/models/dynamics/rwm/model.py): frame-local transition model and its upstream reference. - [All neural dynamics models](../neural_dynamics.md). diff --git a/docs/source/features/neural_dynamics/worldparticle.md b/docs/source/features/neural_dynamics/worldparticle.md index d8d51da41f..0019f5ac71 100644 --- a/docs/source/features/neural_dynamics/worldparticle.md +++ b/docs/source/features/neural_dynamics/worldparticle.md @@ -6,14 +6,14 @@ WorldParticle predicts particle positions and velocities from the current state, total acceleration and fixed authored features/boundaries/topology. The family preserves the original frozen networks and published checkpoints for Fancy Fluid, Cloth on Ball, Duck forward deformation and Deep Fluid. -Its [source provenance](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/PROVENANCE.json) +Its [source provenance](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/models/dynamics/worldparticle/PROVENANCE.json) records the upstream revision and retained licenses, including the separate ToMe notice. | Owner | Responsibility | | --- | --- | -| `embodichain_models.dynamics.worldparticle` | Frozen network, strict weights, feature normalization, topology and coordinate conversion | -| `embodichain_solvers.physics.worldparticle.provider` | Native scene admission and the optional `worldparticle` Provider | +| `embodichain.extensions.models.dynamics.worldparticle` | Frozen network, strict weights, feature normalization, topology and coordinate conversion | +| `embodichain.extensions.solvers.physics.worldparticle.provider` | Native scene admission and the optional `worldparticle` Provider | | SDK `ParticleInferenceSolver` | Streams, native buffers, force-to-acceleration conversion, writes, reset and close | | `examples/learning/worldparticle` | Resource preparation, scene construction, demos and usage contracts | diff --git a/docs/source/features/toolkits/grasp_generator.rst b/docs/source/features/toolkits/grasp_generator.rst index e08e07fa06..9f3dcf845e 100644 --- a/docs/source/features/toolkits/grasp_generator.rst +++ b/docs/source/features/toolkits/grasp_generator.rst @@ -14,7 +14,7 @@ and trajectory execution in the simulation loop. Model-owned hand defaults and embodiment TCP binding are described in :doc:`../../resources/robot/parallel_jaw_grippers`. Concrete hand values come -from ``embodichain_robots``; GraspKit consumes explicit physical descriptions +from ``embodichain.extensions.robots``; GraspKit consumes explicit physical descriptions and keeps sampling, collision and annotation policy separate. Processing Pipeline diff --git a/docs/source/features/workspace_analyzer/cli.md b/docs/source/features/workspace_analyzer/cli.md index 9e4f1af1f6..ea3ab7f6d3 100644 --- a/docs/source/features/workspace_analyzer/cli.md +++ b/docs/source/features/workspace_analyzer/cli.md @@ -31,7 +31,7 @@ including when previewing an existing cache. ## Predefined robots (`--robot`) Use `--robot NAME` to select an installed robot catalog ID. Official concrete -presets live in `embodichain_robots/`; `embodichain list-robot` lists the IDs, +presets live in `embodichain/extensions/robots/`; `embodichain list-robot` lists the IDs, variants, and default control groups. The preset already defines the URDF, control parts, and kinematics solver, so pick the part to analyze with `--control-part` (optional; defaults to `left_arm`/`right_arm` or the first diff --git a/docs/source/features/workspace_analyzer/workspace_analyzer.md b/docs/source/features/workspace_analyzer/workspace_analyzer.md index 40914ba789..6de662f3ab 100644 --- a/docs/source/features/workspace_analyzer/workspace_analyzer.md +++ b/docs/source/features/workspace_analyzer/workspace_analyzer.md @@ -20,7 +20,7 @@ for using cached results in task environments. import torch import numpy as np from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.sim.motion.workspace import ( WorkspaceAnalyzer, WorkspaceAnalyzerConfig, @@ -163,7 +163,7 @@ config = WorkspaceAnalyzerConfig( import torch import numpy as np from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.sim.motion.workspace import ( WorkspaceAnalyzer, WorkspaceAnalyzerConfig, AnalysisMode ) diff --git a/docs/source/guides/add_robot.rst b/docs/source/guides/add_robot.rst index 39c7fe3c57..0ccaed8259 100644 --- a/docs/source/guides/add_robot.rst +++ b/docs/source/guides/add_robot.rst @@ -6,7 +6,7 @@ Adding a New Robot This guide provides a practical checklist and reference for adding a new robot to EmbodiChain. -Official concrete presets live in ``embodichain_robots``; generic robot runtime +Official concrete presets live in ``embodichain.extensions.robots``; generic robot runtime and dual-arm composition remain in the core. Use :doc:`robot_catalog` for catalog registration, display metadata, and canonical import paths. @@ -50,8 +50,8 @@ Checklist 6. **Implement** ``build_pk_serial_chain`` reading from ``_pk_urdf_path``. 7. **Keep** ``from_dict`` as the 3-line template — do not reimplement. 8. **Register** the official preset's lazy export in - ``embodichain_robots/__init__.py`` and its ID, class import path, defaults, - and control metadata in ``embodichain_robots/_catalog.py``. External packages + ``embodichain/extensions/robots/__init__.py`` and its ID, class import path, defaults, + and control metadata in ``embodichain/extensions/robots/_catalog.py``. External packages advertise a catalog through an ``embodichain.robots`` entry point. 9. **Add documentation** — create ``docs/source/resources/robot//.md`` and include it in the @@ -75,7 +75,7 @@ Approaches Keep ``cfg.py``, ``assets.py``, optional specification/type helpers, and a lazy ``__init__.py`` together. Asset imports must not load configuration modules. -Asset classes register through ``embodichain_robots/_asset_catalog.py`` and the +Asset classes register through ``embodichain/extensions/robots/_asset_catalog.py`` and the ``embodichain.assets`` entry point. Each asset ID declares a ``class_path`` and ``category``. Keep source versions, checksums and cache prefixes with the asset; the core owns reusable download, locking and extraction machinery. diff --git a/docs/source/guides/cli.md b/docs/source/guides/cli.md index 7529399634..0eb49b81be 100644 --- a/docs/source/guides/cli.md +++ b/docs/source/guides/cli.md @@ -157,7 +157,7 @@ demo or RL capabilities: ```bash embodichain list-task embodichain list-task --category manipulation -embodichain show-task embodichain_tasks:repeated_pick_place +embodichain show-task embodichain.extensions.tasks:repeated_pick_place ``` `show-task` displays a logical task's named deployments, launch commands and @@ -218,7 +218,7 @@ between dataset/video/trajectory recording, and all three replay modes, see Task environments are **auto-discovered**: any installed package that declares an ``embodichain.tasks`` entry point is imported at startup, registering its environments via ``@register_env``. The main ``embodichain`` distribution -already includes and registers the official ``embodichain_tasks`` import +already includes and registers the official ``embodichain.extensions.tasks`` import package, so no separate task installation is needed. Repository-style task config paths resolve from the source checkout or installed wheel. The task to launch is selected by the ``"id"`` field of the gym config. Pass a runnable @@ -512,21 +512,21 @@ Launch reinforcement learning training from a JSON or YAML config file. ```bash # Train with a config file (JSON or YAML) -embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml # JSON configs remain supported -embodichain train-rl --config embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json # Multi-GPU distributed training torchrun --nproc_per_node=2 -m embodichain train-rl \ - --config embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json \ + --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json \ --distributed ``` The module entry point remains available for compatibility: ```bash -python -m embodichain.learning.rl.train --config embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml +python -m embodichain.learning.rl.train --config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml ``` ### Arguments diff --git a/docs/source/guides/configuration.md b/docs/source/guides/configuration.md index fd060cfca2..041da254a9 100644 --- a/docs/source/guides/configuration.md +++ b/docs/source/guides/configuration.md @@ -140,8 +140,8 @@ Example paths in the repository: | Use case | JSON example | YAML example | |---|---|---| -| Runnable Gym deployment | `embodichain_tasks/configs/tasks/manipulation/push_cube/env.json` | `embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml` | -| RL training | `embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json` | `embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml` | +| Runnable Gym deployment | `embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json` | `embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml` | +| RL training | `embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json` | `embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml` | When a training config references a gym config (via `trainer.gym_config`), the nested path may also use any supported extension. @@ -427,7 +427,7 @@ it validates. Use `class_type` to select a registered `RobotCfg` subclass through `embodichain.robot_registry`. Official concrete presets live in -`embodichain_robots`; generic dual-arm composition remains in the core. +`embodichain.extensions.robots`; generic dual-arm composition remains in the core. Run `embodichain list-robot` to discover IDs and control summaries. Subclass-specific fields remain in the robot configuration and are passed to its `from_dict()` method. For example, this selects the canonical UR preset @@ -504,7 +504,7 @@ trainer: device: cuda:0 iterations: 500 buffer_size: 1024 - gym_config: embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml policy: name: actor_critic actor: @@ -548,7 +548,7 @@ This is automatically converted to a `SceneEntityCfg` object at runtime. ## Tips -1. **Start from an existing config.** Copy a task config from `embodichain_tasks/configs/tasks///`, then modify it for your task. +1. **Start from an existing config.** Copy a task config from `embodichain/extensions/tasks/configs/tasks///`, then modify it for your task. 2. **Use Python configs for development.** They provide IDE auto-completion and type checking. 3. **Use JSON or YAML configs for experiments.** YAML is often easier to read for nested structures; JSON remains fully supported. 4. **Validate configs early.** Run your environment with a short episode count to catch config errors before long training runs. diff --git a/docs/source/guides/configured_manipulation_rl.md b/docs/source/guides/configured_manipulation_rl.md index b1d61f8aa0..c0be4aaba4 100644 --- a/docs/source/guides/configured_manipulation_rl.md +++ b/docs/source/guides/configured_manipulation_rl.md @@ -88,7 +88,7 @@ as task failure; the legacy `PushCubeRL` keeps its original falling-as-truncatio behavior. Existing task IDs and agent files are unchanged. ```bash -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml ``` ## Recording and dynamic replay diff --git a/docs/source/guides/expert_task_language.md b/docs/source/guides/expert_task_language.md index ad6bfe4257..15c6925108 100644 --- a/docs/source/guides/expert_task_language.md +++ b/docs/source/guides/expert_task_language.md @@ -34,7 +34,7 @@ not a source of task language. ## Configure a Task Program The following is the complete program used by the three-cycle cube example at -`embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml`: +`embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml`: ```yaml program_id: repeated_cube_pick_place @@ -89,7 +89,7 @@ Run the shipped example from the repository root: ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --headless \ --max_episodes 1 ``` diff --git a/docs/source/guides/lerobot.md b/docs/source/guides/lerobot.md index eb976a5b23..95d4f1c718 100644 --- a/docs/source/guides/lerobot.md +++ b/docs/source/guides/lerobot.md @@ -41,7 +41,7 @@ arguments, seeds and fresh output directories. Smoke collection produces an unqualified corpus and is not evidence of learning acceptance. The policy observes RGB and measured joints and predicts absolute arm targets -plus a normalized gripper command. The adapter in `embodichain_models.policy.act` +plus a normalized gripper command. The adapter in `embodichain.extensions.models.policy.act` validates ordered data/control contracts. Loading uses native weights and processors together with `embodichain_act.json`; keep the complete `pretrained_model/` directory or portable development `best/` directory. diff --git a/docs/source/guides/offline_expert_datasets.md b/docs/source/guides/offline_expert_datasets.md index 0d4bcfa4fc..c29803ba4c 100644 --- a/docs/source/guides/offline_expert_datasets.md +++ b/docs/source/guides/offline_expert_datasets.md @@ -204,7 +204,7 @@ Enable the existing replay recorder when that state is needed: ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ --headless --max_episodes 1 \ --record_trajectory --trajectory_save_dir outputs/replay ``` diff --git a/docs/source/guides/policy_evaluation.md b/docs/source/guides/policy_evaluation.md index be7996e3a6..505725c721 100644 --- a/docs/source/guides/policy_evaluation.md +++ b/docs/source/guides/policy_evaluation.md @@ -163,7 +163,7 @@ headless evaluation keep their original behavior. ## Headless locomotion checkpoint example Use a checkpoint trained with the Go2 Default deployment's -`embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml`. +`embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml`. Set `go2_run` to that run's directory and `go2_checkpoint` to the specific saved checkpoint to assess. Keep the training and environment snapshots from the same run; a Newton checkpoint uses the snapshots produced by `agents/ppo.newton.yaml`. diff --git a/docs/source/guides/rlinf.md b/docs/source/guides/rlinf.md index fccaccdf50..501edbd003 100644 --- a/docs/source/guides/rlinf.md +++ b/docs/source/guides/rlinf.md @@ -46,7 +46,7 @@ deployment as the EmbodiChain CLI: - The deployment's observation and action spaces remain the source of truth; the RLinf policy dimensions and mapping must match them. -See the [task package registration contract](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_tasks/README.md#how-registration-works) +See the [task package registration contract](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/tasks/README.md#how-registration-works) for discovery and initialization details. See the {doc}`configuration guide ` for inline and componentized Gym deployment paths. @@ -55,7 +55,7 @@ The official RLinf recipe may move at a different pace from EmbodiChain. Older versions of that recipe use the retired `configs/agents/rl/basic//gym_config.json` layout. Current EmbodiChain deployments live under -`extensions/embodichain_tasks/configs/tasks///env.json` or a corresponding +`embodichain/extensions/tasks/configs/tasks///env.json` or a corresponding task deployment selected by the project configuration conventions. ## Current compatibility boundary diff --git a/docs/source/guides/robot_catalog.md b/docs/source/guides/robot_catalog.md index e8eb2df083..4ddf5852bd 100644 --- a/docs/source/guides/robot_catalog.md +++ b/docs/source/guides/robot_catalog.md @@ -3,7 +3,7 @@ Use the robot catalog to discover installed configurations before choosing a robot for a Gym task, workspace analysis, or dual-arm composition. The main -`embodichain` distribution includes the official `embodichain_robots` package. +`embodichain` distribution includes the official `embodichain.extensions.robots` package. ```bash embodichain list-robot @@ -196,11 +196,11 @@ the configuration implementation checklist. ## Import and Selector Migration -Import concrete presets from `embodichain_robots`. Generic dual-arm APIs remain +Import concrete presets from `embodichain.extensions.robots`. Generic dual-arm APIs remain in the core: ```python -from embodichain_robots import FrankaPandaCfg, URRobotCfg +from embodichain.extensions.robots import FrankaPandaCfg, URRobotCfg from embodichain.lab.sim.robots import DualArmRobotCfg, build_dual_arm_cfg from embodichain.lab.sim.robots.dual_arm import resolve_mounts ``` diff --git a/docs/source/guides/run_task.md b/docs/source/guides/run_task.md index 4c25b9a988..b2aab2613c 100644 --- a/docs/source/guides/run_task.md +++ b/docs/source/guides/run_task.md @@ -54,7 +54,7 @@ A configuration-defined Task Program deployment conventionally uses ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml ``` At startup, `run-task`: @@ -335,7 +335,7 @@ complete examples, resolution rules, and reading both levels in training. #### Run the built-in three-cycle example The shipped -`embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml` +`embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml` deployment combines a reusable physical environment with a UR5 parallel-gripper embodiment to pick up and place the same cube three times. Each cycle has a grasp segment and a placement segment, giving six lazy segments. Later calls @@ -343,7 +343,7 @@ are grounded against the scene state left by earlier calls. ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --headless \ --device cuda \ --max_episodes 1 diff --git a/docs/source/guides/task_catalog.md b/docs/source/guides/task_catalog.md index 6f8609a79b..3a9978930c 100644 --- a/docs/source/guides/task_catalog.md +++ b/docs/source/guides/task_catalog.md @@ -7,7 +7,7 @@ inspect the evidence available for it. ```bash embodichain list-task --category manipulation -embodichain show-task embodichain_tasks:repeated_pick_place +embodichain show-task embodichain.extensions.tasks:repeated_pick_place ``` `show-task` reports the task description, named deployments, robot embodiment, @@ -35,7 +35,7 @@ registries: ```bash embodichain list-task \ - --config-root embodichain_tasks=embodichain_tasks/configs/tasks \ + --config-root embodichain.extensions.tasks=embodichain/extensions/tasks/configs/tasks \ --category manipulation \ --export-html task-gallery.html ``` @@ -52,7 +52,7 @@ unavailable. The repeated-pick-place catalog is authored alongside its deployments: -```{literalinclude} ../../../embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml +```{literalinclude} ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml :language: yaml ``` @@ -71,7 +71,7 @@ Program completion, segment acceptance and dataset persistence. ```bash python -m embodichain.lab.scripts.evaluate_task_objective \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml \ --output-dir objective-run --seed 0 --num_envs 1 --headless --device cuda ``` diff --git a/docs/source/introduction.rst b/docs/source/introduction.rst index cf5086a689..de6a649f0b 100644 --- a/docs/source/introduction.rst +++ b/docs/source/introduction.rst @@ -11,9 +11,9 @@ enables rapid experimentation, seamless deployment of intelligent agents, and effective Sim2Real transfer for real-world robotic systems. Official task and robot modules live under -`extensions/ `__ and ship with the main -distribution. Their Python imports remain ``embodichain_tasks`` and -``embodichain_robots``. +`extensions/ `__ and ship with the main +distribution. Their Python imports remain ``embodichain.extensions.tasks`` and +``embodichain.extensions.robots``. .. NOTE:: EmbodiChain is in Alpha and under active development: * More diff --git a/docs/source/overview/gym/env.md b/docs/source/overview/gym/env.md index 9466c3847b..6b8cfd3150 100644 --- a/docs/source/overview/gym/env.md +++ b/docs/source/overview/gym/env.md @@ -65,7 +65,7 @@ deployment. The pure `env.yaml` has `environment_id` but no runnable `id` or Task Program fields. Ordinary component references resolve relative to the runnable config. -References beginning with `embodichain_tasks/configs/` select the imported SDK's +References beginning with `embodichain/extensions/tasks/configs/` select the imported SDK's packaged configurations, so deployments in another repository can reuse the same physical environment, embodiment or Task Program components. An existing same-named file in the working directory does not override a packaged selection. diff --git a/docs/source/overview/learning/supervised_learning.md b/docs/source/overview/learning/supervised_learning.md index 940968d91b..90d5e0e155 100644 --- a/docs/source/overview/learning/supervised_learning.md +++ b/docs/source/overview/learning/supervised_learning.md @@ -8,7 +8,7 @@ learned dynamics. It does not require a simulator or an RL environment. A model recipe defines the network, data encoding and loss. The SL layer runs that recipe without assuming an observation layout, action representation or sequence length. Shared networks live in `learning.models`; concrete models and -their recipes live in the bundled `embodichain_models` extension. +their recipes live in the bundled `embodichain.extensions.models` extension. See [Integrated models](#integrated-models) to choose a model and find its data preparation and training workflow. @@ -271,7 +271,7 @@ not establish that its data source supports exact recovery. ## Recipe factories and related workflows -Factory identifiers use the `embodichain_models.` prefix followed by the module +Factory identifiers use the `embodichain.extensions.models.` prefix followed by the module and function below, joined with `:`. | Model | Factory module / function | Model-owned behavior | diff --git a/docs/source/overview/rl/index.rst b/docs/source/overview/rl/index.rst index c147bde91e..bc26d341bb 100644 --- a/docs/source/overview/rl/index.rst +++ b/docs/source/overview/rl/index.rst @@ -70,7 +70,7 @@ Example .. code-block:: bash - embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml For more details, please refer to the source code and API documentation of each submodule. diff --git a/docs/source/overview/rl/locomotion.md b/docs/source/overview/rl/locomotion.md index 0d328ac7c4..de52c992ff 100644 --- a/docs/source/overview/rl/locomotion.md +++ b/docs/source/overview/rl/locomotion.md @@ -12,7 +12,7 @@ Locomotion environments use the same task registration, configuration loader, ac | `locomotion/velocity/microduck_flat` | `MicroDuckFlatRL-v1` | 14 / 53 / 68 | | `classic_control/humanoid` | `HumanoidRun-v1` | 17 / 63 / 63 | -Paths in this table are relative to `embodichain_tasks/configs/tasks/`. +Paths in this table are relative to `embodichain/extensions/tasks/configs/tasks/`. Each directory contains `env.yaml` and `agents/ppo.yaml` for the default backend, plus `env.newton.yaml` and `agents/ppo.newton.yaml` for Newton. Capability registration is `RL`. The six velocity task deployments declare the generic @@ -51,7 +51,7 @@ Humanoid uses clipped effort actions (`[-0.4, 0.4]`) multiplied by per-joint mot For example, the prepared Go2 training entry is: ```bash -embodichain train-rl --config embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml ``` Local smoke checks cover environment construction, stepping, finite tensors, selective reset and policy forward execution, with zero training updates. diff --git a/docs/source/overview/rl/multi_gpu.md b/docs/source/overview/rl/multi_gpu.md index f61ab51d07..811b435094 100644 --- a/docs/source/overview/rl/multi_gpu.md +++ b/docs/source/overview/rl/multi_gpu.md @@ -21,7 +21,7 @@ torchrun --nproc_per_node=2 -m embodichain train-rl --config --dis Example: ```bash -torchrun --nproc_per_node=2 -m embodichain train-rl --config embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json --distributed +torchrun --nproc_per_node=2 -m embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json --distributed ``` No config file changes needed; `device` and `gpu_id` are overridden automatically per rank. diff --git a/docs/source/overview/rl/train_script.md b/docs/source/overview/rl/train_script.md index a18979b551..7d7f81a3ba 100644 --- a/docs/source/overview/rl/train_script.md +++ b/docs/source/overview/rl/train_script.md @@ -38,9 +38,9 @@ This module provides the RL training entry script, responsible for parsing confi ## Usage Example ```bash -embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml -embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml -embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml ``` PointMass intentionally uses one differentiable PyTorch environment for both diff --git a/docs/source/overview/sim/motion/solvers/srs_solver.md b/docs/source/overview/sim/motion/solvers/srs_solver.md index 2c9e58566b..c98e9fbb03 100644 --- a/docs/source/overview/sim/motion/solvers/srs_solver.md +++ b/docs/source/overview/sim/motion/solvers/srs_solver.md @@ -14,11 +14,11 @@ SRSSolver is configured via the `SRSSolverCfg` class, allowing detailed control ```python from embodichain.data import get_data_path -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1Version, ) -from embodichain_robots.dexforce.w1.params import ( +from embodichain.extensions.robots.dexforce.w1.params import ( W1ArmKineParams, ) from embodichain.lab.sim.motion.solvers.srs_solver import SRSSolver, SRSSolverCfg diff --git a/docs/source/overview/sim/motion/solvers/ssik_solver.md b/docs/source/overview/sim/motion/solvers/ssik_solver.md index 1bdc31c7b5..ab15a7e73b 100644 --- a/docs/source/overview/sim/motion/solvers/ssik_solver.md +++ b/docs/source/overview/sim/motion/solvers/ssik_solver.md @@ -49,7 +49,7 @@ the solver configuration. import torch from embodichain.lab.sim.motion.solvers import SSIKSolverCfg -from embodichain_robots import AlohaMiniCfg +from embodichain.extensions.robots import AlohaMiniCfg device = torch.device("cpu") # Use torch.device("cuda") for CUDA execution. robot_cfg = AlohaMiniCfg.from_dict({"uid": "aloha_mini"}) @@ -356,7 +356,7 @@ from importlib.resources import files import torch from embodichain.lab.sim.motion.solvers import SSIKSolverCfg -from embodichain_robots import ARX5Cfg, FlexivRizon4SCfg +from embodichain.extensions.robots import ARX5Cfg, FlexivRizon4SCfg robot_cfg = ARX5Cfg.from_dict({}) artifact_name = "arx5.py" @@ -365,7 +365,7 @@ artifact_name = "arx5.py" # artifact_name = "flexiv_rizon4s.py" previous = robot_cfg.solver_cfg["arm"] -artifact = files("embodichain_robots").joinpath("_ssik_artifacts", artifact_name) +artifact = files("embodichain.extensions.robots").joinpath("_ssik_artifacts", artifact_name) robot_cfg.solver_cfg["arm"] = SSIKSolverCfg( backend="reference", reference_artifact=str(artifact), diff --git a/docs/source/overview/task_program/architecture.md b/docs/source/overview/task_program/architecture.md index 4bc162cf1d..96bd1c8751 100644 --- a/docs/source/overview/task_program/architecture.md +++ b/docs/source/overview/task_program/architecture.md @@ -83,7 +83,7 @@ configs are {class}`PickCfg`, {class}`PlaceCfg`, and {class}`HandOverCfg`; The complete official program (also used by the Quickstart): -```{literalinclude} ../../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml +```{literalinclude} ../../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml :language: yaml ``` @@ -218,7 +218,7 @@ profile: The abbreviated profile mappings above must be populated for the calls used by the program. See `envs/default.yaml`, `task.ur5.yaml`, and `task_program/integration.yaml` under -`embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/` for the +`embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/` for the complete reference composition. Scene affordances are authored as children of their owning entry in diff --git a/docs/source/overview/task_program/index.md b/docs/source/overview/task_program/index.md index b832ff82c4..ac4f34af2d 100644 --- a/docs/source/overview/task_program/index.md +++ b/docs/source/overview/task_program/index.md @@ -34,7 +34,7 @@ supplies the scene, robot, available calls and execution settings. The {doc}`quickstart` uses `repeated_pick_place/task.franka.yaml`, a single Franka Panda in the Default physics environment, without trajectory expansion. The complete original file is available as a -{download}`download <../../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml>`. +{download}`download <../../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml>`. ## What do I need? diff --git a/docs/source/overview/task_program/quickstart.md b/docs/source/overview/task_program/quickstart.md index 6caf1b315d..493f79c30a 100644 --- a/docs/source/overview/task_program/quickstart.md +++ b/docs/source/overview/task_program/quickstart.md @@ -20,7 +20,7 @@ Run these commands from your own working directory: mkdir -p task-program-quickstart cd task-program-quickstart embodichain list-task --category manipulation -embodichain show-task embodichain_tasks:repeated_pick_place +embodichain show-task embodichain.extensions.tasks:repeated_pick_place ``` Find `franka: TaskProgramRepeatedPickPlace-Franka-v1` in the detailed output. @@ -50,7 +50,7 @@ See {doc}`/guides/run_task` for display and replay options. ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ --physics default --num_envs 1 --max_episodes 1 --seed 7 \ --headless --filter_dataset_saving ``` @@ -105,7 +105,7 @@ that data was saved. ## 3. Download and change the program Download the -{download}`original program <../../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml>` +{download}`original program <../../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml>` and save it as **`program.yaml`** in your working directory. Change: 1. `program.repeat.count` from `3` to `2`. @@ -123,7 +123,7 @@ Run your local file with the same deployment: ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ --physics default --num_envs 1 --max_episodes 1 --seed 7 \ --headless --filter_dataset_saving --task-program program.yaml ``` @@ -185,7 +185,7 @@ choose an explicit output directory: ```bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ --physics default --num_envs 1 --max_episodes 1 --seed 7 \ --headless --task-program program.yaml --dataset-dir "$PWD/datasets" ``` diff --git a/docs/source/overview/task_program/recipes.md b/docs/source/overview/task_program/recipes.md index b432e2ea03..fc106f6fdd 100644 --- a/docs/source/overview/task_program/recipes.md +++ b/docs/source/overview/task_program/recipes.md @@ -118,7 +118,7 @@ These checks do not independently prove grasp contact or release. **Edit location:** the **execution-policy component selected by the deployment**, not the program YAML. The Quickstart policy uses these actual fields: -```{literalinclude} ../../../../extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml +```{literalinclude} ../../../../embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml :language: yaml ``` diff --git a/docs/source/overview/task_program/troubleshooting.md b/docs/source/overview/task_program/troubleshooting.md index c33d985590..5847437518 100644 --- a/docs/source/overview/task_program/troubleshooting.md +++ b/docs/source/overview/task_program/troubleshooting.md @@ -19,7 +19,7 @@ alone is not proof of its listed possible causes. component paths resolve relative to the deployment file. A physical environment component by itself is not a runnable deployment. -**Diagnose:** rerun `embodichain show-task embodichain_tasks:repeated_pick_place` +**Diagnose:** rerun `embodichain show-task embodichain.extensions.tasks:repeated_pick_place` and compare its deployment with the Quickstart's complete package reference. Check that the downloaded file is YAML rather than an HTML error page. For a local deployment, inspect its `environment`, `embodiment`, and `task_program` diff --git a/docs/source/overview/task_program/validation.md b/docs/source/overview/task_program/validation.md index ad7a2f096d..2f75f03a85 100644 --- a/docs/source/overview/task_program/validation.md +++ b/docs/source/overview/task_program/validation.md @@ -14,7 +14,7 @@ all Task Program tasks, robots, seeds or physics backends. | CLI | `embodichain run-env`; `run-task` exists as an alias at this baseline | | Runtime | Python 3.11.14, Linux, DexSim `0.5.1rc1`, Warp `1.17.0`, Newton dependency `1.6.0` | | GPU | NVIDIA RTX PRO 5000 72 GB Blackwell; driver `580.126.20`; PyTorch `2.7.0+cu128`; one GPU selected with `CUDA_VISIBLE_DEVICES=1` | -| Deployment | `embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml` | +| Deployment | `embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml` | | Physics / execution | Default; `trajectory_open_loop.yaml`; `effect_assurance: projected` | | Selection | Seed 7, one environment, one episode, no expansion | | User directory | Empty directory outside the repository; installed package deployment plus local program overrides | @@ -73,7 +73,7 @@ simulator: ```bash python .agents/skills/add-task-program/scripts/inspect_deployment.py \ - extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ + embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml \ --json ``` diff --git a/docs/source/quick_start/install.md b/docs/source/quick_start/install.md index 9749789bd4..b65e4617fe 100644 --- a/docs/source/quick_start/install.md +++ b/docs/source/quick_start/install.md @@ -230,22 +230,22 @@ This pulls in `dexsim_engine` (Python package `dexsim`) and the rest of the core ### 3. Official task environments The main `embodichain` distribution includes the official task environments as -the `embodichain_tasks` import package, together with their JSON/YAML configs. +the `embodichain.extensions.tasks` import package, together with their JSON/YAML configs. Both a published-wheel install and `pip install -e .` register the `embodichain.tasks` entry point automatically; do not install -`embodichain_tasks/` separately. +`embodichain/extensions/tasks/` separately. -If an older checkout was installed with `pip install -e embodichain_tasks/`, +If an older checkout was installed with `pip install -e embodichain/extensions/tasks/`, remove that legacy editable distribution once before reinstalling the main project: ```bash -pip uninstall -y embodichain_tasks +pip uninstall -y embodichain.extensions.tasks pip install -e . ``` Commands can continue to use repository-style paths such as -`embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml`. +`embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml`. EmbodiChain resolves these paths from the checkout when present and otherwise from the installed wheel. diff --git a/docs/source/resources/publications/README.md b/docs/source/resources/publications/README.md index 3c4564b37d..ce66295c34 100644 --- a/docs/source/resources/publications/README.md +++ b/docs/source/resources/publications/README.md @@ -42,13 +42,13 @@ This page contains bibliographic information for academic papers and competition **Examples:** -- **PointMass APG training:** [Training configuration](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml) and [differentiable environment](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_tasks/embodichain_tasks/classic_control/point_mass.py). Run the configuration with: +- **PointMass APG training:** [Training configuration](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml) and [differentiable environment](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/tasks/classic_control/point_mass.py). Run the configuration with: ```bash - embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml ``` -- **Franka FR3 differentiable kinematics:** [Reference environment](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_tasks/embodichain_tasks/special/franka_reach_apg.py), demonstrating the Warp-tape / PyTorch-autograd bridge through forward kinematics and reward kernels. +- **Franka FR3 differentiable kinematics:** [Reference environment](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/tasks/special/franka_reach_apg.py), demonstrating the Warp-tape / PyTorch-autograd bridge through forward kinematics and reward kernels. ```bibtex @article{deng2026backpropagating, diff --git a/docs/source/resources/robot/agibot/g2.md b/docs/source/resources/robot/agibot/g2.md index 1a65ebccc8..da6c70ad78 100644 --- a/docs/source/resources/robot/agibot/g2.md +++ b/docs/source/resources/robot/agibot/g2.md @@ -40,7 +40,7 @@ robot = sim.add_robot(cfg) ```bash embodichain preview-robot --robot AgibotG2 --viser -python -m embodichain_robots.agibot.g2._preview --output g2-render.png +python -m embodichain.extensions.robots.agibot.g2._preview --output g2-render.png ``` The rendering command also writes `g2-render.render.json` with the capture diff --git a/docs/source/resources/robot/agibot/index.rst b/docs/source/resources/robot/agibot/index.rst index 6c914fd722..205757717e 100644 --- a/docs/source/resources/robot/agibot/index.rst +++ b/docs/source/resources/robot/agibot/index.rst @@ -2,7 +2,7 @@ AgiBot ====== Official AgiBot robot configurations live in the -``embodichain_robots.agibot`` manufacturer namespace. +``embodichain.extensions.robots.agibot`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/agilex/cobotmagic.md b/docs/source/resources/robot/agilex/cobotmagic.md index 0f5ff7a05d..64e50289b6 100644 --- a/docs/source/resources/robot/agilex/cobotmagic.md +++ b/docs/source/resources/robot/agilex/cobotmagic.md @@ -52,7 +52,7 @@ camera, lighting and joint settings are recorded in the ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg config = SimulationManagerCfg(headless=False, device="cpu", num_envs=2) sim = SimulationManager(config) @@ -79,7 +79,7 @@ sim.update(step=1) ### 2. Custom Usage Example ```python -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg custom_cfg = { "init_pos": [0.0, 0.0, 1.0], # Initial position diff --git a/docs/source/resources/robot/agilex/cobotmagic_gripper.md b/docs/source/resources/robot/agilex/cobotmagic_gripper.md index 72fb130f86..9622cfcbc1 100644 --- a/docs/source/resources/robot/agilex/cobotmagic_gripper.md +++ b/docs/source/resources/robot/agilex/cobotmagic_gripper.md @@ -8,7 +8,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import CobotMagicV100GripperCfg +from embodichain.extensions.robots import CobotMagicV100GripperCfg cfg = CobotMagicV100GripperCfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/agilex/index.rst b/docs/source/resources/robot/agilex/index.rst index 363b5d6e37..ae2398306e 100644 --- a/docs/source/resources/robot/agilex/index.rst +++ b/docs/source/resources/robot/agilex/index.rst @@ -2,7 +2,7 @@ AgileX ====== Official AgileX robot configurations live in the -``embodichain_robots.agilex`` manufacturer namespace. +``embodichain.extensions.robots.agilex`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/agilex/pika.md b/docs/source/resources/robot/agilex/pika.md index 1e5acec674..da8a25fd08 100644 --- a/docs/source/resources/robot/agilex/pika.md +++ b/docs/source/resources/robot/agilex/pika.md @@ -19,7 +19,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.agilex.pika.assets import PikaGripper +from embodichain.extensions.robots.agilex.pika.assets import PikaGripper ``` Use the stable asset reference for normal loading: @@ -84,12 +84,12 @@ new Pika-specific W1 catalog variant. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/agilex/pika/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/agilex/pika/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/agilex/pika/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/agilex/pika/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's @@ -103,7 +103,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import PikaGripperCfg +from embodichain.extensions.robots import PikaGripperCfg cfg = PikaGripperCfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/agilex/piper_x.md b/docs/source/resources/robot/agilex/piper_x.md index a60d54e3b1..51a9a9ccd2 100644 --- a/docs/source/resources/robot/agilex/piper_x.md +++ b/docs/source/resources/robot/agilex/piper_x.md @@ -22,7 +22,7 @@ embodichain preview-robot --robot AgilexPiperX ``` ```python -from embodichain_robots import AgilexPiperXCfg +from embodichain.extensions.robots import AgilexPiperXCfg cfg = AgilexPiperXCfg.from_dict({}) ``` @@ -36,7 +36,7 @@ Download the `AgxGripper` asset separately with mimic joints. Select `configs/components/embodiments/piper_x_agx_gripper.yaml` from the -`embodichain_tasks` extension as a deployment's embodiment component. +`embodichain.extensions.tasks` extension as a deployment's embodiment component. It places the tool 4.5 mm along flange Z with a +90° rotation about that axis, following the [official assembly Xacro](https://github.com/agilexrobotics/agx_arm_urdf/blob/680fa925cd00db7e2628563d2edc5540963045de/piper_x/urdf/piper_x_with_gripper_description.xacro#L49-L53). The embodiment configures the `eef` control group and locates the arm TCP diff --git a/docs/source/resources/robot/alohamini/aloha_mini.md b/docs/source/resources/robot/alohamini/aloha_mini.md index 818d75cd11..7c10a2319c 100644 --- a/docs/source/resources/robot/alohamini/aloha_mini.md +++ b/docs/source/resources/robot/alohamini/aloha_mini.md @@ -21,7 +21,7 @@ camera, lighting and joint settings are recorded in the ::: ```python -from embodichain_robots import AlohaMiniCfg +from embodichain.extensions.robots import AlohaMiniCfg cfg = AlohaMiniCfg.from_dict({"uid": "aloha_mini"}) robot = sim.add_robot(cfg=cfg) @@ -53,7 +53,7 @@ arm chains describe the grasp TCPs. Run a headless construction smoke check with: ```bash -python -m embodichain_robots.alohamini.aloha_mini.cfg --headless --device cpu +python -m embodichain.extensions.robots.alohamini.aloha_mini.cfg --headless --device cpu ``` Omit `--headless` for the interactive simulation window. Select the physics diff --git a/docs/source/resources/robot/alohamini/index.rst b/docs/source/resources/robot/alohamini/index.rst index 1e78f323b0..0b680d01df 100644 --- a/docs/source/resources/robot/alohamini/index.rst +++ b/docs/source/resources/robot/alohamini/index.rst @@ -2,7 +2,7 @@ AlohaMini ========= The AlohaMini community project uses the -``embodichain_robots.alohamini`` namespace. Its manufacturer is currently +``embodichain.extensions.robots.alohamini`` namespace. Its manufacturer is currently unknown in the robot catalog. .. list-table:: diff --git a/docs/source/resources/robot/anybotics/anymal_c.md b/docs/source/resources/robot/anybotics/anymal_c.md index 8a9a9bebcf..ef1ba63cfd 100644 --- a/docs/source/resources/robot/anybotics/anymal_c.md +++ b/docs/source/resources/robot/anybotics/anymal_c.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import ANYmalCCfg +from embodichain.extensions.robots import ANYmalCCfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = ANYmalCCfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot ANYmalC | --- | --- | | Catalog ID / UID | `ANYmalC` | | Configuration class | `ANYmalCCfg` | -| Canonical module | `embodichain_robots.anybotics.anymal_c` | +| Canonical module | `embodichain.extensions.robots.anybotics.anymal_c` | | Vendor | `anybotics` | | Morphology | `quadruped` | | Arm count | 0 | diff --git a/docs/source/resources/robot/anybotics/index.rst b/docs/source/resources/robot/anybotics/index.rst index 87bc3c52dc..a502a3267f 100644 --- a/docs/source/resources/robot/anybotics/index.rst +++ b/docs/source/resources/robot/anybotics/index.rst @@ -2,7 +2,7 @@ ANYbotics ========= Robot configurations for ANYbotics live in the -``embodichain_robots.anybotics`` manufacturer namespace. +``embodichain.extensions.robots.anybotics`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/arx/arx5.md b/docs/source/resources/robot/arx/arx5.md index 14742eabd6..a324a4e759 100644 --- a/docs/source/resources/robot/arx/arx5.md +++ b/docs/source/resources/robot/arx/arx5.md @@ -1,7 +1,7 @@ # ARX5 X5A -`embodichain_robots.ARX5Cfg` configures the bundled `ARX5/X5A.urdf` asset. -Its implementation lives in `extensions/embodichain_robots/arx/arx5/cfg.py`, and the +`embodichain.extensions.robots.ARX5Cfg` configures the bundled `ARX5/X5A.urdf` asset. +Its implementation lives in `embodichain/extensions/robots/arx/arx5/cfg.py`, and the bundled robot catalog registers it as `ARX5`. The package exports the class lazily; listing the catalog does not load the asset or simulation runtime. @@ -41,7 +41,7 @@ There are eight independent controlled joints. `init_qpos` follows source order: the six arm joints, then the two fingers. ```python -from embodichain_robots import ARX5Cfg +from embodichain.extensions.robots import ARX5Cfg cfg = ARX5Cfg.from_dict({}) robot = sim.add_robot(cfg=cfg) diff --git a/docs/source/resources/robot/arx/index.rst b/docs/source/resources/robot/arx/index.rst index dff081f9db..cfa42fa42b 100644 --- a/docs/source/resources/robot/arx/index.rst +++ b/docs/source/resources/robot/arx/index.rst @@ -2,7 +2,7 @@ ARX === Official ARX robot configurations live in the -``embodichain_robots.arx`` manufacturer namespace. +``embodichain.extensions.robots.arx`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/brainco/index.rst b/docs/source/resources/robot/brainco/index.rst index 8f0f64da63..2bf2e8d08c 100644 --- a/docs/source/resources/robot/brainco/index.rst +++ b/docs/source/resources/robot/brainco/index.rst @@ -2,7 +2,7 @@ BrainCo ======== Model-owned assets and any standalone configurations live under -``embodichain_robots.brainco``. Asset availability does not imply a +``embodichain.extensions.robots.brainco``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/brainco/revo1.md b/docs/source/resources/robot/brainco/revo1.md index ea0291ff6c..95ee0b74a3 100644 --- a/docs/source/resources/robot/brainco/revo1.md +++ b/docs/source/resources/robot/brainco/revo1.md @@ -1,6 +1,6 @@ # BrainCo Revo 1 -`embodichain_robots.BrainCoRevo1Cfg` configures a standalone left or right +`embodichain.extensions.robots.BrainCoRevo1Cfg` configures a standalone left or right BrainCo Revo 1 hand. The catalog ID is `BrainCoRevo1`; `left` and `right` variants select the native hand asset, with right as the default. @@ -29,7 +29,7 @@ Given an existing `SimulationManager` instance named `sim`: ```python from embodichain.robot_registry import resolve_robot_cfg -from embodichain_robots import BrainCoRevo1Cfg +from embodichain.extensions.robots import BrainCoRevo1Cfg cfg = resolve_robot_cfg("BrainCoRevo1", variant="left") # Equivalent native side selection: @@ -92,7 +92,7 @@ replace these simulation settings. ## Shared model and W1 mounting The asset class is -`embodichain_robots.brainco.revo1.assets.BrainCoHandRevo1`. Its shared archive +`embodichain.extensions.robots.brainco.revo1.assets.BrainCoHandRevo1`. Its shared archive contains both `BrainCoLeftHand/BrainCoLeftHand.urdf` and `BrainCoRightHand/BrainCoRightHand.urdf`. Stable references remain: @@ -115,5 +115,5 @@ model definition. The [BrainCo product documentation](https://www.brainco-hz.com/docs/revolimb-hand/revo1/parameters.html) confirms product affiliation. The exact packaged CAD release, original author, upstream revision and asset license remain unverified. See the -[archive-specific source record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/brainco/revo1/README.md) +[archive-specific source record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/brainco/revo1/README.md) for the download digest, inspection evidence and pending questions. diff --git a/docs/source/resources/robot/changingtek/ctm2f110.md b/docs/source/resources/robot/changingtek/ctm2f110.md index f33e7fb5d2..8de03e644d 100644 --- a/docs/source/resources/robot/changingtek/ctm2f110.md +++ b/docs/source/resources/robot/changingtek/ctm2f110.md @@ -19,7 +19,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.changingtek.ctm2f110.assets import ZH_CTM2F110 +from embodichain.extensions.robots.changingtek.ctm2f110.assets import ZH_CTM2F110 ``` Use the stable asset reference for normal loading: @@ -42,12 +42,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/changingtek/ctm2f110/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/changingtek/ctm2f110/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/changingtek/ctm2f110/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/changingtek/ctm2f110/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/changingtek/index.rst b/docs/source/resources/robot/changingtek/index.rst index c5c3eb1e05..68177fb548 100644 --- a/docs/source/resources/robot/changingtek/index.rst +++ b/docs/source/resources/robot/changingtek/index.rst @@ -2,7 +2,7 @@ ChangingTek =========== Model-owned assets and any standalone configurations live under -``embodichain_robots.changingtek``. Asset availability does not imply a +``embodichain.extensions.robots.changingtek``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/dexforce/index.rst b/docs/source/resources/robot/dexforce/index.rst index bd58cae391..b694136376 100644 --- a/docs/source/resources/robot/dexforce/index.rst +++ b/docs/source/resources/robot/dexforce/index.rst @@ -2,7 +2,7 @@ DexForce ======== Official DexForce robot configurations live in the -``embodichain_robots.dexforce`` manufacturer namespace. W1 body releases and +``embodichain.extensions.robots.dexforce`` manufacturer namespace. W1 body releases and end-effector options are documented together on the model page. .. list-table:: diff --git a/docs/source/resources/robot/dexforce/w1.md b/docs/source/resources/robot/dexforce/w1.md index 97eaab910a..2f1f95d552 100644 --- a/docs/source/resources/robot/dexforce/w1.md +++ b/docs/source/resources/robot/dexforce/w1.md @@ -61,7 +61,7 @@ robot = sim.add_robot(cfg=cfg) Use `DexforceW1Cfg.from_dict` when customizing the end effectors: ```python -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg cfg = DexforceW1Cfg.from_dict( { @@ -160,13 +160,13 @@ an existing assembled robot after a visual-only update, set are rebuilt. Body assets, solvers and mounting offsets are registered in -`embodichain_robots/dexforce/w1/specs.py`; external hand assets and transforms +`embodichain/extensions/robots/dexforce/w1/specs.py`; external hand assets and transforms are registered independently in `hand_specs.py`. ## Shared end-effector model ownership BrainCo Revo 1 and DH PGC-140-50 native asset specifications belong to their -manufacturer/model packages in `embodichain_robots`. W1's hand adapter consumes +manufacturer/model packages in `embodichain.extensions.robots`. W1's hand adapter consumes those definitions and retains installation transforms, body revision offsets, assembled naming, control groups and W1-specific drive calibration. Its existing hand selection/version fields and serialization behavior are preserved. diff --git a/docs/source/resources/robot/dh_robotics/ag95.md b/docs/source/resources/robot/dh_robotics/ag95.md index f822854874..9c074de994 100644 --- a/docs/source/resources/robot/dh_robotics/ag95.md +++ b/docs/source/resources/robot/dh_robotics/ag95.md @@ -23,7 +23,7 @@ materials are preserved; the exact settings are recorded in each manifest. Canonical download-class import: ```python -from embodichain_robots.dh_robotics.ag95.assets import DH_AG95 +from embodichain.extensions.robots.dh_robotics.ag95.assets import DH_AG95 ``` Use the stable asset reference for normal loading: @@ -46,12 +46,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/dh_robotics/ag95/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/dh_robotics/ag95/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/dh_robotics/ag95/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/dh_robotics/ag95/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/dh_robotics/index.rst b/docs/source/resources/robot/dh_robotics/index.rst index 868d098ba5..4efd0e6834 100644 --- a/docs/source/resources/robot/dh_robotics/index.rst +++ b/docs/source/resources/robot/dh_robotics/index.rst @@ -2,7 +2,7 @@ DH-Robotics =========== Model-owned assets and any standalone configurations live under -``embodichain_robots.dh_robotics``. Asset availability does not imply a +``embodichain.extensions.robots.dh_robotics``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/dh_robotics/pgc_140_50.md b/docs/source/resources/robot/dh_robotics/pgc_140_50.md index 740e6ac376..bee46e86f4 100644 --- a/docs/source/resources/robot/dh_robotics/pgc_140_50.md +++ b/docs/source/resources/robot/dh_robotics/pgc_140_50.md @@ -26,7 +26,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50, DH_PGC_140_50_M +from embodichain.extensions.robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50, DH_PGC_140_50_M ``` Use the stable asset reference for normal loading: @@ -49,12 +49,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/dh_robotics/pgc_140_50/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/dh_robotics/pgc_140_50/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/dh_robotics/pgc_140_50/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/dh_robotics/pgc_140_50/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/dh_robotics/pgi_140_80.md b/docs/source/resources/robot/dh_robotics/pgi_140_80.md index 9f19d4c588..cdd8136d25 100644 --- a/docs/source/resources/robot/dh_robotics/pgi_140_80.md +++ b/docs/source/resources/robot/dh_robotics/pgi_140_80.md @@ -19,7 +19,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.dh_robotics.pgi_140_80.assets import DH_PGI_140_80 +from embodichain.extensions.robots.dh_robotics.pgi_140_80.assets import DH_PGI_140_80 ``` Use the stable asset reference for normal loading: @@ -42,12 +42,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/dh_robotics/pgi_140_80/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/dh_robotics/pgi_140_80/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/dh_robotics/pgi_140_80/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/dh_robotics/pgi_140_80/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's @@ -61,7 +61,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import DHPGI14080Cfg +from embodichain.extensions.robots import DHPGI14080Cfg cfg = DHPGI14080Cfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/dual_arm.md b/docs/source/resources/robot/dual_arm.md index 0a70d081b0..b38527990c 100644 --- a/docs/source/resources/robot/dual_arm.md +++ b/docs/source/resources/robot/dual_arm.md @@ -116,7 +116,7 @@ applies the `left_` / `right_` prefixes consistently with the assembled URDF. ## Programmatic Build Path ```python -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.lab.sim.robots.dual_arm import build_dual_arm_cfg, resolve_mounts base = URRobotCfg.from_dict({"robot_type": "ur5"}) @@ -130,7 +130,7 @@ A single-arm robot becomes dual-arm-ready by: 1. following the existing `"arm"` convention in its single-arm cfg, 2. exposing `control_parts["arm"]` and `solver_cfg["arm"]`, -3. registering its ID in `embodichain_robots/_catalog.py` or an installed +3. registering its ID in `embodichain/extensions/robots/_catalog.py` or an installed `embodichain.robots` catalog, 4. declaring `supports_dual_arm=True` in its catalog metadata to advertise the base in `list-robot`. diff --git a/docs/source/resources/robot/end_effectors.md b/docs/source/resources/robot/end_effectors.md index 19ef0bfd58..780c919f6b 100644 --- a/docs/source/resources/robot/end_effectors.md +++ b/docs/source/resources/robot/end_effectors.md @@ -1,7 +1,7 @@ # End-effector assets and migration Concrete hand and gripper assets live beside other robot models in -`embodichain_robots`, under their manufacturer/model namespace. `Robot` describes +`embodichain.extensions.robots`, under their manufacturer/model namespace. `Robot` describes an independently controlled runtime entity; EEF describes a role in an assembly. The same BrainCo hand model therefore serves its standalone preset and W1 mounts. The core continues to own downloads, caches, generic configuration and runtime @@ -17,20 +17,20 @@ asset ID. No compatibility forwarding module is provided. | Asset ID / class | Canonical import module | Resource page | | --- | --- | --- | -| `DH_PGC_140_50` | `embodichain_robots.dh_robotics.pgc_140_50.assets` | [PGC-140-50](dh_robotics/pgc_140_50.md) | -| `DH_PGC_140_50_M` | `embodichain_robots.dh_robotics.pgc_140_50.assets` | [PGC modification](dh_robotics/pgc_140_50.md) | -| `DH_PGI_140_80` | `embodichain_robots.dh_robotics.pgi_140_80.assets` | [PGI-140-80](dh_robotics/pgi_140_80.md) | -| `DH_AG95` | `embodichain_robots.dh_robotics.ag95.assets` | [AG95 modification](dh_robotics/ag95.md) | -| `ZH_CTM2F110` | `embodichain_robots.changingtek.ctm2f110.assets` | [CTM2F110](changingtek/ctm2f110.md) | -| `BrainCoHandRevo1` | `embodichain_robots.brainco.revo1.assets` | [Revo 1](brainco/revo1.md) | -| `InspireHand` | `embodichain_robots.inspire.hand.assets` | [INSPIRE hand](inspire/hand.md) | -| `Robotiq` | `embodichain_robots.robotiq.assets` | [Shared Robotiq archive](robotiq/assets.md) | -| `Robotiq2F85` | `embodichain_robots.robotiq.robotiq_2f85.assets` | [Separate 2F-85 archive](robotiq/robotiq_2f85.md) | -| `WheelTecFA2F` | `embodichain_robots.wheeltec.fa2f.assets` | [FA2F asset](wheeltec/fa2f.md) | -| `AgxGripper` | `embodichain_robots.agilex.agx_gripper.assets` | [AgileX PiPER-X and AGX](agilex/piper_x.md) | -| `PikaGripper` | `embodichain_robots.agilex.pika.assets` | [AgileX Pika](agilex/pika.md) | -| `WujiHand` | `embodichain_robots.wuji.hand.assets` | [Wuji Hand](wuji/hand.md) | -| `SharpaWave` | `embodichain_robots.sharpa.wave.assets` | [Sharpa Wave 01](sharpa/wave.md) | +| `DH_PGC_140_50` | `embodichain.extensions.robots.dh_robotics.pgc_140_50.assets` | [PGC-140-50](dh_robotics/pgc_140_50.md) | +| `DH_PGC_140_50_M` | `embodichain.extensions.robots.dh_robotics.pgc_140_50.assets` | [PGC modification](dh_robotics/pgc_140_50.md) | +| `DH_PGI_140_80` | `embodichain.extensions.robots.dh_robotics.pgi_140_80.assets` | [PGI-140-80](dh_robotics/pgi_140_80.md) | +| `DH_AG95` | `embodichain.extensions.robots.dh_robotics.ag95.assets` | [AG95 modification](dh_robotics/ag95.md) | +| `ZH_CTM2F110` | `embodichain.extensions.robots.changingtek.ctm2f110.assets` | [CTM2F110](changingtek/ctm2f110.md) | +| `BrainCoHandRevo1` | `embodichain.extensions.robots.brainco.revo1.assets` | [Revo 1](brainco/revo1.md) | +| `InspireHand` | `embodichain.extensions.robots.inspire.hand.assets` | [INSPIRE hand](inspire/hand.md) | +| `Robotiq` | `embodichain.extensions.robots.robotiq.assets` | [Shared Robotiq archive](robotiq/assets.md) | +| `Robotiq2F85` | `embodichain.extensions.robots.robotiq.robotiq_2f85.assets` | [Separate 2F-85 archive](robotiq/robotiq_2f85.md) | +| `WheelTecFA2F` | `embodichain.extensions.robots.wheeltec.fa2f.assets` | [FA2F asset](wheeltec/fa2f.md) | +| `AgxGripper` | `embodichain.extensions.robots.agilex.agx_gripper.assets` | [AgileX PiPER-X and AGX](agilex/piper_x.md) | +| `PikaGripper` | `embodichain.extensions.robots.agilex.pika.assets` | [AgileX Pika](agilex/pika.md) | +| `WujiHand` | `embodichain.extensions.robots.wuji.hand.assets` | [Wuji Hand](wuji/hand.md) | +| `SharpaWave` | `embodichain.extensions.robots.sharpa.wave.assets` | [Sharpa Wave 01](sharpa/wave.md) | The existing asset IDs, class names, archive URLs, checksum validation and cache prefixes are preserved. All entries remain in the `eef` data category and use @@ -39,7 +39,7 @@ and official Hub fallback order. Catalog discovery does not construct datasets. ```python from embodichain.data import get_data_path -from embodichain_robots.agilex.pika.assets import PikaGripper +from embodichain.extensions.robots.agilex.pika.assets import PikaGripper # Existing references still work; no cache migration is required. urdf_path = get_data_path("PikaGripper/PikaGripper.urdf") diff --git a/docs/source/resources/robot/flexiv/index.rst b/docs/source/resources/robot/flexiv/index.rst index 61c91e2caf..69019e61c1 100644 --- a/docs/source/resources/robot/flexiv/index.rst +++ b/docs/source/resources/robot/flexiv/index.rst @@ -2,7 +2,7 @@ Flexiv ====== Official Flexiv robot configurations live in the -``embodichain_robots.flexiv`` manufacturer namespace. +``embodichain.extensions.robots.flexiv`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/flexiv/rizon4s.md b/docs/source/resources/robot/flexiv/rizon4s.md index 1fdfe718ec..79b465af16 100644 --- a/docs/source/resources/robot/flexiv/rizon4s.md +++ b/docs/source/resources/robot/flexiv/rizon4s.md @@ -17,7 +17,7 @@ settings are recorded in the [render manifest](../../../_static/robots/flexiv_ri ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import FlexivRizon4SCfg +from embodichain.extensions.robots import FlexivRizon4SCfg sim = SimulationManager(SimulationManagerCfg(headless=True)) try: diff --git a/docs/source/resources/robot/franka/cfg.md b/docs/source/resources/robot/franka/cfg.md index cb43f9e861..944d1991db 100644 --- a/docs/source/resources/robot/franka/cfg.md +++ b/docs/source/resources/robot/franka/cfg.md @@ -22,7 +22,7 @@ The original Panda variant is selected separately through `arm_model` below. ## Construction and preview ```python -from embodichain_robots import FrankaCfg +from embodichain.extensions.robots import FrankaCfg arm = FrankaCfg.from_dict({}) # FR3 by default panda_arm = FrankaCfg.from_dict({"arm_model": "panda"}) @@ -78,7 +78,7 @@ original asset directory so relative mesh paths remain valid. The Robotiq assembly retains its qualified asset, component order and assembly name. The separate `Robotiq2F85` archive is a different model identity and is not substituted. Opening conversion remains available from -`embodichain_robots.robotiq.two_finger.robotiq85_joint_positions`. +`embodichain.extensions.robots.robotiq.two_finger.robotiq85_joint_positions`. ## Migration diff --git a/docs/source/resources/robot/franka/hand.md b/docs/source/resources/robot/franka/hand.md index 2f13148e62..1d1abc7835 100644 --- a/docs/source/resources/robot/franka/hand.md +++ b/docs/source/resources/robot/franka/hand.md @@ -8,7 +8,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import FrankaPandaHandCfg +from embodichain.extensions.robots import FrankaPandaHandCfg cfg = FrankaPandaHandCfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/franka/index.rst b/docs/source/resources/robot/franka/index.rst index 485ad8cdfd..0242c9d778 100644 --- a/docs/source/resources/robot/franka/index.rst +++ b/docs/source/resources/robot/franka/index.rst @@ -2,7 +2,7 @@ Franka ====== Official Franka robot configurations live in the -``embodichain_robots.franka`` manufacturer namespace. +``embodichain.extensions.robots.franka`` manufacturer namespace. ``Franka`` is the unified bare-arm catalog entry. ``FrankaPanda`` preserves the historical FR3 selector; native-hand task deployments select an explicit embodiment component. diff --git a/docs/source/resources/robot/franka/panda.md b/docs/source/resources/robot/franka/panda.md index a6198a49c4..4ca961336d 100644 --- a/docs/source/resources/robot/franka/panda.md +++ b/docs/source/resources/robot/franka/panda.md @@ -13,7 +13,7 @@ See [Franka configuration](cfg.md) for arm selection, assembly and migration. ## Bare compatibility constructor ```python -from embodichain_robots import FrankaPandaCfg +from embodichain.extensions.robots import FrankaPandaCfg cfg = FrankaPandaCfg.from_dict({"robot_type": "panda"}) robot = sim.add_robot(cfg=cfg) @@ -47,7 +47,7 @@ For standalone construction, load that component through the public catalog: ```python from embodichain.robot_registry import resolve_robot_cfg from embodichain.utils.utility import load_config -from embodichain_tasks.configs import get_config_path +from embodichain.extensions.tasks.configs import get_config_path fields = load_config(get_config_path("components/embodiments/franka_panda.yaml"))[ "simulation" @@ -62,7 +62,7 @@ belong to the component, while `FrankaPandaCfg` remains the bare-arm compatibility selector. ```{eval-rst} -.. py:class:: embodichain_robots.franka.panda.FrankaPandaCfg +.. py:class:: embodichain.extensions.robots.franka.panda.FrankaPandaCfg Legacy FR3 arm selector. The inherited ``from_dict()`` and ``build_pk_serial_chain()`` use the bare seven-joint arm and flange TCP. diff --git a/docs/source/resources/robot/i2rt/index.rst b/docs/source/resources/robot/i2rt/index.rst index 44dc2a72d2..cd05f10db1 100644 --- a/docs/source/resources/robot/i2rt/index.rst +++ b/docs/source/resources/robot/i2rt/index.rst @@ -2,7 +2,7 @@ I2RT Robotics ============= Official I2RT robot configurations live in the -``embodichain_robots.i2rt`` manufacturer namespace. +``embodichain.extensions.robots.i2rt`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/i2rt/yam.md b/docs/source/resources/robot/i2rt/yam.md index 31b275cc08..48e5ade213 100644 --- a/docs/source/resources/robot/i2rt/yam.md +++ b/docs/source/resources/robot/i2rt/yam.md @@ -1,8 +1,8 @@ # YAM dual arms -`embodichain_robots.YamI2rtCfg` configures the converted I2RT YAM dual-arm +`embodichain.extensions.robots.YamI2rtCfg` configures the converted I2RT YAM dual-arm assembly. Its implementation and asset definition live together in -`embodichain_robots.i2rt.yam`; the robot catalog ID is `YamI2rt`. +`embodichain.extensions.robots.i2rt.yam`; the robot catalog ID is `YamI2rt`. Catalog listing reads metadata without loading the model or downloading assets. :::{figure} ../../../_static/robots/yam_i2rt.png @@ -23,7 +23,7 @@ and [gripper](../../../_static/robots/yam_i2rt_gripper.render.json). ```python from embodichain.robot_registry import resolve_robot_cfg -from embodichain_robots import YamI2rtCfg +from embodichain.extensions.robots import YamI2rtCfg cfg = resolve_robot_cfg("YamI2rt") restored = YamI2rtCfg.from_dict(cfg.to_dict()) diff --git a/docs/source/resources/robot/index.rst b/docs/source/resources/robot/index.rst index 3959300abd..b1ab3c33c6 100644 --- a/docs/source/resources/robot/index.rst +++ b/docs/source/resources/robot/index.rst @@ -3,7 +3,7 @@ Supported Robots EmbodiChain provides configuration classes for the robot families and composed layouts below. Concrete robots follow their manufacturer or community project -namespaces in ``embodichain_robots``. Each model page documents construction, +namespaces in ``embodichain.extensions.robots``. Each model page documents construction, control parts, kinematics, and the currently supported variants. Run ``embodichain list-robot`` to discover installed families, variants, diff --git a/docs/source/resources/robot/inspire/hand.md b/docs/source/resources/robot/inspire/hand.md index 5f780a9b1c..d3597478d3 100644 --- a/docs/source/resources/robot/inspire/hand.md +++ b/docs/source/resources/robot/inspire/hand.md @@ -26,7 +26,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.inspire.hand.assets import InspireHand +from embodichain.extensions.robots.inspire.hand.assets import InspireHand ``` Use the stable asset reference for normal loading: @@ -49,12 +49,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/inspire/hand/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/inspire/hand/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/inspire/hand/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/inspire/hand/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/inspire/index.rst b/docs/source/resources/robot/inspire/index.rst index 24e5f72c20..6798405392 100644 --- a/docs/source/resources/robot/inspire/index.rst +++ b/docs/source/resources/robot/inspire/index.rst @@ -2,7 +2,7 @@ INSPIRE ROBOTS ============== Model-owned assets and any standalone configurations live under -``embodichain_robots.inspire``. Asset availability does not imply a +``embodichain.extensions.robots.inspire``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/pollen_robotics/index.rst b/docs/source/resources/robot/pollen_robotics/index.rst index c5fd77b7ce..47969bbb89 100644 --- a/docs/source/resources/robot/pollen_robotics/index.rst +++ b/docs/source/resources/robot/pollen_robotics/index.rst @@ -2,7 +2,7 @@ Pollen Robotics =============== Robot configurations for Pollen Robotics live in the -``embodichain_robots.pollen_robotics`` manufacturer namespace. +``embodichain.extensions.robots.pollen_robotics`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/pollen_robotics/microduck.md b/docs/source/resources/robot/pollen_robotics/microduck.md index a993b32ef7..825b8143be 100644 --- a/docs/source/resources/robot/pollen_robotics/microduck.md +++ b/docs/source/resources/robot/pollen_robotics/microduck.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import MicroDuckCfg +from embodichain.extensions.robots import MicroDuckCfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = MicroDuckCfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot MicroDuck | --- | --- | | Catalog ID / UID | `MicroDuck` | | Configuration class | `MicroDuckCfg` | -| Canonical module | `embodichain_robots.pollen_robotics.microduck` | +| Canonical module | `embodichain.extensions.robots.pollen_robotics.microduck` | | Vendor | `pollen_robotics` | | Morphology | `biped` | | Arm count | 0 | diff --git a/docs/source/resources/robot/robotiq/arg2f140.md b/docs/source/resources/robot/robotiq/arg2f140.md index fc698aa3ff..37065f2b8f 100644 --- a/docs/source/resources/robot/robotiq/arg2f140.md +++ b/docs/source/resources/robot/robotiq/arg2f140.md @@ -8,7 +8,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import RobotiqArg2F140Cfg +from embodichain.extensions.robots import RobotiqArg2F140Cfg cfg = RobotiqArg2F140Cfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/robotiq/arg2f85.md b/docs/source/resources/robot/robotiq/arg2f85.md index 2b4e33c52e..72511a0182 100644 --- a/docs/source/resources/robot/robotiq/arg2f85.md +++ b/docs/source/resources/robot/robotiq/arg2f85.md @@ -8,7 +8,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import RobotiqArg2F85Cfg +from embodichain.extensions.robots import RobotiqArg2F85Cfg cfg = RobotiqArg2F85Cfg.from_dict({}) ``` diff --git a/docs/source/resources/robot/robotiq/assets.md b/docs/source/resources/robot/robotiq/assets.md index 33855e991e..f511042da4 100644 --- a/docs/source/resources/robot/robotiq/assets.md +++ b/docs/source/resources/robot/robotiq/assets.md @@ -30,7 +30,7 @@ materials are preserved; the exact settings are recorded in each manifest. Canonical download-class import: ```python -from embodichain_robots.robotiq.assets import Robotiq +from embodichain.extensions.robots.robotiq.assets import Robotiq ``` Use the stable asset reference for normal loading: @@ -53,12 +53,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/robotiq/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/robotiq/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/robotiq/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/robotiq/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/robotiq/index.rst b/docs/source/resources/robot/robotiq/index.rst index 6d0db4c17e..88867e1e57 100644 --- a/docs/source/resources/robot/robotiq/index.rst +++ b/docs/source/resources/robot/robotiq/index.rst @@ -2,7 +2,7 @@ Robotiq ======== Model-owned assets and any standalone configurations live under -``embodichain_robots.robotiq``. Asset availability does not imply a +``embodichain.extensions.robots.robotiq``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/robotiq/robotiq_2f85.md b/docs/source/resources/robot/robotiq/robotiq_2f85.md index ed86d79ef2..e62bdd2db8 100644 --- a/docs/source/resources/robot/robotiq/robotiq_2f85.md +++ b/docs/source/resources/robot/robotiq/robotiq_2f85.md @@ -19,7 +19,7 @@ recorded per image. See [EEF rendering conventions](../end_effectors.md#rendered Canonical download-class import: ```python -from embodichain_robots.robotiq.robotiq_2f85.assets import Robotiq2F85 +from embodichain.extensions.robots.robotiq.robotiq_2f85.assets import Robotiq2F85 ``` Use the stable asset reference for normal loading: @@ -42,12 +42,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/robotiq/robotiq_2f85/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/robotiq/robotiq_2f85/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/robotiq/robotiq_2f85/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/robotiq/robotiq_2f85/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/sharpa/index.rst b/docs/source/resources/robot/sharpa/index.rst index 0d2b946fce..b9ddb33b1e 100644 --- a/docs/source/resources/robot/sharpa/index.rst +++ b/docs/source/resources/robot/sharpa/index.rst @@ -2,7 +2,7 @@ Sharpa Robotics =============== Official hand descriptions and standalone joint-controlled presets are owned by -``embodichain_robots.sharpa``. Model availability does not imply grasping or +``embodichain.extensions.robots.sharpa``. Model availability does not imply grasping or retargeting capability. .. list-table:: diff --git a/docs/source/resources/robot/sharpa/wave.md b/docs/source/resources/robot/sharpa/wave.md index 63c9f0f7a5..bdd68ca24a 100644 --- a/docs/source/resources/robot/sharpa/wave.md +++ b/docs/source/resources/robot/sharpa/wave.md @@ -1,6 +1,6 @@ # Sharpa Wave 01 -`embodichain_robots.SharpaWaveCfg` configures a standalone left or right +`embodichain.extensions.robots.SharpaWaveCfg` configures a standalone left or right Sharpa Wave 01. The robot catalog ID is `SharpaWave`; `left` and `right` select the native models, with right as the default. @@ -31,7 +31,7 @@ Given an existing `SimulationManager` named `sim`: ```python from embodichain.robot_registry import resolve_robot_cfg -from embodichain_robots import SharpaWaveCfg +from embodichain.extensions.robots import SharpaWaveCfg cfg = resolve_robot_cfg("SharpaWave", variant="left") # Equivalent model-local selection: @@ -48,7 +48,7 @@ embodichain preview-robot --robot SharpaWave --variant right --headless --device ``` The model package also lazily exports `SharpaWaveCfg` from -`embodichain_robots.sharpa.wave`. Listing catalogs does not +`embodichain.extensions.robots.sharpa.wave`. Listing catalogs does not import configurations or download assets. Unsupported sides fail before asset lookup. `from_dict()` builds defaults and applies isolated overrides through the standard `RobotCfg` path. An existing local `fpath` bypasses asset download. @@ -97,7 +97,7 @@ manipulation or other physics backends. ```python from embodichain.data import get_data_path -from embodichain_robots.sharpa.wave.assets import SharpaWave +from embodichain.extensions.robots.sharpa.wave.assets import SharpaWave right_urdf = get_data_path("SharpaWave/right_sharpa_wave/right_sharpa_wave.urdf") ``` @@ -105,6 +105,6 @@ right_urdf = get_data_path("SharpaWave/right_sharpa_wave/right_sharpa_wave.urdf" The [published V1 archive](https://huggingface.co/datasets/DexForceAI/embodichain_data/blob/541650b05674ead90b58e9edcac650e87d1a35a6/eef_assets/SharpaWaveV1.zip) contains both sides and uses the `SharpaWaveV1` cache. Source: [sharpa-robotics/sharpa-urdf-usd-xml at `0d19cac602f4`](https://github.com/sharpa-robotics/sharpa-urdf-usd-xml/tree/0d19cac602f46456b819e4b6a2c09a74982c9a3e). -The model-owned [provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/sharpa/wave/README.md) +The model-owned [provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/sharpa/wave/README.md) records licensing, preparation, archive hashes and native MJCF resources. Host assemblies own mount transforms, naming prefixes and task-specific interfaces. diff --git a/docs/source/resources/robot/the_robot_studio/index.rst b/docs/source/resources/robot/the_robot_studio/index.rst index d0f439c339..e19031bf24 100644 --- a/docs/source/resources/robot/the_robot_studio/index.rst +++ b/docs/source/resources/robot/the_robot_studio/index.rst @@ -2,7 +2,7 @@ The Robot Studio ================ Robot configurations for The Robot Studio live in the -``embodichain_robots.the_robot_studio`` manufacturer namespace. +``embodichain.extensions.robots.the_robot_studio`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/the_robot_studio/so101.md b/docs/source/resources/robot/the_robot_studio/so101.md index b28df4494f..e2e13b166c 100644 --- a/docs/source/resources/robot/the_robot_studio/so101.md +++ b/docs/source/resources/robot/the_robot_studio/so101.md @@ -17,7 +17,7 @@ yellow printed parts and dark STS3215 housings; Viser uses simplified colors. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import SO101FollowerCfg +from embodichain.extensions.robots import SO101FollowerCfg sim = SimulationManager(SimulationManagerCfg(headless=True)) cfg = SO101FollowerCfg.from_dict({}) diff --git a/docs/source/resources/robot/tianji/index.rst b/docs/source/resources/robot/tianji/index.rst index 4ab7238037..42ca8f3514 100644 --- a/docs/source/resources/robot/tianji/index.rst +++ b/docs/source/resources/robot/tianji/index.rst @@ -2,7 +2,7 @@ Tianji ====== Official Tianji robot configurations live in the -``embodichain_robots.tianji`` manufacturer namespace. +``embodichain.extensions.robots.tianji`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/tianji/marvin.md b/docs/source/resources/robot/tianji/marvin.md index 5b7c36b0af..3dacacb450 100644 --- a/docs/source/resources/robot/tianji/marvin.md +++ b/docs/source/resources/robot/tianji/marvin.md @@ -48,7 +48,7 @@ The arm-only configuration has 14 control DOFs. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg config = SimulationManagerCfg(headless=False, device="cpu", num_envs=1) sim = SimulationManager(config) @@ -121,7 +121,7 @@ source end-link poses, override both arm TCP transforms with identity matrices: ```python import numpy as np -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg cfg = TianjiMarvinCfg.from_dict( { @@ -139,8 +139,8 @@ cfg = TianjiMarvinCfg.from_dict( Run the preview and FK/IK smoke check in the project environment: ```bash -conda run -n embodichain python -m embodichain_robots.tianji.marvin.cfg --headless -conda run -n embodichain python -m embodichain_robots.tianji.marvin.cfg --headless --no-with-gripper +conda run -n embodichain python -m embodichain.extensions.robots.tianji.marvin.cfg --headless +conda run -n embodichain python -m embodichain.extensions.robots.tianji.marvin.cfg --headless --no-with-gripper ``` Omit `--headless` to open the simulation window and an interactive session. diff --git a/docs/source/resources/robot/tianji/marvin_gripper.md b/docs/source/resources/robot/tianji/marvin_gripper.md index de27962b63..9f66580a27 100644 --- a/docs/source/resources/robot/tianji/marvin_gripper.md +++ b/docs/source/resources/robot/tianji/marvin_gripper.md @@ -8,7 +8,7 @@ and declares no arm IK solver or serial FK chain. Simulation drive values are presets rather than manufacturer actuator specifications. ```python -from embodichain_robots import TianjiMarvinGripperCfg +from embodichain.extensions.robots import TianjiMarvinGripperCfg cfg = TianjiMarvinGripperCfg.from_dict({'variant': 'left'}) ``` diff --git a/docs/source/resources/robot/unitree/g1.md b/docs/source/resources/robot/unitree/g1.md index 5b5b7842b7..ee9d5f22bc 100644 --- a/docs/source/resources/robot/unitree/g1.md +++ b/docs/source/resources/robot/unitree/g1.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import UnitreeG1Cfg +from embodichain.extensions.robots import UnitreeG1Cfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = UnitreeG1Cfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot UnitreeG1 | --- | --- | | Catalog ID / UID | `UnitreeG1` | | Configuration class | `UnitreeG1Cfg` | -| Canonical module | `embodichain_robots.unitree.g1` | +| Canonical module | `embodichain.extensions.robots.unitree.g1` | | Vendor | `unitree` | | Morphology | `bipedal_humanoid` | | Arm count | 2 | diff --git a/docs/source/resources/robot/unitree/go1.md b/docs/source/resources/robot/unitree/go1.md index 591d09a416..174ddc4416 100644 --- a/docs/source/resources/robot/unitree/go1.md +++ b/docs/source/resources/robot/unitree/go1.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import UnitreeGo1Cfg +from embodichain.extensions.robots import UnitreeGo1Cfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = UnitreeGo1Cfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot UnitreeGo1 | --- | --- | | Catalog ID / UID | `UnitreeGo1` | | Configuration class | `UnitreeGo1Cfg` | -| Canonical module | `embodichain_robots.unitree.go1` | +| Canonical module | `embodichain.extensions.robots.unitree.go1` | | Vendor | `unitree` | | Morphology | `quadruped` | | Arm count | 0 | diff --git a/docs/source/resources/robot/unitree/go2.md b/docs/source/resources/robot/unitree/go2.md index 68d8e0eae3..2910e60cdc 100644 --- a/docs/source/resources/robot/unitree/go2.md +++ b/docs/source/resources/robot/unitree/go2.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import UnitreeGo2Cfg +from embodichain.extensions.robots import UnitreeGo2Cfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = UnitreeGo2Cfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot UnitreeGo2 | --- | --- | | Catalog ID / UID | `UnitreeGo2` | | Configuration class | `UnitreeGo2Cfg` | -| Canonical module | `embodichain_robots.unitree.go2` | +| Canonical module | `embodichain.extensions.robots.unitree.go2` | | Vendor | `unitree` | | Morphology | `quadruped` | | Arm count | 0 | diff --git a/docs/source/resources/robot/unitree/h1_2.md b/docs/source/resources/robot/unitree/h1_2.md index b7b67184b3..0dfa4fb1c6 100644 --- a/docs/source/resources/robot/unitree/h1_2.md +++ b/docs/source/resources/robot/unitree/h1_2.md @@ -12,7 +12,7 @@ including its floating base, standing pose and simulation PD drive defaults. ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import UnitreeH12Cfg +from embodichain.extensions.robots import UnitreeH12Cfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=1)) cfg = UnitreeH12Cfg.from_dict({}) @@ -31,7 +31,7 @@ embodichain preview-robot --robot UnitreeH1_2 | --- | --- | | Catalog ID / UID | `UnitreeH1_2` | | Configuration class | `UnitreeH12Cfg` | -| Canonical module | `embodichain_robots.unitree.h1_2` | +| Canonical module | `embodichain.extensions.robots.unitree.h1_2` | | Vendor | `unitree` | | Morphology | `bipedal_humanoid` | | Arm count | 2 | diff --git a/docs/source/resources/robot/unitree/index.rst b/docs/source/resources/robot/unitree/index.rst index 3cd62f7f3d..5669601fe9 100644 --- a/docs/source/resources/robot/unitree/index.rst +++ b/docs/source/resources/robot/unitree/index.rst @@ -2,7 +2,7 @@ Unitree ======== Robot configurations for Unitree live in the -``embodichain_robots.unitree`` manufacturer namespace. +``embodichain.extensions.robots.unitree`` manufacturer namespace. .. list-table:: :class: robot-catalog diff --git a/docs/source/resources/robot/universal_robots/index.rst b/docs/source/resources/robot/universal_robots/index.rst index b48e69f0ad..b9742c6569 100644 --- a/docs/source/resources/robot/universal_robots/index.rst +++ b/docs/source/resources/robot/universal_robots/index.rst @@ -2,7 +2,7 @@ Universal Robots ================ Official Universal Robots configurations live in the -``embodichain_robots.universal_robots`` manufacturer namespace. The six +``embodichain.extensions.robots.universal_robots`` manufacturer namespace. The six supported UR models share one family page and configuration class. .. list-table:: diff --git a/docs/source/resources/robot/universal_robots/ur_robot.md b/docs/source/resources/robot/universal_robots/ur_robot.md index 9f4601b4be..24857c0ae4 100644 --- a/docs/source/resources/robot/universal_robots/ur_robot.md +++ b/docs/source/resources/robot/universal_robots/ur_robot.md @@ -57,7 +57,7 @@ in the [render manifest](../../../_static/robots/ur/render_manifest.json). ```python from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg sim = SimulationManager(SimulationManagerCfg(headless=True, num_envs=4)) cfg = URRobotCfg.from_dict({"robot_type": "ur5"}) diff --git a/docs/source/resources/robot/wheeltec/fa2f.md b/docs/source/resources/robot/wheeltec/fa2f.md index 35904fea35..5034662945 100644 --- a/docs/source/resources/robot/wheeltec/fa2f.md +++ b/docs/source/resources/robot/wheeltec/fa2f.md @@ -23,7 +23,7 @@ materials are preserved; the exact settings are recorded in each manifest. Canonical download-class import: ```python -from embodichain_robots.wheeltec.fa2f.assets import WheelTecFA2F +from embodichain.extensions.robots.wheeltec.fa2f.assets import WheelTecFA2F ``` Use the stable asset reference for normal loading: @@ -46,12 +46,12 @@ captions above. ## Ownership and provenance -The download class lives in `extensions/embodichain_robots/wheeltec/fa2f/assets.py` and registers through the +The download class lives in `embodichain/extensions/robots/wheeltec/fa2f/assets.py` and registers through the existing `embodichain.assets` catalog with category `eef`. This asset-only package does not introduce a standalone robot preset. Host assembly owns the mounting transform, naming prefix, control-group mapping and task-specific TCP. -The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/wheeltec/fa2f/README.md) +The [asset provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/wheeltec/fa2f/README.md) separately records manufacturer affiliation, model matching, asset production, archive distribution, modifications and license status. Missing upstream or license evidence stays explicitly unverified. The Python implementation's diff --git a/docs/source/resources/robot/wheeltec/index.rst b/docs/source/resources/robot/wheeltec/index.rst index a787123278..9efedf3d56 100644 --- a/docs/source/resources/robot/wheeltec/index.rst +++ b/docs/source/resources/robot/wheeltec/index.rst @@ -2,7 +2,7 @@ WHEELTEC ======== Model-owned assets and any standalone configurations live under -``embodichain_robots.wheeltec``. Asset availability does not imply a +``embodichain.extensions.robots.wheeltec``. Asset availability does not imply a standalone robot preset or a grasping capability. .. list-table:: diff --git a/docs/source/resources/robot/wuji/hand.md b/docs/source/resources/robot/wuji/hand.md index f111bf2a6d..5439957434 100644 --- a/docs/source/resources/robot/wuji/hand.md +++ b/docs/source/resources/robot/wuji/hand.md @@ -1,6 +1,6 @@ # Wuji Hand -`embodichain_robots.WujiHandCfg` configures a standalone left or right +`embodichain.extensions.robots.WujiHandCfg` configures a standalone left or right Wuji Hand. The robot catalog ID is `WujiHand`; `left` and `right` select the native models, with right as the default. @@ -31,7 +31,7 @@ Given an existing `SimulationManager` named `sim`: ```python from embodichain.robot_registry import resolve_robot_cfg -from embodichain_robots import WujiHandCfg +from embodichain.extensions.robots import WujiHandCfg cfg = resolve_robot_cfg("WujiHand", variant="left") # Equivalent model-local selection: @@ -48,7 +48,7 @@ embodichain preview-robot --robot WujiHand --variant right --headless --device c ``` The model package also lazily exports `WujiHandCfg` from -`embodichain_robots.wuji.hand`. Listing catalogs does not +`embodichain.extensions.robots.wuji.hand`. Listing catalogs does not import configurations or download assets. Unsupported sides fail before asset lookup. `from_dict()` builds defaults and applies isolated overrides through the standard `RobotCfg` path. An existing local `fpath` bypasses asset download. @@ -97,7 +97,7 @@ manipulation or other physics backends. ```python from embodichain.data import get_data_path -from embodichain_robots.wuji.hand.assets import WujiHand +from embodichain.extensions.robots.wuji.hand.assets import WujiHand right_urdf = get_data_path("WujiHand/right.urdf") ``` @@ -105,7 +105,7 @@ right_urdf = get_data_path("WujiHand/right.urdf") The [published V2 archive](https://huggingface.co/datasets/DexForceAI/embodichain_data/blob/0540f7a2eb383cf3f24e85069f5af2b369890541/eef_assets/WujiHandV2.zip) contains both sides and uses the `WujiHandV2` cache. Source: [wuji-technology/wuji-description at `5c4dfa169173`](https://github.com/wuji-technology/wuji-description/tree/5c4dfa16917355d073e2e1d7e3d03897b6cf9508). -The model-owned [provenance record](https://github.com/DexForce/EmbodiChain/blob/main/extensions/embodichain_robots/wuji/hand/README.md) +The model-owned [provenance record](https://github.com/DexForce/EmbodiChain/blob/main/embodichain/extensions/robots/wuji/hand/README.md) records licensing, preparation, archive hashes and native MJCF resources. Host assemblies own mount transforms, naming prefixes and task-specific interfaces. diff --git a/docs/source/resources/robot/wuji/index.rst b/docs/source/resources/robot/wuji/index.rst index a0bb4bb1aa..43fb0659b2 100644 --- a/docs/source/resources/robot/wuji/index.rst +++ b/docs/source/resources/robot/wuji/index.rst @@ -2,7 +2,7 @@ Wuji Technology =============== Official hand descriptions and standalone joint-controlled presets are owned by -``embodichain_robots.wuji``. Model availability does not imply grasping or +``embodichain.extensions.robots.wuji``. Model availability does not imply grasping or retargeting capability. .. list-table:: diff --git a/docs/source/resources/task/classic_control.rst b/docs/source/resources/task/classic_control.rst index a44d0e1ccc..e9aef28632 100644 --- a/docs/source/resources/task/classic_control.rst +++ b/docs/source/resources/task/classic_control.rst @@ -3,7 +3,7 @@ Classic Control Tasks Classic-control tasks provide compact environments for validating learning algorithms and backend behavior. Their configurations live under -``embodichain_tasks/configs/tasks/classic_control``. +``embodichain/extensions/tasks/configs/tasks/classic_control``. .. list-table:: :header-rows: 1 @@ -35,4 +35,4 @@ Gym configuration file. .. code-block:: bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml diff --git a/docs/source/resources/task/index.rst b/docs/source/resources/task/index.rst index a2346dce16..1e72a66456 100644 --- a/docs/source/resources/task/index.rst +++ b/docs/source/resources/task/index.rst @@ -5,8 +5,8 @@ Task environments combine a simulation scene, robot, and task logic behind a Gymnasium-compatible interface. The official task environments are bundled in the ``embodichain`` wheel under -the ``embodichain_tasks`` import package. This section follows the task-first -layout under ``embodichain_tasks/configs/tasks`` so that documentation, +the ``embodichain.extensions.tasks`` import package. This section follows the task-first +layout under ``embodichain/extensions/tasks/configs/tasks`` so that documentation, configuration paths, and ``list-task`` output use the same hierarchy. Find a Task @@ -18,14 +18,14 @@ Use the catalog commands to inspect the installed task set: embodichain list-task embodichain list-task --category manipulation - embodichain show-task embodichain_tasks:repeated_pick_place + embodichain show-task embodichain.extensions.tasks:repeated_pick_place Preview a task with its runnable JSON or YAML configuration: .. code-block:: bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --preview Configuration-backed environments run through ``embodichain run-task``. Tasks @@ -73,7 +73,7 @@ configuration-defined Task Program from reusable components. Third-party task packages are discovered through the ``embodichain.tasks`` entry point. See :doc:`/overview/gym/env` for environment authoring and :doc:`/tutorial/task_program` for Task Programs. The -`official task package README `_ +`official task package README `_ describes package layout and registration. .. toctree:: diff --git a/docs/source/resources/task/locomotion/velocity.rst b/docs/source/resources/task/locomotion/velocity.rst index 9420e061b0..b8b7d089c6 100644 --- a/docs/source/resources/task/locomotion/velocity.rst +++ b/docs/source/resources/task/locomotion/velocity.rst @@ -1,7 +1,7 @@ Velocity-Tracking Tasks ======================= -These tasks live under ``embodichain_tasks/configs/tasks/locomotion/velocity``. +These tasks live under ``embodichain/extensions/tasks/configs/tasks/locomotion/velocity``. Every task provides ``env.yaml`` for the default physics backend and ``env.newton.yaml`` for Newton, plus a matching PPO trainer configuration. @@ -44,4 +44,4 @@ launcher to switch physics: .. code-block:: bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml diff --git a/docs/source/resources/task/manipulation/index.rst b/docs/source/resources/task/manipulation/index.rst index fc08d52dfa..1541012fce 100644 --- a/docs/source/resources/task/manipulation/index.rst +++ b/docs/source/resources/task/manipulation/index.rst @@ -39,9 +39,9 @@ Use ``show-task`` before launch when a logical task has several deployments: .. code-block:: bash - embodichain show-task embodichain_tasks:repeated_pick_place + embodichain show-task embodichain.extensions.tasks:repeated_pick_place embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --physics newton + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --physics newton The UR5 deployment keeps its augmentation settings in the task-facing ``expansion/repeated_pick_place.yaml`` file referenced by diff --git a/docs/source/resources/task/manipulation/tableware.rst b/docs/source/resources/task/manipulation/tableware.rst index 3a4708bd42..301a8ebcc7 100644 --- a/docs/source/resources/task/manipulation/tableware.rst +++ b/docs/source/resources/task/manipulation/tableware.rst @@ -2,7 +2,7 @@ Tableware Manipulation Tasks ============================ Tableware tasks live under -``embodichain_tasks/configs/tasks/manipulation/tableware``. They use task-local +``embodichain/extensions/tasks/configs/tasks/manipulation/tableware``. They use task-local configuration files and remain grouped beneath the manipulation domain in the catalog. @@ -52,4 +52,4 @@ For example, launch Pour Water through its Task Program deployment: .. code-block:: bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml diff --git a/docs/source/resources/task/special.rst b/docs/source/resources/task/special.rst index 59a81ad56a..47b16555c9 100644 --- a/docs/source/resources/task/special.rst +++ b/docs/source/resources/task/special.rst @@ -15,7 +15,7 @@ belong to the main control, locomotion, or manipulation families. * - Franka Reach APG - ``FrankaReachApg-v0`` - Python registration in - ``embodichain_tasks.special.franka_reach_apg``; no standard Gym config + ``embodichain.extensions.tasks.special.franka_reach_apg``; no standard Gym config - Differentiable RL / APG The simple UR10 end-effector motion example is a Task Program tutorial rather diff --git a/docs/source/tutorial/atomic_skills.rst b/docs/source/tutorial/atomic_skills.rst index 0a95c4f0d5..5f97e2f923 100644 --- a/docs/source/tutorial/atomic_skills.rst +++ b/docs/source/tutorial/atomic_skills.rst @@ -361,7 +361,7 @@ Swapping either UR5 or W1's gripper keeps that robot's object, start, destinatio and task frame fixed. Different robots use reachable fixture heights while preserving the object-goal formulation and task recipe. ARX5 uses a 50 mm table, inherits the outward-elbow ready pose and enabled self-collision from -``embodichain_robots.ARX5Cfg``, and selects an unflipped wrist branch for this +``embodichain.extensions.robots.ARX5Cfg``, and selects an unflipped wrist branch for this fixture to keep the wrist clear of its forearm. The dual-arm beam rests on central supports that leave space beneath both grasp regions. diff --git a/docs/source/tutorial/data_expansion.rst b/docs/source/tutorial/data_expansion.rst index 6ab8015d97..cd14bfc495 100644 --- a/docs/source/tutorial/data_expansion.rst +++ b/docs/source/tutorial/data_expansion.rst @@ -232,7 +232,7 @@ route. For example, smoke-test stacking without writing a dataset: .. code-block:: bash embodichain run-task \ - --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml \ --headless --filter_dataset_saving --max_episodes 1 To collect demonstrations, remove ``--filter_dataset_saving`` and configure @@ -256,7 +256,7 @@ Compose the deployment The runnable deployment is intentionally thin: -.. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml +.. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml :language: yaml :linenos: @@ -266,7 +266,7 @@ only physical simulation and ordinary Gym values: .. dropdown:: Pour Water reusable environment :icon: code - .. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml :language: yaml :linenos: @@ -284,7 +284,7 @@ Python callables or naming simulator joints: .. dropdown:: Pour Water Task Program :icon: code - .. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml :language: yaml :linenos: @@ -295,7 +295,7 @@ registered transport and pour lowerers: .. dropdown:: Pour Water integration :icon: code - .. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml :language: yaml :linenos: @@ -314,7 +314,7 @@ runnable deployment can record directly: .. code-block:: bash embodichain run-task \ - --gym_config embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ --headless \ --max_episodes 1 @@ -378,7 +378,7 @@ Important fields are: The real Pour Water recorder block can be inspected directly: -.. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml +.. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml :language: yaml :start-at: dataset: :end-at: control_parts: [left_arm, left_eef, right_arm, right_eef] diff --git a/docs/source/tutorial/modular_env.rst b/docs/source/tutorial/modular_env.rst index 85f2623bf5..7b733487e3 100644 --- a/docs/source/tutorial/modular_env.rst +++ b/docs/source/tutorial/modular_env.rst @@ -95,7 +95,7 @@ The main environment configuration inherits from :class:`envs.EmbodiedEnvCfg` an **Robot Configuration** -.. currentmodule:: embodichain_robots +.. currentmodule:: embodichain.extensions.robots .. literalinclude:: ../../../scripts/tutorials/gym/modular_env.py :language: python diff --git a/docs/source/tutorial/rl.rst b/docs/source/tutorial/rl.rst index b05f0aa4d8..2839f8dd8f 100644 --- a/docs/source/tutorial/rl.rst +++ b/docs/source/tutorial/rl.rst @@ -50,26 +50,26 @@ Training is configured via a JSON or YAML file that defines runtime settings, en Example Configuration --------------------- -Training configurations are task-local: PushCube uses ``embodichain_tasks/configs/tasks/manipulation/push_cube/agents`` and CartPole uses ``embodichain_tasks/configs/tasks/classic_control/cart_pole/agents``. PointMass APG/PPO configs live under ``embodichain_tasks/configs/tasks/classic_control/point_mass/agents``: +Training configurations are task-local: PushCube uses ``embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents`` and CartPole uses ``embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents``. PointMass APG/PPO configs live under ``embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents``: .. dropdown:: Example: train_config.json :icon: code - .. literalinclude:: ../../../embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json :language: json :linenos: .. dropdown:: Example: train_config.yaml (CartPole) :icon: code - .. literalinclude:: ../../../embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml :language: yaml :linenos: .. dropdown:: Example: train_apg.yaml (PointMass) :icon: code - .. literalinclude:: ../../../embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml + .. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml :language: yaml :linenos: @@ -78,8 +78,8 @@ APG and PPO. Launch either config with the same CLI: .. code-block:: bash - embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml - embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml Configuration Sections ---------------------- @@ -250,13 +250,13 @@ To start training, run: .. code-block:: bash - embodichain train-rl --config embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml JSON configs are also supported: .. code-block:: bash - embodichain train-rl --config embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json + embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json Outputs ------- diff --git a/docs/source/tutorial/task_program.rst b/docs/source/tutorial/task_program.rst index 3233b5ebfb..8a9c534318 100644 --- a/docs/source/tutorial/task_program.rst +++ b/docs/source/tutorial/task_program.rst @@ -49,14 +49,14 @@ In a source checkout, the official repeated Pick/Place example is a complete reference. Its physical backends live under ``envs/``; the UR5 deployment additionally references ``expansion/repeated_pick_place.yaml`` through ``expansion.config``: -* ``extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml`` +* ``embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml`` and ``envs/newton.yaml``; -* ``extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/``; -* ``extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml``; -* ``extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml``; -* ``extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml``; -* ``extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml``; -* ``extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml``. +* ``embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/``; +* ``embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml``; +* ``embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml``; +* ``embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml``; +* ``embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml``; +* ``embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml``. These files have explicit ownership rather than generic deep-merge semantics. The deployment must select components that satisfy the task's scene and @@ -111,13 +111,13 @@ The reusable environment owns physical simulation entities and ordinary environment values, including its explicit physics backend. Here is the complete Default environment used by the Quickstart: -.. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml +.. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml :language: yaml The complete Franka deployment selects environment variants, Task Program components and an embodiment. It does not enable expansion: -.. literalinclude:: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml +.. literalinclude:: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml :language: yaml During ``config_to_cfg()``, the component resolver expands these selections, @@ -175,7 +175,7 @@ file decoding before any live environment is constructed. Unlike the CLI, ) program = load_task_program( - "extensions/embodichain_tasks/configs/tasks/manipulation/" + "embodichain/extensions/tasks/configs/tasks/manipulation/" "repeated_pick_place/task_program/program.yaml", integration=TaskProgramIntegrationCfg( robot_profile="ur5_dh_pgi_140_80", @@ -205,7 +205,7 @@ Run the complete configuration with the normal environment CLI: embodichain run-task \ --gym_config \ - embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --headless To select another compatible program while keeping the trusted integration: diff --git a/embodichain/cli/_task_catalog.py b/embodichain/cli/_task_catalog.py index 201fc657f5..e313d22587 100644 --- a/embodichain/cli/_task_catalog.py +++ b/embodichain/cli/_task_catalog.py @@ -39,6 +39,7 @@ _HANDWRITTEN_DEMO = "Expert Demo: Handwritten Trajectory" _RL = "RL" _CAPABILITY_ORDER = (_TASK_PROGRAM, _HANDWRITTEN_DEMO, _RL) +_OFFICIAL_TASK_PACKAGE = "embodichain.extensions.tasks" @dataclass @@ -95,16 +96,6 @@ def _task_config_roots( roots: list[Traversable] = [] visited_packages: set[str] = set() for task_package in task_package_modules: - if task_package == "embodichain_tasks": - # Editable imports can point at a different checkout after task - # discovery. Mirror resolve_config_path's co-located precedence. - colocated = ( - Path(__file__).resolve().parents[2] - / "extensions/embodichain_tasks/configs/tasks" - ) - if colocated.is_dir(): - roots.append(colocated) - continue config_packages = ( f"{task_package}.configs", f"{task_package.partition('.')[0]}.configs", @@ -327,8 +318,8 @@ def _backend(config: Mapping[str, Any], resource: Traversable) -> str | None: def _reference(package: str, task_path: tuple[str, ...], name: str) -> str: - prefix = ("extensions", package) if package == "embodichain_tasks" else (package,) - return "/".join((*prefix, "configs", "tasks", *task_path, name)) + prefix = package.replace(".", "/") if package == _OFFICIAL_TASK_PACKAGE else package + return "/".join((prefix, "configs", "tasks", *task_path, name)) def _agent_matches( @@ -353,9 +344,6 @@ def _agent_matches( return ( deployment_path is not None and reference_path.resolve() == deployment_path ) - # Missing repository-style references resolve through packaged resources. - if reference.startswith("embodichain_tasks/configs/"): - reference = f"extensions/{reference}" return reference == deployment.config_ref @@ -555,7 +543,7 @@ def _config_environment_entries( return _catalog_entries( _load_catalog( { - "embodichain_tasks" if index == 0 else f"package_{index}": root + _OFFICIAL_TASK_PACKAGE if index == 0 else f"package_{index}": root for index, root in enumerate(config_roots) } ) diff --git a/embodichain/cli/benchmark.py b/embodichain/cli/benchmark.py index eaf88986e3..0ff7c42e3b 100644 --- a/embodichain/cli/benchmark.py +++ b/embodichain/cli/benchmark.py @@ -180,7 +180,7 @@ def _run_rl_cli(_: argparse.Namespace) -> None: def _run_motion_generation_cli(args: argparse.Namespace) -> None: """Run the shared Motion Planning and Atomic Skills benchmark.""" - from embodichain_benchmarks.motion_generation.cli import run_from_args + from embodichain.extensions.benchmarks.motion_generation.cli import run_from_args run_from_args(args) @@ -250,7 +250,9 @@ def main(argv: Sequence[str] | None = None) -> None: ), ) if arguments and arguments[0] == "motion-generation": - from embodichain_benchmarks.motion_generation.cli import add_parser_arguments + from embodichain.extensions.benchmarks.motion_generation.cli import ( + add_parser_arguments, + ) add_parser_arguments(motion_generation_parser) motion_generation_parser.set_defaults(func=_run_motion_generation_cli) diff --git a/embodichain/data/assets/locomotion_assets.py b/embodichain/data/assets/locomotion_assets.py index d734647d67..03d18b6636 100644 --- a/embodichain/data/assets/locomotion_assets.py +++ b/embodichain/data/assets/locomotion_assets.py @@ -41,12 +41,12 @@ class HumanoidRun(_LocomotionAsset): from importlib import import_module _ASSET_EXPORTS = { - "UnitreeGo1Locomotion": "embodichain_robots.unitree.go1.assets", - "UnitreeGo2Locomotion": "embodichain_robots.unitree.go2.assets", - "UnitreeG1Locomotion": "embodichain_robots.unitree.g1.assets", - "UnitreeH1_2Locomotion": "embodichain_robots.unitree.h1_2.assets", - "ANYmalCLocomotion": "embodichain_robots.anybotics.anymal_c.assets", - "MicroDuckLocomotion": "embodichain_robots.pollen_robotics.microduck.assets", + "UnitreeGo1Locomotion": "embodichain.extensions.robots.unitree.go1.assets", + "UnitreeGo2Locomotion": "embodichain.extensions.robots.unitree.go2.assets", + "UnitreeG1Locomotion": "embodichain.extensions.robots.unitree.g1.assets", + "UnitreeH1_2Locomotion": "embodichain.extensions.robots.unitree.h1_2.assets", + "ANYmalCLocomotion": "embodichain.extensions.robots.anybotics.anymal_c.assets", + "MicroDuckLocomotion": "embodichain.extensions.robots.pollen_robotics.microduck.assets", } diff --git a/embodichain/data/assets/robot_assets.py b/embodichain/data/assets/robot_assets.py index 9412fb9307..b43a708ee1 100644 --- a/embodichain/data/assets/robot_assets.py +++ b/embodichain/data/assets/robot_assets.py @@ -447,14 +447,14 @@ def __init__(self, data_root: str = None): from importlib import import_module _ASSET_EXPORTS = { - "CobotMagicArm": "embodichain_robots.agilex.cobotmagic.assets", - "ARX5": "embodichain_robots.arx.arx5.assets", - "AlohaMini": "embodichain_robots.alohamini.aloha_mini.assets", - "TianjiMarvin": "embodichain_robots.tianji.marvin.assets", - "FlexivRizon4S": "embodichain_robots.flexiv.rizon4s.assets", - "Franka": "embodichain_robots.franka.assets", - "FrankaPandaArm": "embodichain_robots.franka.assets", - "UniversalRobots": "embodichain_robots.universal_robots.assets", + "CobotMagicArm": "embodichain.extensions.robots.agilex.cobotmagic.assets", + "ARX5": "embodichain.extensions.robots.arx.arx5.assets", + "AlohaMini": "embodichain.extensions.robots.alohamini.aloha_mini.assets", + "TianjiMarvin": "embodichain.extensions.robots.tianji.marvin.assets", + "FlexivRizon4S": "embodichain.extensions.robots.flexiv.rizon4s.assets", + "Franka": "embodichain.extensions.robots.franka.assets", + "FrankaPandaArm": "embodichain.extensions.robots.franka.assets", + "UniversalRobots": "embodichain.extensions.robots.universal_robots.assets", } diff --git a/embodichain/data/assets/so101_assets.py b/embodichain/data/assets/so101_assets.py index ffbb033d0f..76b40ca2bb 100644 --- a/embodichain/data/assets/so101_assets.py +++ b/embodichain/data/assets/so101_assets.py @@ -23,7 +23,7 @@ from importlib import import_module _ASSET_EXPORTS = { - "SO101FollowerAssets": "embodichain_robots.the_robot_studio.so101.assets" + "SO101FollowerAssets": "embodichain.extensions.robots.the_robot_studio.so101.assets" } diff --git a/embodichain/data/assets/w1_assets.py b/embodichain/data/assets/w1_assets.py index 100a1e3f0c..26b1261f2d 100644 --- a/embodichain/data/assets/w1_assets.py +++ b/embodichain/data/assets/w1_assets.py @@ -34,16 +34,16 @@ from importlib import import_module _ASSET_EXPORTS = { - "DexforceW1V021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1V022": "embodichain_robots.dexforce.w1.assets", - "DexforceW1V025": "embodichain_robots.dexforce.w1.assets", - "DexforceW1V030": "embodichain_robots.dexforce.w1.assets", - "DexforceW1ChassisV021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1TorsoV021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1EyesV021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1HeadV021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1LeftArmV021": "embodichain_robots.dexforce.w1.assets", - "DexforceW1RightArmV021": "embodichain_robots.dexforce.w1.assets", + "DexforceW1V021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1V022": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1V025": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1V030": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1ChassisV021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1TorsoV021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1EyesV021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1HeadV021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1LeftArmV021": "embodichain.extensions.robots.dexforce.w1.assets", + "DexforceW1RightArmV021": "embodichain.extensions.robots.dexforce.w1.assets", } diff --git a/embodichain/extensions/README.md b/embodichain/extensions/README.md new file mode 100644 index 0000000000..216edfcf53 --- /dev/null +++ b/embodichain/extensions/README.md @@ -0,0 +1,32 @@ +# EmbodiChain extensions + +The `embodichain` wheel includes the official extensions in +`embodichain.extensions`. Each package has the same layout in source checkouts, +editable installs, and wheel installs. + +| Package | Responsibility | +| --- | --- | +| [`embodichain.extensions.tasks`](tasks/README.md) | Official tasks, deployments, and reusable task components | +| [`embodichain.extensions.robots`](robots/README.md) | Concrete robot presets and the official robot catalog | +| [`embodichain.extensions.models`](models/README.md) | Bundled model implementations | +| [`embodichain.extensions.solvers`](solvers/README.md) | Native-physics deployment adapters | +| [`embodichain.extensions.benchmarks`](benchmarks/motion_generation/README.md) | Evaluation suites, planner adapters, scoring policies, and reports | + +Add a bundled extension as `embodichain/extensions//__init__.py`. The +build discovers it as `embodichain.extensions.` and packages JSON, YAML, +URDF, README, license, attribution, and `preview.png` resources under +`embodichain/extensions/`. Declare any additional resource types in +`setup.py` and any plugin entry points in `pyproject.toml`. + +Official task configuration references beginning with +`embodichain/extensions/tasks/configs/` resolve from the checkout or installed +wheel. Use the complete Python import path in configuration values that name a +factory or class, such as +`embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`. + +Install from the repository root. Reinstall an existing editable checkout to +refresh its entry-point metadata after upgrading. + +```bash +pip install -e . --no-deps +``` diff --git a/embodichain/extensions/__init__.py b/embodichain/extensions/__init__.py new file mode 100644 index 0000000000..82252cf348 --- /dev/null +++ b/embodichain/extensions/__init__.py @@ -0,0 +1,21 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2021-2026 DexForce Technology Co., Ltd. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# ---------------------------------------------------------------------------- + +"""Official extensions bundled with EmbodiChain.""" + +from __future__ import annotations + +__all__: list[str] = [] diff --git a/extensions/embodichain_benchmarks/__init__.py b/embodichain/extensions/benchmarks/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/__init__.py rename to embodichain/extensions/benchmarks/__init__.py diff --git a/extensions/embodichain_benchmarks/assembly/__init__.py b/embodichain/extensions/benchmarks/assembly/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/assembly/__init__.py rename to embodichain/extensions/benchmarks/assembly/__init__.py diff --git a/extensions/embodichain_benchmarks/assembly/_many_metrics.py b/embodichain/extensions/benchmarks/assembly/_many_metrics.py similarity index 100% rename from extensions/embodichain_benchmarks/assembly/_many_metrics.py rename to embodichain/extensions/benchmarks/assembly/_many_metrics.py diff --git a/extensions/embodichain_benchmarks/assembly/_warp.py b/embodichain/extensions/benchmarks/assembly/_warp.py similarity index 100% rename from extensions/embodichain_benchmarks/assembly/_warp.py rename to embodichain/extensions/benchmarks/assembly/_warp.py diff --git a/extensions/embodichain_benchmarks/assembly/precision.py b/embodichain/extensions/benchmarks/assembly/precision.py similarity index 100% rename from extensions/embodichain_benchmarks/assembly/precision.py rename to embodichain/extensions/benchmarks/assembly/precision.py diff --git a/extensions/embodichain_benchmarks/assembly/probes.py b/embodichain/extensions/benchmarks/assembly/probes.py similarity index 100% rename from extensions/embodichain_benchmarks/assembly/probes.py rename to embodichain/extensions/benchmarks/assembly/probes.py diff --git a/extensions/embodichain_benchmarks/motion_generation/BENCHMARK_DESIGN.md b/embodichain/extensions/benchmarks/motion_generation/BENCHMARK_DESIGN.md similarity index 99% rename from extensions/embodichain_benchmarks/motion_generation/BENCHMARK_DESIGN.md rename to embodichain/extensions/benchmarks/motion_generation/BENCHMARK_DESIGN.md index bba9a67101..ccc594515b 100644 --- a/extensions/embodichain_benchmarks/motion_generation/BENCHMARK_DESIGN.md +++ b/embodichain/extensions/benchmarks/motion_generation/BENCHMARK_DESIGN.md @@ -1,7 +1,7 @@ # Motion Planning & Atomic Skills Benchmark Design This document describes the implemented comparison and evaluation contracts. -The [README](./README.md) owns commands, suite selection, configuration examples +The [README](README.md) owns commands, suite selection, configuration examples and extension entry points. Unimplemented capabilities are collected in [future extensions](#9-future-extensions). @@ -42,7 +42,7 @@ state, frozen inputs and evaluation. Planner adapters own backend construction, preparation, capability checks and generation. `metrics/trajectory.py` validates motion; `aggregation.py`, `generalization.py` and `reporting.py` consume records without invoking planners or simulators. Atomic provider/replay owners are -listed in the [extension guide](./README.md#provider-and-evaluator-interfaces). +listed in the [extension guide](README.md#provider-and-evaluator-interfaces). Capacity checks, preparation and planning receive untimed copies of canonical case tensors and nested parameters. External metrics and manifests use the diff --git a/extensions/embodichain_benchmarks/motion_generation/README.md b/embodichain/extensions/benchmarks/motion_generation/README.md similarity index 88% rename from extensions/embodichain_benchmarks/motion_generation/README.md rename to embodichain/extensions/benchmarks/motion_generation/README.md index a02c067e79..4a7d26538a 100644 --- a/extensions/embodichain_benchmarks/motion_generation/README.md +++ b/embodichain/extensions/benchmarks/motion_generation/README.md @@ -1,11 +1,10 @@ # Motion Planning & Atomic Skills Benchmark -The bundled `embodichain_benchmarks` extension owns evaluation orchestration, +The bundled `embodichain.extensions.benchmarks` extension owns evaluation orchestration, baseline adapters, scenarios, scoring policies, reports and suite resources. It consumes the simulation, planning and Atomic Skill APIs in `embodichain`. -The extension ships in the main wheel with the same version and dependencies; -`extensions/` is a source directory, not an import prefix. After updating a -source checkout, refresh its editable mappings with `pip install -e . --no-deps`. +The extension ships in the main wheel and lives under +`embodichain/extensions/benchmarks/` in the source tree. One framework evaluates two families selected by `TrackCfg.scenario`: @@ -16,7 +15,7 @@ One framework evaluates two families selected by `TrackCfg.scenario`: They share planner adapters, robot configuration, motion limits and raw artifacts, while keeping their populations and rankings separate. See the -[design contract](./BENCHMARK_DESIGN.md) for scoring, timing and fairness rules. +[design contract](BENCHMARK_DESIGN.md) for scoring, timing and fairness rules. ## Run @@ -28,14 +27,14 @@ embodichain benchmark motion-generation --suite atomic_franka_robotiq_smoke --de ``` The equivalent Python entry point is -`python -m embodichain_benchmarks.motion_generation`. `--suite` accepts +`python -m embodichain.extensions.benchmarks.motion_generation`. `--suite` accepts one of the names below or a YAML path. Use `--help` for population, trial, output and video overrides. ### Call from another repository ```python -from embodichain_benchmarks.motion_generation import ( +from embodichain.extensions.benchmarks.motion_generation import ( PlannerSpecCfg, load_suite, run_benchmark, @@ -170,7 +169,7 @@ The native Franka hand remains available for custom robot configurations; packaged Franka Atomic suites use Robotiq. GraspKit returns sampled poses converted once to the declared runtime TCP; -see its [frame contract](../../../embodichain/toolkits/graspkit/README.md#frames-and-collision-scope). +see its [frame contract](../../../toolkits/graspkit/README.md#frames-and-collision-scope). Placement converts its authored canonical top/handle poses to that TCP before freezing them. Preparation and replay use Robotiq geometry and the configured solver TCP. Physical success still requires measured replay; kinematic checks @@ -214,18 +213,18 @@ The new hand and suite identity require newly generated frozen inputs. | Suite | Use | | --- | --- | -| [`motion_panda_free_space_smoke`](./suites/motion_panda_free_space_smoke.yaml) | Small Panda EEF/joint planning check | -| [`motion_panda_free_space_coverage`](./suites/motion_panda_free_space_coverage.yaml), [`motion_ur5_free_space_coverage`](./suites/motion_ur5_free_space_coverage.yaml) | Planning coverage across batches, path shapes and start-state bins | -| [`atomic_franka_robotiq_smoke`](./suites/atomic_franka_robotiq_smoke.yaml) | Single-arm motion integration and six interaction skills | -| [`atomic_franka_robotiq_randomized`](./suites/atomic_franka_robotiq_randomized.yaml), [`atomic_ur5_pgi_randomized`](./suites/atomic_ur5_pgi_randomized.yaml) | Seeded single-arm interaction sweeps | -| [`atomic_franka_robotiq_pose_batch`](./suites/atomic_franka_robotiq_pose_batch.yaml) | Batched object/target translation perturbations | -| [`atomic_franka_robotiq_door_pour_align_push`](./suites/atomic_franka_robotiq_door_pour_align_push.yaml) | OpenDoor, Pour, AxisAlign and PushObject | -| [`atomic_franka_robotiq_spatial_generalization`](./suites/atomic_franka_robotiq_spatial_generalization.yaml) | Ten task-level skills across nominal, pose and primitive-geometry domains | -| [`atomic_dual_ur5_pgi_hand_over`](./suites/atomic_dual_ur5_pgi_hand_over.yaml), [`atomic_dual_ur5_pgi_coordinated_pickment`](./suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml), [`atomic_dual_ur5_pgi_coordinated_placement`](./suites/atomic_dual_ur5_pgi_coordinated_placement.yaml) | Dual UR5 + PGI physical skills with TOPPRA | -| [`atomic_dual_franka_robotiq_hand_over`](./suites/atomic_dual_franka_robotiq_hand_over.yaml) | Nominal B=1 dual Franka + Robotiq 2F-140 handover with TOPPRA | -| [`atomic_dual_franka_robotiq_coordinated_placement`](./suites/atomic_dual_franka_robotiq_coordinated_placement.yaml) | Nominal B=1 dual Franka + Robotiq 2F-140 placement fixture with TOPPRA, cuRobo and paired raw/retimed NMG | -| [`atomic_dual_ur5_pgi_hand_over_spatial_generalization`](./suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml), [`atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization`](./suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml), [`atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization`](./suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml) | Dual-arm pose, task-frame and composed domains | -| [`atomic_ur5_embodiment`](./suites/atomic_ur5_embodiment.yaml) | Component-defined UR5 embodiment with nominal/object-XY PickUp domains | +| [`motion_panda_free_space_smoke`](suites/motion_panda_free_space_smoke.yaml) | Small Panda EEF/joint planning check | +| [`motion_panda_free_space_coverage`](suites/motion_panda_free_space_coverage.yaml), [`motion_ur5_free_space_coverage`](suites/motion_ur5_free_space_coverage.yaml) | Planning coverage across batches, path shapes and start-state bins | +| [`atomic_franka_robotiq_smoke`](suites/atomic_franka_robotiq_smoke.yaml) | Single-arm motion integration and six interaction skills | +| [`atomic_franka_robotiq_randomized`](suites/atomic_franka_robotiq_randomized.yaml), [`atomic_ur5_pgi_randomized`](suites/atomic_ur5_pgi_randomized.yaml) | Seeded single-arm interaction sweeps | +| [`atomic_franka_robotiq_pose_batch`](suites/atomic_franka_robotiq_pose_batch.yaml) | Batched object/target translation perturbations | +| [`atomic_franka_robotiq_door_pour_align_push`](suites/atomic_franka_robotiq_door_pour_align_push.yaml) | OpenDoor, Pour, AxisAlign and PushObject | +| [`atomic_franka_robotiq_spatial_generalization`](suites/atomic_franka_robotiq_spatial_generalization.yaml) | Ten task-level skills across nominal, pose and primitive-geometry domains | +| [`atomic_dual_ur5_pgi_hand_over`](suites/atomic_dual_ur5_pgi_hand_over.yaml), [`atomic_dual_ur5_pgi_coordinated_pickment`](suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml), [`atomic_dual_ur5_pgi_coordinated_placement`](suites/atomic_dual_ur5_pgi_coordinated_placement.yaml) | Dual UR5 + PGI physical skills with TOPPRA | +| [`atomic_dual_franka_robotiq_hand_over`](suites/atomic_dual_franka_robotiq_hand_over.yaml) | Nominal B=1 dual Franka + Robotiq 2F-140 handover with TOPPRA | +| [`atomic_dual_franka_robotiq_coordinated_placement`](suites/atomic_dual_franka_robotiq_coordinated_placement.yaml) | Nominal B=1 dual Franka + Robotiq 2F-140 placement fixture with TOPPRA, cuRobo and paired raw/retimed NMG | +| [`atomic_dual_ur5_pgi_hand_over_spatial_generalization`](suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml), [`atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization`](suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml), [`atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization`](suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml) | Dual-arm pose, task-frame and composed domains | +| [`atomic_ur5_embodiment`](suites/atomic_ur5_embodiment.yaml) | Component-defined UR5 embodiment with nominal/object-XY PickUp domains | Motion Planning suites enable cuRobo as the primary baseline and TOPPRA / IK interpolation as diagnostics. To include the optional paired NMG candidates, @@ -315,8 +314,8 @@ backends sequentially; an explicitly enabled NMG backend also runs a packed dispatch for comparison. Task dependencies and physical execution are unchanged. ```python -from embodichain_benchmarks.motion_generation import load_suite -from embodichain_benchmarks.motion_generation.runner import BenchmarkRunner +from embodichain.extensions.benchmarks.motion_generation import load_suite +from embodichain.extensions.benchmarks.motion_generation.runner import BenchmarkRunner suite = load_suite("resolved_dual_suite.yaml") runner = BenchmarkRunner( @@ -410,9 +409,9 @@ Atomic physical success. Motion, execution and end-to-end success are reported separately. Raw NMG and fixed-clock IK interpolation have no timed rank. New suites use report schema `3`; existing artifacts retain their recorded -versions. The [report contract](./BENCHMARK_DESIGN.md#8-artifacts-and-report-contract) +versions. The [report contract](BENCHMARK_DESIGN.md#8-artifacts-and-report-contract) defines family tables, aggregate fields and denominator rules. See -[capability gates](./BENCHMARK_DESIGN.md#5-scenario-tracks-and-capability-gates) +[capability gates](BENCHMARK_DESIGN.md#5-scenario-tracks-and-capability-gates) for unsupported populations and eligibility. Policy control steps are auxiliary Free-space diagnostics. Raw outcomes retain @@ -699,7 +698,7 @@ Select a registered `robot` provider or an official embodiment component: ```yaml embodiment: - component: embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml overrides: {} ``` @@ -745,19 +744,19 @@ a shared `track_group`. The loader does not mutate the source suite. A single Generalization eligibility requires a complete nominal baseline and at least one complete non-nominal domain for the same track and attributed algorithm. Retention is N/A for an incomplete or zero nominal baseline. The -[population contract](./BENCHMARK_DESIGN.md#6-domain-populations-and-generalization) +[population contract](BENCHMARK_DESIGN.md#6-domain-populations-and-generalization) describes pose, primitive-geometry and composed domains. ## Extend -- Planner: implement and register [`PlannerAdapter`](./planners/base.py), +- Planner: implement and register [`PlannerAdapter`](planners/base.py), declaring capabilities and timing semantics. Atomic Skills additionally require an exposed `MotionGenerator` and the `atomic_skill` capability. -- Robot: register a [`RobotProvider`](./robots/base.py); gripper-action suites +- Robot: register a [`RobotProvider`](robots/base.py); gripper-action suites also configure the control part and open/grasp joint commands. - Object: configure a built-in `cube` / `mesh` entry, or register an object-kind - factory in [`atomic_objects.py`](./scenarios/atomic_objects.py). -- Atomic Skill: implement [`AtomicSkillCaseProvider`](./atomic_skill.py), + factory in [`atomic_objects.py`](scenarios/atomic_objects.py). +- Atomic Skill: implement [`AtomicSkillCaseProvider`](atomic_skill.py), register it, declare `requires_gripper` when needed, and supply a measured physical evaluator. Reuse the lifecycle and evidence owners below. @@ -765,17 +764,17 @@ describes pose, primitive-geometry and composed domains. | Owner | Responsibility | | --- | --- | -| [`atomic_skill.py`](./atomic_skill.py) | Provider contract and skill registry | -| [`scenarios/atomic_skill.py`](./scenarios/atomic_skill.py) | Scene setup/reset, cases, compilation, evaluation, video and teardown | -| [`atomic_case_utils.py`](./scenarios/atomic_case_utils.py) | Case identity, typed pose-context adaptation, provenance and goal helpers | -| [`_atomic_pose_sampling.py`](./scenarios/_atomic_pose_sampling.py) | Pure deterministic pose sampling and legacy-context decoding | -| [`_free_space_sampling.py`](./scenarios/_free_space_sampling.py) | Reachable Cartesian workloads and measured difficulty | -| [`atomic_policy.py`](./scenarios/atomic_policy.py) | Motion policy, source attribution and budgets | -| [`atomic_grasps.py`](./scenarios/atomic_grasps.py) | Frozen and case-scoped grasp generators | -| [`atomic_evaluation.py`](./scenarios/atomic_evaluation.py) | Measured evidence and shared evaluators | -| [`atomic_replay.py`](./scenarios/atomic_replay.py) | Replay runtime shared by evaluation and video | -| [`atomic_motion_cases.py`](./scenarios/atomic_motion_cases.py), [`atomic_manipulation_cases.py`](./scenarios/atomic_manipulation_cases.py), [`atomic_contact_cases.py`](./scenarios/atomic_contact_cases.py) | Base motion, manipulation and articulated-contact providers | -| [`atomic_skill_providers.py`](./scenarios/atomic_skill_providers.py), [`atomic_dual_arm_providers.py`](./scenarios/atomic_dual_arm_providers.py) | Additional single-arm and dual-arm providers | +| [`atomic_skill.py`](atomic_skill.py) | Provider contract and skill registry | +| [`scenarios/atomic_skill.py`](scenarios/atomic_skill.py) | Scene setup/reset, cases, compilation, evaluation, video and teardown | +| [`atomic_case_utils.py`](scenarios/atomic_case_utils.py) | Case identity, typed pose-context adaptation, provenance and goal helpers | +| [`_atomic_pose_sampling.py`](scenarios/_atomic_pose_sampling.py) | Pure deterministic pose sampling and legacy-context decoding | +| [`_free_space_sampling.py`](scenarios/_free_space_sampling.py) | Reachable Cartesian workloads and measured difficulty | +| [`atomic_policy.py`](scenarios/atomic_policy.py) | Motion policy, source attribution and budgets | +| [`atomic_grasps.py`](scenarios/atomic_grasps.py) | Frozen and case-scoped grasp generators | +| [`atomic_evaluation.py`](scenarios/atomic_evaluation.py) | Measured evidence and shared evaluators | +| [`atomic_replay.py`](scenarios/atomic_replay.py) | Replay runtime shared by evaluation and video | +| [`atomic_motion_cases.py`](scenarios/atomic_motion_cases.py), [`atomic_manipulation_cases.py`](scenarios/atomic_manipulation_cases.py), [`atomic_contact_cases.py`](scenarios/atomic_contact_cases.py) | Base motion, manipulation and articulated-contact providers | +| [`atomic_skill_providers.py`](scenarios/atomic_skill_providers.py), [`atomic_dual_arm_providers.py`](scenarios/atomic_dual_arm_providers.py) | Additional single-arm and dual-arm providers | Provider hooks cover preconditions and skill-specific sampling: `prefix_invocations()` supplies prerequisite actions, `initial_scene()` adds @@ -788,7 +787,7 @@ All 15 built-in skills use `physical_evaluator()`. Implement `contracts.PhysicalStageEvaluator.evaluate(case, observation, motion_outcomes)` and return one `PhysicalEvaluation` per environment with consistent ordered stage IDs. Custom providers without a physical evaluator can use the existing -`task_result()` fallback. The [physical evaluation contract](./BENCHMARK_DESIGN.md#4-physical-evaluation) +`task_result()` fallback. The [physical evaluation contract](BENCHMARK_DESIGN.md#4-physical-evaluation) defines evidence boundaries, stage progression and success semantics. ## Current limits diff --git a/extensions/embodichain_benchmarks/motion_generation/__init__.py b/embodichain/extensions/benchmarks/motion_generation/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/__init__.py rename to embodichain/extensions/benchmarks/motion_generation/__init__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/__main__.py b/embodichain/extensions/benchmarks/motion_generation/__main__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/__main__.py rename to embodichain/extensions/benchmarks/motion_generation/__main__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/_aggregation_policy.py b/embodichain/extensions/benchmarks/motion_generation/_aggregation_policy.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/_aggregation_policy.py rename to embodichain/extensions/benchmarks/motion_generation/_aggregation_policy.py diff --git a/extensions/embodichain_benchmarks/motion_generation/_atomic_fixtures.py b/embodichain/extensions/benchmarks/motion_generation/_atomic_fixtures.py similarity index 99% rename from extensions/embodichain_benchmarks/motion_generation/_atomic_fixtures.py rename to embodichain/extensions/benchmarks/motion_generation/_atomic_fixtures.py index 966a686c66..8cf38b310a 100644 --- a/extensions/embodichain_benchmarks/motion_generation/_atomic_fixtures.py +++ b/embodichain/extensions/benchmarks/motion_generation/_atomic_fixtures.py @@ -62,7 +62,7 @@ FixedGripperCollisionGeometry, ParallelJawGraspCollisionCfg, ) -from embodichain_robots import FrankaPandaCfg, URRobotCfg +from embodichain.extensions.robots import FrankaPandaCfg, URRobotCfg from ._tcp_presets import ToolPoint, sample_tool_tcp @@ -289,7 +289,7 @@ def create_ur5_gripper_robot_cfg( ) -> RobotCfg: """Build a UR5 arm + DH_PGI_140_80 gripper robot configuration. - The arm is taken from :class:`~embodichain_robots.universal_robots.ur_robot.URRobotCfg` + The arm is taken from :class:`~embodichain.extensions.robots.universal_robots.ur_robot.URRobotCfg` so the URDF, joint names and drive defaults match the canonical UR family config. The gripper and tool-center-point offset are added on top to match the existing atomic-skill tutorial setups. @@ -302,7 +302,7 @@ def create_ur5_gripper_robot_cfg( assembled robot keeps the source URDF's lowercase joint names (``joint1``..``joint6`` and ``gripper_finger1_joint_1``), matching the control parts produced by - :class:`~embodichain_robots.universal_robots.ur_robot.URRobotCfg`. + :class:`~embodichain.extensions.robots.universal_robots.ur_robot.URRobotCfg`. Args: init_pos: Initial root position of the robot in the arena. @@ -548,7 +548,7 @@ def build_pk_serial_chain( def _create_franka_native_hand_cfg(overrides: dict[str, Any] | None = None) -> RobotCfg: """Resolve the official explicit FR3/hand assembly without creating a Gym.""" - from embodichain_tasks.configs import get_config_path + from embodichain.extensions.tasks.configs import get_config_path from embodichain.robot_registry import resolve_robot_cfg from embodichain.lab.gym.utils.composition import resolve_gym_components diff --git a/extensions/embodichain_benchmarks/motion_generation/_case_preparation.py b/embodichain/extensions/benchmarks/motion_generation/_case_preparation.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/_case_preparation.py rename to embodichain/extensions/benchmarks/motion_generation/_case_preparation.py diff --git a/extensions/embodichain_benchmarks/motion_generation/_paired_arm_performance.py b/embodichain/extensions/benchmarks/motion_generation/_paired_arm_performance.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/_paired_arm_performance.py rename to embodichain/extensions/benchmarks/motion_generation/_paired_arm_performance.py diff --git a/extensions/embodichain_benchmarks/motion_generation/_quality_batching.py b/embodichain/extensions/benchmarks/motion_generation/_quality_batching.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/_quality_batching.py rename to embodichain/extensions/benchmarks/motion_generation/_quality_batching.py diff --git a/extensions/embodichain_benchmarks/motion_generation/_tcp_presets.py b/embodichain/extensions/benchmarks/motion_generation/_tcp_presets.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/_tcp_presets.py rename to embodichain/extensions/benchmarks/motion_generation/_tcp_presets.py diff --git a/extensions/embodichain_benchmarks/motion_generation/aggregation.py b/embodichain/extensions/benchmarks/motion_generation/aggregation.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/aggregation.py rename to embodichain/extensions/benchmarks/motion_generation/aggregation.py diff --git a/extensions/embodichain_benchmarks/motion_generation/api.py b/embodichain/extensions/benchmarks/motion_generation/api.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/api.py rename to embodichain/extensions/benchmarks/motion_generation/api.py diff --git a/extensions/embodichain_benchmarks/motion_generation/artifacts.py b/embodichain/extensions/benchmarks/motion_generation/artifacts.py similarity index 99% rename from extensions/embodichain_benchmarks/motion_generation/artifacts.py rename to embodichain/extensions/benchmarks/motion_generation/artifacts.py index 7b33a13f05..4f49c4f00a 100644 --- a/extensions/embodichain_benchmarks/motion_generation/artifacts.py +++ b/embodichain/extensions/benchmarks/motion_generation/artifacts.py @@ -67,7 +67,7 @@ def _package_version(package: str) -> str | None: def _git_commit() -> str | None: """Return the framework checkout revision, independent of caller cwd.""" - repository = Path(__file__).resolve().parents[3] + repository = Path(__file__).resolve().parents[4] if not (repository / ".git").exists(): return None try: diff --git a/extensions/embodichain_benchmarks/motion_generation/atomic_skill.py b/embodichain/extensions/benchmarks/motion_generation/atomic_skill.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/atomic_skill.py rename to embodichain/extensions/benchmarks/motion_generation/atomic_skill.py diff --git a/extensions/embodichain_benchmarks/motion_generation/cli.py b/embodichain/extensions/benchmarks/motion_generation/cli.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/cli.py rename to embodichain/extensions/benchmarks/motion_generation/cli.py diff --git a/extensions/embodichain_benchmarks/motion_generation/config.py b/embodichain/extensions/benchmarks/motion_generation/config.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/config.py rename to embodichain/extensions/benchmarks/motion_generation/config.py diff --git a/extensions/embodichain_benchmarks/motion_generation/contracts.py b/embodichain/extensions/benchmarks/motion_generation/contracts.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/contracts.py rename to embodichain/extensions/benchmarks/motion_generation/contracts.py diff --git a/extensions/embodichain_benchmarks/motion_generation/embodiments.py b/embodichain/extensions/benchmarks/motion_generation/embodiments.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/embodiments.py rename to embodichain/extensions/benchmarks/motion_generation/embodiments.py diff --git a/extensions/embodichain_benchmarks/motion_generation/evaluation.py b/embodichain/extensions/benchmarks/motion_generation/evaluation.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/evaluation.py rename to embodichain/extensions/benchmarks/motion_generation/evaluation.py diff --git a/extensions/embodichain_benchmarks/motion_generation/generalization.py b/embodichain/extensions/benchmarks/motion_generation/generalization.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/generalization.py rename to embodichain/extensions/benchmarks/motion_generation/generalization.py diff --git a/extensions/embodichain_benchmarks/motion_generation/limits.py b/embodichain/extensions/benchmarks/motion_generation/limits.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/limits.py rename to embodichain/extensions/benchmarks/motion_generation/limits.py diff --git a/extensions/embodichain_benchmarks/motion_generation/metrics/__init__.py b/embodichain/extensions/benchmarks/motion_generation/metrics/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/metrics/__init__.py rename to embodichain/extensions/benchmarks/motion_generation/metrics/__init__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/metrics/_constraints.py b/embodichain/extensions/benchmarks/motion_generation/metrics/_constraints.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/metrics/_constraints.py rename to embodichain/extensions/benchmarks/motion_generation/metrics/_constraints.py diff --git a/extensions/embodichain_benchmarks/motion_generation/metrics/performance.py b/embodichain/extensions/benchmarks/motion_generation/metrics/performance.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/metrics/performance.py rename to embodichain/extensions/benchmarks/motion_generation/metrics/performance.py diff --git a/extensions/embodichain_benchmarks/motion_generation/metrics/stats.py b/embodichain/extensions/benchmarks/motion_generation/metrics/stats.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/metrics/stats.py rename to embodichain/extensions/benchmarks/motion_generation/metrics/stats.py diff --git a/extensions/embodichain_benchmarks/motion_generation/metrics/trajectory.py b/embodichain/extensions/benchmarks/motion_generation/metrics/trajectory.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/metrics/trajectory.py rename to embodichain/extensions/benchmarks/motion_generation/metrics/trajectory.py diff --git a/extensions/embodichain_benchmarks/motion_generation/models.py b/embodichain/extensions/benchmarks/motion_generation/models.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/models.py rename to embodichain/extensions/benchmarks/motion_generation/models.py diff --git a/extensions/embodichain_benchmarks/motion_generation/parallel.py b/embodichain/extensions/benchmarks/motion_generation/parallel.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/parallel.py rename to embodichain/extensions/benchmarks/motion_generation/parallel.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/__init__.py b/embodichain/extensions/benchmarks/motion_generation/planners/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/__init__.py rename to embodichain/extensions/benchmarks/motion_generation/planners/__init__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/_constraints.py b/embodichain/extensions/benchmarks/motion_generation/planners/_constraints.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/_constraints.py rename to embodichain/extensions/benchmarks/motion_generation/planners/_constraints.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/base.py b/embodichain/extensions/benchmarks/motion_generation/planners/base.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/base.py rename to embodichain/extensions/benchmarks/motion_generation/planners/base.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/curobo.py b/embodichain/extensions/benchmarks/motion_generation/planners/curobo.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/curobo.py rename to embodichain/extensions/benchmarks/motion_generation/planners/curobo.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/ik_interpolate.py b/embodichain/extensions/benchmarks/motion_generation/planners/ik_interpolate.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/ik_interpolate.py rename to embodichain/extensions/benchmarks/motion_generation/planners/ik_interpolate.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/nmg_onnx.py b/embodichain/extensions/benchmarks/motion_generation/planners/nmg_onnx.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/nmg_onnx.py rename to embodichain/extensions/benchmarks/motion_generation/planners/nmg_onnx.py diff --git a/extensions/embodichain_benchmarks/motion_generation/planners/toppra.py b/embodichain/extensions/benchmarks/motion_generation/planners/toppra.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/planners/toppra.py rename to embodichain/extensions/benchmarks/motion_generation/planners/toppra.py diff --git a/extensions/embodichain_benchmarks/motion_generation/registry.py b/embodichain/extensions/benchmarks/motion_generation/registry.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/registry.py rename to embodichain/extensions/benchmarks/motion_generation/registry.py diff --git a/extensions/embodichain_benchmarks/motion_generation/reporting.py b/embodichain/extensions/benchmarks/motion_generation/reporting.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/reporting.py rename to embodichain/extensions/benchmarks/motion_generation/reporting.py diff --git a/extensions/embodichain_benchmarks/motion_generation/robots/__init__.py b/embodichain/extensions/benchmarks/motion_generation/robots/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/robots/__init__.py rename to embodichain/extensions/benchmarks/motion_generation/robots/__init__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/robots/base.py b/embodichain/extensions/benchmarks/motion_generation/robots/base.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/robots/base.py rename to embodichain/extensions/benchmarks/motion_generation/robots/base.py diff --git a/extensions/embodichain_benchmarks/motion_generation/robots/dual_arm.py b/embodichain/extensions/benchmarks/motion_generation/robots/dual_arm.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/robots/dual_arm.py rename to embodichain/extensions/benchmarks/motion_generation/robots/dual_arm.py diff --git a/extensions/embodichain_benchmarks/motion_generation/robots/franka.py b/embodichain/extensions/benchmarks/motion_generation/robots/franka.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/robots/franka.py rename to embodichain/extensions/benchmarks/motion_generation/robots/franka.py diff --git a/extensions/embodichain_benchmarks/motion_generation/robots/ur5.py b/embodichain/extensions/benchmarks/motion_generation/robots/ur5.py similarity index 97% rename from extensions/embodichain_benchmarks/motion_generation/robots/ur5.py rename to embodichain/extensions/benchmarks/motion_generation/robots/ur5.py index 1161487b2a..574b6da3cb 100644 --- a/extensions/embodichain_benchmarks/motion_generation/robots/ur5.py +++ b/embodichain/extensions/benchmarks/motion_generation/robots/ur5.py @@ -19,7 +19,7 @@ from __future__ import annotations from embodichain.lab.sim.cfg import RobotCfg -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.lab.sim.utility.cfg_utils import merge_robot_cfg from .._atomic_fixtures import create_ur5_gripper_robot_cfg diff --git a/extensions/embodichain_benchmarks/motion_generation/runner.py b/embodichain/extensions/benchmarks/motion_generation/runner.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/runner.py rename to embodichain/extensions/benchmarks/motion_generation/runner.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/__init__.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/__init__.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/__init__.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/__init__.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_pose_sampling.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_pose_sampling.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_pose_sampling.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_pose_sampling.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_reference.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_reference.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_reference.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_reference.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_targets.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_targets.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_atomic_targets.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_atomic_targets.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_case_qualification.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_case_qualification.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_case_qualification.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_case_qualification.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_free_space_proposals.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_free_space_proposals.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_free_space_proposals.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_free_space_proposals.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_free_space_sampling.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_free_space_sampling.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_free_space_sampling.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_free_space_sampling.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_grasp_contacts.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_grasp_contacts.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_grasp_contacts.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_grasp_contacts.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_placement_geometry.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_placement_geometry.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_placement_geometry.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_placement_geometry.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_placement_qualification.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_placement_qualification.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_placement_qualification.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_placement_qualification.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/_replay_diagnostics.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/_replay_diagnostics.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/_replay_diagnostics.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/_replay_diagnostics.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_case_utils.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_case_utils.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_case_utils.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_case_utils.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_contact_cases.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_contact_cases.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_contact_cases.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_contact_cases.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_dual_arm_providers.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_dual_arm_providers.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_dual_arm_providers.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_dual_arm_providers.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_evaluation.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_evaluation.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_evaluation.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_evaluation.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_grasps.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_grasps.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_grasps.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_grasps.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_manipulation_cases.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_manipulation_cases.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_manipulation_cases.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_manipulation_cases.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_motion_cases.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_motion_cases.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_motion_cases.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_motion_cases.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_objects.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_objects.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_objects.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_objects.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_policy.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_policy.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_policy.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_policy.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_replay.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_replay.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_replay.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_replay.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_skill.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_skill.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_skill.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_skill.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_skill_providers.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_skill_providers.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/atomic_skill_providers.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/atomic_skill_providers.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/base.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/base.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/base.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/base.py diff --git a/extensions/embodichain_benchmarks/motion_generation/scenarios/free_space.py b/embodichain/extensions/benchmarks/motion_generation/scenarios/free_space.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/scenarios/free_space.py rename to embodichain/extensions/benchmarks/motion_generation/scenarios/free_space.py diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_coordinated_placement.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_coordinated_placement.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_coordinated_placement.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_coordinated_placement.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_hand_over.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_hand_over.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_hand_over.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_franka_robotiq_hand_over.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_pickment_spatial_generalization.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_coordinated_placement_spatial_generalization.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_dual_ur5_pgi_hand_over_spatial_generalization.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_door_pour_align_push.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_door_pour_align_push.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_door_pour_align_push.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_door_pour_align_push.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_pose_batch.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_pose_batch.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_pose_batch.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_pose_batch.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_randomized.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_randomized.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_randomized.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_randomized.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_smoke.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_smoke.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_smoke.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_smoke.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_spatial_generalization.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_spatial_generalization.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_franka_robotiq_spatial_generalization.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_franka_robotiq_spatial_generalization.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml similarity index 96% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml index f7071d94dd..a40008d8cc 100644 --- a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml +++ b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_ur5_embodiment.yaml @@ -4,7 +4,7 @@ suite_version: atomic_ur5_embodiment_v5 profile: smoke embodiment: - component: embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml initial_qpos: [0.0, -1.57, 1.57, -1.57, -1.57, 0.0, 0.0, 0.0] planners: diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/atomic_ur5_pgi_randomized.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/atomic_ur5_pgi_randomized.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/atomic_ur5_pgi_randomized.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/atomic_ur5_pgi_randomized.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/motion_panda_free_space_coverage.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/motion_panda_free_space_coverage.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/motion_panda_free_space_coverage.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/motion_panda_free_space_coverage.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/suites/motion_ur5_free_space_coverage.yaml b/embodichain/extensions/benchmarks/motion_generation/suites/motion_ur5_free_space_coverage.yaml similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/suites/motion_ur5_free_space_coverage.yaml rename to embodichain/extensions/benchmarks/motion_generation/suites/motion_ur5_free_space_coverage.yaml diff --git a/extensions/embodichain_benchmarks/motion_generation/video.py b/embodichain/extensions/benchmarks/motion_generation/video.py similarity index 100% rename from extensions/embodichain_benchmarks/motion_generation/video.py rename to embodichain/extensions/benchmarks/motion_generation/video.py diff --git a/extensions/embodichain_models/README.md b/embodichain/extensions/models/README.md similarity index 63% rename from extensions/embodichain_models/README.md rename to embodichain/extensions/models/README.md index 7c215456ba..53347d83d2 100644 --- a/extensions/embodichain_models/README.md +++ b/embodichain/extensions/models/README.md @@ -1,7 +1,7 @@ # Official models -`embodichain_models` contains official model implementations grouped by model -family, including `embodichain_models.dynamics.nerd`. It ships in the same +`embodichain.extensions.models` contains official model implementations grouped by model +family, including `embodichain.extensions.models.dynamics.nerd`. It ships in the same `embodichain` wheel and uses that distribution's version and dependencies. There is no separate model distribution, version file or model registry. @@ -20,7 +20,7 @@ working directory. Example helpers remain owned by their example workflows. ## Domains and public imports -Organize implementations as `embodichain_models..`. +Organize implementations as `embodichain.extensions.models..`. The first level describes the model's prediction contract: | Domain | Prediction contract | @@ -32,31 +32,31 @@ Use the following canonical packages for the current model directions: | Model family | Public package | Landing status | | --- | --- | --- | -| Ordinary state/visual BC | `embodichain_models.policy.bc` | Target for the BC follow-up; not created yet. | -| Visual ACT | `embodichain_models.policy.act` | Official LeRobot ACT configuration, provenance and simulator inference. | -| NeRD | `embodichain_models.dynamics.nerd` | Network/codec, shared SL, independent transition/geometry and learning-env consumers. | -| Robot world model (RWM) | `embodichain_models.dynamics.rwm` | Implemented. | -| RigidFormer | `embodichain_models.dynamics.rigidformer` | Native author architecture, official weights and shared-SL recipe. | -| WorldParticle | `embodichain_models.dynamics.worldparticle` | Frozen particle transition; optional native deployment and operator qualification are separate. | - -WorldParticle's [showcase](../../examples/learning/worldparticle/README.md), -[input contract](../../examples/learning/worldparticle/INPUTS.md), -[native quickstart](../../examples/learning/worldparticle/DEPLOYMENT.md) and -[runtime requirements](../../examples/learning/worldparticle/README.md#runtime-requirements) -cover the frozen inference path. A [verification summary](../../examples/learning/worldparticle/README.md#verification) +| Ordinary state/visual BC | `embodichain.extensions.models.policy.bc` | Target for the BC follow-up; not created yet. | +| Visual ACT | `embodichain.extensions.models.policy.act` | Official LeRobot ACT configuration, provenance and simulator inference. | +| NeRD | `embodichain.extensions.models.dynamics.nerd` | Network/codec, shared SL, independent transition/geometry and learning-env consumers. | +| Robot world model (RWM) | `embodichain.extensions.models.dynamics.rwm` | Implemented. | +| RigidFormer | `embodichain.extensions.models.dynamics.rigidformer` | Native author architecture, official weights and shared-SL recipe. | +| WorldParticle | `embodichain.extensions.models.dynamics.worldparticle` | Frozen particle transition; optional native deployment and operator qualification are separate. | + +WorldParticle's [showcase](../../../examples/learning/worldparticle/README.md), +[input contract](../../../examples/learning/worldparticle/INPUTS.md), +[native quickstart](../../../examples/learning/worldparticle/DEPLOYMENT.md) and +[runtime requirements](../../../examples/learning/worldparticle/README.md#runtime-requirements) +cover the frozen inference path. A [verification summary](../../../examples/learning/worldparticle/README.md#verification) states the checked headless/offscreen scope. It has no shared-SL recipe, learning-env or qualified functional-gradient/APG contract in this stage. Visual ACT's configuration and inference adapters are documented in the -[API reference](../../docs/source/api_reference/visual_act.rst); its runnable -workflow lives in [examples/learning/act](../../examples/learning/act/README.md). +[API reference](../../../docs/source/api_reference/visual_act.rst); its runnable +workflow lives in [examples/learning/act](../../../examples/learning/act/README.md). -NeRD's [showcase](../../examples/learning/nerd/README.md) separates offline SL, +NeRD's [showcase](../../../examples/learning/nerd/README.md) separates offline SL, learning-env policy optimization and the optional -[native solver quickstart](../../examples/learning/nerd/DEPLOYMENT.md). -Its [execution record](../../examples/learning/nerd/VALIDATION.md) states the +[native solver quickstart](../../../examples/learning/nerd/DEPLOYMENT.md). +Its [execution record](../../../examples/learning/nerd/VALIDATION.md) states the tested runtime/budgets. Native deployment adapters have their own -[solver extension guide](../embodichain_solvers/README.md). +[solver extension guide](../solvers/README.md). RWM predicts action-conditioned robot state transitions, so it belongs to `dynamics`. World models also describe future-state/observation prediction; @@ -86,4 +86,4 @@ remain in core. Shared-SL families use the same SL contracts regardless of their domain. Create a family only when its implementation lands, without empty placeholder directories, eager cross-family imports or a new registry. -For third-party training ownership and dependency profiles, see the [LeRobot guide](../../docs/source/guides/lerobot.md) and [training framework comparison](../../docs/source/guides/training_frameworks.md). +For third-party training ownership and dependency profiles, see the [LeRobot guide](../../../docs/source/guides/lerobot.md) and [training framework comparison](../../../docs/source/guides/training_frameworks.md). diff --git a/extensions/embodichain_models/embodichain_models/__init__.py b/embodichain/extensions/models/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/__init__.py rename to embodichain/extensions/models/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/__init__.py b/embodichain/extensions/models/dynamics/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/__init__.py rename to embodichain/extensions/models/dynamics/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/THIRD_PARTY_LICENSES b/embodichain/extensions/models/dynamics/nerd/THIRD_PARTY_LICENSES similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/THIRD_PARTY_LICENSES rename to embodichain/extensions/models/dynamics/nerd/THIRD_PARTY_LICENSES diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/__init__.py b/embodichain/extensions/models/dynamics/nerd/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/__init__.py rename to embodichain/extensions/models/dynamics/nerd/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/_numerics.py b/embodichain/extensions/models/dynamics/nerd/_numerics.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/_numerics.py rename to embodichain/extensions/models/dynamics/nerd/_numerics.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/_resident.py b/embodichain/extensions/models/dynamics/nerd/_resident.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/_resident.py rename to embodichain/extensions/models/dynamics/nerd/_resident.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/checkpoint.py b/embodichain/extensions/models/dynamics/nerd/checkpoint.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/checkpoint.py rename to embodichain/extensions/models/dynamics/nerd/checkpoint.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/codec.py b/embodichain/extensions/models/dynamics/nerd/codec.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/codec.py rename to embodichain/extensions/models/dynamics/nerd/codec.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/data.py b/embodichain/extensions/models/dynamics/nerd/data.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/data.py rename to embodichain/extensions/models/dynamics/nerd/data.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/geometry.py b/embodichain/extensions/models/dynamics/nerd/geometry.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/geometry.py rename to embodichain/extensions/models/dynamics/nerd/geometry.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/integration.py b/embodichain/extensions/models/dynamics/nerd/integration.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/integration.py rename to embodichain/extensions/models/dynamics/nerd/integration.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py b/embodichain/extensions/models/dynamics/nerd/model.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py rename to embodichain/extensions/models/dynamics/nerd/model.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/sl_recipe.py b/embodichain/extensions/models/dynamics/nerd/sl_recipe.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/sl_recipe.py rename to embodichain/extensions/models/dynamics/nerd/sl_recipe.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/supervised.py b/embodichain/extensions/models/dynamics/nerd/supervised.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/supervised.py rename to embodichain/extensions/models/dynamics/nerd/supervised.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/nerd/transition.py b/embodichain/extensions/models/dynamics/nerd/transition.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/nerd/transition.py rename to embodichain/extensions/models/dynamics/nerd/transition.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/REFERENCE_SOURCES.json b/embodichain/extensions/models/dynamics/rigidformer/REFERENCE_SOURCES.json similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/REFERENCE_SOURCES.json rename to embodichain/extensions/models/dynamics/rigidformer/REFERENCE_SOURCES.json diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/THIRD_PARTY_LICENSES b/embodichain/extensions/models/dynamics/rigidformer/THIRD_PARTY_LICENSES similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/THIRD_PARTY_LICENSES rename to embodichain/extensions/models/dynamics/rigidformer/THIRD_PARTY_LICENSES diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/__init__.py b/embodichain/extensions/models/dynamics/rigidformer/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/__init__.py rename to embodichain/extensions/models/dynamics/rigidformer/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/__init__.py b/embodichain/extensions/models/dynamics/rigidformer/_native/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/__init__.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/attention.py b/embodichain/extensions/models/dynamics/rigidformer/_native/attention.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/attention.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/attention.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/__init__.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/__init__.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/_index.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/_index.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/_index.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/_index.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/dataset.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/dataset.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/dataset.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/dataset.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/gpu_augmentation.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/gpu_augmentation.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/gpu_augmentation.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/gpu_augmentation.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/object_scale.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/object_scale.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/object_scale.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/object_scale.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/scene_frames.py b/embodichain/extensions/models/dynamics/rigidformer/_native/data/scene_frames.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/data/scene_frames.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/data/scene_frames.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/__init__.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/__init__.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/anchor_vertex_pooling.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/anchor_vertex_pooling.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/anchor_vertex_pooling.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/anchor_vertex_pooling.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/decoder.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/decoder.py similarity index 99% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/decoder.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/decoder.py index ccc02b3fab..3f04a95f19 100644 --- a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/decoder.py +++ b/embodichain/extensions/models/dynamics/rigidformer/_native/models/decoder.py @@ -23,7 +23,7 @@ logger = logging.getLogger(__name__) -from embodichain_models.dynamics.rigidformer._native.models.physformer_rope import ( +from embodichain.extensions.models.dynamics.rigidformer._native.models.physformer_rope import ( PhysFormerRoPE, apply_rotary_emb, ) @@ -625,7 +625,7 @@ def __init__( # when use_se3=True. if objects_self_attention: if use_se3: - from embodichain_models.dynamics.rigidformer._native.models.se3_attention import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.se3_attention import ( SelfAttentionWithSE3Bias, ) @@ -669,7 +669,7 @@ def __init__( # Per-layer FiLM conditioning on step size self.layer_film = None if film_conditioning: - from embodichain_models.dynamics.rigidformer._native.models.encoder import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.encoder import ( StepSizeFiLM, ) diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/encoder.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/encoder.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/encoder.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/encoder.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/geometry_encoders.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/geometry_encoders.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/geometry_encoders.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/geometry_encoders.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/multi_scale_predictor.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/multi_scale_predictor.py similarity index 99% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/multi_scale_predictor.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/multi_scale_predictor.py index d01fcbdc34..2f67caccf5 100644 --- a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/multi_scale_predictor.py +++ b/embodichain/extensions/models/dynamics/rigidformer/_native/models/multi_scale_predictor.py @@ -16,7 +16,7 @@ from typing import List, Optional, Tuple # Import RoPE modules for position-aware attention -from embodichain_models.dynamics.rigidformer._native.models.decoder import ( +from embodichain.extensions.models.dynamics.rigidformer._native.models.decoder import ( CrossAttentionWithRoPE, SelfAttentionWithRoPE, ) diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/physformer_rope.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/physformer_rope.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/physformer_rope.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/physformer_rope.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/predictor.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/predictor.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/predictor.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/predictor.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/se3_attention.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/se3_attention.py similarity index 99% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/se3_attention.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/se3_attention.py index 3eaf581004..280e9acc18 100644 --- a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/se3_attention.py +++ b/embodichain/extensions/models/dynamics/rigidformer/_native/models/se3_attention.py @@ -248,7 +248,7 @@ def __init__( # QK-normalization if self.qk_norm: - from embodichain_models.dynamics.rigidformer._native.models.decoder import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.decoder import ( RMSNorm, ) diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/state.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/state.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/state.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/state.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/transform_layer.py b/embodichain/extensions/models/dynamics/rigidformer/_native/models/transform_layer.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/models/transform_layer.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/models/transform_layer.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/network.py b/embodichain/extensions/models/dynamics/rigidformer/_native/network.py similarity index 99% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/network.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/network.py index 0b20da64d2..ce51106c00 100644 --- a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/network.py +++ b/embodichain/extensions/models/dynamics/rigidformer/_native/network.py @@ -129,7 +129,7 @@ def __init__(self, config): self._ref_pose_object_centered = bool( config["model"].get("ref_pose_object_centered", False) ) - from embodichain_models.dynamics.rigidformer._native.models.physformer_rope import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.physformer_rope import ( PhysFormerRoPE as _RopeCls, ) @@ -317,7 +317,7 @@ def __init__(self, config): # ============================================================ # Multi-scale predictor reads features from selected decoder layers (CUT3R-style) - from embodichain_models.dynamics.rigidformer._native.models.multi_scale_predictor import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.multi_scale_predictor import ( QueryBasedMultiScalePredictor, ) @@ -478,7 +478,7 @@ def __init__(self, config): self._avp_enabled = avp_cfg.get("enable", False) self._avp_output_dim = avp_cfg.get("output_dim", 256) if self._avp_enabled: - from embodichain_models.dynamics.rigidformer._native.models.anchor_vertex_pooling import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.anchor_vertex_pooling import ( AnchorVertexPooling, ) @@ -699,7 +699,7 @@ def __init__(self, config): # FiLM conditioning: modulate encoder output with [s, s²] instead of # concatenating step size to the input features if self._film_conditioning and self._if_time_step: - from embodichain_models.dynamics.rigidformer._native.models.encoder import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.encoder import ( StepSizeFiLM, ) @@ -737,7 +737,7 @@ def __init__(self, config): self._geometry_encoder = None if self._pe_type in ("obb", "pca"): - from embodichain_models.dynamics.rigidformer._native.models.geometry_encoders import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.geometry_encoders import ( OBBEncoder, PCAFrameEncoder, ) @@ -756,7 +756,7 @@ def __init__(self, config): # SE(3) pairwise bias module self._se3_bias_module = None if self._pe_type == "se3": - from embodichain_models.dynamics.rigidformer._native.models.se3_attention import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.se3_attention import ( SE3PairwiseBias, ) @@ -1396,7 +1396,7 @@ def _net_step( # ============== SE(3) Pairwise Bias Computation ============== _se3_bias = None if self._pe_type == "se3" and self._se3_bias_module is not None: - from embodichain_models.dynamics.rigidformer._native.models.se3_attention import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.se3_attention import ( extract_object_pose_features, ) @@ -2658,7 +2658,7 @@ def rollout( # ============== SE(3) Pairwise Bias Computation (rollout) ============== _se3_bias = None if self._pe_type == "se3" and self._se3_bias_module is not None: - from embodichain_models.dynamics.rigidformer._native.models.se3_attention import ( + from embodichain.extensions.models.dynamics.rigidformer._native.models.se3_attention import ( extract_object_pose_features, ) diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/__init__.py b/embodichain/extensions/models/dynamics/rigidformer/_native/utils/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/__init__.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/utils/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/anchor_rotation.py b/embodichain/extensions/models/dynamics/rigidformer/_native/utils/anchor_rotation.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/anchor_rotation.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/utils/anchor_rotation.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/cuda_knn.py b/embodichain/extensions/models/dynamics/rigidformer/_native/utils/cuda_knn.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/cuda_knn.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/utils/cuda_knn.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/intersection_handler.py b/embodichain/extensions/models/dynamics/rigidformer/_native/utils/intersection_handler.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/intersection_handler.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/utils/intersection_handler.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/weight_ema.py b/embodichain/extensions/models/dynamics/rigidformer/_native/utils/weight_ema.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/_native/utils/weight_ema.py rename to embodichain/extensions/models/dynamics/rigidformer/_native/utils/weight_ema.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/checkpoint.py b/embodichain/extensions/models/dynamics/rigidformer/checkpoint.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/checkpoint.py rename to embodichain/extensions/models/dynamics/rigidformer/checkpoint.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_a.yaml b/embodichain/extensions/models/dynamics/rigidformer/configs/movi_a.yaml similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_a.yaml rename to embodichain/extensions/models/dynamics/rigidformer/configs/movi_a.yaml diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_b.yaml b/embodichain/extensions/models/dynamics/rigidformer/configs/movi_b.yaml similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_b.yaml rename to embodichain/extensions/models/dynamics/rigidformer/configs/movi_b.yaml diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_sphere.yaml b/embodichain/extensions/models/dynamics/rigidformer/configs/movi_sphere.yaml similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/configs/movi_sphere.yaml rename to embodichain/extensions/models/dynamics/rigidformer/configs/movi_sphere.yaml diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/data.py b/embodichain/extensions/models/dynamics/rigidformer/data.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/data.py rename to embodichain/extensions/models/dynamics/rigidformer/data.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/ema.py b/embodichain/extensions/models/dynamics/rigidformer/ema.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/ema.py rename to embodichain/extensions/models/dynamics/rigidformer/ema.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/model.py b/embodichain/extensions/models/dynamics/rigidformer/model.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/model.py rename to embodichain/extensions/models/dynamics/rigidformer/model.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/sl_recipe.py b/embodichain/extensions/models/dynamics/rigidformer/sl_recipe.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/sl_recipe.py rename to embodichain/extensions/models/dynamics/rigidformer/sl_recipe.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rigidformer/supervised.py b/embodichain/extensions/models/dynamics/rigidformer/supervised.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rigidformer/supervised.py rename to embodichain/extensions/models/dynamics/rigidformer/supervised.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/__init__.py b/embodichain/extensions/models/dynamics/rwm/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/__init__.py rename to embodichain/extensions/models/dynamics/rwm/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/kinematic.py b/embodichain/extensions/models/dynamics/rwm/kinematic.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/kinematic.py rename to embodichain/extensions/models/dynamics/rwm/kinematic.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py b/embodichain/extensions/models/dynamics/rwm/model.py similarity index 99% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py rename to embodichain/extensions/models/dynamics/rwm/model.py index 0ca3e6dbf3..2d41a41859 100644 --- a/extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py +++ b/embodichain/extensions/models/dynamics/rwm/model.py @@ -79,7 +79,7 @@ class RobotWorldModel(nn.Module): Args: cfg: Model dimensions and physical/control identity. Canonical states - have width ``18 + 2*num_joints``; see ``embodichain_models.dynamics.rwm.robot_state``. + have width ``18 + 2*num_joints``; see ``embodichain.extensions.models.dynamics.rwm.robot_state``. Statistics update only through :meth:`update_normalization`, never during :meth:`forward`. The model starts as an identity transition because its diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/predictor.py b/embodichain/extensions/models/dynamics/rwm/predictor.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/predictor.py rename to embodichain/extensions/models/dynamics/rwm/predictor.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/replay.py b/embodichain/extensions/models/dynamics/rwm/replay.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/replay.py rename to embodichain/extensions/models/dynamics/rwm/replay.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/robot_state.py b/embodichain/extensions/models/dynamics/rwm/robot_state.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/robot_state.py rename to embodichain/extensions/models/dynamics/rwm/robot_state.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py b/embodichain/extensions/models/dynamics/rwm/sl_recipe.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py rename to embodichain/extensions/models/dynamics/rwm/sl_recipe.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/rwm/supervised.py b/embodichain/extensions/models/dynamics/rwm/supervised.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/rwm/supervised.py rename to embodichain/extensions/models/dynamics/rwm/supervised.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/LICENSE.tome b/embodichain/extensions/models/dynamics/worldparticle/LICENSE.tome similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/LICENSE.tome rename to embodichain/extensions/models/dynamics/worldparticle/LICENSE.tome diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/LICENSE.worldparticle b/embodichain/extensions/models/dynamics/worldparticle/LICENSE.worldparticle similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/LICENSE.worldparticle rename to embodichain/extensions/models/dynamics/worldparticle/LICENSE.worldparticle diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/PROVENANCE.json b/embodichain/extensions/models/dynamics/worldparticle/PROVENANCE.json similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/PROVENANCE.json rename to embodichain/extensions/models/dynamics/worldparticle/PROVENANCE.json diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/__init__.py b/embodichain/extensions/models/dynamics/worldparticle/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/__init__.py rename to embodichain/extensions/models/dynamics/worldparticle/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/_data.py b/embodichain/extensions/models/dynamics/worldparticle/_network/_data.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/_data.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/_data.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/continuous_conv.py b/embodichain/extensions/models/dynamics/worldparticle/_network/continuous_conv.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/continuous_conv.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/continuous_conv.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/cross_attn_feat.py b/embodichain/extensions/models/dynamics/worldparticle/_network/cross_attn_feat.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/cross_attn_feat.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/cross_attn_feat.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/encodings/rms_norm.py b/embodichain/extensions/models/dynamics/worldparticle/_network/encodings/rms_norm.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/encodings/rms_norm.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/encodings/rms_norm.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/encodings/rope.py b/embodichain/extensions/models/dynamics/worldparticle/_network/encodings/rope.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/encodings/rope.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/encodings/rope.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/layers/attention.py b/embodichain/extensions/models/dynamics/worldparticle/_network/layers/attention.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/layers/attention.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/layers/attention.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/layers/merge.py b/embodichain/extensions/models/dynamics/worldparticle/_network/layers/merge.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/layers/merge.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/layers/merge.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/particle_network_cross_attn_feat.py b/embodichain/extensions/models/dynamics/worldparticle/_network/particle_network_cross_attn_feat.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/particle_network_cross_attn_feat.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/particle_network_cross_attn_feat.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/super_particle_layers.py b/embodichain/extensions/models/dynamics/worldparticle/_network/super_particle_layers.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_network/super_particle_layers.py rename to embodichain/extensions/models/dynamics/worldparticle/_network/super_particle_layers.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_runtime.py b/embodichain/extensions/models/dynamics/worldparticle/_runtime.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/_runtime.py rename to embodichain/extensions/models/dynamics/worldparticle/_runtime.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/data.py b/embodichain/extensions/models/dynamics/worldparticle/data.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/data.py rename to embodichain/extensions/models/dynamics/worldparticle/data.py diff --git a/extensions/embodichain_models/embodichain_models/dynamics/worldparticle/model.py b/embodichain/extensions/models/dynamics/worldparticle/model.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/dynamics/worldparticle/model.py rename to embodichain/extensions/models/dynamics/worldparticle/model.py diff --git a/extensions/embodichain_models/embodichain_models/policies/__init__.py b/embodichain/extensions/models/policies/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policies/__init__.py rename to embodichain/extensions/models/policies/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/policies/motion_tracking.py b/embodichain/extensions/models/policies/motion_tracking.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policies/motion_tracking.py rename to embodichain/extensions/models/policies/motion_tracking.py diff --git a/extensions/embodichain_models/embodichain_models/policy/__init__.py b/embodichain/extensions/models/policy/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policy/__init__.py rename to embodichain/extensions/models/policy/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/policy/act/__init__.py b/embodichain/extensions/models/policy/act/__init__.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policy/act/__init__.py rename to embodichain/extensions/models/policy/act/__init__.py diff --git a/extensions/embodichain_models/embodichain_models/policy/act/runtime.py b/embodichain/extensions/models/policy/act/runtime.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policy/act/runtime.py rename to embodichain/extensions/models/policy/act/runtime.py diff --git a/extensions/embodichain_models/embodichain_models/policy/act/training.py b/embodichain/extensions/models/policy/act/training.py similarity index 100% rename from extensions/embodichain_models/embodichain_models/policy/act/training.py rename to embodichain/extensions/models/policy/act/training.py diff --git a/extensions/embodichain_robots/README.md b/embodichain/extensions/robots/README.md similarity index 89% rename from extensions/embodichain_robots/README.md rename to embodichain/extensions/robots/README.md index b2d5c1b23c..6ef0939f59 100644 --- a/extensions/embodichain_robots/README.md +++ b/embodichain/extensions/robots/README.md @@ -1,11 +1,11 @@ -# embodichain_robots +# embodichain.extensions.robots Official robot configurations bundled with the `embodichain` distribution. This import package shares the repository, version, dependencies, and wheel -with the core and `embodichain_tasks`; it has no independent release metadata. +with the core and `embodichain.extensions.tasks`; it has no independent release metadata. ```python -from embodichain_robots import FrankaCfg +from embodichain.extensions.robots import FrankaCfg cfg = FrankaCfg.from_dict({"arm_model": "panda"}) robot = sim.add_robot(cfg=cfg) @@ -24,7 +24,7 @@ their existing owners. ## Vendor/model ownership and migration Concrete configurations use vendor/model namespaces, such as -`embodichain_robots.franka.panda` and `embodichain_robots.dexforce.w1`. +`embodichain.extensions.robots.franka.panda` and `embodichain.extensions.robots.dexforce.w1`. Model-owned archives belong in `//assets.py`, beside `cfg.py`. Franka's Panda/FR3 archive and the shared UR archive use vendor-level `assets.py`. Vendor/model initializers are lazy so importing an asset never loads robot code. @@ -32,7 +32,7 @@ Vendor/model initializers are lazy so importing an asset never loads robot code. Root configuration imports and catalog IDs remain stable, except that `FrankaPandaPgiCfg` and `FrankaPandaPgi` have been removed. Panda/PGI examples and benchmark providers assemble that combination locally. Flat configuration -submodules such as `embodichain_robots.franka_panda` are retired. +submodules such as `embodichain.extensions.robots.franka_panda` are retired. Robot catalogs declare optional `vendor`, `morphology`, and `arm_count` metadata. Morphology describes the authored body (for example `wheeled_humanoid`), @@ -44,7 +44,7 @@ The separate, metadata-only `_asset_catalog.py` registers resources through: ```toml [project.entry-points."embodichain.assets"] -official_robots = "embodichain_robots._asset_catalog:ROBOT_ASSETS" +official_robots = "embodichain.extensions.robots._asset_catalog:ROBOT_ASSETS" ``` Each asset ID maps to a `class_path` (`module:Class`) and a `category`. The core @@ -59,18 +59,18 @@ their current core ownership. | Catalog ID | Canonical module | Morphology | Arms | | --- | --- | --- | --- | -| `UnitreeGo1` | `embodichain_robots.unitree.go1` | `quadruped` | 0 | -| `UnitreeGo2` | `embodichain_robots.unitree.go2` | `quadruped` | 0 | -| `UnitreeG1` | `embodichain_robots.unitree.g1` | `bipedal_humanoid` | 2 | -| `UnitreeH1_2` | `embodichain_robots.unitree.h1_2` | `bipedal_humanoid` | 2 | -| `ANYmalC` | `embodichain_robots.anybotics.anymal_c` | `quadruped` | 0 | -| `MicroDuck` | `embodichain_robots.pollen_robotics.microduck` | `biped` | 0 | +| `UnitreeGo1` | `embodichain.extensions.robots.unitree.go1` | `quadruped` | 0 | +| `UnitreeGo2` | `embodichain.extensions.robots.unitree.go2` | `quadruped` | 0 | +| `UnitreeG1` | `embodichain.extensions.robots.unitree.g1` | `bipedal_humanoid` | 2 | +| `UnitreeH1_2` | `embodichain.extensions.robots.unitree.h1_2` | `bipedal_humanoid` | 2 | +| `ANYmalC` | `embodichain.extensions.robots.anybotics.anymal_c` | `quadruped` | 0 | +| `MicroDuck` | `embodichain.extensions.robots.pollen_robotics.microduck` | `biped` | 0 | Each model owns `cfg.py`, `assets.py` and a wheel-packaged `profile.json`. The shared profile reader remains backend-free. Root configuration imports and catalog IDs remain stable; use these vendor/model paths for submodule -imports. For example, `embodichain_robots.unitree_go2` is replaced by -`embodichain_robots.unitree.go2`. +imports. For example, `embodichain.extensions.robots.unitree_go2` is replaced by +`embodichain.extensions.robots.unitree.go2`. The catalog includes `UnitreeGo1`, `UnitreeGo2`, `UnitreeG1`, `UnitreeH1_2`, `ANYmalC` and `MicroDuck`. G1 selects the bundled 29-joint model; H1_2 selects @@ -81,13 +81,13 @@ not manufacturer-verified hardware parameters or Isaac Lab actuator networks. | Unitree Go1 | Unitree Go2 | ANYmal-C | | --- | --- | --- | -| ![Unitree Go1](../../docs/source/_static/robots/unitree_go1.png) | ![Unitree Go2](../../docs/source/_static/robots/unitree_go2.png) | ![ANYmal-C](../../docs/source/_static/robots/anymal_c.png) | +| ![Unitree Go1](../../../docs/source/_static/robots/unitree_go1.png) | ![Unitree Go2](../../../docs/source/_static/robots/unitree_go2.png) | ![ANYmal-C](../../../docs/source/_static/robots/anymal_c.png) | | Unitree G1 | Unitree H1_2 | MicroDuck | | --- | --- | --- | -| ![Unitree G1](../../docs/source/_static/robots/unitree_g1.png) | ![Unitree H1_2](../../docs/source/_static/robots/unitree_h1_2.png) | ![MicroDuck](../../docs/source/_static/robots/microduck.png) | +| ![Unitree G1](../../../docs/source/_static/robots/unitree_g1.png) | ![Unitree H1_2](../../../docs/source/_static/robots/unitree_h1_2.png) | ![MicroDuck](../../../docs/source/_static/robots/microduck.png) | -Each model has its own [robot documentation page](../../docs/source/resources/robot/locomotion.md) +Each model has its own [robot documentation page](../../../docs/source/resources/robot/locomotion.md) with an individual image, usage example and configuration summary. DexSim OfflineRT (`rt`), 1 sample per pixel with DLSS denoising, shared preview @@ -294,7 +294,7 @@ DualArmRobot variants; the runtime still validates the selected configuration. ## Imports and installation -Import concrete robot configurations from `embodichain_robots`. Generic dual-arm +Import concrete robot configurations from `embodichain.extensions.robots`. Generic dual-arm helpers remain in `embodichain.lab.sim.robots.dual_arm`. The former concrete modules and exports under `embodichain.lab.sim.robots` have been removed. diff --git a/extensions/embodichain_robots/__init__.py b/embodichain/extensions/robots/__init__.py similarity index 100% rename from extensions/embodichain_robots/__init__.py rename to embodichain/extensions/robots/__init__.py diff --git a/embodichain/extensions/robots/_asset_catalog.py b/embodichain/extensions/robots/_asset_catalog.py new file mode 100644 index 0000000000..053c781005 --- /dev/null +++ b/embodichain/extensions/robots/_asset_catalog.py @@ -0,0 +1,194 @@ +# ---------------------------------------------------------------------------- +# Copyright (c) 2021-2026 DexForce Technology Co., Ltd. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# ---------------------------------------------------------------------------- + +"""Official robot and end-effector asset IDs; metadata only, with no implementation imports.""" + +from __future__ import annotations + +ROBOT_ASSETS = { + "AgibotG2": { + "class_path": "embodichain.extensions.robots.agibot.g2.assets:AgibotG2", + "category": "robot", + }, + "AgibotG1": { + "class_path": "embodichain.extensions.robots.agibot.g1.assets:AgibotG1", + "category": "robot", + }, + "YamI2rt": { + "class_path": "embodichain.extensions.robots.i2rt.yam.assets:YamI2rt", + "category": "robot", + }, + "UnitreeGo1Locomotion": { + "class_path": "embodichain.extensions.robots.unitree.go1.assets:UnitreeGo1Locomotion", + "category": "robot", + }, + "UnitreeGo2Locomotion": { + "class_path": "embodichain.extensions.robots.unitree.go2.assets:UnitreeGo2Locomotion", + "category": "robot", + }, + "UnitreeG1Locomotion": { + "class_path": "embodichain.extensions.robots.unitree.g1.assets:UnitreeG1Locomotion", + "category": "robot", + }, + "UnitreeH1_2Locomotion": { + "class_path": "embodichain.extensions.robots.unitree.h1_2.assets:UnitreeH1_2Locomotion", + "category": "robot", + }, + "ANYmalCLocomotion": { + "class_path": "embodichain.extensions.robots.anybotics.anymal_c.assets:ANYmalCLocomotion", + "category": "robot", + }, + "MicroDuckLocomotion": { + "class_path": "embodichain.extensions.robots.pollen_robotics.microduck.assets:MicroDuckLocomotion", + "category": "robot", + }, + "AgilexPiperX": { + "class_path": "embodichain.extensions.robots.agilex.piper_x.assets:AgilexPiperX", + "category": "robot", + }, + "CobotMagicArm": { + "class_path": "embodichain.extensions.robots.agilex.cobotmagic.assets:CobotMagicArm", + "category": "robot", + }, + "ARX5": { + "class_path": "embodichain.extensions.robots.arx.arx5.assets:ARX5", + "category": "robot", + }, + "AlohaMini": { + "class_path": "embodichain.extensions.robots.alohamini.aloha_mini.assets:AlohaMini", + "category": "robot", + }, + "TianjiMarvin": { + "class_path": "embodichain.extensions.robots.tianji.marvin.assets:TianjiMarvin", + "category": "robot", + }, + "FlexivRizon4S": { + "class_path": "embodichain.extensions.robots.flexiv.rizon4s.assets:FlexivRizon4S", + "category": "robot", + }, + "FrankaPandaArm": { + "class_path": "embodichain.extensions.robots.franka.assets:FrankaPandaArm", + "category": "robot", + }, + "Franka": { + "class_path": "embodichain.extensions.robots.franka.assets:Franka", + "category": "robot", + }, + "UniversalRobots": { + "class_path": "embodichain.extensions.robots.universal_robots.assets:UniversalRobots", + "category": "robot", + }, + "DexforceW1V021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1V021", + "category": "w1", + }, + "DexforceW1V022": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1V022", + "category": "w1", + }, + "DexforceW1V025": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1V025", + "category": "w1", + }, + "DexforceW1V030": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1V030", + "category": "w1", + }, + "DexforceW1ChassisV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1ChassisV021", + "category": "w1", + }, + "DexforceW1TorsoV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1TorsoV021", + "category": "w1", + }, + "DexforceW1EyesV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1EyesV021", + "category": "w1", + }, + "DexforceW1HeadV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1HeadV021", + "category": "w1", + }, + "DexforceW1LeftArmV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1LeftArmV021", + "category": "w1", + }, + "DexforceW1RightArmV021": { + "class_path": "embodichain.extensions.robots.dexforce.w1.assets:DexforceW1RightArmV021", + "category": "w1", + }, + "SO101FollowerAssets": { + "class_path": "embodichain.extensions.robots.the_robot_studio.so101.assets:SO101FollowerAssets", + "category": "robot", + }, + "DH_PGC_140_50": { + "class_path": "embodichain.extensions.robots.dh_robotics.pgc_140_50.assets:DH_PGC_140_50", + "category": "eef", + }, + "DH_PGC_140_50_M": { + "class_path": "embodichain.extensions.robots.dh_robotics.pgc_140_50.assets:DH_PGC_140_50_M", + "category": "eef", + }, + "DH_PGI_140_80": { + "class_path": "embodichain.extensions.robots.dh_robotics.pgi_140_80.assets:DH_PGI_140_80", + "category": "eef", + }, + "DH_AG95": { + "class_path": "embodichain.extensions.robots.dh_robotics.ag95.assets:DH_AG95", + "category": "eef", + }, + "ZH_CTM2F110": { + "class_path": "embodichain.extensions.robots.changingtek.ctm2f110.assets:ZH_CTM2F110", + "category": "eef", + }, + "BrainCoHandRevo1": { + "class_path": "embodichain.extensions.robots.brainco.revo1.assets:BrainCoHandRevo1", + "category": "eef", + }, + "InspireHand": { + "class_path": "embodichain.extensions.robots.inspire.hand.assets:InspireHand", + "category": "eef", + }, + "Robotiq": { + "class_path": "embodichain.extensions.robots.robotiq.assets:Robotiq", + "category": "eef", + }, + "Robotiq2F85": { + "class_path": "embodichain.extensions.robots.robotiq.robotiq_2f85.assets:Robotiq2F85", + "category": "eef", + }, + "WheelTecFA2F": { + "class_path": "embodichain.extensions.robots.wheeltec.fa2f.assets:WheelTecFA2F", + "category": "eef", + }, + "WujiHand": { + "class_path": "embodichain.extensions.robots.wuji.hand.assets:WujiHand", + "category": "eef", + }, + "SharpaWave": { + "class_path": "embodichain.extensions.robots.sharpa.wave.assets:SharpaWave", + "category": "eef", + }, + "AgxGripper": { + "class_path": "embodichain.extensions.robots.agilex.agx_gripper.assets:AgxGripper", + "category": "eef", + }, + "PikaGripper": { + "class_path": "embodichain.extensions.robots.agilex.pika.assets:PikaGripper", + "category": "eef", + }, +} diff --git a/extensions/embodichain_robots/_catalog.py b/embodichain/extensions/robots/_catalog.py similarity index 83% rename from extensions/embodichain_robots/_catalog.py rename to embodichain/extensions/robots/_catalog.py index 5628901f44..32224a0afc 100644 --- a/extensions/embodichain_robots/_catalog.py +++ b/embodichain/extensions/robots/_catalog.py @@ -21,29 +21,29 @@ from itertools import product _CONFIG_CLASSES = { - "AgibotG2": "embodichain_robots.agibot.g2:AgibotG2Cfg", - "AgibotG1": "embodichain_robots.agibot.g1:AgibotG1Cfg", - "YamI2rt": "embodichain_robots.i2rt.yam:YamI2rtCfg", - "UnitreeGo1": "embodichain_robots.unitree.go1:UnitreeGo1Cfg", - "UnitreeGo2": "embodichain_robots.unitree.go2:UnitreeGo2Cfg", - "UnitreeG1": "embodichain_robots.unitree.g1:UnitreeG1Cfg", - "UnitreeH1_2": "embodichain_robots.unitree.h1_2:UnitreeH12Cfg", - "ANYmalC": "embodichain_robots.anybotics.anymal_c:ANYmalCCfg", - "MicroDuck": "embodichain_robots.pollen_robotics.microduck:MicroDuckCfg", - "ARX5": "embodichain_robots.arx.arx5:ARX5Cfg", - "AlohaMini": "embodichain_robots.alohamini.aloha_mini:AlohaMiniCfg", - "TianjiMarvin": "embodichain_robots.tianji.marvin:TianjiMarvinCfg", - "DexforceW1": "embodichain_robots.dexforce.w1:DexforceW1Cfg", - "CobotMagic": "embodichain_robots.agilex.cobotmagic:CobotMagicCfg", - "AgilexPiperX": "embodichain_robots.agilex.piper_x:AgilexPiperXCfg", - "Franka": "embodichain_robots.franka.cfg:FrankaCfg", - "FrankaPanda": "embodichain_robots.franka.panda:FrankaPandaCfg", - "FlexivRizon4S": "embodichain_robots.flexiv.rizon4s:FlexivRizon4SCfg", - "URRobot": "embodichain_robots.universal_robots.ur_robot:URRobotCfg", - "SO101Follower": "embodichain_robots.the_robot_studio.so101:SO101FollowerCfg", - "BrainCoRevo1": "embodichain_robots.brainco.revo1:BrainCoRevo1Cfg", - "SharpaWave": "embodichain_robots.sharpa.wave:SharpaWaveCfg", - "WujiHand": "embodichain_robots.wuji.hand:WujiHandCfg", + "AgibotG2": "embodichain.extensions.robots.agibot.g2:AgibotG2Cfg", + "AgibotG1": "embodichain.extensions.robots.agibot.g1:AgibotG1Cfg", + "YamI2rt": "embodichain.extensions.robots.i2rt.yam:YamI2rtCfg", + "UnitreeGo1": "embodichain.extensions.robots.unitree.go1:UnitreeGo1Cfg", + "UnitreeGo2": "embodichain.extensions.robots.unitree.go2:UnitreeGo2Cfg", + "UnitreeG1": "embodichain.extensions.robots.unitree.g1:UnitreeG1Cfg", + "UnitreeH1_2": "embodichain.extensions.robots.unitree.h1_2:UnitreeH12Cfg", + "ANYmalC": "embodichain.extensions.robots.anybotics.anymal_c:ANYmalCCfg", + "MicroDuck": "embodichain.extensions.robots.pollen_robotics.microduck:MicroDuckCfg", + "ARX5": "embodichain.extensions.robots.arx.arx5:ARX5Cfg", + "AlohaMini": "embodichain.extensions.robots.alohamini.aloha_mini:AlohaMiniCfg", + "TianjiMarvin": "embodichain.extensions.robots.tianji.marvin:TianjiMarvinCfg", + "DexforceW1": "embodichain.extensions.robots.dexforce.w1:DexforceW1Cfg", + "CobotMagic": "embodichain.extensions.robots.agilex.cobotmagic:CobotMagicCfg", + "AgilexPiperX": "embodichain.extensions.robots.agilex.piper_x:AgilexPiperXCfg", + "Franka": "embodichain.extensions.robots.franka.cfg:FrankaCfg", + "FrankaPanda": "embodichain.extensions.robots.franka.panda:FrankaPandaCfg", + "FlexivRizon4S": "embodichain.extensions.robots.flexiv.rizon4s:FlexivRizon4SCfg", + "URRobot": "embodichain.extensions.robots.universal_robots.ur_robot:URRobotCfg", + "SO101Follower": "embodichain.extensions.robots.the_robot_studio.so101:SO101FollowerCfg", + "BrainCoRevo1": "embodichain.extensions.robots.brainco.revo1:BrainCoRevo1Cfg", + "SharpaWave": "embodichain.extensions.robots.sharpa.wave:SharpaWaveCfg", + "WujiHand": "embodichain.extensions.robots.wuji.hand:WujiHandCfg", } _DEFAULT_CONTROL_INFO = { @@ -384,8 +384,8 @@ def _w1_variant_profile( # Concrete hand defaults share the existing robot entry-point catalog. ROBOT_CONFIGS["FrankaPandaHand"] = { - "class_path": "embodichain_robots.franka.hand.cfg:FrankaPandaHandCfg", - "description_path": "embodichain_robots.franka.hand._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.franka.hand.cfg:FrankaPandaHandCfg", + "description_path": "embodichain.extensions.robots.franka.hand._gripper_defaults:get_gripper_defaults", "vendor": "franka", "morphology": "parallel_gripper", "arm_count": 0, @@ -393,8 +393,8 @@ def _w1_variant_profile( "supports_dual_arm": False, } ROBOT_CONFIGS["DHPGI14080"] = { - "class_path": "embodichain_robots.dh_robotics.pgi_140_80.cfg:DHPGI14080Cfg", - "description_path": "embodichain_robots.dh_robotics.pgi_140_80._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.dh_robotics.pgi_140_80.cfg:DHPGI14080Cfg", + "description_path": "embodichain.extensions.robots.dh_robotics.pgi_140_80._gripper_defaults:get_gripper_defaults", "vendor": "dh_robotics", "morphology": "parallel_gripper", "arm_count": 0, @@ -402,8 +402,8 @@ def _w1_variant_profile( "supports_dual_arm": False, } ROBOT_CONFIGS["CobotMagicV100Gripper"] = { - "class_path": "embodichain_robots.agilex.cobotmagic.gripper.cfg:CobotMagicV100GripperCfg", - "description_path": "embodichain_robots.agilex.cobotmagic.gripper._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.agilex.cobotmagic.gripper.cfg:CobotMagicV100GripperCfg", + "description_path": "embodichain.extensions.robots.agilex.cobotmagic.gripper._gripper_defaults:get_gripper_defaults", "vendor": "agilex", "morphology": "parallel_gripper", "arm_count": 0, @@ -411,8 +411,8 @@ def _w1_variant_profile( "supports_dual_arm": False, } ROBOT_CONFIGS["PikaGripper"] = { - "class_path": "embodichain_robots.agilex.pika.cfg:PikaGripperCfg", - "description_path": "embodichain_robots.agilex.pika._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.agilex.pika.cfg:PikaGripperCfg", + "description_path": "embodichain.extensions.robots.agilex.pika._gripper_defaults:get_gripper_defaults", "vendor": "agilex", "morphology": "parallel_gripper", "arm_count": 0, @@ -420,8 +420,8 @@ def _w1_variant_profile( "supports_dual_arm": False, } ROBOT_CONFIGS["TianjiMarvinGripper"] = { - "class_path": "embodichain_robots.tianji.marvin.gripper.cfg:TianjiMarvinGripperCfg", - "description_path": "embodichain_robots.tianji.marvin.gripper._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.tianji.marvin.gripper.cfg:TianjiMarvinGripperCfg", + "description_path": "embodichain.extensions.robots.tianji.marvin.gripper._gripper_defaults:get_gripper_defaults", "vendor": "tianji", "morphology": "parallel_gripper", "arm_count": 0, @@ -433,8 +433,8 @@ def _w1_variant_profile( }, } ROBOT_CONFIGS["RobotiqArg2F85"] = { - "class_path": "embodichain_robots.robotiq.arg2f85.cfg:RobotiqArg2F85Cfg", - "description_path": "embodichain_robots.robotiq.arg2f85._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.robotiq.arg2f85.cfg:RobotiqArg2F85Cfg", + "description_path": "embodichain.extensions.robots.robotiq.arg2f85._gripper_defaults:get_gripper_defaults", "vendor": "robotiq", "morphology": "parallel_gripper", "arm_count": 0, @@ -442,8 +442,8 @@ def _w1_variant_profile( "supports_dual_arm": False, } ROBOT_CONFIGS["RobotiqArg2F140"] = { - "class_path": "embodichain_robots.robotiq.arg2f140.cfg:RobotiqArg2F140Cfg", - "description_path": "embodichain_robots.robotiq.arg2f140._gripper_defaults:get_gripper_defaults", + "class_path": "embodichain.extensions.robots.robotiq.arg2f140.cfg:RobotiqArg2F140Cfg", + "description_path": "embodichain.extensions.robots.robotiq.arg2f140._gripper_defaults:get_gripper_defaults", "vendor": "robotiq", "morphology": "parallel_gripper", "arm_count": 0, diff --git a/extensions/embodichain_robots/_locomotion.py b/embodichain/extensions/robots/_locomotion.py similarity index 100% rename from extensions/embodichain_robots/_locomotion.py rename to embodichain/extensions/robots/_locomotion.py diff --git a/extensions/embodichain_robots/_ssik_artifacts/LICENSE.txt b/embodichain/extensions/robots/_ssik_artifacts/LICENSE.txt similarity index 100% rename from extensions/embodichain_robots/_ssik_artifacts/LICENSE.txt rename to embodichain/extensions/robots/_ssik_artifacts/LICENSE.txt diff --git a/extensions/embodichain_robots/_ssik_artifacts/arx5.json b/embodichain/extensions/robots/_ssik_artifacts/arx5.json similarity index 100% rename from extensions/embodichain_robots/_ssik_artifacts/arx5.json rename to embodichain/extensions/robots/_ssik_artifacts/arx5.json diff --git a/extensions/embodichain_robots/_ssik_artifacts/arx5.py b/embodichain/extensions/robots/_ssik_artifacts/arx5.py similarity index 100% rename from extensions/embodichain_robots/_ssik_artifacts/arx5.py rename to embodichain/extensions/robots/_ssik_artifacts/arx5.py diff --git a/extensions/embodichain_robots/_ssik_artifacts/flexiv_rizon4s.json b/embodichain/extensions/robots/_ssik_artifacts/flexiv_rizon4s.json similarity index 100% rename from extensions/embodichain_robots/_ssik_artifacts/flexiv_rizon4s.json rename to embodichain/extensions/robots/_ssik_artifacts/flexiv_rizon4s.json diff --git a/extensions/embodichain_robots/_ssik_artifacts/flexiv_rizon4s.py b/embodichain/extensions/robots/_ssik_artifacts/flexiv_rizon4s.py similarity index 100% rename from extensions/embodichain_robots/_ssik_artifacts/flexiv_rizon4s.py rename to embodichain/extensions/robots/_ssik_artifacts/flexiv_rizon4s.py diff --git a/extensions/embodichain_robots/agibot/__init__.py b/embodichain/extensions/robots/agibot/__init__.py similarity index 100% rename from extensions/embodichain_robots/agibot/__init__.py rename to embodichain/extensions/robots/agibot/__init__.py diff --git a/extensions/embodichain_robots/agibot/g1/README.md b/embodichain/extensions/robots/agibot/g1/README.md similarity index 100% rename from extensions/embodichain_robots/agibot/g1/README.md rename to embodichain/extensions/robots/agibot/g1/README.md diff --git a/extensions/embodichain_robots/agibot/g1/__init__.py b/embodichain/extensions/robots/agibot/g1/__init__.py similarity index 100% rename from extensions/embodichain_robots/agibot/g1/__init__.py rename to embodichain/extensions/robots/agibot/g1/__init__.py diff --git a/extensions/embodichain_robots/agibot/g1/assets.py b/embodichain/extensions/robots/agibot/g1/assets.py similarity index 100% rename from extensions/embodichain_robots/agibot/g1/assets.py rename to embodichain/extensions/robots/agibot/g1/assets.py diff --git a/extensions/embodichain_robots/agibot/g1/cfg.py b/embodichain/extensions/robots/agibot/g1/cfg.py similarity index 100% rename from extensions/embodichain_robots/agibot/g1/cfg.py rename to embodichain/extensions/robots/agibot/g1/cfg.py diff --git a/extensions/embodichain_robots/agibot/g1/preview.png b/embodichain/extensions/robots/agibot/g1/preview.png similarity index 100% rename from extensions/embodichain_robots/agibot/g1/preview.png rename to embodichain/extensions/robots/agibot/g1/preview.png diff --git a/extensions/embodichain_robots/agibot/g2/LICENSE b/embodichain/extensions/robots/agibot/g2/LICENSE similarity index 100% rename from extensions/embodichain_robots/agibot/g2/LICENSE rename to embodichain/extensions/robots/agibot/g2/LICENSE diff --git a/extensions/embodichain_robots/agibot/g2/README.md b/embodichain/extensions/robots/agibot/g2/README.md similarity index 96% rename from extensions/embodichain_robots/agibot/g2/README.md rename to embodichain/extensions/robots/agibot/g2/README.md index 67546b457b..200728a668 100644 --- a/extensions/embodichain_robots/agibot/g2/README.md +++ b/embodichain/extensions/robots/agibot/g2/README.md @@ -13,7 +13,7 @@ mesh materials are preserved. Physics is not stepped, and 48 rendered frames warm up reconstruction. Run: ```bash -python -m embodichain_robots.agibot.g2._preview --output g2-render.png +python -m embodichain.extensions.robots.agibot.g2._preview --output g2-render.png ``` The command also writes `g2-render.render.json`. The checked-in @@ -77,7 +77,7 @@ Reproduce the packaged URDF without ROS (Xacro is a development dependency): ```bash python -m pip install xacro==2.1.1 -python extensions/embodichain_robots/agibot/g2/_generate.py \ +python embodichain/extensions/robots/agibot/g2/_generate.py \ --archive /path/to/6d5b2159806ae0e64b432b638e9ee288d8bddc8f.zip \ --output /tmp/g2.urdf ``` @@ -114,7 +114,7 @@ actual shoulder/elbow/wrist vectors and joint axes. For reproducible CPU/CUDA accuracy, limit, latency and memory measurements, run `python -m scripts.benchmark.robotics.kinematic_solver.agibot_g2 --output qualification.md`. -The checked-in [qualification report](../../../../scripts/benchmark/robotics/kinematic_solver/agibot_g2_qualification.md) +The checked-in [qualification report](../../../../../scripts/benchmark/robotics/kinematic_solver/agibot_g2_qualification.md) records both arms, midpoint/nearby seeds, and batches 1/32/128 against numerical IK with matched acceptance thresholds. Finite swivel sampling is not a proof of global reachability. A complete `PytorchSolverCfg` override with this preset's diff --git a/extensions/embodichain_robots/agibot/g2/__init__.py b/embodichain/extensions/robots/agibot/g2/__init__.py similarity index 100% rename from extensions/embodichain_robots/agibot/g2/__init__.py rename to embodichain/extensions/robots/agibot/g2/__init__.py diff --git a/extensions/embodichain_robots/agibot/g2/_generate.py b/embodichain/extensions/robots/agibot/g2/_generate.py similarity index 100% rename from extensions/embodichain_robots/agibot/g2/_generate.py rename to embodichain/extensions/robots/agibot/g2/_generate.py diff --git a/extensions/embodichain_robots/agibot/g2/_preview.py b/embodichain/extensions/robots/agibot/g2/_preview.py similarity index 100% rename from extensions/embodichain_robots/agibot/g2/_preview.py rename to embodichain/extensions/robots/agibot/g2/_preview.py diff --git a/extensions/embodichain_robots/agibot/g2/assets.py b/embodichain/extensions/robots/agibot/g2/assets.py similarity index 100% rename from extensions/embodichain_robots/agibot/g2/assets.py rename to embodichain/extensions/robots/agibot/g2/assets.py diff --git a/extensions/embodichain_robots/agibot/g2/cfg.py b/embodichain/extensions/robots/agibot/g2/cfg.py similarity index 100% rename from extensions/embodichain_robots/agibot/g2/cfg.py rename to embodichain/extensions/robots/agibot/g2/cfg.py diff --git a/extensions/embodichain_robots/agibot/g2/g2.urdf b/embodichain/extensions/robots/agibot/g2/g2.urdf similarity index 100% rename from extensions/embodichain_robots/agibot/g2/g2.urdf rename to embodichain/extensions/robots/agibot/g2/g2.urdf diff --git a/extensions/embodichain_robots/agibot/g2/preview.png b/embodichain/extensions/robots/agibot/g2/preview.png similarity index 100% rename from extensions/embodichain_robots/agibot/g2/preview.png rename to embodichain/extensions/robots/agibot/g2/preview.png diff --git a/extensions/embodichain_robots/agibot/g2/preview.render.json b/embodichain/extensions/robots/agibot/g2/preview.render.json similarity index 100% rename from extensions/embodichain_robots/agibot/g2/preview.render.json rename to embodichain/extensions/robots/agibot/g2/preview.render.json diff --git a/extensions/embodichain_robots/agibot/g2/source.lock.json b/embodichain/extensions/robots/agibot/g2/source.lock.json similarity index 100% rename from extensions/embodichain_robots/agibot/g2/source.lock.json rename to embodichain/extensions/robots/agibot/g2/source.lock.json diff --git a/extensions/embodichain_robots/agilex/__init__.py b/embodichain/extensions/robots/agilex/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/__init__.py rename to embodichain/extensions/robots/agilex/__init__.py diff --git a/extensions/embodichain_robots/agilex/_arm_assets.py b/embodichain/extensions/robots/agilex/_arm_assets.py similarity index 100% rename from extensions/embodichain_robots/agilex/_arm_assets.py rename to embodichain/extensions/robots/agilex/_arm_assets.py diff --git a/extensions/embodichain_robots/agilex/agx_gripper/README.md b/embodichain/extensions/robots/agilex/agx_gripper/README.md similarity index 100% rename from extensions/embodichain_robots/agilex/agx_gripper/README.md rename to embodichain/extensions/robots/agilex/agx_gripper/README.md diff --git a/extensions/embodichain_robots/agilex/agx_gripper/__init__.py b/embodichain/extensions/robots/agilex/agx_gripper/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/agx_gripper/__init__.py rename to embodichain/extensions/robots/agilex/agx_gripper/__init__.py diff --git a/extensions/embodichain_robots/agilex/agx_gripper/assets.py b/embodichain/extensions/robots/agilex/agx_gripper/assets.py similarity index 100% rename from extensions/embodichain_robots/agilex/agx_gripper/assets.py rename to embodichain/extensions/robots/agilex/agx_gripper/assets.py diff --git a/extensions/embodichain_robots/agilex/cobotmagic/__init__.py b/embodichain/extensions/robots/agilex/cobotmagic/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/cobotmagic/__init__.py rename to embodichain/extensions/robots/agilex/cobotmagic/__init__.py diff --git a/extensions/embodichain_robots/agilex/cobotmagic/assets.py b/embodichain/extensions/robots/agilex/cobotmagic/assets.py similarity index 100% rename from extensions/embodichain_robots/agilex/cobotmagic/assets.py rename to embodichain/extensions/robots/agilex/cobotmagic/assets.py diff --git a/extensions/embodichain_robots/agilex/cobotmagic/cfg.py b/embodichain/extensions/robots/agilex/cobotmagic/cfg.py similarity index 99% rename from extensions/embodichain_robots/agilex/cobotmagic/cfg.py rename to embodichain/extensions/robots/agilex/cobotmagic/cfg.py index c2f92836cb..cdb2edd617 100644 --- a/extensions/embodichain_robots/agilex/cobotmagic/cfg.py +++ b/embodichain/extensions/robots/agilex/cobotmagic/cfg.py @@ -309,7 +309,7 @@ def build_pk_serial_chain( from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import RenderCfg, physics_cfg_for_backend - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg parser = argparse.ArgumentParser(description="Launch the CobotMagic robot") parser.add_argument( diff --git a/extensions/embodichain_robots/agilex/cobotmagic/gripper/__init__.py b/embodichain/extensions/robots/agilex/cobotmagic/gripper/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/cobotmagic/gripper/__init__.py rename to embodichain/extensions/robots/agilex/cobotmagic/gripper/__init__.py diff --git a/extensions/embodichain_robots/agilex/cobotmagic/gripper/_gripper_defaults.py b/embodichain/extensions/robots/agilex/cobotmagic/gripper/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/agilex/cobotmagic/gripper/_gripper_defaults.py rename to embodichain/extensions/robots/agilex/cobotmagic/gripper/_gripper_defaults.py diff --git a/extensions/embodichain_robots/agilex/cobotmagic/gripper/cfg.py b/embodichain/extensions/robots/agilex/cobotmagic/gripper/cfg.py similarity index 100% rename from extensions/embodichain_robots/agilex/cobotmagic/gripper/cfg.py rename to embodichain/extensions/robots/agilex/cobotmagic/gripper/cfg.py diff --git a/extensions/embodichain_robots/agilex/pika/README.md b/embodichain/extensions/robots/agilex/pika/README.md similarity index 97% rename from extensions/embodichain_robots/agilex/pika/README.md rename to embodichain/extensions/robots/agilex/pika/README.md index 67026e3d9c..adcb0c6e32 100644 --- a/extensions/embodichain_robots/agilex/pika/README.md +++ b/embodichain/extensions/robots/agilex/pika/README.md @@ -32,5 +32,5 @@ copy with only those inertial elements removed; the archived geometry, meshes, materials and download identity remain unchanged. This preparation is not a physical calibration or a standalone simulation preset. The existing `dexforce_w1_030_pika` embodiment owns mounted simulation. See the -[Pika documentation](../../../../docs/source/resources/robot/agilex/pika.md) +[Pika documentation](../../../../../docs/source/resources/robot/agilex/pika.md) for the preparation recipe and render manifest. diff --git a/extensions/embodichain_robots/agilex/pika/__init__.py b/embodichain/extensions/robots/agilex/pika/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/pika/__init__.py rename to embodichain/extensions/robots/agilex/pika/__init__.py diff --git a/extensions/embodichain_robots/agilex/pika/_gripper_defaults.py b/embodichain/extensions/robots/agilex/pika/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/agilex/pika/_gripper_defaults.py rename to embodichain/extensions/robots/agilex/pika/_gripper_defaults.py diff --git a/extensions/embodichain_robots/agilex/pika/assets.py b/embodichain/extensions/robots/agilex/pika/assets.py similarity index 100% rename from extensions/embodichain_robots/agilex/pika/assets.py rename to embodichain/extensions/robots/agilex/pika/assets.py diff --git a/extensions/embodichain_robots/agilex/pika/cfg.py b/embodichain/extensions/robots/agilex/pika/cfg.py similarity index 100% rename from extensions/embodichain_robots/agilex/pika/cfg.py rename to embodichain/extensions/robots/agilex/pika/cfg.py diff --git a/extensions/embodichain_robots/agilex/piper_x/README.md b/embodichain/extensions/robots/agilex/piper_x/README.md similarity index 100% rename from extensions/embodichain_robots/agilex/piper_x/README.md rename to embodichain/extensions/robots/agilex/piper_x/README.md diff --git a/extensions/embodichain_robots/agilex/piper_x/__init__.py b/embodichain/extensions/robots/agilex/piper_x/__init__.py similarity index 100% rename from extensions/embodichain_robots/agilex/piper_x/__init__.py rename to embodichain/extensions/robots/agilex/piper_x/__init__.py diff --git a/extensions/embodichain_robots/agilex/piper_x/assets.py b/embodichain/extensions/robots/agilex/piper_x/assets.py similarity index 100% rename from extensions/embodichain_robots/agilex/piper_x/assets.py rename to embodichain/extensions/robots/agilex/piper_x/assets.py diff --git a/extensions/embodichain_robots/agilex/piper_x/cfg.py b/embodichain/extensions/robots/agilex/piper_x/cfg.py similarity index 100% rename from extensions/embodichain_robots/agilex/piper_x/cfg.py rename to embodichain/extensions/robots/agilex/piper_x/cfg.py diff --git a/extensions/embodichain_robots/alohamini/__init__.py b/embodichain/extensions/robots/alohamini/__init__.py similarity index 100% rename from extensions/embodichain_robots/alohamini/__init__.py rename to embodichain/extensions/robots/alohamini/__init__.py diff --git a/extensions/embodichain_robots/alohamini/aloha_mini/__init__.py b/embodichain/extensions/robots/alohamini/aloha_mini/__init__.py similarity index 100% rename from extensions/embodichain_robots/alohamini/aloha_mini/__init__.py rename to embodichain/extensions/robots/alohamini/aloha_mini/__init__.py diff --git a/extensions/embodichain_robots/alohamini/aloha_mini/assets.py b/embodichain/extensions/robots/alohamini/aloha_mini/assets.py similarity index 100% rename from extensions/embodichain_robots/alohamini/aloha_mini/assets.py rename to embodichain/extensions/robots/alohamini/aloha_mini/assets.py diff --git a/extensions/embodichain_robots/alohamini/aloha_mini/cfg.py b/embodichain/extensions/robots/alohamini/aloha_mini/cfg.py similarity index 100% rename from extensions/embodichain_robots/alohamini/aloha_mini/cfg.py rename to embodichain/extensions/robots/alohamini/aloha_mini/cfg.py diff --git a/extensions/embodichain_robots/anybotics/__init__.py b/embodichain/extensions/robots/anybotics/__init__.py similarity index 100% rename from extensions/embodichain_robots/anybotics/__init__.py rename to embodichain/extensions/robots/anybotics/__init__.py diff --git a/extensions/embodichain_robots/anybotics/anymal_c/__init__.py b/embodichain/extensions/robots/anybotics/anymal_c/__init__.py similarity index 100% rename from extensions/embodichain_robots/anybotics/anymal_c/__init__.py rename to embodichain/extensions/robots/anybotics/anymal_c/__init__.py diff --git a/extensions/embodichain_robots/anybotics/anymal_c/assets.py b/embodichain/extensions/robots/anybotics/anymal_c/assets.py similarity index 100% rename from extensions/embodichain_robots/anybotics/anymal_c/assets.py rename to embodichain/extensions/robots/anybotics/anymal_c/assets.py diff --git a/extensions/embodichain_robots/anybotics/anymal_c/cfg.py b/embodichain/extensions/robots/anybotics/anymal_c/cfg.py similarity index 100% rename from extensions/embodichain_robots/anybotics/anymal_c/cfg.py rename to embodichain/extensions/robots/anybotics/anymal_c/cfg.py diff --git a/extensions/embodichain_robots/anybotics/anymal_c/profile.json b/embodichain/extensions/robots/anybotics/anymal_c/profile.json similarity index 100% rename from extensions/embodichain_robots/anybotics/anymal_c/profile.json rename to embodichain/extensions/robots/anybotics/anymal_c/profile.json diff --git a/extensions/embodichain_robots/arx/__init__.py b/embodichain/extensions/robots/arx/__init__.py similarity index 100% rename from extensions/embodichain_robots/arx/__init__.py rename to embodichain/extensions/robots/arx/__init__.py diff --git a/extensions/embodichain_robots/arx/arx5/__init__.py b/embodichain/extensions/robots/arx/arx5/__init__.py similarity index 100% rename from extensions/embodichain_robots/arx/arx5/__init__.py rename to embodichain/extensions/robots/arx/arx5/__init__.py diff --git a/extensions/embodichain_robots/arx/arx5/assets.py b/embodichain/extensions/robots/arx/arx5/assets.py similarity index 100% rename from extensions/embodichain_robots/arx/arx5/assets.py rename to embodichain/extensions/robots/arx/arx5/assets.py diff --git a/extensions/embodichain_robots/arx/arx5/cfg.py b/embodichain/extensions/robots/arx/arx5/cfg.py similarity index 100% rename from extensions/embodichain_robots/arx/arx5/cfg.py rename to embodichain/extensions/robots/arx/arx5/cfg.py diff --git a/extensions/embodichain_robots/brainco/__init__.py b/embodichain/extensions/robots/brainco/__init__.py similarity index 100% rename from extensions/embodichain_robots/brainco/__init__.py rename to embodichain/extensions/robots/brainco/__init__.py diff --git a/extensions/embodichain_robots/brainco/revo1/README.md b/embodichain/extensions/robots/brainco/revo1/README.md similarity index 100% rename from extensions/embodichain_robots/brainco/revo1/README.md rename to embodichain/extensions/robots/brainco/revo1/README.md diff --git a/extensions/embodichain_robots/brainco/revo1/__init__.py b/embodichain/extensions/robots/brainco/revo1/__init__.py similarity index 100% rename from extensions/embodichain_robots/brainco/revo1/__init__.py rename to embodichain/extensions/robots/brainco/revo1/__init__.py diff --git a/extensions/embodichain_robots/brainco/revo1/_specs.py b/embodichain/extensions/robots/brainco/revo1/_specs.py similarity index 100% rename from extensions/embodichain_robots/brainco/revo1/_specs.py rename to embodichain/extensions/robots/brainco/revo1/_specs.py diff --git a/extensions/embodichain_robots/brainco/revo1/assets.py b/embodichain/extensions/robots/brainco/revo1/assets.py similarity index 96% rename from extensions/embodichain_robots/brainco/revo1/assets.py rename to embodichain/extensions/robots/brainco/revo1/assets.py index f002f44be6..78e66332df 100644 --- a/extensions/embodichain_robots/brainco/revo1/assets.py +++ b/embodichain/extensions/robots/brainco/revo1/assets.py @@ -45,7 +45,7 @@ class BrainCoHandRevo1(EmbodiChainDataset): BrainCoLeftHand/BrainCoLeftHand.urdf Example usage: - >>> from embodichain_robots.brainco.revo1.assets import BrainCoHandRevo1 + >>> from embodichain.extensions.robots.brainco.revo1.assets import BrainCoHandRevo1 >>> dataset = BrainCoHandRevo1() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/brainco/revo1/cfg.py b/embodichain/extensions/robots/brainco/revo1/cfg.py similarity index 100% rename from extensions/embodichain_robots/brainco/revo1/cfg.py rename to embodichain/extensions/robots/brainco/revo1/cfg.py diff --git a/extensions/embodichain_robots/changingtek/__init__.py b/embodichain/extensions/robots/changingtek/__init__.py similarity index 100% rename from extensions/embodichain_robots/changingtek/__init__.py rename to embodichain/extensions/robots/changingtek/__init__.py diff --git a/extensions/embodichain_robots/changingtek/ctm2f110/README.md b/embodichain/extensions/robots/changingtek/ctm2f110/README.md similarity index 100% rename from extensions/embodichain_robots/changingtek/ctm2f110/README.md rename to embodichain/extensions/robots/changingtek/ctm2f110/README.md diff --git a/extensions/embodichain_robots/changingtek/ctm2f110/__init__.py b/embodichain/extensions/robots/changingtek/ctm2f110/__init__.py similarity index 100% rename from extensions/embodichain_robots/changingtek/ctm2f110/__init__.py rename to embodichain/extensions/robots/changingtek/ctm2f110/__init__.py diff --git a/extensions/embodichain_robots/changingtek/ctm2f110/assets.py b/embodichain/extensions/robots/changingtek/ctm2f110/assets.py similarity index 95% rename from extensions/embodichain_robots/changingtek/ctm2f110/assets.py rename to embodichain/extensions/robots/changingtek/ctm2f110/assets.py index de67f26676..097fbd20da 100644 --- a/extensions/embodichain_robots/changingtek/ctm2f110/assets.py +++ b/embodichain/extensions/robots/changingtek/ctm2f110/assets.py @@ -44,7 +44,7 @@ class ZH_CTM2F110(EmbodiChainDataset): ZH_CTM2F110.urdf Example usage: - >>> from embodichain_robots.changingtek.ctm2f110.assets import ZH_CTM2F110 + >>> from embodichain.extensions.robots.changingtek.ctm2f110.assets import ZH_CTM2F110 >>> dataset = ZH_CTM2F110() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/dexforce/__init__.py b/embodichain/extensions/robots/dexforce/__init__.py similarity index 100% rename from extensions/embodichain_robots/dexforce/__init__.py rename to embodichain/extensions/robots/dexforce/__init__.py diff --git a/extensions/embodichain_robots/dexforce/w1/__init__.py b/embodichain/extensions/robots/dexforce/w1/__init__.py similarity index 100% rename from extensions/embodichain_robots/dexforce/w1/__init__.py rename to embodichain/extensions/robots/dexforce/w1/__init__.py diff --git a/extensions/embodichain_robots/dexforce/w1/assets.py b/embodichain/extensions/robots/dexforce/w1/assets.py similarity index 100% rename from extensions/embodichain_robots/dexforce/w1/assets.py rename to embodichain/extensions/robots/dexforce/w1/assets.py diff --git a/extensions/embodichain_robots/dexforce/w1/cfg.py b/embodichain/extensions/robots/dexforce/w1/cfg.py similarity index 96% rename from extensions/embodichain_robots/dexforce/w1/cfg.py rename to embodichain/extensions/robots/dexforce/w1/cfg.py index a63e8a3061..89d7fa140d 100644 --- a/extensions/embodichain_robots/dexforce/w1/cfg.py +++ b/embodichain/extensions/robots/dexforce/w1/cfg.py @@ -28,26 +28,25 @@ # Replace the script directory so its ``types.py`` cannot shadow the # standard-library ``types`` module in compiler subprocesses. - sys.path[0] = str(Path(__file__).resolve().parents[3]) - sys.path.insert(1, str(Path(__file__).resolve().parents[4])) + sys.path[0] = str(Path(__file__).resolve().parents[5]) from typing import TYPE_CHECKING, Dict -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1HandBrand, DexforceW1HandVersion, DexforceW1Version, ) -from embodichain_robots.dexforce.w1.utils import ( +from embodichain.extensions.robots.dexforce.w1.utils import ( build_dexforce_w1_assembly_urdf_cfg, build_dexforce_w1_control_parts, ) -from embodichain_robots.dexforce.w1.hand_specs import ( +from embodichain.extensions.robots.dexforce.w1.hand_specs import ( get_default_w1_hand_version, normalize_w1_hand_mappings, ) -from embodichain_robots.dexforce.w1.specs import get_w1_version_spec +from embodichain.extensions.robots.dexforce.w1.specs import get_w1_version_spec from embodichain.lab.sim.cfg import ( ArticulationRootPropertiesCfg, CollisionPropertiesCfg, @@ -257,7 +256,7 @@ def _build_defaults(self, init_dict: dict | None = None) -> None: def _build_default_solver_cfg(self): """Build version-matched solvers with URDF joint coordinates and limits.""" from embodichain.lab.sim.motion.solvers import SRSSolverCfg, SolverCfg - from embodichain_robots.dexforce.w1.params import ( + from embodichain.extensions.robots.dexforce.w1.params import ( W1ArmKineParams, ) @@ -366,7 +365,7 @@ def _pk_urdf_path(self, arm_side: DexforceW1ArmSide) -> str: The root_link->end_link kinematics here must match the arms in the simulation (assembled) URDF. A DOF drift guard in the tests checks this. """ - from embodichain_robots.dexforce.w1.utils import arm_manager + from embodichain.extensions.robots.dexforce.w1.utils import arm_manager return arm_manager.get_urdf(side=arm_side, version=self.version) diff --git a/extensions/embodichain_robots/dexforce/w1/hand_specs.py b/embodichain/extensions/robots/dexforce/w1/hand_specs.py similarity index 97% rename from extensions/embodichain_robots/dexforce/w1/hand_specs.py rename to embodichain/extensions/robots/dexforce/w1/hand_specs.py index d4f8f46ef5..58b06baa23 100644 --- a/extensions/embodichain_robots/dexforce/w1/hand_specs.py +++ b/embodichain/extensions/robots/dexforce/w1/hand_specs.py @@ -25,8 +25,8 @@ import numpy as np from scipy.spatial.transform import Rotation as R -from embodichain_robots.brainco.revo1._specs import get_side_spec -from embodichain_robots.dh_robotics.pgc_140_50._specs import get_asset_spec +from embodichain.extensions.robots.brainco.revo1._specs import get_side_spec +from embodichain.extensions.robots.dh_robotics.pgc_140_50._specs import get_asset_spec from .types import ( DexforceW1ArmSide, diff --git a/extensions/embodichain_robots/dexforce/w1/params.py b/embodichain/extensions/robots/dexforce/w1/params.py similarity index 98% rename from extensions/embodichain_robots/dexforce/w1/params.py rename to embodichain/extensions/robots/dexforce/w1/params.py index 8a2279eb2b..413dc46bf4 100644 --- a/extensions/embodichain_robots/dexforce/w1/params.py +++ b/embodichain/extensions/robots/dexforce/w1/params.py @@ -20,11 +20,11 @@ import numpy as np from dataclasses import dataclass, field -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1Version, ) -from embodichain_robots.dexforce.w1.specs import get_w1_version_spec +from embodichain.extensions.robots.dexforce.w1.specs import get_w1_version_spec @dataclass diff --git a/extensions/embodichain_robots/dexforce/w1/specs.py b/embodichain/extensions/robots/dexforce/w1/specs.py similarity index 100% rename from extensions/embodichain_robots/dexforce/w1/specs.py rename to embodichain/extensions/robots/dexforce/w1/specs.py diff --git a/extensions/embodichain_robots/dexforce/w1/types.py b/embodichain/extensions/robots/dexforce/w1/types.py similarity index 100% rename from extensions/embodichain_robots/dexforce/w1/types.py rename to embodichain/extensions/robots/dexforce/w1/types.py diff --git a/extensions/embodichain_robots/dexforce/w1/utils.py b/embodichain/extensions/robots/dexforce/w1/utils.py similarity index 98% rename from extensions/embodichain_robots/dexforce/w1/utils.py rename to embodichain/extensions/robots/dexforce/w1/utils.py index d5b125cf9f..876a72b787 100644 --- a/extensions/embodichain_robots/dexforce/w1/utils.py +++ b/embodichain/extensions/robots/dexforce/w1/utils.py @@ -19,21 +19,21 @@ import numpy as np -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1Type, DexforceW1ArmSide, DexforceW1Version, DexforceW1HandBrand, DexforceW1HandVersion, ) -from embodichain_robots.dexforce.w1.hand_specs import ( +from embodichain.extensions.robots.dexforce.w1.hand_specs import ( get_default_w1_hand_version, get_w1_hand_spec, normalize_w1_hand_mappings, ) from embodichain.data import get_data_path from embodichain.lab.sim.cfg import URDFCfg -from embodichain_robots.dexforce.w1.specs import ( +from embodichain.extensions.robots.dexforce.w1.specs import ( get_w1_version_spec, ) diff --git a/extensions/embodichain_robots/dh_robotics/__init__.py b/embodichain/extensions/robots/dh_robotics/__init__.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/__init__.py rename to embodichain/extensions/robots/dh_robotics/__init__.py diff --git a/extensions/embodichain_robots/dh_robotics/ag95/README.md b/embodichain/extensions/robots/dh_robotics/ag95/README.md similarity index 100% rename from extensions/embodichain_robots/dh_robotics/ag95/README.md rename to embodichain/extensions/robots/dh_robotics/ag95/README.md diff --git a/extensions/embodichain_robots/dh_robotics/ag95/__init__.py b/embodichain/extensions/robots/dh_robotics/ag95/__init__.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/ag95/__init__.py rename to embodichain/extensions/robots/dh_robotics/ag95/__init__.py diff --git a/extensions/embodichain_robots/dh_robotics/ag95/assets.py b/embodichain/extensions/robots/dh_robotics/ag95/assets.py similarity index 96% rename from extensions/embodichain_robots/dh_robotics/ag95/assets.py rename to embodichain/extensions/robots/dh_robotics/ag95/assets.py index bd9d96fbd5..57363e066c 100644 --- a/extensions/embodichain_robots/dh_robotics/ag95/assets.py +++ b/embodichain/extensions/robots/dh_robotics/ag95/assets.py @@ -45,7 +45,7 @@ class DH_AG95(EmbodiChainDataset): dh_ag95.urdf Example usage: - >>> from embodichain_robots.dh_robotics.ag95.assets import DH_AG95 + >>> from embodichain.extensions.robots.dh_robotics.ag95.assets import DH_AG95 >>> dataset = DH_AG95() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/dh_robotics/pgc_140_50/README.md b/embodichain/extensions/robots/dh_robotics/pgc_140_50/README.md similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgc_140_50/README.md rename to embodichain/extensions/robots/dh_robotics/pgc_140_50/README.md diff --git a/extensions/embodichain_robots/dh_robotics/pgc_140_50/__init__.py b/embodichain/extensions/robots/dh_robotics/pgc_140_50/__init__.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgc_140_50/__init__.py rename to embodichain/extensions/robots/dh_robotics/pgc_140_50/__init__.py diff --git a/extensions/embodichain_robots/dh_robotics/pgc_140_50/_specs.py b/embodichain/extensions/robots/dh_robotics/pgc_140_50/_specs.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgc_140_50/_specs.py rename to embodichain/extensions/robots/dh_robotics/pgc_140_50/_specs.py diff --git a/extensions/embodichain_robots/dh_robotics/pgc_140_50/assets.py b/embodichain/extensions/robots/dh_robotics/pgc_140_50/assets.py similarity index 94% rename from extensions/embodichain_robots/dh_robotics/pgc_140_50/assets.py rename to embodichain/extensions/robots/dh_robotics/pgc_140_50/assets.py index 25b9c64d42..d5023103ab 100644 --- a/extensions/embodichain_robots/dh_robotics/pgc_140_50/assets.py +++ b/embodichain/extensions/robots/dh_robotics/pgc_140_50/assets.py @@ -44,7 +44,7 @@ class DH_PGC_140_50(EmbodiChainDataset): DH_PGC_140_50.urdf Example usage: - >>> from embodichain_robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50 + >>> from embodichain.extensions.robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50 >>> dataset = DH_PGC_140_50() or >>> from embodichain.data import get_data_path @@ -79,7 +79,7 @@ class DH_PGC_140_50_M(EmbodiChainDataset): DH_PGC_140_50_M.urdf Example usage: - >>> from embodichain_robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50_M + >>> from embodichain.extensions.robots.dh_robotics.pgc_140_50.assets import DH_PGC_140_50_M >>> dataset = DH_PGC_140_50_M() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/dh_robotics/pgi_140_80/README.md b/embodichain/extensions/robots/dh_robotics/pgi_140_80/README.md similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgi_140_80/README.md rename to embodichain/extensions/robots/dh_robotics/pgi_140_80/README.md diff --git a/extensions/embodichain_robots/dh_robotics/pgi_140_80/__init__.py b/embodichain/extensions/robots/dh_robotics/pgi_140_80/__init__.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgi_140_80/__init__.py rename to embodichain/extensions/robots/dh_robotics/pgi_140_80/__init__.py diff --git a/extensions/embodichain_robots/dh_robotics/pgi_140_80/_gripper_defaults.py b/embodichain/extensions/robots/dh_robotics/pgi_140_80/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgi_140_80/_gripper_defaults.py rename to embodichain/extensions/robots/dh_robotics/pgi_140_80/_gripper_defaults.py diff --git a/extensions/embodichain_robots/dh_robotics/pgi_140_80/assets.py b/embodichain/extensions/robots/dh_robotics/pgi_140_80/assets.py similarity index 95% rename from extensions/embodichain_robots/dh_robotics/pgi_140_80/assets.py rename to embodichain/extensions/robots/dh_robotics/pgi_140_80/assets.py index 58b4a756e4..fe72169bf9 100644 --- a/extensions/embodichain_robots/dh_robotics/pgi_140_80/assets.py +++ b/embodichain/extensions/robots/dh_robotics/pgi_140_80/assets.py @@ -44,7 +44,7 @@ class DH_PGI_140_80(EmbodiChainDataset): DH_PGI_140_80.urdf Example usage: - >>> from embodichain_robots.dh_robotics.pgi_140_80.assets import DH_PGI_140_80 + >>> from embodichain.extensions.robots.dh_robotics.pgi_140_80.assets import DH_PGI_140_80 >>> dataset = DH_PGI_140_80() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/dh_robotics/pgi_140_80/cfg.py b/embodichain/extensions/robots/dh_robotics/pgi_140_80/cfg.py similarity index 100% rename from extensions/embodichain_robots/dh_robotics/pgi_140_80/cfg.py rename to embodichain/extensions/robots/dh_robotics/pgi_140_80/cfg.py diff --git a/extensions/embodichain_robots/flexiv/__init__.py b/embodichain/extensions/robots/flexiv/__init__.py similarity index 100% rename from extensions/embodichain_robots/flexiv/__init__.py rename to embodichain/extensions/robots/flexiv/__init__.py diff --git a/extensions/embodichain_robots/flexiv/rizon4s/__init__.py b/embodichain/extensions/robots/flexiv/rizon4s/__init__.py similarity index 100% rename from extensions/embodichain_robots/flexiv/rizon4s/__init__.py rename to embodichain/extensions/robots/flexiv/rizon4s/__init__.py diff --git a/extensions/embodichain_robots/flexiv/rizon4s/assets.py b/embodichain/extensions/robots/flexiv/rizon4s/assets.py similarity index 100% rename from extensions/embodichain_robots/flexiv/rizon4s/assets.py rename to embodichain/extensions/robots/flexiv/rizon4s/assets.py diff --git a/extensions/embodichain_robots/flexiv/rizon4s/cfg.py b/embodichain/extensions/robots/flexiv/rizon4s/cfg.py similarity index 100% rename from extensions/embodichain_robots/flexiv/rizon4s/cfg.py rename to embodichain/extensions/robots/flexiv/rizon4s/cfg.py diff --git a/extensions/embodichain_robots/franka/README.md b/embodichain/extensions/robots/franka/README.md similarity index 97% rename from extensions/embodichain_robots/franka/README.md rename to embodichain/extensions/robots/franka/README.md index 87bf92da1f..ce60ec3e2a 100644 --- a/extensions/embodichain_robots/franka/README.md +++ b/embodichain/extensions/robots/franka/README.md @@ -26,7 +26,7 @@ Robotiq uses the existing `Robotiq_V2.zip` asset (MD5 One driver controls five mimic followers, including negative multipliers. `robotiq85_joint_positions()` maps observed DROID aperture to this linkage; actuator close commands remain separate from measured contact-limited positions. -The downloader is owned by `embodichain_robots.robotiq.assets.Robotiq`. +The downloader is owned by `embodichain.extensions.robots.robotiq.assets.Robotiq`. The separate `Robotiq2F85` archive is a different asset and is not a replacement for this calibrated model; the stable asset reference, joint layout and geometry remain unchanged after the EEF ownership migration. diff --git a/extensions/embodichain_robots/franka/__init__.py b/embodichain/extensions/robots/franka/__init__.py similarity index 100% rename from extensions/embodichain_robots/franka/__init__.py rename to embodichain/extensions/robots/franka/__init__.py diff --git a/extensions/embodichain_robots/franka/_physics.py b/embodichain/extensions/robots/franka/_physics.py similarity index 100% rename from extensions/embodichain_robots/franka/_physics.py rename to embodichain/extensions/robots/franka/_physics.py diff --git a/extensions/embodichain_robots/franka/_specs.py b/embodichain/extensions/robots/franka/_specs.py similarity index 100% rename from extensions/embodichain_robots/franka/_specs.py rename to embodichain/extensions/robots/franka/_specs.py diff --git a/extensions/embodichain_robots/franka/assets.py b/embodichain/extensions/robots/franka/assets.py similarity index 100% rename from extensions/embodichain_robots/franka/assets.py rename to embodichain/extensions/robots/franka/assets.py diff --git a/extensions/embodichain_robots/franka/cfg.py b/embodichain/extensions/robots/franka/cfg.py similarity index 100% rename from extensions/embodichain_robots/franka/cfg.py rename to embodichain/extensions/robots/franka/cfg.py diff --git a/extensions/embodichain_robots/franka/hand/__init__.py b/embodichain/extensions/robots/franka/hand/__init__.py similarity index 100% rename from extensions/embodichain_robots/franka/hand/__init__.py rename to embodichain/extensions/robots/franka/hand/__init__.py diff --git a/extensions/embodichain_robots/franka/hand/_gripper_defaults.py b/embodichain/extensions/robots/franka/hand/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/franka/hand/_gripper_defaults.py rename to embodichain/extensions/robots/franka/hand/_gripper_defaults.py diff --git a/extensions/embodichain_robots/franka/hand/cfg.py b/embodichain/extensions/robots/franka/hand/cfg.py similarity index 100% rename from extensions/embodichain_robots/franka/hand/cfg.py rename to embodichain/extensions/robots/franka/hand/cfg.py diff --git a/extensions/embodichain_robots/franka/panda.py b/embodichain/extensions/robots/franka/panda.py similarity index 97% rename from extensions/embodichain_robots/franka/panda.py rename to embodichain/extensions/robots/franka/panda.py index e3df4be4fa..06fa83faac 100644 --- a/extensions/embodichain_robots/franka/panda.py +++ b/embodichain/extensions/robots/franka/panda.py @@ -15,7 +15,7 @@ # ---------------------------------------------------------------------------- from __future__ import annotations -from embodichain_robots.franka.cfg import FrankaCfg +from embodichain.extensions.robots.franka.cfg import FrankaCfg from embodichain.utils import configclass __all__ = ["FrankaPandaCfg"] diff --git a/extensions/embodichain_robots/i2rt/__init__.py b/embodichain/extensions/robots/i2rt/__init__.py similarity index 100% rename from extensions/embodichain_robots/i2rt/__init__.py rename to embodichain/extensions/robots/i2rt/__init__.py diff --git a/extensions/embodichain_robots/i2rt/yam/README.md b/embodichain/extensions/robots/i2rt/yam/README.md similarity index 100% rename from extensions/embodichain_robots/i2rt/yam/README.md rename to embodichain/extensions/robots/i2rt/yam/README.md diff --git a/extensions/embodichain_robots/i2rt/yam/__init__.py b/embodichain/extensions/robots/i2rt/yam/__init__.py similarity index 100% rename from extensions/embodichain_robots/i2rt/yam/__init__.py rename to embodichain/extensions/robots/i2rt/yam/__init__.py diff --git a/extensions/embodichain_robots/i2rt/yam/assets.py b/embodichain/extensions/robots/i2rt/yam/assets.py similarity index 100% rename from extensions/embodichain_robots/i2rt/yam/assets.py rename to embodichain/extensions/robots/i2rt/yam/assets.py diff --git a/extensions/embodichain_robots/i2rt/yam/cfg.py b/embodichain/extensions/robots/i2rt/yam/cfg.py similarity index 100% rename from extensions/embodichain_robots/i2rt/yam/cfg.py rename to embodichain/extensions/robots/i2rt/yam/cfg.py diff --git a/extensions/embodichain_robots/inspire/__init__.py b/embodichain/extensions/robots/inspire/__init__.py similarity index 100% rename from extensions/embodichain_robots/inspire/__init__.py rename to embodichain/extensions/robots/inspire/__init__.py diff --git a/extensions/embodichain_robots/inspire/hand/README.md b/embodichain/extensions/robots/inspire/hand/README.md similarity index 100% rename from extensions/embodichain_robots/inspire/hand/README.md rename to embodichain/extensions/robots/inspire/hand/README.md diff --git a/extensions/embodichain_robots/inspire/hand/__init__.py b/embodichain/extensions/robots/inspire/hand/__init__.py similarity index 100% rename from extensions/embodichain_robots/inspire/hand/__init__.py rename to embodichain/extensions/robots/inspire/hand/__init__.py diff --git a/extensions/embodichain_robots/inspire/hand/assets.py b/embodichain/extensions/robots/inspire/hand/assets.py similarity index 96% rename from extensions/embodichain_robots/inspire/hand/assets.py rename to embodichain/extensions/robots/inspire/hand/assets.py index 6df5c08473..3d89477b8c 100644 --- a/extensions/embodichain_robots/inspire/hand/assets.py +++ b/embodichain/extensions/robots/inspire/hand/assets.py @@ -47,7 +47,7 @@ class InspireHand(EmbodiChainDataset): inspire_joint_data.npy Example usage: - >>> from embodichain_robots.inspire.hand.assets import InspireHand + >>> from embodichain.extensions.robots.inspire.hand.assets import InspireHand >>> dataset = InspireHand() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/locomotion_profiles.py b/embodichain/extensions/robots/locomotion_profiles.py similarity index 84% rename from extensions/embodichain_robots/locomotion_profiles.py rename to embodichain/extensions/robots/locomotion_profiles.py index 6ca7a7a329..6f48daffe7 100644 --- a/extensions/embodichain_robots/locomotion_profiles.py +++ b/embodichain/extensions/robots/locomotion_profiles.py @@ -28,12 +28,12 @@ _PROFILE_PACKAGES = { - "UnitreeGo1": "embodichain_robots.unitree.go1", - "UnitreeGo2": "embodichain_robots.unitree.go2", - "UnitreeG1": "embodichain_robots.unitree.g1", - "UnitreeH1_2": "embodichain_robots.unitree.h1_2", - "ANYmalC": "embodichain_robots.anybotics.anymal_c", - "MicroDuck": "embodichain_robots.pollen_robotics.microduck", + "UnitreeGo1": "embodichain.extensions.robots.unitree.go1", + "UnitreeGo2": "embodichain.extensions.robots.unitree.go2", + "UnitreeG1": "embodichain.extensions.robots.unitree.g1", + "UnitreeH1_2": "embodichain.extensions.robots.unitree.h1_2", + "ANYmalC": "embodichain.extensions.robots.anybotics.anymal_c", + "MicroDuck": "embodichain.extensions.robots.pollen_robotics.microduck", } diff --git a/extensions/embodichain_robots/pollen_robotics/__init__.py b/embodichain/extensions/robots/pollen_robotics/__init__.py similarity index 100% rename from extensions/embodichain_robots/pollen_robotics/__init__.py rename to embodichain/extensions/robots/pollen_robotics/__init__.py diff --git a/extensions/embodichain_robots/pollen_robotics/microduck/__init__.py b/embodichain/extensions/robots/pollen_robotics/microduck/__init__.py similarity index 100% rename from extensions/embodichain_robots/pollen_robotics/microduck/__init__.py rename to embodichain/extensions/robots/pollen_robotics/microduck/__init__.py diff --git a/extensions/embodichain_robots/pollen_robotics/microduck/assets.py b/embodichain/extensions/robots/pollen_robotics/microduck/assets.py similarity index 100% rename from extensions/embodichain_robots/pollen_robotics/microduck/assets.py rename to embodichain/extensions/robots/pollen_robotics/microduck/assets.py diff --git a/extensions/embodichain_robots/pollen_robotics/microduck/cfg.py b/embodichain/extensions/robots/pollen_robotics/microduck/cfg.py similarity index 100% rename from extensions/embodichain_robots/pollen_robotics/microduck/cfg.py rename to embodichain/extensions/robots/pollen_robotics/microduck/cfg.py diff --git a/extensions/embodichain_robots/pollen_robotics/microduck/profile.json b/embodichain/extensions/robots/pollen_robotics/microduck/profile.json similarity index 100% rename from extensions/embodichain_robots/pollen_robotics/microduck/profile.json rename to embodichain/extensions/robots/pollen_robotics/microduck/profile.json diff --git a/extensions/embodichain_robots/robotiq/README.md b/embodichain/extensions/robots/robotiq/README.md similarity index 100% rename from extensions/embodichain_robots/robotiq/README.md rename to embodichain/extensions/robots/robotiq/README.md diff --git a/extensions/embodichain_robots/robotiq/__init__.py b/embodichain/extensions/robots/robotiq/__init__.py similarity index 100% rename from extensions/embodichain_robots/robotiq/__init__.py rename to embodichain/extensions/robots/robotiq/__init__.py diff --git a/extensions/embodichain_robots/robotiq/arg2f140/__init__.py b/embodichain/extensions/robots/robotiq/arg2f140/__init__.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f140/__init__.py rename to embodichain/extensions/robots/robotiq/arg2f140/__init__.py diff --git a/extensions/embodichain_robots/robotiq/arg2f140/_gripper_defaults.py b/embodichain/extensions/robots/robotiq/arg2f140/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f140/_gripper_defaults.py rename to embodichain/extensions/robots/robotiq/arg2f140/_gripper_defaults.py diff --git a/extensions/embodichain_robots/robotiq/arg2f140/cfg.py b/embodichain/extensions/robots/robotiq/arg2f140/cfg.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f140/cfg.py rename to embodichain/extensions/robots/robotiq/arg2f140/cfg.py diff --git a/extensions/embodichain_robots/robotiq/arg2f85/__init__.py b/embodichain/extensions/robots/robotiq/arg2f85/__init__.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f85/__init__.py rename to embodichain/extensions/robots/robotiq/arg2f85/__init__.py diff --git a/extensions/embodichain_robots/robotiq/arg2f85/_gripper_defaults.py b/embodichain/extensions/robots/robotiq/arg2f85/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f85/_gripper_defaults.py rename to embodichain/extensions/robots/robotiq/arg2f85/_gripper_defaults.py diff --git a/extensions/embodichain_robots/robotiq/arg2f85/cfg.py b/embodichain/extensions/robots/robotiq/arg2f85/cfg.py similarity index 100% rename from extensions/embodichain_robots/robotiq/arg2f85/cfg.py rename to embodichain/extensions/robots/robotiq/arg2f85/cfg.py diff --git a/extensions/embodichain_robots/robotiq/assets.py b/embodichain/extensions/robots/robotiq/assets.py similarity index 96% rename from extensions/embodichain_robots/robotiq/assets.py rename to embodichain/extensions/robots/robotiq/assets.py index 257f747d6d..b0569de004 100644 --- a/extensions/embodichain_robots/robotiq/assets.py +++ b/embodichain/extensions/robots/robotiq/assets.py @@ -47,7 +47,7 @@ class Robotiq(EmbodiChainDataset): robotiq_arg2f_140.urdf Example usage: - >>> from embodichain_robots.robotiq.assets import Robotiq + >>> from embodichain.extensions.robots.robotiq.assets import Robotiq >>> dataset = Robotiq() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/robotiq/robotiq_2f85/README.md b/embodichain/extensions/robots/robotiq/robotiq_2f85/README.md similarity index 100% rename from extensions/embodichain_robots/robotiq/robotiq_2f85/README.md rename to embodichain/extensions/robots/robotiq/robotiq_2f85/README.md diff --git a/extensions/embodichain_robots/robotiq/robotiq_2f85/__init__.py b/embodichain/extensions/robots/robotiq/robotiq_2f85/__init__.py similarity index 100% rename from extensions/embodichain_robots/robotiq/robotiq_2f85/__init__.py rename to embodichain/extensions/robots/robotiq/robotiq_2f85/__init__.py diff --git a/extensions/embodichain_robots/robotiq/robotiq_2f85/assets.py b/embodichain/extensions/robots/robotiq/robotiq_2f85/assets.py similarity index 95% rename from extensions/embodichain_robots/robotiq/robotiq_2f85/assets.py rename to embodichain/extensions/robots/robotiq/robotiq_2f85/assets.py index 5a4f6f430d..80a681b585 100644 --- a/extensions/embodichain_robots/robotiq/robotiq_2f85/assets.py +++ b/embodichain/extensions/robots/robotiq/robotiq_2f85/assets.py @@ -44,7 +44,7 @@ class Robotiq2F85(EmbodiChainDataset): Robotiq2F85.urdf Example usage: - >>> from embodichain_robots.robotiq.robotiq_2f85.assets import Robotiq2F85 + >>> from embodichain.extensions.robots.robotiq.robotiq_2f85.assets import Robotiq2F85 >>> dataset = Robotiq2F85() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/robotiq/two_finger.py b/embodichain/extensions/robots/robotiq/two_finger.py similarity index 100% rename from extensions/embodichain_robots/robotiq/two_finger.py rename to embodichain/extensions/robots/robotiq/two_finger.py diff --git a/extensions/embodichain_robots/sharpa/__init__.py b/embodichain/extensions/robots/sharpa/__init__.py similarity index 100% rename from extensions/embodichain_robots/sharpa/__init__.py rename to embodichain/extensions/robots/sharpa/__init__.py diff --git a/extensions/embodichain_robots/sharpa/wave/README.md b/embodichain/extensions/robots/sharpa/wave/README.md similarity index 100% rename from extensions/embodichain_robots/sharpa/wave/README.md rename to embodichain/extensions/robots/sharpa/wave/README.md diff --git a/extensions/embodichain_robots/sharpa/wave/__init__.py b/embodichain/extensions/robots/sharpa/wave/__init__.py similarity index 100% rename from extensions/embodichain_robots/sharpa/wave/__init__.py rename to embodichain/extensions/robots/sharpa/wave/__init__.py diff --git a/extensions/embodichain_robots/sharpa/wave/assets.py b/embodichain/extensions/robots/sharpa/wave/assets.py similarity index 96% rename from extensions/embodichain_robots/sharpa/wave/assets.py rename to embodichain/extensions/robots/sharpa/wave/assets.py index 20c7c5df31..52225c1130 100644 --- a/extensions/embodichain_robots/sharpa/wave/assets.py +++ b/embodichain/extensions/robots/sharpa/wave/assets.py @@ -36,7 +36,7 @@ class SharpaWave(EmbodiChainDataset): ``get_data_path("SharpaWave/right_sharpa_wave/right_sharpa_wave.urdf")``. The bundle also retains the upstream MJCF models, mesh dependencies, licensing and a source/checksum manifest. Configure the standalone preset - separately with :class:`embodichain_robots.SharpaWaveCfg`; tactile + separately with :class:`embodichain.extensions.robots.SharpaWaveCfg`; tactile simulation and trained policies are not bundled. Args: diff --git a/extensions/embodichain_robots/sharpa/wave/cfg.py b/embodichain/extensions/robots/sharpa/wave/cfg.py similarity index 100% rename from extensions/embodichain_robots/sharpa/wave/cfg.py rename to embodichain/extensions/robots/sharpa/wave/cfg.py diff --git a/extensions/embodichain_robots/the_robot_studio/__init__.py b/embodichain/extensions/robots/the_robot_studio/__init__.py similarity index 100% rename from extensions/embodichain_robots/the_robot_studio/__init__.py rename to embodichain/extensions/robots/the_robot_studio/__init__.py diff --git a/extensions/embodichain_robots/the_robot_studio/so101/__init__.py b/embodichain/extensions/robots/the_robot_studio/so101/__init__.py similarity index 100% rename from extensions/embodichain_robots/the_robot_studio/so101/__init__.py rename to embodichain/extensions/robots/the_robot_studio/so101/__init__.py diff --git a/extensions/embodichain_robots/the_robot_studio/so101/assets.py b/embodichain/extensions/robots/the_robot_studio/so101/assets.py similarity index 100% rename from extensions/embodichain_robots/the_robot_studio/so101/assets.py rename to embodichain/extensions/robots/the_robot_studio/so101/assets.py diff --git a/extensions/embodichain_robots/the_robot_studio/so101/cfg.py b/embodichain/extensions/robots/the_robot_studio/so101/cfg.py similarity index 100% rename from extensions/embodichain_robots/the_robot_studio/so101/cfg.py rename to embodichain/extensions/robots/the_robot_studio/so101/cfg.py diff --git a/extensions/embodichain_robots/tianji/__init__.py b/embodichain/extensions/robots/tianji/__init__.py similarity index 100% rename from extensions/embodichain_robots/tianji/__init__.py rename to embodichain/extensions/robots/tianji/__init__.py diff --git a/extensions/embodichain_robots/tianji/marvin/__init__.py b/embodichain/extensions/robots/tianji/marvin/__init__.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/__init__.py rename to embodichain/extensions/robots/tianji/marvin/__init__.py diff --git a/extensions/embodichain_robots/tianji/marvin/assets.py b/embodichain/extensions/robots/tianji/marvin/assets.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/assets.py rename to embodichain/extensions/robots/tianji/marvin/assets.py diff --git a/extensions/embodichain_robots/tianji/marvin/cfg.py b/embodichain/extensions/robots/tianji/marvin/cfg.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/cfg.py rename to embodichain/extensions/robots/tianji/marvin/cfg.py diff --git a/extensions/embodichain_robots/tianji/marvin/gripper/__init__.py b/embodichain/extensions/robots/tianji/marvin/gripper/__init__.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/gripper/__init__.py rename to embodichain/extensions/robots/tianji/marvin/gripper/__init__.py diff --git a/extensions/embodichain_robots/tianji/marvin/gripper/_gripper_defaults.py b/embodichain/extensions/robots/tianji/marvin/gripper/_gripper_defaults.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/gripper/_gripper_defaults.py rename to embodichain/extensions/robots/tianji/marvin/gripper/_gripper_defaults.py diff --git a/extensions/embodichain_robots/tianji/marvin/gripper/cfg.py b/embodichain/extensions/robots/tianji/marvin/gripper/cfg.py similarity index 100% rename from extensions/embodichain_robots/tianji/marvin/gripper/cfg.py rename to embodichain/extensions/robots/tianji/marvin/gripper/cfg.py diff --git a/extensions/embodichain_robots/unitree/__init__.py b/embodichain/extensions/robots/unitree/__init__.py similarity index 100% rename from extensions/embodichain_robots/unitree/__init__.py rename to embodichain/extensions/robots/unitree/__init__.py diff --git a/extensions/embodichain_robots/unitree/g1/__init__.py b/embodichain/extensions/robots/unitree/g1/__init__.py similarity index 100% rename from extensions/embodichain_robots/unitree/g1/__init__.py rename to embodichain/extensions/robots/unitree/g1/__init__.py diff --git a/extensions/embodichain_robots/unitree/g1/assets.py b/embodichain/extensions/robots/unitree/g1/assets.py similarity index 100% rename from extensions/embodichain_robots/unitree/g1/assets.py rename to embodichain/extensions/robots/unitree/g1/assets.py diff --git a/extensions/embodichain_robots/unitree/g1/cfg.py b/embodichain/extensions/robots/unitree/g1/cfg.py similarity index 100% rename from extensions/embodichain_robots/unitree/g1/cfg.py rename to embodichain/extensions/robots/unitree/g1/cfg.py diff --git a/extensions/embodichain_robots/unitree/g1/profile.json b/embodichain/extensions/robots/unitree/g1/profile.json similarity index 100% rename from extensions/embodichain_robots/unitree/g1/profile.json rename to embodichain/extensions/robots/unitree/g1/profile.json diff --git a/extensions/embodichain_robots/unitree/go1/__init__.py b/embodichain/extensions/robots/unitree/go1/__init__.py similarity index 100% rename from extensions/embodichain_robots/unitree/go1/__init__.py rename to embodichain/extensions/robots/unitree/go1/__init__.py diff --git a/extensions/embodichain_robots/unitree/go1/assets.py b/embodichain/extensions/robots/unitree/go1/assets.py similarity index 100% rename from extensions/embodichain_robots/unitree/go1/assets.py rename to embodichain/extensions/robots/unitree/go1/assets.py diff --git a/extensions/embodichain_robots/unitree/go1/cfg.py b/embodichain/extensions/robots/unitree/go1/cfg.py similarity index 100% rename from extensions/embodichain_robots/unitree/go1/cfg.py rename to embodichain/extensions/robots/unitree/go1/cfg.py diff --git a/extensions/embodichain_robots/unitree/go1/profile.json b/embodichain/extensions/robots/unitree/go1/profile.json similarity index 100% rename from extensions/embodichain_robots/unitree/go1/profile.json rename to embodichain/extensions/robots/unitree/go1/profile.json diff --git a/extensions/embodichain_robots/unitree/go2/__init__.py b/embodichain/extensions/robots/unitree/go2/__init__.py similarity index 100% rename from extensions/embodichain_robots/unitree/go2/__init__.py rename to embodichain/extensions/robots/unitree/go2/__init__.py diff --git a/extensions/embodichain_robots/unitree/go2/assets.py b/embodichain/extensions/robots/unitree/go2/assets.py similarity index 100% rename from extensions/embodichain_robots/unitree/go2/assets.py rename to embodichain/extensions/robots/unitree/go2/assets.py diff --git a/extensions/embodichain_robots/unitree/go2/cfg.py b/embodichain/extensions/robots/unitree/go2/cfg.py similarity index 100% rename from extensions/embodichain_robots/unitree/go2/cfg.py rename to embodichain/extensions/robots/unitree/go2/cfg.py diff --git a/extensions/embodichain_robots/unitree/go2/profile.json b/embodichain/extensions/robots/unitree/go2/profile.json similarity index 100% rename from extensions/embodichain_robots/unitree/go2/profile.json rename to embodichain/extensions/robots/unitree/go2/profile.json diff --git a/extensions/embodichain_robots/unitree/h1_2/__init__.py b/embodichain/extensions/robots/unitree/h1_2/__init__.py similarity index 100% rename from extensions/embodichain_robots/unitree/h1_2/__init__.py rename to embodichain/extensions/robots/unitree/h1_2/__init__.py diff --git a/extensions/embodichain_robots/unitree/h1_2/assets.py b/embodichain/extensions/robots/unitree/h1_2/assets.py similarity index 100% rename from extensions/embodichain_robots/unitree/h1_2/assets.py rename to embodichain/extensions/robots/unitree/h1_2/assets.py diff --git a/extensions/embodichain_robots/unitree/h1_2/cfg.py b/embodichain/extensions/robots/unitree/h1_2/cfg.py similarity index 100% rename from extensions/embodichain_robots/unitree/h1_2/cfg.py rename to embodichain/extensions/robots/unitree/h1_2/cfg.py diff --git a/extensions/embodichain_robots/unitree/h1_2/profile.json b/embodichain/extensions/robots/unitree/h1_2/profile.json similarity index 100% rename from extensions/embodichain_robots/unitree/h1_2/profile.json rename to embodichain/extensions/robots/unitree/h1_2/profile.json diff --git a/extensions/embodichain_robots/universal_robots/__init__.py b/embodichain/extensions/robots/universal_robots/__init__.py similarity index 100% rename from extensions/embodichain_robots/universal_robots/__init__.py rename to embodichain/extensions/robots/universal_robots/__init__.py diff --git a/extensions/embodichain_robots/universal_robots/assets.py b/embodichain/extensions/robots/universal_robots/assets.py similarity index 100% rename from extensions/embodichain_robots/universal_robots/assets.py rename to embodichain/extensions/robots/universal_robots/assets.py diff --git a/extensions/embodichain_robots/universal_robots/ur_robot.py b/embodichain/extensions/robots/universal_robots/ur_robot.py similarity index 100% rename from extensions/embodichain_robots/universal_robots/ur_robot.py rename to embodichain/extensions/robots/universal_robots/ur_robot.py diff --git a/extensions/embodichain_robots/wheeltec/__init__.py b/embodichain/extensions/robots/wheeltec/__init__.py similarity index 100% rename from extensions/embodichain_robots/wheeltec/__init__.py rename to embodichain/extensions/robots/wheeltec/__init__.py diff --git a/extensions/embodichain_robots/wheeltec/fa2f/README.md b/embodichain/extensions/robots/wheeltec/fa2f/README.md similarity index 100% rename from extensions/embodichain_robots/wheeltec/fa2f/README.md rename to embodichain/extensions/robots/wheeltec/fa2f/README.md diff --git a/extensions/embodichain_robots/wheeltec/fa2f/__init__.py b/embodichain/extensions/robots/wheeltec/fa2f/__init__.py similarity index 100% rename from extensions/embodichain_robots/wheeltec/fa2f/__init__.py rename to embodichain/extensions/robots/wheeltec/fa2f/__init__.py diff --git a/extensions/embodichain_robots/wheeltec/fa2f/assets.py b/embodichain/extensions/robots/wheeltec/fa2f/assets.py similarity index 96% rename from extensions/embodichain_robots/wheeltec/fa2f/assets.py rename to embodichain/extensions/robots/wheeltec/fa2f/assets.py index 03f1e5e3a0..208ba2b963 100644 --- a/extensions/embodichain_robots/wheeltec/fa2f/assets.py +++ b/embodichain/extensions/robots/wheeltec/fa2f/assets.py @@ -44,7 +44,7 @@ class WheelTecFA2F(EmbodiChainDataset): WheelTecFA2F.urdf Example usage: - >>> from embodichain_robots.wheeltec.fa2f.assets import WheelTecFA2F + >>> from embodichain.extensions.robots.wheeltec.fa2f.assets import WheelTecFA2F >>> dataset = WheelTecFA2F() or >>> from embodichain.data import get_data_path diff --git a/extensions/embodichain_robots/wuji/__init__.py b/embodichain/extensions/robots/wuji/__init__.py similarity index 100% rename from extensions/embodichain_robots/wuji/__init__.py rename to embodichain/extensions/robots/wuji/__init__.py diff --git a/extensions/embodichain_robots/wuji/hand/README.md b/embodichain/extensions/robots/wuji/hand/README.md similarity index 100% rename from extensions/embodichain_robots/wuji/hand/README.md rename to embodichain/extensions/robots/wuji/hand/README.md diff --git a/extensions/embodichain_robots/wuji/hand/__init__.py b/embodichain/extensions/robots/wuji/hand/__init__.py similarity index 100% rename from extensions/embodichain_robots/wuji/hand/__init__.py rename to embodichain/extensions/robots/wuji/hand/__init__.py diff --git a/extensions/embodichain_robots/wuji/hand/assets.py b/embodichain/extensions/robots/wuji/hand/assets.py similarity index 96% rename from extensions/embodichain_robots/wuji/hand/assets.py rename to embodichain/extensions/robots/wuji/hand/assets.py index b297aef897..330a20f21a 100644 --- a/extensions/embodichain_robots/wuji/hand/assets.py +++ b/embodichain/extensions/robots/wuji/hand/assets.py @@ -36,7 +36,7 @@ class WujiHand(EmbodiChainDataset): ``get_data_path("WujiHand/right.urdf")``. The bundle also retains the upstream MJCF models, mesh dependencies, licensing and a source/checksum manifest. Configure the standalone preset - separately with :class:`embodichain_robots.WujiHandCfg`; tactile + separately with :class:`embodichain.extensions.robots.WujiHandCfg`; tactile simulation and trained policies are not bundled. Args: diff --git a/extensions/embodichain_robots/wuji/hand/cfg.py b/embodichain/extensions/robots/wuji/hand/cfg.py similarity index 100% rename from extensions/embodichain_robots/wuji/hand/cfg.py rename to embodichain/extensions/robots/wuji/hand/cfg.py diff --git a/extensions/embodichain_solvers/README.md b/embodichain/extensions/solvers/README.md similarity index 73% rename from extensions/embodichain_solvers/README.md rename to embodichain/extensions/solvers/README.md index e00ee34a8a..d8eabedb91 100644 --- a/extensions/embodichain_solvers/README.md +++ b/embodichain/extensions/solvers/README.md @@ -1,17 +1,17 @@ # Native physics deployment adapters -Start with the [NeRD solver quickstart](../../examples/learning/nerd/DEPLOYMENT.md) +Start with the [NeRD solver quickstart](../../../examples/learning/nerd/DEPLOYMENT.md) for a complete model-preparation, step/readback/reset/close example. The -[execution record](../../examples/learning/nerd/VALIDATION.md) separates measured +[execution record](../../../examples/learning/nerd/VALIDATION.md) separates measured native execution from training and viewer claims. -`embodichain_solvers` ships in the main `embodichain` distribution. It shares +`embodichain.extensions.solvers` ships in the main `embodichain` distribution. It shares the existing version/dependencies and `dexsim.newton_solvers` discovery mechanism. Importing the package does not import Torch, models or the SDK. Core simulation never imports a concrete adapter. `physics.nerd.provider` owns the `nerd` Provider and native state/control -binding. Model prediction lives in `embodichain_models.dynamics.nerd`: +binding. Model prediction lives in `embodichain.extensions.models.dynamics.nerd`: `NeRDTransition` combines its injected `NeRDGeometry`, codec, history and network. Native inference and the optional SDK functional service delegate to that same transition; only explicit native publication detaches history. @@ -29,15 +29,15 @@ joint order, COM/velocity convention, contact layout, physical signature, gravit and prediction timestep. Only homogeneous reference Cartpole/Ant domains are supported; a solver entry point does not establish general physical coupling. -Refresh editable mappings after adding the extension. Checkpoints/reference -assets remain outside Git and the wheel; preparation and task/benchmark -workflows belong to `examples/learning/nerd`. +Reinstall the editable checkout to refresh its solver entry-point metadata. +`examples/learning/nerd` owns checkpoint and asset preparation along with the +task and benchmark workflows. `physics.worldparticle.provider` supplies the optional `worldparticle` name. -See the [complete WorldParticle solver quickstart](../../examples/learning/worldparticle/DEPLOYMENT.md), -[input contract](../../examples/learning/worldparticle/INPUTS.md), -[runtime requirements](../../examples/learning/worldparticle/README.md#runtime-requirements) -and [verification summary](../../examples/learning/worldparticle/README.md#verification). +See the [complete WorldParticle solver quickstart](../../../examples/learning/worldparticle/DEPLOYMENT.md), +[input contract](../../../examples/learning/worldparticle/INPUTS.md), +[runtime requirements](../../../examples/learning/worldparticle/README.md#runtime-requirements) +and [verification summary](../../../examples/learning/worldparticle/README.md#verification). The independent `WorldParticleModel` owns features, topology, frozen network and coordinate conversion. The Provider validates native scene, particle count, dt, gravity and supported capabilities; callers must preserve authored particle diff --git a/extensions/embodichain_solvers/embodichain_solvers/__init__.py b/embodichain/extensions/solvers/__init__.py similarity index 100% rename from extensions/embodichain_solvers/embodichain_solvers/__init__.py rename to embodichain/extensions/solvers/__init__.py diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/__init__.py b/embodichain/extensions/solvers/physics/__init__.py similarity index 100% rename from extensions/embodichain_solvers/embodichain_solvers/physics/__init__.py rename to embodichain/extensions/solvers/physics/__init__.py diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/nerd/__init__.py b/embodichain/extensions/solvers/physics/nerd/__init__.py similarity index 100% rename from extensions/embodichain_solvers/embodichain_solvers/physics/nerd/__init__.py rename to embodichain/extensions/solvers/physics/nerd/__init__.py diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/nerd/_binding.py b/embodichain/extensions/solvers/physics/nerd/_binding.py similarity index 99% rename from extensions/embodichain_solvers/embodichain_solvers/physics/nerd/_binding.py rename to embodichain/extensions/solvers/physics/nerd/_binding.py index 55091ef582..e2023c6af6 100644 --- a/extensions/embodichain_solvers/embodichain_solvers/physics/nerd/_binding.py +++ b/embodichain/extensions/solvers/physics/nerd/_binding.py @@ -28,8 +28,8 @@ import torch import warp as wp -from embodichain_models.dynamics.nerd.codec import quat_rotate -from embodichain_models.dynamics.nerd.geometry import NeRDGeometry +from embodichain.extensions.models.dynamics.nerd.codec import quat_rotate +from embodichain.extensions.models.dynamics.nerd.geometry import NeRDGeometry __all__: list[str] = [] diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/nerd/provider.py b/embodichain/extensions/solvers/physics/nerd/provider.py similarity index 98% rename from extensions/embodichain_solvers/embodichain_solvers/physics/nerd/provider.py rename to embodichain/extensions/solvers/physics/nerd/provider.py index 56fb241963..47b7384491 100644 --- a/extensions/embodichain_solvers/embodichain_solvers/physics/nerd/provider.py +++ b/embodichain/extensions/solvers/physics/nerd/provider.py @@ -34,12 +34,15 @@ NewtonSolverContext, NewtonSolverExtension, ) -from embodichain_models.dynamics.nerd.codec import ( +from embodichain.extensions.models.dynamics.nerd.codec import ( NeRDStateCodec, reset_history, ) -from embodichain_models.dynamics.nerd import load_model -from embodichain_models.dynamics.nerd.transition import NeRDState, NeRDTransition +from embodichain.extensions.models.dynamics.nerd import load_model +from embodichain.extensions.models.dynamics.nerd.transition import ( + NeRDState, + NeRDTransition, +) from embodichain.lab.sim.diff._newton_fk import _newton_fk from ._binding import NeRDBinding diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/__init__.py b/embodichain/extensions/solvers/physics/worldparticle/__init__.py similarity index 100% rename from extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/__init__.py rename to embodichain/extensions/solvers/physics/worldparticle/__init__.py diff --git a/extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/provider.py b/embodichain/extensions/solvers/physics/worldparticle/provider.py similarity index 94% rename from extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/provider.py rename to embodichain/extensions/solvers/physics/worldparticle/provider.py index 7057c193ec..8a3f6343ca 100644 --- a/extensions/embodichain_solvers/embodichain_solvers/physics/worldparticle/provider.py +++ b/embodichain/extensions/solvers/physics/worldparticle/provider.py @@ -54,7 +54,9 @@ class WorldParticleProvider: def register_custom_attributes(self, builder: Any, options: dict[str, Any]) -> None: """Declare the authored topology kind before particle materialization.""" - from embodichain_models.dynamics.worldparticle._runtime import load_config + from embodichain.extensions.models.dynamics.worldparticle._runtime import ( + load_config, + ) cfg = load_config(options.get("config")) kind = "cloth" if cfg["data"] == "cloth_on_ball" else "fluid" @@ -66,8 +68,10 @@ def create(self, context: Any, options: dict[str, Any]) -> NewtonSolverExtension """Validate the scene before allocating network weights on the GPU.""" import numpy as np import torch - from embodichain_models.dynamics.worldparticle import _runtime - from embodichain_models.dynamics.worldparticle.model import WorldParticleModel + from embodichain.extensions.models.dynamics.worldparticle import _runtime + from embodichain.extensions.models.dynamics.worldparticle.model import ( + WorldParticleModel, + ) load_assets = _runtime.load_assets diff --git a/extensions/embodichain_tasks/README.md b/embodichain/extensions/tasks/README.md similarity index 89% rename from extensions/embodichain_tasks/README.md rename to embodichain/extensions/tasks/README.md index acc759669e..b5dc73e635 100644 --- a/extensions/embodichain_tasks/README.md +++ b/embodichain/extensions/tasks/README.md @@ -1,10 +1,10 @@ -# embodichain_tasks +# embodichain.extensions.tasks Official task environments for [EmbodiChain](https://github.com/DexForce/EmbodiChain). This source tree contains the official task environments that used to live inside the core `embodichain` import package. It is bundled into the main -`embodichain` wheel as the separate `embodichain_tasks` import package and +`embodichain` wheel under `embodichain.extensions.tasks` and registered through the `embodichain.tasks` entry point. It has no independent distribution metadata or version. @@ -16,7 +16,7 @@ configuration-defined. Optional programs and policy configs live below the same task: ```text -embodichain_tasks//.py +embodichain/extensions/tasks//.py configs/tasks///envs/default.yaml # reusable default backend configs/tasks///envs/newton.yaml # optional Newton backend configs/tasks///task..yaml # componentized runnable deployment @@ -113,7 +113,7 @@ Inspect the selected backend and composed parameters without starting simulation ```bash python .agents/skills/add-task-program/scripts/inspect_deployment.py \ - extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml \ + embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml \ --explain ``` @@ -230,7 +230,7 @@ Example: ```bash python -m embodichain run-task --gym_config \ - extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml + embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml ``` ## Migrating from the solution-first layout @@ -240,9 +240,9 @@ paths must use the task-first locations: | Previous owner | Task-first owner | | --- | --- | -| `embodichain_tasks.rl.basic.` | `embodichain_tasks.classic_control.` | -| `embodichain_tasks.rl.push_cube` | `embodichain_tasks.manipulation.push_cube` | -| `embodichain_tasks.tableware.` | `embodichain_tasks.manipulation.tableware.` | +| `embodichain.extensions.tasks.rl.basic.` | `embodichain.extensions.tasks.classic_control.` | +| `embodichain.extensions.tasks.rl.push_cube` | `embodichain.extensions.tasks.manipulation.push_cube` | +| `embodichain.extensions.tasks.tableware.` | `embodichain.extensions.tasks.manipulation.tableware.` | | Task Program-specific Python task modules | No replacement module for supported config-defined examples; load `configs/tasks/manipulation//task..yaml` | | `configs/tasks/tableware//` | `configs/tasks/manipulation/tableware//` | | `configs/gym/`, `configs/task_program/`, `configs/agents/rl/` | `configs/tasks///` | @@ -263,21 +263,10 @@ The published wheel is installed with the same single-package command: pip install embodichain ``` -When upgrading a development environment that previously installed this source -tree separately, remove the legacy editable distribution once: - -```bash -pip uninstall -y embodichain_tasks -pip install -e . -``` - -Installing `embodichain` registers the bundled `embodichain_tasks` entry point -so the unified CLI can discover every official task it ships. Repository-style -paths beginning with `extensions/embodichain_tasks/configs/` resolve from either a source -checkout or the installed wheel. -The legacy `embodichain_tasks/configs/` prefix remains supported. Sources now -live under `extensions/`; refresh existing editable installations from the -repository root with `pip install -e . --no-deps`. +The `official_tasks` entry point in the `embodichain.tasks` group discovers +the bundled task package. Paths beginning with `embodichain/extensions/tasks/configs/` +resolve from the source checkout or installed wheel. Reinstall an existing +editable checkout to refresh the entry points after upgrading. ## Running a task @@ -287,25 +276,25 @@ selected by the `"id"` field of the gym config. ```bash # Data expansion mode -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml # Newton variant selected from the same deployment -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --physics newton +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --physics newton # Preview mode -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --preview +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml --preview # Equivalent invocations -python -m embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml -python -m embodichain.lab.scripts.run_task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml +python -m embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml +python -m embodichain.lab.scripts.run_task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml # Newton variant selected from the same deployment -python -m embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml --physics newton +python -m embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml --physics newton ``` ## How registration works -Importing `embodichain_tasks` recursively imports every task module, which +Importing `embodichain.extensions.tasks` recursively imports every task module, which triggers its `@register_env` decorator and registers it in the gymnasium registry. Configuration-defined Task Program IDs are registered later by `config_to_cfg()` when their task deployment is loaded. Task listing discovers @@ -314,8 +303,8 @@ top-level JSON/YAML deployments by their non-empty `id` field rather than an unified CLI calls `discover_task_packages()` (from `embodichain.lab.gym.utils.registration`) at startup, which imports this package via its entry point. See the -[task-package discovery utilities](../../embodichain/lab/gym/utils/registration.py) -and the [official task package initializer](embodichain_tasks/__init__.py) for +[task-package discovery utilities](../../lab/gym/utils/registration.py) +and the [official task package initializer](__init__.py) for the implementation. ## Extending with your own tasks @@ -352,7 +341,7 @@ To add a task environment: If your tasks need custom manager modules (observation/reward/event/action functors) or asset resolvers, register them from an `embodichain.init` hook (see `register_manager_modules()` in `embodichain.lab.gym.utils.gym_utils`). -The template uses explicit package imports; `embodichain_tasks` uses the +The template uses explicit package imports; `embodichain.extensions.tasks` uses the `import_packages()` helper for recursive import. ## Using registered tasks with RLinf @@ -360,7 +349,7 @@ The template uses explicit package imports; `embodichain_tasks` uses the RLinf workers use the same installed task packages as the EmbodiChain CLI through the `embodichain.tasks` entry-point group. Install the package in the worker environment and point the adapter at a runnable Gym deployment. See the -[RLinf integration guide](../../docs/source/guides/rlinf.md) for the integration +[RLinf integration guide](../../../docs/source/guides/rlinf.md) for the integration boundary and current compatibility notes. ## Dual-arm qualification scope diff --git a/extensions/embodichain_tasks/embodichain_tasks/__init__.py b/embodichain/extensions/tasks/__init__.py similarity index 55% rename from extensions/embodichain_tasks/embodichain_tasks/__init__.py rename to embodichain/extensions/tasks/__init__.py index 785a804cce..b75da3a9ac 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/__init__.py +++ b/embodichain/extensions/tasks/__init__.py @@ -24,9 +24,6 @@ from __future__ import annotations -from importlib import import_module as _import_module -from pathlib import Path as _Path - from embodichain.lab.gym.utils.gym_utils import register_manager_modules from .utils.importer import import_packages @@ -35,27 +32,10 @@ _BLACKLIST = ["utils"] -# Editable installs map the separate configs package to an absolute checkout. -# Prefer the resources beside the selected source package when PYTHONPATH -# selects another worktree. Restore the code-only search path before walking -# task modules, so the extension container cannot be imported recursively. -_source_root = _Path(__file__).resolve().parent.parent -_source_config = _source_root / "configs" / "__init__.py" -if _source_root.parent.name == "extensions" and _source_config.is_file(): - __path__.append(str(_source_root)) - try: - _config_package = _import_module(f"{__name__}.configs") - if _Path(_config_package.__file__).resolve() != _source_config.resolve(): - raise ImportError( - "Task code and configuration resources belong to different checkouts." - ) - finally: - __path__.remove(str(_source_root)) - register_manager_modules( [ - "embodichain_tasks.locomotion.managers.observations", - "embodichain_tasks.locomotion.managers.rewards", + "embodichain.extensions.tasks.locomotion.managers.observations", + "embodichain.extensions.tasks.locomotion.managers.rewards", ] ) diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/__init__.py b/embodichain/extensions/tasks/classic_control/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/__init__.py rename to embodichain/extensions/tasks/classic_control/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/cart_pole.py b/embodichain/extensions/tasks/classic_control/cart_pole.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/cart_pole.py rename to embodichain/extensions/tasks/classic_control/cart_pole.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/__init__.py b/embodichain/extensions/tasks/classic_control/humanoid/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/__init__.py rename to embodichain/extensions/tasks/classic_control/humanoid/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/humanoid_run.py b/embodichain/extensions/tasks/classic_control/humanoid/humanoid_run.py similarity index 99% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/humanoid_run.py rename to embodichain/extensions/tasks/classic_control/humanoid/humanoid_run.py index e7e26ebd71..eb086ead63 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/humanoid_run.py +++ b/embodichain/extensions/tasks/classic_control/humanoid/humanoid_run.py @@ -34,7 +34,7 @@ __all__ = ["HumanoidRunEnv"] _CONFIG = json.loads( - files("embodichain_tasks.configs") + files("embodichain.extensions.tasks.configs") .joinpath("tasks/classic_control/humanoid/task.json") .read_text() ) diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/mdp.py b/embodichain/extensions/tasks/classic_control/humanoid/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/humanoid/mdp.py rename to embodichain/extensions/tasks/classic_control/humanoid/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/classic_control/point_mass.py b/embodichain/extensions/tasks/classic_control/point_mass.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/classic_control/point_mass.py rename to embodichain/extensions/tasks/classic_control/point_mass.py diff --git a/extensions/embodichain_tasks/configs/__init__.py b/embodichain/extensions/tasks/configs/__init__.py similarity index 98% rename from extensions/embodichain_tasks/configs/__init__.py rename to embodichain/extensions/tasks/configs/__init__.py index 32be9e3027..d61b0eea6e 100644 --- a/extensions/embodichain_tasks/configs/__init__.py +++ b/embodichain/extensions/tasks/configs/__init__.py @@ -29,7 +29,7 @@ def get_config_path(relative_path: str | Path = ".") -> Path: """Return an installed official-task config path. Args: - relative_path: Path relative to the installed ``embodichain_tasks/configs``. + relative_path: Path relative to the installed ``embodichain/extensions/tasks/configs``. Returns: Resolved filesystem path inside the installed task config package. diff --git a/extensions/embodichain_tasks/configs/components/embodiments/cobotmagic.yaml b/embodichain/extensions/tasks/configs/components/embodiments/cobotmagic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/cobotmagic.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/cobotmagic.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_cloth_fold.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_cloth_fold.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_cloth_fold.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_cloth_fold.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.md b/embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.md similarity index 97% rename from extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.md rename to embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.md index 15f1b63dbb..8f8cd5addb 100644 --- a/extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.md +++ b/embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.md @@ -28,7 +28,7 @@ it 20 mm above the object center, leaving the fingertips clear of the table. `FINGER1_JOINT` is actuated and `FINGER2_JOINT` mimics it. Each source joint spans 0–0.05 m: `[0.05, 0.05]` opens and `[0, 0]` closes the jaws. The `pika_gripper` GraspKit geometry is measured from the packaged collision meshes; -see [geometry provenance](../../../../../embodichain/toolkits/graspkit/README.md). +see [geometry provenance](../../../../../toolkits/graspkit/README.md). The embodiment sets gripper drives to 1000 N/m stiffness, 100 N s/m damping, 8 N effort and 0.25 m/s velocity, with finger friction 2.0. These are simulation settings, not hardware ratings. @@ -93,7 +93,7 @@ calibration. The mount coordinates above remain nominal simulation parameters. All nine deployments use `physics: default`, CPU simulation state, and the same embodiment. Native camera rendering and DLSS RR continue to use the GPU. Each lives under `configs/tasks/manipulation//task.dexforce_w1_030_pika.yaml` -in `embodichain_tasks`. Existing default deployments remain selected by default. +in `embodichain.extensions.tasks`. Existing default deployments remain selected by default. | Task | Gym ID prefix | Capability | | --- | --- | --- | @@ -148,8 +148,8 @@ validators. These seeds qualify the configured simulation scenarios; they do not establish arbitrary scene or hardware robustness. ```bash -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml --headless --seed 0 -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml --preview +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml --headless --seed 0 +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml --preview ``` Use `--disable-sensor` to skip acquisition. Existing recorders in RGB block diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_gensim.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_gensim.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_gensim.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_gensim.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140_gensim.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140_gensim.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140_gensim.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_ur10_robotiq_arg2f_140_gensim.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_gs_dual_camera.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_gs_dual_camera.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_gs_dual_camera.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_gs_dual_camera.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda_cartesian.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda_cartesian.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda_cartesian.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda_cartesian.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda_fast_fluid.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda_fast_fluid.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda_fast_fluid.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda_fast_fluid.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda_rgb_224.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda_rgb_224.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda_rgb_224.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda_rgb_224.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda_robotiq85.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda_robotiq85.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda_robotiq85.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda_robotiq85.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml b/embodichain/extensions/tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/piper_x_agx_gripper.yaml b/embodichain/extensions/tasks/configs/components/embodiments/piper_x_agx_gripper.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/piper_x_agx_gripper.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/piper_x_agx_gripper.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/tianji_marvin.yaml b/embodichain/extensions/tasks/configs/components/embodiments/tianji_marvin.yaml similarity index 99% rename from extensions/embodichain_tasks/configs/components/embodiments/tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/tianji_marvin.yaml index 7163a97a83..00f227d00b 100644 --- a/extensions/embodichain_tasks/configs/components/embodiments/tianji_marvin.yaml +++ b/embodichain/extensions/tasks/configs/components/embodiments/tianji_marvin.yaml @@ -1,4 +1,4 @@ -# Parameter provenance: see extensions/embodichain_robots/README.md. +# Parameter provenance: see embodichain/extensions/robots/README.md. # This is a simulation-calibrated embodiment, not a factory hardware profile. # Asset source: DexForceAI/embodichain_data, revision # 48317bd8733182f36d306cc2a7a60ae5e47ed2c9/robot_assets/TianjiMarvin.zip. diff --git a/extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml b/embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml rename to embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/franka_gs_verified.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/franka_gs_verified.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/franka_gs_verified.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/franka_gs_verified.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_projected_manipulation.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_projected_manipulation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_projected_manipulation.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_projected_manipulation.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/real2sim_verified.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/real2sim_verified.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/real2sim_verified.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/real2sim_verified.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/sequential_ik_projected_manipulation.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/sequential_ik_projected_manipulation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/sequential_ik_projected_manipulation.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/sequential_ik_projected_manipulation.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/sequential_ik_verified.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/sequential_ik_verified.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/sequential_ik_verified.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/sequential_ik_verified.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop_dual_arm_manipulation.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop_dual_arm_manipulation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop_dual_arm_manipulation.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop_dual_arm_manipulation.yaml diff --git a/extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop_fluid_pour.yaml b/embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop_fluid_pour.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop_fluid_pour.yaml rename to embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop_fluid_pour.yaml diff --git a/extensions/embodichain_tasks/configs/components/expansion_policies/task_program_episode.yaml b/embodichain/extensions/tasks/configs/components/expansion_policies/task_program_episode.yaml similarity index 95% rename from extensions/embodichain_tasks/configs/components/expansion_policies/task_program_episode.yaml rename to embodichain/extensions/tasks/configs/components/expansion_policies/task_program_episode.yaml index 943aa7b190..bf832d67e4 100644 --- a/extensions/embodichain_tasks/configs/components/expansion_policies/task_program_episode.yaml +++ b/embodichain/extensions/tasks/configs/components/expansion_policies/task_program_episode.yaml @@ -35,7 +35,7 @@ trajectory: visual: enabled: false - profile_file: extensions/embodichain_tasks/configs/components/randomization_profiles/rgb_visual.yaml + profile_file: embodichain/extensions/tasks/configs/components/randomization_profiles/rgb_visual.yaml profiles: [] apply_per_rollout: true balance: round_robin diff --git a/extensions/embodichain_tasks/configs/components/randomization_profiles/cube_initial_pose.yaml b/embodichain/extensions/tasks/configs/components/randomization_profiles/cube_initial_pose.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/randomization_profiles/cube_initial_pose.yaml rename to embodichain/extensions/tasks/configs/components/randomization_profiles/cube_initial_pose.yaml diff --git a/extensions/embodichain_tasks/configs/components/randomization_profiles/rgb_visual.yaml b/embodichain/extensions/tasks/configs/components/randomization_profiles/rgb_visual.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/components/randomization_profiles/rgb_visual.yaml rename to embodichain/extensions/tasks/configs/components/randomization_profiles/rgb_visual.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json similarity index 97% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json index fb9ddfff26..92b4507bf4 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json @@ -1,7 +1,7 @@ { "trainer": { "exp_name": "cart_pole_grpo", - "gym_config": "extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json", + "gym_config": "embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json", "seed": 42, "device": "cuda:0", "headless": true, diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml similarity index 95% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml index 32b0d8eb28..d11a9217d4 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: cart_pole_grpo - gym_config: extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json similarity index 97% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json index 6b89b7b3f4..14f6be7553 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.json @@ -1,7 +1,7 @@ { "trainer": { "exp_name": "cart_pole_ppo", - "gym_config": "extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json", + "gym_config": "embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json", "seed": 42, "device": "cuda:0", "headless": true, diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml similarity index 95% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml index 969c6e8e7a..aaaa0ef50a 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: cart_pole_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/README.md b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/README.md similarity index 85% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/README.md rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/README.md index 342a91d822..b0c1e33194 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/README.md +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/README.md @@ -12,10 +12,10 @@ Each PPO file's `trainer.gym_config` selects its matching deployment. The catalog defaults to `default`; backend selection belongs to the environment file. ```bash -embodichain show-task embodichain_tasks:humanoid -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:humanoid +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml index 7e84c8b220..1828c1fbf6 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: humanoid_run_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml index 0e2ca4379d..58323eff81 100644 --- a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: humanoid_run_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/task.json b/embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/task.json rename to embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/apg_actor_critic.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/classic_control/point_mass/agents/ppo.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/README.md similarity index 97% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/README.md index e329f9d07e..b48be090c4 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/README.md @@ -15,7 +15,7 @@ The command resamples the 30 Hz CSV files to 50 Hz and writes `LAFAN1G1/motion.n ## Train and evaluate ```bash -python -m embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml +python -m embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml ``` Training writes a timestamped `outputs/g1_motion_ppo_smoke_*` directory containing configuration snapshots, TensorBoard metrics, a checkpoint and `run-manifest.json`. Evaluate the newest run from the start of each reference clip: @@ -52,7 +52,7 @@ Run the collection and supervised fitting example after preparing the same data: ```bash python examples/learning/motion_tracking/fit_world_model.py \ - --config extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml \ + --config embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml \ --output outputs/g1_world_model_seed0 ``` @@ -91,7 +91,7 @@ and imagined APG Actor-Critic updates. Its functional, four-clip development and 40-clip convergence configurations are `agents/model_based.yaml`, `agents/model_based_development.yaml` and `agents/model_based_full.yaml`. -See the [online training guide](../../../../../../../examples/learning/motion_tracking/README.md) +See the [online training guide](../../../../../../../../examples/learning/motion_tracking/README.md) for the fixed data source, complete commands, network sizes, gradient boundaries, checkpoint recovery, output schema and physical convergence criteria. diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml similarity index 91% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml index 412aaabec0..7d7b368749 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based.yaml @@ -75,5 +75,5 @@ workflow: adaptive_sampling: true reset_noise: true domain_randomization: true - collection_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml - evaluation_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + collection_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + evaluation_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml similarity index 92% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml index 5280526014..e09d77af65 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_development.yaml @@ -81,5 +81,5 @@ workflow: adaptive_sampling: true reset_noise: true domain_randomization: true - collection_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml - evaluation_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + collection_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + evaluation_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml similarity index 92% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml index abc055bef2..2638fb1e76 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_fixed_wm.yaml @@ -81,5 +81,5 @@ workflow: domain_randomization: true evaluate_final: true learning_mode: fixed_world_model - collection_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml - evaluation_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + collection_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + evaluation_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml similarity index 92% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml index cb4e680e20..2e3231c843 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/model_based_full.yaml @@ -80,5 +80,5 @@ workflow: reset_noise: true domain_randomization: true evaluate_final: true - collection_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml - evaluation_env: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + collection_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + evaluation_env: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml similarity index 92% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml index d601a0c6ec..de07e2b9eb 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: g1_motion_ppo_smoke - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml seed: 0 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.dexuni.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.dexuni.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.dexuni.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.dexuni.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md index 9044bcdfa6..0d4432f4db 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:anymal_c_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:anymal_c_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml index a0f7c80b43..d5c2d75fd0 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: anymal_c_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml index 2b1a5d6a96..46381a65f4 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: anymal_c_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/anymal_c_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/anymal_c_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/README.md index 22521d2f4b..595ec105f8 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:g1_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:g1_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml index 755bf68657..2b8d257bf1 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_g1_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml index 69ce887cbb..403a463a88 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_g1_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/README.md index a4e83b4b18..924bc43b84 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:go1_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:go1_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml index 88c2daf06f..eb57f65b0d 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_go1_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml index 033435f24b..e36489887b 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_go1_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go1_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go1_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/README.md index 3259acea06..341c9f7447 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:go2_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:go2_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml index ade3862ae2..c23bf21445 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_go2_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml index 7f3ce4ce86..a82606fe04 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_go2_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md index b6413fb0ea..d6edfb7b50 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:h1_2_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:h1_2_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml index 3673c0df35..2e15bb64ea 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_h1_2_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml index 763768ee6c..da7ceaa15c 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: unitree_h1_2_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/h1_2_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/h1_2_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md similarity index 90% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md index 5ac8497754..fdb1e588e6 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/README.md @@ -17,9 +17,9 @@ on CUDA (`use_mujoco_cpu: false`). Its MuJoCo settings are explicit, including unbounded policy actions with `clip: null`. ```bash -embodichain show-task embodichain_tasks:microduck_flat -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml +embodichain show-task embodichain.extensions.tasks:microduck_flat +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml ``` ## Evaluation diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml index f13676d290..e74f452d2d 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.newton.yaml @@ -1,6 +1,6 @@ trainer: exp_name: microduck_flat_ppo_newton - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml index 95d23f67bb..5cbe174e86 100644 --- a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml +++ b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/agents/ppo.yaml @@ -1,6 +1,6 @@ trainer: exp_name: microduck_flat_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/task.json b/embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/task.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/locomotion/velocity/microduck_flat/task.json rename to embodichain/extensions/tasks/configs/tasks/locomotion/velocity/microduck_flat/task.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/README.md index 5957b58be5..55d797497a 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/README.md @@ -6,7 +6,7 @@ and yaw. Every collected candidate derives from the real motion prototypes. ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml \ --dataset-dir /tmp/carton-stocking ``` diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/real2sim/collection.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/real2sim/collection.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/real2sim/collection.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/real2sim/collection.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.rgbd.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.rgbd.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.rgbd.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.rgbd.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.ordinary.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.ordinary.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.ordinary.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.ordinary.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/README.md index 1ee932ae43..d33e58dbfc 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/README.md @@ -30,7 +30,7 @@ from embodichain.lab.gym.utils.gym_utils import config_to_cfg from embodichain.lab.gym.utils.registration import make from embodichain.lab.sim import SimulationManager from embodichain.utils.utility import load_config -from embodichain_tasks.configs import get_config_path +from embodichain.extensions.tasks.configs import get_config_path path = get_config_path("tasks/manipulation/cloth_fold/task.w1.yaml") cfg = config_to_cfg(load_config(path), source_path=path) diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task.w1.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task.w1.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task.w1.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task.w1.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/evaluation.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/evaluation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/evaluation.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/evaluation.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz b/embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz rename to embodichain/extensions/tasks/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/README.md index 0bbe3325bd..c899041d51 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/README.md @@ -29,7 +29,7 @@ through the shared Task Program and Atomic Skills. Select `ur5` or `franka` in the config path. ```bash -config=extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml +config=embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml python .agents/skills/add-task-program/scripts/inspect_deployment.py "$config" python -m embodichain run-task --gym-config "$config" \ --headless --device cpu --renderer no-render --disable-sensor --seed 7 @@ -83,7 +83,7 @@ clearance routes, and handle alignment and a contact push to close. ```bash python -m embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml \ --headless --disable-sensor --renderer no-render --device cpu --seed 0 \ --filter-dataset-saving ``` @@ -198,7 +198,7 @@ diverged into arm postures that failed the paper-cup release gate or rode over the handle while closing. ```bash -task=extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage +task=embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage for seed in {0..9}; do python -m scripts.benchmark.task_program.demo_success --run-simulation \ --gym-config "$task/task.ur5.long_horizon.yaml" \ diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/env.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/env.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/env.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/env.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.ur5.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.ur5.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.ur5.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.ur5.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.ur5.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/evaluation.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.franka.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.franka.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.franka.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.franka.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/execution_policy.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.franka.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.franka.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.franka.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.franka.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/README.md similarity index 94% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/README.md index 569b1c29f2..f47397fdb0 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/README.md @@ -16,7 +16,7 @@ Python environment subclass is required. embodichain show-task gaussian_pick_place embodichain list-task --category manipulation embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml \ --headless --seed 42 --max_episodes 2 --record_trajectory \ --trajectory_save_dir outputs/gaussian_pick_place/office ``` @@ -43,7 +43,7 @@ unqualified. Captured lighting is baked. Preserve the packages' upstream licensing/provenance declarations, including the unspecified DISCOVERSE model license. -The [recording example](../../../../../../examples/gym/gaussian_pick_place/README.md) +The [recording example](../../../../../../../examples/gym/gaussian_pick_place/README.md) loads these authoritative definitions, writes portable configuration snapshots, and records complete paired RGB, native trajectories and capture metadata. Media spooling, video export and offline/negative acceptance remain example diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.discoverse.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.discoverse.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.discoverse.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.discoverse.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.office.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.office.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.office.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.office.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.robosimgs.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.robosimgs.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/env.robosimgs.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/env.robosimgs.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.discoverse.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.discoverse.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.discoverse.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.discoverse.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.office.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.office.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.office.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.office.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.robosimgs.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.robosimgs.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.robosimgs.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task_program/program.robosimgs.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/README.md index c62ee00127..e542ece180 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/README.md @@ -28,7 +28,7 @@ that origin. ```bash python -m embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml \ --headless --viser --renderer hybrid --seed 0 --max_episodes 1 --filter-dataset-saving ``` diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/envs/dual_franka_robotiq140.default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/envs/dual_franka_robotiq140.default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/envs/dual_franka_robotiq140.default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/envs/dual_franka_robotiq140.default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/envs/tabletop.default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/envs/tabletop.default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/envs/tabletop.default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/envs/tabletop.default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_franka_robotiq_arg2f_140.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_franka_robotiq_arg2f_140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_franka_robotiq_arg2f_140.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_franka_robotiq_arg2f_140.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_ur5.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_ur5.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_ur5.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_ur5.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.robotiq140.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.robotiq140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.robotiq140.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.robotiq140.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.bar.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.bar.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.bar.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.bar.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.tabletop.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.tabletop.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.tabletop.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.tabletop.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.upright_can.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.upright_can.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.upright_can.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.upright_can.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/README.md similarity index 96% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/README.md index f1ee8a20dd..1a8ac86f9f 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/README.md @@ -26,7 +26,7 @@ Run the configured expansion through the formal task entry point: ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml \ --disable-sensor \ --device cpu --headless --seed 7 \ --output-dir /tmp/open-drawer-expansion \ diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/envs/default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/envs/default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/envs/default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/envs/default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/envs/newton.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/envs/newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/envs/newton.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/envs/newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/expansion/open_drawer.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/expansion/open_drawer.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/expansion/open_drawer.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/expansion/open_drawer.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.franka.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.franka.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.franka.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.franka.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task.ur5.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/README.md similarity index 79% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/README.md index a7bf6deeb1..623a708668 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/README.md @@ -5,9 +5,9 @@ configuration through `trainer.gym_config`. ```bash -embodichain show-task embodichain_tasks:push_cube -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json +embodichain show-task embodichain.extensions.tasks:push_cube +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json ``` The catalog describes configured RL support; it does not claim a trained policy or @@ -22,5 +22,5 @@ condition uses a strict 0.1 m bound; falling below -0.1 m is a failure, whereas the legacy deployment keeps its truncation behavior. ```bash -embodichain train-rl --config extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml +embodichain train-rl --config embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml ``` diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/grpo.json b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/grpo.json similarity index 96% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/grpo.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/grpo.json index ccf986297e..5fd7b7877f 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/grpo.json +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/grpo.json @@ -1,7 +1,7 @@ { "trainer": { "exp_name": "push_cube_grpo", - "gym_config": "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json", + "gym_config": "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json", "seed": 42, "device": "cuda:0", "headless": true, diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml similarity index 95% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml index d6e6deb0f1..4ea9251d9c 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.configured_rl.yaml @@ -1,6 +1,6 @@ trainer: exp_name: push_cube_configured_rl_ppo - gym_config: extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml + gym_config: embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml seed: 42 device: cuda:0 headless: true diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json similarity index 97% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json index cae6fb79a7..18f2d4f6e5 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json @@ -1,7 +1,7 @@ { "trainer": { "exp_name": "push_cube_ppo", - "gym_config": "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json", + "gym_config": "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json", "seed": 42, "device": "cuda:0", "headless": true, diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.visual.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.visual.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.visual.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.visual.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/README.md similarity index 96% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/README.md index af6e389b06..fc0c3ca37d 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/README.md @@ -35,9 +35,9 @@ backend. Inspect the available deployments: ```bash -embodichain show-task embodichain_tasks:repeated_pick_place +embodichain show-task embodichain.extensions.tasks:repeated_pick_place embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml ``` ## Configured trajectory expansion @@ -59,7 +59,7 @@ Run the complete 64-recipe batch schedule through the formal task entry point: ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --device cpu --headless --seed 7 \ --output-dir /tmp/repeated-pick-place/expansion \ --dataset-dir /tmp/repeated-pick-place/datasets @@ -88,10 +88,10 @@ below the repository's `output/` directory unless `--output-dir` overrides it: ```bash python examples/expansion/trajectory/repeated_pick_place_expansion_combined.py \ - --task-config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml + --task-config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml python examples/expansion/trajectory/repeated_pick_place_expansion_showcase.py \ - --task-config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ + --task-config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml \ --candidate-indices 0 16 32 48 --num_envs 16 --seed 7 \ --device cpu --headless ``` @@ -126,7 +126,7 @@ Run without creating a training dataset: ```bash python -m embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml \ --headless --viser --renderer hybrid --seed 0 --max_episodes 1 --filter-dataset-saving ``` diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_franka_robotiq140.default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_franka_robotiq140.default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_franka_robotiq140.default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_franka_robotiq140.default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_ur10_robotiq140.default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_ur10_robotiq140.default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_ur10_robotiq140.default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/dual_ur10_robotiq140.default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/tabletop.default.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/tabletop.default.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/tabletop.default.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/tabletop.default.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/expansion/repeated_pick_place.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/objective.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/objective.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/objective.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/objective.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140_gensim.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140_gensim.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140_gensim.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_franka_robotiq_arg2f_140_gensim.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140_gensim.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140_gensim.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140_gensim.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur10_robotiq_arg2f_140_gensim.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.objective.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.robotiq140.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.robotiq140.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.robotiq140.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.robotiq140.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.tabletop.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.tabletop.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.tabletop.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.tabletop.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.robotiq_workbench.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.robotiq_workbench.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.robotiq_workbench.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.robotiq_workbench.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.tabletop.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.tabletop.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.tabletop.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.tabletop.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.workbench.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.workbench.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.workbench.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.workbench.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task.ur5.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task.ur5.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task.ur5.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task.ur5.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md similarity index 97% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md index d90f2fad1b..41f3a74f27 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/README.md @@ -30,7 +30,7 @@ Run from the repository root with the project's simulation Python environment: ```bash python -m embodichain run-task \ - --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml ``` Static deployment inspection checks schema, component composition, resources, diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.cobotmagic.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_rgb/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.json b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/blocks_ranking_size/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.json b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/match_object_container/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/match_object_container/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.json b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/place_object_drawer/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/README.md similarity index 96% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/README.md index 6e6e7b985a..415978d175 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/README.md @@ -18,7 +18,7 @@ ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ --num-envs 1 --headless --renderer fast-rt ``` @@ -79,12 +79,12 @@ Gym 的 `qualification_result.json` 和 Sim 的 `validation.json` 分别记录 ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ --num-envs 1 --headless --renderer fast-rt \ --record-trajectory --record-fluid-state \ --trajectory-save-dir outputs/fluid-task-program-online embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml \ --num-envs 1 --replay \ --replay_trajectory outputs/fluid-task-program-online/fluid_batch_000000_RUN_ID.pt \ --replay_mode kinematic # 或 dynamic diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/env.fluid.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/env.fluid.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/env.fluid.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/env.fluid.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/integration.fluid.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/integration.fluid.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/integration.fluid.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/integration.fluid.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/program.fluid.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/program.fluid.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/program.fluid.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task_program/program.fluid.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/README.md index 6138b57ea2..dc18fa3b03 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/README.md @@ -20,7 +20,7 @@ From the repository root, using the project's simulation Python environment: ```bash python -m embodichain run-task \ - --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml ``` The registered `PourWaterAssets` bundle downloads and extracts automatically @@ -107,7 +107,7 @@ and the environment allows 3200 steps (32 s) for the complete program. The robot ```bash python -m embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml \ --headless --viser --renderer hybrid --seed 0 --max_episodes 1 --filter-dataset-saving ``` @@ -190,7 +190,7 @@ python -m pytest -q tests/scripts/tools/test_prepare_pour_water_assets.py \ tests/gym/envs/task_program/test_configured_integration.py python .agents/skills/add-task-program/scripts/inspect_deployment.py \ - extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml + embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml ``` The idle-arm regression is covered by @@ -227,7 +227,7 @@ python -m scripts.benchmark.robotics.cobotmagic_drives \ --output-dir outputs/benchmarks/cobotmagic_drives python -m scripts.benchmark.robotics.cobotmagic_drives \ - --task-config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ + --task-config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml \ --bottle-masses 0.01 0.1 0.25 --seeds 0 1 2 \ --renderer hybrid \ --output-dir outputs/benchmarks/pour_water_per_joint_pd diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.cobotmagic.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/evaluation.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/evaluation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/evaluation.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/evaluation.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dual_arm.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dual_arm.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dual_arm.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.dual_arm.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.workbench.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.workbench.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.workbench.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.workbench.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md similarity index 98% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md index 7f2587f538..6e292fb7e9 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/README.md @@ -33,7 +33,7 @@ Run from the repository root with the project's simulation Python environment: ```bash python -m embodichain run-task \ - --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml + --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml ``` The runnable file selects the physical scene, shared robot/sensors, program, diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.policy.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.policy.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.policy.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.policy.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.measured.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.measured.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.measured.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.measured.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/evaluation.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/integration.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/integration.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/integration.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/integration.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.measured.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.measured.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.measured.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.measured.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task_program/program.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/README.md b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/README.md similarity index 80% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/README.md rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/README.md index f001726fff..b2919e0181 100644 --- a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/README.md +++ b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/README.md @@ -6,8 +6,8 @@ The task currently supplies an environment, with no expert demonstration hook or bundled RL training configuration. ```bash -embodichain show-task embodichain_tasks:stack_cups -embodichain run-task --gym_config extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.json +embodichain show-task embodichain.extensions.tasks:stack_cups +embodichain run-task --gym_config embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.json ``` Environment availability does not imply a successful stacking controller. No diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/catalog.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/catalog.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/catalog.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/catalog.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.json b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.json similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.json rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.json diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/env.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/env.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.dexforce_w1_030_pika.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.dexforce_w1_030_pika.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.dexforce_w1_030_pika.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.dexforce_w1_030_pika.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.dual_ur5_dh_pgi_140_80.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.dual_ur5_dh_pgi_140_80.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.dual_ur5_dh_pgi_140_80.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.dual_ur5_dh_pgi_140_80.yaml diff --git a/extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.tianji_marvin.yaml b/embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.tianji_marvin.yaml similarity index 100% rename from extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_cups/task.tianji_marvin.yaml rename to embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_cups/task.tianji_marvin.yaml diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/__init__.py b/embodichain/extensions/tasks/locomotion/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/__init__.py rename to embodichain/extensions/tasks/locomotion/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/__init__.py b/embodichain/extensions/tasks/locomotion/managers/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/__init__.py rename to embodichain/extensions/tasks/locomotion/managers/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/actions.py b/embodichain/extensions/tasks/locomotion/managers/actions.py similarity index 95% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/actions.py rename to embodichain/extensions/tasks/locomotion/managers/actions.py index 74064b174f..f4b5b36f0d 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/actions.py +++ b/embodichain/extensions/tasks/locomotion/managers/actions.py @@ -23,7 +23,9 @@ if TYPE_CHECKING: from embodichain.lab.gym.envs.managers.cfg import ActionTermCfg - from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv + from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, + ) __all__ = ["ReferenceJointPositionAction"] diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/events.py b/embodichain/extensions/tasks/locomotion/managers/events.py similarity index 94% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/events.py rename to embodichain/extensions/tasks/locomotion/managers/events.py index 502193b4da..195101263a 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/events.py +++ b/embodichain/extensions/tasks/locomotion/managers/events.py @@ -22,7 +22,9 @@ import torch if TYPE_CHECKING: - from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv + from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, + ) __all__ = ["randomize_motion_context"] diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/observations.py b/embodichain/extensions/tasks/locomotion/managers/observations.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/observations.py rename to embodichain/extensions/tasks/locomotion/managers/observations.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/rewards.py b/embodichain/extensions/tasks/locomotion/managers/rewards.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/managers/rewards.py rename to embodichain/extensions/tasks/locomotion/managers/rewards.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/__init__.py b/embodichain/extensions/tasks/locomotion/tracking/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/__init__.py rename to embodichain/extensions/tasks/locomotion/tracking/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/_task.py b/embodichain/extensions/tasks/locomotion/tracking/_task.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/_task.py rename to embodichain/extensions/tasks/locomotion/tracking/_task.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/g1_motion.py b/embodichain/extensions/tasks/locomotion/tracking/g1_motion.py similarity index 98% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/g1_motion.py rename to embodichain/extensions/tasks/locomotion/tracking/g1_motion.py index be7d2eb68e..64157ef10a 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/g1_motion.py +++ b/embodichain/extensions/tasks/locomotion/tracking/g1_motion.py @@ -48,10 +48,16 @@ ) from embodichain.utils import configclass from embodichain.utils.math import matrix_from_quat -from embodichain_robots.locomotion_profiles import load_locomotion_robot_profile -from embodichain_tasks.locomotion.managers.actions import ReferenceJointPositionAction +from embodichain.extensions.robots.locomotion_profiles import ( + load_locomotion_robot_profile, +) +from embodichain.extensions.tasks.locomotion.managers.actions import ( + ReferenceJointPositionAction, +) from ._task import MotionTrackingCfg, MotionTrackingTask -from embodichain_tasks.locomotion.managers.events import randomize_motion_context +from embodichain.extensions.tasks.locomotion.managers.events import ( + randomize_motion_context, +) __all__ = ["G1MotionCfg", "UnitreeG1MotionEnv"] diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/motion_model.py b/embodichain/extensions/tasks/locomotion/tracking/motion_model.py similarity index 98% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/motion_model.py rename to embodichain/extensions/tasks/locomotion/tracking/motion_model.py index 58f2f673a8..66d8d7219e 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/locomotion/tracking/motion_model.py +++ b/embodichain/extensions/tasks/locomotion/tracking/motion_model.py @@ -30,8 +30,11 @@ from embodichain.data_pipeline.datasets.motion import MotionLibrary from embodichain.learning.rl.env import DifferentiableRolloutSpec, register_learning_env from embodichain.utils import configclass -from embodichain_models.dynamics.rwm import KinematicWorldModel, TransitionReplay -from embodichain_models.dynamics.rwm.robot_state import unpack_robot_state +from embodichain.extensions.models.dynamics.rwm import ( + KinematicWorldModel, + TransitionReplay, +) +from embodichain.extensions.models.dynamics.rwm.robot_state import unpack_robot_state from ._task import MotionTrackingTask __all__ = [ diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/_embodichain.py b/embodichain/extensions/tasks/locomotion/velocity/_embodichain.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/_embodichain.py rename to embodichain/extensions/tasks/locomotion/velocity/_embodichain.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/anymal_c_flat.py b/embodichain/extensions/tasks/locomotion/velocity/anymal_c_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/anymal_c_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/anymal_c_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/_config.py similarity index 89% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/_config.py index c5fbbb6e36..81eabcb119 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_config.py +++ b/embodichain/extensions/tasks/locomotion/velocity/contracts/_config.py @@ -21,14 +21,16 @@ import json from importlib.resources import files -from embodichain_robots.locomotion_profiles import load_locomotion_robot_profile +from embodichain.extensions.robots.locomotion_profiles import ( + load_locomotion_robot_profile, +) __all__ = ["load_task_data"] def load_task_data(task_name: str) -> dict: """Load one velocity task definition from the configuration package.""" - resource = files("embodichain_tasks.configs").joinpath( + resource = files("embodichain.extensions.tasks.configs").joinpath( "tasks", "locomotion", "velocity", task_name, "task.json" ) data = json.loads(resource.read_text(encoding="utf-8")) diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_math.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/_math.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_math.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/_math.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_reward_terms.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/_reward_terms.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/_reward_terms.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/_reward_terms.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/anymal_c/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/anymal_c/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/g1/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/g1/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/g1/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/g1/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/g1/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/g1/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/g1/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go1/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go1/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go1/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go1/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go1/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go1/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go1/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go2/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go2/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go2/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go2/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/go2/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/go2/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/go2/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/h1_2/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/h1_2/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/__init__.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/__init__.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/config.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/config.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/config.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/config.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/mdp.py b/embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/mdp.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts/microduck/mdp.py rename to embodichain/extensions/tasks/locomotion/velocity/contracts/microduck/mdp.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/g1_flat.py b/embodichain/extensions/tasks/locomotion/velocity/g1_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/g1_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/g1_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/go1_flat.py b/embodichain/extensions/tasks/locomotion/velocity/go1_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/go1_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/go1_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/go2_flat.py b/embodichain/extensions/tasks/locomotion/velocity/go2_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/go2_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/go2_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/h1_2_flat.py b/embodichain/extensions/tasks/locomotion/velocity/h1_2_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/h1_2_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/h1_2_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/microduck_flat.py b/embodichain/extensions/tasks/locomotion/velocity/microduck_flat.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/microduck_flat.py rename to embodichain/extensions/tasks/locomotion/velocity/microduck_flat.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/__init__.py b/embodichain/extensions/tasks/manipulation/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/__init__.py rename to embodichain/extensions/tasks/manipulation/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/push_cube.py b/embodichain/extensions/tasks/manipulation/push_cube.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/push_cube.py rename to embodichain/extensions/tasks/manipulation/push_cube.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/__init__.py b/embodichain/extensions/tasks/manipulation/tableware/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/__init__.py rename to embodichain/extensions/tasks/manipulation/tableware/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/blocks_ranking_size.py b/embodichain/extensions/tasks/manipulation/tableware/blocks_ranking_size.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/blocks_ranking_size.py rename to embodichain/extensions/tasks/manipulation/tableware/blocks_ranking_size.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/match_object_container.py b/embodichain/extensions/tasks/manipulation/tableware/match_object_container.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/match_object_container.py rename to embodichain/extensions/tasks/manipulation/tableware/match_object_container.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/place_object_drawer.py b/embodichain/extensions/tasks/manipulation/tableware/place_object_drawer.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/place_object_drawer.py rename to embodichain/extensions/tasks/manipulation/tableware/place_object_drawer.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/stack_cups.py b/embodichain/extensions/tasks/manipulation/tableware/stack_cups.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/manipulation/tableware/stack_cups.py rename to embodichain/extensions/tasks/manipulation/tableware/stack_cups.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/special/__init__.py b/embodichain/extensions/tasks/special/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/special/__init__.py rename to embodichain/extensions/tasks/special/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/special/franka_reach_apg.py b/embodichain/extensions/tasks/special/franka_reach_apg.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/special/franka_reach_apg.py rename to embodichain/extensions/tasks/special/franka_reach_apg.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/utils/__init__.py b/embodichain/extensions/tasks/utils/__init__.py similarity index 100% rename from extensions/embodichain_tasks/embodichain_tasks/utils/__init__.py rename to embodichain/extensions/tasks/utils/__init__.py diff --git a/extensions/embodichain_tasks/embodichain_tasks/utils/importer.py b/embodichain/extensions/tasks/utils/importer.py similarity index 98% rename from extensions/embodichain_tasks/embodichain_tasks/utils/importer.py rename to embodichain/extensions/tasks/utils/importer.py index 8e2c6259cd..5915213192 100644 --- a/extensions/embodichain_tasks/embodichain_tasks/utils/importer.py +++ b/embodichain/extensions/tasks/utils/importer.py @@ -36,7 +36,7 @@ def import_packages(package_name: str, blacklist: list[str] | None = None) -> No call ``gym.register()``. Args: - package_name: The fully-qualified package name (e.g. ``"embodichain_tasks"``). + package_name: The fully-qualified package name (e.g. ``"embodichain.extensions.tasks"``). blacklist: Module or package names to skip (e.g. ``["utils"]``). """ blacklist = blacklist or [] diff --git a/embodichain/lab/gym/envs/__init__.py b/embodichain/lab/gym/envs/__init__.py index 2cac09e006..c71bfd4bc1 100644 --- a/embodichain/lab/gym/envs/__init__.py +++ b/embodichain/lab/gym/envs/__init__.py @@ -27,6 +27,6 @@ from .types import * from .wrapper import * -# Official task environments live in the bundled ``embodichain_tasks`` package +# Official task environments live in the bundled ``embodichain.extensions.tasks`` package # and register through the same ``embodichain.tasks`` entry-point mechanism as # third-party task packages. diff --git a/embodichain/lab/gym/utils/registration.py b/embodichain/lab/gym/utils/registration.py index 2ba2119e15..7cd7f9cb49 100644 --- a/embodichain/lab/gym/utils/registration.py +++ b/embodichain/lab/gym/utils/registration.py @@ -23,7 +23,6 @@ import importlib.util import json import logging -import os import sys import torch @@ -387,62 +386,6 @@ def register_env_function( return cls -def _import_task_package(ep: importlib.metadata.EntryPoint): - """Import a task package and ensure its auto-registration runs. - - Legacy editable installs from before official tasks were bundled in the - main distribution can expose two editable projects from the same checkout. - The ``extensions/embodichain_tasks/`` source container may then be picked - up as a namespace package that shadows the real - ``extensions/embodichain_tasks/embodichain_tasks/`` package. - - A namespace package never executes ``__init__.py``, so the package's - ``import_packages()`` call -- which triggers every ``@register_env`` -- - is skipped and no environments are registered. - - When such shadowing is detected (the imported module has no ``__file__``), - this helper locates the real ``__init__.py`` beneath one of the namespace's - search locations (``//__init__.py``) and loads it - directly so registration runs. This is a no-op for regular, non-shadowed - installs. - - Args: - ep: The ``embodichain.tasks`` entry point to import. - - Returns: - The imported module (the real package when possible, otherwise the - namespace module). - """ - module_name = ep.value - top_level = module_name.partition(".")[0] - mod = importlib.import_module(module_name) - if getattr(mod, "__file__", None) is not None: - return mod - - # Only top-level packages can be reliably force-loaded here; dotted entry - # point values fall back to the plain import above. - if module_name != top_level: - return mod - - # Namespace shadowing: search each namespace location for the real - # package's __init__.py and load it in place of the namespace module. - for location in list(getattr(mod, "__path__", [])): - init_path = os.path.join(location, top_level, "__init__.py") - if not os.path.isfile(init_path): - continue - pkg_dir = os.path.dirname(init_path) - spec = importlib.util.spec_from_file_location( - top_level, init_path, submodule_search_locations=[pkg_dir] - ) - if spec is None or spec.loader is None: - continue - real_mod = importlib.util.module_from_spec(spec) - sys.modules[top_level] = real_mod - spec.loader.exec_module(real_mod) - return real_mod - return mod - - def discover_task_packages() -> list[str]: """Import all registered task packages via ``embodichain.tasks`` entry_points. @@ -462,7 +405,7 @@ def discover_task_packages() -> list[str]: for ep in eps: try: - _import_task_package(ep) + importlib.import_module(ep.value) imported.append(ep.name) except Exception: _logger.warning( diff --git a/embodichain/lab/sim/motion/expansion/combined.py b/embodichain/lab/sim/motion/expansion/combined.py index 0acae6e3b6..4fd335c21b 100644 --- a/embodichain/lab/sim/motion/expansion/combined.py +++ b/embodichain/lab/sim/motion/expansion/combined.py @@ -193,7 +193,7 @@ class _SceneRandomizationCfg: reference_family_count: int = 4 profile: str = "cube_initial_pose" profile_file: str = ( - "extensions/embodichain_tasks/configs/components/randomization_profiles/" + "embodichain/extensions/tasks/configs/components/randomization_profiles/" "cube_initial_pose.yaml" ) change_scope: str = "cube_initial_pose_only" @@ -289,7 +289,7 @@ def __post_init__(self) -> None: class _VisualCfg: enabled: bool = True profile_file: str = ( - "extensions/embodichain_tasks/configs/components/randomization_profiles/rgb_visual.yaml" + "embodichain/extensions/tasks/configs/components/randomization_profiles/rgb_visual.yaml" ) profiles: tuple[str, ...] = ( "rgb_canonical", diff --git a/embodichain/lab/sim/robots/__init__.py b/embodichain/lab/sim/robots/__init__.py index 9505a1703b..df2ac05b9b 100644 --- a/embodichain/lab/sim/robots/__init__.py +++ b/embodichain/lab/sim/robots/__init__.py @@ -14,7 +14,7 @@ # limitations under the License. # ---------------------------------------------------------------------------- -"""Generic dual-arm composition; concrete presets live in embodichain_robots.""" +"""Generic dual-arm composition; concrete presets live in embodichain.extensions.robots.""" from __future__ import annotations diff --git a/embodichain/learning/rl/env.py b/embodichain/learning/rl/env.py index ce1b86bd8c..eeb0018fd7 100644 --- a/embodichain/learning/rl/env.py +++ b/embodichain/learning/rl/env.py @@ -185,8 +185,8 @@ def prepare_differentiable_rollout( def _is_nested_package_shadow(existing: Any, candidate: Any) -> bool: """Return True when ``candidate`` is an editable-install nested duplicate. - Legacy editable installs can expose both a canonical ``embodichain_tasks`` - module and a nested ``embodichain_tasks.embodichain_tasks`` duplicate. + Legacy editable installs can expose both a canonical ``embodichain.extensions.tasks`` + module and a nested ``embodichain.extensions.tasks.embodichain.extensions.tasks`` duplicate. Prefer the shorter canonical module path already registered. """ existing_module = getattr(existing, "__module__", "") or "" diff --git a/embodichain/learning/rl/train.py b/embodichain/learning/rl/train.py index 49bdb742ba..0d9ff66436 100644 --- a/embodichain/learning/rl/train.py +++ b/embodichain/learning/rl/train.py @@ -924,7 +924,7 @@ def cli(argv: Sequence[str] | None = None) -> None: Task packages are discovered (and init hooks executed) before training so that task environments registered in separate packages (e.g. - ``embodichain_tasks``) are available to ``build_env``. This mirrors the + ``embodichain.extensions.tasks``) are available to ``build_env``. This mirrors the ``run_task`` CLI. """ args = parse_args(argv) diff --git a/embodichain/toolkits/graspkit/README.md b/embodichain/toolkits/graspkit/README.md index 5b4e63e637..7aff847ef4 100644 --- a/embodichain/toolkits/graspkit/README.md +++ b/embodichain/toolkits/graspkit/README.md @@ -137,7 +137,7 @@ remain separate, preserving their existing samples and provenance. ## Versioned geometry sources The source archives are the official assets selected by -the asset registry and `extensions/embodichain_robots/`, pinned here to dataset revision +the asset registry and `embodichain/extensions/robots/`, pinned here to dataset revision `48317bd8733182f36d306cc2a7a60ae5e47ed2c9`. Their MD5 checksums were verified against the download registry. These presets describe those simulation assets; the CobotMagic V70 variant needs its own ID. @@ -223,7 +223,7 @@ Collision meshes under `Collision/`: ### PikaGripper -Source: `PikaGripper/PikaGripper.urdf`, registered by `embodichain_robots.agilex.pika.assets.PikaGripper`. +Source: `PikaGripper/PikaGripper.urdf`, registered by `embodichain.extensions.robots.agilex.pika.assets.PikaGripper`. Archive MD5: `8a9d0779e7dbfa7bf5d4713175df014e`; URDF SHA-256: `cb99efefd74f26011c56d5afcf13839c13a5374160fecb02ac02ba9fa172d952`. diff --git a/embodichain/utils/config_paths.py b/embodichain/utils/config_paths.py index 442fa4994d..fcf4077c2f 100644 --- a/embodichain/utils/config_paths.py +++ b/embodichain/utils/config_paths.py @@ -22,6 +22,8 @@ __all__ = ["resolve_config_path"] +_OFFICIAL_TASK_CONFIGS = Path("embodichain/extensions/tasks/configs") + def resolve_config_path( path: str | Path, *, base_dir: str | Path | None = None @@ -30,10 +32,8 @@ def resolve_config_path( Existing, absolute, and ordinary relative paths preserve their normal filesystem meaning. Repository-style paths below - ``extensions/embodichain_tasks/configs`` (or the legacy - ``embodichain_tasks/configs`` prefix) are redirected to the packaged task-config - resource so the same configuration reference works from an installed - wheel. + ``embodichain/extensions/tasks/configs`` resolve to the packaged task + resources when opening them from outside the checkout. With an explicit owner directory, ordinary relative references resolve from that directory even when a same-named CWD file exists. Official-task @@ -56,41 +56,17 @@ def resolve_config_path( if resolved_path.is_absolute() or (base_dir is None and resolved_path.exists()): return resolved_path - task_prefixes = ( - ("extensions", "embodichain_tasks", "configs"), - ("embodichain_tasks", "configs"), - ) - task_prefix = next( - ( - prefix - for prefix in task_prefixes - if resolved_path.parts[: len(prefix)] == prefix - ), - None, - ) - if task_prefix is None: + if not resolved_path.is_relative_to(_OFFICIAL_TASK_CONFIGS): return ( resolved_path if base_dir is None else Path(base_dir).expanduser() / resolved_path ) - relative_path = Path(*resolved_path.parts[len(task_prefix) :]) - if relative_path.is_absolute() or ".." in relative_path.parts: + relative_path = resolved_path.relative_to(_OFFICIAL_TASK_CONFIGS) + if ".." in relative_path.parts: raise ValueError(f"Config path must stay within the package: {relative_path}") - # Prefer configs co-located with the imported core package. This keeps a - # source worktree self-contained even when another checkout is installed - # in editable mode, and resolves to the same location in a wheel install. + # Bind packaged configs to the same checkout or wheel as the imported SDK. sdk_root = Path(__file__).resolve().parents[2] - for prefix in task_prefixes: - colocated_root = sdk_root / Path(*prefix) - colocated_path = colocated_root / relative_path - if colocated_path.exists() or ( - base_dir is not None and colocated_root.is_dir() - ): - return colocated_path - - from embodichain_tasks.configs import get_config_path - - return get_config_path(relative_path) + return sdk_root / _OFFICIAL_TASK_CONFIGS / relative_path diff --git a/embodichain/utils/utility.py b/embodichain/utils/utility.py index cee193331e..e74f929fea 100644 --- a/embodichain/utils/utility.py +++ b/embodichain/utils/utility.py @@ -355,8 +355,7 @@ def load_config(path: str | Path) -> Dict[str, Any]: Args: path: Path to the config file. Repository-style paths beginning with - ``extensions/embodichain_tasks/configs`` or the legacy - ``embodichain_tasks/configs`` also resolve from an installed wheel. + ``embodichain/extensions/tasks/configs`` also resolve from an installed wheel. Returns: The parsed config dictionary. diff --git a/examples/README.md b/examples/README.md index 88200c91ac..ac232918b0 100644 --- a/examples/README.md +++ b/examples/README.md @@ -50,7 +50,7 @@ The [NeRD showcase](learning/nerd/README.md) prepares pinned external resources, trains through the shared SL recipe, exports models and evaluates saved transitions. Its private support code owns teacher collection, historical training and reference experiments. Reusable models and codecs are installed -as `embodichain_models`; downloaded datasets, weights and raw reference assets +as `embodichain.extensions.models`; downloaded datasets, weights and raw reference assets are stored outside the repository and wheel. The [SL data-source example](learning/sl_data_source/README.md) connects resident @@ -64,7 +64,7 @@ held-out targets, with frozen inference for interactive target edits. The [RWM fitting example](learning/rwm/README.md) qualifies controlled supervised state-transition fitting and state/action gradients. Its generated recipes use -the installable `embodichain_models.dynamics.rwm` model family and shared SL +the installable `embodichain.extensions.models.dynamics.rwm` model family and shared SL trainer; its corpus generation and acceptance helpers remain private to the example. The [Sharpa in-hand example](learning/sharpa_inhand/README.md) trains cylinder diff --git a/examples/data_pipeline/online_dataset_demo.py b/examples/data_pipeline/online_dataset_demo.py index ac68132279..3a6e79524e 100644 --- a/examples/data_pipeline/online_dataset_demo.py +++ b/examples/data_pipeline/online_dataset_demo.py @@ -69,7 +69,7 @@ def _build_engine(args: argparse.Namespace) -> OnlineDataEngine: from embodichain.utils.config_paths import resolve_config_path config_path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml", + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.franka.yaml", base_dir=Path(__file__).parent, ) if not config_path.exists(): diff --git a/examples/expansion/README.md b/examples/expansion/README.md index cee17f26bb..b8dbebf336 100644 --- a/examples/expansion/README.md +++ b/examples/expansion/README.md @@ -12,7 +12,7 @@ provide runnable entry points, local configurations and inspectable outputs. Asset-generalization Task Programs and physical environments live in `asset_generalization/configs/`. These are example-local configurations, not -additional tasks installed into `embodichain_tasks`. They reuse the SDK's robot +additional tasks installed into `embodichain.extensions.tasks`. They reuse the SDK's robot embodiments, policies and asset registry. Run from the repository root with compatible SDK dependencies: diff --git a/examples/expansion/asset_generalization/configs/cube_platform_pick_place/task.ur5.yaml b/examples/expansion/asset_generalization/configs/cube_platform_pick_place/task.ur5.yaml index f1ea9b9206..ae3e6d6259 100644 --- a/examples/expansion/asset_generalization/configs/cube_platform_pick_place/task.ur5.yaml +++ b/examples/expansion/asset_generalization/configs/cube_platform_pick_place/task.ur5.yaml @@ -4,9 +4,9 @@ environment: task_program: program: task_program/program.yaml integration: task_program/integration.yaml - execution_policy: extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml + execution_policy: embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml overrides: init_qpos: [0.0, -1.57, 1.57, -1.57, -1.57, 0.0, 0.0, 0.0] headless: true diff --git a/examples/expansion/asset_generalization/configs/pour_water/task.cobotmagic.yaml b/examples/expansion/asset_generalization/configs/pour_water/task.cobotmagic.yaml index 73cef7c406..2f06eb3b45 100644 --- a/examples/expansion/asset_generalization/configs/pour_water/task.cobotmagic.yaml +++ b/examples/expansion/asset_generalization/configs/pour_water/task.cobotmagic.yaml @@ -5,14 +5,14 @@ task_program: program: task_program/program.yaml integration: task_program/integration.yaml execution_policy: - component: extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml + component: embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml overrides: motion: sample_count: 160 recovery: goal_rotation_threshold: 3.141592653589793 embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/cobotmagic.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/cobotmagic.yaml headless: true renderer: no-render enable_sensor: false diff --git a/examples/expansion/asset_generalization/pour_water.py b/examples/expansion/asset_generalization/pour_water.py index 4239fc6dbf..6dc4d1316b 100644 --- a/examples/expansion/asset_generalization/pour_water.py +++ b/examples/expansion/asset_generalization/pour_water.py @@ -60,7 +60,7 @@ from embodichain.utils.config_paths import resolve_config_path CONFIGS = resolve_config_path( - "extensions/embodichain_tasks/configs", base_dir=Path(__file__).parent + "embodichain/extensions/tasks/configs", base_dir=Path(__file__).parent ) TASK = Path(__file__).resolve().parent / "configs/pour_water" diff --git a/examples/expansion/demo_skill/__main__.py b/examples/expansion/demo_skill/__main__.py index 639623d197..bf3134627e 100644 --- a/examples/expansion/demo_skill/__main__.py +++ b/examples/expansion/demo_skill/__main__.py @@ -52,7 +52,7 @@ ) ROOT = Path(__file__).resolve().parents[3] -TASK = ROOT / "extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking" +TASK = ROOT / "embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking" DT = 1 / 30 diff --git a/examples/expansion/demo_skill/present.py b/examples/expansion/demo_skill/present.py index a69f1d6128..a0ca313e38 100644 --- a/examples/expansion/demo_skill/present.py +++ b/examples/expansion/demo_skill/present.py @@ -36,7 +36,7 @@ def prepare(output: Path, *, duration_s: float = 2.0) -> Path: ) source = resolve_config_path( - "embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml" + "embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml" ).resolve() base = source.parent task = yaml.safe_load(source.read_text()) diff --git a/examples/expansion/engine/motion.yaml b/examples/expansion/engine/motion.yaml index 18e4a783b6..60c7245767 100644 --- a/examples/expansion/engine/motion.yaml +++ b/examples/expansion/engine/motion.yaml @@ -34,7 +34,7 @@ trajectory: enabled: false visual: enabled: false - profile_file: extensions/embodichain_tasks/configs/components/randomization_profiles/rgb_visual.yaml + profile_file: embodichain/extensions/tasks/configs/components/randomization_profiles/rgb_visual.yaml profiles: [] apply_per_rollout: true balance: round_robin diff --git a/examples/expansion/engine/showcase/_cases.py b/examples/expansion/engine/showcase/_cases.py index eb5f781330..6fe44ef64b 100644 --- a/examples/expansion/engine/showcase/_cases.py +++ b/examples/expansion/engine/showcase/_cases.py @@ -46,7 +46,7 @@ def absolute_deployment(path: Path) -> dict: def resolve(reference): candidate = (path.parent / reference).resolve() if not candidate.exists(): - marker = "extensions/embodichain_tasks/configs/" + marker = "embodichain/extensions/tasks/configs/" if marker not in reference: raise FileNotFoundError(candidate) candidate = resolve_config_path(marker + reference.split(marker, 1)[1]) @@ -86,7 +86,7 @@ def write(path, value): task = absolute_deployment(prepared / "task.measured.yaml") task["embodiment"]["component"] = str( resolve_config_path( - "extensions/embodichain_tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml" + "embodichain/extensions/tasks/configs/components/embodiments/franka_panda_robotiq85_rgbd.yaml" ) ) task["renderer"] = "hybrid" diff --git a/examples/expansion/engine/showcase/expand_ranges.py b/examples/expansion/engine/showcase/expand_ranges.py index ccd775feaa..d06f506b3a 100644 --- a/examples/expansion/engine/showcase/expand_ranges.py +++ b/examples/expansion/engine/showcase/expand_ranges.py @@ -60,13 +60,13 @@ def freeze(path, value): resolved = (source.parent / reference).resolve() if ( not resolved.exists() - and "extensions/embodichain_tasks/configs/" in reference + and "embodichain/extensions/tasks/configs/" in reference ): from embodichain.utils.config_paths import resolve_config_path resolved = resolve_config_path( - "extensions/embodichain_tasks/configs/" - + reference.split("extensions/embodichain_tasks/configs/", 1)[1] + "embodichain/extensions/tasks/configs/" + + reference.split("embodichain/extensions/tasks/configs/", 1)[1] ) cfg["task_program"][k] = str(resolved) search = R / "configs/search.wide.yaml" diff --git a/examples/expansion/engine/task.default.yaml b/examples/expansion/engine/task.default.yaml index 511f32c3bb..21a38ce01c 100644 --- a/examples/expansion/engine/task.default.yaml +++ b/examples/expansion/engine/task.default.yaml @@ -1,8 +1,8 @@ id: TaskProgramRepeatedPickPlace-v1 environment: - component: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml + component: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/default.yaml embodiment: - component: ../../../extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml + component: ../../../embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml overrides: init_qpos: - 0.0 @@ -15,5 +15,5 @@ embodiment: - 0.0 task_program: program: ../scene_robot_feasibility/program.yaml - integration: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml - execution_policy: ../../../extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml + integration: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml + execution_policy: ../../../embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml diff --git a/examples/expansion/engine/task.newton.yaml b/examples/expansion/engine/task.newton.yaml index 577dac6443..032b8ad113 100644 --- a/examples/expansion/engine/task.newton.yaml +++ b/examples/expansion/engine/task.newton.yaml @@ -1,8 +1,8 @@ id: TaskProgramRepeatedPickPlace-v1 environment: - component: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml + component: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/envs/newton.yaml embodiment: - component: ../../../extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml + component: ../../../embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80_rgbd.yaml overrides: init_qpos: - 0.0 @@ -15,5 +15,5 @@ embodiment: - 0.0 task_program: program: ../scene_robot_feasibility/program.yaml - integration: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml - execution_policy: ../../../extensions/embodichain_tasks/configs/components/execution_policies/trajectory_open_loop.yaml + integration: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task_program/integration.yaml + execution_policy: ../../../embodichain/extensions/tasks/configs/components/execution_policies/trajectory_open_loop.yaml diff --git a/examples/expansion/scene_robot_feasibility/README.md b/examples/expansion/scene_robot_feasibility/README.md index 1fd415203c..e5926e1513 100644 --- a/examples/expansion/scene_robot_feasibility/README.md +++ b/examples/expansion/scene_robot_feasibility/README.md @@ -93,7 +93,7 @@ uniform exploration, and every proposed layout still runs fresh IK/path/physical checks. The report records prior identity and guided/fallback counts. `search.dual_ur5.yaml` reuses the existing -[`hand_over` task](../../../extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/README.md) +[`hand_over` task](../../../embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/README.md) for rigid-bar grasp, handover and placement. The example-local `hand_over/` directory contains an inline physical deployment, scene binding and a specialization of `hand_over/task_program/program.bar.yaml` for this table's target poses and diff --git a/examples/expansion/scene_robot_feasibility/hand_over/task.dual_ur5.yaml b/examples/expansion/scene_robot_feasibility/hand_over/task.dual_ur5.yaml index da4bfe5792..0dd5a9f4c1 100644 --- a/examples/expansion/scene_robot_feasibility/hand_over/task.dual_ur5.yaml +++ b/examples/expansion/scene_robot_feasibility/hand_over/task.dual_ur5.yaml @@ -66,12 +66,12 @@ task_program: program: task_program/program.yaml integration: task_program/integration.yaml execution_policy: - component: extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml + component: embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml overrides: motion: velocity_limit: 0.2 embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml overrides: init_pos: [1.45, 0.0, 0.25] init_rot: [0.0, 0.0, -90.0] diff --git a/examples/expansion/scene_robot_feasibility/preview.py b/examples/expansion/scene_robot_feasibility/preview.py index 7bc5e0ccdd..0fb47e1232 100644 --- a/examples/expansion/scene_robot_feasibility/preview.py +++ b/examples/expansion/scene_robot_feasibility/preview.py @@ -82,7 +82,7 @@ def _workflow(output: Path, source: Path, demonstration: bool) -> Path: # in the bundled extension package, rather than extensions/. from importlib.resources import files - resource = Path(str(files("embodichain_tasks.configs"))) / ( + resource = Path(str(files("embodichain.extensions.tasks.configs"))) / ( "tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) if not resource.is_file(): diff --git a/examples/expansion/scene_robot_feasibility/search.ur5.yaml b/examples/expansion/scene_robot_feasibility/search.ur5.yaml index 230334f05d..13dd409a69 100644 --- a/examples/expansion/scene_robot_feasibility/search.ur5.yaml +++ b/examples/expansion/scene_robot_feasibility/search.ur5.yaml @@ -116,7 +116,7 @@ search: beam_width: 4 max_rrt_nodes: 128 task_program: - deployment: ../../../extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml + deployment: ../../../embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml program: program.yaml simulation_device: cpu enable_sensor: false diff --git a/examples/expansion/trajectory/real2sim_carton/README.md b/examples/expansion/trajectory/real2sim_carton/README.md index 5677a73b92..5c217fe7bb 100644 --- a/examples/expansion/trajectory/real2sim_carton/README.md +++ b/examples/expansion/trajectory/real2sim_carton/README.md @@ -4,7 +4,7 @@ 完成 affordance 修正、空间重定向、轨迹与时间扩增,再执行仿真并记录 LeRobot 数据。 所有正式候选均来自真实示范。 -官方任务定义位于 `embodichain_tasks/configs/tasks/manipulation/carton_stocking/`。 +官方任务定义位于 `embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/`。 场景、Task Program、来源绑定、执行策略和扩增配方均由官方任务维护;本目录提供来源 重建、复现实验和展示入口。正式任务执行不依赖 example Python 模块。 @@ -12,7 +12,7 @@ ```bash embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml \ --dataset-dir /tmp/carton-dataset ``` diff --git a/examples/expansion/trajectory/real2sim_carton/matrix.py b/examples/expansion/trajectory/real2sim_carton/matrix.py index d6d6280fc6..56ac05a25e 100644 --- a/examples/expansion/trajectory/real2sim_carton/matrix.py +++ b/examples/expansion/trajectory/real2sim_carton/matrix.py @@ -80,17 +80,12 @@ def run( # installation. Each process owns its simulator, recorder and one attempt. repository = Path(__file__).resolve().parents[4] environment = os.environ.copy() - paths = [ - repository, - repository / "extensions", - repository / "extensions/embodichain_tasks", - ] environment.update( EMBODICHAIN_SIM_EXIT_PROCESS="0", OMP_NUM_THREADS="1", OPENBLAS_NUM_THREADS="1", PYTHONPATH=os.pathsep.join( - [*(str(path) for path in paths), environment.get("PYTHONPATH", "")] + [str(repository), environment.get("PYTHONPATH", "")] ), ) diff --git a/examples/expansion/trajectory/real2sim_carton/prepare.py b/examples/expansion/trajectory/real2sim_carton/prepare.py index 16bd21e7db..9178c6e4ae 100644 --- a/examples/expansion/trajectory/real2sim_carton/prepare.py +++ b/examples/expansion/trajectory/real2sim_carton/prepare.py @@ -68,7 +68,7 @@ from embodichain.lab.task_program.integrations.nominal import ( BoundTaskProgramNominalSources, ) -from embodichain_robots.robotiq.two_finger import robotiq85_joint_positions +from embodichain.extensions.robots.robotiq.two_finger import robotiq85_joint_positions from embodichain.utils.config_paths import resolve_config_path from embodichain.toolkits.graspkit.box_region import ( BoxSideGraspRegionCfg, @@ -77,7 +77,7 @@ __all__: list[str] = [] -_TASK_CONFIG = "extensions/embodichain_tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml" +_TASK_CONFIG = "embodichain/extensions/tasks/configs/tasks/manipulation/carton_stocking/task.panda.yaml" def task_config() -> Path: diff --git a/examples/expansion/trajectory/real2sim_carton/run.py b/examples/expansion/trajectory/real2sim_carton/run.py index 935ec45418..c35525cb38 100644 --- a/examples/expansion/trajectory/real2sim_carton/run.py +++ b/examples/expansion/trajectory/real2sim_carton/run.py @@ -162,17 +162,12 @@ def main() -> None: source = (args.source_dir or output / "source").resolve() environment = os.environ.copy() repository = Path(__file__).resolve().parents[4] - paths = [ - repository, - repository / "extensions", - repository / "extensions/embodichain_tasks", - ] environment.update( EMBODICHAIN_SIM_EXIT_PROCESS="0", OMP_NUM_THREADS="1", OPENBLAS_NUM_THREADS="1", PYTHONPATH=os.pathsep.join( - [*(str(p) for p in paths), environment.get("PYTHONPATH", "")] + [str(repository), environment.get("PYTHONPATH", "")] ), ) stages = [] diff --git a/examples/expansion/trajectory/repeated_pick_place_expansion_combined.py b/examples/expansion/trajectory/repeated_pick_place_expansion_combined.py index d4388583b1..f36524515c 100644 --- a/examples/expansion/trajectory/repeated_pick_place_expansion_combined.py +++ b/examples/expansion/trajectory/repeated_pick_place_expansion_combined.py @@ -48,7 +48,7 @@ from embodichain.utils.utility import load_config _DEFAULT_TASK_CONFIG = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml", + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml", base_dir=Path(__file__).parent, ) _DEFAULT_OUTPUT_DIR = Path("output/repeated_pick_place_expansion_combined") diff --git a/examples/expansion/trajectory/repeated_pick_place_expansion_showcase.py b/examples/expansion/trajectory/repeated_pick_place_expansion_showcase.py index 653068d2ea..a9f2c92acb 100644 --- a/examples/expansion/trajectory/repeated_pick_place_expansion_showcase.py +++ b/examples/expansion/trajectory/repeated_pick_place_expansion_showcase.py @@ -55,7 +55,7 @@ from embodichain.utils.config_paths import resolve_config_path _TASK_ROOT = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place", + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place", base_dir=Path(__file__).parent, ) _DEFAULT_TASK_CONFIG = _TASK_ROOT / "task.ur5.yaml" diff --git a/examples/gensim/goal_authoring/README.md b/examples/gensim/goal_authoring/README.md index bc9218e1f7..f0627a4a6a 100644 --- a/examples/gensim/goal_authoring/README.md +++ b/examples/gensim/goal_authoring/README.md @@ -66,7 +66,7 @@ image-to-execution success. ## Unsupported hinge closing ```bash -embodichain gensim task plan --route goal --task-id door --instruction 关上铰链门 --proposal examples/gensim/goal_authoring/close_hinge.json --deployment extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml --output outputs/door-preflight +embodichain gensim task plan --route goal --task-id door --instruction 关上铰链门 --proposal examples/gensim/goal_authoring/close_hinge.json --deployment embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml --output outputs/door-preflight ``` For this Pick/Place installation, the declared hinge-closing operation must diff --git a/examples/gensim/goal_authoring/fruit_pilot.py b/examples/gensim/goal_authoring/fruit_pilot.py index 07a8745b04..3435f46371 100644 --- a/examples/gensim/goal_authoring/fruit_pilot.py +++ b/examples/gensim/goal_authoring/fruit_pilot.py @@ -195,7 +195,7 @@ def complete(self, request): ) components = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/components" + / "embodichain/extensions/tasks/configs/components" ) runtime = root / "runtime.yaml" runtime.write_text( diff --git a/examples/gensim/goal_authoring/stack_pilot.py b/examples/gensim/goal_authoring/stack_pilot.py index 9c41cf36f2..26a80a48c4 100644 --- a/examples/gensim/goal_authoring/stack_pilot.py +++ b/examples/gensim/goal_authoring/stack_pilot.py @@ -195,7 +195,7 @@ def complete(self, request): ) configs = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/components" + / "embodichain/extensions/tasks/configs/components" ) embodiment = yaml.safe_load( (configs / "embodiments/ur5_dh_pgi_140_80.yaml").read_text() diff --git a/examples/gensim/run.yaml b/examples/gensim/run.yaml index 58aa8c87a2..786b28ea76 100644 --- a/examples/gensim/run.yaml +++ b/examples/gensim/run.yaml @@ -6,6 +6,6 @@ instruction: Put the cup on the tray. output: ../../outputs/gensim-run-001 runtime: runtime.dual_ur5.yaml -execution_policy: extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml +execution_policy: embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml task_id: generated_tabletop_task headless: true diff --git a/examples/gensim/runtime.dual_ur5.yaml b/examples/gensim/runtime.dual_ur5.yaml index a82c1f81ef..8941202037 100644 --- a/examples/gensim/runtime.dual_ur5.yaml +++ b/examples/gensim/runtime.dual_ur5.yaml @@ -12,7 +12,7 @@ env: sim_steps_per_control: 4 embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml # Example installation: calibrate this pose against your scene coordinates. overrides: init_pos: [0.15, 0.85, 0.0] diff --git a/examples/gensim/scripted_pick_place/__main__.py b/examples/gensim/scripted_pick_place/__main__.py index b5b6109014..231d0a7d2e 100644 --- a/examples/gensim/scripted_pick_place/__main__.py +++ b/examples/gensim/scripted_pick_place/__main__.py @@ -115,7 +115,7 @@ def complete(self, request: Any) -> ChatResponse: "instruction": "Put the cube on the table", "output": "run", "runtime": "runtime.yaml", - "execution_policy": "extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml", + "execution_policy": "embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml", "scene": "scene", "task_id": "gensim_task", "headless": True, diff --git a/examples/gensim/scripted_pick_place/runtime.yaml b/examples/gensim/scripted_pick_place/runtime.yaml index ad805cecc2..a9817c6f82 100644 --- a/examples/gensim/scripted_pick_place/runtime.yaml +++ b/examples/gensim/scripted_pick_place/runtime.yaml @@ -8,7 +8,7 @@ render_cfg: env: sim_steps_per_control: 4 embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml overrides: init_pos: [1.45, 0.0, 0.25] init_rot: [0.0, 0.0, -90.0] diff --git a/examples/gym/gaussian_pick_place/QUALIFICATION.md b/examples/gym/gaussian_pick_place/QUALIFICATION.md index e18b3d7355..b2af0c02cb 100644 --- a/examples/gym/gaussian_pick_place/QUALIFICATION.md +++ b/examples/gym/gaussian_pick_place/QUALIFICATION.md @@ -175,7 +175,7 @@ scene at one seed, not a multi-seed stability qualification. ## Task-extension migration qualification — 2026-11-16 The three deployments now belong to the official `gaussian_pick_place` task -under `embodichain_tasks`; embodiment and execution-policy components belong to +under `embodichain.extensions.tasks`; embodiment and execution-policy components belong to the shared component directories. No task Python subclass was introduced. Examples retain capture, portable snapshot preparation, video export and offline/negative acceptance. All 14 pre-migration resolved YAML declarations diff --git a/examples/gym/gaussian_pick_place/README.md b/examples/gym/gaussian_pick_place/README.md index c40879c283..eb3bbef900 100644 --- a/examples/gym/gaussian_pick_place/README.md +++ b/examples/gym/gaussian_pick_place/README.md @@ -1,6 +1,6 @@ # Pick/Place in three 3DGS scenes with Franka and two cameras -Record the official Task Program deployments from `embodichain_tasks` against +Record the official Task Program deployments from `embodichain.extensions.tasks` against the registered, standardized Gaussian scene packages. The example retains the FR3/parallel-hand model and initial pose, executes physical Pick/Place, and records a fixed third-person camera plus a @@ -26,16 +26,16 @@ through `embodichain data download --name `. | Scene | Runnable config | Registered background | | --- | --- | --- | -| RoboSplatter office | [task.office.yaml](../../../extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml) | `RoboSplatterOfficeGS/asset.usda` | -| DISCOVERSE lab3 | [task.discoverse.yaml](../../../extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml) | `DiscoverseLab3GS/asset.usda` | -| RoboSimGS tabletop | [task.robosimgs.yaml](../../../extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml) | `RoboSimGSTabletopGS/asset.usda` | +| RoboSplatter office | [task.office.yaml](../../../embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml) | `RoboSplatterOfficeGS/asset.usda` | +| DISCOVERSE lab3 | [task.discoverse.yaml](../../../embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.discoverse.yaml) | `DiscoverseLab3GS/asset.usda` | +| RoboSimGS tabletop | [task.robosimgs.yaml](../../../embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.robosimgs.yaml) | `RoboSimGSTabletopGS/asset.usda` | Task discovery and ordinary trajectory collection work without this recorder: ```bash embodichain show-task gaussian_pick_place embodichain run-task \ - --gym-config extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml \ + --gym-config embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/task.office.yaml \ --headless --seed 42 --max_episodes 2 --record_trajectory \ --trajectory_save_dir outputs/gaussian_pick_place/office ``` diff --git a/examples/gym/gaussian_pick_place/_prepare.py b/examples/gym/gaussian_pick_place/_prepare.py index 7d58208387..6e61bf22ab 100644 --- a/examples/gym/gaussian_pick_place/_prepare.py +++ b/examples/gym/gaussian_pick_place/_prepare.py @@ -31,7 +31,7 @@ HERE = Path(__file__).resolve().parent TASK_CONFIG_ROOT = ( - "extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place" + "embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place" ) SCENES = { "discoverse": {"title": "DISCOVERSE lab3"}, diff --git a/examples/gym/library_pick_place/run.py b/examples/gym/library_pick_place/run.py index e68490b35f..a2ce690c92 100644 --- a/examples/gym/library_pick_place/run.py +++ b/examples/gym/library_pick_place/run.py @@ -96,7 +96,7 @@ def _prepare(args: argparse.Namespace, directory: Path) -> tuple[object, dict]: ) _write_yaml(resolved / "env.yaml", environment) - sdk = "extensions/embodichain_tasks/configs/components/" + sdk = "embodichain/extensions/tasks/configs/components/" embodiment_path = resolve_config_path( sdk + "embodiments/dual_ur5_dh_pgi_140_80.yaml" ) diff --git a/examples/gym/usd_scene_pick_place/task.dual_ur5.yaml b/examples/gym/usd_scene_pick_place/task.dual_ur5.yaml index 1965bf91c1..4d918b5559 100644 --- a/examples/gym/usd_scene_pick_place/task.dual_ur5.yaml +++ b/examples/gym/usd_scene_pick_place/task.dual_ur5.yaml @@ -3,7 +3,7 @@ enable_sensor: false environment: component: env.yaml embodiment: - component: extensions/embodichain_tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml + component: embodichain/extensions/tasks/configs/components/embodiments/dual_ur5_dh_pgi_140_80.yaml overrides: init_pos: [1.683, 0.0, 0.4525] init_rot: [0.0, 0.0, -90.0] @@ -11,7 +11,7 @@ task_program: program: task_program/program.yaml integration: task_program/integration.yaml execution_policy: - component: extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml + component: embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml overrides: motion: velocity_limit: 0.5 diff --git a/examples/learning/act/_environment.py b/examples/learning/act/_environment.py index 7726c9d115..983687e548 100644 --- a/examples/learning/act/_environment.py +++ b/examples/learning/act/_environment.py @@ -25,20 +25,18 @@ from embodichain.utils.config_paths import resolve_config_path TASK = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml", + "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml", base_dir=Path(__file__).parent, ).resolve() CONFIG_ROOT = TASK.parents[3] -TASK_PACKAGE = CONFIG_ROOT.parent / "embodichain_tasks" -if not TASK_PACKAGE.is_dir(): - TASK_PACKAGE = CONFIG_ROOT.parent +TASK_PACKAGE = CONFIG_ROOT.parent IDENTITY_FILES = { - "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml": TASK, - "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.visual.yaml": TASK.parent + "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml": TASK, + "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.visual.yaml": TASK.parent / "env.visual.yaml", - "extensions/embodichain_tasks/configs/components/embodiments/franka_panda_rgb_224.yaml": CONFIG_ROOT + "embodichain/extensions/tasks/configs/components/embodiments/franka_panda_rgb_224.yaml": CONFIG_ROOT / "components/embodiments/franka_panda_rgb_224.yaml", - "extensions/embodichain_tasks/embodichain_tasks/manipulation/push_cube.py": TASK_PACKAGE + "embodichain/extensions/tasks/manipulation/push_cube.py": TASK_PACKAGE / "manipulation/push_cube.py", } diff --git a/examples/learning/act/evaluate.py b/examples/learning/act/evaluate.py index 337e6652e1..641edfef8e 100644 --- a/examples/learning/act/evaluate.py +++ b/examples/learning/act/evaluate.py @@ -34,7 +34,7 @@ def _load_policy( path: Path, device: str, *, panel: str, seeds: list[int] ) -> tuple[Any, int]: - from embodichain_models.policy.act import load_act_policy + from embodichain.extensions.models.policy.act import load_act_policy model = load_act_policy(path, device) _validate_policy_identity(model.metadata, path, panel=panel, seeds=seeds) @@ -291,7 +291,7 @@ def main() -> None: ) mode = "policy" elif args.baseline == "untrained": - from embodichain_models.policy.act import load_act_policy + from embodichain.extensions.models.policy.act import load_act_policy if args.reference_checkpoint is None: parser.error( diff --git a/examples/learning/act/train.py b/examples/learning/act/train.py index 49d1685276..8ead972b3e 100644 --- a/examples/learning/act/train.py +++ b/examples/learning/act/train.py @@ -88,7 +88,7 @@ def main() -> None: raise ValueError("Training and validation scene seeds overlap") if not args.smoke and validation.get("smoke", False): raise ValueError("Full training requires a qualified validation corpus") - from embodichain_models.policy.act import ( + from embodichain.extensions.models.policy.act import ( build_act_train_config, dataset_fingerprint, load_act_policy, diff --git a/examples/learning/motion_tracking/README.md b/examples/learning/motion_tracking/README.md index 5b932c8fe4..185f07d137 100644 --- a/examples/learning/motion_tracking/README.md +++ b/examples/learning/motion_tracking/README.md @@ -272,7 +272,7 @@ callbacks own optimizer steps and complete backward passes before returning. Configuration paths below resolve through the installed task package: ```bash -CONFIGS=extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/agents +CONFIGS=embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/agents CUDA_VISIBLE_DEVICES=0 embodichain run-example learning/motion_tracking/train.py \ --config "$CONFIGS/model_based.yaml" --output outputs/functional ``` diff --git a/examples/learning/motion_tracking/evaluate_online.py b/examples/learning/motion_tracking/evaluate_online.py index 41cb59d48e..fa709a04e3 100644 --- a/examples/learning/motion_tracking/evaluate_online.py +++ b/examples/learning/motion_tracking/evaluate_online.py @@ -28,13 +28,15 @@ import warp as wp from datetime import datetime, timezone from embodichain.lab.gym.utils.gym_utils import config_to_cfg -from embodichain_models.policies.motion_tracking import ( +from embodichain.extensions.models.policies.motion_tracking import ( MotionTrackingPolicy, MotionTrackingPolicyCfg, ) -from embodichain_models.dynamics.rwm.robot_state import pack_robot_state +from embodichain.extensions.models.dynamics.rwm.robot_state import pack_robot_state from embodichain.lab.gym.utils.registration import build_env -from embodichain_tasks.locomotion.tracking import g1_motion # Register physical task. +from embodichain.extensions.tasks.locomotion.tracking import ( + g1_motion, +) # Register physical task. from run_metadata import write_run_metadata from _configuration import normalize_recipe diff --git a/examples/learning/motion_tracking/evaluate_world_model.py b/examples/learning/motion_tracking/evaluate_world_model.py index b1c4bb1a81..24c26adc02 100644 --- a/examples/learning/motion_tracking/evaluate_world_model.py +++ b/examples/learning/motion_tracking/evaluate_world_model.py @@ -28,7 +28,7 @@ import torch from embodichain.data import get_data_path -from embodichain_models.dynamics.rwm.robot_state import unpack_robot_state +from embodichain.extensions.models.dynamics.rwm.robot_state import unpack_robot_state from run_metadata import write_run_metadata from train import MotionTraining from _configuration import normalize_recipe diff --git a/examples/learning/motion_tracking/fit_world_model.py b/examples/learning/motion_tracking/fit_world_model.py index 3294263e1f..1ffaa7bbb2 100644 --- a/examples/learning/motion_tracking/fit_world_model.py +++ b/examples/learning/motion_tracking/fit_world_model.py @@ -28,15 +28,17 @@ from embodichain.lab.gym.utils.gym_utils import config_to_cfg from embodichain.learning.sl import SupervisedBatch, SupervisedLearner -from embodichain_models.dynamics.rwm import ( +from embodichain.extensions.models.dynamics.rwm import ( KinematicWorldModel, KinematicWorldModelCfg, TransitionReplay, RobotWorldModelObjective, replay_supervised_batch, ) -from embodichain_models.dynamics.rwm.robot_state import pack_robot_state -from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv +from embodichain.extensions.models.dynamics.rwm.robot_state import pack_robot_state +from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, +) def sample_batch( diff --git a/examples/learning/motion_tracking/prepare_lafan1.py b/examples/learning/motion_tracking/prepare_lafan1.py index c668b1cf27..98d211fe2f 100644 --- a/examples/learning/motion_tracking/prepare_lafan1.py +++ b/examples/learning/motion_tracking/prepare_lafan1.py @@ -25,7 +25,9 @@ from embodichain.data_pipeline.datasets import MotionLibrary from embodichain.data.constants import EMBODICHAIN_DEFAULT_DATA_ROOT -from embodichain_robots.locomotion_profiles import load_locomotion_robot_profile +from embodichain.extensions.robots.locomotion_profiles import ( + load_locomotion_robot_profile, +) _REPOSITORY = "lvhaidong/LAFAN1_Retargeting_Dataset" _REVISION = "ce1572906efe6157840e8474d5a0d7aa87481e74" diff --git a/examples/learning/motion_tracking/train.py b/examples/learning/motion_tracking/train.py index 80655eefc3..ae61736e2e 100644 --- a/examples/learning/motion_tracking/train.py +++ b/examples/learning/motion_tracking/train.py @@ -50,19 +50,25 @@ from embodichain.learning.sl import SupervisedLearner from embodichain.utils.config_paths import resolve_config_path from embodichain.utils.utility import load_config -from embodichain_models.dynamics.rwm import ( +from embodichain.extensions.models.dynamics.rwm import ( KinematicWorldModel, KinematicWorldModelCfg, TransitionReplay, RobotWorldModelObjective, replay_supervised_batch, ) -from embodichain_models.dynamics.rwm.model import frozen_world_model -from embodichain_models.dynamics.rwm.robot_state import pack_robot_state -from embodichain_models.policies import motion_tracking # Register tracking policy. +from embodichain.extensions.models.dynamics.rwm.model import frozen_world_model +from embodichain.extensions.models.dynamics.rwm.robot_state import pack_robot_state +from embodichain.extensions.models.policies import ( + motion_tracking, +) # Register tracking policy. from embodichain.lab.gym.utils.registration import build_env -from embodichain_tasks.locomotion.tracking import g1_motion # Register physical task. -from embodichain_tasks.locomotion.tracking.motion_model import replay_motion_starts +from embodichain.extensions.tasks.locomotion.tracking import ( + g1_motion, +) # Register physical task. +from embodichain.extensions.tasks.locomotion.tracking.motion_model import ( + replay_motion_starts, +) from run_metadata import write_run_metadata from _configuration import normalize_recipe, recipe_identity, validate_recipe diff --git a/examples/learning/nerd/DEPLOYMENT.md b/examples/learning/nerd/DEPLOYMENT.md index 4fae065d0d..5245a682c8 100644 --- a/examples/learning/nerd/DEPLOYMENT.md +++ b/examples/learning/nerd/DEPLOYMENT.md @@ -125,7 +125,7 @@ from dexsim.engine.newton_physics import ( ProviderNewtonSolverCfg, RegisteredNewtonSolverCfg, ) from embodichain.lab.sim.cfg import NewtonPhysicsCfg -from embodichain_solvers.physics.nerd.provider import NeRDProvider +from embodichain.extensions.solvers.physics.nerd.provider import NeRDProvider options = {"checkpoint": "outputs/nerd-native/models/cartpole"} direct = ProviderNewtonSolverCfg(provider_factory=NeRDProvider, options=options) diff --git a/examples/learning/nerd/README.md b/examples/learning/nerd/README.md index 1aeaa0bbe9..32e8d73c9c 100644 --- a/examples/learning/nerd/README.md +++ b/examples/learning/nerd/README.md @@ -6,7 +6,7 @@ Cartpole and Ant are the supported reference systems. Teacher collection and historical trainer comparisons remain private support workflows. Reusable networks, physical codecs, committed trajectory readers and the NeRD -SL recipe live in `embodichain_models.dynamics.nerd`, bundled in the main wheel. +SL recipe live in `embodichain.extensions.models.dynamics.nerd`, bundled in the main wheel. Core `embodichain.learning.sl` owns the optimizer and training lifecycle; shared MLPs remain in `embodichain.learning.models`. The runtime model package does not import this example or simulation. @@ -54,7 +54,7 @@ embodichain train-sl --config /path/to/recipe.yaml ``` The factory is the installable -`embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer`; it does +`embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`; it does not require example bootstrap. Paths in a common SL recipe resolve from the working directory. `--resource-root` replaces paths only for the showcase's implicit default presets, not an explicitly supplied configuration. @@ -107,7 +107,7 @@ The task returns pre-reset terminal rewards and a full graph-connected uses `detach_state()` as the explicit TBPTT boundary. Existing RWM and Warp kinematic environments retain their own execution contracts. -Optional native deployment lives in `embodichain_solvers.physics.nerd` and uses +Optional native deployment lives in `embodichain.extensions.solvers.physics.nerd` and uses the existing `nerd` solver entry point or a direct SDK Provider configuration. Its native and functional adapters call the same transition. SDK Scene owns native scheduling/publication; no NeRD functional forwarding is added to diff --git a/examples/learning/nerd/__main__.py b/examples/learning/nerd/__main__.py index d13119c0f8..92b8a3e285 100644 --- a/examples/learning/nerd/__main__.py +++ b/examples/learning/nerd/__main__.py @@ -224,7 +224,9 @@ def main(argv: Sequence[str] | None = None) -> None: raise ValueError( "Conversion manifest requires codec mapping and dt" ) - from embodichain_models.dynamics.nerd import convert_legacy_checkpoint + from embodichain.extensions.models.dynamics.nerd import ( + convert_legacy_checkpoint, + ) convert_legacy_checkpoint( checkpoint, output, manifest, trust_pickle=args.trust_pickle diff --git a/examples/learning/nerd/_support/_acceptance.py b/examples/learning/nerd/_support/_acceptance.py index db2cae354c..e90ae36f19 100644 --- a/examples/learning/nerd/_support/_acceptance.py +++ b/examples/learning/nerd/_support/_acceptance.py @@ -56,14 +56,11 @@ def _sha(path: Path) -> str: def _source_modules(source: Path) -> dict[str, str]: """Select only the requested checkout's original or extension module layout.""" - if ( - source - / "extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py" - ).is_file(): + if (source / "embodichain/extensions/models/dynamics/nerd/model.py").is_file(): return { - "codec": "embodichain_models.dynamics.nerd.codec", - "data": "embodichain_models.dynamics.nerd.data", - "model": "embodichain_models.dynamics.nerd", + "codec": "embodichain.extensions.models.dynamics.nerd.codec", + "data": "embodichain.extensions.models.dynamics.nerd.data", + "model": "embodichain.extensions.models.dynamics.nerd", "trainer": "examples.learning.nerd._support._trainer", "qualification": "examples.learning.nerd._support._qualification", } @@ -79,8 +76,11 @@ def _source_modules(source: Path) -> dict[str, str]: def _source_paths(source: Path) -> list[str]: """Keep each independent worker's imports bound to its requested source.""" paths = [str(source)] - if _source_modules(source)["model"] == "embodichain_models.dynamics.nerd": - paths.insert(0, str(source / "extensions/embodichain_models")) + if ( + _source_modules(source)["model"] + == "embodichain.extensions.models.dynamics.nerd" + ): + paths.insert(0, str(source / "embodichain/extensions/models")) return paths @@ -88,11 +88,14 @@ def _source_identity(source: Path) -> dict[str, Any]: def git(*args: str) -> bytes: return subprocess.check_output(["git", "-C", str(source), *args]) - if _source_modules(source)["model"] == "embodichain_models.dynamics.nerd": + if ( + _source_modules(source)["model"] + == "embodichain.extensions.models.dynamics.nerd" + ): modules = ( "examples/learning/nerd/_support/_trainer.py", *( - "extensions/embodichain_models/embodichain_models/dynamics/nerd/" + name + "embodichain/extensions/models/dynamics/nerd/" + name for name in ( "model.py", "checkpoint.py", diff --git a/examples/learning/nerd/_support/_benchmark_dynamics_input.py b/examples/learning/nerd/_support/_benchmark_dynamics_input.py index 3bfc12c962..9b9b65b2d6 100644 --- a/examples/learning/nerd/_support/_benchmark_dynamics_input.py +++ b/examples/learning/nerd/_support/_benchmark_dynamics_input.py @@ -70,7 +70,7 @@ def create_stress_dataset( ) -> Path: """Repeat one real trajectory into independent shards for bounded-I/O stress.""" import h5py - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.data import ( load_manifest, DynamicsShardWriter, dataset_fingerprint, @@ -124,8 +124,8 @@ def benchmark_inputs( import numpy as np import torch from torch.utils.data import default_collate - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset from examples.learning.nerd._support._trainer import encode_batch if ( diff --git a/examples/learning/nerd/_support/_benchmark_dynamics_training.py b/examples/learning/nerd/_support/_benchmark_dynamics_training.py index 197ac5dd82..adee6e088c 100644 --- a/examples/learning/nerd/_support/_benchmark_dynamics_training.py +++ b/examples/learning/nerd/_support/_benchmark_dynamics_training.py @@ -57,7 +57,7 @@ def benchmark_training( import torch from examples.learning.nerd._support._reference import reference_identity from examples.learning.nerd._support._trainer import normalized_mse - from embodichain_models.dynamics.nerd import NeRDModel, NeRDModelCfg + from embodichain.extensions.models.dynamics.nerd import NeRDModel, NeRDModelCfg identity = reference_identity(source) if device.startswith("cuda") and not torch.cuda.is_available(): diff --git a/examples/learning/nerd/_support/_compare_official_model.py b/examples/learning/nerd/_support/_compare_official_model.py index e8af2aa9c1..2789b8c313 100644 --- a/examples/learning/nerd/_support/_compare_official_model.py +++ b/examples/learning/nerd/_support/_compare_official_model.py @@ -52,8 +52,8 @@ def main() -> None: import numpy as np import torch import warp as wp - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd import load_model + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd import load_model from examples.learning.nerd._support._reference import ( reference_identity, import_legacy_datasets, @@ -63,7 +63,7 @@ def main() -> None: _cpu_stream_compatibility, ) from examples.learning.nerd._support._trainer import encode_batch - from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset + from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset source = reference_identity(args.source) if ( diff --git a/examples/learning/nerd/_support/_comparison.py b/examples/learning/nerd/_support/_comparison.py index dfafe1a70e..47beacfeeb 100644 --- a/examples/learning/nerd/_support/_comparison.py +++ b/examples/learning/nerd/_support/_comparison.py @@ -55,9 +55,13 @@ def prepare_comparison(config: dict[str, Any]) -> Path: """ import numpy as np import torch - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset - from embodichain_models.dynamics.nerd import NeRDModel, NeRDModelCfg, export_model + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset + from embodichain.extensions.models.dynamics.nerd import ( + NeRDModel, + NeRDModelCfg, + export_model, + ) from ._trainer import ( DynamicsTrainCfg, compute_statistics, @@ -306,7 +310,7 @@ def run_candidate( ) -> dict[str, Any]: """Execute the migrated trainer on the same frozen run specification.""" import torch - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.data import ( load_manifest, dataset_fingerprint, ) @@ -442,7 +446,7 @@ def run_comparison( source_root = Path(__file__).resolve().parents[4] if (source_root / "pyproject.toml").is_file(): pythonpaths.extend( - (str(source_root / "extensions/embodichain_models"), str(source_root)) + (str(source_root / "embodichain/extensions/models"), str(source_root)) ) if environment.get("PYTHONPATH"): pythonpaths.append(environment["PYTHONPATH"]) diff --git a/examples/learning/nerd/_support/_generation.py b/examples/learning/nerd/_support/_generation.py index d9d8b6c74c..18600c0ad0 100644 --- a/examples/learning/nerd/_support/_generation.py +++ b/examples/learning/nerd/_support/_generation.py @@ -32,8 +32,8 @@ import numpy as np import torch -from embodichain_models.dynamics.nerd.codec import quat_rotate -from embodichain_models.dynamics.nerd.data import DynamicsShardWriter +from embodichain.extensions.models.dynamics.nerd.codec import quat_rotate +from embodichain.extensions.models.dynamics.nerd.data import DynamicsShardWriter from embodichain.utils import configclass from ._reference_assets import reference_profile from ._newton import _NewtonTeacher diff --git a/examples/learning/nerd/_support/_matched_small_budget.py b/examples/learning/nerd/_support/_matched_small_budget.py index e53584ae96..cd54317628 100644 --- a/examples/learning/nerd/_support/_matched_small_budget.py +++ b/examples/learning/nerd/_support/_matched_small_budget.py @@ -35,8 +35,8 @@ import numpy as np import torch -from embodichain_models.dynamics.nerd.codec import NeRDStateCodec -from embodichain_models.dynamics.nerd.data import ( +from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec +from embodichain.extensions.models.dynamics.nerd.data import ( DynamicsWindowDataset, dataset_fingerprint, load_manifest, @@ -49,7 +49,10 @@ normalized_mse, ) from examples.learning.nerd._support._workflow import run_export -from embodichain_models.dynamics.nerd import convert_legacy_checkpoint, load_model +from embodichain.extensions.models.dynamics.nerd import ( + convert_legacy_checkpoint, + load_model, +) __all__: list[str] = [] diff --git a/examples/learning/nerd/_support/_model_env.py b/examples/learning/nerd/_support/_model_env.py index d78dd15faf..3b6d3632a8 100644 --- a/examples/learning/nerd/_support/_model_env.py +++ b/examples/learning/nerd/_support/_model_env.py @@ -26,8 +26,11 @@ import numpy as np import torch -from embodichain_models.dynamics.nerd.codec import reset_history -from embodichain_models.dynamics.nerd.transition import NeRDState, NeRDTransition +from embodichain.extensions.models.dynamics.nerd.codec import reset_history +from embodichain.extensions.models.dynamics.nerd.transition import ( + NeRDState, + NeRDTransition, +) from ._task_reset import sample_task_reset from ._task_values import reference_task_values diff --git a/examples/learning/nerd/_support/_model_factory.py b/examples/learning/nerd/_support/_model_factory.py index 2c64029380..6287064835 100644 --- a/examples/learning/nerd/_support/_model_factory.py +++ b/examples/learning/nerd/_support/_model_factory.py @@ -24,8 +24,12 @@ import torch -from embodichain_models.dynamics.nerd import load_model, NeRDStateCodec, NeRDTransition -from embodichain_solvers.physics.nerd._binding import NeRDBinding +from embodichain.extensions.models.dynamics.nerd import ( + load_model, + NeRDStateCodec, + NeRDTransition, +) +from embodichain.extensions.solvers.physics.nerd._binding import NeRDBinding from ._model_env import NeRDModelEnv from ._reference_assets import reference_profile diff --git a/examples/learning/nerd/_support/_newton.py b/examples/learning/nerd/_support/_newton.py index 2e684d2ea3..2f79fd3f36 100644 --- a/examples/learning/nerd/_support/_newton.py +++ b/examples/learning/nerd/_support/_newton.py @@ -29,7 +29,10 @@ import torch import warp as wp -from embodichain_models.dynamics.nerd.codec import plane_contact_features, quat_rotate +from embodichain.extensions.models.dynamics.nerd.codec import ( + plane_contact_features, + quat_rotate, +) from ._reference_assets import ( _ant_reference_friction, _import_reference, diff --git a/examples/learning/nerd/_support/_official_evaluation_data.py b/examples/learning/nerd/_support/_official_evaluation_data.py index c63c9b01a5..a951a0d22b 100644 --- a/examples/learning/nerd/_support/_official_evaluation_data.py +++ b/examples/learning/nerd/_support/_official_evaluation_data.py @@ -50,10 +50,10 @@ def _hash(path: Path) -> str: def _default_transport_root() -> Path: """Find installed or source codec files without importing the model SDK.""" - relative = Path("embodichain_models/dynamics/nerd") + relative = Path("embodichain/extensions/models/dynamics/nerd") candidates = [ Path(__file__).resolve().parents[4] - / "extensions/embodichain_models" + / "embodichain/extensions/models" / relative, *(Path(entry) / relative for entry in sys.path), ] @@ -97,7 +97,7 @@ def _transport(directory: Path) -> tuple[Any, Any]: # Bind the moved task-math import to the isolated codec rather than # importing the SDK into a historical reference interpreter. source = path.read_text().replace( - "from embodichain_models.dynamics.nerd.codec import", + "from embodichain.extensions.models.dynamics.nerd.codec import", "from .codec import", ) exec(compile(source, str(path), "exec"), module.__dict__) diff --git a/examples/learning/nerd/_support/_reference.py b/examples/learning/nerd/_support/_reference.py index 1d889374ab..b291304416 100644 --- a/examples/learning/nerd/_support/_reference.py +++ b/examples/learning/nerd/_support/_reference.py @@ -299,7 +299,9 @@ def run_reference( """ if not trust_external_code: raise ValueError("Official source execution requires trust_external_code=True") - from embodichain_models.dynamics.nerd._numerics import _validate_numerical_profile + from embodichain.extensions.models.dynamics.nerd._numerics import ( + _validate_numerical_profile, + ) if ( _validate_numerical_profile( @@ -316,9 +318,9 @@ def run_reference( import numpy as np from algorithms.vanilla_trainer import VanillaTrainer from utils.time_report import TimeReport - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset - from embodichain_models.dynamics.nerd import load_model, export_model + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset + from embodichain.extensions.models.dynamics.nerd import load_model, export_model from ._trainer import ( DynamicsTrainCfg, evaluate_model, @@ -587,8 +589,8 @@ def export_legacy_dataset( import h5py import numpy as np import torch - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.data import ( load_manifest, dataset_fingerprint, ) @@ -693,8 +695,8 @@ def import_legacy_datasets( import h5py import numpy as np import torch - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.data import ( DynamicsShardWriter, load_manifest, dataset_fingerprint, @@ -709,7 +711,10 @@ def import_legacy_datasets( "Preserved legacy velocity requires the source world frame without rotation" ) codec = NeRDStateCodec(**metadata["codec"]) - from embodichain_models.dynamics.nerd.codec import quat_rotate, quat_multiply + from embodichain.extensions.models.dynamics.nerd.codec import ( + quat_rotate, + quat_multiply, + ) rotation = ( None @@ -974,7 +979,7 @@ def generate_official_dataset( import math import time import xml.etree.ElementTree as ET - from embodichain_models.dynamics.nerd.codec import quat_multiply + from embodichain.extensions.models.dynamics.nerd.codec import quat_multiply robot = str(spec["robot"]).lower() if robot not in {"cartpole", "ant"}: diff --git a/examples/learning/nerd/_support/_reference_rollout.py b/examples/learning/nerd/_support/_reference_rollout.py index 215f23f182..e511a28596 100644 --- a/examples/learning/nerd/_support/_reference_rollout.py +++ b/examples/learning/nerd/_support/_reference_rollout.py @@ -64,7 +64,10 @@ def compatible(stream_or_device: Any): def _canonical_states(states: Any, codec: Any, rotation: Any) -> tuple[Any, Any]: import torch - from embodichain_models.dynamics.nerd.codec import quat_rotate, quat_multiply + from embodichain.extensions.models.dynamics.nerd.codec import ( + quat_rotate, + quat_multiply, + ) q = states[..., : codec.q_dim] qd = codec.legacy_to_native(q, states[..., codec.q_dim :]) @@ -260,14 +263,14 @@ def evaluate_reference_rollouts( JOINT_ACT_SCALE, ) from utils.python_utils import set_random_seed - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec from ._task_values import reference_task_values from examples.learning.nerd._support._evaluation import ( _error_values, _safe_number, _teacher_row_sha256, ) - from embodichain_models.dynamics.nerd import load_model + from embodichain.extensions.models.dynamics.nerd import load_model from ._reference import _restore_official_model device = str(spec.get("device", "cpu")) diff --git a/examples/learning/nerd/_support/_reference_traces.py b/examples/learning/nerd/_support/_reference_traces.py index 0fd582e14f..db98898b62 100644 --- a/examples/learning/nerd/_support/_reference_traces.py +++ b/examples/learning/nerd/_support/_reference_traces.py @@ -28,7 +28,7 @@ import torch from examples.learning.nerd._support._evaluation import _teacher_row_sha256 -from embodichain_models.dynamics.nerd.data import load_manifest +from embodichain.extensions.models.dynamics.nerd.data import load_manifest from ._reference import OFFICIAL_COMMIT __all__: list[str] = [] diff --git a/examples/learning/nerd/_support/_report.py b/examples/learning/nerd/_support/_report.py index 3eeaa3d67c..d3e1986296 100644 --- a/examples/learning/nerd/_support/_report.py +++ b/examples/learning/nerd/_support/_report.py @@ -369,7 +369,7 @@ def _dataset_evidence(teacher: str, declaration: dict[str, Any]) -> dict[str, An """Check provenance in immutable data, rather than trusting a matrix row label.""" if declaration.get("status") != "available": return {"status": "pending", "reason": "Teacher dataset unavailable"} - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.data import ( dataset_fingerprint, load_manifest, ) diff --git a/examples/learning/nerd/_support/_scene.py b/examples/learning/nerd/_support/_scene.py index b6eecaf101..8a13d43f43 100644 --- a/examples/learning/nerd/_support/_scene.py +++ b/examples/learning/nerd/_support/_scene.py @@ -29,7 +29,7 @@ import warp as wp from embodichain.lab.sim.cfg import NewtonPhysicsCfg -from embodichain_solvers.physics.nerd._binding import NeRDBinding +from embodichain.extensions.solvers.physics.nerd._binding import NeRDBinding from ._scene_assets import reference_profile from ._scene_setup import declare_reference_scene, reference_friction @@ -39,8 +39,8 @@ def _runtime_identity(device: torch.device) -> dict[str, Any]: """Record actual execution identity separately from historical teacher metadata.""" - from embodichain_models.dynamics.nerd import geometry, transition - from embodichain_solvers.physics.nerd import provider + from embodichain.extensions.models.dynamics.nerd import geometry, transition + from embodichain.extensions.solvers.physics.nerd import provider from embodichain.lab.sim.diff import _newton_fk sources = { @@ -130,7 +130,9 @@ def __init__( raise ValueError( "NeRD native deployment requires one prediction per step" ) - from embodichain_solvers.physics.nerd.provider import NeRDProvider + from embodichain.extensions.solvers.physics.nerd.provider import ( + NeRDProvider, + ) solver_cfg = ProviderNewtonSolverCfg( provider_factory=NeRDProvider, options=configured.get("options", {}) diff --git a/examples/learning/nerd/_support/_task_reset.py b/examples/learning/nerd/_support/_task_reset.py index 6074bd8e89..cda1277b5d 100644 --- a/examples/learning/nerd/_support/_task_reset.py +++ b/examples/learning/nerd/_support/_task_reset.py @@ -18,7 +18,7 @@ from __future__ import annotations import torch -from embodichain_models.dynamics.nerd.codec import quat_rotate +from embodichain.extensions.models.dynamics.nerd.codec import quat_rotate from ._scene_assets import reference_profile __all__: list[str] = [] diff --git a/examples/learning/nerd/_support/_task_values.py b/examples/learning/nerd/_support/_task_values.py index 33bcbf5ac6..fa33f913af 100644 --- a/examples/learning/nerd/_support/_task_values.py +++ b/examples/learning/nerd/_support/_task_values.py @@ -25,7 +25,7 @@ from __future__ import annotations import torch from torch import Tensor -from embodichain_models.dynamics.nerd.codec import quat_rotate +from embodichain.extensions.models.dynamics.nerd.codec import quat_rotate __all__ = ["reference_task_values"] diff --git a/examples/learning/nerd/_support/_trainer.py b/examples/learning/nerd/_support/_trainer.py index 44c6b93d9f..9193477522 100644 --- a/examples/learning/nerd/_support/_trainer.py +++ b/examples/learning/nerd/_support/_trainer.py @@ -30,19 +30,22 @@ from torch import Tensor from embodichain.utils import configclass -from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset +from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset from embodichain.learning.sl import SupervisedLearner from embodichain.learning.sl._artifacts import _RunArtifacts -from embodichain_models.dynamics.nerd.supervised import NeRDObjective, make_nerd_batch +from embodichain.extensions.models.dynamics.nerd.supervised import ( + NeRDObjective, + make_nerd_batch, +) from ._sample_order import _CheckpointedOrder, _OfficialShuffleOrder, _open_order -from embodichain_models.dynamics.nerd._numerics import ( +from embodichain.extensions.models.dynamics.nerd._numerics import ( _attention_context, _checkpoint_numerical_profile, _clip_grad_norm_, _validate_numerical_profile, ) -from embodichain_models.dynamics.nerd.integration import ( +from embodichain.extensions.models.dynamics.nerd.integration import ( _PREPROCESSING_EXECUTION, encode_batch, normalized_mse, diff --git a/examples/learning/nerd/_support/_workflow.py b/examples/learning/nerd/_support/_workflow.py index 2a8347221a..8813177ef1 100644 --- a/examples/learning/nerd/_support/_workflow.py +++ b/examples/learning/nerd/_support/_workflow.py @@ -94,9 +94,13 @@ def run_train(config: dict[str, Any]) -> dict[str, Any]: }, ) import torch - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd import NeRDModel, NeRDModelCfg, load_model - from embodichain_models.dynamics.nerd.data import ( + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd import ( + NeRDModel, + NeRDModelCfg, + load_model, + ) + from embodichain.extensions.models.dynamics.nerd.data import ( DynamicsWindowDataset, load_manifest, ) @@ -131,7 +135,9 @@ def run_train(config: dict[str, Any]) -> dict[str, Any]: ) != manifest.get("dt"): raise ValueError("Fine-tuning requires compatible codec and timestep") elif config.get("resume"): - from embodichain_models.dynamics.nerd.checkpoint import _model_from_state + from embodichain.extensions.models.dynamics.nerd.checkpoint import ( + _model_from_state, + ) saved = _load_training_checkpoint(config["resume"]) # Keep the requested architecture/feature order for resume preflight, @@ -206,9 +212,9 @@ def run_eval(config: dict[str, Any]) -> dict[str, Any]: "include_prefix", }, ) - from embodichain_models.dynamics.nerd.codec import NeRDStateCodec - from embodichain_models.dynamics.nerd import load_model - from embodichain_models.dynamics.nerd.data import DynamicsWindowDataset + from embodichain.extensions.models.dynamics.nerd.codec import NeRDStateCodec + from embodichain.extensions.models.dynamics.nerd import load_model + from embodichain.extensions.models.dynamics.nerd.data import DynamicsWindowDataset from ._trainer import evaluate_model device = config.get("device", "cpu") @@ -251,9 +257,11 @@ def run_export(checkpoint: str | Path, output: str | Path) -> dict[str, Any]: import numpy as np import torch - from embodichain_models.dynamics.nerd import NeRDModelCfg, export_model - from embodichain_models.dynamics.nerd.checkpoint import _model_from_state - from embodichain_models.dynamics.nerd._numerics import _checkpoint_numerical_profile + from embodichain.extensions.models.dynamics.nerd import NeRDModelCfg, export_model + from embodichain.extensions.models.dynamics.nerd.checkpoint import _model_from_state + from embodichain.extensions.models.dynamics.nerd._numerics import ( + _checkpoint_numerical_profile, + ) # Generic SL records NumPy's MT19937 RNG state, unlike the historical # tensor-only NeRD checkpoint. Restrict loading to those known array types. diff --git a/examples/learning/nerd/configs/ant/README.md b/examples/learning/nerd/configs/ant/README.md index 943e625f38..d708076886 100644 --- a/examples/learning/nerd/configs/ant/README.md +++ b/examples/learning/nerd/configs/ant/README.md @@ -15,7 +15,7 @@ The SL recipe is bounded to 1,000 updates, with an explicit resident-cache budget. Use `--device cpu` for CPU execution. To use `embodichain train-sl`, copy `sl.train.yaml`, set `data.path` and `trainer.output_dir`, and resolve relative paths from the working directory. The factory is installed under -`embodichain_models.dynamics.nerd.sl_recipe`, so no example imports are needed. +`embodichain.extensions.models.dynamics.nerd.sl_recipe`, so no example imports are needed. The final SL checkpoint does not imply validation-selected accuracy. Teacher collection defaults to `dynamics.generate.smoke.yaml`. Prepare assets diff --git a/examples/learning/nerd/configs/ant/sl.train.yaml b/examples/learning/nerd/configs/ant/sl.train.yaml index f794bc4c26..97b23a4045 100644 --- a/examples/learning/nerd/configs/ant/sl.train.yaml +++ b/examples/learning/nerd/configs/ant/sl.train.yaml @@ -1,5 +1,5 @@ # Standalone SL recipe; run from the repository root after downloading data. -factory: embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer +factory: embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer model: input_dims: states_embedding: 29 diff --git a/examples/learning/nerd/configs/cartpole/README.md b/examples/learning/nerd/configs/cartpole/README.md index 017edf23c8..de5e8bf31e 100644 --- a/examples/learning/nerd/configs/cartpole/README.md +++ b/examples/learning/nerd/configs/cartpole/README.md @@ -15,7 +15,7 @@ The SL recipe is bounded to 1,000 updates, with an explicit resident-cache budget. Use `--device cpu` for CPU execution. To use `embodichain train-sl`, copy `sl.train.yaml`, set `data.path` and `trainer.output_dir`, and resolve relative paths from the working directory. The factory is installed under -`embodichain_models.dynamics.nerd.sl_recipe`, so no example imports are needed. +`embodichain.extensions.models.dynamics.nerd.sl_recipe`, so no example imports are needed. The final SL checkpoint does not imply validation-selected accuracy. Teacher collection defaults to `dynamics.generate.smoke.yaml`. Prepare assets diff --git a/examples/learning/nerd/configs/cartpole/sl.train.yaml b/examples/learning/nerd/configs/cartpole/sl.train.yaml index 8fa869c445..f4d3ae95fb 100644 --- a/examples/learning/nerd/configs/cartpole/sl.train.yaml +++ b/examples/learning/nerd/configs/cartpole/sl.train.yaml @@ -1,5 +1,5 @@ # Standalone SL recipe; run from the repository root after downloading data. -factory: embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer +factory: embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer model: input_dims: states_embedding: 4 diff --git a/examples/learning/nerd/research/acceptance.md b/examples/learning/nerd/research/acceptance.md index 1a02b8a37a..de09dc9341 100644 --- a/examples/learning/nerd/research/acceptance.md +++ b/examples/learning/nerd/research/acceptance.md @@ -15,7 +15,7 @@ embodichain run-example learning/nerd train --robot cartpole --resource-root ./o Use `--robot ant` for Ant. For direct `embodichain train-sl`, copy the robot's `../configs//sl.train.yaml`, set `data.path` and `trainer.output_dir`, and use the installable factory -`embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer`. Common SL +`embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`. Common SL checkpoints resume with the same recipe through `train-sl --resume` or the showcase's default `train --resume`. Export its committed `last.pt` through `embodichain run-example learning/nerd export`; common SL does not automatically diff --git a/examples/learning/rigidformer/README.md b/examples/learning/rigidformer/README.md index 2fc37db0e5..8a11e058b8 100644 --- a/examples/learning/rigidformer/README.md +++ b/examples/learning/rigidformer/README.md @@ -6,7 +6,7 @@ for working principles, input/output layout and a PyTorch prediction example. This showcase integrates the author's RigidFormer implementation at `160fe0852c51cffae7b7440452b58d0b49db6df6` from [Frank-ZY-Dou/Dynamics-Modeling](https://github.com/Frank-ZY-Dou/Dynamics-Modeling/tree/160fe0852c51cffae7b7440452b58d0b49db6df6/RigidFormer). -The model lives at `embodichain_models.dynamics.rigidformer` and trains through +The model lives at `embodichain.extensions.models.dynamics.rigidformer` and trains through the common SL trainer. The community `rigidformer` package is not a runtime dependency. ## Setup and ownership diff --git a/examples/learning/rigidformer/__main__.py b/examples/learning/rigidformer/__main__.py index f1f66772d2..94c805a1a7 100644 --- a/examples/learning/rigidformer/__main__.py +++ b/examples/learning/rigidformer/__main__.py @@ -139,7 +139,7 @@ def main() -> None: run_demo(args) elif args.command == "export": - from embodichain_models.dynamics.rigidformer.checkpoint import ( + from embodichain.extensions.models.dynamics.rigidformer.checkpoint import ( export_rigidformer_checkpoint, ) @@ -161,8 +161,12 @@ def main() -> None: def evaluate(args: argparse.Namespace) -> None: - from embodichain_models.dynamics.rigidformer import load_rigidformer_checkpoint - from embodichain_models.dynamics.rigidformer.data import _verified_manifest + from embodichain.extensions.models.dynamics.rigidformer import ( + load_rigidformer_checkpoint, + ) + from embodichain.extensions.models.dynamics.rigidformer.data import ( + _verified_manifest, + ) from ._support._evidence import evidence if args.output.exists(): @@ -227,7 +231,7 @@ def evaluate(args: argparse.Namespace) -> None: record = { **evidence(args.checkpoint, root, args.attention_backend), "author_revision": __import__( - "embodichain_models.dynamics.rigidformer", + "embodichain.extensions.models.dynamics.rigidformer", fromlist=["RIGIDFORMER_REVISION"], ).RIGIDFORMER_REVISION, "checkpoint_sha256": sha256(args.checkpoint), diff --git a/examples/learning/rigidformer/_demo.py b/examples/learning/rigidformer/_demo.py index 493cc06ab1..9af0bde12d 100644 --- a/examples/learning/rigidformer/_demo.py +++ b/examples/learning/rigidformer/_demo.py @@ -37,7 +37,7 @@ from embodichain.lab.sim import SimulationManager from embodichain.lab.sim.objects import RigidObject, VisualObject from embodichain.lab.sim.sensors import Camera - from embodichain_models.dynamics.rigidformer import RigidFormerModel + from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel __all__ = ["run_demo"] @@ -63,7 +63,7 @@ class _Geometry: def _load_geometry(args: argparse.Namespace, config: dict[str, Any]) -> _Geometry: """Read committed sphere templates, anchors and physical properties.""" - from embodichain_models.dynamics.rigidformer._native.data.dataset import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.dataset import ( MultiObjectDynamics, ) @@ -258,8 +258,12 @@ def run_demo(args: argparse.Namespace) -> None: from embodichain.lab.sim.sensors import CameraCfg from embodichain.lab.sim.shapes import SphereCfg from embodichain.lab.visualization.cli import visualization_cfg_from_args - from embodichain_models.dynamics.rigidformer import load_rigidformer_checkpoint - from embodichain_models.dynamics.rigidformer.data import _verified_manifest + from embodichain.extensions.models.dynamics.rigidformer import ( + load_rigidformer_checkpoint, + ) + from embodichain.extensions.models.dynamics.rigidformer.data import ( + _verified_manifest, + ) if not _WARMUP < args.frames <= 480 or args.stride < 1 or args.fps < 1: raise ValueError("frames must be in [5, 480]; stride and fps must be positive") diff --git a/examples/learning/rigidformer/_prepare.py b/examples/learning/rigidformer/_prepare.py index 24f9822bfd..312fb53011 100644 --- a/examples/learning/rigidformer/_prepare.py +++ b/examples/learning/rigidformer/_prepare.py @@ -108,7 +108,7 @@ def _rows(path: Path) -> list[dict[str, Any]]: def prepare(raw: Path, output: Path, dataset: str, *, limit_per_split: int = 0) -> Path: """Write author-compatible packed vertices without storing videos.""" import trimesh - from embodichain_models.dynamics.rigidformer._native.data.dataset import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.dataset import ( MultiObjectDynamics, ) diff --git a/examples/learning/rigidformer/_support/_compare.py b/examples/learning/rigidformer/_support/_compare.py index 3b1837ef41..2dc71c80e6 100644 --- a/examples/learning/rigidformer/_support/_compare.py +++ b/examples/learning/rigidformer/_support/_compare.py @@ -29,17 +29,20 @@ import numpy as np import torch from .._prepare import sha256, WEIGHT_SHA256 -from embodichain_models.dynamics.rigidformer import ( +from embodichain.extensions.models.dynamics.rigidformer import ( load_rigidformer_checkpoint, RIGIDFORMER_REVISION, ) -from embodichain_models.dynamics.rigidformer.data import MOViSequenceSource -from embodichain_models.dynamics.rigidformer.supervised import ( +from embodichain.extensions.models.dynamics.rigidformer.data import MOViSequenceSource +from embodichain.extensions.models.dynamics.rigidformer.supervised import ( RigidFormerObjective, rigidformer_batch, ) -from embodichain_models.dynamics.rigidformer.sl_recipe import _optimizer, _EpochSchedule -from embodichain_models.dynamics.rigidformer.ema import RigidFormerEMA +from embodichain.extensions.models.dynamics.rigidformer.sl_recipe import ( + _optimizer, + _EpochSchedule, +) +from embodichain.extensions.models.dynamics.rigidformer.ema import RigidFormerEMA from embodichain.learning.sl import SupervisedLearner from ._evidence import evidence @@ -96,7 +99,7 @@ def compare(args: argparse.Namespace) -> None: } try: manifest = json.loads( - files("embodichain_models.dynamics.rigidformer") + files("embodichain.extensions.models.dynamics.rigidformer") .joinpath("REFERENCE_SOURCES.json") .read_text() ) @@ -210,7 +213,7 @@ def sdpa(q, k, v, dropout_p=0.0, softmax_scale=None, **kwargs): _optimizer_state(native_optimizer, native), _optimizer_state(reference_trainer.optimizer, reference), ) - from embodichain_models.dynamics.rigidformer._native.data.gpu_augmentation import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.gpu_augmentation import ( GPUAugmentation, ) diff --git a/examples/learning/rigidformer/_support/_evaluator.py b/examples/learning/rigidformer/_support/_evaluator.py index 32e1e8f256..f72b7c0f0e 100644 --- a/examples/learning/rigidformer/_support/_evaluator.py +++ b/examples/learning/rigidformer/_support/_evaluator.py @@ -41,7 +41,9 @@ from tqdm import tqdm import trimesh import roma # For rotation matrix to quaternion conversion -from embodichain_models.dynamics.rigidformer._native.data.scene_frames import load_frame +from embodichain.extensions.models.dynamics.rigidformer._native.data.scene_frames import ( + load_frame, +) logger = logging.getLogger(__name__) @@ -119,7 +121,7 @@ def __init__(self, trainer): self.trainer = trainer self.config = trainer.config # data.object_scale_file: the canonical frame-0 meshes read below must carry the same scale as the model inputs - from embodichain_models.dynamics.rigidformer._native.data.object_scale import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.object_scale import ( from_config as _object_scale_from_config, ) @@ -328,7 +330,7 @@ def _evaluate_rmse_on_split( split: 'val' or 'test' step_size: Step size for frame sampling (1, 2, 5, 10, etc.) """ - from embodichain_models.dynamics.rigidformer._native.data.dataset import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.dataset import ( MultiObjectDynamics, make_collate_fn, ) @@ -413,7 +415,7 @@ def _get_eval_dataset( self, split: str, skip_step_size: int, eval_sequence_length: int ): """The cached evaluation dataset of a split at a step size (one sample per scene, warm-up frames only).""" - from embodichain_models.dynamics.rigidformer._native.data.dataset import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.dataset import ( MultiObjectDynamics, ) @@ -487,7 +489,7 @@ def _get_eval_dataset( def _eval_loader(self, eval_dataset, batch_size: int): """Evaluation DataLoader: scenes in dataset order, every scene on exactly one rank.""" - from embodichain_models.dynamics.rigidformer._native.data.dataset import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data.dataset import ( make_collate_fn, ) diff --git a/examples/learning/rigidformer/_support/_evidence.py b/examples/learning/rigidformer/_support/_evidence.py index 625ea8189e..0b36d7a2a2 100644 --- a/examples/learning/rigidformer/_support/_evidence.py +++ b/examples/learning/rigidformer/_support/_evidence.py @@ -33,7 +33,7 @@ def evidence(checkpoint: Path, root: Path, backend: str) -> dict[str, Any]: """Describe the executed installation and the immutable experiment inputs.""" import embodichain.learning.sl as sl - import embodichain_models.dynamics.rigidformer as family + import embodichain.extensions.models.dynamics.rigidformer as family dependencies = {} for package in ( diff --git a/examples/learning/rigidformer/_support/_recovery.py b/examples/learning/rigidformer/_support/_recovery.py index d4e25cb0a9..73e249b573 100644 --- a/examples/learning/rigidformer/_support/_recovery.py +++ b/examples/learning/rigidformer/_support/_recovery.py @@ -28,7 +28,7 @@ import torch import yaml -from embodichain_models.dynamics.rigidformer import ( +from embodichain.extensions.models.dynamics.rigidformer import ( build_rigidformer_trainer, export_rigidformer_checkpoint, ) diff --git a/examples/learning/rigidformer/configs/sl.movi_a.yaml b/examples/learning/rigidformer/configs/sl.movi_a.yaml index 2584b0e487..663d3ba65d 100644 --- a/examples/learning/rigidformer/configs/sl.movi_a.yaml +++ b/examples/learning/rigidformer/configs/sl.movi_a.yaml @@ -1,4 +1,4 @@ -factory: embodichain_models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer +factory: embodichain.extensions.models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer model: preset: movi_a attention_backend: sdpa diff --git a/examples/learning/rigidformer/configs/sl.movi_b.yaml b/examples/learning/rigidformer/configs/sl.movi_b.yaml index f69d31b22b..92a6d6ac84 100644 --- a/examples/learning/rigidformer/configs/sl.movi_b.yaml +++ b/examples/learning/rigidformer/configs/sl.movi_b.yaml @@ -1,4 +1,4 @@ -factory: embodichain_models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer +factory: embodichain.extensions.models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer model: preset: movi_b attention_backend: sdpa diff --git a/examples/learning/rigidformer/configs/sl.movi_sphere.yaml b/examples/learning/rigidformer/configs/sl.movi_sphere.yaml index f2644c6c56..e1f6e72652 100644 --- a/examples/learning/rigidformer/configs/sl.movi_sphere.yaml +++ b/examples/learning/rigidformer/configs/sl.movi_sphere.yaml @@ -1,4 +1,4 @@ -factory: embodichain_models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer +factory: embodichain.extensions.models.dynamics.rigidformer.sl_recipe:build_rigidformer_trainer model: preset: movi_sphere attention_backend: sdpa diff --git a/examples/learning/rwm/README.md b/examples/learning/rwm/README.md index 46bc7bc429..43c671cb93 100644 --- a/examples/learning/rwm/README.md +++ b/examples/learning/rwm/README.md @@ -22,8 +22,8 @@ No ODS producer, native simulator or APG learner is constructed. The emitted `recipe.json` also works with `embodichain train-sl --config FILE`. Its installable factory is -`embodichain_models.dynamics.rwm.sl_recipe:build_rwm_trainer`; the same symbol is -exported from `embodichain_models.dynamics.rwm`. +`embodichain.extensions.models.dynamics.rwm.sl_recipe:build_rwm_trainer`; the same symbol is +exported from `embodichain.extensions.models.dynamics.rwm`. Use a fresh output directory for a new run. `--resume FILE` restores the saved learning boundary through the shared trainer; GPU replay snapshots are optional, and a workflow may explicitly rebuild/refill replay instead. diff --git a/examples/learning/rwm/_support/_controlled_fit.py b/examples/learning/rwm/_support/_controlled_fit.py index 35b7a47ba8..bfcf3180eb 100644 --- a/examples/learning/rwm/_support/_controlled_fit.py +++ b/examples/learning/rwm/_support/_controlled_fit.py @@ -35,9 +35,9 @@ import torch -from embodichain_models.dynamics.rwm.robot_state import integrate_robot_state +from embodichain.extensions.models.dynamics.rwm.robot_state import integrate_robot_state from embodichain.learning.sl import SupervisedBatch, SupervisedLearner -from embodichain_models.dynamics.rwm import ( +from embodichain.extensions.models.dynamics.rwm import ( RobotWorldModelObjective, build_rwm_trainer, RobotWorldModel, @@ -98,7 +98,7 @@ def main() -> None: args.output / f"{split}.pt", ) config = { - "factory": "embodichain_models.dynamics.rwm.sl_recipe:build_rwm_trainer", + "factory": "embodichain.extensions.models.dynamics.rwm.sl_recipe:build_rwm_trainer", "model": { "num_joints": 1, "action_dim": 1, @@ -160,17 +160,17 @@ def main() -> None: repository = Path(__file__).resolve().parents[4] sources = {"examples/learning/rwm/_support/_controlled_fit.py": Path(__file__)} for name in ( - "embodichain_models.dynamics.rwm.model", - "embodichain_models.dynamics.rwm.supervised", - "embodichain_models.dynamics.rwm.sl_recipe", - "embodichain_models.dynamics.rwm.robot_state", + "embodichain.extensions.models.dynamics.rwm.model", + "embodichain.extensions.models.dynamics.rwm.supervised", + "embodichain.extensions.models.dynamics.rwm.sl_recipe", + "embodichain.extensions.models.dynamics.rwm.robot_state", "embodichain.learning.sl.learner", "embodichain.learning.sl.trainer", "embodichain.learning.sl.sources", ): prefix = ( - "extensions/embodichain_models/" - if name.startswith("embodichain_models.") + "embodichain/extensions/models/" + if name.startswith("embodichain.extensions.models.") else "" ) sources[f"{prefix}{name.replace('.', '/')}.py"] = Path( diff --git a/examples/learning/sl_ddp/README.md b/examples/learning/sl_ddp/README.md index eee8bec66f..8b13cc6699 100644 --- a/examples/learning/sl_ddp/README.md +++ b/examples/learning/sl_ddp/README.md @@ -88,7 +88,7 @@ CUDA_VISIBLE_DEVICES=0,1 OMP_NUM_THREADS=1 \ --config examples/learning/nerd/configs/cartpole/sl.train.yaml ``` -Its factory is `embodichain_models.dynamics.nerd.sl_recipe:build_supervised_trainer`. +Its factory is `embodichain.extensions.models.dynamics.nerd.sl_recipe:build_supervised_trainer`. The existing precision, causal attention, normalization and loss-mask settings remain recipe-owned. Each rank loads the dataset and keeps its own resident cache, so budget memory per worker. Validation runs on rank 0 with its unwrapped diff --git a/examples/learning/task_program_progress/__main__.py b/examples/learning/task_program_progress/__main__.py index 217c48c389..d294ef3d8e 100644 --- a/examples/learning/task_program_progress/__main__.py +++ b/examples/learning/task_program_progress/__main__.py @@ -60,7 +60,7 @@ def main() -> None: path = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" ) config = load_config(path) config.update( diff --git a/examples/learning/worldparticle/DEPLOYMENT.md b/examples/learning/worldparticle/DEPLOYMENT.md index 729cbd3dcd..905948acc5 100644 --- a/examples/learning/worldparticle/DEPLOYMENT.md +++ b/examples/learning/worldparticle/DEPLOYMENT.md @@ -27,7 +27,7 @@ import yaml import dexsim from dexsim.engine.newton_physics import NewtonCfg, ProviderNewtonSolverCfg from dexsim.spawn import SceneBuilder, FluidRenderMode -from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider +from embodichain.extensions.solvers.physics.worldparticle.provider import WorldParticleProvider assets = Path("outputs/worldparticle/assets").resolve() checkpoint = assets / "checkpoints/fancy_fluid/final.ckpt" diff --git a/examples/learning/worldparticle/README.md b/examples/learning/worldparticle/README.md index 180a2bdbfa..8bbf1a54f9 100644 --- a/examples/learning/worldparticle/README.md +++ b/examples/learning/worldparticle/README.md @@ -1,9 +1,9 @@ # WorldParticle -The model layer lives in `embodichain_models.dynamics.worldparticle`: original +The model layer lives in `embodichain.extensions.models.dynamics.worldparticle`: original network, strict checkpoint loading, authored features/topology and coordinate conversion. It imports neither simulation nor examples. The integration layer -is `embodichain_solvers.physics.worldparticle.provider.WorldParticleProvider`; the native +is `embodichain.extensions.solvers.physics.worldparticle.provider.WorldParticleProvider`; the native solver adapter is DexSim's model-independent `ParticleInferenceSolver`. Providers are constructed per scene through the existing Newton lifecycle. @@ -45,7 +45,7 @@ from pathlib import Path import numpy as np import torch import yaml -from embodichain_models.dynamics.worldparticle import load_model +from embodichain.extensions.models.dynamics.worldparticle import load_model assets = Path("outputs/worldparticle/assets").resolve() config_path = assets / "checkpoints/fancy_fluid/config.yaml" diff --git a/examples/learning/worldparticle/__main__.py b/examples/learning/worldparticle/__main__.py index 841f2ea835..784cb20058 100644 --- a/examples/learning/worldparticle/__main__.py +++ b/examples/learning/worldparticle/__main__.py @@ -27,7 +27,7 @@ import yaml from ._demo_assets import PROFILES, add_boundary_visuals -from embodichain_models.dynamics.worldparticle.data import load_sample +from embodichain.extensions.models.dynamics.worldparticle.data import load_sample def _demo(default_scene="fancy_fluid") -> None: @@ -137,7 +137,9 @@ def _demo(default_scene="fancy_fluid") -> None: os.environ.setdefault("SDL_VIDEODRIVER", "offscreen") import dexsim from dexsim.engine.newton_physics import NewtonCfg, ProviderNewtonSolverCfg - from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider + from embodichain.extensions.solvers.physics.worldparticle.provider import ( + WorldParticleProvider, + ) from dexsim.spawn import ( SceneBuilder, FluidRenderMode, diff --git a/examples/ods/simple_bc_demo/README.md b/examples/ods/simple_bc_demo/README.md index 83923c470d..f526f44dd3 100644 --- a/examples/ods/simple_bc_demo/README.md +++ b/examples/ods/simple_bc_demo/README.md @@ -51,7 +51,7 @@ DexSim runtime from the repository root before running native checks: ```bash conda activate py311 -export PYTHONPATH="$PWD:$PWD/extensions:$PWD/extensions/embodichain_tasks:/tmp/ods-dexsim-runtime" +export PYTHONPATH="$PWD:/tmp/ods-dexsim-runtime" export CUDA_VISIBLE_DEVICES=3 export OMP_NUM_THREADS=1 MKL_NUM_THREADS=1 OPENBLAS_NUM_THREADS=1 ``` diff --git a/examples/ods/simple_bc_demo/evaluation.py b/examples/ods/simple_bc_demo/evaluation.py index b3db53ee05..06cb3e7d99 100644 --- a/examples/ods/simple_bc_demo/evaluation.py +++ b/examples/ods/simple_bc_demo/evaluation.py @@ -33,11 +33,7 @@ if __package__ in {None, ""}: repository = Path(__file__).resolve().parents[3] - sys.path[:0] = [ - str(repository), - str(repository / "extensions"), - str(repository / "extensions/embodichain_tasks"), - ] + sys.path.insert(0, str(repository)) from examples.ods.simple_bc_demo.checkpoint import load_policy from examples.ods.simple_bc_demo.config import load_task_config diff --git a/examples/ods/simple_bc_demo/train.py b/examples/ods/simple_bc_demo/train.py index 3c25141555..0e96725877 100644 --- a/examples/ods/simple_bc_demo/train.py +++ b/examples/ods/simple_bc_demo/train.py @@ -29,8 +29,6 @@ # the sanitized path when multiprocessing copies it into child processes. sys.path[:] = [ str(repository), - str(repository / "extensions"), - str(repository / "extensions/embodichain_tasks"), *(entry for entry in sys.path if Path(entry).resolve() != example_directory), ] diff --git a/examples/sim/assembly/README.md b/examples/sim/assembly/README.md index 8698b92046..8e08b14615 100644 --- a/examples/sim/assembly/README.md +++ b/examples/sim/assembly/README.md @@ -39,7 +39,7 @@ load an `AssemblyAsset` at runtime. Native conversion belongs to `embodichain.toolkits.assembly.native`. Its `prepare_native_configs` prepares rigid and hinged bodies together, including optional file-backed appearance, while preserving authored collision pieces and mass properties. Precision measurements belong to -`embodichain_benchmarks.assembly`. GenSim pipelines can consume the same toolkit. +`embodichain.extensions.benchmarks.assembly`. GenSim pipelines can consume the same toolkit. The gallery writes self-contained manifests and USD files. A manifest can be loaded and constructed without mjfit or MuJoCo installed. Raw MJCF conversion @@ -168,7 +168,7 @@ source/direct cells continue. Worker crashes and mismatched output identities are reported as failures; earlier runs are never reused. Unmeasured memory and unavailable overflow accounting are marked explicitly. Passive success is distinct from S0/S2/S3/S4 clearance qualification. -The constrained reference probes in `embodichain_benchmarks.assembly.probes` use +The constrained reference probes in `embodichain.extensions.benchmarks.assembly.probes` use analytic circle/square ground truth and real slide/hinge DOFs; unsupported outlines are rejected rather than measured against the wrong oracle. Constrained probes disable the global ground. Passive probes author the source diff --git a/examples/sim/assembly/_passive.py b/examples/sim/assembly/_passive.py index 1c87e387ef..bf42460445 100644 --- a/examples/sim/assembly/_passive.py +++ b/examples/sim/assembly/_passive.py @@ -21,7 +21,10 @@ import json from embodichain.toolkits.assembly import AssemblyAsset, build_assembly -from embodichain_benchmarks.assembly.precision import PrecisionRunCfg, run_passive_probe +from embodichain.extensions.benchmarks.assembly.precision import ( + PrecisionRunCfg, + run_passive_probe, +) def run(config: str) -> None: diff --git a/examples/sim/assembly/visual_demo.py b/examples/sim/assembly/visual_demo.py index 3c7bb6d879..c775455557 100644 --- a/examples/sim/assembly/visual_demo.py +++ b/examples/sim/assembly/visual_demo.py @@ -39,7 +39,7 @@ build_many_pegs, import_mjcf, ) -from embodichain_benchmarks.assembly.precision import ( +from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, _run_embodichain, _run_mujoco, diff --git a/examples/sim/assets/gaussian_backgrounds/README.md b/examples/sim/assets/gaussian_backgrounds/README.md index 9c494dbd2a..c8279fbdbe 100644 --- a/examples/sim/assets/gaussian_backgrounds/README.md +++ b/examples/sim/assets/gaussian_backgrounds/README.md @@ -92,6 +92,6 @@ converter is deliberately not used because it also generates an enclosing box. The publication includes actual native render previews in `validation/`. The official physical consumer is -[the Franka dual-camera Pick/Place task](../../../../extensions/embodichain_tasks/configs/tasks/manipulation/gaussian_pick_place/README.md). +[the Franka dual-camera Pick/Place task](../../../../embodichain/extensions/tasks/configs/tasks/manipulation/gaussian_pick_place/README.md). The [recording example](../../../gym/gaussian_pick_place/README.md) consumes those definitions and adds complete RGB capture, video export and offline acceptance. diff --git a/examples/sim/atomic_skill/coordinated_placement.py b/examples/sim/atomic_skill/coordinated_placement.py index b6fb406353..dc056ed3b7 100644 --- a/examples/sim/atomic_skill/coordinated_placement.py +++ b/examples/sim/atomic_skill/coordinated_placement.py @@ -58,14 +58,14 @@ from embodichain.lab.sim.shapes import MeshCfg, MeshCollisionCfg from embodichain.utils import logger -from embodichain_benchmarks.motion_generation.scenarios._placement_geometry import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._placement_geometry import ( TABLE_TOP_Z, build_flat_object_grasp_pose, build_pan_handle_grasp_pose, build_support_object_target_pose, build_placing_object_target_pose, ) -from embodichain_benchmarks.motion_generation.scenarios._placement_qualification import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._placement_qualification import ( _placement_input_geometry, ) from examples.sim.atomic_skill.scenario import ( diff --git a/examples/sim/atomic_skill/embodiments.py b/examples/sim/atomic_skill/embodiments.py index 3531baff33..7ef733af50 100644 --- a/examples/sim/atomic_skill/embodiments.py +++ b/examples/sim/atomic_skill/embodiments.py @@ -48,7 +48,7 @@ from .gripper_geometry import geometry_from_asset from embodichain.utils import configclass, logger -from embodichain_robots import ( +from embodichain.extensions.robots import ( ARX5Cfg, CobotMagicCfg, DexforceW1Cfg, @@ -273,7 +273,7 @@ def create_embodiment(args: argparse.Namespace) -> EmbodimentCfg: if args.robot in ("ur5", "w1_030"): _mount_grippers(args, cfg) elif args.robot == "franka": - from embodichain_benchmarks.motion_generation._atomic_fixtures import ( + from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) @@ -360,7 +360,7 @@ def create_embodiment(args: argparse.Namespace) -> EmbodimentCfg: # Task Program runtime are created by this direct Atomic caller. from importlib.resources import files - path = files("embodichain_tasks.configs").joinpath( + path = files("embodichain.extensions.tasks.configs").joinpath( "components/embodiments/tianji_marvin.yaml" ) from embodichain.lab.gym.utils.composition import resolve_gym_components diff --git a/examples/sim/atomic_skill/support.py b/examples/sim/atomic_skill/support.py index 61fd818bb7..7cb1b0411e 100644 --- a/examples/sim/atomic_skill/support.py +++ b/examples/sim/atomic_skill/support.py @@ -70,7 +70,7 @@ ToppraPlannerCfg, TrapezoidalPlannerCfg, ) -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.toolkits.graspkit.pg_grasp import ( AntipodalGraspPoseGenerator, AntipodalGraspPoseGeneratorCfg, @@ -2645,7 +2645,7 @@ def create_ur5_gripper_robot_cfg( ) -> RobotCfg: """Build a UR5 arm + DH_PGI_140_80 gripper robot configuration. - The arm is taken from :class:`~embodichain_robots.universal_robots.ur_robot.URRobotCfg` + The arm is taken from :class:`~embodichain.extensions.robots.universal_robots.ur_robot.URRobotCfg` so the URDF, joint names and drive defaults match the canonical UR family config. The gripper and tool-center-point offset are added on top to match the existing atomic-skill tutorial setups. @@ -2658,7 +2658,7 @@ def create_ur5_gripper_robot_cfg( assembled robot keeps the source URDF's lowercase joint names (``joint1``..``joint6`` and ``gripper_finger1_joint_1``), matching the control parts produced by - :class:`~embodichain_robots.universal_robots.ur_robot.URRobotCfg`. + :class:`~embodichain.extensions.robots.universal_robots.ur_robot.URRobotCfg`. Args: init_pos: Initial root position of the robot in the arena. diff --git a/examples/sim/demo/franka_dexuni_pour_demo.py b/examples/sim/demo/franka_dexuni_pour_demo.py index 3abc695471..612cbc8040 100644 --- a/examples/sim/demo/franka_dexuni_pour_demo.py +++ b/examples/sim/demo/franka_dexuni_pour_demo.py @@ -61,7 +61,7 @@ __all__ = ["main"] TASK = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" + "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" ) diff --git a/examples/sim/demo/grasp_cup_to_caffe.py b/examples/sim/demo/grasp_cup_to_caffe.py index 30ecc35614..7c28df2385 100644 --- a/examples/sim/demo/grasp_cup_to_caffe.py +++ b/examples/sim/demo/grasp_cup_to_caffe.py @@ -77,7 +77,7 @@ def parse_arguments(argv: list[str] | None = None) -> argparse.Namespace: from embodichain.lab.sim.shapes import MeshCfg, MeshCollisionCfg from embodichain.data import get_data_path from embodichain.utils import logger -from embodichain_robots.dexforce.w1.cfg import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1.cfg import DexforceW1Cfg def initialize_simulation(args) -> SimulationManager: diff --git a/examples/sim/demo/pick_up_cloth.py b/examples/sim/demo/pick_up_cloth.py index 4da7275cb7..c494d15d60 100644 --- a/examples/sim/demo/pick_up_cloth.py +++ b/examples/sim/demo/pick_up_cloth.py @@ -68,7 +68,7 @@ def build_parser() -> argparse.ArgumentParser: RenderCfg, ) from embodichain.lab.sim.objects import SurfaceDeformableObject, RigidObject, Robot -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.lab.sim.shapes import CubeCfg, MeshCfg from embodichain.compute.trajectory import interpolate_with_nums from embodichain.lab.visualization import visualization_cfg_from_args diff --git a/examples/sim/demo/press_softbody.py b/examples/sim/demo/press_softbody.py index 2f5dcc151b..2eccfca7e7 100644 --- a/examples/sim/demo/press_softbody.py +++ b/examples/sim/demo/press_softbody.py @@ -58,7 +58,7 @@ def parse_arguments(argv: list[str] | None = None) -> argparse.Namespace: VolumeDeformableMeshingCfg, ) from embodichain.lab.sim.objects import Robot, VolumeDeformableObject -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.lab.sim.shapes import MeshCfg from embodichain.compute.trajectory import interpolate_with_nums from embodichain.lab.visualization import visualization_cfg_from_args diff --git a/examples/sim/demo/scoop_ice.py b/examples/sim/demo/scoop_ice.py index ac26ae8870..9726073570 100644 --- a/examples/sim/demo/scoop_ice.py +++ b/examples/sim/demo/scoop_ice.py @@ -66,7 +66,7 @@ def build_parser() -> argparse.ArgumentParser: from embodichain.lab.sim.shapes import CubeCfg, MeshCfg, MeshCollisionCfg from embodichain.data import get_data_path from embodichain.utils import logger -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg def initialize_simulation(args): diff --git a/examples/sim/motion/planners/curobo_planner.py b/examples/sim/motion/planners/curobo_planner.py index 3850769563..477f34eb47 100644 --- a/examples/sim/motion/planners/curobo_planner.py +++ b/examples/sim/motion/planners/curobo_planner.py @@ -199,10 +199,10 @@ def parse_args(argv: list[str] | None = None) -> argparse.Namespace: CuroboWorldCfg, ) import numpy as np -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) -from embodichain_robots import URRobotCfg, DexforceW1Cfg +from embodichain.extensions.robots import URRobotCfg, DexforceW1Cfg from embodichain.lab.sim.shapes import CubeCfg, MeshCfg __all__ = ["main"] diff --git a/examples/sim/motion/planners/neural_planner.py b/examples/sim/motion/planners/neural_planner.py index 58b443553b..1d62215cb5 100644 --- a/examples/sim/motion/planners/neural_planner.py +++ b/examples/sim/motion/planners/neural_planner.py @@ -84,7 +84,7 @@ def parse_args(argv: list[str] | None = None) -> argparse.Namespace: from embodichain.lab.visualization import visualization_cfg_from_args from embodichain.lab.sim.cfg import MarkerCfg, RenderCfg, physics_cfg_for_backend from embodichain.lab.sim.objects import Robot -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) from embodichain.lab.sim.motion.motion_generator import ( diff --git a/examples/sim/motion/solvers/fep_solver.py b/examples/sim/motion/solvers/fep_solver.py index f838dad28f..4f5a784ad9 100644 --- a/examples/sim/motion/solvers/fep_solver.py +++ b/examples/sim/motion/solvers/fep_solver.py @@ -69,7 +69,7 @@ def main() -> None: from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import RenderCfg, physics_cfg_for_backend - from embodichain_robots import FrankaPandaCfg + from embodichain.extensions.robots import FrankaPandaCfg from embodichain.lab.visualization import visualization_cfg_from_args from embodichain.lab.visualization.protocol import SceneOverlays, TrajectoryOverlay diff --git a/examples/sim/motion/solvers/neural_ik_solver.py b/examples/sim/motion/solvers/neural_ik_solver.py index 5efc0e7156..1af0b598ba 100644 --- a/examples/sim/motion/solvers/neural_ik_solver.py +++ b/examples/sim/motion/solvers/neural_ik_solver.py @@ -28,7 +28,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import MarkerCfg from embodichain.lab.sim.objects import Robot -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) from embodichain.lab.sim.motion.solvers import NeuralIKSolverCfg diff --git a/examples/sim/motion/solvers/opw_solver.py b/examples/sim/motion/solvers/opw_solver.py index f23938bb71..6f564aaff0 100644 --- a/examples/sim/motion/solvers/opw_solver.py +++ b/examples/sim/motion/solvers/opw_solver.py @@ -24,7 +24,7 @@ from IPython import embed from embodichain.lab.sim.objects import Robot -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import MarkerCfg from embodichain.lab.visualization import ( diff --git a/examples/sim/motion/solvers/srs_solver.py b/examples/sim/motion/solvers/srs_solver.py index 7083473125..6151b78067 100644 --- a/examples/sim/motion/solvers/srs_solver.py +++ b/examples/sim/motion/solvers/srs_solver.py @@ -25,7 +25,7 @@ from embodichain.lab.sim.objects import Robot from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.visualization import ( VisualizationCfg, add_viser_args_to_parser, diff --git a/examples/sim/motion/trajectory_velocity_tracking.py b/examples/sim/motion/trajectory_velocity_tracking.py index ce31cd170f..95926517cf 100644 --- a/examples/sim/motion/trajectory_velocity_tracking.py +++ b/examples/sim/motion/trajectory_velocity_tracking.py @@ -212,7 +212,7 @@ def parse_args(argv: list[str] | None = None) -> argparse.Namespace: from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import RenderCfg, physics_cfg_for_backend from embodichain.lab.sim.objects import Robot -from embodichain_robots import FrankaPandaCfg +from embodichain.extensions.robots import FrankaPandaCfg from embodichain.lab.visualization import visualization_cfg_from_args diff --git a/examples/sim/motion/workspace/_common.py b/examples/sim/motion/workspace/_common.py index f2dbd2b9e8..cf42381eea 100644 --- a/examples/sim/motion/workspace/_common.py +++ b/examples/sim/motion/workspace/_common.py @@ -32,7 +32,7 @@ add_viser_args_to_parser, visualization_cfg_from_args, ) -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg def parse_args(description: str, *, samples: int, device: str) -> argparse.Namespace: diff --git a/examples/sim/robot/dexforce_w1.py b/examples/sim/robot/dexforce_w1.py index 55b072b997..35d88b52d5 100644 --- a/examples/sim/robot/dexforce_w1.py +++ b/examples/sim/robot/dexforce_w1.py @@ -25,7 +25,7 @@ import numpy as np from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.visualization import ( VisualizationCfg, add_viser_args_to_parser, diff --git a/examples/sim/scene/scene_demo.py b/examples/sim/scene/scene_demo.py index d9fff65329..93dfd5aa8a 100644 --- a/examples/sim/scene/scene_demo.py +++ b/examples/sim/scene/scene_demo.py @@ -179,7 +179,7 @@ def main(args: argparse.Namespace | None = None) -> None: ) ) if args.scene == "factory": - from embodichain_robots.dexforce.w1.cfg import DexforceW1Cfg + from embodichain.extensions.robots.dexforce.w1.cfg import DexforceW1Cfg w1_robot: Robot = sim.add_robot( cfg=DexforceW1Cfg.from_dict( diff --git a/extensions/README.md b/extensions/README.md deleted file mode 100644 index 52cc431ceb..0000000000 --- a/extensions/README.md +++ /dev/null @@ -1,48 +0,0 @@ -# EmbodiChain extensions - -Official extension modules live here, separate from the core `embodichain/` -package. The directory name describes their role and leaves room for future -extension types. - -| Source directory | Python import | Responsibility | -| --- | --- | --- | -| `embodichain_tasks/` | `embodichain_tasks` | Official tasks, deployments, and reusable task components | -| `embodichain_robots/` | `embodichain_robots` | Concrete robot presets and the official robot catalog | -| `embodichain_benchmarks/` | `embodichain_benchmarks` | Evaluation suites, planner adapters, scoring policies, and reports | -| `embodichain_models/` | `embodichain_models` | Bundled model implementations | -| [embodichain_solvers/](embodichain_solvers/README.md) | `embodichain_solvers` | Optional concrete native-physics deployment adapters and their runnable quickstarts | - -Keep the `embodichain_` prefix on extension modules and Python packages. It -identifies their ecosystem outside this repository and avoids ambiguous -top-level imports such as `tasks` or `robots`. The parent `extensions/` -directory is only a source container, not a Python package or an import prefix. - -These modules currently ship in the main `embodichain` distribution, sharing -its version and dependencies. Install or refresh the editable mappings from -the repository root after moving or adding a module: - -```bash -pip install -e . --no-deps -``` - -New bundled extensions should use the nested layout -`extensions/embodichain_/embodichain_/__init__.py`. The root build -automatically includes these packages in the main distribution. The existing -flat layout, `extensions/embodichain_/__init__.py`, is also supported; -each extension must use exactly one layout. Package names must be valid Python -identifiers. The build rejects ambiguous and missing package roots. - -The root build applies shared resource rules to every discovered extension: -JSON, YAML and URDF files, `README.md`, `LICENSE` / `LICENSE.*`, -`THIRD_PARTY_LICENSES` and `preview.png`, including resources in subdirectories. -New models using these resource types need no per-model declaration in -`setup.py`. Other resource types require an explicit build-rule update. -The task configuration tree retains its separate installed-package mapping. -Runtime discovery entry points, when needed, are declared in `pyproject.toml`. -Including a package does not register it as a plugin. Extensions have no -separate build metadata. - -Official task references beginning with -`extensions/embodichain_tasks/configs/` work from a source checkout and an -installed wheel. The earlier `embodichain_tasks/configs/` prefix remains -supported by the configuration loader. diff --git a/extensions/embodichain_robots/_asset_catalog.py b/extensions/embodichain_robots/_asset_catalog.py deleted file mode 100644 index 6ea9d7bcd9..0000000000 --- a/extensions/embodichain_robots/_asset_catalog.py +++ /dev/null @@ -1,194 +0,0 @@ -# ---------------------------------------------------------------------------- -# Copyright (c) 2021-2026 DexForce Technology Co., Ltd. -# -# Licensed under the Apache License, Version 2.0 (the "License"); -# you may not use this file except in compliance with the License. -# You may obtain a copy of the License at -# -# http://www.apache.org/licenses/LICENSE-2.0 -# -# Unless required by applicable law or agreed to in writing, software -# distributed under the License is distributed on an "AS IS" BASIS, -# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -# See the License for the specific language governing permissions and -# limitations under the License. -# ---------------------------------------------------------------------------- - -"""Official robot and end-effector asset IDs; metadata only, with no implementation imports.""" - -from __future__ import annotations - -ROBOT_ASSETS = { - "AgibotG2": { - "class_path": "embodichain_robots.agibot.g2.assets:AgibotG2", - "category": "robot", - }, - "AgibotG1": { - "class_path": "embodichain_robots.agibot.g1.assets:AgibotG1", - "category": "robot", - }, - "YamI2rt": { - "class_path": "embodichain_robots.i2rt.yam.assets:YamI2rt", - "category": "robot", - }, - "UnitreeGo1Locomotion": { - "class_path": "embodichain_robots.unitree.go1.assets:UnitreeGo1Locomotion", - "category": "robot", - }, - "UnitreeGo2Locomotion": { - "class_path": "embodichain_robots.unitree.go2.assets:UnitreeGo2Locomotion", - "category": "robot", - }, - "UnitreeG1Locomotion": { - "class_path": "embodichain_robots.unitree.g1.assets:UnitreeG1Locomotion", - "category": "robot", - }, - "UnitreeH1_2Locomotion": { - "class_path": "embodichain_robots.unitree.h1_2.assets:UnitreeH1_2Locomotion", - "category": "robot", - }, - "ANYmalCLocomotion": { - "class_path": "embodichain_robots.anybotics.anymal_c.assets:ANYmalCLocomotion", - "category": "robot", - }, - "MicroDuckLocomotion": { - "class_path": "embodichain_robots.pollen_robotics.microduck.assets:MicroDuckLocomotion", - "category": "robot", - }, - "AgilexPiperX": { - "class_path": "embodichain_robots.agilex.piper_x.assets:AgilexPiperX", - "category": "robot", - }, - "CobotMagicArm": { - "class_path": "embodichain_robots.agilex.cobotmagic.assets:CobotMagicArm", - "category": "robot", - }, - "ARX5": { - "class_path": "embodichain_robots.arx.arx5.assets:ARX5", - "category": "robot", - }, - "AlohaMini": { - "class_path": "embodichain_robots.alohamini.aloha_mini.assets:AlohaMini", - "category": "robot", - }, - "TianjiMarvin": { - "class_path": "embodichain_robots.tianji.marvin.assets:TianjiMarvin", - "category": "robot", - }, - "FlexivRizon4S": { - "class_path": "embodichain_robots.flexiv.rizon4s.assets:FlexivRizon4S", - "category": "robot", - }, - "FrankaPandaArm": { - "class_path": "embodichain_robots.franka.assets:FrankaPandaArm", - "category": "robot", - }, - "Franka": { - "class_path": "embodichain_robots.franka.assets:Franka", - "category": "robot", - }, - "UniversalRobots": { - "class_path": "embodichain_robots.universal_robots.assets:UniversalRobots", - "category": "robot", - }, - "DexforceW1V021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1V021", - "category": "w1", - }, - "DexforceW1V022": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1V022", - "category": "w1", - }, - "DexforceW1V025": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1V025", - "category": "w1", - }, - "DexforceW1V030": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1V030", - "category": "w1", - }, - "DexforceW1ChassisV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1ChassisV021", - "category": "w1", - }, - "DexforceW1TorsoV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1TorsoV021", - "category": "w1", - }, - "DexforceW1EyesV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1EyesV021", - "category": "w1", - }, - "DexforceW1HeadV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1HeadV021", - "category": "w1", - }, - "DexforceW1LeftArmV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1LeftArmV021", - "category": "w1", - }, - "DexforceW1RightArmV021": { - "class_path": "embodichain_robots.dexforce.w1.assets:DexforceW1RightArmV021", - "category": "w1", - }, - "SO101FollowerAssets": { - "class_path": "embodichain_robots.the_robot_studio.so101.assets:SO101FollowerAssets", - "category": "robot", - }, - "DH_PGC_140_50": { - "class_path": "embodichain_robots.dh_robotics.pgc_140_50.assets:DH_PGC_140_50", - "category": "eef", - }, - "DH_PGC_140_50_M": { - "class_path": "embodichain_robots.dh_robotics.pgc_140_50.assets:DH_PGC_140_50_M", - "category": "eef", - }, - "DH_PGI_140_80": { - "class_path": "embodichain_robots.dh_robotics.pgi_140_80.assets:DH_PGI_140_80", - "category": "eef", - }, - "DH_AG95": { - "class_path": "embodichain_robots.dh_robotics.ag95.assets:DH_AG95", - "category": "eef", - }, - "ZH_CTM2F110": { - "class_path": "embodichain_robots.changingtek.ctm2f110.assets:ZH_CTM2F110", - "category": "eef", - }, - "BrainCoHandRevo1": { - "class_path": "embodichain_robots.brainco.revo1.assets:BrainCoHandRevo1", - "category": "eef", - }, - "InspireHand": { - "class_path": "embodichain_robots.inspire.hand.assets:InspireHand", - "category": "eef", - }, - "Robotiq": { - "class_path": "embodichain_robots.robotiq.assets:Robotiq", - "category": "eef", - }, - "Robotiq2F85": { - "class_path": "embodichain_robots.robotiq.robotiq_2f85.assets:Robotiq2F85", - "category": "eef", - }, - "WheelTecFA2F": { - "class_path": "embodichain_robots.wheeltec.fa2f.assets:WheelTecFA2F", - "category": "eef", - }, - "WujiHand": { - "class_path": "embodichain_robots.wuji.hand.assets:WujiHand", - "category": "eef", - }, - "SharpaWave": { - "class_path": "embodichain_robots.sharpa.wave.assets:SharpaWave", - "category": "eef", - }, - "AgxGripper": { - "class_path": "embodichain_robots.agilex.agx_gripper.assets:AgxGripper", - "category": "eef", - }, - "PikaGripper": { - "class_path": "embodichain_robots.agilex.pika.assets:PikaGripper", - "category": "eef", - }, -} diff --git a/pyproject.toml b/pyproject.toml index 76f049af65..765b8a1ff0 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,5 +1,5 @@ [build-system] -# setup.py supplies package discovery, source mappings and bundled resources. +# setup.py supplies package discovery and bundled resources. requires = ["setuptools>=61.0", "wheel"] build-backend = "setuptools.build_meta" @@ -94,17 +94,17 @@ gensim = [ embodichain = "embodichain.__main__:main" [project.entry-points."dexsim.newton_solvers"] -nerd = "embodichain_solvers.physics.nerd.provider:NeRDProvider" -worldparticle = "embodichain_solvers.physics.worldparticle.provider:WorldParticleProvider" +nerd = "embodichain.extensions.solvers.physics.nerd.provider:NeRDProvider" +worldparticle = "embodichain.extensions.solvers.physics.worldparticle.provider:WorldParticleProvider" [project.entry-points."embodichain.tasks"] -embodichain_tasks = "embodichain_tasks" +official_tasks = "embodichain.extensions.tasks" [project.entry-points."embodichain.robots"] -official = "embodichain_robots._catalog:ROBOT_CONFIGS" +official = "embodichain.extensions.robots._catalog:ROBOT_CONFIGS" [project.entry-points."embodichain.assets"] -official_robots = "embodichain_robots._asset_catalog:ROBOT_ASSETS" +official_robots = "embodichain.extensions.robots._asset_catalog:ROBOT_ASSETS" [tool.uv.sources] bpy = { index = "blender" } diff --git a/scripts/benchmark/assembly/precision.py b/scripts/benchmark/assembly/precision.py index f0aac1d442..a32caac1dd 100644 --- a/scripts/benchmark/assembly/precision.py +++ b/scripts/benchmark/assembly/precision.py @@ -35,7 +35,7 @@ import tempfile from embodichain.toolkits.assembly import AssemblyAsset, build_assembly -from embodichain_benchmarks.assembly.precision import ( +from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, compare_usd_geometry, run_passive_probe, @@ -464,7 +464,7 @@ def main() -> None: if probe == "passive": result = run_passive_probe(asset, cfg) else: - from embodichain_benchmarks.assembly.probes import ( + from embodichain.extensions.benchmarks.assembly.probes import ( ConstrainedProbeCfg, run_native_probe, run_reference_probe, diff --git a/scripts/benchmark/atomic_skill/BENCHMARK_STANDARD.md b/scripts/benchmark/atomic_skill/BENCHMARK_STANDARD.md index 3812fd82d1..531d016468 100644 --- a/scripts/benchmark/atomic_skill/BENCHMARK_STANDARD.md +++ b/scripts/benchmark/atomic_skill/BENCHMARK_STANDARD.md @@ -2,7 +2,7 @@ These benchmarks measure **skills**, not trajectories. Whether a plan is finite, stays inside the joint limits, avoids collisions, or is tracked faithfully by -the drive belongs to `extensions/embodichain_benchmarks/motion_generation/`. Those properties +the drive belongs to `embodichain/extensions/benchmarks/motion_generation/`. Those properties are reported here as diagnostic columns only; none of them fails a skill. A skill is measured along three dimensions. `robustness` and `adaptability` are diff --git a/scripts/benchmark/learning/rigidformer_index.py b/scripts/benchmark/learning/rigidformer_index.py index 6030fdecb4..ff23630c50 100644 --- a/scripts/benchmark/learning/rigidformer_index.py +++ b/scripts/benchmark/learning/rigidformer_index.py @@ -31,7 +31,9 @@ import time import tracemalloc from typing import Any -from embodichain_models.dynamics.rigidformer._native.data._index import _SceneWindows +from embodichain.extensions.models.dynamics.rigidformer._native.data._index import ( + _SceneWindows, +) def _build(scenes: int, compact: bool) -> Any: diff --git a/scripts/benchmark/motion/observed_batch.py b/scripts/benchmark/motion/observed_batch.py index 0f54194b7d..4ff068ae9c 100644 --- a/scripts/benchmark/motion/observed_batch.py +++ b/scripts/benchmark/motion/observed_batch.py @@ -42,7 +42,7 @@ from embodichain.lab.sim.cfg import RigidBodyPhysicsCfg from embodichain.lab.sim.objects import RigidObjectCfg from embodichain.lab.sim.shapes import CubeCfg -from embodichain_robots import FrankaPandaCfg +from embodichain.extensions.robots import FrankaPandaCfg from embodichain.lab.sim.motion.motion_generator import MotionGenOptions from embodichain.lab.sim.motion.planners.utils import PlanState from embodichain.lab.sim.motion.planners.curobo.curobo_planner import ( diff --git a/scripts/benchmark/motion_generation/README.md b/scripts/benchmark/motion_generation/README.md index 4642220063..4e418daf58 100644 --- a/scripts/benchmark/motion_generation/README.md +++ b/scripts/benchmark/motion_generation/README.md @@ -1,7 +1,7 @@ # Motion Generation Benchmark The installable implementation and usage guide live in -[`embodichain_benchmarks.motion_generation`](../../../extensions/embodichain_benchmarks/motion_generation/README.md). +[`embodichain.extensions.benchmarks.motion_generation`](../../../embodichain/extensions/benchmarks/motion_generation/README.md). Run `embodichain benchmark motion-generation --help` or `python -m scripts.benchmark.motion_generation.run_benchmark --help`. diff --git a/scripts/benchmark/motion_generation/run_benchmark.py b/scripts/benchmark/motion_generation/run_benchmark.py index df796b65d5..9ff8ecfc08 100644 --- a/scripts/benchmark/motion_generation/run_benchmark.py +++ b/scripts/benchmark/motion_generation/run_benchmark.py @@ -18,7 +18,7 @@ from __future__ import annotations -from embodichain_benchmarks.motion_generation.cli import ( +from embodichain.extensions.benchmarks.motion_generation.cli import ( add_parser_arguments, main, run_all_benchmarks, diff --git a/scripts/benchmark/rendering/native_object_batches.py b/scripts/benchmark/rendering/native_object_batches.py index 4d5357b444..afdb8c87d4 100644 --- a/scripts/benchmark/rendering/native_object_batches.py +++ b/scripts/benchmark/rendering/native_object_batches.py @@ -457,11 +457,16 @@ def run_all_benchmarks() -> None: "--order", args.order, ] - source_paths = [source, source / "extensions"] + sorted( - path - for path in (source / "extensions").iterdir() - if (path / path.name / "__init__.py").is_file() - ) + source_paths = [source] + # Baseline revisions can predate the move into the main package. + extension_container = source / "extensions" + if extension_container.is_dir(): + source_paths.append(extension_container) + source_paths.extend( + path + for path in sorted(extension_container.iterdir()) + if (path / path.name / "__init__.py").is_file() + ) with log.open("w") as stream: completed = subprocess.run( command, diff --git a/scripts/benchmark/rl/locomotion_ppo.py b/scripts/benchmark/rl/locomotion_ppo.py index e7987c0588..56146360a9 100644 --- a/scripts/benchmark/rl/locomotion_ppo.py +++ b/scripts/benchmark/rl/locomotion_ppo.py @@ -35,7 +35,7 @@ } TASK_DIR = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/tasks/locomotion/velocity/g1_flat" + / "embodichain/extensions/tasks/configs/tasks/locomotion/velocity/g1_flat" ) diff --git a/scripts/benchmark/rl/tasks/cart_pole.yaml b/scripts/benchmark/rl/tasks/cart_pole.yaml index 8ddd615403..d91cffdbcd 100644 --- a/scripts/benchmark/rl/tasks/cart_pole.yaml +++ b/scripts/benchmark/rl/tasks/cart_pole.yaml @@ -3,7 +3,7 @@ env_id: CartPoleRL success_threshold: 0.8 base_config: trainer: - gym_config: extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json + gym_config: embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json exp_name: cart_pole device: cpu headless: true diff --git a/scripts/benchmark/rl/tasks/push_cube.yaml b/scripts/benchmark/rl/tasks/push_cube.yaml index 0a649a7ded..cf89a187ad 100644 --- a/scripts/benchmark/rl/tasks/push_cube.yaml +++ b/scripts/benchmark/rl/tasks/push_cube.yaml @@ -4,7 +4,7 @@ success_threshold: 0.6 train_eval_enabled: false base_config: trainer: - gym_config: extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json + gym_config: embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json exp_name: push_cube device: cpu headless: true diff --git a/scripts/benchmark/robotics/cobotmagic_drives.py b/scripts/benchmark/robotics/cobotmagic_drives.py index c7da8623fc..67c45e8374 100644 --- a/scripts/benchmark/robotics/cobotmagic_drives.py +++ b/scripts/benchmark/robotics/cobotmagic_drives.py @@ -838,7 +838,7 @@ def run_all_benchmarks(output: Path, profiles: list[str]) -> None: from embodichain.data import get_data_path from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import DefaultPhysicsCfg, RenderCfg - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg audit = _audit_urdf( Path(get_data_path("CobotMagicArm/CobotMagicWithGripperV100.urdf")) diff --git a/scripts/benchmark/robotics/kinematic_solver/agibot_g2.py b/scripts/benchmark/robotics/kinematic_solver/agibot_g2.py index 56dc6124cc..988db6ad77 100644 --- a/scripts/benchmark/robotics/kinematic_solver/agibot_g2.py +++ b/scripts/benchmark/robotics/kinematic_solver/agibot_g2.py @@ -36,7 +36,7 @@ import warp as wp from embodichain.lab.sim.motion.solvers import PytorchSolverCfg, SSIKSolverCfg -from embodichain_robots import AgibotG2Cfg +from embodichain.extensions.robots import AgibotG2Cfg __all__ = [] diff --git a/scripts/benchmark/robotics/kinematic_solver/run_benchmark.py b/scripts/benchmark/robotics/kinematic_solver/run_benchmark.py index ec46e286bd..f70dcc4869 100644 --- a/scripts/benchmark/robotics/kinematic_solver/run_benchmark.py +++ b/scripts/benchmark/robotics/kinematic_solver/run_benchmark.py @@ -1188,7 +1188,7 @@ def benchmark_franka_solver_comparison() -> ( """Compare Franka's default FEP and former Pytorch solver on shared inputs.""" from scipy.spatial.transform import Rotation - from embodichain_robots.franka.panda import FrankaPandaCfg + from embodichain.extensions.robots.franka.panda import FrankaPandaCfg perf_rows: list[dict[str, object]] = [] metric_rows: list[dict[str, object]] = [] diff --git a/scripts/benchmark/robotics/kinematic_solver/srs_solver.py b/scripts/benchmark/robotics/kinematic_solver/srs_solver.py index 9ace1509b1..976de736c0 100644 --- a/scripts/benchmark/robotics/kinematic_solver/srs_solver.py +++ b/scripts/benchmark/robotics/kinematic_solver/srs_solver.py @@ -37,8 +37,8 @@ import torch from embodichain.data import get_data_path -from embodichain_robots.dexforce.w1.params import W1ArmKineParams -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.params import W1ArmKineParams +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1Version, ) diff --git a/scripts/benchmark/robotics/kinematic_solver/ssik_benchmark.py b/scripts/benchmark/robotics/kinematic_solver/ssik_benchmark.py index 0c4e6cd78e..6306391f66 100644 --- a/scripts/benchmark/robotics/kinematic_solver/ssik_benchmark.py +++ b/scripts/benchmark/robotics/kinematic_solver/ssik_benchmark.py @@ -115,7 +115,7 @@ def fk(self, qpos: torch.Tensor) -> torch.Tensor: def _load_model(name: str) -> _Model: - from embodichain_robots import ( + from embodichain.extensions.robots import ( AlohaMiniCfg, ARX5Cfg, FlexivRizon4SCfg, @@ -1019,7 +1019,7 @@ def _versions() -> dict[str, Any]: bool(status.stdout.strip()) if status.returncode == 0 else None ) result["preset_modules"] = {} - from embodichain_robots import ( + from embodichain.extensions.robots import ( AlohaMiniCfg, ARX5Cfg, FlexivRizon4SCfg, diff --git a/scripts/benchmark/sensors/contact_loss.md b/scripts/benchmark/sensors/contact_loss.md index 448413245f..631cc110ab 100644 --- a/scripts/benchmark/sensors/contact_loss.md +++ b/scripts/benchmark/sensors/contact_loss.md @@ -60,11 +60,11 @@ simulator FPS claim is made. ## Reproduce ```bash -PYTHONPATH="$PWD:$PWD/extensions:$PWD/extensions/embodichain_tasks:$PWD/extensions/embodichain_models" \ +PYTHONPATH="$PWD" \ python -m scripts.benchmark.sensors.contact_loss --device cpu --output /tmp/contact-loss-cpu.json CUDA_VISIBLE_DEVICES=4 \ -PYTHONPATH="$PWD:$PWD/extensions:$PWD/extensions/embodichain_tasks:$PWD/extensions/embodichain_models" \ +PYTHONPATH="$PWD" \ python -m scripts.benchmark.sensors.contact_loss --device cuda:0 --output /tmp/contact-loss-cuda.json ``` diff --git a/scripts/benchmark/workspace_analyzer/benchmark_robot_workspace.py b/scripts/benchmark/workspace_analyzer/benchmark_robot_workspace.py index 795cb89df7..9818f30526 100644 --- a/scripts/benchmark/workspace_analyzer/benchmark_robot_workspace.py +++ b/scripts/benchmark/workspace_analyzer/benchmark_robot_workspace.py @@ -40,7 +40,7 @@ import warp as wp from embodichain.lab.sim.objects.robot import Robot -from embodichain_robots import CobotMagicCfg, URRobotCfg +from embodichain.extensions.robots import CobotMagicCfg, URRobotCfg from embodichain.lab.sim.motion.workspace.analyzer import ( AnalysisMode, WorkspaceAnalyzer, diff --git a/scripts/ci/pytest_no_finalize.py b/scripts/ci/pytest_no_finalize.py index f01d4be899..7a096cf2ed 100644 --- a/scripts/ci/pytest_no_finalize.py +++ b/scripts/ci/pytest_no_finalize.py @@ -60,10 +60,10 @@ def _domain_loaded(root: Path) -> bool: domain_roots = { "dexsim", "embodichain", - "embodichain_tasks", - "embodichain_robots", - "embodichain_models", - "embodichain_benchmarks", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + "embodichain.extensions.models", + "embodichain.extensions.benchmarks", } test_prefix = str(root / "tests") + os.sep return any( diff --git a/scripts/ci/select_tests.py b/scripts/ci/select_tests.py index 0adeecd004..8461032a43 100644 --- a/scripts/ci/select_tests.py +++ b/scripts/ci/select_tests.py @@ -52,7 +52,7 @@ DEFAULT_MAP = "agent_context/MAP.yaml" TEST_ROOT = "tests" _GLOB_CHARS = "*?[" -_SOURCE_ROOTS = ("embodichain", "extensions", "scripts", "examples", "tests") +_SOURCE_ROOTS = ("embodichain", "scripts", "examples", "tests") _DOC_PATTERNS = ( "docs/**", "docs/scripts/**", @@ -645,7 +645,7 @@ def _content_risk(changed: Sequence[ChangedPath], diff_text: str | None = None) path = _normalize_path(path_value) if path.endswith("/__init__.py") or path in { "embodichain/__init__.py", - "extensions/embodichain_tasks/embodichain_tasks/__init__.py", + "embodichain/extensions/tasks/__init__.py", }: risk = "high" return risk diff --git a/scripts/tools/rl/visualize_point_mass.py b/scripts/tools/rl/visualize_point_mass.py index 84d8439f6b..44baf4da31 100644 --- a/scripts/tools/rl/visualize_point_mass.py +++ b/scripts/tools/rl/visualize_point_mass.py @@ -37,7 +37,7 @@ from embodichain.learning.models import build_mlp_from_cfg from embodichain.utils.logger import log_info from embodichain.utils.utility import load_config -from embodichain_tasks.classic_control.point_mass import PointMassEnv +from embodichain.extensions.tasks.classic_control.point_mass import PointMassEnv @dataclass(frozen=True) diff --git a/scripts/tutorials/atomic_skill/README.md b/scripts/tutorials/atomic_skill/README.md index bf65fb49f2..3af0fccc2c 100644 --- a/scripts/tutorials/atomic_skill/README.md +++ b/scripts/tutorials/atomic_skill/README.md @@ -117,7 +117,7 @@ Pika 的张开指令为正向移动的米制坐标,DH_AG95 为带 mimic 的转 ARX5 使用 50 mm 高的工作台、向外展开的肘部和不翻转的腕部逆解分支, 初始姿态和自碰撞设置继承扩展包的 -[`ARX5Cfg`](../../../extensions/embodichain_robots/arx/arx5/cfg.py)。台面、目标和该场景的 +[`ARX5Cfg`](../../../embodichain/extensions/robots/arx/arx5/cfg.py)。台面、目标和该场景的 IK 分支范围仍由示例配置管理。旧的高工作台与折叠腕部组合会让腕部网格与前臂相交。 调整位于物理配置层,PickUp → Place 的调用、抬升距离与物体目标定义保持一致。 diff --git a/scripts/tutorials/atomic_skill/embodiment_switching.py b/scripts/tutorials/atomic_skill/embodiment_switching.py index 114885dbcd..3d8f78f215 100644 --- a/scripts/tutorials/atomic_skill/embodiment_switching.py +++ b/scripts/tutorials/atomic_skill/embodiment_switching.py @@ -26,9 +26,8 @@ from pathlib import Path _REPO_ROOT = Path(__file__).resolve().parents[3] -for _source in (_REPO_ROOT, _REPO_ROOT / "extensions"): - if str(_source) not in sys.path: - sys.path.insert(0, str(_source)) +if str(_REPO_ROOT) not in sys.path: + sys.path.insert(0, str(_REPO_ROOT)) import torch from embodichain.utils import logger, set_seed diff --git a/scripts/tutorials/gym/modular_env.py b/scripts/tutorials/gym/modular_env.py index a73c6ce36e..83761c2e7e 100644 --- a/scripts/tutorials/gym/modular_env.py +++ b/scripts/tutorials/gym/modular_env.py @@ -55,7 +55,7 @@ def build_parser() -> argparse.ArgumentParser: ) from embodichain.lab.gym.envs import EmbodiedEnv, EmbodiedEnvCfg from embodichain.lab.gym.utils.registration import register_env -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.sim.sensors import StereoCameraCfg, SensorCfg from embodichain.lab.sim.shapes import MeshCfg from embodichain.lab.sim.cfg import ( diff --git a/scripts/tutorials/gym/simple_task_program.py b/scripts/tutorials/gym/simple_task_program.py index e373305da7..6cd7de9a38 100644 --- a/scripts/tutorials/gym/simple_task_program.py +++ b/scripts/tutorials/gym/simple_task_program.py @@ -101,7 +101,7 @@ def build_parser() -> argparse.ArgumentParser: SkillPolicyPreset, ) from embodichain.lab.visualization import visualization_cfg_from_args -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg _CALL_ID = "tutorial.move_end_effector" _RETURN_TOLERANCE = 0.02 # Metres; this tutorial does not tune the arm's controller. diff --git a/scripts/tutorials/scene/_robot_workspace_scene.py b/scripts/tutorials/scene/_robot_workspace_scene.py index 8f5d64edc6..f9d4c09caf 100644 --- a/scripts/tutorials/scene/_robot_workspace_scene.py +++ b/scripts/tutorials/scene/_robot_workspace_scene.py @@ -91,10 +91,10 @@ class _Candidate: def _embodiment() -> dict[str, Any]: - # Importing embodichain_tasks auto-registers Gym environments. Resolve the + # Importing embodichain.extensions.tasks auto-registers Gym environments. Resolve the # physical resource through the core path helper instead, including wheels. path = resolve_config_path( - "extensions/embodichain_tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml", + "embodichain/extensions/tasks/configs/components/embodiments/ur5_dh_pgi_140_80.yaml", base_dir=Path(__file__).parent, ) from embodichain.lab.gym.utils.composition import resolve_gym_components diff --git a/scripts/tutorials/scene/_robot_workspace_task.py b/scripts/tutorials/scene/_robot_workspace_task.py index 3f28ed24b1..b8e754119a 100644 --- a/scripts/tutorials/scene/_robot_workspace_task.py +++ b/scripts/tutorials/scene/_robot_workspace_task.py @@ -191,7 +191,7 @@ def step(self, action: Any) -> tuple[Any, ...]: def _task_config(display: Any) -> tuple[Any, Any]: path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml", + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml", base_dir=Path(__file__).parent, ) cfg = config_to_cfg(load_config(path), source_path=path) diff --git a/scripts/tutorials/sim/export_usd.py b/scripts/tutorials/sim/export_usd.py index eda3f21557..45f4a49695 100644 --- a/scripts/tutorials/sim/export_usd.py +++ b/scripts/tutorials/sim/export_usd.py @@ -66,7 +66,7 @@ def parse_arguments(argv: list[str] | None = None) -> argparse.Namespace: from embodichain.data import get_data_path from embodichain.utils import logger -from embodichain_robots.dexforce.w1.cfg import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1.cfg import DexforceW1Cfg def initialize_simulation(args) -> SimulationManager: diff --git a/scripts/tutorials/sim/motion_generator.py b/scripts/tutorials/sim/motion_generator.py index aa0932a15c..df1ab3b779 100644 --- a/scripts/tutorials/sim/motion_generator.py +++ b/scripts/tutorials/sim/motion_generator.py @@ -91,7 +91,7 @@ def parse_args(argv: list[str] | None = None) -> argparse.Namespace: ToppraPlannerCfg, ) from embodichain.lab.sim.motion.planners.utils import TrajectorySampleMethod -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg RECORD_WIDTH = 1920 RECORD_HEIGHT = 1080 diff --git a/scripts/tutorials/sim/open_drawer.py b/scripts/tutorials/sim/open_drawer.py index ae57563cdb..e82e48e9ee 100644 --- a/scripts/tutorials/sim/open_drawer.py +++ b/scripts/tutorials/sim/open_drawer.py @@ -96,7 +96,7 @@ def build_parser() -> argparse.ArgumentParser: ToppraPlanOptions, TrajectorySampleMethod, ) -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) from embodichain.lab.visualization import visualization_cfg_from_args diff --git a/scripts/tutorials/sim/planner/manipulability_augmentation_plot.py b/scripts/tutorials/sim/planner/manipulability_augmentation_plot.py index 17ef09d24b..2aa04b9e5a 100644 --- a/scripts/tutorials/sim/planner/manipulability_augmentation_plot.py +++ b/scripts/tutorials/sim/planner/manipulability_augmentation_plot.py @@ -69,7 +69,7 @@ describe_manipulability, manipulability_guided_residual, ) -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.utils import logger DEFAULT_OUTPUT = Path("docs/source/_static/tutorials/manipulability_augmentation.png") diff --git a/scripts/tutorials/sim/planner/trapezoidal_planner.py b/scripts/tutorials/sim/planner/trapezoidal_planner.py index 159efade2c..ce0120b14f 100644 --- a/scripts/tutorials/sim/planner/trapezoidal_planner.py +++ b/scripts/tutorials/sim/planner/trapezoidal_planner.py @@ -51,7 +51,7 @@ plan_cartesian_path, compute_eef_trajectory, ) -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.cfg import MarkerCfg, physics_cfg_for_backend from embodichain.lab.visualization import visualization_cfg_from_args from embodichain.utils.math import euler_xyz_from_quat diff --git a/scripts/tutorials/sim/simple_newton_solver/README.md b/scripts/tutorials/sim/simple_newton_solver/README.md index 6e43cc3610..46290eeb60 100644 --- a/scripts/tutorials/sim/simple_newton_solver/README.md +++ b/scripts/tutorials/sim/simple_newton_solver/README.md @@ -25,7 +25,7 @@ without reinstalling its editable package or SDK: ```bash conda activate open -export PYTHONPATH="$PWD:$PWD/extensions${PYTHONPATH:+:$PYTHONPATH}" +export PYTHONPATH="$PWD${PYTHONPATH:+:$PYTHONPATH}" python scripts/tutorials/sim/simple_newton_solver/demo.py --device cpu python scripts/tutorials/sim/simple_newton_solver/demo.py --device cuda:0 python scripts/tutorials/sim/simple_newton_solver/demo.py --device cpu \ diff --git a/scripts/tutorials/sim/srs_solver.py b/scripts/tutorials/sim/srs_solver.py index ab75f99363..e2fc306a98 100644 --- a/scripts/tutorials/sim/srs_solver.py +++ b/scripts/tutorials/sim/srs_solver.py @@ -29,7 +29,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import MarkerCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots import DexforceW1Cfg +from embodichain.extensions.robots import DexforceW1Cfg from embodichain.lab.visualization import ( VisualizationCfg, add_viser_args_to_parser, diff --git a/scripts/tutorials/sim/workspace_manipulability_visualization.py b/scripts/tutorials/sim/workspace_manipulability_visualization.py index 18fa6e45aa..9665c444c6 100644 --- a/scripts/tutorials/sim/workspace_manipulability_visualization.py +++ b/scripts/tutorials/sim/workspace_manipulability_visualization.py @@ -79,7 +79,7 @@ select_inspection_indices, ) from embodichain.lab.sim.objects.robot import Robot -from embodichain_robots import CobotMagicCfg, URRobotCfg +from embodichain.extensions.robots import CobotMagicCfg, URRobotCfg from embodichain.utils import logger from embodichain.utils.utility import reset_all_seeds diff --git a/setup.py b/setup.py index d2b5b24d76..7c47b5d73c 100644 --- a/setup.py +++ b/setup.py @@ -27,7 +27,6 @@ __all__ = [ "get_example_data_files", "get_package_data", - "get_package_dir", "get_packages", "get_version", ] @@ -36,8 +35,7 @@ logger = logging.getLogger() THIS_DIR = Path(__file__).resolve().parent -CORE_PACKAGE_PATTERNS = ["embodichain", "embodichain.*"] -EXTENSIONS_DIR = THIS_DIR / "extensions" +PACKAGE_PATTERNS = ["embodichain", "embodichain.*"] EXAMPLES_DIR = THIS_DIR / "examples" @@ -56,7 +54,6 @@ def run(self): "build", "dist", "embodichain.egg-info", - "extensions/embodichain_tasks/embodichain_tasks.egg-info", ]: rm_path = THIS_DIR / d if not rm_path.exists(): @@ -80,77 +77,19 @@ def run(self): logger.info(f"removed '{rm_path}'") -def _extension_package_dirs() -> dict[str, Path]: - """Discover bundled extension roots in flat or nested layouts.""" - packages = {} - for project in sorted(EXTENSIONS_DIR.glob("embodichain_*")): - if not project.is_dir(): - continue - name = project.name - if not name.isidentifier(): - raise ValueError(f"Invalid extension package name: {name}") - nested = project / name - flat_package = (project / "__init__.py").is_file() - nested_package = (nested / "__init__.py").is_file() - if flat_package == nested_package: - raise ValueError(f"Expected exactly one package layout for {project}") - packages[name] = project if flat_package else nested - return packages - - def get_packages() -> list[str]: """Return core and bundled extension packages shipped in the main wheel.""" - core_packages = find_namespace_packages( - where=str(THIS_DIR), include=CORE_PACKAGE_PATTERNS - ) - extension_packages = [] - for name, package_dir in _extension_package_dirs().items(): - extension_packages.extend( - find_namespace_packages( - where=str(package_dir.parent), include=[name, f"{name}.*"] - ) - ) return sorted( - set( - [ - *core_packages, - *extension_packages, - "embodichain_tasks.configs", - ] - ) + find_namespace_packages(where=str(THIS_DIR), include=PACKAGE_PATTERNS) ) -def get_package_dir() -> dict[str, str]: - """Map bundled extension sources to their stable Python package names.""" - return { - **{ - name: path.relative_to(THIS_DIR).as_posix() - for name, path in _extension_package_dirs().items() - }, - "embodichain_tasks.configs": "extensions/embodichain_tasks/configs", - } - - def get_package_data() -> dict[str, list[str]]: - """Collect core resources and shared rules for discovered extension roots. + """Collect resource patterns for core and bundled extensions. Returns: - Resource patterns keyed by installed package name. Extension resources - use the same rules for flat and nested layouts; task configurations - retain their separate source-directory mapping. + Resource patterns keyed by installed package name. """ - extension_patterns = [ - "**/*.json", - "**/*.yaml", - "**/*.yml", - "**/*.urdf", - "**/README.md", - "**/LICENSE", - "**/LICENSE.*", - "**/THIRD_PARTY_LICENSES", - "**/preview.png", - ] return { "embodichain": ["VERSION"], "embodichain.data": ["default_materials.json"], @@ -169,13 +108,17 @@ def get_package_data() -> dict[str, list[str]]: "_graph_react.LICENSE.txt", "_graph_assets/*", ], - **{name: list(extension_patterns) for name in _extension_package_dirs()}, - "embodichain_tasks.configs": [ - "tasks/manipulation/cloth_fold/task_program/trajectory.npz", + "embodichain.extensions": [ + "tasks/configs/tasks/manipulation/cloth_fold/task_program/trajectory.npz", "**/*.json", "**/*.yaml", "**/*.yml", + "**/*.urdf", "**/README.md", + "**/LICENSE", + "**/LICENSE.*", + "**/THIRD_PARTY_LICENSES", + "**/preview.png", ], } @@ -228,7 +171,6 @@ def main() -> None: author="EmbodiChain Developers", description="An end-to-end, GPU-accelerated, and modular platform for building generalized Embodied Intelligence.", packages=get_packages(), - package_dir=get_package_dir(), package_data=get_package_data(), data_files=get_example_data_files(), cmdclass={"clean": CleanCommand}, diff --git a/tests/benchmark/assembly/test_precision.py b/tests/benchmark/assembly/test_precision.py index 2ec5d867fe..7245b58871 100644 --- a/tests/benchmark/assembly/test_precision.py +++ b/tests/benchmark/assembly/test_precision.py @@ -40,7 +40,9 @@ def test_usd_precision_detects_changed_primitive_dimensions(tmp_path) -> None: # the portable exporter authors a stage, independent of collection order. pytest.importorskip("dexsim.kit.usd") from pxr import Usd, UsdGeom - from embodichain_benchmarks.assembly.precision import compare_usd_geometry + from embodichain.extensions.benchmarks.assembly.precision import ( + compare_usd_geometry, + ) asset = import_mjcf(SOURCE) path = asset.write_usd(tmp_path / "wrong_radius.usda") @@ -60,7 +62,7 @@ def test_precision_host_matches_source_floor_and_disables_missing_floor( source_contact: bool, ) -> None: pytest.importorskip("mujoco") - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, _source_floor_attributes, ) @@ -93,7 +95,7 @@ def test_precision_host_matches_source_floor_and_disables_missing_floor( @pytest.mark.parametrize("backend", ["unknown", "fake"]) def test_invalid_probe_backend_is_not_reported_as_skipped(backend) -> None: - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, run_passive_probe, ) @@ -107,7 +109,10 @@ def test_peg_drop_distinguishes_seating_from_rim_and_outside_falls( scale: float, bottom: float ) -> None: """A tiny penetration after the spawn gap must not become drop success.""" - from embodichain_benchmarks.assembly.precision import PrecisionRunCfg, _score + from embodichain.extensions.benchmarks.assembly.precision import ( + PrecisionRunCfg, + _score, + ) # Pinned peg() defaults: 10 mm plate, 30 mm insertion section, 5 mm # spawn gap. The blind-hole bottom and all dimensions scale together. @@ -179,7 +184,7 @@ def test_usd_comparison_registers_schemas_in_a_fresh_process(tmp_path: Path) -> import json import sys from embodichain.toolkits.assembly import AssemblyAsset -from embodichain_benchmarks.assembly.precision import compare_usd_geometry +from embodichain.extensions.benchmarks.assembly.precision import compare_usd_geometry result = compare_usd_geometry(AssemblyAsset.load(sys.argv[1]), sys.argv[2]) assert result['passed'], result print('FRESH_USD_COMPARISON_PASSED') @@ -320,7 +325,9 @@ def test_many_pegs_scores_each_translated_cell_and_rejects_rim_or_floor_passage( None ): """Heterogeneous cells cannot use one global plate position or thickness.""" - from embodichain_benchmarks.assembly._many_metrics import _score_many_pegs + from embodichain.extensions.benchmarks.assembly._many_metrics import ( + _score_many_pegs, + ) cells = [ ([-0.3, 0.3, 0.005], 0.01, 0.03), @@ -410,7 +417,7 @@ def test_many_pegs_scores_each_translated_cell_and_rejects_rim_or_floor_passage( def test_precision_solver_comparisons_reject_ignored_or_unsupported_settings( settings, message ) -> None: - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, run_passive_probe, ) @@ -434,7 +441,10 @@ def test_precision_reference_preserves_source_options_unless_explicitly_overridd ) -> None: """Unspecified calibration knobs must not rewrite the recorded source baseline.""" mujoco = pytest.importorskip("mujoco") - from embodichain_benchmarks.assembly.precision import PrecisionRunCfg, _run_mujoco + from embodichain.extensions.benchmarks.assembly.precision import ( + PrecisionRunCfg, + _run_mujoco, + ) flag = "enable" if source_multiccd else "disable" source = SOURCE.replace( @@ -462,7 +472,7 @@ def inspect(model, data, step): def test_failed_precision_measurements_preserve_json_and_failure_reason( monkeypatch, ) -> None: - from embodichain_benchmarks.assembly import precision + from embodichain.extensions.benchmarks.assembly import precision # Real sub-micron meshes can fail backend cooking; the matrix must retain # that diagnostic instead of terminating without a result file. @@ -496,7 +506,7 @@ def nonfinite(*args): def test_newton_family_routes_the_full_source_or_explicit_mujoco_profile( family, override ): - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, _newton_solver_config, ) @@ -560,7 +570,7 @@ def test_dexuni_missing_or_mismatched_dispatch_cannot_masquerade_as_a_profile( active, features, error ): from types import SimpleNamespace - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, _native_solver_metadata, ) @@ -579,7 +589,7 @@ def test_dexuni_missing_or_mismatched_dispatch_cannot_masquerade_as_a_profile( def test_dexuni_metadata_reports_actual_dispatch_and_keeps_the_algorithm_separate(): from types import SimpleNamespace - from embodichain_benchmarks.assembly.precision import ( + from embodichain.extensions.benchmarks.assembly.precision import ( PrecisionRunCfg, _native_solver_metadata, ) @@ -684,7 +694,10 @@ def worker(command, **kwargs): "scale,starts,advance", [(0.5, 1, 0.00075), (2.0, 1, 0.003), (2.0, 3, 0.009)] ) def test_thread_lead_oracle_uses_physical_scaled_pitch(scale, starts, advance): - from embodichain_benchmarks.assembly.precision import PrecisionRunCfg, _score + from embodichain.extensions.benchmarks.assembly.precision import ( + PrecisionRunCfg, + _score, + ) asset = AssemblyAsset( config={"kind": "thread", "pitch": 0.0015, "scale": scale, "n_starts": starts} diff --git a/tests/benchmark/assembly/test_probes.py b/tests/benchmark/assembly/test_probes.py index d2bfd0c552..609b009a0b 100644 --- a/tests/benchmark/assembly/test_probes.py +++ b/tests/benchmark/assembly/test_probes.py @@ -23,7 +23,7 @@ import pytest from embodichain.toolkits.assembly import import_mjcf -from embodichain_benchmarks.assembly.probes import ( +from embodichain.extensions.benchmarks.assembly.probes import ( AnalyticPegGeometry, ConstrainedProbeCfg, prepare_probe, @@ -129,7 +129,9 @@ def test_constrained_probe_integrates_without_pose_drives_and_retains_joint_expo ], ) def test_quasistatic_acceptance_rejects_oscillation_or_drift_with_zero_median(errors): - from embodichain_benchmarks.assembly.probes import _settled_error_statistics + from embodichain.extensions.benchmarks.assembly.probes import ( + _settled_error_statistics, + ) statistics = _settled_error_statistics(errors, 5e-6) assert statistics["wall_error_m"] == pytest.approx(0.0) @@ -142,7 +144,9 @@ def test_quasistatic_acceptance_rejects_oscillation_or_drift_with_zero_median(er def test_initial_overlap_only_counts_penetrating_plate_peg_contacts(): - from embodichain_benchmarks.assembly.probes import _contact_overlap_worlds + from embodichain.extensions.benchmarks.assembly.probes import ( + _contact_overlap_worlds, + ) # World0 has a separated plate/peg pair and an unrelated overlap; # world1 has one real plate/peg overlap; world2 starts with no contacts. @@ -189,7 +193,7 @@ def test_mjfit_nested_default_contact_profile_is_retained_on_analytic_probe_peg( def test_native_constrained_probe_rejects_newton_selection_on_default_before_preparation(): from embodichain.toolkits.assembly import AssemblyAsset - from embodichain_benchmarks.assembly.probes import run_native_probe + from embodichain.extensions.benchmarks.assembly.probes import run_native_probe with pytest.raises(ValueError, match="requires backend='newton'"): run_native_probe( @@ -220,7 +224,7 @@ def test_native_solver_family_retains_colliders_and_seats_a_peg(tmp_path, family import json, sys from pathlib import Path from embodichain.toolkits.assembly import AssemblyAsset -from embodichain_benchmarks.assembly.precision import PrecisionRunCfg, run_passive_probe +from embodichain.extensions.benchmarks.assembly.precision import PrecisionRunCfg, run_passive_probe asset = AssemblyAsset.load(sys.argv[1]) result = run_passive_probe(asset, PrecisionRunCfg( backend='newton', newton_solver=sys.argv[3], duration=.2, work_dir=sys.argv[4])) @@ -296,7 +300,7 @@ def test_s2_circle_retains_ten_micrometre_budget_at_every_integration_step( import json,sys from pathlib import Path from embodichain.toolkits.assembly import import_mjcf -from embodichain_benchmarks.assembly.probes import ConstrainedProbeCfg,run_native_probe +from embodichain.extensions.benchmarks.assembly.probes import ConstrainedProbeCfg,run_native_probe asset = import_mjcf(Path(sys.argv[1]).read_text(), config={ 'kind':'peg','hole':{'type':'circle','radius':.008,'n':32}, 'clearance':.0001,'plate_thickness':.01,'peg_length':.03}) diff --git a/tests/benchmark/motion_generation/test_api.py b/tests/benchmark/motion_generation/test_api.py index e4a2b19fb5..76eaa2167f 100644 --- a/tests/benchmark/motion_generation/test_api.py +++ b/tests/benchmark/motion_generation/test_api.py @@ -26,7 +26,7 @@ import pytest import torch import yaml -from embodichain_benchmarks.motion_generation import ( +from embodichain.extensions.benchmarks.motion_generation import ( BenchmarkCase, PlannerAdapter, PlannerSpecCfg, @@ -34,16 +34,19 @@ load_suite, run_benchmark, ) -from embodichain_benchmarks.motion_generation import runner as runner_module -from embodichain_benchmarks.motion_generation.config import TrackCfg, suite_to_dict -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation import runner as runner_module +from embodichain.extensions.benchmarks.motion_generation.config import ( + TrackCfg, + suite_to_dict, +) +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( make_failure_outcomes, ) -from embodichain_benchmarks.motion_generation.registry import ( +from embodichain.extensions.benchmarks.motion_generation.registry import ( planner_adapter_names, planner_configuration_features, ) -from embodichain_benchmarks.motion_generation.scenarios.base import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.base import ( ScenarioEvaluation, ScenarioProvider, ) @@ -329,7 +332,9 @@ def test_suite_with_no_enabled_planners_fails_before_simulation(fake_runtime) -> def test_framework_revision_is_independent_of_caller_directory( monkeypatch: pytest.MonkeyPatch, tmp_path: Path ) -> None: - from embodichain_benchmarks.motion_generation.artifacts import _git_commit + from embodichain.extensions.benchmarks.motion_generation.artifacts import ( + _git_commit, + ) framework_revision = _git_commit() assert framework_revision is not None @@ -528,7 +533,9 @@ def test_frozen_manifest_rejects_changed_embodiment_before_simulation( def test_prepare_case_manifest_is_planner_independent_and_never_overwrites( fake_runtime, tmp_path, monkeypatch ): - from embodichain_benchmarks.motion_generation import prepare_case_manifest + from embodichain.extensions.benchmarks.motion_generation import ( + prepare_case_manifest, + ) suite = load_suite() monkeypatch.setattr( @@ -574,7 +581,7 @@ def _spawned_fake_shard(job): from dataclasses import replace from unittest.mock import patch - from embodichain_benchmarks.motion_generation.parallel import _run_shard + from embodichain.extensions.benchmarks.motion_generation.parallel import _run_shard robot = Mock(uid="test_robot") provider = Mock(control_part="arm") @@ -625,8 +632,11 @@ def test_parallel_quality_merges_full_population_and_preserves_inputs( ): from dataclasses import replace - from embodichain_benchmarks.motion_generation import parallel, prepare_case_manifest - from embodichain_benchmarks.motion_generation.models import TrialPhase + from embodichain.extensions.benchmarks.motion_generation import ( + parallel, + prepare_case_manifest, + ) + from embodichain.extensions.benchmarks.motion_generation.models import TrialPhase suite = load_suite() suite.protocol.warmup_trials = 0 @@ -793,9 +803,12 @@ def test_parallel_merges_initialized_and_unsupported_only_nmg_workers( from copy import deepcopy from dataclasses import replace - from embodichain_benchmarks.motion_generation import parallel, prepare_case_manifest - from embodichain_benchmarks.motion_generation.models import TrialPhase - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation import ( + parallel, + prepare_case_manifest, + ) + from embodichain.extensions.benchmarks.motion_generation.models import TrialPhase + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -892,8 +905,11 @@ def capture_worker(job): def test_parallel_partition_preserves_shared_geometry_and_rejects_timing( fake_runtime, tmp_path, monkeypatch ): - from embodichain_benchmarks.motion_generation import parallel, prepare_case_manifest - from embodichain_benchmarks.motion_generation.config import stable_hash + from embodichain.extensions.benchmarks.motion_generation import ( + parallel, + prepare_case_manifest, + ) + from embodichain.extensions.benchmarks.motion_generation.config import stable_hash rows = [ { @@ -943,7 +959,9 @@ def test_parallel_partition_preserves_shared_geometry_and_rejects_timing( @pytest.mark.parametrize("devices", [[], ["cuda"], ["cuda:0", "cuda:0"], ["cuda:2"]]) def test_quality_device_list_is_explicit_unique_and_available(monkeypatch, devices): - from embodichain_benchmarks.motion_generation import resolve_quality_devices + from embodichain.extensions.benchmarks.motion_generation import ( + resolve_quality_devices, + ) monkeypatch.setattr(torch.cuda, "is_available", lambda: True) monkeypatch.setattr(torch.cuda, "device_count", lambda: 2) @@ -957,7 +975,7 @@ def test_serial_quality_device_scope_restores_host_on_return_or_failure( monkeypatch, fails ): from contextlib import contextmanager - from embodichain_benchmarks.motion_generation import parallel + from embodichain.extensions.benchmarks.motion_generation import parallel events = [] @@ -1007,7 +1025,9 @@ def run(self): def test_parallel_resolves_device_index_in_parent( monkeypatch, requested, expected, uses_current ): - from embodichain_benchmarks.motion_generation.parallel import _worker_device + from embodichain.extensions.benchmarks.motion_generation.parallel import ( + _worker_device, + ) current = Mock(return_value=5) monkeypatch.setattr(torch.cuda, "is_available", lambda: True) @@ -1024,7 +1044,9 @@ def test_preparation_progress_survives_interruption_and_rejects_mismatch( fake_runtime, tmp_path, monkeypatch, change ): """Interrupted preparation retains inputs but never publishes a partial corpus.""" - from embodichain_benchmarks.motion_generation import prepare_case_manifest + from embodichain.extensions.benchmarks.motion_generation import ( + prepare_case_manifest, + ) suite = load_suite() output, progress = tmp_path / "frozen.json", tmp_path / "progress" diff --git a/tests/benchmark/motion_generation/test_atomic_dual_arm_providers.py b/tests/benchmark/motion_generation/test_atomic_dual_arm_providers.py index c9a056a119..986971a676 100644 --- a/tests/benchmark/motion_generation/test_atomic_dual_arm_providers.py +++ b/tests/benchmark/motion_generation/test_atomic_dual_arm_providers.py @@ -32,38 +32,49 @@ import torch import numpy as np -from embodichain_benchmarks.motion_generation.scenarios._atomic_pose_sampling import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._atomic_pose_sampling import ( apply_task_frame_randomization, ) from embodichain.lab.sim.motion.planners import PlanState from embodichain.toolkits.graspkit import ParallelJawGraspPoseGenerator from embodichain.utils.math import axis_angle_to_rotation_matrix, pose_inv -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( AtomicPoseRandomizationCfg, load_suite, ) -from embodichain_benchmarks.motion_generation.contracts import ( +from embodichain.extensions.benchmarks.motion_generation.contracts import ( ReplayObservationTrace, ReplayObservationWindow, ) -from embodichain_benchmarks.motion_generation.models import BenchmarkCase, CaseOutcome -from embodichain_benchmarks.motion_generation import robots as _robots # noqa: F401 -from embodichain_benchmarks.motion_generation.registry import create_robot_provider -from embodichain_benchmarks.motion_generation.scenarios import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( + BenchmarkCase, + CaseOutcome, +) +from embodichain.extensions.benchmarks.motion_generation import ( + robots as _robots, +) # noqa: F401 +from embodichain.extensions.benchmarks.motion_generation.registry import ( + create_robot_provider, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios import ( atomic_dual_arm_providers as dual, ) -from embodichain_benchmarks.motion_generation.scenarios import atomic_case_utils -from embodichain_benchmarks.motion_generation.scenarios import atomic_skill -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios import ( + atomic_case_utils, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios import atomic_skill +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_grasps import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps import ( ActiveCaseGraspPoseGenerator, CaseSampleCountGraspPoseGenerator, ) -from embodichain_benchmarks.motion_generation.contracts import ExecutionObservation -from embodichain_benchmarks.motion_generation.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + ExecutionObservation, +) +from embodichain.extensions.benchmarks.motion_generation.atomic_skill import ( create_atomic_skill_provider, ) @@ -1676,7 +1687,7 @@ def test_franka_dual_suites_use_authored_robotiq_linkage_and_finger_contacts( def test_native_panda_dual_provider_preserves_real_fingers_and_stock_tcp(tmp_path): """Check actual assembled geometry/kinematics, including the native mimic.""" from embodichain.utils.string import resolve_matching_names - from embodichain_robots import FrankaPandaCfg + from embodichain.extensions.robots import FrankaPandaCfg suite = load_suite("atomic_dual_franka_robotiq_hand_over") values = { @@ -1804,7 +1815,7 @@ def test_native_panda_dual_rejects_incompatible_arm_or_tool_override( def test_native_grasp_sampling_maps_closing_axis_once_before_frozen_replay(monkeypatch): """Every sampler API preserves metadata and native replay retains the pose.""" - from embodichain_benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures canonical = _pose(0.2, 0.3, 0.4).unsqueeze(0) canonical[:, :3, :3] = axis_angle_to_rotation_matrix(torch.tensor([0.2, -0.1, 0.3])) diff --git a/tests/benchmark/motion_generation/test_atomic_pose_config.py b/tests/benchmark/motion_generation/test_atomic_pose_config.py index e70d08cbc1..bccccc87ed 100644 --- a/tests/benchmark/motion_generation/test_atomic_pose_config.py +++ b/tests/benchmark/motion_generation/test_atomic_pose_config.py @@ -23,31 +23,31 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( AtomicPoseRandomizationCfg, TrackCfg, load_suite, resolve_atomic_batch_sizes, resolve_atomic_pose_randomization, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) -from embodichain_benchmarks.motion_generation.scenarios._atomic_pose_sampling import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._atomic_pose_sampling import ( _pose_settings, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils import ( apply_target_rotation_randomization, randomization_parameters, randomized_vector_batch, seeded_jitter, workspace_shell_profile, ) -from embodichain_benchmarks.motion_generation.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.atomic_skill import ( atomic_skill_provider_names, create_atomic_skill_provider, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_dual_arm_providers import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_dual_arm_providers import ( _support_randomization_config, ) @@ -1285,7 +1285,7 @@ def test_resolve_articulation_grasp_broadcasts_one_local_candidate_over_batch( model_id: str | None, ) -> None: """Slide uses the mounted hand and screens one translated grasp pool.""" - from embodichain_benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures batch_size = 4 target_pose = torch.eye(4).repeat(batch_size, 1, 1) diff --git a/tests/benchmark/motion_generation/test_atomic_skill_benchmark.py b/tests/benchmark/motion_generation/test_atomic_skill_benchmark.py index 8444d15f47..c99588fd58 100644 --- a/tests/benchmark/motion_generation/test_atomic_skill_benchmark.py +++ b/tests/benchmark/motion_generation/test_atomic_skill_benchmark.py @@ -21,8 +21,10 @@ import numpy as np import xml.etree.ElementTree as ET from embodichain.lab.sim.cfg import RobotCfg -from embodichain_robots import FrankaPandaCfg -from embodichain_benchmarks.motion_generation._atomic_fixtures import _FrankaPgiCfg +from embodichain.extensions.robots import FrankaPandaCfg +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( + _FrankaPgiCfg, +) import argparse import json @@ -46,17 +48,21 @@ from embodichain.lab.sim.motion.planners import ToppraPlanOptions from embodichain.lab.sim.motion.planners.utils import PlanResult from embodichain.utils.math import axis_angle_to_rotation_matrix -from embodichain_benchmarks.motion_generation.aggregation import aggregate_results -from embodichain_benchmarks.motion_generation.artifacts import ( +from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, +) +from embodichain.extensions.benchmarks.motion_generation.artifacts import ( TrialJsonlWriter, write_case_manifest, ) -from embodichain_benchmarks.motion_generation.config import load_suite -from embodichain_benchmarks.motion_generation.contracts import ReplayObservationTrace -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation.config import load_suite +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + ReplayObservationTrace, +) +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( compute_case_outcomes, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -64,21 +70,27 @@ TrialPhase, TrialRecord, ) -from embodichain_benchmarks.motion_generation.registry import create_robot_provider -from embodichain_benchmarks.motion_generation.runner import BenchmarkRunner -from embodichain_benchmarks.motion_generation import robots as _robots # noqa: F401 -from embodichain_benchmarks.motion_generation.scenarios.atomic_objects import ( +from embodichain.extensions.benchmarks.motion_generation.registry import ( + create_robot_provider, +) +from embodichain.extensions.benchmarks.motion_generation.runner import BenchmarkRunner +from embodichain.extensions.benchmarks.motion_generation import ( + robots as _robots, +) # noqa: F401 +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_objects import ( atomic_object_kind_names, create_atomic_object, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_replay import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_replay import ( AtomicReplayRuntime, ) -from embodichain_benchmarks.motion_generation.contracts import ExecutionObservation -from embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils import ( +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + ExecutionObservation, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils import ( atomic_case_id, canonical_case_qpos, case_generation_seed, @@ -86,19 +98,21 @@ seeded_jitter, snapshot_case_qpos, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( benchmark_motion_attribution, benchmark_motion_policy_strategy, ) -from embodichain_benchmarks.motion_generation.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.atomic_skill import ( atomic_skill_provider_names, create_atomic_skill_provider, ) -from embodichain_benchmarks.motion_generation.scenarios.base import ScenarioProvider -from embodichain_benchmarks.motion_generation.scenarios.free_space import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.base import ( + ScenarioProvider, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios.free_space import ( FreeSpaceScenario, ) -from embodichain_benchmarks.motion_generation.video import ( +from embodichain.extensions.benchmarks.motion_generation.video import ( VideoRecordCfg, build_video_path, record_with_window, @@ -327,7 +341,9 @@ def test_move_end_effector_provider_uses_settled_tcp_standard_evidence() -> None results = evaluator.evaluate(case, observation, outcomes) assert [result.task_success for result in results] == [True, False] - from embodichain_benchmarks.motion_generation.evaluation import STANDARD_VERSION + from embodichain.extensions.benchmarks.motion_generation.evaluation import ( + STANDARD_VERSION, + ) assert results[0].protocol_version == STANDARD_VERSION assert results[0].stages[0].evidence_source == ( @@ -2382,8 +2398,10 @@ def test_physical_evaluator_dispatch_preserves_row_results_and_execution_gates( expected_failure: str | None, ) -> None: """Row-local physical evidence preserves rejected plans' failure causes.""" - from embodichain_benchmarks.motion_generation import contracts - from embodichain_benchmarks.motion_generation.scenarios import atomic_skill + from embodichain.extensions.benchmarks.motion_generation import contracts + from embodichain.extensions.benchmarks.motion_generation.scenarios import ( + atomic_skill, + ) case = replace( _atomic_case(), batch_size=2, target_waypoints=torch.eye(4).repeat(2, 1, 1, 1) @@ -2494,8 +2512,10 @@ def test_runner_freezes_domain_manifest_before_each_planner( monkeypatch, tmp_path ) -> None: """The same case population and provenance reach all candidate records.""" - from embodichain_benchmarks.motion_generation import runner as runner_module - from embodichain_benchmarks.motion_generation.config import DomainCfg + from embodichain.extensions.benchmarks.motion_generation import ( + runner as runner_module, + ) + from embodichain.extensions.benchmarks.motion_generation.config import DomainCfg suite = load_suite("atomic_franka_robotiq_smoke") suite.tracks = [suite.enabled_tracks()[0]] @@ -2866,7 +2886,7 @@ def test_nonfinite_press_joint_evidence_does_not_count_as_contact_failure( def test_compiled_replay_clock_preserves_intervals_and_zero_time_boundaries(): - from embodichain_benchmarks.motion_generation.scenarios.atomic_replay import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_replay import ( _PhysicsReplaySettings, ) @@ -2944,7 +2964,7 @@ def test_compiled_replay_uses_scheduled_ticks_for_completion_time(): def test_compiled_clock_synchronizes_unequal_row_intervals(): - from embodichain_benchmarks.motion_generation.scenarios.atomic_replay import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_replay import ( _PhysicsReplaySettings, ) @@ -3015,7 +3035,7 @@ def test_loaded_cases_bind_atomic_providers_without_regeneration(monkeypatch): provider = Mock() factory = Mock(return_value=provider) monkeypatch.setattr( - "embodichain_benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", + "embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", factory, ) monkeypatch.setattr(scenario, "restore_base_robot", Mock()) @@ -3031,7 +3051,7 @@ def test_loaded_cases_bind_atomic_providers_without_regeneration(monkeypatch): @pytest.mark.parametrize("control_part", [None, "right_arm"]) def test_atomic_reference_ik_recovery_preserves_rows_and_original_targets(control_part): """An IK success near a probe must still satisfy the original arrival ball.""" - from embodichain_benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg batch = 3 targets = torch.eye(4).repeat(batch, 1, 1) @@ -3096,7 +3116,7 @@ def forward(*, qpos, name, env_ids, to_matrix): @pytest.mark.parametrize("failure", ["joint_bounds", "nonfinite", "unreachable"]) def test_atomic_reference_ik_recovery_keeps_unqualified_rows_failed(failure): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg robot = Mock() calls = 0 @@ -3121,7 +3141,7 @@ def inverse(*, pose, joint_seed, name, env_ids=None): def test_atomic_reference_exact_success_retains_existing_path_without_probes(): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg robot = Mock() robot.compute_ik.return_value = (torch.tensor([True]), torch.tensor([[0.123456]])) @@ -3143,8 +3163,8 @@ def test_atomic_reference_exact_success_retains_existing_path_without_probes(): @pytest.mark.parametrize("failure", ["wrong_fk", "joint_bounds", "nonfinite"]) def test_atomic_reference_rejects_false_positive_exact_ik(failure): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg - from embodichain_benchmarks.motion_generation.scenarios._case_qualification import ( + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.scenarios._case_qualification import ( _CaseQualificationError, ) @@ -3165,8 +3185,8 @@ def test_atomic_reference_rejects_false_positive_exact_ik(failure): def test_atomic_generation_retries_whole_batches_with_reproducible_inputs(monkeypatch): - from embodichain_benchmarks.motion_generation.config import TrackCfg - from embodichain_benchmarks.motion_generation.scenarios._case_qualification import ( + from embodichain.extensions.benchmarks.motion_generation.config import TrackCfg + from embodichain.extensions.benchmarks.motion_generation.scenarios._case_qualification import ( _CaseQualificationError, ) @@ -3224,7 +3244,7 @@ def restore(): clean = True monkeypatch.setattr( - "embodichain_benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", + "embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", factory, ) before_rng = torch.random.get_rng_state().clone() @@ -3253,7 +3273,7 @@ def restore(): @pytest.mark.parametrize("max_attempts", [1, 3]) def test_input_qualification_exhaustion_retains_evidence(max_attempts): - from embodichain_benchmarks.motion_generation.scenarios._case_qualification import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios._case_qualification import ( _CaseQualificationError, _generate_qualified_case, ) @@ -3283,7 +3303,7 @@ def reject(seed): def test_input_qualification_propagates_backend_errors_without_retry(): - from embodichain_benchmarks.motion_generation.scenarios._case_qualification import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios._case_qualification import ( _generate_qualified_case, ) @@ -3304,7 +3324,10 @@ def test_input_qualification_propagates_backend_errors_without_retry(): def test_nominal_case_cannot_enable_input_resampling(): - from embodichain_benchmarks.motion_generation.config import DomainCfg, TrackCfg + from embodichain.extensions.benchmarks.motion_generation.config import ( + DomainCfg, + TrackCfg, + ) scenario = AtomicSkillScenario() robot = SimpleNamespace(device=torch.device("cpu")) @@ -3344,8 +3367,8 @@ def get_qpos_limits(self, *, name, env_ids): def test_held_target_candidates_freeze_successful_rows_and_keep_original_inputs( monkeypatch, ): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg - from embodichain_benchmarks.motion_generation.scenarios import ( + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.scenarios import ( _atomic_targets as targets, ) @@ -3393,8 +3416,8 @@ def test_held_target_candidates_freeze_successful_rows_and_keep_original_inputs( @pytest.mark.parametrize("incorrect_fk", [False, True]) def test_held_target_candidate_exhaustion_is_an_error(monkeypatch, incorrect_fk): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg - from embodichain_benchmarks.motion_generation.scenarios import ( + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.scenarios import ( _atomic_targets as targets, ) @@ -3426,8 +3449,8 @@ def test_held_target_candidate_exhaustion_is_an_error(monkeypatch, incorrect_fk) def test_reference_recovery_maps_nested_environment_ids(): - from embodichain_benchmarks.motion_generation.config import ProtocolCfg - from embodichain_benchmarks.motion_generation.scenarios._atomic_reference import ( + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.scenarios._atomic_reference import ( _recover_reference_ik, ) @@ -3452,7 +3475,7 @@ def test_reference_recovery_maps_nested_environment_ids(): @pytest.mark.parametrize("count", [0, 33, True]) def test_held_target_candidate_count_bounds_precede_sampling(count): - from embodichain_benchmarks.motion_generation.scenarios._atomic_targets import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios._atomic_targets import ( _held_target_reference, ) @@ -3589,9 +3612,13 @@ def test_atomic_preparation_resumes_cases_without_renumbering_random_streams( monkeypatch, tmp_path ): """A failed later case cannot discard or regenerate an accepted earlier case.""" - from embodichain_benchmarks.motion_generation import runner as runner_module - from embodichain_benchmarks.motion_generation import prepare_case_manifest - from embodichain_benchmarks.motion_generation.config import TrackCfg + from embodichain.extensions.benchmarks.motion_generation import ( + runner as runner_module, + ) + from embodichain.extensions.benchmarks.motion_generation import ( + prepare_case_manifest, + ) + from embodichain.extensions.benchmarks.motion_generation.config import TrackCfg suite = load_suite("atomic_franka_robotiq_smoke") suite.tracks = [ @@ -3650,7 +3677,7 @@ def configured(self, simulation, robot, suite, track, control_part): monkeypatch.setattr(AtomicSkillScenario, "configure_runtime", configured) monkeypatch.setattr(AtomicSkillScenario, "restore_base_robot", lambda *args: None) monkeypatch.setattr( - "embodichain_benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", + "embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill.create_atomic_skill_provider", Provider, ) output, progress = tmp_path / "resumed.json", tmp_path / "progress" diff --git a/tests/benchmark/motion_generation/test_atomic_skill_providers.py b/tests/benchmark/motion_generation/test_atomic_skill_providers.py index 4f06c0ad9e..07e2cd32b5 100644 --- a/tests/benchmark/motion_generation/test_atomic_skill_providers.py +++ b/tests/benchmark/motion_generation/test_atomic_skill_providers.py @@ -41,35 +41,44 @@ from embodichain.lab.sim.motion.planners import MoveType, ToppraPlanOptions from embodichain.lab.sim.motion.planners.utils import TrajectorySampleMethod from embodichain.utils.math import axis_angle_to_rotation_matrix, pose_inv -from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg, load_suite -from embodichain_benchmarks.motion_generation.contracts import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + load_suite, +) +from embodichain.extensions.benchmarks.motion_generation.contracts import ( ReplayObservationTrace, ReplayObservationWindow, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, ) -from embodichain_benchmarks.motion_generation.planners.base import PlannerContext -from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter -from embodichain_benchmarks.motion_generation.scenarios import ( +from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, +) +from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios import ( atomic_skill_providers as providers, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_grasps import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps import ( ActiveCaseGraspPoseGenerator, ) -from embodichain_benchmarks.motion_generation.contracts import ExecutionObservation -from embodichain_benchmarks.motion_generation.scenarios.atomic_evaluation import ( +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + ExecutionObservation, +) +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_evaluation import ( signed_rotation_about_axis, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_plan_options, ) -from embodichain_benchmarks.motion_generation.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.atomic_skill import ( create_atomic_skill_provider, ) @@ -78,7 +87,7 @@ @pytest.mark.parametrize("mount_yaw", [0.0, math.pi, 0.7]) def test_radial_pre_pick_preserves_tool_tilt_in_the_mounted_base(mount_yaw): - from embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils import ( _pre_pick_pose, ) @@ -110,7 +119,7 @@ def test_radial_pre_pick_preserves_tool_tilt_in_the_mounted_base(mount_yaw): def test_pre_pick_default_keeps_world_orientation_and_validates_opt_in(): - from embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils import ( _pre_pick_pose, ) @@ -136,8 +145,8 @@ def test_pre_pick_default_keeps_world_orientation_and_validates_opt_in(): def test_empty_grasp_geometry_pool_is_a_typed_input_rejection(monkeypatch): - from embodichain_benchmarks.motion_generation import _atomic_fixtures - from embodichain_benchmarks.motion_generation.scenarios._case_qualification import ( + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation.scenarios._case_qualification import ( _CaseQualificationError, ) @@ -894,7 +903,7 @@ def test_grasp_screen_qualifies_original_targets_with_declared_arrival_region( use_arrival_region, ): """A bounded prismatic chain reaches 1.005 within 1 cm, but not 1.03.""" - from embodichain_benchmarks.motion_generation.config import ProtocolCfg + from embodichain.extensions.benchmarks.motion_generation.config import ProtocolCfg def ik(*, pose, joint_seed, **kwargs): x = pose[:, 0, 3] @@ -1439,9 +1448,14 @@ def test_push_succeeds_when_contact_starts_during_planar_motion() -> None: def test_custom_gripper_provider_initializes_configured_commands(monkeypatch): - from embodichain_benchmarks.motion_generation import atomic_skill as registry - from embodichain_benchmarks.motion_generation.config import SuiteCfg, TrackCfg - from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( + from embodichain.extensions.benchmarks.motion_generation import ( + atomic_skill as registry, + ) + from embodichain.extensions.benchmarks.motion_generation.config import ( + SuiteCfg, + TrackCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) @@ -1524,7 +1538,7 @@ def test_object_rotation_providers_screen_every_pose_row( """Freeze independently feasible row grasps and match their reference chains.""" from types import MethodType - from embodichain_benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures from embodichain.lab.sim.objects.robot import Robot @@ -1661,7 +1675,9 @@ def checked_pools(*args, **kwargs): } protocol = object() if cartesian: - from embodichain_benchmarks.motion_generation.scenarios import atomic_skill + from embodichain.extensions.benchmarks.motion_generation.scenarios import ( + atomic_skill, + ) def qualified_ik(robot, pose, seed, **kwargs): assert kwargs["protocol"] is protocol diff --git a/tests/benchmark/motion_generation/test_benchmark_views.py b/tests/benchmark/motion_generation/test_benchmark_views.py index 0ea97afe89..469faf02eb 100644 --- a/tests/benchmark/motion_generation/test_benchmark_views.py +++ b/tests/benchmark/motion_generation/test_benchmark_views.py @@ -24,14 +24,18 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.aggregation import aggregate_results -from embodichain_benchmarks.motion_generation.config import SuiteCfg -from embodichain_benchmarks.motion_generation.contracts import EvaluationDomain -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, +) +from embodichain.extensions.benchmarks.motion_generation.config import SuiteCfg +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + EvaluationDomain, +) +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( compute_case_outcomes, make_failure_outcomes, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -39,7 +43,9 @@ TrialPhase, TrialRecord, ) -from embodichain_benchmarks.motion_generation.reporting import write_markdown_report +from embodichain.extensions.benchmarks.motion_generation.reporting import ( + write_markdown_report, +) def _case(track: str = "neutral", *, atomic: bool = False) -> BenchmarkCase: diff --git a/tests/benchmark/motion_generation/test_constraint_sequences.py b/tests/benchmark/motion_generation/test_constraint_sequences.py index 19235b51e5..e9a285277e 100644 --- a/tests/benchmark/motion_generation/test_constraint_sequences.py +++ b/tests/benchmark/motion_generation/test_constraint_sequences.py @@ -23,13 +23,13 @@ import torch from types import SimpleNamespace -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( FreeSpaceTrackCfg, ) -from embodichain_benchmarks.motion_generation.metrics._constraints import ( +from embodichain.extensions.benchmarks.motion_generation.metrics._constraints import ( match_constraints, ) -from embodichain_benchmarks.motion_generation.scenarios._free_space_sampling import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._free_space_sampling import ( _project_constraints, ) @@ -75,8 +75,12 @@ def test_masked_baseline_ik_ignores_unused_pose_components(modality): def _masked_adapter(kind, *, enabled=True): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) robot = SimpleNamespace( compute_batch_fk=lambda *, qpos, **_: _coupled_fk(qpos), @@ -101,8 +105,10 @@ def _masked_adapter(kind, *, enabled=True): @pytest.mark.parametrize("fail_joint", [False, True]) def test_toppra_mixed_sequence_uses_requested_joint_payload_and_masked_ik(fail_joint): from embodichain.lab.sim.motion.planners import PlanResult - from embodichain_benchmarks.motion_generation.models import BenchmarkCase - from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter + from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase + from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, + ) adapter = _masked_adapter(ToppraAdapter) adapter._motion_limits = { @@ -206,12 +212,20 @@ def test_franka_masked_baseline_runtime(backend): """Actual FK, component IK/native TrajOpt, timing and independent scoring.""" from dataclasses import replace from embodichain.lab.sim import SimulationManager, SimulationManagerCfg - from embodichain_robots import FrankaPandaCfg - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.models import BenchmarkCase - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter - from embodichain_benchmarks.motion_generation.planners.curobo import CuroboAdapter + from embodichain.extensions.robots import FrankaPandaCfg + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.curobo import ( + CuroboAdapter, + ) sim = SimulationManager( SimulationManagerCfg(headless=True, sim_device="cuda", num_envs=1) @@ -425,7 +439,7 @@ def compute_fk(self, qpos, name, to_matrix): def test_projected_patterns_share_screened_cartesian_inputs(): - from embodichain_benchmarks.motion_generation.models import BenchmarkCase + from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase base = BenchmarkCase( "test", @@ -491,8 +505,8 @@ def test_empty_trajectory_is_a_failed_semantic_match(): def test_case_outcomes_preserve_native_samples_for_masked_and_common_inputs( validity: str, modalities: list[str], dtype: torch.dtype ) -> None: - from embodichain_benchmarks.motion_generation.models import BenchmarkCase - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( compute_case_outcomes, ) from embodichain.lab.sim.motion.planners.utils import PlanResult @@ -572,7 +586,7 @@ def score(positions): def test_equivalent_pattern_expansions_are_rejected_by_suite_loader( patterns: list[list[str]], count: int ) -> None: - from embodichain_benchmarks.motion_generation.config import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( SuiteCfg, load_suite, suite_to_dict, diff --git a/tests/benchmark/motion_generation/test_contracts.py b/tests/benchmark/motion_generation/test_contracts.py index b3f992f783..2b0a9b65f0 100644 --- a/tests/benchmark/motion_generation/test_contracts.py +++ b/tests/benchmark/motion_generation/test_contracts.py @@ -26,17 +26,17 @@ import torch import yaml -from embodichain_benchmarks.motion_generation import contracts -from embodichain_benchmarks.motion_generation.artifacts import ( +from embodichain.extensions.benchmarks.motion_generation import contracts +from embodichain.extensions.benchmarks.motion_generation.artifacts import ( TrialJsonlWriter, write_case_manifest, ) -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( SuiteCfg, load_suite, suite_to_dict, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -356,7 +356,7 @@ def test_replay_observation_trace_requires_synchronized_batch_axes() -> None: @pytest.mark.parametrize("dtype", [torch.float32, torch.float64]) def test_default_fixed_grasp_is_a_proper_rotation(dtype: torch.dtype) -> None: - from embodichain_benchmarks.motion_generation.scenarios.atomic_case_utils import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_case_utils import ( TOP_DOWN_ROTATION, ) diff --git a/tests/benchmark/motion_generation/test_embodiment_runtime.py b/tests/benchmark/motion_generation/test_embodiment_runtime.py index fffa37be02..7563b07c54 100644 --- a/tests/benchmark/motion_generation/test_embodiment_runtime.py +++ b/tests/benchmark/motion_generation/test_embodiment_runtime.py @@ -28,16 +28,20 @@ import torch import yaml -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( EmbodimentSpecCfg, RobotSpecCfg, SuiteCfg, load_suite, suite_to_dict, ) -from embodichain_benchmarks.motion_generation.embodiments import resolve_embodiment -from embodichain_benchmarks.motion_generation.robots.base import EmbodimentRobotProvider -from embodichain_benchmarks.motion_generation.runner import BenchmarkRunner +from embodichain.extensions.benchmarks.motion_generation.embodiments import ( + resolve_embodiment, +) +from embodichain.extensions.benchmarks.motion_generation.robots.base import ( + EmbodimentRobotProvider, +) +from embodichain.extensions.benchmarks.motion_generation.runner import BenchmarkRunner pytestmark = pytest.mark.no_sim @@ -207,7 +211,9 @@ def test_multiple_resources_need_explicit_selection(component: Path) -> None: def test_runner_uses_component_robot_and_preserves_input_suite( component: Path, monkeypatch, substeps: int ) -> None: - from embodichain_benchmarks.motion_generation import runner as runner_module + from embodichain.extensions.benchmarks.motion_generation import ( + runner as runner_module, + ) suite = SuiteCfg.from_dict(_suite_data(str(component))) suite.protocol.physics_substeps = substeps @@ -247,7 +253,7 @@ def test_invalid_physics_substeps_fail_before_runtime( def test_gripper_and_domain_overrides_cannot_change_component_commands( component: Path, ) -> None: - from embodichain_benchmarks.motion_generation.config import DomainCfg + from embodichain.extensions.benchmarks.motion_generation.config import DomainCfg suite = SuiteCfg.from_dict(_suite_data(str(component))) suite.tracks[0].config["gripper"] = {"control_part": "wrong"} @@ -274,8 +280,8 @@ def test_official_ur5_component_uses_robot_catalog_and_binds_fingers( domain_id: str, ) -> None: from embodichain.lab.sim import cfg as cfg_module - from embodichain_robots.universal_robots import ur_robot - from embodichain_benchmarks.motion_generation.scenarios._grasp_contacts import ( + from embodichain.extensions.robots.universal_robots import ur_robot + from embodichain.extensions.benchmarks.motion_generation.scenarios._grasp_contacts import ( contact_configuration, ) @@ -327,13 +333,17 @@ def test_suite_validates_case_identity_before_planning_and_persistence( component_owned: bool, case_identity: str, ) -> None: - from embodichain_benchmarks.motion_generation import runner as runner_module - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation import ( + runner as runner_module, + ) + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( make_failure_outcomes, ) - from embodichain_benchmarks.motion_generation.models import BenchmarkCase - from embodichain_benchmarks.motion_generation.planners.base import PlannerAdapter - from embodichain_benchmarks.motion_generation.scenarios.base import ( + from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.scenarios.base import ( ScenarioEvaluation, ScenarioProvider, ) @@ -470,7 +480,7 @@ def plan(self, case): def test_example_has_nominal_and_position_domains() -> None: - from embodichain_benchmarks.motion_generation.config import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( resolve_atomic_batch_sizes, ) diff --git a/tests/benchmark/motion_generation/test_embodiments.py b/tests/benchmark/motion_generation/test_embodiments.py index 303716e451..0afcd5661b 100644 --- a/tests/benchmark/motion_generation/test_embodiments.py +++ b/tests/benchmark/motion_generation/test_embodiments.py @@ -22,11 +22,11 @@ import pytest -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( EmbodimentSpecCfg, RobotSpecCfg, ) -from embodichain_benchmarks.motion_generation.embodiments import ( +from embodichain.extensions.benchmarks.motion_generation.embodiments import ( EmbodimentResolution, YamlEmbodimentProvider, check_embodiment_capabilities, diff --git a/tests/benchmark/motion_generation/test_evaluation.py b/tests/benchmark/motion_generation/test_evaluation.py index 61dfda0393..07f5738e43 100644 --- a/tests/benchmark/motion_generation/test_evaluation.py +++ b/tests/benchmark/motion_generation/test_evaluation.py @@ -25,15 +25,22 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.aggregation import aggregate_results -from embodichain_benchmarks.motion_generation.artifacts import TrialJsonlWriter -from embodichain_benchmarks.motion_generation.config import SuiteCfg, TrackCfg -from embodichain_benchmarks.motion_generation.contracts import ( +from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, +) +from embodichain.extensions.benchmarks.motion_generation.artifacts import ( + TrialJsonlWriter, +) +from embodichain.extensions.benchmarks.motion_generation.config import ( + SuiteCfg, + TrackCfg, +) +from embodichain.extensions.benchmarks.motion_generation.contracts import ( PhysicalEvaluation, StageOutcome, validate_physical_evaluations, ) -from embodichain_benchmarks.motion_generation.evaluation import ( +from embodichain.extensions.benchmarks.motion_generation.evaluation import ( STANDARD_VERSION, SKILL_CRITERIA, StageEvidence, @@ -41,7 +48,7 @@ evaluate_skill_stages, validate_standard_evaluation, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -50,7 +57,9 @@ TrialRecord, with_physical_evaluation, ) -from embodichain_benchmarks.motion_generation.reporting import write_markdown_report +from embodichain.extensions.benchmarks.motion_generation.reporting import ( + write_markdown_report, +) def _evidence(window: str, **measurements: float | bool) -> StageEvidence: diff --git a/tests/benchmark/motion_generation/test_free_space.py b/tests/benchmark/motion_generation/test_free_space.py index 7efca97a94..81893c2439 100644 --- a/tests/benchmark/motion_generation/test_free_space.py +++ b/tests/benchmark/motion_generation/test_free_space.py @@ -23,12 +23,12 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.config import SuiteCfg -from embodichain_benchmarks.motion_generation.scenarios.free_space import ( +from embodichain.extensions.benchmarks.motion_generation.config import SuiteCfg +from embodichain.extensions.benchmarks.motion_generation.scenarios.free_space import ( FreeSpaceScenario, _start_qpos_for_bin, ) -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( compute_case_outcomes, ) from embodichain.lab.sim.motion.planners.utils import PlanResult @@ -267,9 +267,13 @@ def test_conditioning_and_joint_margin_are_measured(near_limit_sampling): def test_proposal_chunks_preserve_first_complete_input_and_arena_rows( monkeypatch, chunk_size, batch_mode ): - from embodichain_benchmarks.motion_generation.config import FreeSpaceTrackCfg - from embodichain_benchmarks.motion_generation.scenarios import _free_space_sampling - from embodichain_benchmarks.motion_generation.scenarios._free_space_proposals import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + FreeSpaceTrackCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.scenarios import ( + _free_space_sampling, + ) + from embodichain.extensions.benchmarks.motion_generation.scenarios._free_space_proposals import ( _sample_request_batched, ) @@ -440,14 +444,16 @@ def test_reference_rotation_is_valid_under_strict_angular_threshold(): def test_workload_tables_preserve_modality_batch_semantics_and_uncertainty(): - from embodichain_benchmarks.motion_generation.aggregation import aggregate_results - from embodichain_benchmarks.motion_generation.models import ( + from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, + ) + from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, PlannerMetadata, TrialPhase, TrialRecord, ) - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( make_failure_outcomes, ) @@ -650,7 +656,7 @@ def test_reference_path_deviation_is_diagnostic_for_cartesian_waypoint_layouts( def test_polyline_deviation_handles_long_degenerate_and_noncontiguous_inputs(): - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( _reference_path_deviation, ) @@ -667,7 +673,7 @@ def test_polyline_deviation_handles_long_degenerate_and_noncontiguous_inputs(): def test_compact_screening_preserves_arena_frames_and_per_environment_limits(): - from embodichain_benchmarks.motion_generation.scenarios._free_space_sampling import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios._free_space_sampling import ( _RowKinematics, _screen_path, ) @@ -704,7 +710,7 @@ def compute_batch_fk(self, qpos, name, to_matrix, env_ids=None): def test_screening_can_select_a_finite_restart_when_another_candidate_is_nonfinite(): - from embodichain_benchmarks.motion_generation.scenarios._free_space_sampling import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios._free_space_sampling import ( _reference_ik, ) diff --git a/tests/benchmark/motion_generation/test_generalization.py b/tests/benchmark/motion_generation/test_generalization.py index be252f2616..1d50a4334e 100644 --- a/tests/benchmark/motion_generation/test_generalization.py +++ b/tests/benchmark/motion_generation/test_generalization.py @@ -23,13 +23,17 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.aggregation import aggregate_results -from embodichain_benchmarks.motion_generation.config import SuiteCfg -from embodichain_benchmarks.motion_generation.contracts import EvaluationDomain -from embodichain_benchmarks.motion_generation.generalization import ( +from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, +) +from embodichain.extensions.benchmarks.motion_generation.config import SuiteCfg +from embodichain.extensions.benchmarks.motion_generation.contracts import ( + EvaluationDomain, +) +from embodichain.extensions.benchmarks.motion_generation.generalization import ( aggregate_generalization, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -679,7 +683,7 @@ def test_spatial_bucket_rates_count_missing_repeats_as_failures() -> None: def test_seed_cluster_uncertainty_is_deterministic_and_requires_independent_seeds(): - from embodichain_benchmarks.motion_generation.metrics.stats import ( + from embodichain.extensions.benchmarks.motion_generation.metrics.stats import ( _seed_cluster_interval, ) diff --git a/tests/benchmark/motion_generation/test_grasp_contacts.py b/tests/benchmark/motion_generation/test_grasp_contacts.py index 523f950228..9bbade758a 100644 --- a/tests/benchmark/motion_generation/test_grasp_contacts.py +++ b/tests/benchmark/motion_generation/test_grasp_contacts.py @@ -23,16 +23,16 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.contracts import ( +from embodichain.extensions.benchmarks.motion_generation.contracts import ( ExecutionObservation, ReplayObservationTrace, ) -from embodichain_benchmarks.motion_generation.scenarios._grasp_contacts import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._grasp_contacts import ( GraspContacts, contact_configuration, minimum_target_contact_distances, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_evaluation import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_evaluation import ( gripper_holding, trace_validity, ) @@ -230,8 +230,8 @@ def test_newton_finger_contact_scoring_is_target_and_environment_specific(): from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import NewtonPhysicsCfg, RigidObjectCfg from embodichain.lab.sim.shapes import CubeCfg - from embodichain_benchmarks.motion_generation.config import RobotSpecCfg - from embodichain_benchmarks.motion_generation.robots.franka import ( + from embodichain.extensions.benchmarks.motion_generation.config import RobotSpecCfg + from embodichain.extensions.benchmarks.motion_generation.robots.franka import ( FrankaPgiProvider, ) diff --git a/tests/benchmark/motion_generation/test_motion_generation_benchmark.py b/tests/benchmark/motion_generation/test_motion_generation_benchmark.py index 5f7f364934..c4d035e664 100644 --- a/tests/benchmark/motion_generation/test_motion_generation_benchmark.py +++ b/tests/benchmark/motion_generation/test_motion_generation_benchmark.py @@ -42,19 +42,24 @@ from embodichain.lab.sim.motion.planners.curobo.curobo_planner import CuroboPlanner from embodichain.lab.sim.motion.planners.utils import MoveType, PlanResult from embodichain.toolkits.graspkit import GraspPoseGenerator -from embodichain_benchmarks.motion_generation.aggregation import aggregate_results -from embodichain_benchmarks.motion_generation.config import DomainCfg, load_suite -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation.aggregation import ( + aggregate_results, +) +from embodichain.extensions.benchmarks.motion_generation.config import ( + DomainCfg, + load_suite, +) +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( _trajectory_derivatives, compute_case_outcomes, compute_waypoint_errors, match_ordered_joint_waypoints, match_ordered_waypoints, ) -from embodichain_benchmarks.motion_generation import ( +from embodichain.extensions.benchmarks.motion_generation import ( scenarios as _scenarios, ) # noqa: F401 -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, CaseOutcome, @@ -62,26 +67,26 @@ TrialPhase, TrialRecord, ) -from embodichain_benchmarks.motion_generation.registry import ( +from embodichain.extensions.benchmarks.motion_generation.registry import ( create_scenario_provider, scenario_provider_names, ) -from embodichain_benchmarks.motion_generation.reporting import ( +from embodichain.extensions.benchmarks.motion_generation.reporting import ( write_markdown_report, ) -from embodichain_benchmarks.motion_generation.cli import ( +from embodichain.extensions.benchmarks.motion_generation.cli import ( _apply_overrides, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_grasps import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps import ( FrozenArticulationGraspPoseGenerator, ) -from embodichain_benchmarks.motion_generation.scenarios.atomic_evaluation import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_evaluation import ( executed_final_pose_errors, ) -from embodichain_benchmarks.motion_generation.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.atomic_skill import ( create_atomic_skill_provider, ) @@ -414,7 +419,7 @@ def test_validity_excludes_terminal_padding_but_keeps_timed_holds( def test_arrival_grid_union_is_row_local_and_keeps_repeated_visits_ordered(): from embodichain.compute.trajectory import resample_with_distance - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( _arrival_validation_grid, ) @@ -631,7 +636,7 @@ def _json_round_tripped_outcomes(trial: TrialRecord) -> tuple[CaseOutcome, ...]: def test_motion_across_a_zero_interval_is_an_unbounded_velocity_violation(tmp_path): - from embodichain_benchmarks.motion_generation.artifacts import ( + from embodichain.extensions.benchmarks.motion_generation.artifacts import ( TrialJsonlWriter, write_json, ) @@ -748,9 +753,13 @@ def test_suite_stated_velocity_limit_overrides_a_placeholder_asset(): def _nmg_adapter(**config): """Build an NMG adapter against a stub context, without loading a policy.""" - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -834,7 +843,7 @@ def test_nmg_cli_overrides_reach_every_nmg_row(): # A checkpoint supplied on the command line must reach the paired row too; # otherwise its availability check skips it and no comparison runs. suite = load_suite( - "extensions/embodichain_benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml" + "embodichain/extensions/benchmarks/motion_generation/suites/motion_panda_free_space_smoke.yaml" ) _apply_overrides(suite, nmg_onnx_path="/tmp/policy.onnx", nmg_pos_eps=0.02) rows = { @@ -851,7 +860,7 @@ def test_nmg_cli_overrides_reach_every_nmg_row(): ) def test_free_space_suites_pair_a_nominal_and_a_retimed_nmg_row(suite_name): suite = load_suite( - f"extensions/embodichain_benchmarks/motion_generation/suites/{suite_name}.yaml" + f"embodichain/extensions/benchmarks/motion_generation/suites/{suite_name}.yaml" ) rows = { spec.id: bool(spec.config.get("retime", False)) @@ -1065,12 +1074,18 @@ def test_dynamic_limit_tolerance_must_be_finite_and_non_negative(tolerance): def test_only_planners_that_solve_timing_declare_it(): - from embodichain_benchmarks.motion_generation.planners.base import PlannerAdapter - from embodichain_benchmarks.motion_generation.planners.curobo import CuroboAdapter - from embodichain_benchmarks.motion_generation.planners.ik_interpolate import ( + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.curobo import ( + CuroboAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.ik_interpolate import ( IkInterpolateAdapter, ) - from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter + from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, + ) # An adapter that declares nothing is not judged on an unsolved clock. assert PlannerAdapter.timing_is_solved is False @@ -1279,9 +1294,13 @@ def test_nmg_precision_and_external_accuracy_are_independently_configurable(): def test_nmg_model_revision_is_derived_from_runtime_model_path(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -1304,9 +1323,13 @@ def test_nmg_model_revision_is_derived_from_runtime_model_path(): def test_nmg_over_capacity_case_is_explicitly_unsupported_without_truncation(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -1387,9 +1410,13 @@ def test_nmg_case_support_respects_position_only_tcp_origin_requirement( def test_nmg_case_budget_is_thirty_steps_per_waypoint(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -1414,9 +1441,13 @@ def test_nmg_case_budget_is_thirty_steps_per_waypoint(): def test_nmg_joint_case_uses_joint_constraint_waypoints(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -1466,9 +1497,15 @@ def test_nmg_joint_case_uses_joint_constraint_waypoints(): def _curobo_adapter(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.curobo import CuroboAdapter + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.curobo import ( + CuroboAdapter, + ) adapter = CuroboAdapter( PlannerSpecCfg( @@ -1577,9 +1614,13 @@ def test_curobo_prepares_both_named_atomic_arms(): def test_nmg_rejects_unknown_motion_validity(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.nmg_onnx import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( NmgOnnxAdapter, ) @@ -1631,7 +1672,7 @@ def test_seed_override_adds_missing_atomic_track_seeds(): def test_free_space_overrides_reach_each_configured_track(): - from embodichain_benchmarks.motion_generation.config import SuiteCfg + from embodichain.extensions.benchmarks.motion_generation.config import SuiteCfg suite = SuiteCfg.from_dict( { @@ -1674,7 +1715,7 @@ def test_atomic_skill_antipodal_grasp_uses_standalone_generator( from contextlib import nullcontext from types import MethodType, SimpleNamespace - from embodichain_benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures from embodichain.lab.sim.objects.robot import Robot @@ -1814,7 +1855,7 @@ def solve(*, target_xpos, qpos_seed, return_all_solutions): def test_atomic_screen_selects_its_robot_environments(monkeypatch, env_ids): from types import MethodType, SimpleNamespace - from embodichain_benchmarks.motion_generation import _atomic_fixtures + from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures from embodichain.lab.sim.objects.robot import Robot @@ -3166,9 +3207,15 @@ def test_curobo_prepare_backend_exposes_actual_graph_mode(): def test_toppra_adapter_close_releases_planner(): - from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg - from embodichain_benchmarks.motion_generation.planners.base import PlannerContext - from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter + from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, + ) + from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, + ) planner = Mock() adapter = ToppraAdapter( @@ -3287,7 +3334,7 @@ def test_success_table_uses_case_macro_and_counts_cases_not_env_slots(): def test_timed_call_reports_null_peak_gpu_without_cuda(monkeypatch): - from embodichain_benchmarks.motion_generation.metrics import performance + from embodichain.extensions.benchmarks.motion_generation.metrics import performance monkeypatch.setattr(performance.torch.cuda, "is_available", lambda: False) measured = performance.timed_call(lambda: 42) @@ -3297,18 +3344,24 @@ def test_timed_call_reports_null_peak_gpu_without_cuda(monkeypatch): def test_runner_capability_gate_and_fake_adapter_lifecycle(tmp_path): """Exercise AVAILABILITY gating and MEASURED aggregation without DexSim.""" - from embodichain_benchmarks.motion_generation.artifacts import TrialJsonlWriter - from embodichain_benchmarks.motion_generation.config import ( + from embodichain.extensions.benchmarks.motion_generation.artifacts import ( + TrialJsonlWriter, + ) + from embodichain.extensions.benchmarks.motion_generation.config import ( PlannerSpecCfg, ProtocolCfg, SuiteCfg, ) - from embodichain_benchmarks.motion_generation.planners.base import PlannerAdapter - from embodichain_benchmarks.motion_generation.registry import ( + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.registry import ( register_planner_adapter, unregister_planner_adapter, ) - from embodichain_benchmarks.motion_generation.runner import BenchmarkRunner + from embodichain.extensions.benchmarks.motion_generation.runner import ( + BenchmarkRunner, + ) prepared_case_sets: list[tuple[str, ...]] = [] @@ -3549,18 +3602,24 @@ def test_runner_preserves_case_attribution_across_lifecycle_failures( tmp_path, failure_mode, failure_phase, failure_code ): """Every early exit preserves planner attribution for every case.""" - from embodichain_benchmarks.motion_generation.artifacts import TrialJsonlWriter - from embodichain_benchmarks.motion_generation.config import ( + from embodichain.extensions.benchmarks.motion_generation.artifacts import ( + TrialJsonlWriter, + ) + from embodichain.extensions.benchmarks.motion_generation.config import ( PlannerSpecCfg, ProtocolCfg, SuiteCfg, ) - from embodichain_benchmarks.motion_generation.planners.base import PlannerAdapter - from embodichain_benchmarks.motion_generation.registry import ( + from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerAdapter, + ) + from embodichain.extensions.benchmarks.motion_generation.registry import ( register_planner_adapter, unregister_planner_adapter, ) - from embodichain_benchmarks.motion_generation.runner import BenchmarkRunner + from embodichain.extensions.benchmarks.motion_generation.runner import ( + BenchmarkRunner, + ) adapter_name = "fake_lifecycle_failure" @@ -3660,7 +3719,9 @@ def test_scenario_reset_publishes_frozen_start_without_stepping( full_state: bool, ) -> None: from types import SimpleNamespace - from embodichain_benchmarks.motion_generation.scenarios.base import ScenarioProvider + from embodichain.extensions.benchmarks.motion_generation.scenarios.base import ( + ScenarioProvider, + ) class Provider(ScenarioProvider): def batch_sizes(self, *args): diff --git a/tests/benchmark/motion_generation/test_motion_limits.py b/tests/benchmark/motion_generation/test_motion_limits.py index e0f9012d78..0eab5949e4 100644 --- a/tests/benchmark/motion_generation/test_motion_limits.py +++ b/tests/benchmark/motion_generation/test_motion_limits.py @@ -26,20 +26,31 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.config import PlannerSpecCfg, load_suite -from embodichain_benchmarks.motion_generation.limits import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( + PlannerSpecCfg, + load_suite, +) +from embodichain.extensions.benchmarks.motion_generation.limits import ( resolve_dynamic_limit, resolve_robot_velocity_limits, resolve_velocity_limits, ) -from embodichain_benchmarks.motion_generation.models import BenchmarkCase -from embodichain_benchmarks.motion_generation.planners.base import PlannerContext -from embodichain_benchmarks.motion_generation.planners.curobo import CuroboAdapter -from embodichain_benchmarks.motion_generation.planners.ik_interpolate import ( +from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase +from embodichain.extensions.benchmarks.motion_generation.planners.base import ( + PlannerContext, +) +from embodichain.extensions.benchmarks.motion_generation.planners.curobo import ( + CuroboAdapter, +) +from embodichain.extensions.benchmarks.motion_generation.planners.ik_interpolate import ( IkInterpolateAdapter, ) -from embodichain_benchmarks.motion_generation.planners.nmg_onnx import NmgOnnxAdapter -from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter +from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( + NmgOnnxAdapter, +) +from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, +) def _robot() -> SimpleNamespace: @@ -174,7 +185,7 @@ def test_curobo_atomic_policy_preserves_prepared_backend_budget() -> None: MotionPolicy, ) from embodichain.lab.sim.motion.motion_generator import MotionGenerator - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_plan_options, ) @@ -207,7 +218,7 @@ def test_curobo_atomic_policy_preserves_prepared_backend_budget() -> None: def test_curobo_benchmark_forwards_fast_settings(monkeypatch) -> None: """A/B suite settings must reach the production planner configuration.""" - from embodichain_benchmarks.motion_generation.planners import curobo + from embodichain.extensions.benchmarks.motion_generation.planners import curobo generator = Mock() monkeypatch.setattr(curobo, "MotionGenerator", generator) @@ -311,7 +322,7 @@ def test_explicit_zero_speed_cap_is_preserved_and_moving_path_fails() -> None: @pytest.mark.parametrize( "path", sorted( - Path("extensions/embodichain_benchmarks/motion_generation/suites").glob( + Path("embodichain/extensions/benchmarks/motion_generation/suites").glob( "*.yaml" ) ), @@ -335,7 +346,7 @@ def test_shipped_suites_share_explicit_timed_planning_budgets(path: Path) -> Non def test_atomic_migration_preserves_existing_toppra_budgets() -> None: """Moving budgets to protocol must not accelerate existing Atomic tasks.""" - for path in Path("extensions/embodichain_benchmarks/motion_generation/suites").glob( + for path in Path("embodichain/extensions/benchmarks/motion_generation/suites").glob( "atomic*.yaml" ): suite = load_suite(path) diff --git a/tests/benchmark/motion_generation/test_motion_suite_families.py b/tests/benchmark/motion_generation/test_motion_suite_families.py index 3abc3b4e1a..26f0b51210 100644 --- a/tests/benchmark/motion_generation/test_motion_suite_families.py +++ b/tests/benchmark/motion_generation/test_motion_suite_families.py @@ -25,18 +25,18 @@ import torch import yaml -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( BENCHMARK_ROOT, DomainCfg, SuiteCfg, load_suite, ) -from embodichain_benchmarks.motion_generation.models import BenchmarkCase -from embodichain_benchmarks.motion_generation.planners.base import ( +from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase +from embodichain.extensions.benchmarks.motion_generation.planners.base import ( PlannerAdapter, PlannerContext, ) -from embodichain_benchmarks.motion_generation.scenarios.free_space import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios.free_space import ( FreeSpaceScenario, ) @@ -300,8 +300,10 @@ def test_franka_pose_batch_uses_the_same_policy_frames_as_its_robot_assembly(): ) def test_packaged_franka_atomic_suites_bind_robotiq_geometry_and_policy_tcp(suite_path): """Every shipped Franka Atomic track must describe its mounted Robotiq.""" - from embodichain_benchmarks.motion_generation.registry import create_robot_provider - from embodichain_benchmarks.motion_generation import robots as _robots + from embodichain.extensions.benchmarks.motion_generation.registry import ( + create_robot_provider, + ) + from embodichain.extensions.benchmarks.motion_generation import robots as _robots suite = load_suite(suite_path) dual = suite.robot.provider == "dual_arm" @@ -343,7 +345,9 @@ def test_packaged_franka_atomic_suites_bind_robotiq_geometry_and_policy_tcp(suit def test_component_ur5_policy_tcp_is_inverse_of_the_component_solver_tcp(): - from embodichain_benchmarks.motion_generation.embodiments import resolve_embodiment + from embodichain.extensions.benchmarks.motion_generation.embodiments import ( + resolve_embodiment, + ) suite = load_suite("atomic_ur5_embodiment") resolution = resolve_embodiment(suite.embodiment, suite.robot) diff --git a/tests/benchmark/motion_generation/test_native_hand_collision_geometry.py b/tests/benchmark/motion_generation/test_native_hand_collision_geometry.py index b607ed67d5..c29152c813 100644 --- a/tests/benchmark/motion_generation/test_native_hand_collision_geometry.py +++ b/tests/benchmark/motion_generation/test_native_hand_collision_geometry.py @@ -46,7 +46,7 @@ GripperCollisionCfg, GripperCollisionChecker, ) -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( create_parallel_jaw_grasp_pose_generator, ) @@ -151,10 +151,10 @@ def make_checker(fixed): def test_benchmark_mounted_hand_uses_bound_solver_tcp( model_id: str, expected_tcp_z: float, expected_offset: float ) -> None: - from embodichain_benchmarks.motion_generation._atomic_fixtures import ( + from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( create_ur5_gripper_robot_cfg, ) - from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) @@ -162,12 +162,12 @@ def test_benchmark_mounted_hand_uses_bound_solver_tcp( if model_id == "dh_pgi_140_80": cfg = create_ur5_gripper_robot_cfg() else: - from embodichain_benchmarks.motion_generation import load_suite - from embodichain_benchmarks.motion_generation.registry import ( + from embodichain.extensions.benchmarks.motion_generation import load_suite + from embodichain.extensions.benchmarks.motion_generation.registry import ( create_robot_provider, ) - import embodichain_benchmarks.motion_generation.robots.dual_arm + import embodichain.extensions.benchmarks.motion_generation.robots.dual_arm cfg = create_robot_provider( load_suite("atomic_dual_franka_robotiq_hand_over").robot diff --git a/tests/benchmark/motion_generation/test_paired_arm_performance.py b/tests/benchmark/motion_generation/test_paired_arm_performance.py index 36bc98d716..371e37ef9e 100644 --- a/tests/benchmark/motion_generation/test_paired_arm_performance.py +++ b/tests/benchmark/motion_generation/test_paired_arm_performance.py @@ -27,14 +27,16 @@ from embodichain.lab.sim.motion.motion_generator import MotionGenOptions from embodichain.lab.sim.motion.planners import PlanResult, PlanState -from embodichain_benchmarks.motion_generation import _paired_arm_performance as paired -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation import ( + _paired_arm_performance as paired, +) +from embodichain.extensions.benchmarks.motion_generation.config import ( PlannerSpecCfg, ProtocolCfg, SuiteCfg, TrackCfg, ) -from embodichain_benchmarks.motion_generation.models import ( +from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, BenchmarkCase, PlannerMetadata, diff --git a/tests/benchmark/motion_generation/test_placement_geometry.py b/tests/benchmark/motion_generation/test_placement_geometry.py index 06b6716026..234d78bbfe 100644 --- a/tests/benchmark/motion_generation/test_placement_geometry.py +++ b/tests/benchmark/motion_generation/test_placement_geometry.py @@ -21,14 +21,14 @@ import pytest import torch -from embodichain_benchmarks.motion_generation.scenarios._placement_geometry import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._placement_geometry import ( build_flat_object_grasp_pose, build_pan_handle_grasp_pose, build_placing_object_target_pose, build_support_object_target_pose, get_pan_basin_vertices, ) -from embodichain_benchmarks.motion_generation.scenarios._placement_qualification import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._placement_qualification import ( _placement_input_geometry, ) @@ -177,14 +177,14 @@ def test_settled_placement_requires_full_footprint_and_bounded_surface_gaps(cond ], ) def test_suite_pan_frame_matches_actual_native_glb_loading(suite_name, backend): - from embodichain_benchmarks.motion_generation.config import ( + from embodichain.extensions.benchmarks.motion_generation.config import ( BENCHMARK_ROOT, load_suite, ) - from embodichain_benchmarks.motion_generation.scenarios.atomic_objects import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_objects import ( create_atomic_object, ) - from embodichain_benchmarks.motion_generation._atomic_fixtures import ( + from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( get_local_vertices, ) from embodichain.lab.sim import SimulationManager, SimulationManagerCfg diff --git a/tests/benchmark/motion_generation/test_quality_batching.py b/tests/benchmark/motion_generation/test_quality_batching.py index 81ea8cf8d4..e769b970f0 100644 --- a/tests/benchmark/motion_generation/test_quality_batching.py +++ b/tests/benchmark/motion_generation/test_quality_batching.py @@ -28,23 +28,31 @@ from embodichain.lab.sim.motion.planners.neural_planner import NeuralPlanner from embodichain.lab.sim.motion.planners.toppra_planner import retime_joint_paths from embodichain.lab.sim.motion.planners.utils import PlanResult -from embodichain_benchmarks.motion_generation import run_benchmark -from embodichain_benchmarks.motion_generation._quality_batching import ( +from embodichain.extensions.benchmarks.motion_generation import run_benchmark +from embodichain.extensions.benchmarks.motion_generation._quality_batching import ( case_groups, pack_cases, split_result, ) -from embodichain_benchmarks.motion_generation.artifacts import write_case_manifest -from embodichain_benchmarks.motion_generation.config import ( +from embodichain.extensions.benchmarks.motion_generation.artifacts import ( + write_case_manifest, +) +from embodichain.extensions.benchmarks.motion_generation.config import ( PlannerSpecCfg, SuiteCfg, TrackCfg, ) -from embodichain_benchmarks.motion_generation.models import BenchmarkCase -from embodichain_benchmarks.motion_generation.embodiments import resolve_embodiment -from embodichain_benchmarks.motion_generation.planners.nmg_onnx import NmgOnnxAdapter -from embodichain_benchmarks.motion_generation.planners import nmg_onnx as nmg_module -from embodichain_benchmarks.motion_generation import runner as runner_module +from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase +from embodichain.extensions.benchmarks.motion_generation.embodiments import ( + resolve_embodiment, +) +from embodichain.extensions.benchmarks.motion_generation.planners.nmg_onnx import ( + NmgOnnxAdapter, +) +from embodichain.extensions.benchmarks.motion_generation.planners import ( + nmg_onnx as nmg_module, +) +from embodichain.extensions.benchmarks.motion_generation import runner as runner_module pytestmark = pytest.mark.no_sim diff --git a/tests/benchmark/motion_generation/test_replay_diagnostics.py b/tests/benchmark/motion_generation/test_replay_diagnostics.py index c7a2125c89..0b9b92327d 100644 --- a/tests/benchmark/motion_generation/test_replay_diagnostics.py +++ b/tests/benchmark/motion_generation/test_replay_diagnostics.py @@ -25,7 +25,7 @@ import torch from tensordict import TensorDict -from embodichain_benchmarks.motion_generation.scenarios._replay_diagnostics import ( +from embodichain.extensions.benchmarks.motion_generation.scenarios._replay_diagnostics import ( ReplayDiagnostics, resolve_diagnostics_config, ) diff --git a/tests/benchmark/motion_generation/test_scenario_timing.py b/tests/benchmark/motion_generation/test_scenario_timing.py index 6b3bf5b679..f3a6e96566 100644 --- a/tests/benchmark/motion_generation/test_scenario_timing.py +++ b/tests/benchmark/motion_generation/test_scenario_timing.py @@ -26,12 +26,15 @@ from embodichain.lab.sim.atomic_skills.plans import CompiledTrajectory, TimedTrajectory from embodichain.lab.sim.motion.planners.utils import PlanResult -from embodichain_benchmarks.motion_generation.config import ProtocolCfg, SuiteCfg -from embodichain_benchmarks.motion_generation.metrics.trajectory import ( +from embodichain.extensions.benchmarks.motion_generation.config import ( + ProtocolCfg, + SuiteCfg, +) +from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( compute_case_outcomes, ) -from embodichain_benchmarks.motion_generation.models import BenchmarkCase -from embodichain_benchmarks.motion_generation.scenarios.atomic_skill import ( +from embodichain.extensions.benchmarks.motion_generation.models import BenchmarkCase +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_skill import ( AtomicSkillScenario, ) @@ -131,7 +134,7 @@ def test_secondary_arm_uses_same_dynamic_policy(timing_is_solved: bool) -> None: def test_secondary_arm_preserves_unbounded_dynamic_evidence() -> None: """An invalid clock in the second arm survives JSON sanitization.""" - from embodichain_benchmarks.motion_generation.models import ( + from embodichain.extensions.benchmarks.motion_generation.models import ( AlgorithmRole, CaseOutcome, TrialPhase, @@ -227,7 +230,7 @@ def test_ik_skill_timing_is_independent_of_unused_planner(monkeypatch) -> None: def test_coordinated_pickment_keeps_its_fixed_clock_out_of_planner_attribution() -> ( None ): - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( benchmark_motion_policy_strategy, ) @@ -263,7 +266,7 @@ def _budget_invocation(skill_id: str, strategy: str): def test_scenario_owned_motion_consumes_shared_scalar_budget( skill: str, strategy: str ) -> None: - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_motion_budget, ) @@ -281,7 +284,7 @@ def test_scenario_owned_motion_consumes_shared_scalar_budget( def test_vector_policy_budget_is_conservative_and_recorded() -> None: - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_motion_budget, ) @@ -303,7 +306,7 @@ def test_vector_policy_budget_is_conservative_and_recorded() -> None: def test_policy_budget_keeps_unset_defaults_and_selected_backend_vectors() -> None: - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_motion_budget, ) @@ -319,7 +322,7 @@ def test_policy_budget_keeps_unset_defaults_and_selected_backend_vectors() -> No def test_scenario_owned_ik_keeps_scalar_budget_when_options_are_injected() -> None: from embodichain.lab.sim.motion.planners import ToppraPlanOptions - from embodichain_benchmarks.motion_generation.scenarios.atomic_policy import ( + from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_policy import ( with_plan_options, ) diff --git a/tests/benchmark/motion_generation/test_toppra_dependency.py b/tests/benchmark/motion_generation/test_toppra_dependency.py index 551542d540..c6708874f2 100644 --- a/tests/benchmark/motion_generation/test_toppra_dependency.py +++ b/tests/benchmark/motion_generation/test_toppra_dependency.py @@ -33,7 +33,9 @@ def without_external(name, *args, **kwargs): return None if name == "toppra" else original(name, *args, **kwargs) monkeypatch.setattr(importlib.util, "find_spec", without_external) - from embodichain_benchmarks.motion_generation.planners.toppra import ToppraAdapter + from embodichain.extensions.benchmarks.motion_generation.planners.toppra import ( + ToppraAdapter, + ) adapter = object.__new__(ToppraAdapter) assert adapter.availability() == (True, None) diff --git a/tests/benchmark/task_program/test_demo_success_cube_sim.py b/tests/benchmark/task_program/test_demo_success_cube_sim.py index 34636b8657..eb4e0c8f77 100644 --- a/tests/benchmark/task_program/test_demo_success_cube_sim.py +++ b/tests/benchmark/task_program/test_demo_success_cube_sim.py @@ -24,7 +24,7 @@ import pytest -from embodichain_tasks.configs import get_config_path +from embodichain.extensions.tasks.configs import get_config_path from scripts.benchmark.task_program.demo_success import ( aggregate_demo_success_trials, load_raw_trials, diff --git a/tests/benchmark/task_program/test_demo_success_open_drawer_sim.py b/tests/benchmark/task_program/test_demo_success_open_drawer_sim.py index 5db842f514..5e186906ad 100644 --- a/tests/benchmark/task_program/test_demo_success_open_drawer_sim.py +++ b/tests/benchmark/task_program/test_demo_success_open_drawer_sim.py @@ -32,7 +32,7 @@ ) _REPOSITORY_ROOT = Path(__file__).resolve().parents[3] -_TASK_CONFIG_ROOT = _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs" +_TASK_CONFIG_ROOT = _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs" _OPEN_DRAWER_GYM_CONFIG = ( _TASK_CONFIG_ROOT / "tasks/manipulation/open_drawer/task.ur5.yaml" ) diff --git a/tests/benchmark/test_cobotmagic_drives.py b/tests/benchmark/test_cobotmagic_drives.py index 1b33464b1f..018f6956ff 100644 --- a/tests/benchmark/test_cobotmagic_drives.py +++ b/tests/benchmark/test_cobotmagic_drives.py @@ -63,7 +63,7 @@ def test_imported_benchmark_drains_cleanup_after_preparation_failure( """A benchmark host must not retain queued native worlds after an error.""" from embodichain import data from embodichain.lab import sim - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg from scripts.benchmark.robotics import cobotmagic_drives events = [] diff --git a/tests/ci/test_container_verification.py b/tests/ci/test_container_verification.py index 30114bc20f..0b4a3ace76 100644 --- a/tests/ci/test_container_verification.py +++ b/tests/ci/test_container_verification.py @@ -61,7 +61,11 @@ def test_qualification_requires_installed_code_and_resources( metadata.mkdir() (metadata / "METADATA").write_text("Name: embodichain\nVersion: 0.0.0\n") repo = tmp_path / "checkout" - for name in ("embodichain", "embodichain_tasks", "embodichain_robots"): + for name in ( + "embodichain", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + ): for base in (site, repo): package = base / name package.mkdir(parents=True) @@ -75,7 +79,11 @@ def test_qualification_requires_installed_code_and_resources( if installation == "wheel": (site / "embodichain/payload.txt").write_text("shipped") if installation == "editable": - for name in ("embodichain", "embodichain_tasks", "embodichain_robots"): + for name in ( + "embodichain", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + ): shutil.rmtree(site / name) (site / "editable.pth").write_text(str(repo) + "\n") @@ -103,7 +111,11 @@ def test_qualification_requires_installed_code_and_resources( "cases": 1, "imports": { name: str(site / name) - for name in ("embodichain", "embodichain_tasks", "embodichain_robots") + for name in ( + "embodichain", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + ) }, } else: diff --git a/tests/ci/test_select_tests.py b/tests/ci/test_select_tests.py index 50960ba336..5c7df26213 100644 --- a/tests/ci/test_select_tests.py +++ b/tests/ci/test_select_tests.py @@ -79,11 +79,11 @@ def test_repository_manifest_selectors_resolve() -> None: ("source_path", "expected_selector"), [ ( - "extensions/embodichain_robots/franka/panda.py", + "embodichain/extensions/robots/franka/panda.py", "tests/sim/robots/test_entrypoints.py", ), ( - "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json", + "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json", "tests/test_task_program_package_data.py", ), ( diff --git a/tests/ci/test_workflows.py b/tests/ci/test_workflows.py index 2c2349610d..24212527f5 100644 --- a/tests/ci/test_workflows.py +++ b/tests/ci/test_workflows.py @@ -409,21 +409,19 @@ def test_release_guard_validates_bundled_runtime_packages( script = guard["run"].split("python - <<'PY'\n", 1)[1].rsplit("\nPY", 1)[0] version = "0.1.0" (tmp_path / "VERSION").write_text(version) - task_config = ( - "embodichain_tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml" - ) - source = tmp_path / "extensions" / task_config + task_config = "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/env.yaml" + source = tmp_path / task_config source.parent.mkdir(parents=True) source.write_text("physics: default\n") entry_points = ( - "[embodichain.tasks]\nembodichain_tasks = embodichain_tasks\n\n" - "[embodichain.robots]\nofficial = embodichain_robots._catalog:ROBOT_CONFIGS\n" + "[embodichain.tasks]\nofficial_tasks = embodichain.extensions.tasks\n\n" + "[embodichain.robots]\nofficial = embodichain.extensions.robots._catalog:ROBOT_CONFIGS\n" "\n[embodichain.assets]\n" - "official_robots = embodichain_robots._asset_catalog:ROBOT_ASSETS\n" + "official_robots = embodichain.extensions.robots._asset_catalog:ROBOT_ASSETS\n" ) if invalid_contents == "missing_entry_point": entry_points = entry_points.replace( - "[embodichain.robots]\nofficial = embodichain_robots._catalog:ROBOT_CONFIGS\n", + "[embodichain.robots]\nofficial = embodichain.extensions.robots._catalog:ROBOT_CONFIGS\n", "", ) elif invalid_contents == "wrong_entry_point_group": @@ -433,16 +431,18 @@ def test_release_guard_validates_bundled_runtime_packages( members = { "embodichain/VERSION": version, "embodichain/gen_sim/asset_engine/configs/gen_config.json": "{}", - "embodichain_tasks/__init__.py": "", + "embodichain/extensions/__init__.py": "", + "embodichain/extensions/solvers/__init__.py": "", + "embodichain/extensions/tasks/__init__.py": "", task_config: source.read_text(), - "embodichain_robots/__init__.py": "", - "embodichain_robots/_catalog.py": "ROBOT_CONFIGS = {}\n", - "embodichain_robots/_asset_catalog.py": "ROBOT_ASSETS = {}\n", + "embodichain/extensions/robots/__init__.py": "", + "embodichain/extensions/robots/_catalog.py": "ROBOT_CONFIGS = {}\n", + "embodichain/extensions/robots/_asset_catalog.py": "ROBOT_ASSETS = {}\n", "embodichain/data/_asset_registry.py": "", - "embodichain_robots/franka/assets.py": "", - "embodichain_robots/dexforce/w1/assets.py": "", - "embodichain_benchmarks/__init__.py": "", - "embodichain_models/__init__.py": "", + "embodichain/extensions/robots/franka/assets.py": "", + "embodichain/extensions/robots/dexforce/w1/assets.py": "", + "embodichain/extensions/benchmarks/__init__.py": "", + "embodichain/extensions/models/__init__.py": "", f"embodichain-{version}.data/data/share/embodichain/examples/__init__.py": "", f"embodichain-{version}.dist-info/METADATA": f"Version: {version}\n", f"embodichain-{version}.dist-info/entry_points.txt": entry_points, @@ -451,20 +451,22 @@ def test_release_guard_validates_bundled_runtime_packages( members = { path: data for path, data in members.items() - if not path.startswith("embodichain_robots/") + if not path.startswith("embodichain/extensions/robots/") } elif invalid_contents == "missing_models": members = { path: data for path, data in members.items() - if not path.startswith("embodichain_models/") + if not path.startswith("embodichain/extensions/models/") } elif invalid_contents == "retired_robot_module": - members["embodichain_robots/franka_panda.py"] = "" + members["embodichain/extensions/robots/franka_panda.py"] = "" elif invalid_contents == "foreign_package": members["foreign/__init__.py"] = "" elif invalid_contents == "bytecode": - members["embodichain_robots/__pycache__/_catalog.cpython-311.pyc"] = "" + members[ + "embodichain/extensions/robots/__pycache__/_catalog.cpython-311.pyc" + ] = "" dist = tmp_path / "dist" dist.mkdir() with ZipFile(dist / f"embodichain-{version}-py3-none-any.whl", "w") as wheel: diff --git a/tests/cli/test_list_robot.py b/tests/cli/test_list_robot.py index 3245ac5009..11f09e9bd6 100644 --- a/tests/cli/test_list_robot.py +++ b/tests/cli/test_list_robot.py @@ -91,8 +91,8 @@ def test_list_robot_dispatch_reads_installed_catalogs( monkeypatch.setenv("COLUMNS", str(terminal_width)) catalogs.append( metadata.EntryPoint( - name="embodichain_robots", - value="embodichain_robots._catalog:ROBOT_CONFIGS", + name="embodichain.extensions.robots", + value="embodichain.extensions.robots._catalog:ROBOT_CONFIGS", group="embodichain.robots", ) ) @@ -223,7 +223,7 @@ def find_spec(self, fullname, path=None, target=None): fullname == "torch" or fullname.startswith("embodichain.lab") or fullname.startswith("embodichain.data") - or (fullname.startswith("embodichain_robots.") and fullname != "embodichain_robots._catalog") + or (fullname.startswith("embodichain.extensions.robots.") and fullname != "embodichain.extensions.robots._catalog") ): raise AssertionError("Listing imported runtime module: " + fullname) @@ -231,8 +231,8 @@ def find_spec(self, fullname, path=None, target=None): from embodichain import robot_registry as registry registry.metadata.entry_points = lambda **_: [ metadata.EntryPoint( - name="embodichain_robots", - value="embodichain_robots._catalog:ROBOT_CONFIGS", + name="embodichain.extensions.robots", + value="embodichain.extensions.robots._catalog:ROBOT_CONFIGS", group="embodichain.robots", ) ] @@ -310,7 +310,7 @@ def test_dual_arm_variant_rows_use_each_base_dof(catalogs: list[Any]) -> None: catalogs.append( metadata.EntryPoint( name="official", - value="embodichain_robots._catalog:ROBOT_CONFIGS", + value="embodichain.extensions.robots._catalog:ROBOT_CONFIGS", group="embodichain.robots", ) ) @@ -354,7 +354,7 @@ def test_w1_variants_show_body_releases_and_hand_specific_dofs( catalogs.append( metadata.EntryPoint( name="official", - value="embodichain_robots._catalog:ROBOT_CONFIGS", + value="embodichain.extensions.robots._catalog:ROBOT_CONFIGS", group="embodichain.robots", ) ) diff --git a/tests/compute/test_imports.py b/tests/compute/test_imports.py index d20a238ead..4a653e9c59 100644 --- a/tests/compute/test_imports.py +++ b/tests/compute/test_imports.py @@ -61,8 +61,8 @@ [ "embodichain.lab", "embodichain.gen_sim", - "embodichain_robots", - "embodichain_tasks", + "embodichain.extensions.robots", + "embodichain.extensions.tasks", "dexsim", "fcl", ], diff --git a/tests/conftest.py b/tests/conftest.py index fdd82850f5..4a08daa4d7 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -60,7 +60,7 @@ def requires_dexuni_two_way() -> None: def _discover_task_packages(): """Discover all installed task packages once per test session. - Official task environments now ship as the ``embodichain_tasks`` import + Official task environments now ship as the ``embodichain.extensions.tasks`` import package inside the main EmbodiChain distribution. Third-party packages can also declare an ``embodichain.tasks`` entry point. Tasks are no longer auto-registered by importing diff --git a/tests/data/assets/test_policy_assets.py b/tests/data/assets/test_policy_assets.py index 468dc8a23e..56e1d3ad02 100644 --- a/tests/data/assets/test_policy_assets.py +++ b/tests/data/assets/test_policy_assets.py @@ -41,7 +41,7 @@ def hub(tmp_path, monkeypatch): "models": { MODEL: { "format": "embodichain-rl-run-v1", - "task_package": "embodichain_tasks", + "task_package": "embodichain.extensions.tasks", } }, } @@ -196,7 +196,7 @@ def test_invalid_index_does_not_download_weights(value, message, hub): def test_missing_task_package_is_reported_before_weights(hub, monkeypatch): _, calls = hub monkeypatch.setattr(policy_assets.importlib.util, "find_spec", lambda name: None) - with pytest.raises(ImportError, match="embodichain_tasks"): + with pytest.raises(ImportError, match="embodichain.extensions.tasks"): policy_assets.download_pretrained_policy(MODEL) assert [name for name, _ in calls] == ["index.json"] diff --git a/tests/data/test_agibot_g2_assets.py b/tests/data/test_agibot_g2_assets.py index 9b02a82183..5cbb77ad40 100644 --- a/tests/data/test_agibot_g2_assets.py +++ b/tests/data/test_agibot_g2_assets.py @@ -26,7 +26,7 @@ import pytest -from embodichain_robots.agibot.g2 import assets +from embodichain.extensions.robots.agibot.g2 import assets pytestmark = pytest.mark.no_sim diff --git a/tests/data/test_download.py b/tests/data/test_download.py index 4078ad23ec..57264f4926 100644 --- a/tests/data/test_download.py +++ b/tests/data/test_download.py @@ -50,7 +50,7 @@ def asset_catalogs(monkeypatch): def test_migrated_robot_assets_keep_legacy_class_identity() -> None: - from embodichain_robots._asset_catalog import ROBOT_ASSETS + from embodichain.extensions.robots._asset_catalog import ROBOT_ASSETS import embodichain.data.assets as assets registry = download.get_registry() @@ -146,15 +146,15 @@ def test_asset_resolution_preserves_explicit_extra_modules(monkeypatch) -> None: @pytest.mark.parametrize( "first_module", [ - "embodichain_robots.arx.arx5.assets", - "embodichain_robots.brainco.revo1.assets", - "embodichain_robots.agilex.pika.assets", - "embodichain_robots.agibot.g1.assets", - "embodichain_robots.franka.assets", - "embodichain_robots.the_robot_studio.so101.assets", - "embodichain_robots.unitree.go2.assets", - "embodichain_robots.anybotics.anymal_c.assets", - "embodichain_robots.pollen_robotics.microduck.assets", + "embodichain.extensions.robots.arx.arx5.assets", + "embodichain.extensions.robots.brainco.revo1.assets", + "embodichain.extensions.robots.agilex.pika.assets", + "embodichain.extensions.robots.agibot.g1.assets", + "embodichain.extensions.robots.franka.assets", + "embodichain.extensions.robots.the_robot_studio.so101.assets", + "embodichain.extensions.robots.unitree.go2.assets", + "embodichain.extensions.robots.anybotics.anymal_c.assets", + "embodichain.extensions.robots.pollen_robotics.microduck.assets", ], ) def test_asset_imports_do_not_load_robot_configuration(first_module: str) -> None: @@ -163,10 +163,10 @@ def test_asset_imports_do_not_load_robot_configuration(first_module: str) -> Non import sys class RejectConfigs(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): - if fullname.startswith('embodichain_robots.') and (fullname.endswith('.cfg') or fullname in ('embodichain_robots.franka.panda', 'embodichain_robots.universal_robots.ur_robot')): + if fullname.startswith('embodichain.extensions.robots.') and (fullname.endswith('.cfg') or fullname in ('embodichain.extensions.robots.franka.panda', 'embodichain.extensions.robots.universal_robots.ur_robot')): raise AssertionError('Asset discovery imported robot config: ' + fullname) sys.meta_path.insert(0, RejectConfigs()) -from embodichain_robots._asset_catalog import ROBOT_ASSETS +from embodichain.extensions.robots._asset_catalog import ROBOT_ASSETS assert 'open3d' not in sys.modules import importlib importlib.import_module(sys.argv[1]) @@ -356,10 +356,10 @@ def unexpected_download(*args, **kwargs): assert len(entries) == len(expected_ids) for name, cls in entries: assert cls is get_data_class(name) - assert cls.__module__.startswith("embodichain_robots.") + assert cls.__module__.startswith("embodichain.extensions.robots.") assert not hasattr(assets, name) assert get_data_class("PikaGripper").__module__ == ( - "embodichain_robots.agilex.pika.assets" + "embodichain.extensions.robots.agilex.pika.assets" ) download.cmd_list(Namespace(category="eef")) output = capsys.readouterr().out diff --git a/tests/data/test_download_prefix.py b/tests/data/test_download_prefix.py index bef144d386..54b38bc569 100644 --- a/tests/data/test_download_prefix.py +++ b/tests/data/test_download_prefix.py @@ -38,10 +38,10 @@ from embodichain.data import dataset from embodichain.data.assets import CobotMagicArm, FlexivRizon4S, UnitreeGo2Locomotion, UniversalRobots, PourCupAssets, PourCupDemoData from embodichain.data.assets.w1_assets import DexforceW1V030 -from embodichain_robots.agilex.pika.assets import PikaGripper -from embodichain_robots.sharpa.wave.assets import SharpaWave -from embodichain_robots.wuji.hand.assets import WujiHand -from embodichain_robots.i2rt.yam.assets import YamI2rt +from embodichain.extensions.robots.agilex.pika.assets import PikaGripper +from embodichain.extensions.robots.sharpa.wave.assets import SharpaWave +from embodichain.extensions.robots.wuji.hand.assets import WujiHand +from embodichain.extensions.robots.i2rt.yam.assets import YamI2rt urls = {} diff --git a/tests/data/test_so101_assets.py b/tests/data/test_so101_assets.py index 148c6bd998..d8a8bdb26c 100644 --- a/tests/data/test_so101_assets.py +++ b/tests/data/test_so101_assets.py @@ -23,7 +23,7 @@ import pytest -from embodichain_robots.the_robot_studio.so101 import assets as so101_assets +from embodichain.extensions.robots.the_robot_studio.so101 import assets as so101_assets pytestmark = pytest.mark.no_sim diff --git a/tests/data/test_yam_i2rt_assets.py b/tests/data/test_yam_i2rt_assets.py index 3d380bde09..b4fb3177c5 100644 --- a/tests/data/test_yam_i2rt_assets.py +++ b/tests/data/test_yam_i2rt_assets.py @@ -26,11 +26,11 @@ import pytest from embodichain.data import get_data_path -from embodichain_robots.i2rt.yam.assets import YamI2rt +from embodichain.extensions.robots.i2rt.yam.assets import YamI2rt from embodichain.data import dataset from embodichain.data.download import find_asset_class, get_registry -robot_assets = importlib.import_module("embodichain_robots.i2rt.yam.assets") +robot_assets = importlib.import_module("embodichain.extensions.robots.i2rt.yam.assets") pytestmark = pytest.mark.no_sim @@ -86,7 +86,7 @@ def test_asset_import_does_not_load_robot_configuration() -> None: [ sys.executable, "-c", - "import sys; import embodichain_robots.i2rt.yam.assets; assert 'embodichain_robots.i2rt.yam.cfg' not in sys.modules", + "import sys; import embodichain.extensions.robots.i2rt.yam.assets; assert 'embodichain.extensions.robots.i2rt.yam.cfg' not in sys.modules", ], capture_output=True, text=True, diff --git a/tests/data_pipeline/test_online_data.py b/tests/data_pipeline/test_online_data.py index b58fe196bc..06e630f451 100644 --- a/tests/data_pipeline/test_online_data.py +++ b/tests/data_pipeline/test_online_data.py @@ -1224,7 +1224,7 @@ def test_worker_registers_tasks_before_creating_environment( def discover_task_packages() -> list[str]: nonlocal task_packages_registered task_packages_registered = True - return ["embodichain_tasks"] + return ["official_tasks"] env = MagicMock() env_cfg = SimpleNamespace( diff --git a/tests/docs/test_build_architecture.py b/tests/docs/test_build_architecture.py index d539e46810..826bf1e09e 100644 --- a/tests/docs/test_build_architecture.py +++ b/tests/docs/test_build_architecture.py @@ -104,8 +104,8 @@ def test_dirty_check_checks_index_and_worktree_independently(seed): [ ("pkg", "pkg"), ( - "extensions/embodichain_models/embodichain_models/dynamics/nerd", - "embodichain_models.dynamics.nerd", + "embodichain/extensions/models/dynamics/nerd", + "embodichain.extensions.models.dynamics.nerd", ), ], ) diff --git a/tests/docs/test_check_api_docs.py b/tests/docs/test_check_api_docs.py index f3c984ffca..85442c4104 100644 --- a/tests/docs/test_check_api_docs.py +++ b/tests/docs/test_check_api_docs.py @@ -264,30 +264,23 @@ def test_main_writes_missing_json_to_stdout( @pytest.mark.parametrize( - "package,module,exports", + "module,exports", [ ( - "embodichain_benchmarks", - "embodichain_benchmarks.motion_generation", + "embodichain.extensions.benchmarks.motion_generation", {"run_benchmark", "PlannerAdapter"}, ), ( - "embodichain_models", - "embodichain_models.dynamics.nerd.model", + "embodichain.extensions.models.dynamics.nerd.model", {"NeRDModel", "NeRDModelCfg"}, ), ( - "embodichain_solvers", - "embodichain_solvers.physics.nerd.provider", + "embodichain.extensions.solvers.physics.nerd.provider", {"NeRDProvider", "NeuralRobotDynamicSolver"}, ), ], ) -def test_default_inventory_includes_bundled_extension_public_exports( - package, module, exports -): - """Moving evaluation to an extension must not remove it from API coverage.""" - roots = [root for root in _checker.DEFAULT_PACKAGE_ROOTS if root.module == package] - assert len(roots) == 1 - modules = {module.name: module for module in discover_public_modules(roots)} +def test_default_inventory_includes_bundled_extension_public_exports(module, exports): + """The main package inventory includes the official extension exports.""" + modules = {item.name: item for item in discover_public_modules()} assert exports <= set(modules[module].exports) diff --git a/tests/examples/atomic_skill/test_run.py b/tests/examples/atomic_skill/test_run.py index c300e52030..5a10c4291c 100644 --- a/tests/examples/atomic_skill/test_run.py +++ b/tests/examples/atomic_skill/test_run.py @@ -44,8 +44,8 @@ ) from embodichain.lab.sim.atomic_skills import TimedTrajectory from embodichain.lab.sim.cfg import RobotCfg -from embodichain_benchmarks.motion_generation import _atomic_fixtures -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation import _atomic_fixtures +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) from embodichain.utils.string import resolve_matching_names diff --git a/tests/fixtures/kinematics/panda_original.urdf b/tests/fixtures/kinematics/panda_original.urdf index 35d1d6915c..9e835842fb 100644 --- a/tests/fixtures/kinematics/panda_original.urdf +++ b/tests/fixtures/kinematics/panda_original.urdf @@ -2,7 +2,7 @@ +See embodichain/extensions/robots/franka/assets.py for original asset identity. --> diff --git a/tests/fixtures/kinematics/robotiq85_linkage.urdf b/tests/fixtures/kinematics/robotiq85_linkage.urdf index 1366eb6cd6..8fff748ad1 100644 --- a/tests/fixtures/kinematics/robotiq85_linkage.urdf +++ b/tests/fixtures/kinematics/robotiq85_linkage.urdf @@ -2,7 +2,7 @@ +See embodichain/extensions/robots/franka/assets.py for original asset identity. --> diff --git a/tests/gen_sim/services/test_wheel_configuration.py b/tests/gen_sim/services/test_wheel_configuration.py index beb15e3672..76f20f3f0d 100644 --- a/tests/gen_sim/services/test_wheel_configuration.py +++ b/tests/gen_sim/services/test_wheel_configuration.py @@ -48,10 +48,10 @@ def test_installed_wheel_cli_reads_external_profiles_without_package_edits(tmp_p for name in ( "embodichain", "examples", - "extensions/embodichain_robots", - "extensions/embodichain_tasks", - "extensions/embodichain_benchmarks", - "extensions/embodichain_models", + "embodichain/extensions/robots", + "embodichain/extensions/tasks", + "embodichain/extensions/benchmarks", + "embodichain/extensions/models", ): shutil.copytree( repo / name, @@ -118,14 +118,11 @@ def execute(command, cwd, env=None): "\n".join(dict.fromkeys(runtime_sites)) + "\n" ) # Remove source imports without excluding dependencies installed inside the checkout. - source_paths = [repo.resolve()] + [ - path.resolve() for path in (repo / "extensions").iterdir() if path.is_dir() - ] (site / "sitecustomize.py").write_text( "import sys\nfrom pathlib import Path\n" - f"source_paths={list(map(str, source_paths))!r}\n" + f"source_path={str(repo.resolve())!r}\n" "sys.meta_path=[x for x in sys.meta_path if '__editable__' not in str(x)]\n" - "sys.path=[x for x in sys.path if x and str(Path(x).resolve()) not in source_paths]\n" + "sys.path=[x for x in sys.path if x and str(Path(x).resolve()) != source_path]\n" ) package = site / "embodichain/gen_sim" bundled = package / "asset_engine/configs/gen_config.json" diff --git a/tests/gen_sim/task_engine/test_bundle.py b/tests/gen_sim/task_engine/test_bundle.py index 273d31f76e..d30a5b3de3 100644 --- a/tests/gen_sim/task_engine/test_bundle.py +++ b/tests/gen_sim/task_engine/test_bundle.py @@ -175,7 +175,7 @@ def _configured_files(): root = ( Path(__file__).parents[3] - / "extensions/embodichain_tasks/configs/tasks/manipulation/rubiks_cube_pick_place" + / "embodichain/extensions/tasks/configs/tasks/manipulation/rubiks_cube_pick_place" ) original = yaml.safe_load((root / "task.ur5.yaml").read_text()) scene = yaml.safe_load((root / original["environment"]["component"]).read_text()) diff --git a/tests/gen_sim/task_engine/test_image_planning.py b/tests/gen_sim/task_engine/test_image_planning.py index d28b4dcdbe..620e44a986 100644 --- a/tests/gen_sim/task_engine/test_image_planning.py +++ b/tests/gen_sim/task_engine/test_image_planning.py @@ -1476,7 +1476,7 @@ def test_hybrid_cli_compiles_pick_place_and_rejects_hinge( root = Path(__file__).resolve().parents[3] deployment = ( root - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.cobotmagic.yaml" ) instruction = "把第二块积木放在第一块积木顶面" from embodichain.gen_sim.task_engine import _image_run diff --git a/tests/gen_sim/test_workflow.py b/tests/gen_sim/test_workflow.py index d5c52f39a8..5e14677770 100644 --- a/tests/gen_sim/test_workflow.py +++ b/tests/gen_sim/test_workflow.py @@ -234,7 +234,7 @@ def run_cfg(tmp_path: Path) -> _RunCfg: "embodiment": { "component": str( _ROOT - / "extensions/embodichain_tasks/configs/components/embodiments/franka_panda.yaml" + / "embodichain/extensions/tasks/configs/components/embodiments/franka_panda.yaml" ) }, "max_episode_steps": 1000, @@ -244,7 +244,7 @@ def run_cfg(tmp_path: Path) -> _RunCfg: policy = yaml.safe_load( ( _ROOT - / "extensions/embodichain_tasks/configs/components/execution_policies/motion_gen_verified.yaml" + / "embodichain/extensions/tasks/configs/components/execution_policies/motion_gen_verified.yaml" ).read_text() ) policy["requires"]["embodiment_contract"] = "single_arm_parallel_gripper" @@ -1887,7 +1887,7 @@ def _dual_runtime(run_cfg): runtime["embodiment"] = { "component": str( _ROOT - / "extensions/embodichain_tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml" + / "embodichain/extensions/tasks/configs/components/embodiments/dual_franka_robotiq_arg2f_140_handover.yaml" ) } run_cfg.runtime.write_text(yaml.safe_dump(runtime)) diff --git a/tests/gym/envs/managers/test_observation_functors.py b/tests/gym/envs/managers/test_observation_functors.py index fedce47cac..c2b1d61854 100644 --- a/tests/gym/envs/managers/test_observation_functors.py +++ b/tests/gym/envs/managers/test_observation_functors.py @@ -280,7 +280,7 @@ def test_locomotion_observation_keeps_legacy_import_and_selects_requested_group( from embodichain.lab.gym.envs.managers.observations import ( velocity_locomotion_observation, ) - from embodichain_tasks.locomotion.managers.observations import ( + from embodichain.extensions.tasks.locomotion.managers.observations import ( velocity_locomotion_observation as legacy, ) diff --git a/tests/gym/envs/managers/test_scene_layout_randomization.py b/tests/gym/envs/managers/test_scene_layout_randomization.py index ed07f5360a..cc6eb44f1a 100644 --- a/tests/gym/envs/managers/test_scene_layout_randomization.py +++ b/tests/gym/envs/managers/test_scene_layout_randomization.py @@ -239,7 +239,7 @@ def test_yaml_event_decodes_through_production_environment_loader(tmp_path) -> N root = Path(__file__).resolve().parents[4] task = ( root - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) component = task.parent / "envs/default.yaml" physical = yaml.safe_load(component.read_text()) diff --git a/tests/gym/envs/task_program/test_asset_materialization.py b/tests/gym/envs/task_program/test_asset_materialization.py index 15c7f14d7d..092ecf4d42 100644 --- a/tests/gym/envs/task_program/test_asset_materialization.py +++ b/tests/gym/envs/task_program/test_asset_materialization.py @@ -50,7 +50,7 @@ ) ROOT = Path(__file__).resolve().parents[4] -CONFIGS = ROOT / "extensions/embodichain_tasks/configs" +CONFIGS = ROOT / "embodichain/extensions/tasks/configs" TASK = CONFIGS / "tasks/manipulation/repeated_pick_place" diff --git a/tests/gym/envs/task_program/test_asset_pouring_materialization.py b/tests/gym/envs/task_program/test_asset_pouring_materialization.py index e33ef48996..ac1a0d0a20 100644 --- a/tests/gym/envs/task_program/test_asset_pouring_materialization.py +++ b/tests/gym/envs/task_program/test_asset_pouring_materialization.py @@ -50,7 +50,7 @@ from embodichain.lab.task_program.semantics.asset_matching import resolve_asset_set ROOT = Path(__file__).resolve().parents[4] -CONFIGS = ROOT / "extensions/embodichain_tasks/configs" +CONFIGS = ROOT / "embodichain/extensions/tasks/configs" POUR = CONFIGS / "tasks/manipulation/tableware/pour_water" PROFILE_ID = "ur5_dh_pgi_140_80" diff --git a/tests/gym/envs/task_program/test_catalog.py b/tests/gym/envs/task_program/test_catalog.py index e6af80e2ce..2c02a282bd 100644 --- a/tests/gym/envs/task_program/test_catalog.py +++ b/tests/gym/envs/task_program/test_catalog.py @@ -109,7 +109,7 @@ _REPOSITORY_ROOT = Path(__file__).parents[4] _CUBE_ENV_PATH = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place" / "task.ur5.yaml" ) diff --git a/tests/gym/envs/task_program/test_configured_integration.py b/tests/gym/envs/task_program/test_configured_integration.py index dc237d6fbb..43c1ccd845 100644 --- a/tests/gym/envs/task_program/test_configured_integration.py +++ b/tests/gym/envs/task_program/test_configured_integration.py @@ -118,7 +118,7 @@ TrapezoidalPlanOptions, ) from embodichain.lab.sim.sensors import CameraCfg -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg from embodichain.lab.task_program.semantics import ( HeldObjectRelation, RegisteredSemanticCall, @@ -136,7 +136,7 @@ _REPOSITORY_ROOT = Path(__file__).parents[4] _CONFIG_DIRECTORY = ( - _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs/tasks/manipulation" + _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs/tasks/manipulation" ) _TABLEWARE_CONFIG_DIRECTORY = _CONFIG_DIRECTORY / "tableware" _TASKS = { @@ -2043,7 +2043,8 @@ def test_marvin_embodiment_grasp_defaults_compose_with_bimanual_task( ) -> None: """Both Marvin hands use source joint commands and toolkit policy defaults.""" monkeypatch.setattr( - "embodichain_robots.tianji.marvin.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.tianji.marvin.cfg.get_data_path", + lambda value: value, ) path = _config_path("hand_over") config = _gym_config("hand_over") @@ -2614,7 +2615,7 @@ def test_examples_have_no_importable_task_environment_modules() -> None: deployments remain configuration-defined. """ for task_name in ("open_drawer", "hand_over"): - module_name = f"embodichain_tasks.manipulation.{task_name}" + module_name = f"embodichain.extensions.tasks.manipulation.{task_name}" assert importlib.util.find_spec(module_name) is None diff --git a/tests/gym/envs/task_program/test_drawer_storage_long_horizon_sim.py b/tests/gym/envs/task_program/test_drawer_storage_long_horizon_sim.py index 7e20a6d895..ed68c221fc 100644 --- a/tests/gym/envs/task_program/test_drawer_storage_long_horizon_sim.py +++ b/tests/gym/envs/task_program/test_drawer_storage_long_horizon_sim.py @@ -174,7 +174,7 @@ def _run_episode() -> dict[str, Any]: execute_init_hooks() source = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation" + / "embodichain/extensions/tasks/configs/tasks/manipulation" / "drawer_storage" / "task.ur5.long_horizon.yaml" ) diff --git a/tests/gym/envs/task_program/test_dual_arm_variants.py b/tests/gym/envs/task_program/test_dual_arm_variants.py index c63c5c49f7..279b6b0218 100644 --- a/tests/gym/envs/task_program/test_dual_arm_variants.py +++ b/tests/gym/envs/task_program/test_dual_arm_variants.py @@ -30,7 +30,7 @@ from embodichain.utils.utility import load_config _CONFIG_ROOT = ( - Path(__file__).resolve().parents[4] / "extensions/embodichain_tasks/configs" + Path(__file__).resolve().parents[4] / "embodichain/extensions/tasks/configs" ) _VARIANTS = ("dual_ur5_dh_pgi_140_80", "tianji_marvin") _BASELINES = ( @@ -63,7 +63,7 @@ def test_dual_arm_deployment_decodes_and_registers(task: str, variant: str) -> N payload = load_config(path) if task.split("/")[-1] in _BASELINES: importlib.import_module( - f"embodichain_tasks.manipulation.{task.replace('/', '.')}" + f"embodichain.extensions.tasks.manipulation.{task.replace('/', '.')}" ) cfg = config_to_cfg(payload, source_path=path) cfg.robot.validate() diff --git a/tests/gym/envs/task_program/test_feasibility_sim.py b/tests/gym/envs/task_program/test_feasibility_sim.py index 662fa71be0..705e79c014 100644 --- a/tests/gym/envs/task_program/test_feasibility_sim.py +++ b/tests/gym/envs/task_program/test_feasibility_sim.py @@ -43,16 +43,7 @@ def find_spec(self, fullname, path=None, target=None): def _source_environment(root: Path) -> dict[str, str]: """Keep bundled extensions in the same checkout as the tested core.""" env = dict(os.environ) - sources = ( - root, - root / "extensions", - root / "extensions/embodichain_tasks", - root / "extensions/embodichain_benchmarks", - root / "extensions/embodichain_models", - ) - env["PYTHONPATH"] = ( - os.pathsep.join(map(str, sources)) + os.pathsep + env.get("PYTHONPATH", "") - ) + env["PYTHONPATH"] = os.pathsep.join((str(root), env.get("PYTHONPATH", ""))) env["EMBODICHAIN_SIM_EXIT_PROCESS"] = "0" return env diff --git a/tests/gym/envs/task_program/test_policy_deployment.py b/tests/gym/envs/task_program/test_policy_deployment.py index 0563d3787b..071fff55c4 100644 --- a/tests/gym/envs/task_program/test_policy_deployment.py +++ b/tests/gym/envs/task_program/test_policy_deployment.py @@ -33,7 +33,7 @@ _TASK = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" ) diff --git a/tests/gym/envs/task_program/test_pour_water_sim.py b/tests/gym/envs/task_program/test_pour_water_sim.py index 0171afa5f4..fe1bb3c55e 100644 --- a/tests/gym/envs/task_program/test_pour_water_sim.py +++ b/tests/gym/envs/task_program/test_pour_water_sim.py @@ -32,7 +32,7 @@ _REPOSITORY_ROOT = Path(__file__).resolve().parents[4] _CONFIG_DIRECTORY = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_water" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water" ) # Keep the bottle near its authored pour center while rotating by 60 degrees. _MAX_POUR_POSITION_ERROR_M = 0.02 diff --git a/tests/gym/envs/task_program/test_scene_expansion_sim.py b/tests/gym/envs/task_program/test_scene_expansion_sim.py index 581b94fd27..fe791cd0c9 100644 --- a/tests/gym/envs/task_program/test_scene_expansion_sim.py +++ b/tests/gym/envs/task_program/test_scene_expansion_sim.py @@ -59,7 +59,7 @@ def _run_scene_expansion_smoke(output: Path) -> None: path = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) cfg = config_to_cfg(load_config(path), source_path=path) cfg.seed = 0 diff --git a/tests/gym/envs/task_program/test_tableware_sim.py b/tests/gym/envs/task_program/test_tableware_sim.py index e1148933ec..afcaa04564 100644 --- a/tests/gym/envs/task_program/test_tableware_sim.py +++ b/tests/gym/envs/task_program/test_tableware_sim.py @@ -131,7 +131,7 @@ def _run_real_sim_episode( discover_task_packages() source = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation" + / "embodichain/extensions/tasks/configs/tasks/manipulation" / ( task_name if task_name in {"hand_over", "repeated_pick_place", "carton_stocking"} diff --git a/tests/gym/envs/task_program/test_task_hand_over.py b/tests/gym/envs/task_program/test_task_hand_over.py index ad828c283d..04e1d924eb 100644 --- a/tests/gym/envs/task_program/test_task_hand_over.py +++ b/tests/gym/envs/task_program/test_task_hand_over.py @@ -99,7 +99,7 @@ def _gym_config_path() -> Path: """Return the installed-source dual-UR5 Gym config path.""" return ( Path(__file__).parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/hand_over/" + / "embodichain/extensions/tasks/configs/tasks/manipulation/hand_over/" "task.dual_ur5_dh_pgi_140_80.yaml" ) @@ -133,10 +133,13 @@ def test_hand_over_registers_plain_embodied_env_from_config() -> None: cfg = _configured_env_cfg() spec = REGISTERED_ENVS[_ENV_ID] - from embodichain_tasks.manipulation import __all__ + from embodichain.extensions.tasks.manipulation import __all__ assert __all__ == [] - assert importlib.util.find_spec("embodichain_tasks.manipulation.hand_over") is None + assert ( + importlib.util.find_spec("embodichain.extensions.tasks.manipulation.hand_over") + is None + ) assert spec.cls is EmbodiedEnv assert spec.max_episode_steps == 3600 assert spec.task_program_registration is not None diff --git a/tests/gym/envs/task_program/test_task_tianji_marvin.py b/tests/gym/envs/task_program/test_task_tianji_marvin.py index 106993d3a5..d2fb83667c 100644 --- a/tests/gym/envs/task_program/test_task_tianji_marvin.py +++ b/tests/gym/envs/task_program/test_task_tianji_marvin.py @@ -55,11 +55,11 @@ HeldObjectStateExpectation, ) from embodichain.utils.utility import load_config -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg _CONFIGS = ( Path(__file__).parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation" + / "embodichain/extensions/tasks/configs/tasks/manipulation" ) _DEPLOYMENTS = ( ("repeated_pick_place", "TaskProgramRepeatedPickPlace-TianjiMarvin-v1", 6), @@ -131,7 +131,8 @@ def test_marvin_deployments_preflight_and_register( ) -> None: """Each real task selects compatible contracts and registers EmbodiedEnv.""" monkeypatch.setattr( - "embodichain_robots.tianji.marvin.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.tianji.marvin.cfg.get_data_path", + lambda value: value, ) path, payload, physical, deployment = _deployment(task) registration = deployment.integration.registration @@ -205,7 +206,8 @@ def test_marvin_grasp_tcp_aligns_with_physical_hand_axes( from embodichain.lab.sim.motion.solvers import SSIKSolverCfg monkeypatch.setattr( - "embodichain_robots.tianji.marvin.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.tianji.marvin.cfg.get_data_path", + lambda value: value, ) path, payload, _, _ = _deployment("repeated_pick_place") cfg = config_to_cfg(payload, source_path=path) @@ -334,7 +336,8 @@ def test_marvin_pour_lowers_scene_and_targets_without_changing_program_steps( ) -> None: """The 750 mm table variant shifts assets and targets together by 125 mm.""" monkeypatch.setattr( - "embodichain_robots.tianji.marvin.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.tianji.marvin.cfg.get_data_path", + lambda value: value, ) path, payload, _, deployment = _deployment("tableware/pour_water") reference = load_config(path.parent / "task.cobotmagic.yaml") diff --git a/tests/gym/envs/task_program/test_task_vertical_slices.py b/tests/gym/envs/task_program/test_task_vertical_slices.py index 4996eb2186..a68397deeb 100644 --- a/tests/gym/envs/task_program/test_task_vertical_slices.py +++ b/tests/gym/envs/task_program/test_task_vertical_slices.py @@ -170,7 +170,7 @@ def observe( def _read_payload(relative_path: Path) -> dict[str, object]: """Load one packaged JSON/YAML example as inert data.""" - path = _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs" / relative_path + path = _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs" / relative_path if path.suffix == ".json": payload = json.loads(path.read_text(encoding="utf-8")) else: @@ -181,7 +181,7 @@ def _read_payload(relative_path: Path) -> dict[str, object]: def _deployment(relative_path: Path): """Compose one packaged environment deployment.""" - path = _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs" / relative_path + path = _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs" / relative_path payload = _read_payload(relative_path) physical = _resolve_gym_components(payload, base_dir=path.parent) assert physical.embodiment_skill_profile is not None @@ -235,7 +235,7 @@ def _configure_cube_environment(): """Load the packaged config and register its declared integration.""" path = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs" + / "embodichain/extensions/tasks/configs" / _REPEATED_CUBE_GYM_CONFIG ) payload = _read_payload(_REPEATED_CUBE_GYM_CONFIG) @@ -245,7 +245,7 @@ def _configure_cube_environment(): def _configure_packaged_environment(relative_path: Path, *, physics: str | None = None): """Load one packaged deployment and its selected physical component.""" - path = _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs" / relative_path + path = _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs" / relative_path payload = _read_payload(relative_path) if physics is not None: payload = _resolve_environment_component( diff --git a/tests/gym/envs/task_program/test_task_w1_pika.py b/tests/gym/envs/task_program/test_task_w1_pika.py index 8072517cf0..bb907adc84 100644 --- a/tests/gym/envs/task_program/test_task_w1_pika.py +++ b/tests/gym/envs/task_program/test_task_w1_pika.py @@ -27,8 +27,8 @@ from embodichain.lab.gym.envs import EmbodiedEnv from embodichain.lab.sim.cfg import DefaultPhysicsCfg -from embodichain_robots.dexforce.w1 import DexforceW1Cfg -from embodichain_robots.dexforce.w1.types import DexforceW1Version +from embodichain.extensions.robots.dexforce.w1 import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1.types import DexforceW1Version from embodichain.lab.gym.utils.gym_utils import config_to_cfg from embodichain.lab.gym.utils.registration import REGISTERED_ENVS from embodichain.lab.gym.utils._component_composition import ( @@ -43,7 +43,7 @@ _CONFIGS = ( Path(__file__).parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation" + / "embodichain/extensions/tasks/configs/tasks/manipulation" ) _TASKS = ( ("repeated_pick_place", 6), @@ -63,7 +63,7 @@ def test_w1_pika_deployment_composes_and_preserves_task_route( task: str, segments: int | None, monkeypatch: pytest.MonkeyPatch, tmp_path: Path ) -> None: import embodichain.lab.sim.cfg as sim_cfg - from embodichain_robots.dexforce.w1 import utils as w1_utils + from embodichain.extensions.robots.dexforce.w1 import utils as w1_utils def asset(value: str) -> str: path = tmp_path / value @@ -78,7 +78,7 @@ def asset(value: str) -> str: physical = _resolve_gym_components(payload, base_dir=path.parent) if segments is None: importlib.import_module( - "embodichain_tasks.manipulation." + task.replace("/", ".") + "embodichain.extensions.tasks.manipulation." + task.replace("/", ".") ) cfg = config_to_cfg(payload, source_path=path) assert isinstance(cfg.robot, DexforceW1Cfg) diff --git a/tests/gym/envs/task_program/test_usd_scene_import.py b/tests/gym/envs/task_program/test_usd_scene_import.py index 3234eede1b..3f3e66f3b8 100644 --- a/tests/gym/envs/task_program/test_usd_scene_import.py +++ b/tests/gym/envs/task_program/test_usd_scene_import.py @@ -162,7 +162,7 @@ def _exercise_imported_scene_verified_pick_place( (tmp_path / "env.yaml").write_text(yaml.safe_dump(environment)) task_root = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place" ) source_task = task_root / "task.dual_ur5_dh_pgi_140_80.yaml" config = load_config(source_task) diff --git a/tests/gym/envs/tasks/test_cloth_fold.py b/tests/gym/envs/tasks/test_cloth_fold.py index 82d49cdd26..a3c33df916 100644 --- a/tests/gym/envs/tasks/test_cloth_fold.py +++ b/tests/gym/envs/tasks/test_cloth_fold.py @@ -35,7 +35,7 @@ @pytest.mark.parametrize("config_first", (True, False)) def test_cloth_fold_registration_order(tmp_path: Path, config_first: bool) -> None: package = ( - Path(__file__).resolve().parents[4] / "extensions/embodichain_tasks/configs" + Path(__file__).resolve().parents[4] / "embodichain/extensions/tasks/configs" ) config = package / "tasks/manipulation/cloth_fold/task.w1.yaml" script = """ diff --git a/tests/gym/envs/tasks/test_drawer_storage.py b/tests/gym/envs/tasks/test_drawer_storage.py index d3bbdd9a6e..ffacb4da0c 100644 --- a/tests/gym/envs/tasks/test_drawer_storage.py +++ b/tests/gym/envs/tasks/test_drawer_storage.py @@ -37,7 +37,7 @@ _CONFIG = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage" + / "embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage" ) @@ -234,7 +234,7 @@ def _run_franka_contact_episode() -> None: source = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/task.franka.yaml" ) payload = load_config(source) payload.update( diff --git a/tests/gym/envs/tasks/test_humanoid_run.py b/tests/gym/envs/tasks/test_humanoid_run.py index 66476efae6..133f348c60 100644 --- a/tests/gym/envs/tasks/test_humanoid_run.py +++ b/tests/gym/envs/tasks/test_humanoid_run.py @@ -19,11 +19,11 @@ from types import SimpleNamespace import torch import pytest -from embodichain_tasks.classic_control.humanoid.humanoid_run import ( +from embodichain.extensions.tasks.classic_control.humanoid.humanoid_run import ( HumanoidRunEnv, _CONFIG, ) -from embodichain_tasks.classic_control.humanoid.mdp import ( +from embodichain.extensions.tasks.classic_control.humanoid.mdp import ( humanoid_observation, humanoid_reward, ) @@ -138,7 +138,7 @@ def test_humanoid_deployment_preserves_effort_contract(monkeypatch): monkeypatch.setattr(sim_cfg, "get_data_path", lambda value: value) path = Path( - "extensions/embodichain_tasks/configs/tasks/classic_control/humanoid/env.yaml" + "embodichain/extensions/tasks/configs/tasks/classic_control/humanoid/env.yaml" ) cfg = config_to_cfg(load_config(str(path)), source_path=path) assert cfg.sim_cfg.physics_dt == pytest.approx(1 / 120) diff --git a/tests/gym/envs/tasks/test_locomotion_cuda.py b/tests/gym/envs/tasks/test_locomotion_cuda.py index 5315618581..6694af51d5 100644 --- a/tests/gym/envs/tasks/test_locomotion_cuda.py +++ b/tests/gym/envs/tasks/test_locomotion_cuda.py @@ -50,7 +50,7 @@ ) ROOT = Path(__file__).resolve().parents[4] -TASK_DIR = ROOT / "extensions/embodichain_tasks/configs/tasks/locomotion/velocity" +TASK_DIR = ROOT / "embodichain/extensions/tasks/configs/tasks/locomotion/velocity" def _subprocess_env() -> dict[str, str]: diff --git a/tests/gym/envs/tasks/test_locomotion_deployments.py b/tests/gym/envs/tasks/test_locomotion_deployments.py index 0448dc4111..1596705098 100644 --- a/tests/gym/envs/tasks/test_locomotion_deployments.py +++ b/tests/gym/envs/tasks/test_locomotion_deployments.py @@ -105,7 +105,7 @@ def test_packaged_deployment_and_agent_config_agree( ) -> None: """Real config decoding must work without smoke-script backend overrides.""" monkeypatch.setattr(sim_cfg, "get_data_path", lambda value: value) - directory = Path("extensions/embodichain_tasks/configs/tasks") / task + directory = Path("embodichain/extensions/tasks/configs/tasks") / task suffix = "" if backend == "default" else ".newton" path = directory / f"env{suffix}.yaml" raw = load_config(str(path)) @@ -116,7 +116,7 @@ def test_packaged_deployment_and_agent_config_agree( raw, source_path=path, manager_modules=[ - f"embodichain_tasks.locomotion.managers.{module}" + f"embodichain.extensions.tasks.locomotion.managers.{module}" for module in ("observations", "rewards") ], ) @@ -401,9 +401,9 @@ def _verify_native_no_render(task: str, backend: str) -> dict[str, object]: runtime = env = sim = observation = None try: importlib.import_module( - f"embodichain_tasks.locomotion.velocity.{task.rsplit('/', 1)[-1]}" + f"embodichain.extensions.tasks.locomotion.velocity.{task.rsplit('/', 1)[-1]}" ) - directory = Path("extensions/embodichain_tasks/configs/tasks") / task + directory = Path("embodichain/extensions/tasks/configs/tasks") / task suffix = "" if backend == "default" else ".newton" agent_path = directory / f"agents/ppo{suffix}.yaml" agent = load_config(agent_path) diff --git a/tests/gym/envs/tasks/test_locomotion_landing.py b/tests/gym/envs/tasks/test_locomotion_landing.py index 93a71dee67..5b8e65a81f 100644 --- a/tests/gym/envs/tasks/test_locomotion_landing.py +++ b/tests/gym/envs/tasks/test_locomotion_landing.py @@ -20,8 +20,12 @@ import pytest import torch from embodichain.lab.sim.sensors.contact.history import ContactHistory -from embodichain_tasks.locomotion.velocity.contracts.anymal_c.config import load_config -from embodichain_tasks.locomotion.velocity.contracts.anymal_c.mdp import _reward_terms +from embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.config import ( + load_config, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c.mdp import ( + _reward_terms, +) def test_anymal_landing_reward_consumes_completed_flight_duration(): diff --git a/tests/gym/envs/tasks/test_motion_model.py b/tests/gym/envs/tasks/test_motion_model.py index 341fc39b35..7877d6e6b4 100644 --- a/tests/gym/envs/tasks/test_motion_model.py +++ b/tests/gym/envs/tasks/test_motion_model.py @@ -24,18 +24,21 @@ from tensordict import TensorDict from embodichain.compute.kinematics import TreeKinematics from embodichain.data_pipeline.datasets.motion import MotionLibrary -from embodichain_models.dynamics.rwm import KinematicWorldModel, KinematicWorldModelCfg -from embodichain_models.dynamics.rwm.model import frozen_world_model -from embodichain_models.dynamics.rwm.robot_state import pack_robot_state -from embodichain_models.policies.motion_tracking import ( +from embodichain.extensions.models.dynamics.rwm import ( + KinematicWorldModel, + KinematicWorldModelCfg, +) +from embodichain.extensions.models.dynamics.rwm.model import frozen_world_model +from embodichain.extensions.models.dynamics.rwm.robot_state import pack_robot_state +from embodichain.extensions.models.policies.motion_tracking import ( MotionTrackingPolicy, MotionTrackingPolicyCfg, ) -from embodichain_tasks.locomotion.tracking._task import ( +from embodichain.extensions.tasks.locomotion.tracking._task import ( MotionTrackingTask, MotionTrackingCfg, ) -from embodichain_tasks.locomotion.tracking.motion_model import ( +from embodichain.extensions.tasks.locomotion.tracking.motion_model import ( MotionModelEnv, MotionModelCfg, MotionModelStart, @@ -248,7 +251,9 @@ def test_task_analytics_preserves_values_and_state_gradients(compiled): def test_physical_transition_excludes_nonfinite_rows(compiled): """Divergent state rows terminate with finite features and zero return.""" from types import SimpleNamespace - from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv + from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, + ) env, _ = make_env() frame = torch.tensor([1, 3]) @@ -284,7 +289,9 @@ def test_physical_episode_metrics_own_storage_across_task_invocations(monkeypatc """Reset metrics remain writable when a compiled producer reuses its output.""" from types import SimpleNamespace from embodichain.lab.gym.envs.embodied_env import EmbodiedEnv - from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv + from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, + ) model_env, _ = make_env() env = object.__new__(UnitreeG1MotionEnv) diff --git a/tests/gym/envs/tasks/test_motion_tracking.py b/tests/gym/envs/tasks/test_motion_tracking.py index 98d266c866..17700ae904 100644 --- a/tests/gym/envs/tasks/test_motion_tracking.py +++ b/tests/gym/envs/tasks/test_motion_tracking.py @@ -29,8 +29,10 @@ from embodichain.compute.kinematics import TreeKinematics from embodichain.data_pipeline.datasets.motion import MotionLibrary from embodichain.lab.gym.envs.managers.cfg import ActionTermCfg -from embodichain_tasks.locomotion.managers.actions import ReferenceJointPositionAction -from embodichain_tasks.locomotion.tracking._task import MotionTrackingTask +from embodichain.extensions.tasks.locomotion.managers.actions import ( + ReferenceJointPositionAction, +) +from embodichain.extensions.tasks.locomotion.tracking._task import MotionTrackingTask @pytest.mark.subprocess_sim @@ -61,7 +63,9 @@ def _run_g1_state_injection_and_selected_reset(update_data_interval: int) -> Non from embodichain.lab.gym.utils.gym_utils import config_to_cfg from embodichain.lab.sim import SimulationManager - from embodichain_tasks.locomotion.tracking.g1_motion import UnitreeG1MotionEnv + from embodichain.extensions.tasks.locomotion.tracking.g1_motion import ( + UnitreeG1MotionEnv, + ) data_root = os.environ.get("EMBODICHAIN_DATA_ROOT") archive = Path(data_root or "") / "LAFAN1G1/motion.npz" @@ -70,7 +74,7 @@ def _run_g1_state_injection_and_selected_reset(update_data_interval: int) -> Non root = Path(__file__).resolve().parents[4] config_path = ( root - / "extensions/embodichain_tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml" + / "embodichain/extensions/tasks/configs/tasks/locomotion/tracking/g1_motion/env.newton.yaml" ) gym = yaml.safe_load(config_path.read_text()) gym["num_envs"] = 2 @@ -256,7 +260,7 @@ def test_tracking_diagnostics_distinguish_alignment_and_failure_conditions(): assert torch.equal(failed, reasons["height"] | reasons["tilt"]) # Equal headings with different root tilts must not introduce a yaw offset. - from embodichain_models.dynamics.rwm.robot_state import rotation_exp + from embodichain.extensions.models.dynamics.rwm.robot_state import rotation_exp task, ref = task_and_state() state = {k: v.clone() for k, v in ref.items()} @@ -282,7 +286,7 @@ def test_rotation_error_has_correct_values_and_gradients_near_zero_and_pi( compiled: bool, ) -> None: """Check rotation values and gradients with a default device active.""" - from embodichain_models.dynamics.rwm.robot_state import rotation_exp + from embodichain.extensions.models.dynamics.rwm.robot_state import rotation_exp task, original = task_and_state() angles = torch.tensor( diff --git a/tests/gym/envs/tasks/test_push_cube.py b/tests/gym/envs/tasks/test_push_cube.py index 9d6e554515..588b29f957 100644 --- a/tests/gym/envs/tasks/test_push_cube.py +++ b/tests/gym/envs/tasks/test_push_cube.py @@ -28,7 +28,7 @@ from embodichain.lab.gym.utils._component_composition import _resolve_gym_components from embodichain.lab.gym.utils.gym_utils import config_to_cfg, get_manager_modules from embodichain.utils.utility import load_config -from embodichain_tasks.manipulation.push_cube import PushCubeEnv +from embodichain.extensions.tasks.manipulation.push_cube import PushCubeEnv from embodichain.lab.gym.envs import EmbodiedEnv from embodichain.lab.gym.envs.managers import EventManager, SceneEntityCfg from embodichain.lab.gym.utils.registration import REGISTERED_ENVS @@ -38,7 +38,7 @@ def _configuration(filename: str): path = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube" + / "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube" / filename ) physical = _resolve_gym_components(load_config(path), base_dir=path.parent).config diff --git a/tests/gym/envs/tasks/test_segmented_manipulation.py b/tests/gym/envs/tasks/test_segmented_manipulation.py index b1e13d9f30..1aee02e78e 100644 --- a/tests/gym/envs/tasks/test_segmented_manipulation.py +++ b/tests/gym/envs/tasks/test_segmented_manipulation.py @@ -37,7 +37,7 @@ _CONFIG_ROOT = ( Path(__file__).resolve().parents[4] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware" ) diff --git a/tests/gym/envs/tasks/test_unitree_locomotion.py b/tests/gym/envs/tasks/test_unitree_locomotion.py index 81652d9fca..7af72357b4 100644 --- a/tests/gym/envs/tasks/test_unitree_locomotion.py +++ b/tests/gym/envs/tasks/test_unitree_locomotion.py @@ -23,20 +23,34 @@ import pytest import torch -from embodichain_tasks.locomotion.velocity.contracts.g1 import config as g1_config -from embodichain_tasks.locomotion.velocity.contracts.g1 import mdp as g1_mdp -from embodichain_tasks.locomotion.velocity.contracts.go1 import config as go1_config -from embodichain_tasks.locomotion.velocity.contracts.go1 import mdp as go1_mdp -from embodichain_tasks.locomotion.velocity.contracts.go2 import config as go2_config -from embodichain_tasks.locomotion.velocity.contracts.go2 import mdp as go2_mdp -from embodichain_tasks.locomotion.velocity.contracts.h1_2 import config as h1_config -from embodichain_tasks.locomotion.velocity.contracts.h1_2 import mdp as h1_mdp - -from embodichain_tasks.locomotion.velocity.contracts.anymal_c import ( +from embodichain.extensions.tasks.locomotion.velocity.contracts.g1 import ( + config as g1_config, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.g1 import mdp as g1_mdp +from embodichain.extensions.tasks.locomotion.velocity.contracts.go1 import ( + config as go1_config, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.go1 import ( + mdp as go1_mdp, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.go2 import ( + config as go2_config, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.go2 import ( + mdp as go2_mdp, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2 import ( + config as h1_config, +) +from embodichain.extensions.tasks.locomotion.velocity.contracts.h1_2 import ( + mdp as h1_mdp, +) + +from embodichain.extensions.tasks.locomotion.velocity.contracts.anymal_c import ( config as anymal_config, mdp as anymal_mdp, ) -from embodichain_tasks.locomotion.velocity.contracts.microduck import ( +from embodichain.extensions.tasks.locomotion.velocity.contracts.microduck import ( config as microduck_config, mdp as microduck_mdp, ) @@ -70,9 +84,7 @@ def test_contract_dimensions_and_action_mapping( def test_contract_package_has_no_backend_imports(): - root = Path( - "extensions/embodichain_tasks/embodichain_tasks/locomotion/velocity/contracts" - ) + root = Path("embodichain/extensions/tasks/locomotion/velocity/contracts") forbidden = ("embodichain.lab", "dexsim") imports: set[str] = set() for path in root.rglob("*.py"): @@ -88,7 +100,7 @@ def test_contract_package_has_no_backend_imports(): def test_heading_commands_consume_xyzw_quaternions() -> None: import math from types import SimpleNamespace - from embodichain_tasks.locomotion.velocity._embodichain import ( + from embodichain.extensions.tasks.locomotion.velocity._embodichain import ( EmbodiChainVelocityEnv, ) @@ -117,7 +129,7 @@ def test_locomotion_state_binds_new_action_term_buffers() -> None: """Velocity state reads current, previous, and encoder-bias buffers.""" from types import SimpleNamespace - from embodichain_tasks.locomotion.velocity._embodichain import ( + from embodichain.extensions.tasks.locomotion.velocity._embodichain import ( EmbodiChainVelocityEnv, ) @@ -141,7 +153,7 @@ def test_locomotion_state_keeps_legacy_named_action_binding() -> None: """A compatible named custom action remains valid without a contract ID.""" from types import SimpleNamespace - from embodichain_tasks.locomotion.velocity._embodichain import ( + from embodichain.extensions.tasks.locomotion.velocity._embodichain import ( EmbodiChainVelocityEnv, ) @@ -180,13 +192,13 @@ def test_unitree_deployments_preserve_task_physics( monkeypatch.setattr(sim_cfg, "get_data_path", lambda value: value) name = "env.yaml" if backend == "default" else "env.newton.yaml" path = Path( - f"extensions/embodichain_tasks/configs/tasks/locomotion/velocity/{robot}_flat/{name}" + f"embodichain/extensions/tasks/configs/tasks/locomotion/velocity/{robot}_flat/{name}" ) config = config_to_cfg( load_config(str(path)), source_path=path, manager_modules=[ - f"embodichain_tasks.locomotion.managers.{module}" + f"embodichain.extensions.tasks.locomotion.managers.{module}" for module in ("observations", "rewards") ], ) @@ -229,7 +241,8 @@ def test_locomotion_env_preserves_ordered_unbounded_joint_actions( from embodichain.utils.utility import load_config env_type = getattr( - import_module(f"embodichain_tasks.locomotion.velocity.{robot}_flat"), env_name + import_module(f"embodichain.extensions.tasks.locomotion.velocity.{robot}_flat"), + env_name, ) task = env_type.velocity_task_config @@ -237,7 +250,7 @@ def test_locomotion_env_preserves_ordered_unbounded_joint_actions( filename = "env.yaml" if backend == "default" else "env.newton.yaml" path = ( Path( - f"extensions/embodichain_tasks/configs/tasks/locomotion/velocity/{robot}_flat" + f"embodichain/extensions/tasks/configs/tasks/locomotion/velocity/{robot}_flat" ) / filename ) @@ -245,7 +258,7 @@ def test_locomotion_env_preserves_ordered_unbounded_joint_actions( load_config(path), source_path=path, manager_modules=[ - f"embodichain_tasks.locomotion.managers.{module}" + f"embodichain.extensions.tasks.locomotion.managers.{module}" for module in ("observations", "rewards") ], ) @@ -301,12 +314,14 @@ def test_locomotion_keeps_explicit_robot_overrides( from embodichain.lab.gym.utils.gym_utils import config_to_cfg from embodichain.lab.sim import cfg as sim_cfg from embodichain.utils.utility import load_config - from embodichain_tasks.locomotion.velocity.go2_flat import UnitreeGo2FlatEnv + from embodichain.extensions.tasks.locomotion.velocity.go2_flat import ( + UnitreeGo2FlatEnv, + ) monkeypatch.setattr(sim_cfg, "get_data_path", lambda value: value) filename = "env.yaml" if backend == "default" else "env.newton.yaml" path = ( - Path("extensions/embodichain_tasks/configs/tasks/locomotion/velocity/go2_flat") + Path("embodichain/extensions/tasks/configs/tasks/locomotion/velocity/go2_flat") / filename ) raw = load_config(path) @@ -317,7 +332,7 @@ def test_locomotion_keeps_explicit_robot_overrides( raw, source_path=path, manager_modules=[ - f"embodichain_tasks.locomotion.managers.{module}" + f"embodichain.extensions.tasks.locomotion.managers.{module}" for module in ("observations", "rewards") ], ) @@ -336,7 +351,7 @@ def test_locomotion_keeps_explicit_robot_overrides( def test_policy_viewer_target_pose_preserves_world_xyzw_and_copies_state(): from types import SimpleNamespace - from embodichain_tasks.locomotion.velocity._embodichain import ( + from embodichain.extensions.tasks.locomotion.velocity._embodichain import ( EmbodiChainVelocityEnv, ) diff --git a/tests/gym/envs/test_asset_generalization.py b/tests/gym/envs/test_asset_generalization.py index 51d40916e1..e250f9905f 100644 --- a/tests/gym/envs/test_asset_generalization.py +++ b/tests/gym/envs/test_asset_generalization.py @@ -626,7 +626,7 @@ def test_default_factory_applies_recording_flag_after_production_config_loading( repository = Path(__file__).resolve().parents[3] source = ( repository - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) config = yaml.safe_load(source.read_text()) config["id"] = "AssetFactoryRecordingFlagTest-v0" diff --git a/tests/gym/envs/test_auto_renderer_lifecycle.py b/tests/gym/envs/test_auto_renderer_lifecycle.py index d77cb0aa3a..2624784020 100644 --- a/tests/gym/envs/test_auto_renderer_lifecycle.py +++ b/tests/gym/envs/test_auto_renderer_lifecycle.py @@ -87,10 +87,10 @@ def _run_scenario(scenario: str, task: str, report: Path) -> None: discover_task_packages() execute_init_hooks() - importlib.import_module(f"embodichain_tasks.locomotion.velocity.{task}") + importlib.import_module(f"embodichain.extensions.tasks.locomotion.velocity.{task}") sim_cfg.DEFAULT_RENDERER = "auto" task_path = Path( - f"extensions/embodichain_tasks/configs/tasks/locomotion/velocity/{task}/env.newton.yaml" + f"embodichain/extensions/tasks/configs/tasks/locomotion/velocity/{task}/env.newton.yaml" ) raw = load_config(task_path) agent = load_config(task_path.parent / "agents/ppo.newton.yaml") diff --git a/tests/gym/envs/test_configured_rl.py b/tests/gym/envs/test_configured_rl.py index 35697bfe9a..8f9e759777 100644 --- a/tests/gym/envs/test_configured_rl.py +++ b/tests/gym/envs/test_configured_rl.py @@ -48,7 +48,7 @@ _ROOT = Path(__file__).resolve().parents[3] _CONFIG = ( _ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.configured_rl.yaml" ) @@ -593,7 +593,7 @@ def test_configured_rl_rejects_mid_episode_virtual_target_resampling(): def test_falling_is_failure_only_in_configured_deployment(monkeypatch): - from embodichain_tasks.manipulation.push_cube import PushCubeEnv + from embodichain.extensions.tasks.manipulation.push_cube import PushCubeEnv env = _env() env.pose[:, 2, 3] = -0.2 diff --git a/tests/gym/envs/test_differentiable_embodied_env.py b/tests/gym/envs/test_differentiable_embodied_env.py index 21051dd0f2..f640e14350 100644 --- a/tests/gym/envs/test_differentiable_embodied_env.py +++ b/tests/gym/envs/test_differentiable_embodied_env.py @@ -452,7 +452,7 @@ def _reset(*, options: dict[str, Any]): def _import_franka_env(): """Import the Franka APG environment after resolving task packages.""" - from embodichain_tasks.special.franka_reach_apg import FrankaReachApgEnv + from embodichain.extensions.tasks.special.franka_reach_apg import FrankaReachApgEnv return FrankaReachApgEnv @@ -461,7 +461,7 @@ def test_franka_kinematics_build_snapshots_live_primal_before_bridge( monkeypatch: pytest.MonkeyPatch, ) -> None: """Franka detaches taped FK inputs before the parent opens a tape.""" - from embodichain_tasks.special import franka_reach_apg + from embodichain.extensions.tasks.special import franka_reach_apg env = object.__new__(franka_reach_apg.FrankaReachApgEnv) live_joint_q = object() @@ -501,7 +501,7 @@ def test_franka_action_kernel_reads_snapshot_instead_of_live_state( monkeypatch: pytest.MonkeyPatch, ) -> None: """The recorded action kernel never captures mutable manager state.""" - from embodichain_tasks.special import franka_reach_apg + from embodichain.extensions.tasks.special import franka_reach_apg env = object.__new__(franka_reach_apg.FrankaReachApgEnv) snapshot_joint_q = object() @@ -539,7 +539,7 @@ def test_franka_snapshot_keeps_gradient_after_live_state_mutation_and_matches_fd tmp_path, ) -> None: """Detached FK input survives live writes before backward under strict mode.""" - from embodichain_tasks.special import franka_reach_apg + from embodichain.extensions.tasks.special import franka_reach_apg env = object.__new__(franka_reach_apg.FrankaReachApgEnv) device = "cpu" diff --git a/tests/gym/envs/test_fluid_integration.py b/tests/gym/envs/test_fluid_integration.py index 57925ea122..0f7f632cf9 100644 --- a/tests/gym/envs/test_fluid_integration.py +++ b/tests/gym/envs/test_fluid_integration.py @@ -36,7 +36,7 @@ ROOT = Path(__file__).resolve().parents[3] TASK = ( ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" ) diff --git a/tests/gym/envs/test_modular_env_tutorial.py b/tests/gym/envs/test_modular_env_tutorial.py index 0e58b4ea69..4c1f1f0291 100644 --- a/tests/gym/envs/test_modular_env_tutorial.py +++ b/tests/gym/envs/test_modular_env_tutorial.py @@ -39,7 +39,7 @@ def test_tutorial_rigid_objects_compile_to_spawn_descriptors(tutorial) -> None: @pytest.fixture def tutorial(monkeypatch): from embodichain.lab.sim.cfg import RobotCfg - from embodichain_robots import DexforceW1Cfg + from embodichain.extensions.robots import DexforceW1Cfg # These tests exercise object descriptors and event setup, not W1 assembly. # Its imported asset resolvers can bypass the package-level path stub. diff --git a/tests/gym/envs/test_official_task_layout.py b/tests/gym/envs/test_official_task_layout.py index af6cbc55ed..6def2e3a07 100644 --- a/tests/gym/envs/test_official_task_layout.py +++ b/tests/gym/envs/test_official_task_layout.py @@ -32,15 +32,15 @@ from embodichain.lab.sim.cfg import physics_cfg_for_backend from embodichain.learning.rl.env import get_registered_learning_env_names from embodichain.utils.utility import load_config -from embodichain_tasks.classic_control.point_mass import PointMassEnv +from embodichain.extensions.tasks.classic_control.point_mass import PointMassEnv EXPECTED_IMPORT_REGISTERED_TASK_MODULES = { - "BlocksRankingSize-v1": "embodichain_tasks.manipulation.tableware.blocks_ranking_size", - "CartPoleRL": "embodichain_tasks.classic_control.cart_pole", - "MatchObjectContainer-v1": "embodichain_tasks.manipulation.tableware.match_object_container", - "PlaceObjectDrawer-v1": "embodichain_tasks.manipulation.tableware.place_object_drawer", - "PushCubeRL": "embodichain_tasks.manipulation.push_cube", - "StackCups-v1": "embodichain_tasks.manipulation.tableware.stack_cups", + "BlocksRankingSize-v1": "embodichain.extensions.tasks.manipulation.tableware.blocks_ranking_size", + "CartPoleRL": "embodichain.extensions.tasks.classic_control.cart_pole", + "MatchObjectContainer-v1": "embodichain.extensions.tasks.manipulation.tableware.match_object_container", + "PlaceObjectDrawer-v1": "embodichain.extensions.tasks.manipulation.tableware.place_object_drawer", + "PushCubeRL": "embodichain.extensions.tasks.manipulation.push_cube", + "StackCups-v1": "embodichain.extensions.tasks.manipulation.tableware.stack_cups", } REMOVED_AGENT_ENV_IDS = {"PourWaterAgent-v3", "RearrangementAgent-v3"} CONFIG_DEFINED_TASK_PROGRAM_TASKS = { @@ -63,7 +63,7 @@ "stack_cups", } TASK_CONFIG_ROOT = ( - Path(__file__).resolve().parents[3] / "extensions/embodichain_tasks/configs/tasks" + Path(__file__).resolve().parents[3] / "embodichain/extensions/tasks/configs/tasks" ) @@ -176,7 +176,10 @@ def test_point_mass_registration_uses_classic_control_task_module() -> None: discover_task_packages() assert "pointmassrl" in get_registered_learning_env_names() - assert PointMassEnv.__module__ == "embodichain_tasks.classic_control.point_mass" + assert ( + PointMassEnv.__module__ + == "embodichain.extensions.tasks.classic_control.point_mass" + ) def test_simulator_rl_tasks_declare_rl_capability() -> None: @@ -196,8 +199,11 @@ def test_legacy_tableware_agent_envs_are_not_registered() -> None: discover_task_packages() assert REMOVED_AGENT_ENV_IDS.isdisjoint(REGISTERED_ENVS) - assert find_spec("embodichain_tasks.tableware") is None - assert find_spec("embodichain_tasks.manipulation.tableware.base_agent_env") is None + assert find_spec("embodichain.extensions.tasks.tableware") is None + assert ( + find_spec("embodichain.extensions.tasks.manipulation.tableware.base_agent_env") + is None + ) def test_tableware_configs_are_nested_under_manipulation() -> None: @@ -213,7 +219,7 @@ def test_tableware_configs_are_nested_under_manipulation() -> None: def test_config_defined_task_programs_do_not_need_python_task_modules() -> None: """Pure Task Programs keep their runtime and workflow in task-local config.""" for task_name in CONFIG_DEFINED_TASK_PROGRAM_TASKS: - module_name = f"embodichain_tasks.manipulation.tableware.{task_name}" + module_name = f"embodichain.extensions.tasks.manipulation.tableware.{task_name}" config_root = TASK_CONFIG_ROOT / "manipulation/tableware" / task_name assert find_spec(module_name) is None diff --git a/tests/gym/utils/test_gym_utils.py b/tests/gym/utils/test_gym_utils.py index 19caf815b1..23b25774e8 100644 --- a/tests/gym/utils/test_gym_utils.py +++ b/tests/gym/utils/test_gym_utils.py @@ -44,7 +44,7 @@ init_rollout_buffer_from_config, init_rollout_buffer_from_gym_space, ) -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg from embodichain.lab.sim.cfg import DefaultPhysicsCfg, NewtonPhysicsCfg from embodichain.lab.sim.sensors import CameraCfg from embodichain.utils.utility import load_config, save_config @@ -53,17 +53,17 @@ _REPOSITORY_ROOT = Path(__file__).parents[3] _CUBE_GYM_CONFIG_PATH = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) _CUBE_TASK_PROGRAM_DIR = _CUBE_GYM_CONFIG_PATH.parent / "task_program" _CUBE_INTEGRATION_PATH = _CUBE_TASK_PROGRAM_DIR / "integration.yaml" _CUBE_ENVIRONMENT_PATH = _CUBE_GYM_CONFIG_PATH.parent / "envs/default.yaml" -_COMPONENT_ROOT = _REPOSITORY_ROOT / "extensions/embodichain_tasks/configs/components" +_COMPONENT_ROOT = _REPOSITORY_ROOT / "embodichain/extensions/tasks/configs/components" _CUBE_POLICY_PATH = _COMPONENT_ROOT / "execution_policies/trajectory_open_loop.yaml" _CUBE_EMBODIMENT_PATH = _COMPONENT_ROOT / "embodiments/ur5_dh_pgi_140_80.yaml" _TABLEWARE_CONFIG_ROOT = ( _REPOSITORY_ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware" ) CUBE_ROBOT_PROFILE_ID = "ur5_dh_pgi_140_80" CUBE_SCENE_REGISTRY_ID = "task_program_repeated_pick_place" @@ -614,12 +614,12 @@ def test_robot_default_sensors_are_included_in_component_buffer( self, monkeypatch: pytest.MonkeyPatch ) -> None: monkeypatch.setattr( - "embodichain_robots.agilex.cobotmagic.cfg.get_data_path", + "embodichain.extensions.robots.agilex.cobotmagic.cfg.get_data_path", lambda value: value, ) config = { "embodiment": { - "component": "extensions/embodichain_tasks/configs/components/embodiments/cobotmagic.yaml" + "component": "embodichain/extensions/tasks/configs/components/embodiments/cobotmagic.yaml" }, "env": {}, } diff --git a/tests/lab/expansion/test_program_sim.py b/tests/lab/expansion/test_program_sim.py index c66881f584..60856880b5 100644 --- a/tests/lab/expansion/test_program_sim.py +++ b/tests/lab/expansion/test_program_sim.py @@ -37,7 +37,7 @@ def _probe(source: str = "task_program") -> None: root = Path(__file__).resolve().parents[3] path = ( root - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) if source == "task_program_newton": path = root / "examples/expansion/engine/task.newton.yaml" @@ -338,13 +338,7 @@ def test_native_task_program_two_rows_one_world(source): cwd=root, env={ **os.environ, - "PYTHONPATH": os.pathsep.join( - ( - str(root), - str(root / "extensions"), - str(root / "extensions/embodichain_tasks"), - ) - ), + "PYTHONPATH": str(root), "EMBODICHAIN_SIM_EXIT_PROCESS": "0", }, capture_output=True, diff --git a/tests/lab/scripts/test_preview_robot.py b/tests/lab/scripts/test_preview_robot.py index 2b9c6f332a..83086cf6f7 100644 --- a/tests/lab/scripts/test_preview_robot.py +++ b/tests/lab/scripts/test_preview_robot.py @@ -34,7 +34,7 @@ from embodichain.lab.scripts import preview_robot from embodichain import robot_registry as registry -from embodichain_robots._catalog import ROBOT_CONFIGS +from embodichain.extensions.robots._catalog import ROBOT_CONFIGS pytestmark = pytest.mark.no_sim _ROOT = Path(__file__).resolve().parents[3] @@ -135,7 +135,7 @@ def test_registered_body_configs_pass_preview_validation( from importlib import import_module import embodichain.data import embodichain.lab.sim.cfg as sim_cfg - from embodichain_robots.dexforce.w1 import utils + from embodichain.extensions.robots.dexforce.w1 import utils # Import before patching the shared resolver so newly loaded presets cannot # retain the temporary asset function after monkeypatch teardown. @@ -164,7 +164,7 @@ def test_w1_catalog_variants_pass_preview_validation( monkeypatch: pytest.MonkeyPatch, robot_asset: Path, variant: str ) -> None: import embodichain.lab.sim.cfg as sim_cfg - from embodichain_robots.dexforce.w1 import utils as w1_utils + from embodichain.extensions.robots.dexforce.w1 import utils as w1_utils monkeypatch.setattr(w1_utils, "get_data_path", lambda _: str(robot_asset)) monkeypatch.setattr(sim_cfg, "get_data_path", lambda _: str(robot_asset)) @@ -380,7 +380,7 @@ def test_help_does_not_load_simulation_or_robot_modules(arguments) -> None: main(sys.argv[1:] or ["--help"]) except SystemExit as error: assert error.code == 0 -for prefix in ("torch", "dexsim", "embodichain.lab.sim", "embodichain.lab.gym", "embodichain.lab.task_program", "embodichain_robots"): +for prefix in ("torch", "dexsim", "embodichain.lab.sim", "embodichain.lab.gym", "embodichain.lab.task_program", "embodichain.extensions.robots"): assert not any(name == prefix or name.startswith(prefix + ".") for name in sys.modules), prefix """ result = subprocess.run( diff --git a/tests/lab/scripts/test_run_task_expansion.py b/tests/lab/scripts/test_run_task_expansion.py index ebe96b685f..61b59fefa1 100644 --- a/tests/lab/scripts/test_run_task_expansion.py +++ b/tests/lab/scripts/test_run_task_expansion.py @@ -44,7 +44,7 @@ def _resolve(path: str): def test_repeated_pick_place_policy_component_merges_task_binding() -> None: request = _resolve( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/" + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/" "task.ur5.yaml" ) assert request is not None @@ -76,7 +76,7 @@ def test_repeated_pick_place_policy_component_merges_task_binding() -> None: def test_open_drawer_policy_component_merges_phase_binding() -> None: request = _resolve( - "extensions/embodichain_tasks/configs/tasks/manipulation/open_drawer/" + "embodichain/extensions/tasks/configs/tasks/manipulation/open_drawer/" "task.ur5.yaml" ) assert request is not None @@ -96,7 +96,7 @@ def test_open_drawer_policy_component_merges_phase_binding() -> None: def test_task_expansion_config_accepts_local_candidate_override() -> None: task_path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/" + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/" "task.ur5.yaml" ) config = load_config(task_path) @@ -251,7 +251,7 @@ def test_collection_plan_maps_legacy_max_episodes_as_fallback() -> None: def test_task_expansion_config_applies_runtime_overlay() -> None: task_path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/" + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/" "task.ur5.yaml" ) with pytest.raises(ValueError, match="unsupported fields.*simulation"): @@ -289,11 +289,11 @@ def test_task_expansion_config_applies_runtime_overlay() -> None: def test_cli_expansion_profile_overrides_task_expansion_policy() -> None: task_path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/" + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/" "task.ur5.yaml" ) policy_path = resolve_config_path( - "extensions/embodichain_tasks/configs/components/expansion_policies/" + "embodichain/extensions/tasks/configs/components/expansion_policies/" "task_program_episode.yaml" ) args = _create_parser().parse_args( diff --git a/tests/lab/task_program/test_loader.py b/tests/lab/task_program/test_loader.py index b21550db9e..77c529222b 100644 --- a/tests/lab/task_program/test_loader.py +++ b/tests/lab/task_program/test_loader.py @@ -106,7 +106,7 @@ def validate_validator(self, validator: object, *, path: ConfigPath) -> None: _STACK_BLOCKS_TWO_PROGRAM = ( Path(__file__).parents[3] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware" / "stack_blocks_two/task_program/program.yaml" ) diff --git a/tests/lab/task_program/test_semantic_executor_curobo_gpu.py b/tests/lab/task_program/test_semantic_executor_curobo_gpu.py index 8d2d16be5f..1302d49226 100644 --- a/tests/lab/task_program/test_semantic_executor_curobo_gpu.py +++ b/tests/lab/task_program/test_semantic_executor_curobo_gpu.py @@ -56,7 +56,7 @@ CuroboPlannerCfg, CuroboWorldCfg, ) -from embodichain_robots import FrankaPandaCfg # noqa: E402 +from embodichain.extensions.robots import FrankaPandaCfg # noqa: E402 from embodichain.lab.sim.shapes import CubeCfg # noqa: E402 from embodichain.lab.task_program.semantics import ( # noqa: E402 BoundSemanticCall, diff --git a/tests/learning/test_point_mass.py b/tests/learning/test_point_mass.py index ba11258142..e65f6f1d48 100644 --- a/tests/learning/test_point_mass.py +++ b/tests/learning/test_point_mass.py @@ -35,7 +35,7 @@ from embodichain.learning.rl.train import _build_learning_policy, train_from_config from embodichain.learning.rl.utils import OptimizerCfg from embodichain.learning.rl.utils.trainer import Trainer -from embodichain_tasks.classic_control.point_mass import PointMassEnv +from embodichain.extensions.tasks.classic_control.point_mass import PointMassEnv def test_point_mass_is_registered_differentiable_environment() -> None: diff --git a/tests/learning/test_rl.py b/tests/learning/test_rl.py index 4eae64d74e..1be5556256 100644 --- a/tests/learning/test_rl.py +++ b/tests/learning/test_rl.py @@ -38,9 +38,9 @@ class TestRLTraining: def setup_method(self): """Set up test configuration before each test method.""" # Load the existing push_cube config - train_config_path = "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/agents/ppo.json" + train_config_path = "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/agents/ppo.json" gym_config_path = ( - "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.json" + "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.json" ) with open(train_config_path, "r") as f: diff --git a/tests/learning/test_rl_distributed.py b/tests/learning/test_rl_distributed.py index cf4249427e..86448f4922 100644 --- a/tests/learning/test_rl_distributed.py +++ b/tests/learning/test_rl_distributed.py @@ -113,7 +113,7 @@ def test_training_timeout_terminates_worker_process( def _create_minimal_distributed_config(): """Create a minimal train config for distributed testing.""" config_path = Path( - "extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json" + "embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/agents/grpo.json" ) if not config_path.exists(): pytest.skip(f"Config not found: {config_path}") diff --git a/tests/learning/test_rl_resume.py b/tests/learning/test_rl_resume.py index 872de3b2d9..d6c1e4fa09 100644 --- a/tests/learning/test_rl_resume.py +++ b/tests/learning/test_rl_resume.py @@ -39,7 +39,7 @@ train_from_config, ) from embodichain.learning.rl.utils.trainer import Trainer -from embodichain_tasks.classic_control.point_mass import PointMassEnv +from embodichain.extensions.tasks.classic_control.point_mass import PointMassEnv def _export_prepared_policy_resource(env, config, config_dir): @@ -1017,7 +1017,7 @@ def test_saved_policy_task_program_reloads_from_unrelated_directory( source = ( Path(__file__).resolve().parents[2] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/stack_blocks_two/task.policy.cobotmagic.yaml" ) raw = yaml.safe_load(source.read_text()) if export_resources: diff --git a/tests/learning/test_rl_resume_distributed.py b/tests/learning/test_rl_resume_distributed.py index a792f89484..d3295382ba 100644 --- a/tests/learning/test_rl_resume_distributed.py +++ b/tests/learning/test_rl_resume_distributed.py @@ -37,7 +37,7 @@ from embodichain.learning.rl.utils.trainer import Trainer from embodichain.learning.rl.train import _configure_checkpoints, _save_final_checkpoint from embodichain.lab.gym.envs.managers.cfg import FunctorCfg -from embodichain_tasks.classic_control.point_mass import PointMassEnv +from embodichain.extensions.tasks.classic_control.point_mass import PointMassEnv def _components(rank: int, directory: Path, mode: str) -> Trainer: diff --git a/tests/learning/test_shared_rollout.py b/tests/learning/test_shared_rollout.py index 1f07387a3c..21d2dbff51 100644 --- a/tests/learning/test_shared_rollout.py +++ b/tests/learning/test_shared_rollout.py @@ -188,7 +188,7 @@ def test_shared_rollout_collects_policy_and_env_fields(): @pytest.mark.requires_tasks def test_embodied_env_writes_next_fields_into_external_rollout(): gym_config = load_json( - "extensions/embodichain_tasks/configs/tasks/classic_control/cart_pole/env.json" + "embodichain/extensions/tasks/configs/tasks/classic_control/cart_pole/env.json" ) env_cfg = config_to_cfg(gym_config, manager_modules=get_manager_modules()) env_cfg = deepcopy(env_cfg) diff --git a/tests/models/dynamics/_rigidformer_fixtures.py b/tests/models/dynamics/_rigidformer_fixtures.py index d15db1a84c..988ce08f45 100644 --- a/tests/models/dynamics/_rigidformer_fixtures.py +++ b/tests/models/dynamics/_rigidformer_fixtures.py @@ -17,7 +17,7 @@ from __future__ import annotations import torch -from embodichain_models.dynamics.rigidformer import RigidFormerCfg +from embodichain.extensions.models.dynamics.rigidformer import RigidFormerCfg def tiny_cfg() -> RigidFormerCfg: diff --git a/tests/models/dynamics/_rigidformer_training.py b/tests/models/dynamics/_rigidformer_training.py index af2899ef1b..24f7f3ec81 100644 --- a/tests/models/dynamics/_rigidformer_training.py +++ b/tests/models/dynamics/_rigidformer_training.py @@ -20,7 +20,7 @@ import json from pathlib import Path import numpy as np -from embodichain_models.dynamics.rigidformer.data import MOViSequenceSource +from embodichain.extensions.models.dynamics.rigidformer.data import MOViSequenceSource from ._rigidformer_fixtures import tiny_cfg diff --git a/tests/models/dynamics/nerd/test_transition.py b/tests/models/dynamics/nerd/test_transition.py index e1a994d0e7..3dc556ed77 100644 --- a/tests/models/dynamics/nerd/test_transition.py +++ b/tests/models/dynamics/nerd/test_transition.py @@ -25,14 +25,14 @@ import pytest import torch -from embodichain_models.dynamics.nerd import ( +from embodichain.extensions.models.dynamics.nerd import ( NeRDGeometry, NeRDModel, NeRDModelCfg, NeRDStateCodec, NeRDTransition, ) -from embodichain_models.dynamics.nerd.codec import reset_history +from embodichain.extensions.models.dynamics.nerd.codec import reset_history def _transition(robot: str, batch: int = 2): @@ -236,13 +236,13 @@ def test_model_layer_imports_without_native_backends(): root = Path(__file__).resolve().parents[4] script = f""" import importlib.abc,sys -sys.path[:0] = {[str(root), str(root / 'extensions/embodichain_models')]!r} +sys.path[:0] = {[str(root), str(root / 'embodichain/extensions/models')]!r} class BlockNative(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): if fullname.split('.')[0] in {{'newton','dexsim','warp'}} or fullname.startswith('embodichain.lab'): raise AssertionError(fullname) sys.meta_path.insert(0, BlockNative()) -from embodichain_models.dynamics.nerd import NeRDGeometry,NeRDState,NeRDTransition +from embodichain.extensions.models.dynamics.nerd import NeRDGeometry,NeRDState,NeRDTransition """ result = subprocess.run( [sys.executable, "-I", "-c", script], capture_output=True, text=True diff --git a/tests/models/dynamics/rwm/test_kinematic.py b/tests/models/dynamics/rwm/test_kinematic.py index 0251d4a159..917677245b 100644 --- a/tests/models/dynamics/rwm/test_kinematic.py +++ b/tests/models/dynamics/rwm/test_kinematic.py @@ -23,15 +23,15 @@ import pytest import torch -from embodichain_models.dynamics.rwm.kinematic import ( +from embodichain.extensions.models.dynamics.rwm.kinematic import ( KinematicWorldModel, KinematicWorldModelCfg, heading_state_increment, integrate_heading_state, ) -from embodichain_models.dynamics.rwm.model import frozen_world_model -from embodichain_models.dynamics.rwm.robot_state import rotation_exp -from embodichain_models.dynamics.rwm.supervised import ( +from embodichain.extensions.models.dynamics.rwm.model import frozen_world_model +from embodichain.extensions.models.dynamics.rwm.robot_state import rotation_exp +from embodichain.extensions.models.dynamics.rwm.supervised import ( RobotWorldModelObjective, replay_supervised_batch, ) diff --git a/tests/models/dynamics/rwm/test_robot_state.py b/tests/models/dynamics/rwm/test_robot_state.py index 442d2537af..439be654e9 100644 --- a/tests/models/dynamics/rwm/test_robot_state.py +++ b/tests/models/dynamics/rwm/test_robot_state.py @@ -22,7 +22,7 @@ import torch -from embodichain_models.dynamics.rwm.robot_state import ( +from embodichain.extensions.models.dynamics.rwm.robot_state import ( integrate_robot_state, robot_state_error, robot_state_features, diff --git a/tests/models/dynamics/rwm/test_rwm.py b/tests/models/dynamics/rwm/test_rwm.py index 2e588046b1..5d4dc354e7 100644 --- a/tests/models/dynamics/rwm/test_rwm.py +++ b/tests/models/dynamics/rwm/test_rwm.py @@ -25,17 +25,17 @@ import pytest import torch -from embodichain_models.dynamics.rwm.robot_state import ( +from embodichain.extensions.models.dynamics.rwm.robot_state import ( integrate_robot_state, robot_state_error, ) -from embodichain_models.dynamics.rwm.model import ( +from embodichain.extensions.models.dynamics.rwm.model import ( RobotWorldModel, RobotWorldModelCfg, frozen_world_model, ) from embodichain.learning.sl import SupervisedBatch, SupervisedLearner -from embodichain_models.dynamics.rwm import ( +from embodichain.extensions.models.dynamics.rwm import ( RobotWorldModelObjective, RWMPredictor, build_rwm_trainer, @@ -337,9 +337,9 @@ def test_rwm_imports_do_not_initialize_simulation(): code = """ import sys import embodichain.learning.sl -assert not any(name == 'embodichain_models' or name.startswith('embodichain_models.') for name in sys.modules) -from embodichain_models.dynamics.rwm import RobotWorldModel, RobotWorldModelObjective, RWMPredictor, build_rwm_trainer -import embodichain_models.dynamics.rwm.replay +assert not any(name == 'embodichain.extensions.models' or name.startswith('embodichain.extensions.models.') for name in sys.modules) +from embodichain.extensions.models.dynamics.rwm import RobotWorldModel, RobotWorldModelObjective, RWMPredictor, build_rwm_trainer +import embodichain.extensions.models.dynamics.rwm.replay assert not any(name == 'dexsim' or name.startswith('dexsim.') or name.startswith('embodichain.lab.') for name in sys.modules) """ subprocess.run([sys.executable, "-c", code], check=True) @@ -393,7 +393,7 @@ def test_offline_recipe_preserves_committed_updates_on_resume(tmp_path): @pytest.mark.gpu def test_cuda_replay_and_bfloat16_network_preserve_fp32_state(): - from embodichain_models.dynamics.rwm.replay import TransitionReplay + from embodichain.extensions.models.dynamics.rwm.replay import TransitionReplay model = RobotWorldModel( RobotWorldModelCfg(hidden_dims=(16,), amp_bfloat16=True) diff --git a/tests/models/dynamics/rwm/test_transition_replay.py b/tests/models/dynamics/rwm/test_transition_replay.py index 10437c4625..3f2ea3ad62 100644 --- a/tests/models/dynamics/rwm/test_transition_replay.py +++ b/tests/models/dynamics/rwm/test_transition_replay.py @@ -23,7 +23,7 @@ import pytest import torch -from embodichain_models.dynamics.rwm.replay import TransitionReplay +from embodichain.extensions.models.dynamics.rwm.replay import TransitionReplay def _append(replay: TransitionReplay, step: int) -> None: diff --git a/tests/models/dynamics/test_rigidformer_distributed.py b/tests/models/dynamics/test_rigidformer_distributed.py index 725101f999..88ffa825f4 100644 --- a/tests/models/dynamics/test_rigidformer_distributed.py +++ b/tests/models/dynamics/test_rigidformer_distributed.py @@ -32,9 +32,11 @@ import torch.multiprocessing as mp from embodichain.learning.sl import SupervisedLearner -from embodichain_models.dynamics.rigidformer import RigidFormerModel -from embodichain_models.dynamics.rigidformer.sl_recipe import build_rigidformer_trainer -from embodichain_models.dynamics.rigidformer.supervised import ( +from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel +from embodichain.extensions.models.dynamics.rigidformer.sl_recipe import ( + build_rigidformer_trainer, +) +from embodichain.extensions.models.dynamics.rigidformer.supervised import ( RigidFormerObjective, rigidformer_batch, ) diff --git a/tests/models/dynamics/test_rigidformer_official.py b/tests/models/dynamics/test_rigidformer_official.py index 8f250de780..1d14a78076 100644 --- a/tests/models/dynamics/test_rigidformer_official.py +++ b/tests/models/dynamics/test_rigidformer_official.py @@ -27,7 +27,7 @@ def test_import_does_not_require_community_model_or_simulator(): code = """import sys -from embodichain_models.dynamics.rigidformer import RigidFormerCfg +from embodichain.extensions.models.dynamics.rigidformer import RigidFormerCfg assert 'rigidformer' not in sys.modules assert 'flash_attn' not in sys.modules assert not any(n.startswith('embodichain.lab.sim') for n in sys.modules) @@ -41,7 +41,7 @@ def test_cpu_only_model_construction_and_checkpoint_import(tmp_path): code = """import importlib.util import sys import torch -from embodichain_models.dynamics.rigidformer import RigidFormerModel, load_rigidformer_checkpoint +from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel, load_rigidformer_checkpoint assert not torch.cuda.is_available() spec = importlib.util.spec_from_file_location('fixtures', sys.argv[2]) @@ -77,8 +77,11 @@ def test_cpu_only_model_construction_and_checkpoint_import(tmp_path): def test_rope_pairing_is_owned_by_each_model(): pytest.importorskip("roma") - from embodichain_models.dynamics.rigidformer import RigidFormerCfg, RigidFormerModel - from embodichain_models.dynamics.rigidformer._native.models.physformer_rope import ( + from embodichain.extensions.models.dynamics.rigidformer import ( + RigidFormerCfg, + RigidFormerModel, + ) + from embodichain.extensions.models.dynamics.rigidformer._native.models.physformer_rope import ( PhysFormerRoPE, ) @@ -100,7 +103,7 @@ def test_rope_pairing_is_owned_by_each_model(): @pytest.mark.gpu def test_native_forward_checkpoint_and_rollout_with_variable_objects(tmp_path): pytest.importorskip("roma") - from embodichain_models.dynamics.rigidformer import ( + from embodichain.extensions.models.dynamics.rigidformer import ( RigidFormerModel, load_rigidformer_checkpoint, ) @@ -152,7 +155,7 @@ def test_native_forward_checkpoint_and_rollout_with_variable_objects(tmp_path): @pytest.mark.gpu def test_native_packed_points_ignore_finite_padding_above_128(): pytest.importorskip("roma") - from embodichain_models.dynamics.rigidformer import RigidFormerModel + from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel model = RigidFormerModel(tiny_cfg()).cuda().eval() batch = geometry_batch("cuda", points=160) diff --git a/tests/models/dynamics/test_rigidformer_training.py b/tests/models/dynamics/test_rigidformer_training.py index 2daebfaa45..00eefbd121 100644 --- a/tests/models/dynamics/test_rigidformer_training.py +++ b/tests/models/dynamics/test_rigidformer_training.py @@ -22,7 +22,7 @@ import numpy as np import pytest import torch -from embodichain_models.dynamics.rigidformer.supervised import ( +from embodichain.extensions.models.dynamics.rigidformer.supervised import ( RigidFormerObjective, rigidformer_batch, ) @@ -144,7 +144,9 @@ def test_geometry_missing_from_manifest_is_not_a_verified_source(packed_data): @pytest.mark.parametrize("missing_cache", ["anchor", "fps_order"]) def test_missing_prepared_cache_does_not_modify_source(packed_data, missing_cache): - from embodichain_models.dynamics.rigidformer.data import MOViSequenceSource + from embodichain.extensions.models.dynamics.rigidformer.data import ( + MOViSequenceSource, + ) original = source(packed_data, random_step=False) valid = dict(original.config) @@ -247,7 +249,9 @@ def test_new_manifest_reloads_replaced_per_frame_geometry(tmp_path): def test_fixed_step_and_stride_are_applied(packed_data): - from embodichain_models.dynamics.rigidformer.data import MOViSequenceSource + from embodichain.extensions.models.dynamics.rigidformer.data import ( + MOViSequenceSource, + ) original = source(packed_data, random_step=False) updated = MOViSequenceSource( @@ -275,7 +279,9 @@ def test_small_dataset_pads_every_distributed_rank(tmp_path, monkeypatch): def test_default_object_padding_counts_toward_memory_limit(packed_data): - from embodichain_models.dynamics.rigidformer.data import MOViSequenceSource + from embodichain.extensions.models.dynamics.rigidformer.data import ( + MOViSequenceSource, + ) original = source(packed_data, random_step=False) config = dict(original.config) @@ -293,7 +299,7 @@ def test_default_object_padding_counts_toward_memory_limit(packed_data): def test_recipe_rejects_anchor_count_mismatched_with_model(packed_data, tmp_path): - from embodichain_models.dynamics.rigidformer.sl_recipe import ( + from embodichain.extensions.models.dynamics.rigidformer.sl_recipe import ( build_rigidformer_trainer, ) @@ -337,7 +343,7 @@ def forward(self, values): @pytest.mark.gpu def test_centered_model_loss_is_translation_invariant(): pytest.importorskip("roma") - from embodichain_models.dynamics.rigidformer import RigidFormerModel + from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel cfg = tiny_cfg() cfg.architecture["data"]["center_scene_by_t0"] = True @@ -356,7 +362,7 @@ def test_centered_model_loss_is_translation_invariant(): def test_export_accepts_legacy_numpy_rng_pickle(tmp_path, monkeypatch): - from embodichain_models.dynamics.rigidformer.checkpoint import ( + from embodichain.extensions.models.dynamics.rigidformer.checkpoint import ( export_rigidformer_checkpoint, ) @@ -395,7 +401,7 @@ def test_export_accepts_legacy_numpy_rng_pickle(tmp_path, monkeypatch): @pytest.mark.parametrize("random_sampling", [False, True]) def test_compact_windows_preserve_scene_stride_and_boundaries(random_sampling): from pathlib import Path - from embodichain_models.dynamics.rigidformer._native.data._index import ( + from embodichain.extensions.models.dynamics.rigidformer._native.data._index import ( _SceneWindows, ) @@ -423,10 +429,10 @@ def test_compact_windows_preserve_scene_stride_and_boundaries(random_sampling): def test_recipe_resume_crosses_epoch_and_warmup_with_exact_ema(tmp_path): pytest.importorskip("roma") pytest.importorskip("einops") - from embodichain_models.dynamics.rigidformer.sl_recipe import ( + from embodichain.extensions.models.dynamics.rigidformer.sl_recipe import ( build_rigidformer_trainer, ) - from embodichain_models.dynamics.rigidformer import ( + from embodichain.extensions.models.dynamics.rigidformer import ( export_rigidformer_checkpoint, load_rigidformer_checkpoint, ) @@ -469,8 +475,8 @@ def test_recipe_resume_crosses_epoch_and_warmup_with_exact_ema(tmp_path): @pytest.mark.gpu def test_fp32_geometry_augmentation_precedes_bf16_model_autocast(): pytest.importorskip("roma") - from embodichain_models.dynamics.rigidformer import RigidFormerModel - from embodichain_models.dynamics.rigidformer._native.data.gpu_augmentation import ( + from embodichain.extensions.models.dynamics.rigidformer import RigidFormerModel + from embodichain.extensions.models.dynamics.rigidformer._native.data.gpu_augmentation import ( GPUAugmentation, ) diff --git a/tests/models/dynamics/worldparticle/test_data.py b/tests/models/dynamics/worldparticle/test_data.py index f891c0a9e4..18560e919a 100644 --- a/tests/models/dynamics/worldparticle/test_data.py +++ b/tests/models/dynamics/worldparticle/test_data.py @@ -16,7 +16,7 @@ from __future__ import annotations import numpy as np import pytest -from embodichain_models.dynamics.worldparticle.data import load_sample +from embodichain.extensions.models.dynamics.worldparticle.data import load_sample def test_initial_state_and_reference_follow_config_slice(tmp_path): diff --git a/tests/models/dynamics/worldparticle/test_worldparticle.py b/tests/models/dynamics/worldparticle/test_worldparticle.py index 7b1e166258..0db72ead03 100644 --- a/tests/models/dynamics/worldparticle/test_worldparticle.py +++ b/tests/models/dynamics/worldparticle/test_worldparticle.py @@ -23,7 +23,7 @@ import torch import warp as wp -from embodichain_models.dynamics.worldparticle._runtime import load_assets +from embodichain.extensions.models.dynamics.worldparticle._runtime import load_assets # Tests own their explicit NoRender World when needed; pytest must not # preinitialize an unrelated renderer. CUDA bodies remain in the GPU lane. @@ -104,8 +104,10 @@ def test_public_worldparticle_provider_advances_and_resets(assets, monkeypatch): _require_cuda(native_adapter=True) import dexsim from dexsim.engine.newton_physics import NewtonCfg, ProviderNewtonSolverCfg - from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider - from embodichain_models.dynamics.worldparticle import _runtime + from embodichain.extensions.solvers.physics.worldparticle.provider import ( + WorldParticleProvider, + ) + from embodichain.extensions.models.dynamics.worldparticle import _runtime from dexsim.spawn import SceneBuilder, FluidRenderMode monkeypatch.setattr( @@ -172,7 +174,9 @@ def test_particle_force_units_rotation_buffers_and_invalid_dt(): _require_cuda(native_adapter=True) import newton from dexsim.engine.newton_physics.particle_inference import ParticleInferenceSolver - from embodichain_models.dynamics.worldparticle.model import WorldParticleModel + from embodichain.extensions.models.dynamics.worldparticle.model import ( + WorldParticleModel, + ) builder = newton.ModelBuilder() builder.add_particle( @@ -232,8 +236,10 @@ def test_unsupported_runtime_rejected_before_weights( _require_cuda() import newton from dexsim.engine.newton_physics import NewtonSolverContext - from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider - from embodichain_models.dynamics.worldparticle import _runtime + from embodichain.extensions.solvers.physics.worldparticle.provider import ( + WorldParticleProvider, + ) + from embodichain.extensions.models.dynamics.worldparticle import _runtime def forbidden_load(*_): raise AssertionError("Weights allocated before runtime validation") @@ -273,7 +279,9 @@ def test_runtime_fixed_particle_remains_fixed(mode): _require_cuda(native_adapter=True) import newton from dexsim.engine.newton_physics.particle_inference import ParticleInferenceSolver - from embodichain_models.dynamics.worldparticle.model import WorldParticleModel + from embodichain.extensions.models.dynamics.worldparticle.model import ( + WorldParticleModel, + ) builder = newton.ModelBuilder() builder.add_particle( @@ -324,7 +332,9 @@ def test_runtime_fixed_particle_remains_fixed(mode): ], ) def test_task_specific_feature_semantics(task, raw, expected): - from embodichain_models.dynamics.worldparticle._runtime import normalize_features + from embodichain.extensions.models.dynamics.worldparticle._runtime import ( + normalize_features, + ) np.testing.assert_allclose( normalize_features(task, np.asarray(raw, np.float64)), expected, atol=1e-7 @@ -332,7 +342,9 @@ def test_task_specific_feature_semantics(task, raw, expected): def test_topology_layout_and_capabilities_are_model_scoped(assets): - from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider + from embodichain.extensions.solvers.physics.worldparticle.provider import ( + WorldParticleProvider, + ) Path(assets["config"]).write_text( "data: cloth_on_ball\ntimestep: .02\ngravity: [0.,0.,0.]\n" @@ -382,7 +394,9 @@ def test_topology_checkpoint_requires_original_neighbors(assets): def test_legacy_fluid_buffer_migration_does_not_hide_missing_weights(): - from embodichain_models.dynamics.worldparticle._runtime import load_checkpoint_state + from embodichain.extensions.models.dynamics.worldparticle._runtime import ( + load_checkpoint_state, + ) network = torch.nn.Module() network.weight = torch.nn.Parameter(torch.ones(1)) @@ -406,7 +420,9 @@ def test_legacy_fluid_buffer_migration_does_not_hide_missing_weights(): def test_explicit_provider_config_does_not_resolve_builtin_solvers(): from embodichain.lab.sim.cfg import NewtonPhysicsCfg - from embodichain_solvers.physics.worldparticle.provider import WorldParticleProvider + from embodichain.extensions.solvers.physics.worldparticle.provider import ( + WorldParticleProvider, + ) from dexsim.engine.newton_physics import ProviderNewtonSolverCfg provider = ProviderNewtonSolverCfg( @@ -428,7 +444,7 @@ def test_explicit_provider_config_does_not_resolve_builtin_solvers(): def test_model_coordinate_transport_stays_fp32_under_ambient_autocast(device): if device.startswith("cuda"): _require_cuda() - from embodichain_models.dynamics.worldparticle import WorldParticleModel + from embodichain.extensions.models.dynamics.worldparticle import WorldParticleModel # An oblique rotation and non-BF16-representable input make an accidental # ambient BF16 matmul visible independently of the network implementation. diff --git a/tests/models/policy/test_act.py b/tests/models/policy/test_act.py index 987d2b8af9..98c719d452 100644 --- a/tests/models/policy/test_act.py +++ b/tests/models/policy/test_act.py @@ -27,7 +27,7 @@ import pytest import torch -from embodichain_models.policy.act import load_act_policy, policy_fingerprint +from embodichain.extensions.models.policy.act import load_act_policy, policy_fingerprint pytestmark = pytest.mark.skipif( version("lerobot") != "0.6.1", @@ -37,7 +37,7 @@ @pytest.fixture def artifact(act_data, tmp_path: Path): - from embodichain_models.policy.act import build_act_train_config + from embodichain.extensions.models.policy.act import build_act_train_config from lerobot.policies.act.modeling_act import ACTPolicy from lerobot.policies.act.processor_act import make_act_pre_post_processors @@ -81,7 +81,7 @@ def test_import_does_not_initialize_simulation(): [ sys.executable, "-c", - "from embodichain_models.policy.act import load_act_policy; import sys; assert 'dexsim' not in sys.modules", + "from embodichain.extensions.models.policy.act import load_act_policy; import sys; assert 'dexsim' not in sys.modules", ], check=True, ) diff --git a/tests/models/policy/test_act_data.py b/tests/models/policy/test_act_data.py index f3b17484bc..7f6205c0c4 100644 --- a/tests/models/policy/test_act_data.py +++ b/tests/models/policy/test_act_data.py @@ -24,7 +24,10 @@ import numpy as np import pytest -from embodichain_models.policy.act import build_act_train_config, dataset_fingerprint +from embodichain.extensions.models.policy.act import ( + build_act_train_config, + dataset_fingerprint, +) pytestmark = pytest.mark.skipif( version("lerobot") != "0.6.1", diff --git a/tests/nerd_support.py b/tests/nerd_support.py index 21fb016a4d..6faa75ae45 100644 --- a/tests/nerd_support.py +++ b/tests/nerd_support.py @@ -22,13 +22,17 @@ import torch -from embodichain_models.dynamics.nerd import NeRDModel, NeRDModelCfg, export_model +from embodichain.extensions.models.dynamics.nerd import ( + NeRDModel, + NeRDModelCfg, + export_model, +) def small_nerd_export(destination: Path, robot: str) -> Path: from examples.learning.nerd._support._reference_assets import reference_profile from examples.learning.nerd._support._reference_model import make_reference_model - from embodichain_solvers.physics.nerd._binding import NeRDBinding + from embodichain.extensions.solvers.physics.nerd._binding import NeRDBinding profile = reference_profile(robot) model = make_reference_model(robot, "cpu", 2, "native") diff --git a/tests/sim/atomic_skills/test_curobo_motion_strategy_e2e.py b/tests/sim/atomic_skills/test_curobo_motion_strategy_e2e.py index d3d28a6079..36686ce787 100644 --- a/tests/sim/atomic_skills/test_curobo_motion_strategy_e2e.py +++ b/tests/sim/atomic_skills/test_curobo_motion_strategy_e2e.py @@ -35,7 +35,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg # noqa: E402 from embodichain.lab.sim.cfg import RigidBodyPhysicsCfg # noqa: E402 from embodichain.lab.sim.objects import RigidObjectCfg # noqa: E402 -from embodichain_robots import FrankaPandaCfg # noqa: E402 +from embodichain.extensions.robots import FrankaPandaCfg # noqa: E402 from embodichain.lab.sim.shapes import CubeCfg # noqa: E402 from embodichain.lab.sim.motion.motion_generator import MotionGenCfg, MotionGenerator from embodichain.lab.sim.motion.planners.curobo.curobo_planner import ( # noqa: E402 diff --git a/tests/sim/atomic_skills/test_motion_strategy_e2e.py b/tests/sim/atomic_skills/test_motion_strategy_e2e.py index 0b0859ef35..8945fcdd63 100644 --- a/tests/sim/atomic_skills/test_motion_strategy_e2e.py +++ b/tests/sim/atomic_skills/test_motion_strategy_e2e.py @@ -22,7 +22,7 @@ import pytest from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.motion.motion_generator import MotionGenerator, MotionGenCfg from embodichain.lab.sim.motion.planners import ToppraPlannerCfg from embodichain.lab.sim.atomic_skills import ( diff --git a/tests/sim/motion/expansion/test_combined.py b/tests/sim/motion/expansion/test_combined.py index ffc1d4a0ca..920a54d0b3 100644 --- a/tests/sim/motion/expansion/test_combined.py +++ b/tests/sim/motion/expansion/test_combined.py @@ -35,7 +35,7 @@ from embodichain.lab.scripts.run_task import _create_parser, _resolve_expansion_request _TASK_CONFIG = Path(__file__).parents[4] / ( - "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/" + "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/" "task.ur5.yaml" ) diff --git a/tests/sim/motion/expansion/test_combined_runtime.py b/tests/sim/motion/expansion/test_combined_runtime.py index b97d54da0d..11cfafac83 100644 --- a/tests/sim/motion/expansion/test_combined_runtime.py +++ b/tests/sim/motion/expansion/test_combined_runtime.py @@ -42,7 +42,7 @@ _ROOT = Path(__file__).parents[4] _TASK_ROOT = ( _ROOT - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place" ) diff --git a/tests/sim/motion/planners/test_curobo_integration.py b/tests/sim/motion/planners/test_curobo_integration.py index befac9edb0..30e1b74485 100644 --- a/tests/sim/motion/planners/test_curobo_integration.py +++ b/tests/sim/motion/planners/test_curobo_integration.py @@ -39,7 +39,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg # noqa: E402 from embodichain.lab.sim.objects import RigidObjectCfg # noqa: E402 -from embodichain_robots import FrankaPandaCfg # noqa: E402 +from embodichain.extensions.robots import FrankaPandaCfg # noqa: E402 from embodichain.lab.sim.cfg import RigidBodyPhysicsCfg # noqa: E402 from embodichain.lab.sim.shapes import CubeCfg # noqa: E402 from embodichain.lab.sim.motion.motion_generator import ( diff --git a/tests/sim/motion/planners/test_curobo_planner.py b/tests/sim/motion/planners/test_curobo_planner.py index 86e1fa6a99..1ba000e4c7 100644 --- a/tests/sim/motion/planners/test_curobo_planner.py +++ b/tests/sim/motion/planners/test_curobo_planner.py @@ -2250,7 +2250,7 @@ def _build_curobo_scene(sim_device: str = "cuda") -> tuple[object, object, objec from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import RigidBodyPhysicsCfg from embodichain.lab.sim.objects import RigidObjectCfg - from embodichain_robots import FrankaPandaCfg + from embodichain.extensions.robots import FrankaPandaCfg from embodichain.lab.sim.shapes import CubeCfg sim = SimulationManager( diff --git a/tests/sim/motion/planners/test_toppra_batched.py b/tests/sim/motion/planners/test_toppra_batched.py index ec9a7e686a..eaa5daa9eb 100644 --- a/tests/sim/motion/planners/test_toppra_batched.py +++ b/tests/sim/motion/planners/test_toppra_batched.py @@ -152,7 +152,7 @@ def _make_planner(self): ToppraPlannerCfg, ) from embodichain.lab.sim import SimulationManager, SimulationManagerCfg - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg sim = SimulationManager( SimulationManagerCfg(headless=True, device="cpu", num_envs=2) @@ -760,7 +760,7 @@ def test_stopped_waypoints_keep_rest_goals_on_exact_control_grid(batch: int) -> ToppraPlanOptions, ) from embodichain.lab.sim.motion.planners.utils import PlanState - from embodichain_benchmarks.motion_generation.metrics.trajectory import ( + from embodichain.extensions.benchmarks.motion_generation.metrics.trajectory import ( _trajectory_derivatives, ) diff --git a/tests/sim/motion/planners/test_toppra_planner.py b/tests/sim/motion/planners/test_toppra_planner.py index af847325a1..0611255937 100644 --- a/tests/sim/motion/planners/test_toppra_planner.py +++ b/tests/sim/motion/planners/test_toppra_planner.py @@ -27,7 +27,7 @@ ) from embodichain.lab.sim.motion.planners.utils import PlanState, TrajectorySampleMethod from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.cfg import RenderCfg diff --git a/tests/sim/motion/solvers/test_analytic_batching.py b/tests/sim/motion/solvers/test_analytic_batching.py index 1421d576af..5e60106d09 100644 --- a/tests/sim/motion/solvers/test_analytic_batching.py +++ b/tests/sim/motion/solvers/test_analytic_batching.py @@ -21,7 +21,7 @@ import torch import warp as wp -from embodichain_robots import CobotMagicCfg, URRobotCfg +from embodichain.extensions.robots import CobotMagicCfg, URRobotCfg from embodichain.lab.sim.objects.robot import Robot from embodichain.lab.sim.motion.solvers._buffers import _IKBuffers diff --git a/tests/sim/motion/solvers/test_fep_solver.py b/tests/sim/motion/solvers/test_fep_solver.py index 77f5dc3349..cb0f864bfa 100644 --- a/tests/sim/motion/solvers/test_fep_solver.py +++ b/tests/sim/motion/solvers/test_fep_solver.py @@ -370,7 +370,7 @@ def test_franka_robot_ik_shapes_frames_and_limit_sync( from types import SimpleNamespace from embodichain.lab.sim.objects.robot import Robot - from embodichain_robots import FrankaPandaCfg + from embodichain.extensions.robots import FrankaPandaCfg cfg = FrankaPandaCfg.from_dict({}) assert isinstance(cfg.solver_cfg["arm"], FEPSolverCfg) diff --git a/tests/sim/motion/solvers/test_neural_ik_solver.py b/tests/sim/motion/solvers/test_neural_ik_solver.py index 729a11a736..4a961d307d 100644 --- a/tests/sim/motion/solvers/test_neural_ik_solver.py +++ b/tests/sim/motion/solvers/test_neural_ik_solver.py @@ -21,7 +21,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Robot -from embodichain_benchmarks.motion_generation._atomic_fixtures import ( +from embodichain.extensions.benchmarks.motion_generation._atomic_fixtures import ( _create_franka_native_hand_cfg, ) from embodichain.lab.sim.motion.solvers import NeuralIKSolverCfg diff --git a/tests/sim/motion/solvers/test_opw_solver.py b/tests/sim/motion/solvers/test_opw_solver.py index 67b3558361..01a43c9e3a 100644 --- a/tests/sim/motion/solvers/test_opw_solver.py +++ b/tests/sim/motion/solvers/test_opw_solver.py @@ -26,7 +26,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg # Base test class for OPWSolver diff --git a/tests/sim/motion/solvers/test_srs_solver.py b/tests/sim/motion/solvers/test_srs_solver.py index 5831c8bc5c..8c0975a7f1 100644 --- a/tests/sim/motion/solvers/test_srs_solver.py +++ b/tests/sim/motion/solvers/test_srs_solver.py @@ -29,10 +29,10 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.cfg import RobotCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots.dexforce.w1.params import ( +from embodichain.extensions.robots.dexforce.w1.params import ( W1ArmKineParams, ) -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1Version, ) diff --git a/tests/sim/motion/solvers/test_ssik_near_parallel.py b/tests/sim/motion/solvers/test_ssik_near_parallel.py index 039c40cfcf..98a5f62851 100644 --- a/tests/sim/motion/solvers/test_ssik_near_parallel.py +++ b/tests/sim/motion/solvers/test_ssik_near_parallel.py @@ -29,7 +29,7 @@ from scipy.spatial.transform import Rotation from embodichain.lab.sim.motion.solvers import SSIKSolver, SSIKSolverCfg -from embodichain_robots import ARX5Cfg, FlexivRizon4SCfg +from embodichain.extensions.robots import ARX5Cfg, FlexivRizon4SCfg _DEVICES = [ "cpu", @@ -380,7 +380,7 @@ def stage(phase, **details): stage("torch_imported", version=torch.__version__, intraop_threads=torch.get_num_threads(), interop_threads=torch.get_num_interop_threads()) from embodichain.lab.sim.motion.solvers import SSIKSolverCfg -from embodichain_robots import ARX5Cfg +from embodichain.extensions.robots import ARX5Cfg stage("solver_imported", source=sys.modules[SSIKSolverCfg.__module__].__file__) preset = ARX5Cfg.from_dict({}) original = preset.solver_cfg["arm"] diff --git a/tests/sim/motion/solvers/test_ssik_reference_models.py b/tests/sim/motion/solvers/test_ssik_reference_models.py index c627cc8f30..d2d259edb1 100644 --- a/tests/sim/motion/solvers/test_ssik_reference_models.py +++ b/tests/sim/motion/solvers/test_ssik_reference_models.py @@ -35,7 +35,7 @@ from embodichain.compute.kinematics._ssik_model import _extract_model from embodichain.lab.sim.motion.solvers import SSIKSolver, SSIKSolverCfg -from embodichain_robots import ARX5Cfg, FlexivRizon4SCfg +from embodichain.extensions.robots import ARX5Cfg, FlexivRizon4SCfg @pytest.fixture(scope="module") @@ -52,7 +52,7 @@ def pinned_reference() -> None: def _artifact(name: str) -> Path: return Path( str( - importlib.resources.files("embodichain_robots").joinpath( + importlib.resources.files("embodichain.extensions.robots").joinpath( "_ssik_artifacts", name + ".py" ) ) diff --git a/tests/sim/motion/solvers/test_ssik_rr_solver.py b/tests/sim/motion/solvers/test_ssik_rr_solver.py index c2969b166d..a6ee6a394e 100644 --- a/tests/sim/motion/solvers/test_ssik_rr_solver.py +++ b/tests/sim/motion/solvers/test_ssik_rr_solver.py @@ -26,7 +26,7 @@ import torch from embodichain.lab.sim.motion.solvers import SSIKSolverCfg, SolverCfg -from embodichain_robots import FlexivRizon4SCfg +from embodichain.extensions.robots import FlexivRizon4SCfg def _make_solver(device: str = "cuda", *, legacy: bool = False, **kwargs: Any): diff --git a/tests/sim/motion/solvers/test_ssik_solver.py b/tests/sim/motion/solvers/test_ssik_solver.py index 650a2c8bb7..e4e4993de7 100644 --- a/tests/sim/motion/solvers/test_ssik_solver.py +++ b/tests/sim/motion/solvers/test_ssik_solver.py @@ -39,7 +39,7 @@ vec8i, ) from embodichain.lab.sim.motion.solvers import SSIKSolver, SSIKSolverCfg, SolverCfg -from embodichain_robots import AlohaMiniCfg, TianjiMarvinCfg +from embodichain.extensions.robots import AlohaMiniCfg, TianjiMarvinCfg _DEVICE_CASES = [ "cpu", diff --git a/tests/sim/motion/solvers/test_ssik_srs_search.py b/tests/sim/motion/solvers/test_ssik_srs_search.py index 0199b83198..d2822a23e9 100644 --- a/tests/sim/motion/solvers/test_ssik_srs_search.py +++ b/tests/sim/motion/solvers/test_ssik_srs_search.py @@ -27,7 +27,7 @@ from embodichain.lab.sim.motion.solvers import SSIKSolver, SSIKSolverCfg, SolverCfg from embodichain.lab.sim.objects.robot import Robot -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg _DEVICES = [ "cpu", diff --git a/tests/sim/motion/solvers/test_ssik_warp_dependency_isolation.py b/tests/sim/motion/solvers/test_ssik_warp_dependency_isolation.py index e19f3cce2d..247a977217 100644 --- a/tests/sim/motion/solvers/test_ssik_warp_dependency_isolation.py +++ b/tests/sim/motion/solvers/test_ssik_warp_dependency_isolation.py @@ -70,8 +70,8 @@ def find_spec(self, fullname, path=None, target=None): torch.set_num_threads(1) torch.set_num_interop_threads(1) from embodichain.lab.sim.motion.solvers import SSIKSolverCfg -import embodichain_robots -preset = getattr(embodichain_robots, case["robot"]).from_dict(case["variant"]) +import embodichain.extensions.robots +preset = getattr(embodichain.extensions.robots, case["robot"]).from_dict(case["variant"]) source = preset.solver_cfg[case["part"]] chain = preset.build_pk_serial_chain(device=torch.device("cpu"))[case["part"]].to(dtype=torch.float64) assert chain.device.type == "cpu" diff --git a/tests/sim/motion/test_motion_generator.py b/tests/sim/motion/test_motion_generator.py index f618618b47..a186c3c39a 100644 --- a/tests/sim/motion/test_motion_generator.py +++ b/tests/sim/motion/test_motion_generator.py @@ -22,7 +22,7 @@ from copy import deepcopy from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.motion.planners.utils import TrajectorySampleMethod from embodichain.lab.sim.motion.motion_generator import ( diff --git a/tests/sim/motion/workspace/test_analyzer.py b/tests/sim/motion/workspace/test_analyzer.py index eee40d596a..945b51be3f 100644 --- a/tests/sim/motion/workspace/test_analyzer.py +++ b/tests/sim/motion/workspace/test_analyzer.py @@ -25,7 +25,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.motion.workspace.configs import ( SamplingConfig, VisualizationConfig, diff --git a/tests/sim/motion/workspace/test_cache.py b/tests/sim/motion/workspace/test_cache.py index 5ce7d6cceb..9fcb3a8f3a 100644 --- a/tests/sim/motion/workspace/test_cache.py +++ b/tests/sim/motion/workspace/test_cache.py @@ -605,7 +605,7 @@ def test_build_robot_cfg_asset_control_part_defaults_to_arm(): def test_build_preset_robot_cfg_franka(): """--robot FrankaPanda loads the bare-arm preset without manual frame flags.""" from embodichain.lab.scripts.analyze_workspace import build_robot_cfg - from embodichain_robots import FrankaPandaCfg + from embodichain.extensions.robots import FrankaPandaCfg cfg, part, urdf = build_robot_cfg( _robot_ns( @@ -628,7 +628,7 @@ def test_build_preset_robot_cfg_franka(): def test_build_preset_robot_cfg_cobotmagic_control_part_and_params(): """--robot CobotMagic honors --control-part and --robot-params overrides.""" from embodichain.lab.scripts.analyze_workspace import build_robot_cfg - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg cfg, part, _urdf = build_robot_cfg( _robot_ns( @@ -705,7 +705,7 @@ def _cache_robot_scene(request: pytest.FixtureRequest) -> Iterator[None]: robot = None try: from embodichain.lab.sim import SimulationManagerCfg - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg config = SimulationManagerCfg(headless=True, sim_device="cpu") sim = SimulationManager(config) diff --git a/tests/sim/motion/workspace/test_manipulability.py b/tests/sim/motion/workspace/test_manipulability.py index a4ea5ced20..d118cc96b7 100644 --- a/tests/sim/motion/workspace/test_manipulability.py +++ b/tests/sim/motion/workspace/test_manipulability.py @@ -25,7 +25,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Robot -from embodichain_robots import CobotMagicCfg +from embodichain.extensions.robots import CobotMagicCfg from embodichain.lab.sim.motion.workspace.analyzer import ( AnalysisMode, WorkspaceAnalyzer, diff --git a/tests/sim/objects/test_dual_arm.py b/tests/sim/objects/test_dual_arm.py index 90b8d52225..8edb751dbe 100644 --- a/tests/sim/objects/test_dual_arm.py +++ b/tests/sim/objects/test_dual_arm.py @@ -28,7 +28,7 @@ build_dual_arm_cfg, resolve_mounts, ) -from embodichain_robots.universal_robots.ur_robot import URRobotCfg +from embodichain.extensions.robots.universal_robots.ur_robot import URRobotCfg from embodichain.lab.sim.motion.solvers import URSolverCfg # --------------------------------------------------------------------------- # diff --git a/tests/sim/objects/test_fluid_online_runtime.py b/tests/sim/objects/test_fluid_online_runtime.py index 09a30728e4..1ef0ed1265 100644 --- a/tests/sim/objects/test_fluid_online_runtime.py +++ b/tests/sim/objects/test_fluid_online_runtime.py @@ -199,7 +199,7 @@ def test_franka_gripper_stays_stable_with_inner_rigid_solver(self): try: task = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" ) robot_cfg = config_to_cfg(load_config(task), source_path=task).robot robot = sim.add_robot(robot_cfg) @@ -234,7 +234,7 @@ def test_normal_gym_partial_reset_does_not_advance_peer(self): task = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/task.franka.fluid.yaml" ) discover_task_packages() declaration = load_config(task) diff --git a/tests/sim/objects/test_robot.py b/tests/sim/objects/test_robot.py index a9d35f1c53..bca779660d 100644 --- a/tests/sim/objects/test_robot.py +++ b/tests/sim/objects/test_robot.py @@ -27,7 +27,7 @@ from embodichain.lab.sim import SimulationManager, SimulationManagerCfg from embodichain.lab.sim.objects import Articulation, Robot from embodichain.lab.sim.objects.backends.newton import _default_mujoco_mimic_solref -from embodichain_robots.dexforce.w1 import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1 import DexforceW1Cfg from embodichain.lab.sim.cfg import physics_cfg_for_backend from embodichain.lab.sim.motion.solvers.base_solver import BaseSolver from embodichain.data import get_data_path diff --git a/tests/sim/objects/test_robot_cfg.py b/tests/sim/objects/test_robot_cfg.py index 18910edb14..b0c46b9513 100644 --- a/tests/sim/objects/test_robot_cfg.py +++ b/tests/sim/objects/test_robot_cfg.py @@ -35,21 +35,21 @@ RobotCfg, ) from embodichain.lab.sim.motion.workspace import RobotWorkspaceCfg -from embodichain_robots.dexforce.w1 import DexforceW1Cfg -from embodichain_robots.dexforce.w1.params import W1ArmKineParams -from embodichain_robots.dexforce.w1.types import ( +from embodichain.extensions.robots.dexforce.w1 import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1.params import W1ArmKineParams +from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1ArmSide, DexforceW1HandBrand, DexforceW1HandVersion, DexforceW1Type, DexforceW1Version, ) -from embodichain_robots.dexforce.w1.hand_specs import ( +from embodichain.extensions.robots.dexforce.w1.hand_specs import ( get_default_w1_hand_version, get_w1_hand_spec, ) -from embodichain_robots.dexforce.w1.specs import get_w1_version_spec -from embodichain_robots.dexforce.w1.utils import ( +from embodichain.extensions.robots.dexforce.w1.specs import get_w1_version_spec +from embodichain.extensions.robots.dexforce.w1.utils import ( build_dexforce_w1_assembly_urdf_cfg, build_dexforce_w1_control_parts, ) @@ -141,7 +141,7 @@ def test_arx5_source_chain_commands_and_ik_roundtrip( monkeypatch: pytest.MonkeyPatch, ) -> None: """X5A retains two independent fingers and a six-joint flange/TCP chain.""" - from embodichain_robots.arx.arx5 import cfg as arx5 + from embodichain.extensions.robots.arx.arx5 import cfg as arx5 source = Path(__file__).parents[2] / "fixtures/kinematics/arx5_x5a.urdf" monkeypatch.setattr(arx5, "get_data_path", lambda _: str(source)) @@ -269,10 +269,11 @@ def test_mounted_sensor_config_roundtrip_and_instance_isolation() -> None: def test_cobotmagic_mounted_defaults_replace_and_clear(monkeypatch) -> None: - from embodichain_robots import CobotMagicCfg + from embodichain.extensions.robots import CobotMagicCfg monkeypatch.setattr( - "embodichain_robots.agilex.cobotmagic.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.agilex.cobotmagic.cfg.get_data_path", + lambda value: value, ) cfg = CobotMagicCfg.from_dict({}) assert cfg.enable_sensor is False @@ -306,7 +307,7 @@ def test_cobotmagic_mounted_defaults_replace_and_clear(monkeypatch) -> None: def _mock_w1_asset_paths(monkeypatch, tmp_path): import embodichain.lab.sim.cfg as sim_cfg - from embodichain_robots.dexforce.w1 import utils as w1_utils + from embodichain.extensions.robots.dexforce.w1 import utils as w1_utils def resolve(path): resolved = tmp_path / path @@ -480,7 +481,7 @@ def test_w1_v022_provisional_eef_baseline_is_composed_consistently(): def test_w1_v022_cfg_uses_registered_asset_paths(tmp_path, monkeypatch): import embodichain.lab.sim.cfg as sim_cfg - from embodichain_robots.dexforce.w1 import utils as w1_utils + from embodichain.extensions.robots.dexforce.w1 import utils as w1_utils registered_paths = [] @@ -532,7 +533,7 @@ def test_w1_cfg_builds_complete_dual_arm_robot(monkeypatch, tmp_path): def test_w1_hand_version_is_independent_of_robot_version(monkeypatch, tmp_path): _mock_w1_asset_paths(monkeypatch, tmp_path) - from embodichain_robots.dexforce.w1 import utils as w1_utils + from embodichain.extensions.robots.dexforce.w1 import utils as w1_utils selected_versions = [] original_get_urdf = w1_utils.hand_manager.get_urdf @@ -818,10 +819,15 @@ def test_root_property_overrides_preserve_unspecified_preset_fields( assert override == original -from embodichain_robots.agilex.cobotmagic.cfg import CobotMagicCfg -from embodichain_robots import AlohaMiniCfg, TianjiMarvinCfg, ARX5Cfg, FlexivRizon4SCfg -from embodichain_robots.franka.panda import FrankaPandaCfg -from embodichain_robots.universal_robots.ur_robot import URRobotCfg +from embodichain.extensions.robots.agilex.cobotmagic.cfg import CobotMagicCfg +from embodichain.extensions.robots import ( + AlohaMiniCfg, + TianjiMarvinCfg, + ARX5Cfg, + FlexivRizon4SCfg, +) +from embodichain.extensions.robots.franka.panda import FrankaPandaCfg +from embodichain.extensions.robots.universal_robots.ur_robot import URRobotCfg from embodichain.lab.sim.motion.solvers import OPWSolverCfg @@ -857,7 +863,8 @@ def test_specified_robot_defaults_use_eef_control_part_names( module_path = "franka.cfg" monkeypatch.setattr("embodichain.data.get_data_path", lambda value: value) monkeypatch.setattr( - f"embodichain_robots.{module_path}.get_data_path", lambda value: value + f"embodichain.extensions.robots.{module_path}.get_data_path", + lambda value: value, ) cfg = robot_class.from_dict({}) @@ -1064,7 +1071,8 @@ def test_tianji_marvin_custom_asset_does_not_inherit_demo_inertials( monkeypatch, tmp_path ): monkeypatch.setattr( - "embodichain_robots.tianji.marvin.cfg.get_data_path", lambda value: value + "embodichain.extensions.robots.tianji.marvin.cfg.get_data_path", + lambda value: value, ) asset = tmp_path / "custom.urdf" asset.write_text('') @@ -1584,7 +1592,7 @@ def test_specified_robots_use_portable_joint_drive_semantics( def test_explicit_franka_hand_embodiment_owns_contact_defaults() -> None: - from embodichain_tasks.configs import get_config_path + from embodichain.extensions.tasks.configs import get_config_path from embodichain.utils.utility import load_config from embodichain.lab.gym.utils.gym_utils import _robot_cfg_from_dict @@ -1718,8 +1726,10 @@ def test_original_panda_robotiq_tcp_linkage_limits_and_model_isolation( monkeypatch, tmp_path: Path, ) -> None: - from embodichain_robots.franka import cfg as panda - from embodichain_robots.robotiq.two_finger import robotiq85_joint_positions + from embodichain.extensions.robots.franka import cfg as panda + from embodichain.extensions.robots.robotiq.two_finger import ( + robotiq85_joint_positions, + ) import pinocchio as pin fixtures = Path(__file__).parents[2] / "fixtures/kinematics" @@ -1732,7 +1742,7 @@ def source(name): return str(sources[name]) if not Path(name).is_absolute() else name monkeypatch.setattr(panda, "get_data_path", source) - from embodichain_tasks.configs import get_config_path + from embodichain.extensions.tasks.configs import get_config_path from embodichain.utils.utility import load_config from embodichain.lab.gym.utils.gym_utils import _robot_cfg_from_dict @@ -1789,7 +1799,7 @@ def source(name): @pytest.mark.no_sim def test_franka_family_preserves_legacy_configuration_and_isolates_overrides() -> None: - from embodichain_robots import FrankaCfg + from embodichain.extensions.robots import FrankaCfg legacy = FrankaPandaCfg.from_dict({"robot_type": "panda"}) family = FrankaCfg.from_dict({}) @@ -1827,7 +1837,7 @@ def test_franka_family_preserves_legacy_configuration_and_isolates_overrides() - def test_franka_family_rejects_unqualified_combinations_before_downloading( monkeypatch, values ) -> None: - from embodichain_robots.franka import cfg as module + from embodichain.extensions.robots.franka import cfg as module def download_forbidden(*args): pytest.fail("invalid Franka selection downloaded an asset") @@ -1841,7 +1851,7 @@ def download_forbidden(*args): @pytest.mark.parametrize("model", ["fr3", "panda"]) def test_franka_bare_arm_has_only_seven_source_dofs(model: str) -> None: import xml.etree.ElementTree as ET - from embodichain_robots import FrankaCfg + from embodichain.extensions.robots import FrankaCfg cfg = FrankaCfg.from_dict({"arm_model": model}) source = ET.parse(cfg.urdf_cfg.components["arm"]["urdf_path"]).getroot() diff --git a/tests/sim/robots/test_agibot_g2.py b/tests/sim/robots/test_agibot_g2.py index fdd92f3ff6..ee20876b42 100644 --- a/tests/sim/robots/test_agibot_g2.py +++ b/tests/sim/robots/test_agibot_g2.py @@ -32,8 +32,8 @@ import torch from embodichain.robot_registry import resolve_robot_cfg -from embodichain_robots import AgibotG2Cfg -from embodichain_robots.agibot.g2 import cfg as g2 +from embodichain.extensions.robots import AgibotG2Cfg +from embodichain.extensions.robots.agibot.g2 import cfg as g2 _URDF = Path(g2.__file__).with_name("g2.urdf") @@ -41,7 +41,7 @@ @pytest.mark.no_sim def test_g2_native_joint_and_mimic_contract() -> None: """Catalog counts describe the actual source tree, excluding mimic followers.""" - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS cfg = resolve_robot_cfg("AgibotG2", overrides={"fpath": str(_URDF)}) robot = ET.parse(_URDF) diff --git a/tests/sim/robots/test_agilex_piper_x.py b/tests/sim/robots/test_agilex_piper_x.py index 5c36a9d4ba..e7ffd6cce2 100644 --- a/tests/sim/robots/test_agilex_piper_x.py +++ b/tests/sim/robots/test_agilex_piper_x.py @@ -34,7 +34,7 @@ _EMBODIMENT = ( Path(__file__).resolve().parents[3] - / "extensions/embodichain_tasks/configs/components/embodiments" + / "embodichain/extensions/tasks/configs/components/embodiments" / "piper_x_agx_gripper.yaml" ) _ARM_JOINTS = [f"joint{index}" for index in range(1, 7)] diff --git a/tests/sim/robots/test_brainco_revo1.py b/tests/sim/robots/test_brainco_revo1.py index 7c29ba9c1a..a093aa0e52 100644 --- a/tests/sim/robots/test_brainco_revo1.py +++ b/tests/sim/robots/test_brainco_revo1.py @@ -42,7 +42,7 @@ @pytest.fixture def local_hands(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> dict[str, Path]: """Use original synthetic URDFs with the shipped active/mimic naming contract.""" - from embodichain_robots.brainco.revo1 import cfg as revo1 + from embodichain.extensions.robots.brainco.revo1 import cfg as revo1 paths = {} for side in ("left", "right"): @@ -100,7 +100,7 @@ def test_revo1_standalone_preserves_native_control_contract( local_hands: dict[str, Path], side: str ) -> None: """Six native actuator names survive config decoding and JSON serialization.""" - from embodichain_robots import BrainCoRevo1Cfg + from embodichain.extensions.robots import BrainCoRevo1Cfg original = resolve_robot_cfg("BrainCoRevo1", variant=side) cfg = BrainCoRevo1Cfg.from_dict(json.loads(json.dumps(original.to_dict()))) @@ -133,8 +133,8 @@ def test_revo1_defaults_overrides_and_instances_are_isolated( local_hands: dict[str, Path], monkeypatch: pytest.MonkeyPatch ) -> None: """Caller overrides neither download the catalog asset nor mutate other configs.""" - from embodichain_robots.brainco.revo1 import cfg as revo1 - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots.brainco.revo1 import cfg as revo1 + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS assert "BrainCoRevo1" in list_robot_cfgs() metadata = ROBOT_CONFIGS["BrainCoRevo1"] @@ -183,7 +183,7 @@ def unexpected_download(reference: str) -> str: @pytest.mark.no_sim @pytest.mark.parametrize("side", ("LEFT", "both", "", None)) def test_revo1_rejects_unknown_side(side: object) -> None: - from embodichain_robots import BrainCoRevo1Cfg + from embodichain.extensions.robots import BrainCoRevo1Cfg with pytest.raises((ValueError, TypeError), match="side"): BrainCoRevo1Cfg.from_dict({"side": side}) @@ -193,7 +193,7 @@ def test_revo1_rejects_unknown_side(side: object) -> None: @pytest.mark.parametrize("side", ("left", "right")) def test_w1_revo1_adapter_retains_names_frames_and_mount(side: str) -> None: """The shared model extraction preserves the established W1 assembly ABI.""" - from embodichain_robots.dexforce.w1.hand_specs import get_w1_hand_spec + from embodichain.extensions.robots.dexforce.w1.hand_specs import get_w1_hand_spec spec = get_w1_hand_spec("BRAINCO_HAND", "v021").for_side(side) title = side.title() diff --git a/tests/sim/robots/test_dexforce_w1_v030.py b/tests/sim/robots/test_dexforce_w1_v030.py index 24c4129c7c..0b42d7a3cc 100644 --- a/tests/sim/robots/test_dexforce_w1_v030.py +++ b/tests/sim/robots/test_dexforce_w1_v030.py @@ -26,14 +26,16 @@ from scipy.spatial.transform import Rotation from embodichain.lab.sim.motion.solvers import FEPSolver, FEPSolverCfg -from embodichain_robots.dexforce.w1 import DexforceW1Cfg -from embodichain_robots.dexforce.w1.utils import build_dexforce_w1_assembly_urdf_cfg +from embodichain.extensions.robots.dexforce.w1 import DexforceW1Cfg +from embodichain.extensions.robots.dexforce.w1.utils import ( + build_dexforce_w1_assembly_urdf_cfg, +) @pytest.fixture def standard_cfg(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> DexforceW1Cfg: """Split the independent full-body reference into local kinematic components.""" - from embodichain_robots.dexforce.w1 import utils + from embodichain.extensions.robots.dexforce.w1 import utils fixture = Path(__file__).parents[2] / "fixtures/kinematics/w1_v030_body.urdf" reference = ET.parse(fixture).getroot() @@ -204,7 +206,7 @@ def test_standard_cfg_search_and_partial_failures( def test_standard_component_frame_metadata_resolves_source_links( standard_cfg: DexforceW1Cfg, ) -> None: - from embodichain_robots.dexforce.w1.utils import ( + from embodichain.extensions.robots.dexforce.w1.utils import ( chassis_manager, torso_manager, head_manager, diff --git a/tests/sim/robots/test_entrypoints.py b/tests/sim/robots/test_entrypoints.py index f8bff10824..5f2aaba00a 100644 --- a/tests/sim/robots/test_entrypoints.py +++ b/tests/sim/robots/test_entrypoints.py @@ -28,11 +28,11 @@ _REPOSITORY_ROOT = Path(__file__).resolve().parents[3] _ROBOT_ENTRYPOINTS = ( - "extensions/embodichain_robots/agilex/cobotmagic/cfg.py", - "extensions/embodichain_robots/franka/panda.py", - "extensions/embodichain_robots/universal_robots/ur_robot.py", + "embodichain/extensions/robots/agilex/cobotmagic/cfg.py", + "embodichain/extensions/robots/franka/panda.py", + "embodichain/extensions/robots/universal_robots/ur_robot.py", "embodichain/lab/sim/robots/dual_arm.py", - "extensions/embodichain_robots/dexforce/w1/cfg.py", + "embodichain/extensions/robots/dexforce/w1/cfg.py", ) diff --git a/tests/sim/robots/test_flexiv_rizon4s.py b/tests/sim/robots/test_flexiv_rizon4s.py index 053820b1e6..66214fb83f 100644 --- a/tests/sim/robots/test_flexiv_rizon4s.py +++ b/tests/sim/robots/test_flexiv_rizon4s.py @@ -31,7 +31,7 @@ from embodichain.data.assets.robot_assets import FlexivRizon4S from embodichain.lab.sim.cfg import RobotCfg -from embodichain_robots import FlexivRizon4SCfg +from embodichain.extensions.robots import FlexivRizon4SCfg @pytest.mark.no_sim diff --git a/tests/sim/robots/test_imports.py b/tests/sim/robots/test_imports.py index 1c7f8430af..a64853c057 100644 --- a/tests/sim/robots/test_imports.py +++ b/tests/sim/robots/test_imports.py @@ -87,30 +87,30 @@ def test_core_does_not_reexport_concrete_robot_classes(class_name: str) -> None: @pytest.mark.parametrize("class_name", _CONFIG_CLASSES) def test_concrete_robot_class_uses_canonical_package(class_name: str) -> None: """Every official preset is accessible from the new public import package.""" - canonical = import_module("embodichain_robots") + canonical = import_module("embodichain.extensions.robots") cfg_cls = getattr(canonical, class_name) - assert cfg_cls.__module__.startswith("embodichain_robots.") + assert cfg_cls.__module__.startswith("embodichain.extensions.robots.") @pytest.mark.parametrize( "first_module", ( - "embodichain_robots._catalog", - "embodichain_robots.locomotion_profiles", - "embodichain_robots.unitree.go1", - "embodichain_robots.unitree.go2", - "embodichain_robots.unitree.g1", - "embodichain_robots.unitree.h1_2", - "embodichain_robots.anybotics.anymal_c", - "embodichain_robots.pollen_robotics.microduck", - "embodichain_robots.brainco.revo1", - "embodichain_robots.sharpa.wave", - "embodichain_robots.wuji.hand", - "embodichain_robots.dh_robotics.pgc_140_50", - "embodichain_robots.agilex.pika", - "embodichain_robots.agibot.g2", + "embodichain.extensions.robots._catalog", + "embodichain.extensions.robots.locomotion_profiles", + "embodichain.extensions.robots.unitree.go1", + "embodichain.extensions.robots.unitree.go2", + "embodichain.extensions.robots.unitree.g1", + "embodichain.extensions.robots.unitree.h1_2", + "embodichain.extensions.robots.anybotics.anymal_c", + "embodichain.extensions.robots.pollen_robotics.microduck", + "embodichain.extensions.robots.brainco.revo1", + "embodichain.extensions.robots.sharpa.wave", + "embodichain.extensions.robots.wuji.hand", + "embodichain.extensions.robots.dh_robotics.pgc_140_50", + "embodichain.extensions.robots.agilex.pika", + "embodichain.extensions.robots.agibot.g2", "embodichain.robot_registry", - "embodichain_robots.dexforce.w1.types", + "embodichain.extensions.robots.dexforce.w1.types", "embodichain.lab.sim.robots", "embodichain.lab.sim.robots.dual_arm", ), @@ -138,14 +138,14 @@ def test_package_imports_defer_concrete_robot_configs(first_module: str) -> None "sharpa.wave.cfg", "wuji.hand.cfg", ): - assert "embodichain_robots." + name not in sys.modules, name -if module.startswith("embodichain_robots") or module == "embodichain.robot_registry": + assert "embodichain.extensions.robots." + name not in sys.modules, name +if module.startswith("embodichain.extensions.robots") or module == "embodichain.robot_registry": assert "embodichain.lab.sim" not in sys.modules assert "torch" not in sys.modules """ root = Path(__file__).resolve().parents[3] env = os.environ.copy() - env["PYTHONPATH"] = os.pathsep.join((str(root), str(root / "extensions"))) + env["PYTHONPATH"] = str(root) result = subprocess.run( [sys.executable, "-c", script, first_module], cwd=root, @@ -179,14 +179,14 @@ def test_package_imports_defer_concrete_robot_configs(first_module: str) -> None ) def test_flat_robot_modules_are_retired(module_name: str) -> None: with pytest.raises(ModuleNotFoundError) as error: - import_module("embodichain_robots." + module_name) - assert error.value.name == "embodichain_robots." + module_name + import_module("embodichain.extensions.robots." + module_name) + assert error.value.name == "embodichain.extensions.robots." + module_name def test_pgi_is_not_a_public_preset() -> None: - import embodichain_robots + import embodichain.extensions.robots from embodichain.robot_registry import resolve_robot_cfg - assert not hasattr(embodichain_robots, "FrankaPandaPgiCfg") + assert not hasattr(embodichain.extensions.robots, "FrankaPandaPgiCfg") with pytest.raises(ValueError, match="Unknown robot.*FrankaPandaPgi"): resolve_robot_cfg("FrankaPandaPgi") diff --git a/tests/sim/robots/test_sharpa_hand.py b/tests/sim/robots/test_sharpa_hand.py index 566ccee4ff..274f53ae86 100644 --- a/tests/sim/robots/test_sharpa_hand.py +++ b/tests/sim/robots/test_sharpa_hand.py @@ -28,7 +28,7 @@ import torch from embodichain.robot_registry import list_robot_cfgs, resolve_robot_cfg -from embodichain_robots.sharpa.wave import cfg as hand_cfg +from embodichain.extensions.robots.sharpa.wave import cfg as hand_cfg @pytest.fixture @@ -141,7 +141,7 @@ def test_native_side_control_and_round_trip( def test_catalog_defaults_overrides_and_isolation( local_asset: dict[str, Path], monkeypatch: pytest.MonkeyPatch ) -> None: - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS assert "SharpaWave" in list_robot_cfgs() metadata = ROBOT_CONFIGS["SharpaWave"] diff --git a/tests/sim/robots/test_so101.py b/tests/sim/robots/test_so101.py index 02e70312cb..59a53a16bc 100644 --- a/tests/sim/robots/test_so101.py +++ b/tests/sim/robots/test_so101.py @@ -23,8 +23,8 @@ import pytest import torch -from embodichain_robots import SO101FollowerCfg -from embodichain_robots.the_robot_studio.so101 import cfg as so101 +from embodichain.extensions.robots import SO101FollowerCfg +from embodichain.extensions.robots.the_robot_studio.so101 import cfg as so101 pytestmark = pytest.mark.no_sim diff --git a/tests/sim/robots/test_tianji_marvin_sensors.py b/tests/sim/robots/test_tianji_marvin_sensors.py index d680fb0f35..2c4bc47f0c 100644 --- a/tests/sim/robots/test_tianji_marvin_sensors.py +++ b/tests/sim/robots/test_tianji_marvin_sensors.py @@ -28,7 +28,7 @@ from embodichain.robot_registry import resolve_robot_cfg from embodichain.lab.sim.material import VisualMaterialCfg from embodichain.lab.sim.shapes import CubeCfg -from embodichain_robots import TianjiMarvinCfg +from embodichain.extensions.robots import TianjiMarvinCfg from embodichain.lab.gym.utils.composition import resolve_gym_components @@ -147,7 +147,7 @@ class TestDexforceW1PikaSensors(TestTianjiMarvinSensors): def _robot_cfg(self): component = ( Path(__file__).parents[3] - / "extensions/embodichain_tasks/configs/components/embodiments" + / "embodichain/extensions/tasks/configs/components/embodiments" / "dexforce_w1_030_pika.yaml" ) physical = resolve_gym_components( diff --git a/tests/sim/robots/test_wuji_hand.py b/tests/sim/robots/test_wuji_hand.py index 0e4f70aa37..1a0e0e91b6 100644 --- a/tests/sim/robots/test_wuji_hand.py +++ b/tests/sim/robots/test_wuji_hand.py @@ -28,7 +28,7 @@ import torch from embodichain.robot_registry import list_robot_cfgs, resolve_robot_cfg -from embodichain_robots.wuji.hand import cfg as hand_cfg +from embodichain.extensions.robots.wuji.hand import cfg as hand_cfg @pytest.fixture @@ -102,7 +102,7 @@ def test_native_side_control_and_round_trip( def test_catalog_defaults_overrides_and_isolation( local_asset: dict[str, Path], monkeypatch: pytest.MonkeyPatch ) -> None: - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS assert "WujiHand" in list_robot_cfgs() metadata = ROBOT_CONFIGS["WujiHand"] diff --git a/tests/sim/robots/test_yam_i2rt.py b/tests/sim/robots/test_yam_i2rt.py index c4360a0e21..628b17e412 100644 --- a/tests/sim/robots/test_yam_i2rt.py +++ b/tests/sim/robots/test_yam_i2rt.py @@ -25,8 +25,8 @@ import pytest import torch -from embodichain_robots import YamI2rtCfg -from embodichain_robots.i2rt.yam import cfg as yam_i2rt +from embodichain.extensions.robots import YamI2rtCfg +from embodichain.extensions.robots.i2rt.yam import cfg as yam_i2rt pytestmark = pytest.mark.no_sim diff --git a/tests/sim/scene/expansion/test_layout_sim.py b/tests/sim/scene/expansion/test_layout_sim.py index a4a24f7718..c25bd03812 100644 --- a/tests/sim/scene/expansion/test_layout_sim.py +++ b/tests/sim/scene/expansion/test_layout_sim.py @@ -159,7 +159,7 @@ def get_obs(self, **kwargs): root = Path(__file__).resolve().parents[4] path = ( root - / "extensions/embodichain_tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" + / "embodichain/extensions/tasks/configs/tasks/manipulation/repeated_pick_place/task.ur5.yaml" ) raw = load_config(path) raw.pop("task_program", None) diff --git a/tests/sim/sensors/test_contact.py b/tests/sim/sensors/test_contact.py index b2c88ef917..1642e24459 100644 --- a/tests/sim/sensors/test_contact.py +++ b/tests/sim/sensors/test_contact.py @@ -35,7 +35,7 @@ ) from embodichain.lab.sim.shapes import CubeCfg from embodichain.lab.sim.objects import RigidObject, RigidObjectCfg, Robot -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg NUM_ENVS = 4 CONTACT_TEST_WIDTH = 320 diff --git a/tests/sim/sensors/test_contact_newton_e2e.py b/tests/sim/sensors/test_contact_newton_e2e.py index 9494a861dc..629ba62482 100644 --- a/tests/sim/sensors/test_contact_newton_e2e.py +++ b/tests/sim/sensors/test_contact_newton_e2e.py @@ -39,7 +39,7 @@ ) from embodichain.lab.sim.shapes import CubeCfg from embodichain.lab.sim.sim_manager import SimulationManager, SimulationManagerCfg -from embodichain_robots import URRobotCfg +from embodichain.extensions.robots import URRobotCfg # Queue destruction in the tests and let conftest drain it after the test and # fixture frames release borrowed solver and contact buffers. diff --git a/tests/sim/spawn/test_create_robot_integration.py b/tests/sim/spawn/test_create_robot_integration.py index 5021ec2bcb..b76d396ce3 100644 --- a/tests/sim/spawn/test_create_robot_integration.py +++ b/tests/sim/spawn/test_create_robot_integration.py @@ -24,7 +24,7 @@ import dexsim from embodichain.lab.sim.cfg import NewtonPhysicsCfg from embodichain.lab.sim import SimulationManager, SimulationManagerCfg -from embodichain_robots.franka.panda import FrankaPandaCfg +from embodichain.extensions.robots.franka.panda import FrankaPandaCfg from dexsim.engine.newton_physics.backend_registry import get_newton_backend from embodichain.lab.sim.spawn.descriptors import ( articulation_desc_from_cfg, diff --git a/tests/solvers/physics/nerd/test_provider.py b/tests/solvers/physics/nerd/test_provider.py index 4d7fca1573..5fd3b3bd76 100644 --- a/tests/solvers/physics/nerd/test_provider.py +++ b/tests/solvers/physics/nerd/test_provider.py @@ -26,8 +26,8 @@ pytest.importorskip("dexsim") from dexsim.engine.newton_physics import NewtonSolverContext -from embodichain_models.dynamics.nerd import NeRDState -from embodichain_solvers.physics.nerd.provider import NeRDProvider +from embodichain.extensions.models.dynamics.nerd import NeRDState +from embodichain.extensions.solvers.physics.nerd.provider import NeRDProvider from examples.learning.nerd._support._reference_model import make_reference_model from examples.learning.nerd._support._reference_assets import reference_profile from nerd_support import small_nerd_export diff --git a/tests/test_agent_context_map.py b/tests/test_agent_context_map.py index c259992672..759d38ce84 100644 --- a/tests/test_agent_context_map.py +++ b/tests/test_agent_context_map.py @@ -170,7 +170,7 @@ def test_rl_only_config_changes_do_not_select_task_program_context() -> None: affected = helper.affected_topics( data, [ - "extensions/embodichain_tasks/configs/tasks/" + "embodichain/extensions/tasks/configs/tasks/" "classic_control/cart_pole/agents/ppo.yaml" ], ) @@ -182,7 +182,7 @@ def test_rl_only_config_changes_do_not_select_task_program_context() -> None: def test_task_program_deployments_and_shared_components_remain_watched() -> None: helper = _load_helper() data = helper.load_map(_REPOSITORY_ROOT) - config_root = "extensions/embodichain_tasks/configs/" + config_root = "embodichain/extensions/tasks/configs/" paths = [ "tasks/manipulation/repeated_pick_place/task.ur5.yaml", "tasks/manipulation/repeated_pick_place/task_program/integration.yaml", diff --git a/tests/test_benchmark_package.py b/tests/test_benchmark_package.py index ecb0e1f7c4..233af2f987 100644 --- a/tests/test_benchmark_package.py +++ b/tests/test_benchmark_package.py @@ -49,15 +49,7 @@ def installed_benchmark(tmp_path_factory: pytest.TempPathFactory) -> tuple[Path, ): shutil.copy2(root / name, source / name) ignore = shutil.ignore_patterns("__pycache__", "*.pyc", "*.egg-info") - for name in ( - "embodichain", - "examples", - "extensions/embodichain_robots", - "extensions/embodichain_tasks", - "extensions/embodichain_benchmarks", - "extensions/embodichain_models", - "extensions/embodichain_solvers", - ): + for name in ("embodichain", "examples"): shutil.copytree(root / name, source / name, ignore=ignore) built = subprocess.run( [ @@ -86,8 +78,8 @@ def installed_benchmark(tmp_path_factory: pytest.TempPathFactory) -> tuple[Path, Requirement(value).name.lower() == "mujoco" for value in metadata.get_all("Requires-Dist", []) ) - assert "embodichain_benchmarks/__init__.py" in entries - assert "embodichain_benchmarks/motion_generation/api.py" in entries + assert "embodichain/extensions/benchmarks/__init__.py" in entries + assert "embodichain/extensions/benchmarks/motion_generation/api.py" in entries assert "embodichain/cli/benchmark.py" in entries assert "embodichain/toolkits/assembly/native.py" in entries assert not any( @@ -98,22 +90,29 @@ def installed_benchmark(tmp_path_factory: pytest.TempPathFactory) -> tuple[Path, ) for name in ("LICENSE.worldparticle", "LICENSE.tome", "PROVENANCE.json"): - assert f"embodichain_models/dynamics/worldparticle/{name}" in entries + assert ( + f"embodichain/extensions/models/dynamics/worldparticle/{name}" + in entries + ) suites = { Path(name).name for name in entries - if name.startswith("embodichain_benchmarks/motion_generation/suites/") + if name.startswith( + "embodichain/extensions/benchmarks/motion_generation/suites/" + ) and name.endswith(".yaml") } assert suites == { path.name for path in ( - root / "extensions/embodichain_benchmarks/motion_generation/suites" + root / "embodichain/extensions/benchmarks/motion_generation/suites" ).glob("*.yaml") } assert not any(name.startswith("scripts/") for name in entries) assert not any(name.startswith("embodichain/benchmarks/") for name in entries) - assert not any(name.startswith("extensions/") for name in entries) + assert not any( + name.startswith(("extensions/", "embodichain_")) for name in entries + ) target = workspace / "consumer_env" created = subprocess.run( [sys.executable, "-I", "-m", "venv", "--system-site-packages", str(target)], @@ -198,15 +197,15 @@ def find_spec(self, fullname, path=None, target=None): sys.meta_path.insert(0, RejectSamples()) from embodichain.cli.benchmark import main as benchmark_cli benchmark_cli(["--help"]) -assert not any(name == "embodichain_benchmarks" or name.startswith("embodichain_benchmarks.") for name in sys.modules) -import embodichain_benchmarks.motion_generation as benchmark -from embodichain_benchmarks.motion_generation import load_suite, run_benchmark +assert not any(name == "embodichain.extensions.benchmarks" or name.startswith("embodichain.extensions.benchmarks.") for name in sys.modules) +import embodichain.extensions.benchmarks.motion_generation as benchmark +from embodichain.extensions.benchmarks.motion_generation import load_suite, run_benchmark assert Path(benchmark.__file__).is_relative_to(target) assert "embodichain.lab.sim" not in sys.modules from embodichain.toolkits.assembly import native assert Path(native.__file__).is_relative_to(target) assert callable(native.prepare_native_configs) -from embodichain_benchmarks.assembly.precision import PrecisionRunCfg +from embodichain.extensions.benchmarks.assembly.precision import PrecisionRunCfg profile = PrecisionRunCfg(backend="newton", newton_solver="dexuni", solver="cg") assert profile.to_dict()["newton_solver"] == "dexuni" assert "embodichain.lab.sim" not in sys.modules @@ -221,13 +220,13 @@ def find_spec(self, fullname, path=None, target=None): suite = load_suite(name) assert suite.name assert load_suite().name == "motion_panda_free_space_smoke" -from embodichain_benchmarks.motion_generation import PlannerAdapter -from embodichain_benchmarks.motion_generation.scenarios.atomic_grasps import parallel_jaw_sampler +from embodichain.extensions.benchmarks.motion_generation import PlannerAdapter +from embodichain.extensions.benchmarks.motion_generation.scenarios.atomic_grasps import parallel_jaw_sampler assert parallel_jaw_sampler(2) -from embodichain_benchmarks.motion_generation.scenarios._placement_geometry import build_support_object_target_pose +from embodichain.extensions.benchmarks.motion_generation.scenarios._placement_geometry import build_support_object_target_pose import torch assert build_support_object_target_pose(torch.eye(4), torch.device("cpu")).shape == (4, 4) -from embodichain_benchmarks.motion_generation.artifacts import environment_metadata +from embodichain.extensions.benchmarks.motion_generation.artifacts import environment_metadata assert environment_metadata()["git_commit"] is None from embodichain.cli.main import main try: @@ -299,15 +298,15 @@ def test_installed_solver_entry_point_and_core_dependency_boundary( from pathlib import Path import sys -import embodichain_solvers.physics.nerd -import embodichain_solvers.physics.worldparticle -assert Path(embodichain_solvers.__file__).is_relative_to(Path(sys.prefix)) -for name in ('torch', 'newton', 'dexsim', 'embodichain_models'): +import embodichain.extensions.solvers.physics.nerd +import embodichain.extensions.solvers.physics.worldparticle +assert Path(embodichain.extensions.solvers.__file__).is_relative_to(Path(sys.prefix)) +for name in ('torch', 'newton', 'dexsim', 'embodichain.extensions.models'): assert name not in sys.modules, name class ConcreteImportsForbidden(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): - if fullname.split('.')[0] in {'embodichain_models', 'embodichain_solvers'}: + if fullname.split('.')[0] in {'embodichain.extensions.models', 'embodichain.extensions.solvers'}: raise AssertionError('Core imported a concrete implementation: ' + fullname) blocker = ConcreteImportsForbidden() @@ -315,19 +314,19 @@ def find_spec(self, fullname, path=None, target=None): from embodichain.lab.gym.envs.differentiable_env import DifferentiableEnv from embodichain.lab.sim.diff._newton_fk import _newton_fk sys.meta_path.remove(blocker) -assert 'embodichain_models' not in sys.modules +assert 'embodichain.extensions.models' not in sys.modules entries = [entry for entry in metadata.entry_points(group='dexsim.newton_solvers') if entry.name == 'nerd'] assert len(entries) == 1 -assert entries[0].value == 'embodichain_solvers.physics.nerd.provider:NeRDProvider' +assert entries[0].value == 'embodichain.extensions.solvers.physics.nerd.provider:NeRDProvider' provider = entries[0].load() assert provider.capabilities.supported_control_fields == ('joint_f',) entries = [entry for entry in metadata.entry_points(group='dexsim.newton_solvers') if entry.name == 'worldparticle'] assert len(entries) == 1 -assert entries[0].value == 'embodichain_solvers.physics.worldparticle.provider:WorldParticleProvider' +assert entries[0].value == 'embodichain.extensions.solvers.physics.worldparticle.provider:WorldParticleProvider' provider = entries[0].load() assert provider.capabilities.supported_particle_kinds == ('fluid',) assert not provider.capabilities.cuda_graph -assert 'embodichain_models.dynamics.worldparticle' not in sys.modules +assert 'embodichain.extensions.models.dynamics.worldparticle' not in sys.modules assert 'open3d.ml.torch' not in sys.modules assert 'flash_attn' not in sys.modules import dexsim diff --git a/tests/test_example_package.py b/tests/test_example_package.py index 407a1981d4..58f2654e7b 100644 --- a/tests/test_example_package.py +++ b/tests/test_example_package.py @@ -22,7 +22,7 @@ from setuptools import Distribution import setup as package_setup -from setup import get_example_data_files, get_package_dir, get_packages +from setup import get_example_data_files, get_packages pytestmark = pytest.mark.no_sim @@ -57,19 +57,7 @@ def test_distribution_preserves_the_ordinary_examples_tree(tmp_path: Path) -> No "expansion/asset_generalization/configs/pour_water/task.cobotmagic.yaml", ): assert (output / relative).is_file(), relative - assert all( - name.partition(".")[0] - in { - "embodichain", - "embodichain_tasks", - "embodichain_robots", - "embodichain_benchmarks", - "embodichain_models", - "embodichain_solvers", - } - for name in get_packages() - ) - assert "examples" not in get_package_dir() + assert not any(name.split(".")[0] == "examples" for name in get_packages()) assert not (output / "embodichain_examples").exists() diff --git a/tests/test_gripper_defaults.py b/tests/test_gripper_defaults.py index 8bccf2ca7f..430840f939 100644 --- a/tests/test_gripper_defaults.py +++ b/tests/test_gripper_defaults.py @@ -641,7 +641,7 @@ def test_native_drive_mapping_and_optional_resource_corrections(tmp_path, monkey _decode_grasp_generator, ) from embodichain.robot_registry import resolve_robot_cfg - import embodichain_robots.dh_robotics.pgi_140_80._gripper_defaults as provider + import embodichain.extensions.robots.dh_robotics.pgi_140_80._gripper_defaults as provider original = provider.get_gripper_defaults() original["joint_drive_props"]["stiffness"] = { @@ -729,7 +729,7 @@ def test_generic_dual_bound_hands_preserve_source_order_limit_overrides(tmp_path def test_generator_capabilities_are_explicit_and_do_not_grant_undeclared_endpoints( tmp_path, monkeypatch, supported ): - import embodichain_robots.dh_robotics.pgi_140_80._gripper_defaults as provider + import embodichain.extensions.robots.dh_robotics.pgi_140_80._gripper_defaults as provider values = provider.get_gripper_defaults() values["grasp_generators"] = supported @@ -808,7 +808,7 @@ def test_w1_pika_partial_prefixes_match_assembled_hand_names(): source = ( Path(__file__).resolve().parents[1] - / "extensions/embodichain_tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml" + / "embodichain/extensions/tasks/configs/components/embodiments/dexforce_w1_030_pika.yaml" ) declaration = yaml.safe_load(source.read_text()) declaration["simulation"]["urdf_cfg"]["component_prefix"] = [ diff --git a/tests/test_locomotion_catalog.py b/tests/test_locomotion_catalog.py index 5bf8e1a24e..35006cbe0e 100644 --- a/tests/test_locomotion_catalog.py +++ b/tests/test_locomotion_catalog.py @@ -27,7 +27,7 @@ from embodichain.cli.show_task import main as show_task _CONFIG_ROOT = ( - Path(__file__).resolve().parents[1] / "extensions/embodichain_tasks/configs/tasks" + Path(__file__).resolve().parents[1] / "embodichain/extensions/tasks/configs/tasks" ) _TASK_PATHS = ( "locomotion/velocity/g1_flat", @@ -42,7 +42,7 @@ @pytest.fixture(scope="module") def locomotion_catalog() -> list: - return catalog._load_catalog({"embodichain_tasks": _CONFIG_ROOT}) + return catalog._load_catalog({"embodichain.extensions.tasks": _CONFIG_ROOT}) @pytest.mark.parametrize("task_path", _TASK_PATHS) @@ -58,7 +58,7 @@ def test_locomotion_deployments_resolve_matching_ppo( assert {deployment.name for deployment in task.deployments} == {"default", "newton"} for deployment in task.deployments: suffix = ".newton" if deployment.name == "newton" else "" - prefix = f"extensions/embodichain_tasks/configs/tasks/{task_path}" + prefix = f"embodichain/extensions/tasks/configs/tasks/{task_path}" env_path = _CONFIG_ROOT / task_path / f"env{suffix}.yaml" env = yaml.safe_load(env_path.read_text()) agent = yaml.safe_load( @@ -83,7 +83,11 @@ def test_locomotion_details_and_gallery( gallery = catalog._render_html(tasks, static_only=True) for task in tasks: show_task( - [task.qualified_key, "--config-root", f"embodichain_tasks={_CONFIG_ROOT}"] + [ + task.qualified_key, + "--config-root", + f"embodichain.extensions.tasks={_CONFIG_ROOT}", + ] ) detail = capsys.readouterr().out assert task.title in detail and task.title in gallery diff --git a/tests/test_main.py b/tests/test_main.py index d43e176096..af2609548c 100644 --- a/tests/test_main.py +++ b/tests/test_main.py @@ -506,7 +506,7 @@ def test_config_environment_entries_infer_inline_robot_embodiments( def test_handwritten_demo_detection_uses_environment_hooks() -> None: """Only task classes overriding a demo hook are handwritten demos.""" - from embodichain_tasks.manipulation.tableware.blocks_ranking_size import ( + from embodichain.extensions.tasks.manipulation.tableware.blocks_ranking_size import ( BlocksRankingSizeEnv, ) from embodichain.lab.gym.envs import EmbodiedEnv @@ -611,7 +611,7 @@ def test_motion_generation_dispatch_selects_suite( expected_suite: str, ) -> None: """The domain command forwards either family and its canonical default.""" - from embodichain_benchmarks.motion_generation import cli as run_benchmark + from embodichain.extensions.benchmarks.motion_generation import cli as run_benchmark received: dict[str, object] = {} @@ -705,8 +705,8 @@ def test_benchmark_dispatch_loads_extension_only_for_motion_generation( original_import = builtins.__import__ def reject_extension(name, *args, **kwargs): - if name == "embodichain_benchmarks" or name.startswith( - "embodichain_benchmarks." + if name == "embodichain.extensions.benchmarks" or name.startswith( + "embodichain.extensions.benchmarks." ): raise AssertionError("An unrelated benchmark command loaded the extension") return original_import(name, *args, **kwargs) diff --git a/tests/test_release_metadata.py b/tests/test_release_metadata.py index ccd9100872..6afc6d3c72 100644 --- a/tests/test_release_metadata.py +++ b/tests/test_release_metadata.py @@ -29,7 +29,7 @@ import setup as package_setup from scripts.validate_wheel_metadata import WheelMetadataError, validate_wheel -from setup import get_package_data, get_package_dir, get_packages +from setup import get_package_data, get_packages _REPOSITORY_ROOT = Path(__file__).resolve().parents[1] _TEST_VERSION = "0.2.4" @@ -91,56 +91,44 @@ def _write_test_wheel(tmp_path: Path, requirements: list[str]) -> Path: def test_official_tasks_share_core_distribution_metadata() -> None: - task_root = _REPOSITORY_ROOT / "extensions" / "embodichain_tasks" + task_root = _REPOSITORY_ROOT / "embodichain" / "extensions" / "tasks" metadata = _read_project_metadata() task_entry_points = metadata["project"]["entry-points"]["embodichain.tasks"] assert not (task_root / "VERSION").exists() assert not (task_root / "pyproject.toml").exists() - assert task_entry_points == {"embodichain_tasks": "embodichain_tasks"} + assert task_entry_points == {"official_tasks": "embodichain.extensions.tasks"} def test_package_discovery_includes_only_runtime_trees() -> None: packages = get_packages() - package_dir = get_package_dir() - runtime_roots = { "embodichain", - "embodichain_tasks", - "embodichain_robots", - "embodichain_benchmarks", - "embodichain_models", - "embodichain_solvers", + "embodichain.extensions", + "embodichain.extensions.tasks", + "embodichain.extensions.robots", + "embodichain.extensions.benchmarks", + "embodichain.extensions.models", + "embodichain.extensions.solvers", } assert runtime_roots | { - "embodichain_tasks.configs", - "embodichain_robots.dexforce.w1", + "embodichain.extensions.tasks.configs", + "embodichain.extensions.robots.dexforce.w1", } <= set(packages) - assert "embodichain_tasks.manipulation.tableware" in packages + assert "embodichain.extensions.tasks.manipulation.tableware" in packages assert "embodichain.lab.gym.envs.managers.observations" in packages - assert "embodichain_solvers.physics.nerd" in packages - assert "embodichain_tasks.tableware" not in packages - assert all(package.partition(".")[0] in runtime_roots for package in packages) - assert package_dir == { - "embodichain_tasks": "extensions/embodichain_tasks/embodichain_tasks", - "embodichain_tasks.configs": "extensions/embodichain_tasks/configs", - "embodichain_robots": "extensions/embodichain_robots", - "embodichain_benchmarks": "extensions/embodichain_benchmarks", - "embodichain_models": "extensions/embodichain_models/embodichain_models", - "embodichain_solvers": "extensions/embodichain_solvers/embodichain_solvers", - } + assert "embodichain.extensions.solvers.physics.nerd" in packages + assert "embodichain.extensions.tasks.tableware" not in packages + assert all(package.partition(".")[0] == "embodichain" for package in packages) -@pytest.mark.parametrize("nested", [False, True]) def test_new_extension_package_and_resources_are_discovered( - tmp_path: Path, monkeypatch: pytest.MonkeyPatch, nested: bool + tmp_path: Path, monkeypatch: pytest.MonkeyPatch ) -> None: - extensions = tmp_path / "extensions" - project = extensions / "embodichain_example" - package = project / "embodichain_example" if nested else project + package = tmp_path / "embodichain" / "extensions" / "example" (package / "feature").mkdir(parents=True) - (package / "__init__.py").touch() - (package / "feature" / "__init__.py").touch() + for module in (package.parent.parent, package.parent, package, package / "feature"): + (module / "__init__.py").touch() resources = { "README.md": "Extension usage", "LICENSE": "Source license", @@ -164,21 +152,15 @@ def test_new_extension_package_and_resources_are_discovered( path.parent.mkdir(parents=True, exist_ok=True) path.write_text(content) monkeypatch.setattr(package_setup, "THIS_DIR", tmp_path) - monkeypatch.setattr(package_setup, "EXTENSIONS_DIR", extensions) - - assert {"embodichain_example", "embodichain_example.feature"} <= set(get_packages()) - assert ( - get_package_dir()["embodichain_example"] - == package.relative_to(tmp_path).as_posix() - ) + monkeypatch.chdir(tmp_path) + packages = get_packages() + assert { + "embodichain.extensions.example", + "embodichain.extensions.example.feature", + } <= set(packages) distribution = Distribution( { - "packages": [ - name - for name in get_packages() - if name.startswith("embodichain_example") - ], - "package_dir": {"embodichain_example": str(package)}, + "packages": packages, "package_data": get_package_data(), "include_package_data": False, "script_name": str(tmp_path / "setup.py"), @@ -188,31 +170,13 @@ def test_new_extension_package_and_resources_are_discovered( command.build_lib = str(tmp_path / "lib") command.ensure_finalized() command.run() - output = Path(command.build_lib) / "embodichain_example" + output = Path(command.build_lib) / package.relative_to(tmp_path) for relative, content in resources.items(): assert (output / relative).read_text() == content for relative in excluded: assert not (output / relative).exists(), relative -@pytest.mark.parametrize("layout", ["missing", "ambiguous", "invalid_name"]) -def test_invalid_extension_layout_is_rejected( - tmp_path: Path, monkeypatch: pytest.MonkeyPatch, layout: str -) -> None: - extensions = tmp_path / "extensions" - name = "embodichain_bad-name" if layout == "invalid_name" else "embodichain_example" - project = extensions / name - project.mkdir(parents=True) - if layout == "ambiguous": - (project / "__init__.py").touch() - (project / name).mkdir() - (project / name / "__init__.py").touch() - monkeypatch.setattr(package_setup, "EXTENSIONS_DIR", extensions) - - with pytest.raises(ValueError, match="extension package name|package layout"): - get_packages() - - def test_project_metadata_has_no_direct_dependencies() -> None: project = _read_project_metadata()["project"] requirements = list(project["dependencies"]) diff --git a/tests/test_robot_package.py b/tests/test_robot_package.py index 03eedd2e85..fdd1d91923 100644 --- a/tests/test_robot_package.py +++ b/tests/test_robot_package.py @@ -25,17 +25,16 @@ from setuptools import Distribution from setuptools.command.build_py import build_py -from setup import get_package_data, get_package_dir, get_packages +from setup import get_package_data, get_packages def test_w1_script_resolves_core_and_robots_without_editable_install( tmp_path: Path, ) -> None: - """Standalone startup finds both source trees without editable finders.""" + """Standalone startup finds the source package without an editable install.""" root = Path(__file__).resolve().parents[1] script = """ import importlib.abc -import importlib.machinery from pathlib import Path import runpy import sys @@ -49,17 +48,15 @@ class CoreDiscovered(Exception): class CoreProbe(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): - if fullname == 'embodichain': - spec = importlib.machinery.PathFinder.find_spec(fullname, sys.path) - assert spec is not None, 'standalone script cannot find the core package' - assert Path(spec.origin) == root / 'embodichain/__init__.py' - robot = sys.modules['embodichain_robots'] - assert Path(robot.__file__) == root / 'extensions/embodichain_robots/__init__.py' + if fullname == 'embodichain.lab.sim': + assert Path(sys.modules['embodichain'].__file__) == root / 'embodichain/__init__.py' + robot = sys.modules['embodichain.extensions.robots'] + assert Path(robot.__file__) == root / 'embodichain/extensions/robots/__init__.py' raise CoreDiscovered sys.meta_path.insert(0, CoreProbe()) try: - runpy.run_path(str(root / 'extensions/embodichain_robots/dexforce/w1/cfg.py'), run_name='__main__') + runpy.run_path(str(root / 'embodichain/extensions/robots/dexforce/w1/cfg.py'), run_name='__main__') except CoreDiscovered: pass else: @@ -79,15 +76,18 @@ def test_main_distribution_stages_robot_package_without_legacy_modules(tmp_path) packages = [ name for name in get_packages() - if name == "embodichain" + if name in {"embodichain", "embodichain.extensions"} or name.startswith( - ("embodichain_robots", "embodichain.lab.sim.robots", "embodichain.data") + ( + "embodichain.extensions.robots", + "embodichain.lab.sim.robots", + "embodichain.data", + ) ) ] distribution = Distribution( { "packages": packages, - "package_dir": get_package_dir(), "package_data": get_package_data(), "include_package_data": False, "script_name": "setup.py", @@ -100,33 +100,33 @@ def test_main_distribution_stages_robot_package_without_legacy_modules(tmp_path) output = Path(command.build_lib) for relative in ( - "embodichain_robots/__init__.py", - "embodichain_robots/_catalog.py", - "embodichain_robots/_asset_catalog.py", - "embodichain_robots/agibot/g2/cfg.py", - "embodichain_robots/agibot/g2/assets.py", - "embodichain_robots/agibot/g2/g2.urdf", - "embodichain_robots/agibot/g2/source.lock.json", - "embodichain_robots/agibot/g2/LICENSE", - "embodichain_robots/agibot/g2/preview.png", - "embodichain_robots/agibot/g2/preview.render.json", - "embodichain_robots/i2rt/yam/cfg.py", - "embodichain_robots/i2rt/yam/assets.py", - "embodichain_robots/_locomotion.py", - "embodichain_robots/locomotion_profiles.py", - "embodichain_robots/agibot/g1/assets.py", - "embodichain_robots/agibot/g1/cfg.py", - "embodichain_robots/agibot/g1/README.md", - "embodichain_robots/franka/assets.py", - "embodichain_robots/universal_robots/assets.py", - "embodichain_robots/dexforce/w1/assets.py", - "embodichain_robots/the_robot_studio/so101/assets.py", - "embodichain_robots/franka/panda.py", - "embodichain_robots/universal_robots/ur_robot.py", - "embodichain_robots/flexiv/rizon4s/cfg.py", - "embodichain_robots/the_robot_studio/so101/cfg.py", - "embodichain_robots/dexforce/w1/cfg.py", - "embodichain_robots/dexforce/w1/types.py", + "embodichain/extensions/robots/__init__.py", + "embodichain/extensions/robots/_catalog.py", + "embodichain/extensions/robots/_asset_catalog.py", + "embodichain/extensions/robots/agibot/g2/cfg.py", + "embodichain/extensions/robots/agibot/g2/assets.py", + "embodichain/extensions/robots/agibot/g2/g2.urdf", + "embodichain/extensions/robots/agibot/g2/source.lock.json", + "embodichain/extensions/robots/agibot/g2/LICENSE", + "embodichain/extensions/robots/agibot/g2/preview.png", + "embodichain/extensions/robots/agibot/g2/preview.render.json", + "embodichain/extensions/robots/i2rt/yam/cfg.py", + "embodichain/extensions/robots/i2rt/yam/assets.py", + "embodichain/extensions/robots/_locomotion.py", + "embodichain/extensions/robots/locomotion_profiles.py", + "embodichain/extensions/robots/agibot/g1/assets.py", + "embodichain/extensions/robots/agibot/g1/cfg.py", + "embodichain/extensions/robots/agibot/g1/README.md", + "embodichain/extensions/robots/franka/assets.py", + "embodichain/extensions/robots/universal_robots/assets.py", + "embodichain/extensions/robots/dexforce/w1/assets.py", + "embodichain/extensions/robots/the_robot_studio/so101/assets.py", + "embodichain/extensions/robots/franka/panda.py", + "embodichain/extensions/robots/universal_robots/ur_robot.py", + "embodichain/extensions/robots/flexiv/rizon4s/cfg.py", + "embodichain/extensions/robots/the_robot_studio/so101/cfg.py", + "embodichain/extensions/robots/dexforce/w1/cfg.py", + "embodichain/extensions/robots/dexforce/w1/types.py", "embodichain/lab/sim/robots/dual_arm.py", "embodichain/robot_registry.py", ): @@ -141,7 +141,7 @@ def test_main_distribution_stages_robot_package_without_legacy_modules(tmp_path) assert not (output / "embodichain/data/assets/eef_assets.py").exists() # Provenance accompanies every migrated archive in the installed package. - from embodichain_robots._asset_catalog import ROBOT_ASSETS + from embodichain.extensions.robots._asset_catalog import ROBOT_ASSETS for spec in ROBOT_ASSETS.values(): if spec["category"] != "eef": @@ -150,12 +150,14 @@ def test_main_distribution_stages_robot_package_without_legacy_modules(tmp_path) owner = output.joinpath(*module.split(".")[:-1]) assert (owner / "assets.py").is_file() assert (owner / "README.md").is_file() - assert (output / "embodichain_robots/sharpa/wave/cfg.py").is_file() - assert (output / "embodichain_robots/wuji/hand/cfg.py").is_file() + assert (output / "embodichain/extensions/robots/sharpa/wave/cfg.py").is_file() + assert (output / "embodichain/extensions/robots/wuji/hand/cfg.py").is_file() for filename in ("cfg.py", "_specs.py"): - assert (output / "embodichain_robots/brainco/revo1" / filename).is_file() + assert ( + output / "embodichain/extensions/robots/brainco/revo1" / filename + ).is_file() for retired in ("franka_panda.py", "ur_robot.py", "so101.py", "dexforce_w1"): - assert not (output / "embodichain_robots" / retired).exists() + assert not (output / "embodichain/extensions/robots" / retired).exists() for owner, retired in ( ("unitree/go1", "unitree_go1"), @@ -166,13 +168,15 @@ def test_main_distribution_stages_robot_package_without_legacy_modules(tmp_path) ("pollen_robotics/microduck", "microduck"), ): for filename in ("__init__.py", "cfg.py", "assets.py", "profile.json"): - assert (output / "embodichain_robots" / owner / filename).is_file() - assert not (output / "embodichain_robots" / f"{retired}.py").exists() + assert ( + output / "embodichain/extensions/robots" / owner / filename + ).is_file() + assert not (output / "embodichain/extensions/robots" / f"{retired}.py").exists() script = """ import sys sys.path.insert(0, sys.argv[1]) -from embodichain_robots.locomotion_profiles import load_locomotion_robot_profile +from embodichain.extensions.robots.locomotion_profiles import load_locomotion_robot_profile for robot, count in ( ('UnitreeGo1', 12), ('UnitreeGo2', 12), ('UnitreeG1', 29), ('UnitreeH1_2', 27), ('ANYmalC', 12), ('MicroDuck', 14), diff --git a/tests/test_robot_registry.py b/tests/test_robot_registry.py index 1067cb6211..b314b58bee 100644 --- a/tests/test_robot_registry.py +++ b/tests/test_robot_registry.py @@ -189,7 +189,7 @@ def test_variant_defaults_require_a_mapping(catalogs): def test_named_official_variant_selects_its_model( catalogs, local_robot_assets, name, variant, field ): - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) @@ -223,7 +223,7 @@ def test_resolver_rejects_unregistered_configuration_class_spelling(external_rob ], ) def test_official_catalog_rejects_retired_selectors(catalogs, name): - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) @@ -306,17 +306,17 @@ def local_asset(path: str) -> str: for module_name in ( "embodichain.data", "embodichain.lab.sim.cfg", - "embodichain_robots.agibot.g1.cfg", - "embodichain_robots.arx.arx5.cfg", - "embodichain_robots.alohamini.aloha_mini.cfg", - "embodichain_robots.tianji.marvin.cfg", - "embodichain_robots.agibot.g2.cfg", - "embodichain_robots.agilex.cobotmagic.cfg", - "embodichain_robots.franka.cfg", - "embodichain_robots.flexiv.rizon4s.cfg", - "embodichain_robots.the_robot_studio.so101.cfg", - "embodichain_robots.universal_robots.ur_robot", - "embodichain_robots.dexforce.w1.utils", + "embodichain.extensions.robots.agibot.g1.cfg", + "embodichain.extensions.robots.arx.arx5.cfg", + "embodichain.extensions.robots.alohamini.aloha_mini.cfg", + "embodichain.extensions.robots.tianji.marvin.cfg", + "embodichain.extensions.robots.agibot.g2.cfg", + "embodichain.extensions.robots.agilex.cobotmagic.cfg", + "embodichain.extensions.robots.franka.cfg", + "embodichain.extensions.robots.flexiv.rizon4s.cfg", + "embodichain.extensions.robots.the_robot_studio.so101.cfg", + "embodichain.extensions.robots.universal_robots.ur_robot", + "embodichain.extensions.robots.dexforce.w1.utils", ): module = import_module(module_name) if hasattr(module, "get_data_path"): @@ -356,7 +356,7 @@ def test_default_control_metadata_matches_robot_configuration( catalogs, local_robot_assets, name ): """Catalog summaries track real defaults without downloading robot assets.""" - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) @@ -390,7 +390,7 @@ def test_locomotion_presets_preserve_standalone_drive_defaults( catalogs, local_robot_assets, name, joint, stiffness, effort, height ) -> None: """Standalone presets retain the previous official task's effective drives.""" - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) cfg = registry.resolve_robot_cfg(name) @@ -458,7 +458,7 @@ def test_locomotion_overrides_are_isolated_and_roundtrip( """Caller rules lower without default overlaps and survive serialization.""" from copy import deepcopy from embodichain.lab.sim.spawn.descriptors import _joint_property_matches - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) overrides = {"joint_drive_props": {"stiffness": rules}, "control_parts": parts} @@ -514,7 +514,7 @@ def resolved(candidate): def test_locomotion_catalog_classifies_body_independently_of_arms( catalogs, name, vendor, morphology, arm_count ) -> None: - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) spec = registry._robot_specs()[name] @@ -526,8 +526,12 @@ def test_locomotion_catalog_classifies_body_independently_of_arms( def test_w1_variant_catalog_covers_body_and_independent_hand_registries(): - from embodichain_robots._catalog import ROBOT_CONFIGS, _W1_HANDS, _W1_VERSIONS - from embodichain_robots.dexforce.w1.types import ( + from embodichain.extensions.robots._catalog import ( + ROBOT_CONFIGS, + _W1_HANDS, + _W1_VERSIONS, + ) + from embodichain.extensions.robots.dexforce.w1.types import ( DexforceW1Version, DexforceW1HandBrand, ) @@ -560,7 +564,7 @@ def test_w1_variant_catalog_covers_body_and_independent_hand_registries(): + ["v030/bare"], ) def test_w1_variant_metadata_matches_config(catalogs, local_robot_assets, variant): - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) profile = ROBOT_CONFIGS["DexforceW1"]["variants"][variant] @@ -706,8 +710,8 @@ def test_dual_arm_composes_external_robot_without_builtin_mapping(external_robot def test_franka_family_profiles_use_one_implementation(catalogs, local_robot_assets): - from embodichain_robots._catalog import ROBOT_CONFIGS - from embodichain_robots import FrankaCfg, FrankaPandaCfg + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots import FrankaCfg, FrankaPandaCfg catalogs.append(_entry("official", ROBOT_CONFIGS)) for variant in ("fr3", "panda"): @@ -728,8 +732,8 @@ def test_yam_catalog_resolves_offline_assets_and_independent_controls( catalogs, tmp_path ): """The new preset participates in the shared catalog without downloads.""" - from embodichain_robots import YamI2rtCfg - from embodichain_robots._catalog import ROBOT_CONFIGS + from embodichain.extensions.robots import YamI2rtCfg + from embodichain.extensions.robots._catalog import ROBOT_CONFIGS catalogs.append(_entry("official", ROBOT_CONFIGS)) urdf = tmp_path / "yam.urdf" diff --git a/tests/test_task_catalog.py b/tests/test_task_catalog.py index 3bfb705327..f06d7435b5 100644 --- a/tests/test_task_catalog.py +++ b/tests/test_task_catalog.py @@ -33,10 +33,12 @@ def write(path: Path, value: dict) -> None: def test_gaussian_pick_place_is_one_official_task_with_three_deployments() -> None: root = ( Path(__file__).resolve().parents[1] - / "extensions/embodichain_tasks/configs/tasks" + / "embodichain/extensions/tasks/configs/tasks" + ) + tasks = catalog._load_catalog({"embodichain.extensions.tasks": root}) + task = catalog._select_task( + tasks, "embodichain.extensions.tasks:gaussian_pick_place" ) - tasks = catalog._load_catalog({"embodichain_tasks": root}) - task = catalog._select_task(tasks, "embodichain_tasks:gaussian_pick_place") assert task.task_path == ("manipulation", "gaussian_pick_place") assert task.default_deployment == "office" assert {deployment.name: deployment.env_id for deployment in task.deployments} == { @@ -96,27 +98,28 @@ def test_only_linked_deployment_acquires_rl(task_root: Path) -> None: assert a.embodiments == ("Arm",) -@pytest.mark.parametrize( - "prefix", ["embodichain_tasks/configs", "extensions/embodichain_tasks/configs"] -) def test_official_agent_references_match_outside_checkout( - task_root: Path, monkeypatch: pytest.MonkeyPatch, prefix: str + task_root: Path, monkeypatch: pytest.MonkeyPatch ) -> None: - """Both config prefixes retain RL discovery without matching CWD files.""" + """Use the packaged YAML path to match agent and deployment metadata.""" monkeypatch.chdir(task_root) write( task_root / "manipulation/pick/agents/ppo.json", - {"trainer": {"gym_config": f"{prefix}/tasks/manipulation/pick/task.a.yaml"}}, + { + "trainer": { + "gym_config": "embodichain/extensions/tasks/configs/tasks/manipulation/pick/task.a.yaml" + } + }, ) - (task,) = catalog._load_catalog({"embodichain_tasks": task_root}) + (task,) = catalog._load_catalog({"embodichain.extensions.tasks": task_root}) deployment = task.deployments[0] assert ( deployment.config_ref - == "extensions/embodichain_tasks/configs/tasks/manipulation/pick/task.a.yaml" + == "embodichain/extensions/tasks/configs/tasks/manipulation/pick/task.a.yaml" ) assert catalog._RL in deployment.capabilities assert deployment.agent_refs == ( - "extensions/embodichain_tasks/configs/tasks/manipulation/pick/agents/ppo.json", + "embodichain/extensions/tasks/configs/tasks/manipulation/pick/agents/ppo.json", ) @@ -274,9 +277,9 @@ def test_runtime_only_and_registered_capabilities_are_preserved( def test_official_catalogs_resolve_real_deployments() -> None: root = ( Path(__file__).resolve().parents[1] - / "extensions/embodichain_tasks/configs/tasks" + / "embodichain/extensions/tasks/configs/tasks" ) - tasks = catalog._load_catalog({"embodichain_tasks": root}) + tasks = catalog._load_catalog({"embodichain.extensions.tasks": root}) pick = catalog._select_task(tasks, "repeated_pick_place") assert {d.name for d in pick.deployments} >= { "franka", @@ -335,21 +338,6 @@ def test_authored_nested_deployment_stays_in_one_logical_task(task_root: Path) - assert tasks[0].deployments[0].env_id == "Nested-v1" -def test_official_discovery_prefers_core_colocated_worktree( - monkeypatch: pytest.MonkeyPatch, tmp_path: Path -) -> None: - stale_package = tmp_path / "stale" - (stale_package / "tasks").mkdir(parents=True) - monkeypatch.setattr( - catalog.importlib.resources, "files", lambda name: stale_package - ) - expected = ( - Path(__file__).resolve().parents[1] - / "extensions/embodichain_tasks/configs/tasks" - ) - assert catalog._task_config_roots(("embodichain_tasks",)) == (expected,) - - def test_validation_links_independent_physical_failure( task_root: Path, capsys: pytest.CaptureFixture[str] ) -> None: @@ -448,7 +436,7 @@ def test_carton_source_and_ordinary_rgbd_deployments_without_loading_assets( ) -> None: root = ( Path(__file__).resolve().parents[1] - / "extensions/embodichain_tasks/configs/tasks" + / "embodichain/extensions/tasks/configs/tasks" ) def forbidden(*args): @@ -457,8 +445,8 @@ def forbidden(*args): monkeypatch.setattr("embodichain.data.get_data_class", forbidden) task = next( t - for t in catalog._load_catalog({"embodichain_tasks": root}) - if t.qualified_key == "embodichain_tasks:carton_stocking" + for t in catalog._load_catalog({"embodichain.extensions.tasks": root}) + if t.qualified_key == "embodichain.extensions.tasks:carton_stocking" ) assert task.default_deployment == "panda" deployments = {deployment.name: deployment for deployment in task.deployments} diff --git a/tests/test_task_program_package_data.py b/tests/test_task_program_package_data.py index 00ecd06ec8..a2d82831a0 100644 --- a/tests/test_task_program_package_data.py +++ b/tests/test_task_program_package_data.py @@ -19,7 +19,6 @@ from __future__ import annotations import ast -from fnmatch import fnmatch import json import os from pathlib import Path @@ -33,12 +32,10 @@ from setuptools import Distribution from setuptools.command.build_py import build_py -from setup import get_package_data, get_package_dir +from setup import get_package_data, get_packages _REPOSITORY_ROOT = Path(__file__).resolve().parents[1] _SETUP_PATH = _REPOSITORY_ROOT / "setup.py" -_CONFIG_PACKAGE = "embodichain_tasks.configs" -_CONFIG_SOURCE = _REPOSITORY_ROOT / "extensions" / "embodichain_tasks" / "configs" _PROGRAMS = ( Path("tasks/manipulation/drawer_storage/task_program/program.long_horizon.yaml"), *( @@ -403,7 +400,6 @@ class _StagedConfigPackage(NamedTuple): build_lib: Path relative_outputs: frozenset[Path] - package_data: dict[str, list[str]] include_package_data: bool @@ -429,27 +425,20 @@ def _literal_setup_keyword(keyword_name: str) -> object: return ast.literal_eval(keywords[keyword_name]) -@pytest.fixture -def staged_config_package(tmp_path: Path) -> _StagedConfigPackage: +@pytest.fixture(scope="module") +def staged_config_package( + tmp_path_factory: pytest.TempPathFactory, +) -> _StagedConfigPackage: """Stage official Task Program resources through the real build command.""" package_data = get_package_data() include_package_data = _literal_setup_keyword("include_package_data") assert type(package_data) is dict assert type(include_package_data) is bool - isolated_source = tmp_path / "source" / "embodichain_tasks" / "configs" - isolated_source.mkdir(parents=True) - shutil.copyfile(_CONFIG_SOURCE / "__init__.py", isolated_source / "__init__.py") - for relative_path in _RESOURCE_PATHS: - destination = isolated_source / relative_path - destination.parent.mkdir(parents=True, exist_ok=True) - shutil.copyfile(_CONFIG_SOURCE / relative_path, destination) - - build_lib = tmp_path / "build_lib" + build_lib = tmp_path_factory.mktemp("task-config-build") distribution = Distribution( { - "packages": [_CONFIG_PACKAGE], - "package_dir": {_CONFIG_PACKAGE: str(isolated_source)}, + "packages": get_packages(), "package_data": package_data, "include_package_data": include_package_data, } @@ -473,7 +462,6 @@ def reject_manifest_command(command_name: str) -> None: return _StagedConfigPackage( build_lib=build_lib, relative_outputs=relative_outputs, - package_data=package_data, include_package_data=include_package_data, ) @@ -483,22 +471,14 @@ def test_setup_stages_all_official_task_programs( ) -> None: """The actual setup patterns put nested Task Programs in wheel staging.""" assert staged_config_package.include_package_data is False - assert get_package_dir()[_CONFIG_PACKAGE] == "extensions/embodichain_tasks/configs" - assert staged_config_package.package_data[_CONFIG_PACKAGE] == [ - "tasks/manipulation/cloth_fold/task_program/trajectory.npz", - "**/*.json", - "**/*.yaml", - "**/*.yml", - "**/README.md", - ] expected_outputs = { - Path("embodichain_tasks") / "configs" / relative_path + Path("embodichain/extensions/tasks/configs") / relative_path for relative_path in _RESOURCE_PATHS } assert expected_outputs <= staged_config_package.relative_outputs assert not ( staged_config_package.build_lib - / "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/pour_cup/assets" + / "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_cup/assets" ).exists() @@ -520,23 +500,14 @@ def test_staged_task_program_resources_decode_through_installed_paths( build_lib = Path(sys.argv[1]).resolve() expected_deployments = json.loads(sys.argv[2]) -# An installed ``embodichain_tasks`` parent package can shadow the staged -# namespace package. Pin its search path to the isolated build output -# so this subprocess really exercises the staged package resources. -import types - -staged_namespace = types.ModuleType("embodichain_tasks") -staged_namespace.__path__ = [str(build_lib / "embodichain_tasks")] -sys.modules["embodichain_tasks"] = staged_namespace - -import embodichain_tasks.configs as config_package +import embodichain.extensions.tasks.configs as config_package from embodichain.lab.task_program import load_task_program from embodichain.lab.task_program.integrations._configured_composition import ( _load_configured_task_program_deployment, ) from embodichain.lab.gym.utils._component_composition import _resolve_gym_components from embodichain.utils.utility import load_config -from embodichain_tasks.configs import get_config_path +from embodichain.extensions.tasks.configs import get_config_path module_path = Path(config_package.__file__).resolve() assert module_path.is_relative_to(build_lib), (module_path, build_lib) @@ -597,23 +568,23 @@ def test_staged_task_program_resources_decode_through_installed_paths( } -def test_drawer_storage_readme_links_survive_wheel_installation() -> None: +def test_drawer_storage_readme_links_survive_wheel_installation( + staged_config_package: _StagedConfigPackage, +) -> None: """Relative README links target files shipped in the installed package.""" - readme = _CONFIG_SOURCE / "tasks/manipulation/drawer_storage/README.md" - patterns = get_package_data()[_CONFIG_PACKAGE] + readme = ( + staged_config_package.build_lib + / "embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage/README.md" + ) targets = re.findall(r"\]\(([^)\s#]+)", readme.read_text(encoding="utf-8")) relative = [ - (readme.parent / target).resolve().relative_to(_CONFIG_SOURCE.resolve()) + readme.parent / target for target in targets if re.match(r"[a-z][a-z0-9+.-]*:", target) is None ] assert relative - assert [ - path - for path in relative - if not any(fnmatch(path.as_posix(), pattern) for pattern in patterns) - ] == [] + assert all(path.is_file() for path in relative) def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: @@ -622,7 +593,7 @@ def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: source.mkdir() for name in ("setup.py", "pyproject.toml", "README.md", "VERSION", "MANIFEST.in"): shutil.copyfile(_REPOSITORY_ROOT / name, source / name) - for name in ("embodichain", "extensions", "examples"): + for name in ("embodichain", "examples"): shutil.copytree( _REPOSITORY_ROOT / name, source / name, @@ -669,6 +640,8 @@ def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: "-I", "-c", """ +from contextlib import redirect_stdout +from io import StringIO from pathlib import Path import sys @@ -685,10 +658,10 @@ def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: import embodichain assert Path(embodichain.__file__).is_relative_to(installed) -configs = installed / "embodichain_tasks/configs/tasks/manipulation/drawer_storage" -assert not (installed / "embodichain_tasks/manipulation/drawer_storage.py").exists() +configs = installed / "embodichain/extensions/tasks/configs/tasks/manipulation/drawer_storage" +assert not (installed / "embodichain/extensions/tasks/manipulation/drawer_storage.py").exists() assert (configs / "task_program/evaluation.yaml").is_file() -assert "embodichain_tasks" not in sys.modules +assert "embodichain.extensions.tasks" not in sys.modules for name, open_positions, contained, clearance_fields, finger_stiffness in ( ("ur5", (0.0,), "cube_contained", 3, 1000.0), @@ -723,7 +696,7 @@ def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: shared_embodiments = set() for scene, expected_id in gaussian_ids.items(): path = resolve_config_path( - "extensions/embodichain_tasks/configs/tasks/manipulation/" + "embodichain/extensions/tasks/configs/tasks/manipulation/" f"gaussian_pick_place/task.{scene}.yaml", base_dir=Path.cwd(), ) @@ -756,21 +729,25 @@ def test_installed_wheel_registers_configured_tasks(tmp_path: Path) -> None: assert all((camera.width, camera.height) == (960, 540) for camera in cameras.values()) assert all(camera.enable_color and not camera.enable_depth for camera in cameras.values()) assert len(shared_embodiments) == 1 -assert not (installed / "embodichain_tasks/manipulation/gaussian_pick_place.py").exists() +assert not (installed / "embodichain/extensions/tasks/manipulation/gaussian_pick_place.py").exists() assert not (installed / "share/embodichain/examples/gym/gaussian_pick_place/configs").exists() -import embodichain_tasks +import embodichain.extensions.tasks from embodichain.cli.list_task import _collect_environment_entries +from embodichain.cli.main import main -assert Path(embodichain_tasks.__file__).is_relative_to(installed) -assert "embodichain_tasks.manipulation.drawer_storage" not in sys.modules +assert Path(embodichain.extensions.tasks.__file__).is_relative_to(installed) +assert "embodichain.extensions.tasks.manipulation.drawer_storage" not in sys.modules assert {entry.env_id for entry in _collect_environment_entries()} >= { "TaskProgramDrawerStorage-UR5-v1", "TaskProgramDrawerStorage-Franka-v1", "TaskProgramDrawerStorage-UR5-LongHorizon-v1", *gaussian_ids.values(), } - +with redirect_stdout(StringIO()) as details: + main(["show-task", "embodichain.extensions.tasks:pour_water"]) +assert "pour_water" in details.getvalue() +assert "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/pour_water/" in details.getvalue() """, str(installed), ], diff --git a/tests/toolkits/assembly/test_assets.py b/tests/toolkits/assembly/test_assets.py index c6b975a48e..2fbba18bfa 100644 --- a/tests/toolkits/assembly/test_assets.py +++ b/tests/toolkits/assembly/test_assets.py @@ -49,7 +49,7 @@ class RuntimeBlocker(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): blocked = ( "embodichain.gen_sim", "embodichain.lab", - "embodichain_tasks", "embodichain_benchmarks", + "embodichain.extensions.tasks", "embodichain.extensions.benchmarks", "mjfit", "mujoco", "dexsim", ) if any(fullname == name or fullname.startswith(name + ".") for name in blocked): @@ -150,7 +150,9 @@ def test_usd_preserves_body_ownership_vertices_and_mass(tmp_path) -> None: pytest.importorskip("pxr") # The native comparison must register schemas before the first stage. pytest.importorskip("dexsim.kit.usd") - from embodichain_benchmarks.assembly.precision import compare_usd_geometry + from embodichain.extensions.benchmarks.assembly.precision import ( + compare_usd_geometry, + ) asset = import_mjcf(SOURCE) path = asset.write_usd(tmp_path / "part.usda") diff --git a/tests/toolkits/test_parallel_jaw_grasp_pose_generator.py b/tests/toolkits/test_parallel_jaw_grasp_pose_generator.py index a2c3402556..bdf4757e6e 100644 --- a/tests/toolkits/test_parallel_jaw_grasp_pose_generator.py +++ b/tests/toolkits/test_parallel_jaw_grasp_pose_generator.py @@ -77,8 +77,8 @@ def test_numeric_grasp_entries_do_not_import_runtime_backends() -> None: class BlockRuntime(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): forbidden = ( - 'embodichain.lab', 'embodichain.gen_sim', 'embodichain_robots', - 'embodichain_tasks', 'dexsim', 'fcl', + 'embodichain.lab', 'embodichain.gen_sim', 'embodichain.extensions.robots', + 'embodichain.extensions.tasks', 'dexsim', 'fcl', 'embodichain.toolkits.graspkit.pg_grasp._antipodal_backend', 'embodichain.toolkits.graspkit.pg_grasp.collision_checker', ) diff --git a/tests/utils/test_config_paths.py b/tests/utils/test_config_paths.py index 58109f57d9..efbeed9f8f 100644 --- a/tests/utils/test_config_paths.py +++ b/tests/utils/test_config_paths.py @@ -25,6 +25,8 @@ from embodichain.utils import resolve_config_path as exported_resolve_config_path from embodichain.utils.config_paths import resolve_config_path +_TASK_CONFIG_PREFIX = "embodichain/extensions/tasks/configs" + def test_resolve_config_path_preserves_existing_path(tmp_path: Path) -> None: config_path = tmp_path / "config.yaml" @@ -46,18 +48,15 @@ def test_resolve_config_path_preserves_ordinary_relative_path( assert resolve_config_path("local/config.yaml") == Path("local/config.yaml") -@pytest.mark.parametrize( - "prefix", ["embodichain_tasks/configs", "extensions/embodichain_tasks/configs"] -) def test_resolve_config_path_redirects_packaged_task_config( tmp_path: Path, monkeypatch, - prefix: str, ) -> None: monkeypatch.chdir(tmp_path) resolved = resolve_config_path( - f"{prefix}/tasks/manipulation/tableware/" "pour_water/task.cobotmagic.yaml" + f"{_TASK_CONFIG_PREFIX}/tasks/manipulation/tableware/" + "pour_water/task.cobotmagic.yaml" ) assert resolved.is_file() @@ -65,18 +64,14 @@ def test_resolve_config_path_redirects_packaged_task_config( assert resolved.parent.name == "pour_water" -@pytest.mark.parametrize( - "prefix", ["embodichain_tasks/configs", "extensions/embodichain_tasks/configs"] -) def test_resolve_config_path_rejects_packaged_path_escape( tmp_path: Path, monkeypatch, - prefix: str, ) -> None: monkeypatch.chdir(tmp_path) with pytest.raises(ValueError, match="stay within the package"): - resolve_config_path(f"{prefix}/../VERSION") + resolve_config_path(f"{_TASK_CONFIG_PREFIX}/../VERSION") def test_owner_relative_config_ignores_same_named_cwd_file( @@ -96,38 +91,34 @@ def test_owner_relative_config_ignores_same_named_cwd_file( ) -@pytest.mark.parametrize( - "prefix", ["embodichain_tasks/configs", "extensions/embodichain_tasks/configs"] -) def test_owned_official_config_ignores_same_named_cwd_shadow( - tmp_path: Path, monkeypatch: pytest.MonkeyPatch, prefix: str + tmp_path: Path, monkeypatch: pytest.MonkeyPatch ) -> None: """Component references bind packaged configs to their imported SDK.""" - reference = Path(f"{prefix}/components/embodiments/franka_panda.yaml") + reference = Path(f"{_TASK_CONFIG_PREFIX}/components/embodiments/franka_panda.yaml") shadow = tmp_path / reference shadow.parent.mkdir(parents=True) shadow.write_text("shadow: true\n") monkeypatch.chdir(tmp_path) expected = ( Path(__file__).resolve().parents[2] - / "extensions/embodichain_tasks/configs/components/embodiments/franka_panda.yaml" + / "embodichain/extensions/tasks/configs/components/embodiments/franka_panda.yaml" ) assert resolve_config_path(reference, base_dir=tmp_path / "deployment") == expected assert resolve_config_path(reference) == reference -@pytest.mark.parametrize( - "prefix", ["embodichain_tasks/configs", "extensions/embodichain_tasks/configs"] -) def test_owned_official_config_rejects_escape_even_when_cwd_target_exists( - tmp_path: Path, monkeypatch: pytest.MonkeyPatch, prefix: str + tmp_path: Path, monkeypatch: pytest.MonkeyPatch ) -> None: """An existing CWD file cannot bypass the packaged selector boundary.""" - shadow_root = tmp_path / Path(prefix).parent + shadow_root = tmp_path / Path(_TASK_CONFIG_PREFIX).parent (shadow_root / "configs").mkdir(parents=True) (shadow_root / "VERSION").write_text("shadow\n") monkeypatch.chdir(tmp_path) with pytest.raises(ValueError, match="stay within the package"): - resolve_config_path(f"{prefix}/../VERSION", base_dir=tmp_path / "deployment") + resolve_config_path( + f"{_TASK_CONFIG_PREFIX}/../VERSION", base_dir=tmp_path / "deployment" + ) diff --git a/tests/utils/test_utility.py b/tests/utils/test_utility.py index 26ba3b15f2..7b037ccd37 100644 --- a/tests/utils/test_utility.py +++ b/tests/utils/test_utility.py @@ -84,7 +84,7 @@ def test_load_packaged_official_task_config(self, tmp_path, monkeypatch): monkeypatch.chdir(tmp_path) loaded = load_config( - "extensions/embodichain_tasks/configs/tasks/manipulation/tableware/" + "embodichain/extensions/tasks/configs/tasks/manipulation/tableware/" "pour_water/task.cobotmagic.yaml" ) From 8cbaf1bf40ddc4586a2b455908fb3ce67075c979 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Wed, 18 Nov 2026 05:22:03 +0000 Subject: [PATCH 02/12] docs(architecture): refresh extension namespace references --- docs/architecture/generated/architecture.json | 455 +++++++++--------- docs/architecture/generated/summary.md | 248 +++++----- 2 files changed, 348 insertions(+), 355 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index a7bce18684..cf76b2b279 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,8 +3,8 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "87d8d9454cd18f19d24434380bcd26bcd0dd376e", - "source_ref": "87d8d9454cd18f19d24434380bcd26bcd0dd376e", + "revision": "15ef0041fb9e811df6f0adad91b25694ff7ebe09", + "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", "limitations": [ @@ -530,8 +530,8 @@ { "path": "embodichain/lab/task_program/compiler/program.py", "symbol": "CompiledTaskProgram", - "start_line": 1343, - "end_line": 1343, + "start_line": 1345, + "end_line": 1345, "excerpt": "class CompiledTaskProgram:" } ], @@ -1591,8 +1591,8 @@ { "path": "embodichain/lab/task_program/integrations/catalog.py", "symbol": "TaskProgramIntegrationCatalog", - "start_line": 611, - "end_line": 611, + "start_line": 612, + "end_line": 612, "excerpt": "class TaskProgramIntegrationCatalog:" } ], @@ -1735,7 +1735,7 @@ ], "evidence": [ { - "path": "extensions/embodichain_benchmarks/motion_generation/__init__.py", + "path": "embodichain/extensions/benchmarks/motion_generation/__init__.py", "symbol": "", "start_line": 17, "end_line": 21, @@ -1822,14 +1822,14 @@ "neural-dynamics" ], "summary": "Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel.", - "details": "embodichain_models.dynamics.nerd owns the concrete model, portable checkpoints, physical representations, HDF5 windows and installable SL recipe. Generic MLP/normalization and supervised orchestration stay in core. The model extension imports neither the showcase nor simulation; collection, historical training and reference research belong to the example.", + "details": "embodichain.extensions.models.dynamics.nerd owns the concrete model, portable checkpoints, physical representations, HDF5 windows and installable SL recipe. Generic MLP/normalization and supervised orchestration stay in core. The model extension imports neither the showcase nor simulation; collection, historical training and reference research belong to the example.", "boundaries": [ "The core does not import concrete model implementations.", "Data/model/reference-asset payloads are external resources; numerical and physical identities remain explicit." ], "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py", + "path": "embodichain/extensions/models/dynamics/nerd/model.py", "symbol": "NeRDModel", "start_line": 201, "end_line": 201, @@ -2125,8 +2125,8 @@ { "path": "embodichain/lab/task_program/compiler/program.py", "symbol": "TaskProgramCompiler", - "start_line": 1613, - "end_line": 1613, + "start_line": 1615, + "end_line": 1615, "excerpt": "class TaskProgramCompiler:" } ], @@ -2447,7 +2447,7 @@ "robot-world-model" ], "summary": "Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay.", - "details": "embodichain_models.dynamics.rwm owns frame-local state increments and SO(3) integration, graph-connected prediction state, autoregressive objectives and fixed-byte-budget replay. Its installable build_rwm_trainer recipe composes these contracts with the shared SL learner and offline trainer. The learning/rwm example owns controlled corpus generation and fitting qualification.", + "details": "embodichain.extensions.models.dynamics.rwm owns frame-local state increments and SO(3) integration, graph-connected prediction state, autoregressive objectives and fixed-byte-budget replay. Its installable build_rwm_trainer recipe composes these contracts with the shared SL learner and offline trainer. The learning/rwm example owns controlled corpus generation and fitting qualification.", "boundaries": [ "The model family imports neither simulation nor example helpers; acquisition and execution remain caller-owned.", "Fixed control period, action semantics and ordered joints bind model and checkpoint identity.", @@ -2455,35 +2455,35 @@ ], "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py", + "path": "embodichain/extensions/models/dynamics/rwm/model.py", "symbol": "RobotWorldModel", "start_line": 77, "end_line": 77, "excerpt": "class RobotWorldModel(nn.Module):" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/predictor.py", + "path": "embodichain/extensions/models/dynamics/rwm/predictor.py", "symbol": "RWMPredictor", "start_line": 31, "end_line": 31, "excerpt": "class RWMPredictor:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/replay.py", + "path": "embodichain/extensions/models/dynamics/rwm/replay.py", "symbol": "TransitionReplay", "start_line": 35, "end_line": 35, "excerpt": "class TransitionReplay:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/supervised.py", + "path": "embodichain/extensions/models/dynamics/rwm/supervised.py", "symbol": "RobotWorldModelObjective", "start_line": 71, "end_line": 71, "excerpt": "class RobotWorldModelObjective:" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 39, "end_line": 39, @@ -2947,8 +2947,8 @@ { "path": "embodichain/lab/task_program/compiler/lowering.py", "symbol": "SemanticCallCompiler", - "start_line": 1033, - "end_line": 1033, + "start_line": 1046, + "end_line": 1046, "excerpt": "class SemanticCallCompiler:" } ], @@ -3116,8 +3116,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager", - "start_line": 562, - "end_line": 562, + "start_line": 566, + "end_line": 566, "excerpt": "class SimulationManager:" } ], @@ -3296,8 +3296,8 @@ { "path": "embodichain/lab/gym/utils/registration.py", "symbol": "discover_task_packages", - "start_line": 446, - "end_line": 446, + "start_line": 389, + "end_line": 389, "excerpt": "def discover_task_packages() -> list[str]:" } ], @@ -3349,8 +3349,8 @@ { "path": "embodichain/gen_sim/task_engine/semantic_plan_validation.py", "symbol": "_validate_interpreted_plan", - "start_line": 824, - "end_line": 831, + "start_line": 838, + "end_line": 845, "excerpt": " \"status\": \"covered\",\n \"semantic_status\": \"valid\",\n \"visual_status\": (\"complete\" if observed == total else \"pending\"),\n \"pending_bindings\": len(bindings),\n \"visual_observed_entities\": observed,\n \"visual_total_entities\": total,\n \"execution_ready\": False,\n \"runtime_evidence_status\": \"not_run\"," } ], @@ -3443,7 +3443,7 @@ ], "evidence": [ { - "path": "extensions/embodichain_tasks/embodichain_tasks/__init__.py", + "path": "embodichain/extensions/tasks/__init__.py", "symbol": "", "start_line": 17, "end_line": 23, @@ -3457,7 +3457,7 @@ "source_extension": ".rst" } ], - "details": "Official tasks are bundled in the same distribution under the embodichain_tasks import package. Import-backed tasks register during discovery, while supported configuration-defined Task Programs register when their Gym configuration is loaded." + "details": "Official tasks are bundled in the same distribution under the embodichain.extensions.tasks import package. Import-backed tasks register during discovery, while supported configuration-defined Task Programs register when their Gym configuration is loaded." }, { "id": "toolkits", @@ -4193,7 +4193,7 @@ "symbol": "_run_motion_generation_cli", "start_line": 183, "end_line": 185, - "excerpt": " from embodichain_benchmarks.motion_generation.cli import run_from_args\n\n run_from_args(args)" + "excerpt": " from embodichain.extensions.benchmarks.motion_generation.cli import run_from_args\n\n run_from_args(args)" } ] }, @@ -4331,15 +4331,15 @@ { "path": "embodichain/lab/task_program/compiler/program.py", "symbol": "TaskProgramCompiler._compile", - "start_line": 2379, - "end_line": 2384, + "start_line": 2381, + "end_line": 2386, "excerpt": " return _materialize_program(\n program_id=config.program_id,\n instruction=config.instruction,\n integration=integration,\n targets=targets,\n root=root," }, { "path": "embodichain/lab/task_program/compiler/program.py", "symbol": "_materialize_program", - "start_line": 1605, - "end_line": 1610, + "start_line": 1607, + "end_line": 1612, "excerpt": " return CompiledTaskProgram._create(\n program_id=program_id,\n instruction=instruction,\n integration=integration,\n segments=tuple(segments),\n )" } ] @@ -4356,8 +4356,8 @@ { "path": "embodichain/lab/task_program/compiler/program.py", "symbol": "TaskProgramCompiler._compile", - "start_line": 2366, - "end_line": 2368, + "start_line": 2368, + "end_line": 2370, "excerpt": " targets = self._compile_targets(config.targets)\n root = self._compile_node(\n config.program," } ] @@ -4606,28 +4606,21 @@ "symbol": "", "start_line": 100, "end_line": 101, - "excerpt": "[project.entry-points.\"embodichain.tasks\"]\nembodichain_tasks = \"embodichain_tasks\"" + "excerpt": "[project.entry-points.\"embodichain.tasks\"]\nofficial_tasks = \"embodichain.extensions.tasks\"" }, { "path": "embodichain/lab/gym/utils/registration.py", "symbol": "discover_task_packages", - "start_line": 458, - "end_line": 458, + "start_line": 401, + "end_line": 401, "excerpt": " eps = importlib.metadata.entry_points(group=\"embodichain.tasks\")" }, { "path": "embodichain/lab/gym/utils/registration.py", "symbol": "discover_task_packages", - "start_line": 465, - "end_line": 465, - "excerpt": " _import_task_package(ep)" - }, - { - "path": "embodichain/lab/gym/utils/registration.py", - "symbol": "_import_task_package", - "start_line": 416, - "end_line": 418, - "excerpt": " module_name = ep.value\n top_level = module_name.partition(\".\")[0]\n mod = importlib.import_module(module_name)" + "start_line": 408, + "end_line": 408, + "excerpt": " importlib.import_module(ep.value)" } ] }, @@ -5087,7 +5080,7 @@ "scope": "BenchmarkRunner._create_simulation.", "evidence": [ { - "path": "extensions/embodichain_benchmarks/motion_generation/runner.py", + "path": "embodichain/extensions/benchmarks/motion_generation/runner.py", "symbol": "BenchmarkRunner._create_simulation", "start_line": 276, "end_line": 286, @@ -5123,7 +5116,7 @@ "scope": "The installable NeRD supervised recipe only; the core does not resolve or import model families eagerly.", "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/nerd/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/nerd/sl_recipe.py", "symbol": "build_supervised_trainer", "start_line": 167, "end_line": 167, @@ -5143,8 +5136,8 @@ { "path": "examples/learning/nerd/__main__.py", "symbol": "main", - "start_line": 290, - "end_line": 290, + "start_line": 292, + "end_line": 292, "excerpt": " result = train_from_config(" } ] @@ -5490,14 +5483,14 @@ "scope": "The installable RWM supervised recipe only; acquisition and simulation are outside this factory, and the core does not import the model family.", "evidence": [ { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 108, "end_line": 108, "excerpt": " learner = SupervisedLearner(model, objective, optimizer, max_grad_norm=maximum_norm)" }, { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/sl_recipe.py", + "path": "embodichain/extensions/models/dynamics/rwm/sl_recipe.py", "symbol": "build_rwm_trainer", "start_line": 138, "end_line": 138, @@ -5819,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4395, - "end_line": 4396, + "start_line": 4389, + "end_line": 4390, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4435, - "end_line": 4438, + "start_line": 4429, + "end_line": 4432, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5844,8 +5837,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.start_visualization", - "start_line": 1194, - "end_line": 1199, + "start_line": 1198, + "end_line": 1203, "excerpt": " runtime = VisualizationRuntime(\n SceneExporter(self, visualization_cfg),\n visualization_cfg,\n )\n self._visualization_runtime = runtime\n runtime.start()" } ] @@ -5862,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4396, - "end_line": 4401, + "start_line": 4390, + "end_line": 4395, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5880,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4591, - "end_line": 4591, + "start_line": 4585, + "end_line": 4585, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5898,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4041, - "end_line": 4041, + "start_line": 4051, + "end_line": 4051, "excerpt": " constraint = RigidConstraint(" } ] @@ -5916,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4182, - "end_line": 4182, + "start_line": 4192, + "end_line": 4192, "excerpt": " group = RigidObjectGroup(" } ] @@ -5934,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3462, - "end_line": 3462, + "start_line": 3472, + "end_line": 3472, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5952,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4283, - "end_line": 4283, + "start_line": 4293, + "end_line": 4293, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5970,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 3841, - "end_line": 3841, + "start_line": 3851, + "end_line": 3851, "excerpt": " self._deformable_objects[uid] = deformable" } ] @@ -5988,8 +5981,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_light", - "start_line": 2973, - "end_line": 2973, + "start_line": 2983, + "end_line": 2983, "excerpt": " self._lights[uid] = batch_lights" } ] @@ -6030,24 +6023,6 @@ } ] }, - { - "id": "static-imports-01a9592b5f6f", - "source": "simulation-manager", - "target": "configuration", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/sim/sim_manager.py", - "symbol": "", - "start_line": 166, - "end_line": 166, - "excerpt": "from embodichain.utils import configclass, logger" - } - ] - }, { "id": "static-imports-023d746bdd8d", "source": "scene-generation", @@ -6084,6 +6059,24 @@ } ] }, + { + "id": "static-imports-0439aa147cbd", + "source": "integration-catalog", + "target": "task-program-config", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/task_program/integrations/catalog.py", + "symbol": "", + "start_line": 96, + "end_line": 104, + "excerpt": "from embodichain.lab.task_program.language.schema import (\n ConditionValidatorCfg,\n TaskProgramCfg,\n TaskProgramIntegrationCfg,\n PostPolicyCfg,\n RegisteredSemanticCallCfg,\n SemanticCallCfg,\n ValidatorCfg,\n)" + } + ] + }, { "id": "static-imports-095579fb8b55", "source": "differentiable-trainer", @@ -6120,6 +6113,24 @@ } ] }, + { + "id": "static-imports-0b585d90034a", + "source": "tasks", + "target": "config-loader", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/extensions/tasks/__init__.py", + "symbol": "", + "start_line": 27, + "end_line": 27, + "excerpt": "from embodichain.lab.gym.utils.gym_utils import register_manager_modules" + } + ] + }, { "id": "static-imports-0c5f841524c0", "source": "online-dataset", @@ -6336,6 +6347,24 @@ } ] }, + { + "id": "static-imports-1cb8ca231ed7", + "source": "integration-catalog", + "target": "semantic-compiler", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/task_program/integrations/catalog.py", + "symbol": "", + "start_line": 79, + "end_line": 85, + "excerpt": "from embodichain.lab.task_program.compiler.lowering import (\n ContainerRelationTargetGrounder,\n HandOverPoseProvider,\n RegisteredSemanticLowerer,\n RelationTargetGrounder,\n SupportSurfaceRelationTargetGrounder,\n)" + } + ] + }, { "id": "static-imports-1d52e30c0b32", "source": "articulations", @@ -6606,6 +6635,24 @@ } ] }, + { + "id": "static-imports-3d3109273aad", + "source": "simulation-manager", + "target": "configuration", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 170, + "end_line": 170, + "excerpt": "from embodichain.utils import configclass, logger" + } + ] + }, { "id": "static-imports-3d4c7a13ce4e", "source": "environment-adapter", @@ -6804,6 +6851,24 @@ } ] }, + { + "id": "static-imports-51cfd1108753", + "source": "robot-world-model", + "target": "configuration", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/extensions/models/dynamics/rwm/model.py", + "symbol": "", + "start_line": 45, + "end_line": 45, + "excerpt": "from embodichain.utils import configclass" + } + ] + }, { "id": "static-imports-529bd7af88fc", "source": "scene-editing", @@ -6912,6 +6977,24 @@ } ] }, + { + "id": "static-imports-5d39a2c66b5b", + "source": "neural-dynamics", + "target": "configuration", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/extensions/models/dynamics/nerd/model.py", + "symbol": "", + "start_line": 31, + "end_line": 31, + "excerpt": "from embodichain.utils import configclass" + } + ] + }, { "id": "static-imports-5dea4cdf81b7", "source": "data-pipeline", @@ -7164,24 +7247,6 @@ } ] }, - { - "id": "static-imports-72897e797d52", - "source": "robot-world-model", - "target": "configuration", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py", - "symbol": "", - "start_line": 45, - "end_line": 45, - "excerpt": "from embodichain.utils import configclass" - } - ] - }, { "id": "static-imports-735fdeb87797", "source": "simulation-manager", @@ -7236,24 +7301,6 @@ } ] }, - { - "id": "static-imports-7a0fb061e5eb", - "source": "integration-catalog", - "target": "parallel-execution", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/task_program/integrations/catalog.py", - "symbol": "", - "start_line": 91, - "end_line": 93, - "excerpt": "from embodichain.lab.task_program.runtime.parallel_executor import (\n ParallelCommandSafetyValidator,\n)" - } - ] - }, { "id": "static-imports-819e3ce626d3", "source": "physics", @@ -7344,24 +7391,6 @@ } ] }, - { - "id": "static-imports-86942e4dcbbb", - "source": "integration-catalog", - "target": "semantic-compiler", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/task_program/integrations/catalog.py", - "symbol": "", - "start_line": 78, - "end_line": 84, - "excerpt": "from embodichain.lab.task_program.compiler.lowering import (\n ContainerRelationTargetGrounder,\n HandOverPoseProvider,\n RegisteredSemanticLowerer,\n RelationTargetGrounder,\n SupportSurfaceRelationTargetGrounder,\n)" - } - ] - }, { "id": "static-imports-87dcd41f5830", "source": "simulation-factory", @@ -7398,24 +7427,6 @@ } ] }, - { - "id": "static-imports-8dc5959ea472", - "source": "neural-dynamics", - "target": "configuration", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py", - "symbol": "", - "start_line": 31, - "end_line": 31, - "excerpt": "from embodichain.utils import configclass" - } - ] - }, { "id": "static-imports-930e47fbc08a", "source": "collision-processor", @@ -7434,24 +7445,6 @@ } ] }, - { - "id": "static-imports-93cee5e09878", - "source": "tasks", - "target": "config-loader", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "extensions/embodichain_tasks/embodichain_tasks/__init__.py", - "symbol": "", - "start_line": 30, - "end_line": 30, - "excerpt": "from embodichain.lab.gym.utils.gym_utils import register_manager_modules" - } - ] - }, { "id": "static-imports-9a93b3074225", "source": "rl-routing", @@ -7488,6 +7481,42 @@ } ] }, + { + "id": "static-imports-9ccfb0f3bdcf", + "source": "simulation-manager", + "target": "physics", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 141, + "end_line": 141, + "excerpt": "from embodichain.lab.sim.physics import make_physics_backend" + } + ] + }, + { + "id": "static-imports-9e8c80d64a20", + "source": "integration-catalog", + "target": "parallel-execution", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/task_program/integrations/catalog.py", + "symbol": "", + "start_line": 92, + "end_line": 94, + "excerpt": "from embodichain.lab.task_program.runtime.parallel_executor import (\n ParallelCommandSafetyValidator,\n)" + } + ] + }, { "id": "static-imports-a225c2b26ae1", "source": "environment-adapter", @@ -7848,24 +7877,6 @@ } ] }, - { - "id": "static-imports-c84985d043b9", - "source": "simulation-manager", - "target": "physics", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/sim/sim_manager.py", - "symbol": "", - "start_line": 137, - "end_line": 137, - "excerpt": "from embodichain.lab.sim.physics import make_physics_backend" - } - ] - }, { "id": "static-imports-c8cfa7225b4a", "source": "embodied-env", @@ -7956,24 +7967,6 @@ } ] }, - { - "id": "static-imports-de7d2002c14c", - "source": "integration-catalog", - "target": "task-program-config", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/task_program/integrations/catalog.py", - "symbol": "", - "start_line": 95, - "end_line": 103, - "excerpt": "from embodichain.lab.task_program.language.schema import (\n ConditionValidatorCfg,\n TaskProgramCfg,\n TaskProgramIntegrationCfg,\n PostPolicyCfg,\n RegisteredSemanticCallCfg,\n SemanticCallCfg,\n ValidatorCfg,\n)" - } - ] - }, { "id": "static-imports-e100b414a9a5", "source": "embodied-env", @@ -8563,6 +8556,9 @@ "static-imports-42ede9f875a7", "static-imports-0c5f841524c0", "static-imports-5dea4cdf81b7", + "static-imports-5d39a2c66b5b", + "static-imports-51cfd1108753", + "static-imports-0b585d90034a", "static-imports-384d24ede117", "static-imports-2b46f5300ceb", "static-imports-7117cd19afa0", @@ -8604,8 +8600,8 @@ "static-imports-735fdeb87797", "static-imports-30e2933cfbeb", "static-imports-a38ea1f6aa90", - "static-imports-c84985d043b9", - "static-imports-01a9592b5f6f", + "static-imports-9ccfb0f3bdcf", + "static-imports-3d3109273aad", "static-imports-3d4c7a13ce4e", "static-imports-14722eceaa11", "static-imports-84f40c9ef00a", @@ -8626,10 +8622,7 @@ "static-imports-762916dd292b", "static-imports-9a93b3074225", "static-imports-12bfadcb1d0e", - "static-imports-7045336779d1", - "static-imports-8dc5959ea472", - "static-imports-72897e797d52", - "static-imports-93cee5e09878" + "static-imports-7045336779d1" ], "groups": [ { @@ -8855,9 +8848,9 @@ "static-imports-c6dd97cd134c", "static-imports-8350ecf8d7c9", "static-imports-0d77cfea421a", - "static-imports-86942e4dcbbb", - "static-imports-7a0fb061e5eb", - "static-imports-de7d2002c14c", + "static-imports-1cb8ca231ed7", + "static-imports-9e8c80d64a20", + "static-imports-0439aa147cbd", "static-imports-3d4c7a13ce4e", "static-imports-62adb31d7b9c", "static-imports-14722eceaa11", @@ -9060,8 +9053,8 @@ "static-imports-735fdeb87797", "static-imports-30e2933cfbeb", "static-imports-a38ea1f6aa90", - "static-imports-c84985d043b9", - "static-imports-01a9592b5f6f" + "static-imports-9ccfb0f3bdcf", + "static-imports-3d3109273aad" ], "groups": [ { @@ -9363,7 +9356,7 @@ "static-imports-a954b58f9edc", "static-imports-17df33c96f97", "static-imports-9bc131d4e099", - "static-imports-01a9592b5f6f" + "static-imports-3d3109273aad" ], "groups": [ { diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index 6336b00c5b..cb5ba801e6 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `87d8d9454cd18f19d24434380bcd26bcd0dd376e` · package 0.3.2 +Source revision: `15ef0041fb9e811df6f0adad91b25694ff7ebe09` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/utils/registration.py#L446-L446) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/extensions/embodichain_tasks/embodichain_tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/compiler/program.py#L1613-L1613) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/compiler/lowering.py#L1033-L1033) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/extensions/embodichain_benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/sim_manager.py#L562-L562) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/articulation.py#L724-L724) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/algo/ppo.py#L52-L52) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/policies/actor_critic.py#L33-L33) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/buffer/standard_buffer.py#L27-L27) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/extensions/embodichain_models/embodichain_models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/extensions/embodichain_models/embodichain_models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/articulation.py#L724-L724) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/ppo.py#L52-L52) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/actor_critic.py#L33-L33) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/buffer/standard_buffer.py#L27-L27) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/compiler/program.py#L1343-L1343) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/integrations/catalog.py#L611-L611) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/87d8d9454cd18f19d24434380bcd26bcd0dd376e/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From 3b719d63b6b4d1266a3cc134f074b9cb60b4ebaf Mon Sep 17 00:00:00 2001 From: yuecideng Date: Wed, 18 Nov 2026 05:40:45 +0000 Subject: [PATCH 03/12] test(ci): stage extension fixtures as nested packages --- tests/ci/test_container_verification.py | 21 ++++++--------------- 1 file changed, 6 insertions(+), 15 deletions(-) diff --git a/tests/ci/test_container_verification.py b/tests/ci/test_container_verification.py index 0b4a3ace76..323e146746 100644 --- a/tests/ci/test_container_verification.py +++ b/tests/ci/test_container_verification.py @@ -61,13 +61,14 @@ def test_qualification_requires_installed_code_and_resources( metadata.mkdir() (metadata / "METADATA").write_text("Name: embodichain\nVersion: 0.0.0\n") repo = tmp_path / "checkout" - for name in ( + package_names = ( "embodichain", "embodichain.extensions.tasks", "embodichain.extensions.robots", - ): + ) + for name in package_names: for base in (site, repo): - package = base / name + package = base.joinpath(*name.split(".")) package.mkdir(parents=True) source = ( "raise RuntimeError('source checkout imported')\n" @@ -79,12 +80,7 @@ def test_qualification_requires_installed_code_and_resources( if installation == "wheel": (site / "embodichain/payload.txt").write_text("shipped") if installation == "editable": - for name in ( - "embodichain", - "embodichain.extensions.tasks", - "embodichain.extensions.robots", - ): - shutil.rmtree(site / name) + shutil.rmtree(site / "embodichain") (site / "editable.pth").write_text(str(repo) + "\n") (repo / "scripts").mkdir() @@ -110,12 +106,7 @@ def test_qualification_requires_installed_code_and_resources( assert result == { "cases": 1, "imports": { - name: str(site / name) - for name in ( - "embodichain", - "embodichain.extensions.tasks", - "embodichain.extensions.robots", - ) + name: str(site.joinpath(*name.split("."))) for name in package_names }, } else: From be260e79675b21ee5f68e6f59ffbdaf78c976f1f Mon Sep 17 00:00:00 2001 From: yuecideng Date: Wed, 18 Nov 2026 14:46:39 +0000 Subject: [PATCH 04/12] docs(architecture): refresh the snapshot after syncing main --- docs/architecture/generated/architecture.json | 82 +++--- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 165 insertions(+), 165 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index cf76b2b279..1d4138c1ee 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "15ef0041fb9e811df6f0adad91b25694ff7ebe09", + "revision": "f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", @@ -31,8 +31,8 @@ { "path": "embodichain/learning/rl/policies/actor_critic.py", "symbol": "ActorCritic", - "start_line": 33, - "end_line": 33, + "start_line": 36, + "end_line": 36, "excerpt": "class ActorCritic(Policy):" } ], @@ -145,8 +145,8 @@ { "path": "embodichain/lab/sim/objects/articulation.py", "symbol": "Articulation", - "start_line": 724, - "end_line": 724, + "start_line": 739, + "end_line": 739, "excerpt": "class Articulation(BatchEntity):" } ], @@ -2097,8 +2097,8 @@ { "path": "embodichain/learning/rl/algo/ppo.py", "symbol": "PPO", - "start_line": 52, - "end_line": 52, + "start_line": 53, + "end_line": 53, "excerpt": "class PPO(BaseAlgorithm[TensorDict]):" } ], @@ -2519,8 +2519,8 @@ { "path": "embodichain/learning/rl/buffer/standard_buffer.py", "symbol": "RolloutBuffer", - "start_line": 27, - "end_line": 27, + "start_line": 29, + "end_line": 29, "excerpt": "class RolloutBuffer:" } ], @@ -3785,8 +3785,8 @@ { "path": "embodichain/learning/rl/policies/actor_critic.py", "symbol": "ActorCritic", - "start_line": 33, - "end_line": 33, + "start_line": 36, + "end_line": 36, "excerpt": "class ActorCritic(Policy):" } ] @@ -3947,8 +3947,8 @@ { "path": "embodichain/lab/sim/objects/articulation.py", "symbol": "Articulation", - "start_line": 724, - "end_line": 724, + "start_line": 739, + "end_line": 739, "excerpt": "class Articulation(BatchEntity):" } ] @@ -4690,8 +4690,8 @@ { "path": "embodichain/lab/gym/envs/embodied_env.py", "symbol": "EmbodiedEnv.create_task_program_bridge", - "start_line": 4307, - "end_line": 4307, + "start_line": 4316, + "end_line": 4316, "excerpt": " bridge = self._checked_task_program_adapter().create_bridge(" } ] @@ -4708,8 +4708,8 @@ { "path": "embodichain/lab/gym/envs/embodied_env.py", "symbol": "EmbodiedEnv.compile_task_program", - "start_line": 4242, - "end_line": 4242, + "start_line": 4251, + "end_line": 4251, "excerpt": " return self._checked_task_program_adapter().compile(program)" } ] @@ -4726,8 +4726,8 @@ { "path": "embodichain/lab/gym/envs/embodied_env.py", "symbol": "EmbodiedEnv._declare_robot", - "start_line": 3966, - "end_line": 3966, + "start_line": 3975, + "end_line": 3975, "excerpt": " return self.sim.add_robot(robot_cfg)" } ] @@ -5316,8 +5316,8 @@ { "path": "embodichain/learning/rl/utils/trainer.py", "symbol": "Trainer.__init__", - "start_line": 140, - "end_line": 140, + "start_line": 141, + "end_line": 141, "excerpt": " self.collector = SyncCollector(" } ] @@ -5812,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4389, - "end_line": 4390, + "start_line": 4418, + "end_line": 4419, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4429, - "end_line": 4432, + "start_line": 4458, + "end_line": 4461, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5855,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4390, - "end_line": 4395, + "start_line": 4419, + "end_line": 4424, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5873,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4585, - "end_line": 4585, + "start_line": 4614, + "end_line": 4614, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5891,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4051, - "end_line": 4051, + "start_line": 4080, + "end_line": 4080, "excerpt": " constraint = RigidConstraint(" } ] @@ -5909,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4192, - "end_line": 4192, + "start_line": 4221, + "end_line": 4221, "excerpt": " group = RigidObjectGroup(" } ] @@ -5927,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3472, - "end_line": 3472, + "start_line": 3501, + "end_line": 3501, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5945,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4293, - "end_line": 4293, + "start_line": 4322, + "end_line": 4322, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5963,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 3851, - "end_line": 3851, + "start_line": 3880, + "end_line": 3880, "excerpt": " self._deformable_objects[uid] = deformable" } ] @@ -5981,8 +5981,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_light", - "start_line": 2983, - "end_line": 2983, + "start_line": 3012, + "end_line": 3012, "excerpt": " self._lights[uid] = batch_lights" } ] diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index cb5ba801e6..747e07096d 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `15ef0041fb9e811df6f0adad91b25694ff7ebe09` · package 0.3.2 +Source revision: `f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/articulation.py#L724-L724) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/ppo.py#L52-L52) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/actor_critic.py#L33-L33) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/buffer/standard_buffer.py#L27-L27) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/15ef0041fb9e811df6f0adad91b25694ff7ebe09/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From 75fc5a1efe7b65e4e857f96844d00961670c0944 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 04:53:37 +0000 Subject: [PATCH 05/12] docs(architecture): refresh the snapshot after merging main --- docs/architecture/generated/architecture.json | 42 +-- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 145 insertions(+), 145 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index 1d4138c1ee..b6f5fffe0e 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83", + "revision": "c247197e8260700a32bff47c7fa74100c38b7377", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", @@ -5812,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4418, - "end_line": 4419, + "start_line": 4427, + "end_line": 4428, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4458, - "end_line": 4461, + "start_line": 4467, + "end_line": 4470, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5855,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4419, - "end_line": 4424, + "start_line": 4428, + "end_line": 4433, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5873,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4614, - "end_line": 4614, + "start_line": 4623, + "end_line": 4623, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5891,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4080, - "end_line": 4080, + "start_line": 4089, + "end_line": 4089, "excerpt": " constraint = RigidConstraint(" } ] @@ -5909,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4221, - "end_line": 4221, + "start_line": 4230, + "end_line": 4230, "excerpt": " group = RigidObjectGroup(" } ] @@ -5927,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3501, - "end_line": 3501, + "start_line": 3510, + "end_line": 3510, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5945,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4322, - "end_line": 4322, + "start_line": 4331, + "end_line": 4331, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5963,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 3880, - "end_line": 3880, + "start_line": 3889, + "end_line": 3889, "excerpt": " self._deformable_objects[uid] = deformable" } ] @@ -5981,8 +5981,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_light", - "start_line": 3012, - "end_line": 3012, + "start_line": 3021, + "end_line": 3021, "excerpt": " self._lights[uid] = batch_lights" } ] diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index 747e07096d..5a3a036c54 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83` · package 0.3.2 +Source revision: `c247197e8260700a32bff47c7fa74100c38b7377` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/f1a22b6b998a35cc5db6a3a75d08ce3bd3be9f83/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From fe10605fce43af0c0fea06a47a85c97d2fc1689f Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 11:30:36 +0000 Subject: [PATCH 06/12] docs(architecture): refresh after syncing main --- docs/architecture/generated/architecture.json | 342 +++++++++--------- docs/architecture/generated/summary.md | 248 ++++++------- 2 files changed, 295 insertions(+), 295 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index b6f5fffe0e..d23562aa9f 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "c247197e8260700a32bff47c7fa74100c38b7377", + "revision": "b3bad38b5effeee6848d9733703aefbbd114d6e8", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", @@ -496,8 +496,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "BufferedGymCommandSink", - "start_line": 864, - "end_line": 864, + "start_line": 892, + "end_line": 892, "excerpt": "class BufferedGymCommandSink:" } ], @@ -681,8 +681,8 @@ { "path": "embodichain/lab/gym/utils/gym_utils.py", "symbol": "build_env_cfg_from_args", - "start_line": 1954, - "end_line": 1954, + "start_line": 1978, + "end_line": 1978, "excerpt": "def build_env_cfg_from_args(" } ], @@ -1181,8 +1181,8 @@ { "path": "embodichain/lab/scripts/run_task.py", "symbol": "cli", - "start_line": 2015, - "end_line": 2015, + "start_line": 2059, + "end_line": 2059, "excerpt": "def cli(argv: Sequence[str] | None = None) -> None:" } ], @@ -1418,8 +1418,8 @@ { "path": "embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py", "symbol": "GripperCollisionChecker", - "start_line": 39, - "end_line": 39, + "start_line": 96, + "end_line": 96, "excerpt": "class GripperCollisionChecker:" } ], @@ -1556,8 +1556,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge", - "start_line": 1149, - "end_line": 1149, + "start_line": 1177, + "end_line": 1177, "excerpt": "class TaskProgramDemoBridge:" } ], @@ -1591,8 +1591,8 @@ { "path": "embodichain/lab/task_program/integrations/catalog.py", "symbol": "TaskProgramIntegrationCatalog", - "start_line": 612, - "end_line": 612, + "start_line": 618, + "end_line": 618, "excerpt": "class TaskProgramIntegrationCatalog:" } ], @@ -1765,8 +1765,8 @@ { "path": "embodichain/lab/sim/motion/motion_generator.py", "symbol": "MotionGenerator", - "start_line": 310, - "end_line": 310, + "start_line": 334, + "end_line": 334, "excerpt": "class MotionGenerator:" } ], @@ -2310,8 +2310,8 @@ { "path": "embodichain/lab/sim/objects/rigid_object.py", "symbol": "RigidObject", - "start_line": 430, - "end_line": 430, + "start_line": 434, + "end_line": 434, "excerpt": "class RigidObject(BatchEntity):" } ], @@ -2607,8 +2607,8 @@ "path": "embodichain/lab/sim/scene/expansion/__init__.py", "symbol": "", "start_line": 28, - "end_line": 30, - "excerpt": "from .cfg import SceneExpansionCfg\nfrom .contracts import ScenePoseChange, SceneVariant\nfrom .source import FixedSceneCandidateSource" + "end_line": 31, + "excerpt": "from .cfg import SceneExpansionCfg\nfrom .contracts import ScenePoseChange, SceneVariant\nfrom .conditions import SceneLayoutCondition\nfrom .source import FixedSceneCandidateSource" }, { "path": "embodichain/lab/sim/scene/expansion/source.py", @@ -3116,8 +3116,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager", - "start_line": 566, - "end_line": 566, + "start_line": 580, + "end_line": 580, "excerpt": "class SimulationManager:" } ], @@ -3983,8 +3983,8 @@ { "path": "embodichain/lab/gym/envs/base_env.py", "symbol": "BaseEnv._setup_scene", - "start_line": 535, - "end_line": 539, + "start_line": 545, + "end_line": 549, "excerpt": " self.sim = SimulationManager(\n self.sim_cfg,\n defer_startup_summary=True,\n requires_native_renderer=requires_native_renderer,\n )" } ] @@ -4001,8 +4001,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge.__init__", - "start_line": 1287, - "end_line": 1287, + "start_line": 1315, + "end_line": 1315, "excerpt": " self._clock = clock" } ] @@ -4019,8 +4019,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge.__init__", - "start_line": 1285, - "end_line": 1285, + "start_line": 1313, + "end_line": 1313, "excerpt": " self._runtime = runtime" }, { @@ -4044,8 +4044,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge.__init__", - "start_line": 1284, - "end_line": 1284, + "start_line": 1312, + "end_line": 1312, "excerpt": " self._program = program" }, { @@ -4069,8 +4069,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge.__init__", - "start_line": 1286, - "end_line": 1286, + "start_line": 1314, + "end_line": 1314, "excerpt": " self._sink = command_sink" } ] @@ -4087,8 +4087,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge._segment_actions", - "start_line": 1995, - "end_line": 1995, + "start_line": 2023, + "end_line": 2023, "excerpt": " self._sink.pop()," } ] @@ -4399,15 +4399,15 @@ { "path": "embodichain/lab/gym/utils/gym_utils.py", "symbol": "build_env_cfg_from_args", - "start_line": 2012, - "end_line": 2017, + "start_line": 2036, + "end_line": 2041, "excerpt": " cfg: EmbodiedEnvCfg = config_to_cfg(\n gym_config,\n manager_modules=get_manager_modules(),\n source_path=gym_config_source_path,\n task_program_path_override=getattr(args, \"task_program\", None),\n )" }, { "path": "embodichain/lab/scripts/run_task.py", "symbol": "cli", - "start_line": 2185, - "end_line": 2185, + "start_line": 2229, + "end_line": 2229, "excerpt": " env = gymnasium.make(id=gym_config[\"id\"], cfg=env_cfg, **action_config)" } ] @@ -4604,8 +4604,8 @@ { "path": "pyproject.toml", "symbol": "", - "start_line": 100, - "end_line": 101, + "start_line": 101, + "end_line": 102, "excerpt": "[project.entry-points.\"embodichain.tasks\"]\nofficial_tasks = \"embodichain.extensions.tasks\"" }, { @@ -4974,8 +4974,8 @@ { "path": "embodichain/lab/scripts/run_task.py", "symbol": "cli", - "start_line": 2053, - "end_line": 2053, + "start_line": 2097, + "end_line": 2097, "excerpt": " env_cfg, gym_config, action_config = build_env_cfg_from_args(args)" } ] @@ -4992,8 +4992,8 @@ { "path": "embodichain/lab/scripts/run_task.py", "symbol": "cli", - "start_line": 2048, - "end_line": 2048, + "start_line": 2092, + "end_line": 2092, "excerpt": " discover_task_packages()" } ] @@ -5244,8 +5244,8 @@ { "path": "embodichain/lab/sim/objects/rigid_object.py", "symbol": "RigidObject", - "start_line": 430, - "end_line": 430, + "start_line": 434, + "end_line": 434, "excerpt": "class RigidObject(BatchEntity):" } ] @@ -5812,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4427, - "end_line": 4428, + "start_line": 4638, + "end_line": 4639, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4467, - "end_line": 4470, + "start_line": 4678, + "end_line": 4681, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5837,8 +5837,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.start_visualization", - "start_line": 1198, - "end_line": 1203, + "start_line": 1245, + "end_line": 1250, "excerpt": " runtime = VisualizationRuntime(\n SceneExporter(self, visualization_cfg),\n visualization_cfg,\n )\n self._visualization_runtime = runtime\n runtime.start()" } ] @@ -5855,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4428, - "end_line": 4433, + "start_line": 4639, + "end_line": 4644, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5873,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4623, - "end_line": 4623, + "start_line": 4834, + "end_line": 4834, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5891,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4089, - "end_line": 4089, + "start_line": 4300, + "end_line": 4300, "excerpt": " constraint = RigidConstraint(" } ] @@ -5909,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4230, - "end_line": 4230, + "start_line": 4441, + "end_line": 4441, "excerpt": " group = RigidObjectGroup(" } ] @@ -5927,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3510, - "end_line": 3510, + "start_line": 3721, + "end_line": 3721, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5945,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4331, - "end_line": 4331, + "start_line": 4542, + "end_line": 4542, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5963,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 3889, - "end_line": 3889, + "start_line": 4100, + "end_line": 4100, "excerpt": " self._deformable_objects[uid] = deformable" } ] @@ -5981,8 +5981,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_light", - "start_line": 3021, - "end_line": 3021, + "start_line": 3227, + "end_line": 3227, "excerpt": " self._lights[uid] = batch_lights" } ] @@ -5999,8 +5999,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "BufferedGymCommandSink.__init__", - "start_line": 880, - "end_line": 881, + "start_line": 908, + "end_line": 909, "excerpt": " self._encoder = encoder\n self._clock = clock" } ] @@ -6059,6 +6059,24 @@ } ] }, + { + "id": "static-imports-02ef4754d36f", + "source": "simulation-manager", + "target": "sensors", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 106, + "end_line": 106, + "excerpt": "from embodichain.lab.sim.sensors import _builtin_sensor_factories" + } + ] + }, { "id": "static-imports-0439aa147cbd", "source": "integration-catalog", @@ -6384,9 +6402,9 @@ ] }, { - "id": "static-imports-1fcaaf2a281e", + "id": "static-imports-1efe7f42a374", "source": "env-launcher", - "target": "task-discovery", + "target": "config-loader", "relation": "imports", "description": "The selected source module declares an absolute import associated with this target.", "provenance": "static-extracted", @@ -6395,9 +6413,9 @@ { "path": "embodichain/lab/scripts/run_task.py", "symbol": "", - "start_line": 54, - "end_line": 57, - "excerpt": "from embodichain.lab.gym.utils.registration import (\n discover_task_packages,\n execute_init_hooks,\n)" + "start_line": 50, + "end_line": 56, + "excerpt": "from embodichain.lab.gym.utils.gym_utils import (\n add_env_launcher_args_to_parser,\n build_env_cfg_from_args,\n configure_fluid_spacing,\n load_trajectory,\n _load_expansion_declaration,\n)" } ] }, @@ -6527,24 +6545,6 @@ } ] }, - { - "id": "static-imports-30e2933cfbeb", - "source": "simulation-manager", - "target": "sensors", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/sim/sim_manager.py", - "symbol": "", - "start_line": 95, - "end_line": 104, - "excerpt": "from embodichain.lab.sim.sensors import (\n SensorCfg,\n BaseSensor,\n Camera,\n CameraCfg,\n StereoCamera,\n StereoCameraCfg,\n ContactSensor,\n SensorContext,\n)" - } - ] - }, { "id": "static-imports-31678f8689cc", "source": "urdf-assembly", @@ -6635,24 +6635,6 @@ } ] }, - { - "id": "static-imports-3d3109273aad", - "source": "simulation-manager", - "target": "configuration", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/sim/sim_manager.py", - "symbol": "", - "start_line": 170, - "end_line": 170, - "excerpt": "from embodichain.utils import configclass, logger" - } - ] - }, { "id": "static-imports-3d4c7a13ce4e", "source": "environment-adapter", @@ -7067,24 +7049,6 @@ } ] }, - { - "id": "static-imports-67a3a6ca9069", - "source": "env-launcher", - "target": "config-loader", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/scripts/run_task.py", - "symbol": "", - "start_line": 47, - "end_line": 53, - "excerpt": "from embodichain.lab.gym.utils.gym_utils import (\n add_env_launcher_args_to_parser,\n build_env_cfg_from_args,\n configure_fluid_spacing,\n load_trajectory,\n _load_expansion_declaration,\n)" - } - ] - }, { "id": "static-imports-680c8e9017d5", "source": "articulations", @@ -7248,9 +7212,9 @@ ] }, { - "id": "static-imports-735fdeb87797", + "id": "static-imports-726d1e8f3927", "source": "simulation-manager", - "target": "gizmo", + "target": "sensors", "relation": "imports", "description": "The selected source module declares an absolute import associated with this target.", "provenance": "static-extracted", @@ -7259,9 +7223,9 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "", - "start_line": 94, - "end_line": 94, - "excerpt": "from embodichain.lab.sim.objects.gizmo import Gizmo, GizmoCfg" + "start_line": 96, + "end_line": 105, + "excerpt": "from embodichain.lab.sim.sensors import (\n SensorCfg,\n BaseSensor,\n Camera,\n CameraCfg,\n StereoCamera,\n StereoCameraCfg,\n ContactSensor,\n SensorContext,\n)" } ] }, @@ -7301,6 +7265,24 @@ } ] }, + { + "id": "static-imports-78872b465d8c", + "source": "simulation-manager", + "target": "configuration", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 171, + "end_line": 171, + "excerpt": "from embodichain.utils import configclass, logger" + } + ] + }, { "id": "static-imports-819e3ce626d3", "source": "physics", @@ -7481,24 +7463,6 @@ } ] }, - { - "id": "static-imports-9ccfb0f3bdcf", - "source": "simulation-manager", - "target": "physics", - "relation": "imports", - "description": "The selected source module declares an absolute import associated with this target.", - "provenance": "static-extracted", - "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", - "evidence": [ - { - "path": "embodichain/lab/sim/sim_manager.py", - "symbol": "", - "start_line": 141, - "end_line": 141, - "excerpt": "from embodichain.lab.sim.physics import make_physics_backend" - } - ] - }, { "id": "static-imports-9e8c80d64a20", "source": "integration-catalog", @@ -7572,20 +7536,20 @@ ] }, { - "id": "static-imports-a38ea1f6aa90", - "source": "simulation-manager", - "target": "sensors", + "id": "static-imports-a43d0369f3e6", + "source": "env-launcher", + "target": "task-discovery", "relation": "imports", "description": "The selected source module declares an absolute import associated with this target.", "provenance": "static-extracted", "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", "evidence": [ { - "path": "embodichain/lab/sim/sim_manager.py", + "path": "embodichain/lab/scripts/run_task.py", "symbol": "", - "start_line": 105, - "end_line": 105, - "excerpt": "from embodichain.lab.sim.sensors import _builtin_sensor_factories" + "start_line": 57, + "end_line": 60, + "excerpt": "from embodichain.lab.gym.utils.registration import (\n discover_task_packages,\n execute_init_hooks,\n)" } ] }, @@ -7733,6 +7697,24 @@ } ] }, + { + "id": "static-imports-b2a8f9f1b012", + "source": "simulation-manager", + "target": "physics", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 142, + "end_line": 142, + "excerpt": "from embodichain.lab.sim.physics import make_physics_backend" + } + ] + }, { "id": "static-imports-b87e50be9752", "source": "recording", @@ -7751,6 +7733,24 @@ } ] }, + { + "id": "static-imports-bacd2acfbd2e", + "source": "simulation-manager", + "target": "gizmo", + "relation": "imports", + "description": "The selected source module declares an absolute import associated with this target.", + "provenance": "static-extracted", + "scope": "Module-level declaration. Not a runtime call or proof that every class in the file uses the imported symbol.", + "evidence": [ + { + "path": "embodichain/lab/sim/sim_manager.py", + "symbol": "", + "start_line": 95, + "end_line": 95, + "excerpt": "from embodichain.lab.sim.objects.gizmo import Gizmo, GizmoCfg" + } + ] + }, { "id": "static-imports-bd39f7e063d7", "source": "embodied-env", @@ -8582,8 +8582,8 @@ "static-imports-b87e50be9752", "static-imports-0f836c314aba", "static-imports-fbdcbe47c167", - "static-imports-67a3a6ca9069", - "static-imports-1fcaaf2a281e", + "static-imports-1efe7f42a374", + "static-imports-a43d0369f3e6", "static-imports-c6dd97cd134c", "static-imports-ad7ae2c5c0b5", "static-imports-c794d135c34f", @@ -8597,11 +8597,11 @@ "static-imports-a31378055869", "static-imports-a2682243828b", "static-imports-819e3ce626d3", - "static-imports-735fdeb87797", - "static-imports-30e2933cfbeb", - "static-imports-a38ea1f6aa90", - "static-imports-9ccfb0f3bdcf", - "static-imports-3d3109273aad", + "static-imports-bacd2acfbd2e", + "static-imports-726d1e8f3927", + "static-imports-02ef4754d36f", + "static-imports-b2a8f9f1b012", + "static-imports-78872b465d8c", "static-imports-3d4c7a13ce4e", "static-imports-14722eceaa11", "static-imports-84f40c9ef00a", @@ -9050,11 +9050,11 @@ "static-imports-a31378055869", "static-imports-a2682243828b", "static-imports-819e3ce626d3", - "static-imports-735fdeb87797", - "static-imports-30e2933cfbeb", - "static-imports-a38ea1f6aa90", - "static-imports-9ccfb0f3bdcf", - "static-imports-3d3109273aad" + "static-imports-bacd2acfbd2e", + "static-imports-726d1e8f3927", + "static-imports-02ef4754d36f", + "static-imports-b2a8f9f1b012", + "static-imports-78872b465d8c" ], "groups": [ { @@ -9356,7 +9356,7 @@ "static-imports-a954b58f9edc", "static-imports-17df33c96f97", "static-imports-9bc131d4e099", - "static-imports-3d3109273aad" + "static-imports-78872b465d8c" ], "groups": [ { diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index 5a3a036c54..10efcea235 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `c247197e8260700a32bff47c7fa74100c38b7377` · package 0.3.2 +Source revision: `b3bad38b5effeee6848d9733703aefbbd114d6e8` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/scripts/run_task.py#L2015-L2015) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/gym_utils.py#L1954-L1954) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L1149-L1149) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/motion_generator.py#L310-L310) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/sim_manager.py#L566-L566) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/scene/expansion/__init__.py#L28-L30) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/rigid_object.py#L430-L430) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L864-L864) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L39-L39) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/catalog.py#L612-L612) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/c247197e8260700a32bff47c7fa74100c38b7377/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From 66fe833f5f8f70956945f721a80a8af9c2c8c681 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 13:54:01 +0000 Subject: [PATCH 07/12] docs(architecture): refresh after syncing the incoming RL tasks --- docs/architecture/generated/architecture.json | 46 ++-- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 147 insertions(+), 147 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index d23562aa9f..3fb08a4197 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "b3bad38b5effeee6848d9733703aefbbd114d6e8", + "revision": "a79dd9bc3fa1d938b50eaf2d3198326cffac480e", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", @@ -5812,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4638, - "end_line": 4639, + "start_line": 4663, + "end_line": 4664, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4678, - "end_line": 4681, + "start_line": 4703, + "end_line": 4706, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5837,8 +5837,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.start_visualization", - "start_line": 1245, - "end_line": 1250, + "start_line": 1246, + "end_line": 1251, "excerpt": " runtime = VisualizationRuntime(\n SceneExporter(self, visualization_cfg),\n visualization_cfg,\n )\n self._visualization_runtime = runtime\n runtime.start()" } ] @@ -5855,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4639, - "end_line": 4644, + "start_line": 4664, + "end_line": 4669, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5873,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4834, - "end_line": 4834, + "start_line": 4859, + "end_line": 4859, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5891,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4300, - "end_line": 4300, + "start_line": 4325, + "end_line": 4325, "excerpt": " constraint = RigidConstraint(" } ] @@ -5909,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4441, - "end_line": 4441, + "start_line": 4466, + "end_line": 4466, "excerpt": " group = RigidObjectGroup(" } ] @@ -5927,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3721, - "end_line": 3721, + "start_line": 3746, + "end_line": 3746, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5945,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4542, - "end_line": 4542, + "start_line": 4567, + "end_line": 4567, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5963,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 4100, - "end_line": 4100, + "start_line": 4125, + "end_line": 4125, "excerpt": " self._deformable_objects[uid] = deformable" } ] @@ -5981,8 +5981,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_light", - "start_line": 3227, - "end_line": 3227, + "start_line": 3252, + "end_line": 3252, "excerpt": " self._lights[uid] = batch_lights" } ] diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index 10efcea235..03e05fbe0a 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `b3bad38b5effeee6848d9733703aefbbd114d6e8` · package 0.3.2 +Source revision: `a79dd9bc3fa1d938b50eaf2d3198326cffac480e` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/b3bad38b5effeee6848d9733703aefbbd114d6e8/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From 5c2ebdbafb7a6617e3accda182fbacd7680a9320 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 15:40:59 +0000 Subject: [PATCH 08/12] fix(packaging): address extension migration review feedback --- .../topics/data-assets/data-assets.md | 2 +- examples/learning/act/_environment.py | 9 ++-- .../learning/nerd/_support/_acceptance.py | 46 +++++++++++++------ .../_support/_official_evaluation_data.py | 16 ++++--- setup.py | 23 +++++++++- tests/test_benchmark_package.py | 7 ++- 6 files changed, 75 insertions(+), 28 deletions(-) diff --git a/agent_context/topics/data-assets/data-assets.md b/agent_context/topics/data-assets/data-assets.md index 7693ad10b3..cca069a5d6 100644 --- a/agent_context/topics/data-assets/data-assets.md +++ b/agent_context/topics/data-assets/data-assets.md @@ -209,7 +209,7 @@ The CLI records repository provenance and writes reports outside the model cache. Robot references still use `get_data_path()` and its existing asset cache. Task packages must already be installed; downloading weights does not register new environment implementations. The index's `task_package` accepts a qualified -module name. Published official policy indexes declaring `embodichain.extensions.tasks` +module name. Published official policy indexes declaring `embodichain_tasks` resolve their requirement to `embodichain.extensions.tasks`. Test the Hub boundary with fake downloads and validate a real selected-model download separately. diff --git a/examples/learning/act/_environment.py b/examples/learning/act/_environment.py index 983687e548..56e5e0918f 100644 --- a/examples/learning/act/_environment.py +++ b/examples/learning/act/_environment.py @@ -30,13 +30,14 @@ ).resolve() CONFIG_ROOT = TASK.parents[3] TASK_PACKAGE = CONFIG_ROOT.parent +# These keys identify task content in saved ACT datasets and checkpoints. IDENTITY_FILES = { - "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml": TASK, - "embodichain/extensions/tasks/configs/tasks/manipulation/push_cube/env.visual.yaml": TASK.parent + "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/task.franka.visual.yaml": TASK, + "extensions/embodichain_tasks/configs/tasks/manipulation/push_cube/env.visual.yaml": TASK.parent / "env.visual.yaml", - "embodichain/extensions/tasks/configs/components/embodiments/franka_panda_rgb_224.yaml": CONFIG_ROOT + "extensions/embodichain_tasks/configs/components/embodiments/franka_panda_rgb_224.yaml": CONFIG_ROOT / "components/embodiments/franka_panda_rgb_224.yaml", - "embodichain/extensions/tasks/manipulation/push_cube.py": TASK_PACKAGE + "extensions/embodichain_tasks/embodichain_tasks/manipulation/push_cube.py": TASK_PACKAGE / "manipulation/push_cube.py", } diff --git a/examples/learning/nerd/_support/_acceptance.py b/examples/learning/nerd/_support/_acceptance.py index e90ae36f19..f00ab0abb2 100644 --- a/examples/learning/nerd/_support/_acceptance.py +++ b/examples/learning/nerd/_support/_acceptance.py @@ -40,6 +40,18 @@ import time from typing import Any +_PREVIOUS_MODELS_ROOT = Path("extensions/embodichain_models") +_EXTENSION_LAYOUTS = ( + ( + Path("embodichain/extensions/models/dynamics/nerd"), + "embodichain.extensions.models.dynamics.nerd", + ), + ( + _PREVIOUS_MODELS_ROOT / "embodichain_models/dynamics/nerd", + "embodichain_models.dynamics.nerd", + ), +) + def _write(path: Path, value: Any) -> None: path.parent.mkdir(parents=True, exist_ok=True) @@ -54,13 +66,22 @@ def _sha(path: Path) -> str: return digest.hexdigest() +def _extension_layout(source: Path) -> tuple[Path, str] | None: + for directory, package in _EXTENSION_LAYOUTS: + if (source / directory / "model.py").is_file(): + return directory, package + return None + + def _source_modules(source: Path) -> dict[str, str]: """Select only the requested checkout's original or extension module layout.""" - if (source / "embodichain/extensions/models/dynamics/nerd/model.py").is_file(): + layout = _extension_layout(source) + if layout is not None: + _, package = layout return { - "codec": "embodichain.extensions.models.dynamics.nerd.codec", - "data": "embodichain.extensions.models.dynamics.nerd.data", - "model": "embodichain.extensions.models.dynamics.nerd", + "codec": f"{package}.codec", + "data": f"{package}.data", + "model": package, "trainer": "examples.learning.nerd._support._trainer", "qualification": "examples.learning.nerd._support._qualification", } @@ -76,11 +97,9 @@ def _source_modules(source: Path) -> dict[str, str]: def _source_paths(source: Path) -> list[str]: """Keep each independent worker's imports bound to its requested source.""" paths = [str(source)] - if ( - _source_modules(source)["model"] - == "embodichain.extensions.models.dynamics.nerd" - ): - paths.insert(0, str(source / "embodichain/extensions/models")) + layout = _extension_layout(source) + if layout is not None and layout[0].is_relative_to(_PREVIOUS_MODELS_ROOT): + paths.insert(0, str(source / _PREVIOUS_MODELS_ROOT)) return paths @@ -88,14 +107,13 @@ def _source_identity(source: Path) -> dict[str, Any]: def git(*args: str) -> bytes: return subprocess.check_output(["git", "-C", str(source), *args]) - if ( - _source_modules(source)["model"] - == "embodichain.extensions.models.dynamics.nerd" - ): + layout = _extension_layout(source) + if layout is not None: + directory, _ = layout modules = ( "examples/learning/nerd/_support/_trainer.py", *( - "embodichain/extensions/models/dynamics/nerd/" + name + (directory / name).as_posix() for name in ( "model.py", "checkpoint.py", diff --git a/examples/learning/nerd/_support/_official_evaluation_data.py b/examples/learning/nerd/_support/_official_evaluation_data.py index a951a0d22b..4cb15714a7 100644 --- a/examples/learning/nerd/_support/_official_evaluation_data.py +++ b/examples/learning/nerd/_support/_official_evaluation_data.py @@ -52,9 +52,7 @@ def _default_transport_root() -> Path: """Find installed or source codec files without importing the model SDK.""" relative = Path("embodichain/extensions/models/dynamics/nerd") candidates = [ - Path(__file__).resolve().parents[4] - / "embodichain/extensions/models" - / relative, + Path(__file__).resolve().parents[4] / relative, *(Path(entry) / relative for entry in sys.path), ] for candidate in candidates: @@ -96,10 +94,14 @@ def _transport(directory: Path) -> tuple[Any, Any]: if name == "reference": # Bind the moved task-math import to the isolated codec rather than # importing the SDK into a historical reference interpreter. - source = path.read_text().replace( - "from embodichain.extensions.models.dynamics.nerd.codec import", - "from .codec import", - ) + source = path.read_text() + for package in ( + "embodichain.extensions.models.dynamics.nerd", + "embodichain_models.dynamics.nerd", + ): + source = source.replace( + f"from {package}.codec import", "from .codec import" + ) exec(compile(source, str(path), "exec"), module.__dict__) else: spec.loader.exec_module(module) diff --git a/setup.py b/setup.py index 47138f5633..f5292f19de 100644 --- a/setup.py +++ b/setup.py @@ -23,6 +23,7 @@ from pathlib import Path from setuptools import Command, find_namespace_packages, setup +from setuptools.command.build_py import build_py __all__ = [ "get_example_data_files", @@ -39,6 +40,26 @@ EXAMPLES_DIR = THIS_DIR / "examples" +class BuildPy(build_py): + """Remove retired extension packages from reused build staging.""" + + def run(self) -> None: + for extension in ( + "benchmarks", + "models", + "robots", + "sensors", + "solvers", + "tasks", + ): + stale_package = Path(self.build_lib) / f"embodichain_{extension}" + if stale_package.is_symlink(): + stale_package.unlink(missing_ok=True) + elif stale_package.is_dir(): + shutil.rmtree(stale_package) + super().run() + + class CleanCommand(Command): description = "Delete build, dist, *.egg-info and all __pycache__ directories." user_options = [] @@ -179,7 +200,7 @@ def main() -> None: packages=get_packages(), package_data=get_package_data(), data_files=get_example_data_files(), - cmdclass={"clean": CleanCommand}, + cmdclass={"build_py": BuildPy, "clean": CleanCommand}, include_package_data=False, ) diff --git a/tests/test_benchmark_package.py b/tests/test_benchmark_package.py index 4ea5a57327..ebe23f27db 100644 --- a/tests/test_benchmark_package.py +++ b/tests/test_benchmark_package.py @@ -51,6 +51,10 @@ def installed_benchmark(tmp_path_factory: pytest.TempPathFactory) -> tuple[Path, ignore = shutil.ignore_patterns("__pycache__", "*.pyc", "*.egg-info") for name in ("embodichain", "examples"): shutil.copytree(root / name, source / name, ignore=ignore) + # Reuse staging from the retired top-level layout. + stale = source / "build" / "lib" / "embodichain_tasks" + stale.mkdir(parents=True) + (stale / "__init__.py").touch() built = subprocess.run( [ sys.executable, @@ -334,7 +338,8 @@ def test_installed_solver_entry_point_and_core_dependency_boundary( class ConcreteImportsForbidden(importlib.abc.MetaPathFinder): def find_spec(self, fullname, path=None, target=None): - if fullname.split('.')[0] in {'embodichain.extensions.models', 'embodichain.extensions.solvers'}: + packages = ('embodichain.extensions.models', 'embodichain.extensions.solvers') + if any(fullname == package or fullname.startswith(package + '.') for package in packages): raise AssertionError('Core imported a concrete implementation: ' + fullname) blocker = ConcreteImportsForbidden() From c38aa69d1bdab5d0e7949baf889134248af7570e Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 15:55:14 +0000 Subject: [PATCH 09/12] docs(architecture): refresh after syncing the task catalog --- docs/architecture/generated/architecture.json | 2 +- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 125 insertions(+), 125 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index 3fb08a4197..e93ee7ad95 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "a79dd9bc3fa1d938b50eaf2d3198326cffac480e", + "revision": "318da3e17a674401c372984973cc974efeddb361", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index 03e05fbe0a..dcfc61ccb5 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `a79dd9bc3fa1d938b50eaf2d3198326cffac480e` · package 0.3.2 +Source revision: `318da3e17a674401c372984973cc974efeddb361` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/a79dd9bc3fa1d938b50eaf2d3198326cffac480e/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From cb7b27cfa42d0e634d0cd580607514f19eaf5ec9 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Thu, 19 Nov 2026 16:03:33 +0000 Subject: [PATCH 10/12] docs(architecture): refresh after syncing cable routing --- docs/architecture/generated/architecture.json | 66 ++--- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 157 insertions(+), 157 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index e93ee7ad95..a2a9c4df4c 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,7 +3,7 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "318da3e17a674401c372984973cc974efeddb361", + "revision": "dabd052127eafabe4b724b258f6550a0b4c97235", "source_ref": "HEAD", "package_version": "0.3.2", "topic_index": "agent_context/MAP.yaml", @@ -1591,8 +1591,8 @@ { "path": "embodichain/lab/task_program/integrations/catalog.py", "symbol": "TaskProgramIntegrationCatalog", - "start_line": 618, - "end_line": 618, + "start_line": 635, + "end_line": 635, "excerpt": "class TaskProgramIntegrationCatalog:" } ], @@ -2947,8 +2947,8 @@ { "path": "embodichain/lab/task_program/compiler/lowering.py", "symbol": "SemanticCallCompiler", - "start_line": 1046, - "end_line": 1046, + "start_line": 1066, + "end_line": 1066, "excerpt": "class SemanticCallCompiler:" } ], @@ -4087,8 +4087,8 @@ { "path": "embodichain/lab/gym/envs/task_program/bridge.py", "symbol": "TaskProgramDemoBridge._segment_actions", - "start_line": 2023, - "end_line": 2023, + "start_line": 2036, + "end_line": 2036, "excerpt": " self._sink.pop()," } ] @@ -4787,8 +4787,8 @@ { "path": "embodichain/lab/task_program/runtime/executor.py", "symbol": "SemanticCallExecutor._prepare_grounded_call", - "start_line": 1240, - "end_line": 1246, + "start_line": 1276, + "end_line": 1282, "excerpt": " session = self._engine.start(\n (invocation,),\n context,\n eligible_mask=active_mask,\n plan_transform=plan_transform,\n nominal_source=nominal_source,\n )" } ] @@ -4805,8 +4805,8 @@ { "path": "embodichain/lab/task_program/runtime/executor.py", "symbol": "SemanticCallExecutor._prepare_grounded_call", - "start_line": 1248, - "end_line": 1254, + "start_line": 1284, + "end_line": 1290, "excerpt": " runner = ExecutionRunner(\n session,\n primed,\n self._command_sink,\n clock=self._clock,\n cfg=runner_cfg,\n )" } ] @@ -4866,8 +4866,8 @@ { "path": "embodichain/lab/task_program/integrations/simulation/environment.py", "symbol": "SimulationTaskProgramFactory.create_atomic_skill_engine", - "start_line": 1164, - "end_line": 1165, + "start_line": 1198, + "end_line": 1199, "excerpt": " engine = AtomicSkillEngine(\n motion_generator," } ] @@ -4884,8 +4884,8 @@ { "path": "embodichain/lab/task_program/integrations/simulation/environment.py", "symbol": "SimulationTaskProgramFactory._create_motion_generator", - "start_line": 1358, - "end_line": 1359, + "start_line": 1399, + "end_line": 1400, "excerpt": " generator = MotionGenerator(\n MotionGenCfg(planner_cfg=planner_cfg), **selection_kwargs" } ] @@ -5812,15 +5812,15 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4663, - "end_line": 4664, + "start_line": 4675, + "end_line": 4676, "excerpt": " robot = self._declare_spawn_articulation(cfg, Robot)\n self._robots[uid] = robot" }, { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_spawn_articulation", - "start_line": 4703, - "end_line": 4706, + "start_line": 4715, + "end_line": 4718, "excerpt": " facade = facade_type(\n cfg=cfg,\n device=self.device,\n )" } ] @@ -5855,8 +5855,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_robot", - "start_line": 4664, - "end_line": 4669, + "start_line": 4676, + "end_line": 4681, "excerpt": " self._robots[uid] = robot\n if was_materialized:\n self.prepare()\n for sensor_cfg in mounted_sensors:\n self.add_sensor(sensor_cfg)\n return robot" } ] @@ -5873,8 +5873,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.enable_gizmo", - "start_line": 4859, - "end_line": 4859, + "start_line": 4871, + "end_line": 4871, "excerpt": " gizmo = Gizmo(target, gizmo_cfg, control_part)" } ] @@ -5891,8 +5891,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.create_rigid_constraint", - "start_line": 4325, - "end_line": 4325, + "start_line": 4337, + "end_line": 4337, "excerpt": " constraint = RigidConstraint(" } ] @@ -5909,8 +5909,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_rigid_object_group", - "start_line": 4466, - "end_line": 4466, + "start_line": 4478, + "end_line": 4478, "excerpt": " group = RigidObjectGroup(" } ] @@ -5927,8 +5927,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager._declare_rigid_objects", - "start_line": 3746, - "end_line": 3746, + "start_line": 3754, + "end_line": 3754, "excerpt": " rigid_obj = RigidObject(cfg=cfg, device=self.device)" } ] @@ -5945,8 +5945,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_articulation", - "start_line": 4567, - "end_line": 4567, + "start_line": 4579, + "end_line": 4579, "excerpt": " self._articulations[uid] = articulation" } ] @@ -5963,8 +5963,8 @@ { "path": "embodichain/lab/sim/sim_manager.py", "symbol": "SimulationManager.add_deformable_object", - "start_line": 4125, - "end_line": 4125, + "start_line": 4137, + "end_line": 4137, "excerpt": " self._deformable_objects[uid] = deformable" } ] diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index dcfc61ccb5..b37d75f0d4 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `318da3e17a674401c372984973cc974efeddb361` · package 0.3.2 +Source revision: `dabd052127eafabe4b724b258f6550a0b4c97235` · package 0.3.2 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/lowering.py#L1046-L1046) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/lowering.py#L1066-L1066) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/catalog.py#L618-L618) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/318da3e17a674401c372984973cc974efeddb361/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/catalog.py#L635-L635) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From 2e80a1eb443d5e37fb344148427056f48ad6f8e9 Mon Sep 17 00:00:00 2001 From: yuecideng Date: Fri, 20 Nov 2026 05:19:52 +0000 Subject: [PATCH 11/12] docs(architecture): refresh after syncing v0.3.3 --- docs/architecture/generated/architecture.json | 4 +- docs/architecture/generated/summary.md | 248 +++++++++--------- 2 files changed, 126 insertions(+), 126 deletions(-) diff --git a/docs/architecture/generated/architecture.json b/docs/architecture/generated/architecture.json index a2a9c4df4c..b46b4c73bd 100644 --- a/docs/architecture/generated/architecture.json +++ b/docs/architecture/generated/architecture.json @@ -3,9 +3,9 @@ "kind": "static-architecture", "coverage": "curated-sample", "repository": "DexForce/EmbodiChain", - "revision": "dabd052127eafabe4b724b258f6550a0b4c97235", + "revision": "bca6e91c0f7187cf037eb20c331b3a2764258737", "source_ref": "HEAD", - "package_version": "0.3.2", + "package_version": "0.3.3", "topic_index": "agent_context/MAP.yaml", "limitations": [ "A curated source snapshot, not a complete import graph, runtime trace, or execution order.", diff --git a/docs/architecture/generated/summary.md b/docs/architecture/generated/summary.md index b37d75f0d4..2d32d7b44f 100644 --- a/docs/architecture/generated/summary.md +++ b/docs/architecture/generated/summary.md @@ -1,139 +1,139 @@ # Architecture overview -Source revision: `dabd052127eafabe4b724b258f6550a0b4c97235` · package 0.3.2 +Source revision: `bca6e91c0f7187cf037eb20c331b3a2764258737` · package 0.3.3 Curated static relationships; not a complete dependency graph or runtime trace. | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/cli.md) | -| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/run_task.md) | -| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/task/index.rst) | -| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/task/index.rst) | -| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/configuration.md) | -| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/guides/configuration.md) | -| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/env.md) | -| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/env.md) | -| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/index.rst) | -| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.utils.rst) | -| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | -| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/lowering.py#L1066-L1066) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | -| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) | -| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/benchmarks.rst) | -| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | -| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/planners/index.rst) | -| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/motion/solvers/index.rst) | -| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/workspace_analyzer/runtime.md) | -| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | -| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_manager.md) | -| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | -| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_articulation.md) | -| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sensors/index.rst) | -| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_manager/physics/index.md) | -| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/visualization/viser.md) | -| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.rst) | -| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | -| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | -| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/gym/dataset_functors.md) | -| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | -| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/online_data.md) | -| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | -| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/asset_generalization.rst) | -| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/asset_engine.md) | -| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/asset_engine.md) | -| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/scene_engine.md) | -| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/train_script.md) | -| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/algorithm.md) | -| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | -| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/models.md) | -| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | -| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/index.rst) | -| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/rl/buffer.md) | -| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | -| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | -| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | -| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.rst) | -| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/convex_decomposition.md) | -| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | -| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/nerd.md) | -| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | -| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/nerd.md) | -| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/neural_dynamics/rwm.md) | -| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/public_api.rst) | -| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | +| CLI | Dispatches commands and lazily loads task discovery, environment, and training entry points. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/cli/main.py#L17-L17) · [CLI reference](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/guides/cli.md) | +| Environment launcher | Runs task discovery, configuration loading, and Gym environment creation. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/scripts/run_task.py#L2059-L2059) · [Environment launch guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/guides/run_task.md) | +| Task discovery | Imports installed task packages through entry points to populate the environment registry. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/utils/registration.py#L389-L389) · [Task discovery and supported tasks](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/resources/task/index.rst) | +| Official tasks | Registers official task entry points and organises reusable robot tasks. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/extensions/tasks/__init__.py#L17-L23) · [Supported tasks](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/resources/task/index.rst) | +| Config loader | Loads deployment files, resolves components, and assembles the typed environment configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/utils/gym_utils.py#L1978-L1978) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/guides/configuration.md) | +| Component composition | Resolves environment and embodiment components into runnable Gym configurations. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/utils/_component_composition.py#L17-L17) · [Configuration guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/guides/configuration.md) | +| EmbodiedEnv | Assembles scenes, managers, and demonstrations with optional Task Program integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/embodied_env.py#L518-L518) · [EmbodiedEnv documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/env.md) | +| BaseEnv | Owns the Gym loop, simulation initialisation, and environment step lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/base_env.py#L118-L118) · [BaseEnv documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/env.md) | +| Managers | Organises observations, actions, rewards, events, and data recording within the environment lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/__init__.py#L17-L20) · [Gym managers and environment lifecycle](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/index.rst) | +| Configuration utilities | Defines typed configuration copying, serialization, and required-field validation. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/utils/configclass.py#L15-L15) · [Configuration utilities documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.utils.rst) | +| Domain randomization | Event functors randomize physical, visual, spatial, and geometric properties. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/randomization/__init__.py#L17-L20) · [Domain randomization documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| DifferentiableEnv | Preserves the Gym lifecycle while bridging task-defined kinematics to autograd. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/differentiable_env.py#L48-L48) · [DifferentiableEnv documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| EventManager | Dispatches configured event functors with lifecycle scheduling and scoped seeds. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/event_manager.py#L97-L97) · [EventManager documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.managers.rst) | +| TaskProgramCompiler | Compiles task configuration into an analysable program using a static scene manifest. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/compiler/program.py#L1615-L1615) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [TaskProgramCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallCompiler | Analyses and lowers Semantic Calls against the bound scene and skill integration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/compiler/lowering.py#L1066-L1066) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [SemanticCallCompiler documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| SemanticCallExecutor | Lowers and executes semantic calls, creating an execution session for each call. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/runtime/executor.py#L258-L258) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [SemanticCallExecutor documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| TaskProgramEnvironmentAdapter | Validates integration choices and assembles the semantic runtime and Gym bridge. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/integrations/environment.py#L315-L315) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [TaskProgramEnvironmentAdapter documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| TaskProgramDemoBridge | Converts program segments into lazy Gym demonstrations with a shared runtime, buffer, and clock. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/task_program/bridge.py#L1177-L1177) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [TaskProgramDemoBridge documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Scene expansion attempts | Prepares selected scene candidates and executes a shared Task Program with per-row measured acceptance. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/integrations/scene_expansion.py#L241-L241) · [Task Program scene preparation and measured acceptance](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.scene_expansion.rst) | +| MLLM frontend | Decodes untrusted model JSON and compiles it through the existing Task Program adapter. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/agents/mllm/task_program.py#L17-L17) · [MLLM frontend documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) | +| AtomicSkillEngine | Manages planning resources and atomic skills to create executable action sessions. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/atomic_skills/engine.py#L85-L85) · [Atomic Skills guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/atomic_skills/index.md) · [AtomicSkillEngine documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Motion benchmarks | Evaluates motion planners and Atomic Skills using installed suites and external adapters. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/extensions/benchmarks/motion_generation/__init__.py#L17-L21) · [Benchmark API and external adapters](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/benchmarks.rst) | +| MotionGenerator | Composes planning backends behind a unified robot motion generation interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/motion/motion_generator.py#L334-L334) · [Motion generation guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/motion/motion_generator.md) · [MotionGenerator documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.motion_generator.rst) | +| Planners | Provides motion planning backends that generate constrained robot trajectories. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/motion/planners/__init__.py#L17-L22) · [Motion planner guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/motion/planners/index.rst) | +| Solvers | Provides inverse kinematics backends and stateful robot solving capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/motion/solvers/__init__.py#L17-L20) · [Kinematic solver guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/motion/solvers/index.rst) | +| Robot workspace | Loads reachability caches and samples robot joint configurations and poses. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/motion/workspace/runtime.py#L53-L53) · [Robot workspace documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/workspace_analyzer/runtime.md) | +| Expansion session | Owns bounded candidate lifecycles, collection budgets and final commit receipts. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/expansion/session.py#L121-L121) · [Trajectory augmentation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.motion.expansion.rst) | +| SimulationManager | Manages the world, robots, sensors, physics, and visualisation lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/sim_manager.py#L580-L580) · [SimulationManager documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/sim_manager.md) | +| Scene expansion contracts | Defines immutable arena-local scene proposals and bounded authored candidate sources. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/scene/expansion/__init__.py#L28-L31) · [Scene expansion contracts and fixed candidates](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.expansion.rst) | +| Robot | Represents a simulated robot with control parts, joint state, and kinematics. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/robot.py#L17-L17) · [Robots and articulations](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/sim_articulation.md) | +| Sensors | Provides camera, stereo, and contact observations for the environment. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/sensors/__init__.py#L17-L20) · [Sensor guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/sensors/index.rst) | +| Physics backends | Constructs the configured physics backend and connects simulation state to physics solving. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/physics/__init__.py#L16-L21) · [Physics backend guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/sim_manager/physics/index.md) | +| Browser visualization | Publishes simulation snapshots and interactive controls through a browser runtime. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/visualization/runtime.py#L17-L17) · [Browser visualization guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/visualization/viser.md) | +| Rigid objects | Represents rigid scene objects and their physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/rigid_object.py#L434-L434) · [Rigid objects documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid object groups | Groups multiple rigid bodies into a batched scene entity. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/rigid_object_group.py#L187-L187) · [Rigid object group guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/sim_rigid_object_group.md) · [Object API reference](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Articulations | Represents jointed scene entities and articulated state. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/articulation.py#L739-L739) · [Articulations documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Deformable objects | Represents Newton-backed deformable particle-set entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/deformable/base.py#L49-L49) · [Deformable objects documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Lights | Controls light color, intensity, falloff, and pose through a batched facade. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/light.py#L40-L40) · [Lights documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Rigid constraints | Wraps per-arena fixed constraints between two rigid objects. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/constraint.py#L36-L36) · [Rigid constraints documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Gizmo | Provides native robot IK and browser manipulation controls for simulation targets. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/gizmo.py#L458-L458) · [Gizmo documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Compute | Shared numerical algorithms for kinematics, trajectories, geometry, and images. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/compute/__init__.py#L17-L21) · [Compute API reference](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Trajectory computation | Shared interpolation, resampling, timing, and trajectory warping algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/compute/trajectory/__init__.py#L17-L20) · [Trajectory computation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| Kinematics computation | Shared numerical kinematics and manipulability algorithms. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/compute/kinematics/__init__.py#L17-L24) · [Kinematics computation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.compute.rst) | +| DatasetManager | Coordinates dataset functors for frame collection, saving, and finalization. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/dataset_manager.py#L46-L46) · [DatasetManager documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/dataset_functors.md) | +| LeRobot recording | Persists demonstrations and metadata in LeRobot datasets with optional depth sidecars. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/datasets.py#L167-L167) · [LeRobot recording documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/dataset_functors.md) | +| Async recording | Moves durable dataset writes to one background worker. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/managers/async_datasets.py#L58-L58) · [Async recording documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/gym/dataset_functors.md) | +| Depth sidecar writer | Coordinates depth-video files and metadata alongside recorded demonstrations. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/depth_video/writer.py#L226-L226) · [Depth video documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth sidecar reader | Loads depth metadata and decodes episode/sensor depth video frames. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/depth_video/reader.py#L17-L23) · [Depth sidecar reader documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| Depth quantization | Converts depth values to and from the sidecar video representation. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/depth_video/depth_utils.py#L24-L35) · [Depth quantization documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.data_pipeline.depth_video.rst) | +| OnlineDataEngine | Online data engine managing workers and their lifecycle. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/engine/data.py#L17-L17) · [Online data streaming guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/online_data.md) | +| OnlineDataset | Exposes live engine samples as an infinite PyTorch IterableDataset. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/datasets/online_data.py#L39-L39) · [OnlineDataset documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Chunk samplers | Selects fixed-shape time windows using configurable chunk-length distributions. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data_pipeline/datasets/sampler.py#L17-L17) · [Chunk samplers documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.data_pipeline.datasets.rst) | +| Data assets | Resolves asset paths and coordinates registered dataset downloads and caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/data/dataset.py#L17-L17) · [Data assets documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/resources/assets.md) · [Asset catalog and task role contracts](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/asset_generalization.rst) | +| Scene generation | Generates scene state from input images for scene asset workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/generate.py#L17-L17) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene understanding | Interprets an image, segments objects, and initializes a validated support graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/generation/scene_understanding.py#L260-L260) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Asset generation & refinement | Generates geometry and articulated assets, then refines scene placement. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/generation/scene_generation.py#L96-L96) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene asset preparation | Prepares generated Scene Engine geometry for layout and export. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/utils/simready_processor.py#L90-L90) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene editing | Edits an existing portable scene using a typed edit plan. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/edit.py#L17-L17) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene edit layout | Reconstructs scene placement against an edited goal graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/editing/scene_edit_layout_generation.py#L32-L32) · [Scene editing documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene import | Reconstructs an editable scene and graph from a portable scene export. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/utils/scene_importer.py#L50-L50) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Scene export | Writes portable scene metadata and assets for downstream simulation preparation. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/scene_engine/pipeline/utils/scene_exporter.py#L53-L53) · [Scene export documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Asset Engine | Prepares an existing mesh through source conversion, semantic/physics inference, and mesh/USD export. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/asset_engine/pipeline/ingest.py#L172-L178) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/asset_engine.md) | +| Asset parser stages | Dispatches inspector, geometry, physics, USD, and internal asset parsers. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/asset_engine/parser/base.py#L58-L64) · [Asset Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/asset_engine.md) | +| GenSim UI sessions | Tracks one replaceable subprocess per Gradio session. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/gradio_ui/app_processes.py#L109-L109) · [Scene Engine guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/scene_engine.md) | +| Training assembly | Builds environments, policies, algorithms, and the compatible trainer from configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/train.py#L17-L17) · [Training assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/rl/train_script.md) | +| RL algorithms | Registers PPO, GRPO, and APG with their rollout contracts. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/algo/__init__.py#L17-L17) · [RL algorithms documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/rl/algorithm.md) | +| PPO | Optimizes an actor-critic policy from standard TensorDict rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/algo/ppo.py#L53-L53) · [PPO documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| GRPO | Optimizes policies with group-relative advantages from standard rollouts. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/algo/grpo.py#L48-L48) · [GRPO documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| APG | Optimizes policy parameters through differentiable rollout rewards. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/algo/apg.py#L119-L119) · [APG documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.algo.rst) | +| Policy models | Defines policy action inference and model interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/policies/policy.py#L35-L35) · [Policy models documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/rl/models.md) | +| ActorCritic | Provides Gaussian actions and value estimates with separate actor and critic inputs. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/policies/actor_critic.py#L36-L36) · [ActorCritic documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| ActorOnly | Provides Gaussian actions without a learned value network. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/policies/actor_only.py#L31-L31) · [ActorOnly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.policies.rst) | +| Learning environments | Defines lightweight vector-environment protocols and factory registration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/env.py#L17-L17) · [Learning environments documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Standard trainer | Coordinates standard rollout collection, algorithm updates, evaluation, and checkpoints. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/utils/trainer.py#L17-L17) · [Reinforcement learning overview](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/rl/index.rst) | +| SyncCollector | Collects standard vector-environment rollouts into the training buffer. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/collector/sync_collector.py#L33-L33) · [SyncCollector documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Rollout buffer | Stores standard rollout transitions and bootstrap state in TensorDict buffers. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/buffer/standard_buffer.py#L29-L29) · [Rollout buffer documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/rl/buffer.md) | +| DifferentiableTrainer | Coordinates graph-connected rollouts and analytic policy-gradient updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/differentiable_trainer.py#L77-L77) · [DifferentiableTrainer documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Differentiable collector | Collects differentiable trajectories while preserving their autograd graph. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/collector/differentiable.py#L145-L145) · [Differentiable collector documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.collector.rst) | +| Running observation normalization | Normalizes continuous observation fields with explicit running-statistic updates. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/normalization.py#L29-L29) · [Running observation normalization documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.rst) | +| Policy evaluation | Runs trained policy evaluation in headless or viewer workflows. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/rl/policy_evaluation/cli.py#L17-L17) · [Policy evaluation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.rl.policy_evaluation.rst) | +| Devices | Defines start, stop, and controller-state interfaces for robot input devices. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/devices/device.py#L17-L17) · [Laboratory and device API reference](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| Device controller | Maps input-device state to robot joint commands with joint-limit handling. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/devices/device_controller.py#L29-L29) · [Device controller documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.rst) | +| GraspKit | Defines parallel-jaw gripper models and grasp-pose generation interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/graspkit/pose_generator.py#L17-L17) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| URDF assembly | Assembles URDF components, connections, sensors, and mesh resources. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/urdf_assembly_manager.py#L81-L81) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| Convex decomposition | Prepares convex collision meshes for URDF assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/acd/cli.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/convex_decomposition.md) | +| Shared scene services | Composes explicit configurations, proposes layouts, and operates on caller-owned physical state. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/scene/__init__.py#L17-L22) · [Scene services architecture and capabilities](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/scene/index.md) · [Scene construction and preparation workflows](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/scene/workflows.md) · [Production scene service integrations](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/scene/integrations.md) · [Scene composition, layout, state and validation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.scene.rst) · [Shared numerical geometry and layout](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.compute.scene_geometry.rst) | +| NeRD model extension | Bundles the causal NeRD network, physical codec, trajectory windows and supervised recipe in the main wheel. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/extensions/models/dynamics/nerd/model.py#L201-L201) · [Official model library](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/model_catalogs.rst) · [NeRD data and training workflow](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/neural_dynamics/nerd.md) | +| Supervised learning (SL) | Shares structured batches, objective-owned losses, optimizer updates and offline recovery across policy and dynamics fitting. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/learning/sl/learner.py#L52-L52) · [SL batches, updates and recovery](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.learning.sl.rst) | +| NeRD showcase | Prepares pinned external resources and routes default NeRD training through shared SL. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/examples/learning/nerd/__main__.py#L81-L81) · [NeRD showcase commands](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/neural_dynamics/nerd.md) | +| Robot world model (RWM) | Owns action-conditioned robot-state prediction, differentiable rollout objectives and bounded transition replay. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/extensions/models/dynamics/rwm/model.py#L77-L77) · [RWM state, objectives, prediction, replay and SL recipe](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/rwm.rst) · [RWM principles and usage](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/neural_dynamics/rwm.md) | +| TaskSpec | Defines simulator-independent task requirements, milestones, semantic identity and evidence evaluation. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/task_spec/spec.py#L335-L335) · [TaskSpec protocol API](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/public_api.rst) | +| Task Engine | Interprets instructions and image evidence into candidates, TaskSpec requirements and canonical Semantic Call graphs. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/gen_sim/task_engine/agent.py#L72-L72) · [Task Engine workflow and artifact guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/generative_sim/task_engine.md) · [Task Engine semantic contracts](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.gen_sim.task_engine.rst) | ### Additional modules in specialist views | Module | Responsibility | Evidence and documentation | | --- | --- | --- | -| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | -| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/convex_decomposition.md) | -| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | -| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | -| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | -| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/grasp_generator.rst) | -| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/catalog.py#L635-L635) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | -| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | -| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/scene_registry.md) | -| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | -| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/robot_profiles.md) | -| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | -| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | -| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/precision_assembly.md) | -| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/toolkits/urdf_assembly.md) | -| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | -| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/dabd052127eafabe4b724b258f6550a0b4c97235/docs/source/features/workspace_analyzer/workspace_analyzer.md) | +| Antipodal grasp generator | Generates candidate grasp poses through a reusable parallel-jaw interface. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/graspkit/pg_grasp/pose_generator.py#L284-L284) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Newton autograd bridge | Connects Warp tape derivatives to PyTorch action and functional-state gradients. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/diff/bridge.py#L81-L81) · [Newton autograd bridge documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.rst) | +| BatchEntity | Defines shared configuration and instance operations for batched simulation entities. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/common.py#L55-L55) · [BatchEntity documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| URDF collision processor | Replaces mesh collisions with convex pieces and optionally recomputes inertia. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/acd/urdf_modifider.py#L17-L17) · [Convex decomposition documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/convex_decomposition.md) | +| BufferedGymCommandSink | Validates and buffers control commands for incremental Gym demonstration consumption. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/task_program/bridge.py#L892-L892) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [BufferedGymCommandSink documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| CompiledTaskProgram | Immutable compilation result with materialized task segments and analysis views. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/compiler/program.py#L1345-L1345) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [CompiledTaskProgram documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.compiler.rst) | +| Effect evidence | Collects typed evidence from registered providers for semantic effects. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/semantics/evidence.py#L438-L438) · [Effect evidence documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.semantics.rst) | +| ExecutionRunner | Advances atomic skill sessions through observation, command, and clock interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/atomic_skills/runner.py#L367-L367) · [Atomic Skills execution guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/sim/atomic_skills/index.md) · [ExecutionRunner documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.atomic_skills.rst) | +| Interactive grasp annotation | Offers browser selection of a graspable mesh region. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/scripts/annotate_grasp.py#L42-L42) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Mesh grasp backend | Coordinates sampling, annotation, collision checks, and caches for one mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/graspkit/pg_grasp/_antipodal_backend.py#L71-L71) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Gripper collision checks | Checks gripper geometry against the target mesh. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/graspkit/pg_grasp/gripper_collision_checker.py#L96-L96) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Antipodal sampling | Samples opposing surface contacts using mesh ray casting. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/graspkit/pg_grasp/antipodal_sampler.py#L62-L62) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Parallel-jaw gripper configuration | Owns native hand physics, calibration and declared grasp-generator support. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/cfg/gripper.py#L53-L53) · [Grasp generation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/grasp_generator.rst) | +| Integration catalog | Describes one Task Program integration and validates compilation against its fingerprint. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/integrations/catalog.py#L635-L635) · [Integration catalog documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.rst) | +| Object backend views | Adapts rigid and articulated object state to backend-neutral Scene batches. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/backends/__init__.py#L19-L19) · [Object backend views documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Parallel execution | Coordinates parallel semantic branches through command and safety interfaces. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/runtime/parallel_executor.py#L629-L629) · [Parallel execution documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.runtime.rst) | +| Program loading & validation | Loads bounded JSON or YAML into the canonical Task Program configuration. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/language/loader.py#L17-L17) · [Program loading & validation documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| SceneRegistry | Binds semantic entity identifiers to scene metadata and runtime providers. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/semantics/scene.py#L1113-L1113) · [SceneRegistry documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/scene_registry.md) | +| SimulationTaskProgramFactory | Binds simulated robots, planners, and services to construct the atomic skill engine. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/integrations/simulation/environment.py#L731-L731) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [Simulation integration API](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.integrations.simulation.rst) | +| RobotSkillProfile | Declares robot resources, skill bindings, and effect-assurance capabilities. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/semantics/profiles.py#L1495-L1495) · [RobotSkillProfile documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/robot_profiles.md) | +| EnvironmentStepClock | Maintains execution time on the environment step grid. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/gym/envs/task_program/bridge.py#L351-L351) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [Gym Task Program API](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.gym.envs.task_program.rst) | +| Surface deformables | Specializes deformable objects for cloth particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/deformable/surface.py#L28-L28) · [Surface deformables documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| TaskProgramCfg | Declarative task configuration describing intent and execution structure. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/task_program/language/schema.py#L1067-L1067) · [Task Program guide](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/overview/task_program/index.md) · [TaskProgramCfg documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.task_program.language.rst) | +| Toolkit directory | Standalone grasp sampling, collision-mesh preparation, URDF composition and precision assembly assets. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/__init__.py#L17-L21) · [Toolkits documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/index.rst) · [Precision Assembly guide and native demos](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/precision_assembly.md) | +| URDF components | Processes component links, joints, naming, and mesh references. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/component.py#L87-L87) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| URDF connections | Applies component connection rules and sensor attachment joints. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/connection.py#L30-L30) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| URDF mesh resources | Copies mesh resources and rewrites references for the assembled robot. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/mesh.py#L33-L33) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| URDF sensor attachments | Processes sensor descriptions and attachment metadata for assembly. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/sensor.py#L75-L75) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| URDF file output | Formats and persists the assembled URDF document. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/toolkits/urdf_assembly/file_writer.py#L28-L28) · [URDF assembly documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/toolkits/urdf_assembly.md) | +| Volume deformables | Specializes deformable objects for volumetric soft-body particle sets. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/objects/deformable/volume.py#L36-L36) · [Volume deformables documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/api_reference/embodichain/embodichain.lab.sim.objects.rst) | +| Workspace analyzer | Analyzes robot reachability and metrics for reusable workspace caches. | [Source](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/embodichain/lab/sim/motion/workspace/analyzer.py#L182-L182) · [Workspace analyzer documentation](https://github.com/DexForce/EmbodiChain/blob/bca6e91c0f7187cf037eb20c331b3a2764258737/docs/source/features/workspace_analyzer/workspace_analyzer.md) | ## Coverage and interpretation From b5197862332ab7c51aeca7e7f989c4eff41c8a6b Mon Sep 17 00:00:00 2001 From: yuecideng Date: Fri, 20 Nov 2026 08:55:26 +0000 Subject: [PATCH 12/12] fix(packaging): honor dry-run and correct legacy uninstall --- docs/source/quick_start/install.md | 8 ++++---- setup.py | 27 ++++++++++++++------------- tests/test_release_metadata.py | 19 +++++++++++++++++++ 3 files changed, 37 insertions(+), 17 deletions(-) diff --git a/docs/source/quick_start/install.md b/docs/source/quick_start/install.md index b65e4617fe..9ad4c78d8d 100644 --- a/docs/source/quick_start/install.md +++ b/docs/source/quick_start/install.md @@ -235,12 +235,12 @@ Both a published-wheel install and `pip install -e .` register the `embodichain.tasks` entry point automatically; do not install `embodichain/extensions/tasks/` separately. -If an older checkout was installed with `pip install -e embodichain/extensions/tasks/`, -remove that legacy editable distribution once before reinstalling the main -project: +If you previously installed the separate `embodichain_tasks` distribution +with `pip install -e embodichain_tasks/` from an older checkout, remove it +before reinstalling the main project. ```bash -pip uninstall -y embodichain.extensions.tasks +pip uninstall -y embodichain_tasks pip install -e . ``` diff --git a/setup.py b/setup.py index d41e4b5457..094a42589e 100644 --- a/setup.py +++ b/setup.py @@ -44,19 +44,20 @@ class BuildPy(build_py): """Remove retired extension packages from reused build staging.""" def run(self) -> None: - for extension in ( - "benchmarks", - "models", - "robots", - "sensors", - "solvers", - "tasks", - ): - stale_package = Path(self.build_lib) / f"embodichain_{extension}" - if stale_package.is_symlink(): - stale_package.unlink(missing_ok=True) - elif stale_package.is_dir(): - shutil.rmtree(stale_package) + if not self.dry_run: + for extension in ( + "benchmarks", + "models", + "robots", + "sensors", + "solvers", + "tasks", + ): + stale_package = Path(self.build_lib) / f"embodichain_{extension}" + if stale_package.is_symlink(): + stale_package.unlink(missing_ok=True) + elif stale_package.is_dir(): + shutil.rmtree(stale_package) super().run() diff --git a/tests/test_release_metadata.py b/tests/test_release_metadata.py index 978c85a02b..1ad8c1ecde 100644 --- a/tests/test_release_metadata.py +++ b/tests/test_release_metadata.py @@ -123,6 +123,25 @@ def test_package_discovery_includes_only_runtime_trees() -> None: assert all(package.partition(".")[0] == "embodichain" for package in packages) +def test_dry_run_preserves_retired_extension_staging(tmp_path: Path) -> None: + stale_dir = tmp_path / "embodichain_tasks" + stale_dir.mkdir() + payload = stale_dir / "__init__.py" + payload.touch() + stale_link = tmp_path / "embodichain_models" + stale_link.symlink_to(stale_dir, target_is_directory=True) + + distribution = Distribution() + distribution.dry_run = True + command = package_setup.BuildPy(distribution) + command.build_lib = str(tmp_path) + command.ensure_finalized() + command.run() + + assert payload.is_file() + assert stale_link.is_symlink() + + def test_new_extension_package_and_resources_are_discovered( tmp_path: Path, monkeypatch: pytest.MonkeyPatch ) -> None: