Skip to main content

CERES Ray Tracer

Project description

CERES Ray Tracer (CRT)

PyPI version GitHub Release GitHub issues GitHub Contributers License: MIT Size

This project was developed as part of CERES and aims to provide scientifically useful path tracing capabilities for rendering images, simulating LiDAR, modeling radiation pressure, and flux computations for thermal and solar panel analysis.

Available Environments

Linux

Environment Build Python Binding Install from PyPI
Ubuntu 22.04

Ubuntu 20.04

Ubuntu 18.04


Installation:

It is recommended to install directly from the Python Package Index (PyPI):

pip install ceres-raytracer

Building from Source:

git clone https://github.com/ceres-navigation/ceres-raytracer.git
pip install .

sphinx is used to build documentation for the python API. To install sphinx, simply use:

sudo apt-get install python3-sphinx
pip install sphinx-autodoc-typehints sphinx-toolbox sphinx-licenseinfo sphinx-rtd-theme

Once sphinx is installed, you can build the documentation on Linux systems by running:

cd doc
make html

Demos:

After installing ceres-raytracer, simply clone the ceres-raytracer-demos:

git clone https://github.com/ceres-navigation/ceres-raytracer-demos.git

and run any of the included .py example files:

cornel_box.py

This demo script demonstrates multi-bounce path tracing using the traditional cornell box scene. It additionally shows how to render depth, instances and normal passes:

comet67p.py

This demo script demonstrates how to use CRT's SPICE support, and rendering in a body fixed frame (allowing for the BVH to be cached and therefore overall faster render times):


Tasks:

  • Python Interface
    • Python bindings with pybind11
    • Binary distributions (cross compiled for Windows/MacOS on Linux)
    • Python defined materials (compatible only with wavefront ray tracing)
  • Path tracing implementations
    • Adaptive sampling
    • Wavefront ray tracing
    • Bidirectional path tracing
    • Primary Sample Space Metropolis Light Transport
  • Physics
    • Polarization of light rays
    • Wavelength of light rays
    • Spectral power density of rays
    • Physically based radiance tracking for paths
    • Momentum of paths
  • Materials
    • PBR Texture support
    • Hapke function support
    • Microfacet support
  • Major architecture changes
    • TBB for parallelization
    • Add Embree single precision support
    • Add OptiX (GPU) single precision support
    • Add Vulkan (GPU) single precision support

Attributions

madmann91's Modern C++ BVH Construction and Traversal Library

This project utilizes a BVH construction and traversal library built by madmann91. While we have made some modifications to their implementation, their work forms most of the basis of the bounding volume hierarchy used in this project. Their originally source code can be found in the bvh repository

National Science Foundation Graduate Research Fellowship

This material is based upon work supported by the National Science Foundation Graduate Research Fellowship under Grant No. 2020305048. NSF GRFP gave Chris Gnam the flexibility and resources required to complete his research in spacecraft navigation, and this project is meant to serve as an open source implementation of his dissertation.


Contact

All questions, comments, and concerns should be directed to Chris Gnam: crgnam@buffalo.edu

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ceres-raytracer-0.6a4.tar.gz (230.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page