| Name | rr-infinigen JSON |
| Version |
1.3.4
JSON |
| download |
| home_page | None |
| Summary | Infinite Photorealistic Worlds using Procedural Generation |
| upload_time | 2024-06-10 07:39:15 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | ==3.11.* |
| license | BSD 3-Clause License Copyright (c) 2023, Princeton University Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| keywords |
computer vision
data generation
procedural
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
## [Infinigen: Infinite Photorealistic Worlds using Procedural Generation](https://infinigen.org)
Please visit our website, [https://infinigen.org](https://infinigen.org)
[](https://youtu.be/6tgspeI-GHY)
If you use Infinigen in your work, please cite our [academic paper]([https://arxiv.org/abs/2306.09310](https://arxiv.org/abs/2306.09310)):
<h3 align="center"><a href="https://arxiv.org/pdf/2306.09310">Infinite Photorealistic Worlds using Procedural Generation</a></h3>
<p align="center">
<a href="http://araistrick.com/">Alexander Raistrick</a>*, <a href="https://www.lahavlipson.com/">Lahav Lipson</a>*, <a href="https://mazeyu.github.io/">Zeyu Ma</a>* (*equal contribution, alphabetical order) <br>
<a href="https://www.cs.princeton.edu/~lm5483/">Lingjie Mei</a>, <a href="https://www.cs.princeton.edu/~mingzhew">Mingzhe Wang</a>, <a href="https://zuoym15.github.io/">Yiming Zuo</a>, <a href="https://kkayan.com/">Karhan Kayan</a>, <a href="https://hermera.github.io/">Hongyu Wen</a>, <a href="https://pvl.cs.princeton.edu/people.html">Beining Han</a>, <br>
<a href="https://pvl.cs.princeton.edu/people.html">Yihan Wang</a>, <a href="http://www-personal.umich.edu/~alnewell/index.html">Alejandro Newell</a>, <a href="https://heilaw.github.io/">Hei Law</a>, <a href="https://imankgoyal.github.io/">Ankit Goyal</a>, <a href="https://yangky11.github.io/">Kaiyu Yang</a>, <a href="http://www.cs.princeton.edu/~jiadeng">Jia Deng</a><br>
Conference on Computer Vision and Pattern Recognition (CVPR) 2023
</p>
```
@inproceedings{infinigen2023infinite,
title={Infinite Photorealistic Worlds Using Procedural Generation},
author={Raistrick, Alexander and Lipson, Lahav and Ma, Zeyu and Mei, Lingjie and Wang, Mingzhe and Zuo, Yiming and Kayan, Karhan and Wen, Hongyu and Han, Beining and Wang, Yihan and Newell, Alejandro and Law, Hei and Goyal, Ankit and Yang, Kaiyu and Deng, Jia},
booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
pages={12630--12641},
year={2023}
}
```
### Getting Started
First, follow our [Installation Instructions](docs/Installation.md).
Next, see our ["Hello World" example](docs/HelloWorld.md) to generate an image & ground truth similar to those shown below.
<p align="center">
<img src="docs/images/hello_world/Image0048_00_00.png" width="350" />
<img src="docs/images/hello_world/Depth0048_00_00.png" width="350" />
<img src="docs/images/hello_world/SurfaceNormal_0001_00_00.png" width="350" />
<img src="docs/images/hello_world/InstanceSegmentation_0001_00_00.png" width="350" />
</p>
### Documentation
- [Installation Guide](docs/Installation.md)
- ["Hello World": Generate your first Infinigen scene](docs/HelloWorld.md)
- [Configuring Infinigen](docs/ConfiguringInfinigen.md)
- [Downloading pre-generated data](docs/PreGeneratedData.md)
- [Generating individual assets](docs/GeneratingIndividualAssets.md)
- [Exporting to external fileformats (OBJ, OpenUSD, etc)](docs/ExportingToExternalFileFormats.md)
- [Extended ground-truth](docs/GroundTruthAnnotations.md)
- [Implementing new materials & assets](docs/ImplementingAssets.md)
- [Generating fluid simulations](docs/GeneratingFluidSimulations.md)
### Coming Soon
Please see our [project roadmap](https://infinigen.org/roadmap) and follow us at [https://twitter.com/PrincetonVL](https://twitter.com/PrincetonVL) for updates.
### Contributing
We welcome contributions! You can contribute in many ways:
- **Contribute code to this repository** - We welcome code contributions. More guidelines coming soon.
- **Contribute procedural generators** - `infinigen/nodes/node_transpiler/dev_script.py` provides tools to convert artist-friendly [Blender Nodes](https://docs.blender.org/manual/en/2.79/render/blender_render/materials/nodes/introduction.html) into python code. Tutorials and guidelines coming soon.
- **Contribute pre-generated data** - Anyone can contribute their computing power to create data and share it with the community. Please stay tuned for a repository of pre-generated data.
### Getting Help
Please post this repository's Github Issues page for help. Please run your command with `--debug`, and let us know:
- What is your computing setup, including OS version, CPU, RAM, GPU(s) and any drivers?
- What version of the code are you using (link a commit hash), and what if any modifications have you made (new configs, code edits)
- What exact command did you run?
- What were the output logs of the command you ran?
- If using `manage_jobs`, look in `outputs/MYJOB/MYSEED/logs/` to find the right one.
- What was the exact python error and stacktrace, if applicable?
### Acknowledgements
Infinigen wouldn't be possible without the fantastic work of the [Blender Foundation](https://www.blender.org/) and it's open-source contributors. Infinigen uses many open source projects, with special thanks to [Land-Lab](https://github.com/landlab/landlab), [BlenderProc](https://github.com/DLR-RM/BlenderProc) [Blender-FLIP-Fluids](https://github.com/rlguy/Blender-FLIP-Fluids) and [Blender-Differential-Growth](https://github.com/inca/blender-differential-growth).
We thank [Thomas Kole](https://blenderartists.org/u/ThomasKole) for providing procedural clouds and [Pedro P. Lopes](https://blendswap.com/blend/30728) for the autoexposure nodegraph.
We learned tremendously from online tutorials of
[Andrew Price](https://www.youtube.com/channel/UCOKHwx1VCdgnxwbjyb9Iu1g),
[Artisans of Vaul](https://www.youtube.com/@ArtisansofVaul),
[Bad Normals](https://www.youtube.com/@BadNormals),
[Blender Tutorial Channel](https://www.youtube.com/@BlenderTutorialChannel),
[blenderbitesize](https://www.youtube.com/@blenderbitesize),
[Blendini](http://www.youtube.com/watch?v=sHr8LjfX09c),
[Bradley Animation](https://www.youtube.com/@bradleyanimation120),
[CGCookie](https://www.youtube.com/watch?v=lPAYX8z9i8M),
[CGRogue](https://www.youtube.com/@PixelicaCG),
[Creative Shrimp](https://www.youtube.com/@CreativeShrimp),
[CrowdRender](https://www.youtube.com/@Crowdrender),
[Dr. Blender](https://www.youtube.com/@DrBlender),
[HEY Pictures](https://www.youtube.com/channel/UCo5rv1z-PPrCh-C7OvO2VAA),
[Ian Hubert](https://www.youtube.com/@IanHubert2),
[Kev Binge](https://www.youtube.com/@KevBinge),
[Lance Phan](https://www.youtube.com/@LancePhan),
[MaxEdge](https://www.youtube.com/@MaxEdge420),
[Mr. Cheebs](https://www.youtube.com/@MrCheebs),
[PixelicaCG](https://www.youtube.com/@PixelicaCG),
[Polyfjord](https://www.youtube.com/@Polyfjord),
[Robbie Tilton](https://www.youtube.com/@RobbieTilton),
[Ryan King Art](https://www.youtube.com/@RyanKingArt),
[Sam Bowman](https://www.youtube.com/@snow_mamba) and
[yogigraphics](https://www.youtube.com/@yojigraphics).
These tutorials provided procedural generators for our early experimentation and served as inspiration for our own implementations in the official release of Infinigen. They are acknowledged in file header comments where applicable.
Infinigen has evolved significantly since the version described in our CVPR paper. It now features some procedural code obtained from the internet under CC-0 licenses, which are marked with code comments where applicable - no such code was present in the system for the CVPR version.
Raw data
{
"_id": null,
"home_page": null,
"name": "rr-infinigen",
"maintainer": null,
"docs_url": null,
"requires_python": "==3.11.*",
"maintainer_email": null,
"keywords": "computer vision, data generation, procedural",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a8/82/85c2833eb386bcd11d93412e1e0b0adc9b5e156da8716c8e1d9fd5e4cd78/rr_infinigen-1.3.4.tar.gz",
"platform": null,
"description": "\n\n## [Infinigen: Infinite Photorealistic Worlds using Procedural Generation](https://infinigen.org)\n\nPlease visit our website, [https://infinigen.org](https://infinigen.org)\n\n[](https://youtu.be/6tgspeI-GHY)\n\nIf you use Infinigen in your work, please cite our [academic paper]([https://arxiv.org/abs/2306.09310](https://arxiv.org/abs/2306.09310)):\n\n<h3 align=\"center\"><a href=\"https://arxiv.org/pdf/2306.09310\">Infinite Photorealistic Worlds using Procedural Generation</a></h3>\n<p align=\"center\">\n<a href=\"http://araistrick.com/\">Alexander Raistrick</a>*, <a href=\"https://www.lahavlipson.com/\">Lahav Lipson</a>*, <a href=\"https://mazeyu.github.io/\">Zeyu Ma</a>* (*equal contribution, alphabetical order) <br>\n<a href=\"https://www.cs.princeton.edu/~lm5483/\">Lingjie Mei</a>, <a href=\"https://www.cs.princeton.edu/~mingzhew\">Mingzhe Wang</a>, <a href=\"https://zuoym15.github.io/\">Yiming Zuo</a>, <a href=\"https://kkayan.com/\">Karhan Kayan</a>, <a href=\"https://hermera.github.io/\">Hongyu Wen</a>, <a href=\"https://pvl.cs.princeton.edu/people.html\">Beining Han</a>, <br>\n<a href=\"https://pvl.cs.princeton.edu/people.html\">Yihan Wang</a>, <a href=\"http://www-personal.umich.edu/~alnewell/index.html\">Alejandro Newell</a>, <a href=\"https://heilaw.github.io/\">Hei Law</a>, <a href=\"https://imankgoyal.github.io/\">Ankit Goyal</a>, <a href=\"https://yangky11.github.io/\">Kaiyu Yang</a>, <a href=\"http://www.cs.princeton.edu/~jiadeng\">Jia Deng</a><br>\nConference on Computer Vision and Pattern Recognition (CVPR) 2023\n</p>\n\n```\n@inproceedings{infinigen2023infinite,\n title={Infinite Photorealistic Worlds Using Procedural Generation},\n author={Raistrick, Alexander and Lipson, Lahav and Ma, Zeyu and Mei, Lingjie and Wang, Mingzhe and Zuo, Yiming and Kayan, Karhan and Wen, Hongyu and Han, Beining and Wang, Yihan and Newell, Alejandro and Law, Hei and Goyal, Ankit and Yang, Kaiyu and Deng, Jia},\n booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},\n pages={12630--12641},\n year={2023}\n}\n```\n\n### Getting Started\n\nFirst, follow our [Installation Instructions](docs/Installation.md).\n\nNext, see our [\"Hello World\" example](docs/HelloWorld.md) to generate an image & ground truth similar to those shown below.\n\n<p align=\"center\">\n <img src=\"docs/images/hello_world/Image0048_00_00.png\" width=\"350\" />\n <img src=\"docs/images/hello_world/Depth0048_00_00.png\" width=\"350\" />\n <img src=\"docs/images/hello_world/SurfaceNormal_0001_00_00.png\" width=\"350\" />\n <img src=\"docs/images/hello_world/InstanceSegmentation_0001_00_00.png\" width=\"350\" />\n</p>\n\n### Documentation\n\n- [Installation Guide](docs/Installation.md)\n- [\"Hello World\": Generate your first Infinigen scene](docs/HelloWorld.md)\n- [Configuring Infinigen](docs/ConfiguringInfinigen.md)\n- [Downloading pre-generated data](docs/PreGeneratedData.md)\n- [Generating individual assets](docs/GeneratingIndividualAssets.md)\n- [Exporting to external fileformats (OBJ, OpenUSD, etc)](docs/ExportingToExternalFileFormats.md)\n- [Extended ground-truth](docs/GroundTruthAnnotations.md)\n- [Implementing new materials & assets](docs/ImplementingAssets.md)\n- [Generating fluid simulations](docs/GeneratingFluidSimulations.md)\n\n### Coming Soon\nPlease see our [project roadmap](https://infinigen.org/roadmap) and follow us at [https://twitter.com/PrincetonVL](https://twitter.com/PrincetonVL) for updates. \n\n### Contributing\nWe welcome contributions! You can contribute in many ways:\n- **Contribute code to this repository** - We welcome code contributions. More guidelines coming soon.\n- **Contribute procedural generators** - `infinigen/nodes/node_transpiler/dev_script.py` provides tools to convert artist-friendly [Blender Nodes](https://docs.blender.org/manual/en/2.79/render/blender_render/materials/nodes/introduction.html) into python code. Tutorials and guidelines coming soon.\n- **Contribute pre-generated data** - Anyone can contribute their computing power to create data and share it with the community. Please stay tuned for a repository of pre-generated data.\n\n### Getting Help\n\nPlease post this repository's Github Issues page for help. Please run your command with `--debug`, and let us know:\n- What is your computing setup, including OS version, CPU, RAM, GPU(s) and any drivers?\n- What version of the code are you using (link a commit hash), and what if any modifications have you made (new configs, code edits)\n- What exact command did you run?\n- What were the output logs of the command you ran? \n - If using `manage_jobs`, look in `outputs/MYJOB/MYSEED/logs/` to find the right one.\n - What was the exact python error and stacktrace, if applicable?\n\n### Acknowledgements\n\nInfinigen wouldn't be possible without the fantastic work of the [Blender Foundation](https://www.blender.org/) and it's open-source contributors. Infinigen uses many open source projects, with special thanks to [Land-Lab](https://github.com/landlab/landlab), [BlenderProc](https://github.com/DLR-RM/BlenderProc) [Blender-FLIP-Fluids](https://github.com/rlguy/Blender-FLIP-Fluids) and [Blender-Differential-Growth](https://github.com/inca/blender-differential-growth).\n\nWe thank [Thomas Kole](https://blenderartists.org/u/ThomasKole) for providing procedural clouds and [Pedro P. Lopes](https://blendswap.com/blend/30728) for the autoexposure nodegraph. \n\nWe learned tremendously from online tutorials of \n[Andrew Price](https://www.youtube.com/channel/UCOKHwx1VCdgnxwbjyb9Iu1g),\n[Artisans of Vaul](https://www.youtube.com/@ArtisansofVaul),\n[Bad Normals](https://www.youtube.com/@BadNormals),\n[Blender Tutorial Channel](https://www.youtube.com/@BlenderTutorialChannel),\n[blenderbitesize](https://www.youtube.com/@blenderbitesize),\n[Blendini](http://www.youtube.com/watch?v=sHr8LjfX09c),\n[Bradley Animation](https://www.youtube.com/@bradleyanimation120),\n[CGCookie](https://www.youtube.com/watch?v=lPAYX8z9i8M),\n[CGRogue](https://www.youtube.com/@PixelicaCG),\n[Creative Shrimp](https://www.youtube.com/@CreativeShrimp),\n[CrowdRender](https://www.youtube.com/@Crowdrender),\n[Dr. Blender](https://www.youtube.com/@DrBlender),\n[HEY Pictures](https://www.youtube.com/channel/UCo5rv1z-PPrCh-C7OvO2VAA),\n[Ian Hubert](https://www.youtube.com/@IanHubert2),\n[Kev Binge](https://www.youtube.com/@KevBinge),\n[Lance Phan](https://www.youtube.com/@LancePhan),\n[MaxEdge](https://www.youtube.com/@MaxEdge420),\n[Mr. Cheebs](https://www.youtube.com/@MrCheebs),\n[PixelicaCG](https://www.youtube.com/@PixelicaCG),\n[Polyfjord](https://www.youtube.com/@Polyfjord),\n[Robbie Tilton](https://www.youtube.com/@RobbieTilton),\n[Ryan King Art](https://www.youtube.com/@RyanKingArt),\n[Sam Bowman](https://www.youtube.com/@snow_mamba) and\n[yogigraphics](https://www.youtube.com/@yojigraphics).\nThese tutorials provided procedural generators for our early experimentation and served as inspiration for our own implementations in the official release of Infinigen. They are acknowledged in file header comments where applicable. \n\nInfinigen has evolved significantly since the version described in our CVPR paper. It now features some procedural code obtained from the internet under CC-0 licenses, which are marked with code comments where applicable - no such code was present in the system for the CVPR version.\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License Copyright (c) 2023, Princeton University Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.",
"summary": "Infinite Photorealistic Worlds using Procedural Generation",
"version": "1.3.4",
"project_urls": null,
"split_keywords": [
"computer vision",
" data generation",
" procedural"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1d8a3afa188641b5b7d0bb467bcec6bc31b939623a0066facff2ea179de02b49",
"md5": "2dc2da22d18e8e4fe1b54c7815b30235",
"sha256": "611b70da9799c93ce9e93908e788d4289219c77a46a12f2cf982a02cfdc9879f"
},
"downloads": -1,
"filename": "rr_infinigen-1.3.4-cp311-cp311-macosx_13_0_arm64.whl",
"has_sig": false,
"md5_digest": "2dc2da22d18e8e4fe1b54c7815b30235",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": "==3.11.*",
"size": 1268621,
"upload_time": "2024-06-10T07:39:09",
"upload_time_iso_8601": "2024-06-10T07:39:09.193101Z",
"url": "https://files.pythonhosted.org/packages/1d/8a/3afa188641b5b7d0bb467bcec6bc31b939623a0066facff2ea179de02b49/rr_infinigen-1.3.4-cp311-cp311-macosx_13_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a88285c2833eb386bcd11d93412e1e0b0adc9b5e156da8716c8e1d9fd5e4cd78",
"md5": "4b7d9dc96b0cf9932b356fc23e948890",
"sha256": "cb6e4468dc8af167b35b99bbf02c51a1835e69a28548ac5ff3e62b92d00f9267"
},
"downloads": -1,
"filename": "rr_infinigen-1.3.4.tar.gz",
"has_sig": false,
"md5_digest": "4b7d9dc96b0cf9932b356fc23e948890",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "==3.11.*",
"size": 1321678,
"upload_time": "2024-06-10T07:39:15",
"upload_time_iso_8601": "2024-06-10T07:39:15.142729Z",
"url": "https://files.pythonhosted.org/packages/a8/82/85c2833eb386bcd11d93412e1e0b0adc9b5e156da8716c8e1d9fd5e4cd78/rr_infinigen-1.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-10 07:39:15",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "rr-infinigen"
}
