Conquer3D
Installation
1. Install from PyPI
pip install -U conquer3d
2. Install via Docker (Recommended for complete 3D & CUDA setup)
You can directly pull and run the pre-built Docker image with full GPU and CUDA toolchain support:
docker pull kohido/conquer3d:latest
docker run --rm --gpus all -it kohido/conquer3d:latest bash
Or build the image locally from source:
docker build -t conquer3d:latest .
docker run --rm --gpus all -it conquer3d:latest bash
3. Build from Source
To build from source, ensure you have a compatible CUDA toolchain (e.g., CUDA Toolkit 12.8) and PyTorch installed:
# Optional: Create a dedicated Conda environment with modern C++ compilers and CUDA
conda create -c conda-forge -n geocutool python=3.10 gxx_linux-64=13 gcc_linux-64=13 -y
conda activate geocutool
conda install -c conda-forge sparsehash -y
conda install nvidia::cuda-toolkit==12.8.2 -y
# Install PyTorch and binding generators
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu128
pip install pybind11-stubgen
Install directly from GitHub without build isolation:
pip install git+https://github.com/KhoiDOO/geocutool.git --no-build-isolation
git clone https://github.com/KhoiDOO/geocutool.git
cd geocutool
pip install -e . --no-build-isolation
Features
- Isosurface Extraction: Differentiable Marching Cubes, Marching Cubes Asymptotic (MCA), Marching Tetrahedra (MT), Dual Contouring (DC) with GPU QEF solver, and Dual Marching Cubes (DMC) for multi-sheet manifold topological resolution with pure quad / Delaunay triangle extraction.
- Spatial Acceleration Structures: GPU Bounding Volume Hierarchies (Mesh BVH, GS BVH, PGS BVH), KD-Trees, Morton Z-Curve sorting, and 3D Sparse Voxel Grids.
- Differentiable Ray Tracing & Radiance Fields: Fast 3D Gaussian Splatting (3DGS) and Periodic Gaussian Splatting (PGS) query kernels.
- Geometric Metrics & Integrals: Exact one-sided & symmetric Chamfer / Hausdorff distances and single-view volume integrals.
Acknowledgements & References
For further theoretical background, GPU collision detection guides, and related open-source projects, please refer to:
- Research Papers: Key computational geometry, differential topology, and acceleration structure literature.
- Blog Posts: Articles and guides on NVIDIA GPU spatial traversal and parallel construction.
- Related Repositories: Open-source libraries and frameworks supporting geometric deep learning and processing.
- Books: Core theoretical books.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
conquer3d-0.5.9.tar.gz
(4.8 MB
view details)
File details
Details for the file conquer3d-0.5.9.tar.gz.
File metadata
- Download URL: conquer3d-0.5.9.tar.gz
- Upload date:
- Size: 4.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dde12aa2dc90db7d6591462f4996bf6989ae8272bba3ec82dbc064415301675f
|
|
| MD5 |
49a683736d02f25c93211ec01e93e7f7
|
|
| BLAKE2b-256 |
8abfba51fdd3fad71cf3c396d03e5e02b23770f1d6750c48df6988df273620f3
|