Files

3.4 KiB
Raw Permalink Blame History

Microban bundled source assets

Imported with python3 app/scripts/import-microban.py /path/to/microban.

The precise origin remote, HEAD, dirty-worktree flag, per-file SHA-256 and behavior-reference hashes are in source-manifest.json. The source worktree was dirty at import: the HEAD alone is not a complete description of the behavior used as reference. Runtime does not read that worktree or require Python.

  • model.xml: copied from src/model/mjcf/robot.xml, unmodified; its Apache-2.0 copyright/license header is retained.
  • assets/*.stl: only the 25 mesh files actually declared by that MJCF, copied byte-for-byte from the source model asset directory (not the separate cad/ directory).
  • policies/walk.onnx: copied byte-for-byte from src/agents/walk.onnx.
  • LICENSES/SOURCE-LICENSE.txt: entire upstream license/attribution notice. The upstream summary assigns GPL-3.0 to control software outside cad/ and CC-BY-NC-SA-4.0 to cad/. Model-file-specific notices take precedence for their respective files. No assertion is made that all files have one uniform license. Preserve these notices when redistributing, and check upstream terms for intended distribution.

Browser adaptations (not edits to the copied XML): 0.005 s physics timestep; separate flat ground; explicit 18-joint policy order excluding head; body-frame gravity and IMU-site gyroscope following source observation semantics; limited joint-PD torque control instead of BAM. Default PD kp=0.3 Nm/rad, kd=0.02 Nm·s/rad, torque limit=0.65 Nm are experimentally selected simplified parameters, not metadata gains and not a claim of hardware equivalence.

Textured visual replacement

visuals/*.glb are the 20 files copied byte-for-byte from the user-supplied microban2.zip, replacing the earlier microban.zip visual export, not from the upstream checkout above. They retain their embedded PBR materials and 46 textures (45 normal maps and one screen base-colour image, all 1024 × 1024). The archive contains no license notice; confirm public redistribution rights with the asset owner rather than assuming the upstream model license covers these replacements. Archive and file SHA-256 values are recorded separately in visual-source-manifest.json.

Reimport with python3 app/scripts/import-microban-visuals.py /path/to/microban2.zip. This does not change model.xml, the original STL files, policy, original source manifest or the reviewed render.body_visuals mapping in robot.json.

The GLBs have different local frames from the original MJCF. robot.json records fixed, visual-only rigid transforms (metres and xyzw quaternions), checked against the original per-body geometry; body-local bounding-box endpoint differences are at most 3.01 mm, allowing the replacement's added details. Mapping: BASE → trunk; LINK1 → head; LINK2–4 → right arm; LINK5–7 → left arm; LINK8–13 → left leg; LINK14–19 → right leg. Vertex positions and node transforms in all 20 GLBs are unchanged from the previous visual export, so the existing body registration is retained. Runtime follows the existing MuJoCo body poses and hides only the replaced visual geoms; collisions, inertias, joints, policy inputs and actuation are untouched. This is geometric registration, not a claim that the archive supplied authoritative joint-frame metadata.

No Placo, real-robot control, source Python code, CAD project, BAM battery model or communication delays are bundled into the browser runtime.