{"id":29131231,"url":"https://github.com/autonomousvision/volsurfs","last_synced_at":"2025-06-30T05:06:54.584Z","repository":{"id":282247154,"uuid":"846986274","full_name":"autonomousvision/volsurfs","owner":"autonomousvision","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-07T13:45:05.000Z","size":125391,"stargazers_count":23,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-07T14:48:06.699Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/autonomousvision.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-08-24T14:21:58.000Z","updated_at":"2025-05-07T01:28:11.000Z","dependencies_parsed_at":"2025-04-29T13:35:06.989Z","dependency_job_id":null,"html_url":"https://github.com/autonomousvision/volsurfs","commit_stats":null,"previous_names":["s-esposito/volsurfs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/autonomousvision/volsurfs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomousvision%2Fvolsurfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomousvision%2Fvolsurfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomousvision%2Fvolsurfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomousvision%2Fvolsurfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/autonomousvision","download_url":"https://codeload.github.com/autonomousvision/volsurfs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/autonomousvision%2Fvolsurfs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262714509,"owners_count":23352466,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-30T05:06:54.147Z","updated_at":"2025-06-30T05:06:54.574Z","avatar_url":"https://github.com/autonomousvision.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Volumetric Surfaces (CVPR 2025)\n\n### Representing Fuzzy Geometries with Layered Meshes\n\n### [Project Page](https://autonomousvision.github.io/volsurfs/) | [Paper](https://arxiv.org/pdf/2409.02482) | [Web Demo](https://autonomousvision.github.io/volsurfs/viewer/)\n\n\n[Stefano Esposito](https://s-esposito.github.io/)\u003csup\u003e1\u003c/sup\u003e,\n[Anpei Chen](https://apchenstu.github.io/)\u003csup\u003e1\u003c/sup\u003e, \n[Christian Reiser](https://creiser.github.io/)\u003csup\u003e1\u003c/sup\u003e, \n[Samuel Rota Bulò](https://scholar.google.com/citations?user=484sccEAAAAJ\u0026hl=it)\u003csup\u003e2\u003c/sup\u003e, \n[Lorenzo Porzi](https://scholar.google.it/citations?user=vW1gaVEAAAAJ\u0026hl=it)\u003csup\u003e2\u003c/sup\u003e, \n[Katja Schwarz](https://katjaschwarz.github.io/)\u003csup\u003e2\u003c/sup\u003e, \n[Christian Richardt](https://richardt.name/)\u003csup\u003e2\u003c/sup\u003e, \n[Michael Zollhöfer](https://zollhoefer.com/)\u003csup\u003e2\u003c/sup\u003e, \n[Peter Kontschieder](https://scholar.google.co.uk/citations?user=CxbDDRMAAAAJ\u0026hl=en)\u003csup\u003e2\u003c/sup\u003e,\n[Andreas Geiger](https://www.cvlibs.net/)\u003csup\u003e1\u003c/sup\u003e\n\u003cbr\u003e\n\u003csup\u003e1\u003c/sup\u003e[University of Tübingen](https://uni-tuebingen.de/fakultaeten/mathematisch-naturwissenschaftliche-fakultaet/fachbereiche/informatik/lehrstuehle/autonomous-vision/home/), \u003csup\u003e2\u003c/sup\u003eMeta Reality Labs\n\n\u003cp align=\"middle\"\u003e\n  \u003cimg src=\"imgs/teaser.png\" width=\"650\"/\u003e\n\u003c/p\u003e\n\n\n\n## 🛠️ Installation\n\n```bash\n# Clone the repository with submodules\ngit clone --recursive https://github.com/autonomousvision/volsurfs\ncd volsurfs\ngit submodule update --remote --merge\n\n# Create and activate a conda environment\nconda create -n volsurfs python=3.8 cmake=3.31\nconda activate volsurfs\n\n# (Optional) Install CUDA toolkit\nconda install -c \"nvidia/label/cuda-11.8.0\" cuda-toolkit\n\n# Install PyTorch with CUDA support\nconda install pytorch==2.4.1 torchvision==0.19.1 torchaudio==2.4.1 pytorch-cuda=11.8 -c pytorch -c nvidia\n\n# Install Python dependencies\npip install -r requirements.txt\n\n# Install raytracelib\ncd submodules/raytracelib\npip install -e .\ncd ../..\n\n# Install NVIDIA APEX\ncd submodules/apex\npip install . -v --disable-pip-version-check --no-cache-dir --no-build-isolation \\\n  --config-settings \"--build-option=--cpp_ext\" --config-settings \"--build-option=--cuda_ext\" ./\ncd ../..\n\n# Compile and install VolSurfs\npip install ninja\npip install -e . --no-build-isolation\n```\n\n\n\n## 📁 Datasets\n\nWe use the following datasets for training and evaluation:\n\n- [NeRF-Synthetic](scripts/download/blender.sh)\n- [DTU](scripts/download/dtu.sh)\n- [Shelly](scripts/download/shelly.sh)\n\nDownload scripts are located in `scripts/download/` and will place the datasets in the `data/` directory. You can configure dataset paths in `config/paths_config.cfg`.\n\nExample directory structure:\n```\ndata/\n├── shelly/\n│   ├── khady/\n│   ├── kitten/\n│   └── ...\n├── dtu/\n│   ├── dtu_scan24/\n│   ├── dtu_scan37/\n│   └── ...\n├── blender/\n│   ├── lego/\n│   └── ...\n└── ...\n```\n\n\n\n## 📈 Reproducing Results\n\nTo reproduce the main results (5-Mesh) on the **Shelly** dataset, run:\n\n```bash\nbash scripts/train_all_shelly.sh\n```\n\nResults will be saved in the `runs/` directory. By default, [Weights \u0026 Biases](https://wandb.ai/) logging is enabled; you can disable it in `config/train_config.cfg`.\n\n\n\n## 📜 License\n\nThis project is licensed under the **Creative Commons Attribution 4.0 International License (CC BY 4.0)**.  \nSee the [LICENSE](LICENSE) file for details.\n\nYou are free to use, modify, and distribute this code as long as you provide proper attribution to the original authors.\n\n\n\n## 📚 Citation\n\nIf you use this work in your research, please consider citing:\n\n```bibtex\n@inproceedings{Esposito2025VolSurfs,\n  author    = {Esposito, Stefano and Chen, Anpei and Reiser, Christian and Rota Bulò, Samuel and Porzi, Lorenzo and Schwarz, Katja and Richardt, Christian and Zollhoefer, Michael and Kontschieder, Peter and Geiger, Andreas},\n  title     = {Volumetric Surfaces: Representing Fuzzy Geometries with Layered Meshes},\n  booktitle = {IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},\n  year      = {2025}\n}\n```\n\n```bibtex\n@misc{Esposito2025MVD,\n  author = {Esposito, Stefano and Geiger, Andreas},\n  title  = {MVDatasets: Standardized DataLoaders for 3D Computer Vision},\n  year   = {2025},\n  url    = {https://github.com/autonomousvision/mvdatasets},\n  note   = {GitHub repository}\n}\n```\n\n\n\n## 🙏 Acknowledgements\n\nThis repository builds upon [Radu Alexandru Rosu](https://radualexandru.github.io/)'s excellent project [permuto_sdf](https://github.com/RaduAlexandru/permuto_sdf).  \nWe thank him for sharing his work and providing a strong foundation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomousvision%2Fvolsurfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fautonomousvision%2Fvolsurfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fautonomousvision%2Fvolsurfs/lists"}