Skip to main content

obj2mjcf

PyPI Python Version PyPI version

obj2mjcf is a CLI for proccessing composite Wavefront OBJ files for use in MuJoCo. It automatically:

  • Splits an OBJ file into sub-meshes that are grouped by the materials referenced in the OBJ's MTL file
  • Generates an MJCF XML file that is pre-filled with materials, meshes and geom elements referencing these OBJ files
  • Optionally generates a collision mesh by performing a convex decomposition of the OBJ using CoACD

obj2mjcf was used to process model meshes for MuJoCo Menagerie:

Motivation

As of June 2022, MuJoCo does not support composite OBJ files consisting of groups or objects (o or g OBJ tags) and only 1 material can be assigned per mesh. This means that you have to manually split your OBJ file into sub-meshes, a process that is tedious and error-prone. This tool is meant to automate this process.

Installation

Important. MuJoCo support for OBJ files is only available in versions 2.1.2 and above. Make sure you upgrade to the latest version via the Releases page.

The recommended way to install this package is via PyPI:

pip install --upgrade obj2mjcf

Usage

Type the following at the command line for a detailed description of available options:

obj2mjcf --help

Metadata

Release files for obj2mjcf 0.0.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for obj2mjcf 0.0.25
File Size Uploaded Provenance
obj2mjcf-0.0.25.tar.gz 11.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for obj2mjcf 0.0.25
File Interpreter ABI Platform
obj2mjcf-0.0.25-py3-none-any.whl Python 3 none any Details

Total release size: 22.8 kB

Release files / obj2mjcf-0.0.25.tar.gz

Download URL obj2mjcf-0.0.25.tar.gz
Size 11.7 kB
Tags Source
SHA-256 checksum
How to use checksums
1c01806d8f81d1314e7f5acb56bfad8816b34fed1ebcd69625586407a241b9a9
BLAKE2b-256 checksum
How to use checksums
3b00127af3219bbfd2951d774aa16a8c60fc39a7199d7f1c3255f0e1d6c6404e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.18

Release files / obj2mjcf-0.0.25-py3-none-any.whl

Download URL obj2mjcf-0.0.25-py3-none-any.whl
Size 11.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25376e061f3818370b2b806218e29d7648589dfdf64b57e96f55a3a1dd642409
BLAKE2b-256 checksum
How to use checksums
4cad2a7c1ab8eb30387b9b14728ffa1d221c9c3d3979d2da96dcf96c87004fe1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.9.18

Security for obj2mjcf 0.0.25

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page