VolumetricSMPL
Description
VolumetricSMPL is an extension of the SMPL body model that incorporates a volumetric (signed distance field, SDF) representation. This enables seamless interaction with 3D geometries, such as scenes, objects, and other humans.
Installation
Ensure that PyTorch and PyTorch3D are installed with GPU support. Then, install VolumetricSMPL via:
pip install VolumetricSMPL
Usage
VolumetricSMPL extends the interface of the SMPL-X package by attaching a volumetric representation to the body model. This allows for querying signed distance fields for arbitrary points and accessing collision loss terms.
A more detailed tutorial is available here, demonstrating how to integrate VolumetricSMPL into applications requiring human-scene, human-object, and human-human interactions.
Example Usage
import smplx
from VolumetricSMPL import attach_volume
# Create a SMPL body and extend it with volumetric functionalities (supports SMPL, SMPLH, and SMPL-X)
model = smplx.create(**smpl_parameters)
attach_volume(model)
# Forward pass
smpl_output = model(**smpl_data)
# Ensure valid SMPL variables (pose parameters, joints, and vertices)
assert model.joint_mapper is None, "VolumetricSMPL requires valid SMPL joints as input."
# Access volumetric functionalities
model.volume.query(scan_point_cloud) # Query SDF for given points
model.volume.selfpen_loss(smpl_output) # Compute self-intersection loss
model.volume.collision_loss(smpl_output, scan_point_cloud) # Compute collisions with external geometries
Pretrained Models
Pretrained models are automatically fetched and loaded. They can also be found in the dev branch inside the ./models directory.
Contact
For questions, please contact Marko Mihajlovic (markomih@ethz.ch) or open an issue on GitHub.
Metadata
Release files for VolumetricSMPL 1.0.4
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 | Actions |
|---|---|---|---|---|
| volumetricsmpl-1.0.4.tar.gz | 22.8 kB | Without provenance | Details for volumetricsmpl-1.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| VolumetricSMPL-1.0.4-py3-none-any.whl | Python 3 | none | any | Details for VolumetricSMPL-1.0.4-py3-none-any.whl |
Total release size: 45.5 kB
Release files / volumetricsmpl-1.0.4.tar.gz
| Download URL | volumetricsmpl-1.0.4.tar.gz |
|---|---|
| Size | 22.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5382b941eef854a2bb20d3a37ff17ce5991d9cf7350c7aa4f9374fac30128db0
|
|
BLAKE2b-256 checksum How to use checksums |
43a012e3f97bbdffe8c9b8385bc18d23af6401216b6743905e80a1d271928077
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.6
|
Release files / VolumetricSMPL-1.0.4-py3-none-any.whl
| Download URL | VolumetricSMPL-1.0.4-py3-none-any.whl |
|---|---|
| Size | 22.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aed868225c3605068b30e49c2e7c4975d8beebc6e904210339dedff2e74291a1
|
|
BLAKE2b-256 checksum How to use checksums |
c18adf274f938f314992812eae6470ed0ad945d12e92efc5719892f1547bd31a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.9.6
|
Security for VolumetricSMPL 1.0.4
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.
To learn more about protecting yourself from malicious actors, visit our package security documentation.