Skip to content

Tarawally/fluid-light-transport

Repository files navigation

Fluid Light Transport

A hybrid simulation engine that treats light as a fluid. It uses stochastic ray tracing to inject photons into a grid, then propagates energy using cellular automata to create soft shadows and organic colour bleeding in real-time.

This repository unifies the application with its technical documentation.

Quick Start

Ensure you have Node.js and the Quarto CLI installed.

# Clone and install
git clone https://github.com/Tarawally/fluid-light-transport.git
cd fluid-light-transport
npm install

# Launch the interactive walkthrough & simulation
quarto preview

Highlights

  • Hybrid Engine: Combines ray tracing with fluid dynamics for efficient global illumination.
  • Interactive Documentation: A "docs-as-code" walkthrough built with Quarto, featuring live simulation widgets and annotated source code.
  • Tested Core: Fundamental mathematics validated with Vitest.

Navigation

  • Simulation: The standalone full-screen engine.
  • Tutorial: A guided tour of the architecture.
  • API Reference: Auto-generated documentation from src/engine.js.

License

MIT

About

A cellular automata fluid-based model for real-time global illumination.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors