Skip to content

Commit 9cd4069

Browse files
beltegeusebeltegeuse
committed
initial commit with clean code version.
1 parent 4fdb10f commit 9cd4069

File tree

1,420 files changed

+455811
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,420 files changed

+455811
-0
lines changed

‎.gitignore

+57
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Documentation
2+
doc/apidocs/*
3+
doc/*.aux
4+
doc/*.log
5+
doc/*.out
6+
doc/*.toc
7+
doc/*.bbl
8+
doc/*.blg
9+
doc/main.pdf
10+
doc/plugins_generated.tex
11+
12+
# Build-related
13+
.sconf_temp
14+
build/release
15+
build/debug
16+
debian
17+
.sconsign.dblite
18+
config.py
19+
config.log
20+
*.pyc
21+
22+
# MSVC++-related
23+
build/mitsuba-msvc2010.sdf
24+
build/mitsuba-msvc2010.suo
25+
build/mitsuba-msvc2010.vcxproj.user
26+
data/windows/mitsuba_res.res
27+
dist
28+
build/mitsuba-msvc2010.v12.suo
29+
build/mitsuba-msvc2010.opensdf
30+
31+
# Debugging history files
32+
\.gdb_history
33+
34+
# Dependencies
35+
dependencies
36+
37+
# OSX binaries and byproducts
38+
Mitsuba.app
39+
.DS_Store
40+
41+
# Imported geometry and some default output types
42+
/meshes
43+
/textures
44+
mitsuba.*.log
45+
*.exr
46+
47+
# Eclipse CDT project files
48+
.externalToolBuilders
49+
.settings
50+
.cproject
51+
.project
52+
/.idea/
53+
/cmake-build-debug/
54+
/cmake-build-release/
55+
/.vscode/
56+
/cmake-build-debug-default-7/
57+
/cmake-build-release-default-7/

‎CMakeLists.txt

+205
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,205 @@
1+
# Experimental CMake file for Mitusba
2+
# Tested only on Windows and Linux (Ubuntu 10.10)
3+
cmake_minimum_required(VERSION 2.8.3 FATAL_ERROR)
4+
5+
# Internal variable to know whether this is the first time CMake runs
6+
if (NOT DEFINED MTS_CMAKE_INIT)
7+
set(MTS_CMAKE_INIT ON CACHE INTERNAL "Is this the initial CMake run?")
8+
else()
9+
set(MTS_CMAKE_INIT OFF CACHE INTERNAL "Is this the initial CMake run?")
10+
endif()
11+
12+
# Allow to override the default project name "mitsuba"
13+
if (NOT DEFINED MTS_PROJECT_NAME)
14+
set(MTS_PROJECT_NAME "mitsuba")
15+
endif()
16+
project(${MTS_PROJECT_NAME})
17+
18+
# Tell cmake where to find the additional modules
19+
list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/data/cmake")
20+
# Make sure the cmake-provided modules use the versions they expect
21+
if(NOT CMAKE_VERSION VERSION_LESS "2.8.4")
22+
cmake_policy(SET CMP0017 NEW)
23+
endif()
24+
25+
# Enable folders for projects in Visual Studio
26+
if (CMAKE_GENERATOR MATCHES "Visual Studio")
27+
set_property(GLOBAL PROPERTY USE_FOLDERS ON)
28+
endif()
29+
30+
# Remove Debug from CMAKE_CONFIGURATION_TYPES as the dependencies do not contain the necessary debug libraries
31+
if(MSVC AND CMAKE_CONFIGURATION_TYPES)
32+
set(CMAKE_CONFIGURATION_TYPES Release MinSizeRel RelWithDebInfo)
33+
set(CMAKE_CONFIGURATION_TYPES "${CMAKE_CONFIGURATION_TYPES}" CACHE STRING
34+
"Remove Debug from available configuration types"
35+
FORCE)
36+
endif()
37+
38+
39+
# make config 'RelWithDebInfo' debuggable by disabling optimizations
40+
if(MSVC)
41+
# /MD link against release libs, /Od disable optimizations, /Ob0
42+
if(CMAKE_C_FLAGS_RELWITHDEBINFO MATCHES "/O2")
43+
string(REGEX REPLACE "/O2" "/Od" CMAKE_C_FLAGS_RELWITHDEBINFO "${CMAKE_C_FLAGS_RELWITHDEBINFO}")
44+
endif()
45+
if(CMAKE_CXX_FLAGS_RELWITHDEBINFO MATCHES "/O2")
46+
string(REGEX REPLACE "/O2" "/Od" CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO}")
47+
endif()
48+
if(CMAKE_C_FLAGS_RELWITHDEBINFO MATCHES "/Ob1")
49+
string(REGEX REPLACE "/Ob1" "/Ob0" CMAKE_C_FLAGS_RELWITHDEBINFO "${CMAKE_C_FLAGS_RELWITHDEBINFO}")
50+
endif()
51+
if(CMAKE_CXX_FLAGS_RELWITHDEBINFO MATCHES "/Ob1")
52+
string(REGEX REPLACE "/Ob1" "/Ob0" CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO}")
53+
endif()
54+
set(CMAKE_C_FLAGS_RELWITHDEBINFO "${CMAKE_C_FLAGS_RELWITHDEBINFO} /RTC1")
55+
set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO} /RTC1")
56+
list(REMOVE_DUPLICATES CMAKE_C_FLAGS_RELWITHDEBINFO)
57+
list(REMOVE_DUPLICATES CMAKE_CXX_FLAGS_RELWITHDEBINFO)
58+
endif()
59+
60+
# Set CMAKE_BUILD_TYPE to Release by default
61+
if (MTS_CMAKE_INIT AND DEFINED CMAKE_BUILD_TYPE AND NOT CMAKE_BUILD_TYPE)
62+
set(CMAKE_BUILD_TYPE "Release" CACHE STRING
63+
"Choose the type of build, options are: Debug, Release, RelWithDebInfo, MinSizeRel." FORCE)
64+
endif()
65+
66+
# If we are on the cluster, change the base path
67+
if(MTS_CLUSTER_COMPILATION)
68+
# For Boost
69+
#set(BOOST_EXT "/software/CentOS-6/libraries/boost-1.57")
70+
#set(BOOST_EXT "/home/neodym60/renderers")
71+
set(BOOST_EXT "/home/u00068/dependencies")
72+
73+
set(BOOST_ROOT "${BOOST_EXT}")
74+
set(BOOST_LIBRARYDIR "${BOOST_EXT}/lib")
75+
set(Boost_NO_SYSTEM_PATHS ON)
76+
set(BOOST_INCLUDEDIR "${BOOST_EXT}/include")
77+
78+
# For Xerces
79+
set(XERCES_ROOT_DIR /home/u00068/dependencies)
80+
set(EIGEN_ROOT_DIR /home/u00068/dependencies)
81+
set(Eigen_INCLUDE_DIR /home/u00068/dependencies/include)
82+
set(EXTERNAL_ROOT_DIR /home/u00068/dependencies)
83+
set(GLEW_ROOT_DIR /home/u00068/dependencies)
84+
endif()
85+
86+
# Load the required modules
87+
include (MitsubaUtil)
88+
include (MtsGetVersionInfo)
89+
include (CheckCXXSourceCompiles)
90+
include (CMakeDependentOption)
91+
92+
# Read the version information
93+
MTS_GET_VERSION_INFO()
94+
#if (MTS_HAS_VALID_REV)
95+
# message(STATUS "mitsuba ${MTS_VERSION}-hg${MTS_REV_ID} (${MTS_DATE})")
96+
#else()
97+
# message(STATUS "mitsuba ${MTS_VERSION} (${MTS_DATE})")
98+
#endif()
99+
100+
# Setup the build options
101+
include (MitsubaBuildOptions)
102+
103+
# Find the external libraries and setup the paths
104+
include (MitsubaExternal)
105+
106+
# Main mitsuba include directory
107+
include_directories("include")
108+
109+
# ===== Prerequisite resources =====
110+
111+
# Process the XML schemas
112+
add_subdirectory(data/schema)
113+
# Add the IOR database
114+
add_subdirectory(data/ior)
115+
# Microfacet precomputed data
116+
add_subdirectory(data/microfacet)
117+
118+
119+
# ===== Build the support libraries ====
120+
121+
# Core support library
122+
add_subdirectory(src/libcore)
123+
# Rendering-related APIs
124+
add_subdirectory(src/librender)
125+
# Hardware acceleration
126+
add_subdirectory(src/libhw)
127+
# Bidirectional support library
128+
add_subdirectory(src/libbidir)
129+
# Python binding library
130+
if (BUILD_PYTHON)
131+
add_subdirectory(src/libpython)
132+
elseif(NOT PYTHON_FOUND)
133+
message(STATUS "Python was not found. The bindings will not be built.")
134+
endif()
135+
136+
137+
# Additional files to add to main executables
138+
if(APPLE)
139+
set(MTS_DARWIN_STUB "${CMAKE_CURRENT_SOURCE_DIR}/src/mitsuba/darwin_stub.mm")
140+
set(MTS_WINDOWS_STUB "")
141+
elseif(WIN32)
142+
set(MTS_DARWIN_STUB "")
143+
set(MTS_WINDOWS_STUB "${CMAKE_CURRENT_SOURCE_DIR}/data/windows/wmain_stub.cpp")
144+
else()
145+
set(MTS_DARWIN_STUB "")
146+
set(MTS_WINDOWS_STUB "")
147+
endif()
148+
149+
150+
# ===== Build the applications =====
151+
152+
# Build the command-line binaries
153+
add_subdirectory(src/mitsuba)
154+
155+
# Build the COLLADA converter
156+
if (COLLADA_FOUND)
157+
add_subdirectory(src/converter)
158+
else()
159+
message(STATUS "Collada DOM was not found. The importer will not be built.")
160+
endif()
161+
162+
# Build the Qt-based GUI binaries
163+
if (BUILD_GUI)
164+
add_subdirectory(src/mtsgui)
165+
endif()
166+
167+
168+
# ===== Build the plugins =====
169+
170+
# Utilities
171+
add_subdirectory(src/utils)
172+
# Surface scattering models
173+
add_subdirectory(src/bsdfs)
174+
# Phase functions
175+
add_subdirectory(src/phase)
176+
# Intersection shapes
177+
add_subdirectory(src/shapes)
178+
# Sample generators
179+
add_subdirectory(src/samplers)
180+
# Reconstruction filters
181+
add_subdirectory(src/rfilters)
182+
# Film implementations
183+
add_subdirectory(src/films)
184+
# Sensors
185+
add_subdirectory(src/sensors)
186+
# Emitters
187+
add_subdirectory(src/emitters)
188+
# Participating media
189+
add_subdirectory(src/medium)
190+
# Volumetric data sources
191+
add_subdirectory(src/volume)
192+
# Sub-surface integrators
193+
add_subdirectory(src/subsurface)
194+
# Texture types
195+
add_subdirectory(src/textures)
196+
# Integrators
197+
add_subdirectory(src/integrators)
198+
# Testcases
199+
add_subdirectory(src/tests)
200+
201+
202+
# ===== Packaging =====
203+
204+
# Use a subdirectory to enforce that packaging runs after all other targets
205+
add_subdirectory(data/cmake/packaging)

‎README.md

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
Light Transport Simulation in the Gradient Domain
2+
-------------------------------------------------------------------------
3+
4+
![](http://beltegeuse.s3-website-ap-northeast-1.amazonaws.com/research/2018_GradientCourse/img/teaser.jpg)
5+
6+
Light transport simulation in the gradient domain is an efficient family of Monte Carlo rendering techniques that can converge a few times faster than standard Monte Carlo rendering. The basic idea of gradient-domain rendering is to first efficiently sample the horizontal and vertical gradient images in addition to the standard Monte Carlo rendering. The final image can be reconstructed from the gradients by solving an image-space Poisson problem. The final image can be seen as a denoised result of standard Monte Carlo rendering.
7+
8+
This repository contains several gradient-domain light transport simulation algorithms. It derives Mitsuba 0.5.0 and includes the gradient domain implementation of path tracing, bidirectional path tracing, photon mapping, vertex connection and merging. It also supports rendering participating media with volumetric photon mapping, beam radiance estimates, photon beams, and planes. The repository is made to support the course [Light Transport Simulation in the Gradient Domain](http://beltegeuse.s3-website-ap-northeast-1.amazonaws.com/research/2018_GradientCourse/) in SIGGRAPH Asia 2018.
9+
10+
In case of problems/questions/comments don't hesitate to contact us
11+
directly: [email protected] or [email protected].
12+
13+
Integrators
14+
-----------
15+
16+
This code includes several integrators originally implemented by many other researchers:
17+
- [Gradient-domain path tracing](https://github.com/mmanzi/gradientdomain-mitsuba) (SIGGRAPH 2015)
18+
- [Gradient-domain bidirectional path tracing](https://github.com/mmanzi/gradientdomain-mitsuba) (EGSR 2015)
19+
- [Gradient-domain photon density estimation](https://github.com/gradientpm/gpm) (Eurographics 2017)
20+
- [Gradient-domain vertex connection and merging](https://github.com/sunweilun/Mitsuba) (EGSR 2017)
21+
- [Gradient-domain volume photon density estimation](https://github.com/gradientpm/gvpm) (SIGGRAPH 2018)
22+
23+
The code is located in the `src/integrator/gradient` folder.
24+
25+
Image reconstruction
26+
--------------------
27+
For image reconstruction, it includes:
28+
- [L1 and L2 reconstruction](https://github.com/mmanzi/gradientdomain-mitsuba)
29+
- [Uniform and weighted reconstruction based on control variates](https://cs.dartmouth.edu/~wjarosz/publications/rousselle16image.html) (SIGGRAPH Asia 2016)
30+
31+
Currently, weighted reconstruction only supports gradient-domain path tracing. This reconstruction requires an estimate of the variance of the pixel value and its gradients. The support for other algorithms requires some extensions of this variance estimates which we temporarily leave as future work.
32+
33+
Denoisers
34+
---------
35+
To support the comparison of gradient-domain image reconstruction with Monte Carlo denoising techniques, the code also includes two popular denoising techniques:
36+
- [Nonlinearly Weighted First-order Regression for Denoising Monte Carlo Renderings (NFOR)](https://benedikt-bitterli.me/nfor/) (EGSR 2016)
37+
- [Bayesian Collaborative Denoising for Monte Carlo Rendering (BCD)](https://perso.telecom-paristech.fr/boubek/papers/BCD/) (EGSR 2017)
38+
39+
Currently, this two denoisers are only compatible with path tracing. They require the auxilary buffer (NFOR) or samples histograms (BCD).
40+
41+
Troubleshooting
42+
---------------
43+
- Make sure that the config.py files use DOUBLE_PRECISON flag instead
44+
of SINGLE_PRECISION since the current implementation of gradient-domain rendering is quite sensitive to floating point precision. This will hopefully be fixed at a later time.
45+
46+
Change logs
47+
-----------
48+
49+
2018/11/29: Initial code release
50+
51+
52+
License
53+
-------
54+
55+
This code is released under the GNU General Public License (version 3).
56+
57+
This source code includes the following open source implementations:
58+
59+
- Screened Poisson reconstruction code from NVIDIA, released under the new BSD license.
60+
- Mitsuba 0.5.0 by Wenzel Jakob, released under the GNU General Public License (version 3).
61+
- A small part of [Tungsten](https://github.com/tunabrain/tungsten) by Benedikt Bitterli.

0 commit comments

Comments
 (0)