obj2mjcf
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| obj2mjcf-0.0.25.tar.gz | 11.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.