omniverse-gsplat-converter 0.1.1

NVIDIA 3D Gaussian Splat to USD Converter

Omniverse Gaussian Splat Converter

A pip-installable Python package for converting 3D Gaussian Splat data (PLY and SPZ formats) to USD using the ParticleField3DGaussianSplat schema.

Installation

pip install omniverse-gsplat-converter

For USD support (if not already installed):

pip install omniverse-gsplat-converter[usd]

Usage

Command Line

# Convert a PLY file to USDZ
omni_gsplat_convert -i input.ply -o output.usdz

# Convert an SPZ file to USDA with Z-up axis
omni_gsplat_convert -i input.spz -o output.usda --up-axis Z

# Generate spherical harmonics and scales from raw PLY
omni_gsplat_convert -i input.ply -o output.usdz --generateSh --generateScales

You can also run via python -m:

python -m omniverse_gsplat_converter -i input.ply -o output.usdz

Python API

from omniverse_gsplat_converter import read_ply, read_spz, write_gaussian_splat_usd

# Read a PLY file
splat_data = read_ply("scene.ply")

# Write to USD
write_gaussian_splat_usd(splat_data, "scene.usdz", source_file="scene.ply")

# Read an SPZ file
splat_data = read_spz("scene.spz")

# Write to USD with options
write_gaussian_splat_usd(
    splat_data,
    "scene.usda",
    source_file="scene.spz",
    up_axis="Z",
    rotation_degrees=(90.0, 0.0, 0.0),
)