Veach-style multi-chain perturbation strategy. More...

#include <mitsuba/bidir/mut_mchain.h>

Inheritance diagram for mitsuba::MultiChainPerturbation:

Public Member Functions
	MultiChainPerturbation (const Scene scene, Sampler sampler, MemoryPool &pool, Float minJump, Float coveredArea)
	Construct a new lens perturbation strategy. More...

virtual const Class *	getClass () const
	Retrieve this object's class. More...

Implementation of the Mutator interface
EMutationType	getType () const
	What kind of mutations does this mutator perform? More...

Float	suitability (const Path &path) const
	Determine the general "suitability" of this mutator for a given kind of path. More...

bool	sampleMutation (Path &source, Path &proposal, MutationRecord &muRec, const MutationRecord &sourceMuRec)
	Given a path, this function produces a new proposal according to the internally implemented mutation strategy. More...

Float	Q (const Path &source, const Path &proposal, const MutationRecord &muRec) const
	For a pair of paths, this function computes the inverse transition probability (matching the Q term in [Veach 97]) More...

void	accept (const MutationRecord &muRec)
	Record an accepted mutation. More...

Public Member Functions inherited from Object
	Object ()
	Construct a new object. More...

int	getRefCount () const
	Return the current reference count. More...

void	incRef () const
	Increase the reference count of the object by one. More...

void	decRef (bool autoDeallocate=true) const
	Decrease the reference count of the object and possibly deallocate it. More...

virtual std::string	toString () const
	Return a human-readable string representation of the object's contents. More...

Static Public Attributes
static Class *	m_theClass

Static Public Attributes inherited from mitsuba::MutatorBase
static Class *	m_theClass

Static Public Attributes inherited from mitsuba::Mutator
static Class *	m_theClass

Static Public Attributes inherited from Object
static Class *	m_theClass
	Pointer to the object's class descriptor. More...

Protected Member Functions
virtual	~MultiChainPerturbation ()
	Virtual destructor. More...

Protected Member Functions inherited from mitsuba::MutatorBase
	MutatorBase ()
	Protected constructor. More...

virtual	~MutatorBase ()
	Virtual destructor. More...

Float	perturbMediumDistance (Sampler sampler, const PathVertex vertex)
	Perturb a distance within a medium. More...

Float	pdfMediumPerturbation (const PathVertex oldVertex, const PathEdge oldEdge, const PathEdge *newEdge) const
	Density function of perturbMediumDistance. More...

Protected Member Functions inherited from mitsuba::Mutator
virtual	~Mutator ()
	Virtual destructor. More...

Protected Member Functions inherited from Object
virtual	~Object ()
	Virtual private deconstructor. (Will only be called by ref) More...

Protected Attributes
ref< const Scene >	m_scene

ref< Sampler >	m_sampler

MemoryPool &	m_pool

Vector2	m_filmRes

Float	m_r1

Float	m_r2

Float	m_theta1

Float	m_theta2

Float	m_logRatio

Float	m_thetaLogRatio

Float	m_imagePlaneArea

Float	m_mediumConcentration

Protected Attributes inherited from mitsuba::MutatorBase
Float	m_mediumDensityMultiplier

Additional Inherited Members
Public Types inherited from mitsuba::Mutator
enum	EMutationType { EBidirectionalMutation = 0, ELensPerturbation, ELensSubpathMutation, EIndependentMutation, ECausticPerturbation, EMultiChainPerturbation, EManifoldPerturbation, EMutationTypeCount }
	Specifies the type of mutation implemented by the mutator. More...

Static Public Member Functions inherited from Object
static void	staticInitialization ()
	Initializes the built-in reference count debugger (if enabled) More...

static void	staticShutdown ()
	Free the memory taken by staticInitialization() More...

Detailed Description

Veach-style multi-chain perturbation strategy.

This class implements a simple multi-chain perturbation strategy as described in Eric Veach's PhD thesis.

Author: Wenzel Jakob

Constructor & Destructor Documentation

mitsuba::MultiChainPerturbation::MultiChainPerturbation	(	const Scene *	scene,
		Sampler *	sampler,
		MemoryPool &	pool,
		Float	minJump,
		Float	coveredArea
	)

Construct a new lens perturbation strategy.

Parameters

scene	A pointer to the underlying scene
sampler	A sample generator
pool	A memory pool used to allocate new path vertices and edges
minJump	Minimum jump distance in fractional pixel coordinates
coveredArea	Approximate fractional image plane area that is reachable using the lens perturbation

virtual mitsuba::MultiChainPerturbation::~MultiChainPerturbation ( )

protectedvirtual

Virtual destructor.

Member Function Documentation

void mitsuba::MultiChainPerturbation::accept ( const MutationRecord & muRec )

virtual

Record an accepted mutation.

This function exists to allow mutators to track their acceptance rate and other statistics.

Implements mitsuba::Mutator.

virtual const Class* mitsuba::MultiChainPerturbation::getClass ( ) const

virtual

Retrieve this object's class.

Reimplemented from mitsuba::MutatorBase.

EMutationType mitsuba::MultiChainPerturbation::getType ( ) const

virtual

What kind of mutations does this mutator perform?

Implements mitsuba::Mutator.

Float mitsuba::MultiChainPerturbation::Q	(	const Path &	source,
		const Path &	proposal,
		const MutationRecord &	muRec
	)		const

virtual

For a pair of paths, this function computes the inverse transition probability (matching the Q term in [Veach 97])

Parameters

source	A path data structure containing the original path
proposal	A path data structure containing the proposed mutated path
muRec	Data record that describes the mutation strategy, which transformed `source` to `proposal`.

Implements mitsuba::Mutator.

bool mitsuba::MultiChainPerturbation::sampleMutation	(	Path &	source,
		Path &	proposal,
		MutationRecord &	muRec,
		const MutationRecord &	sourceMuRec
	)

virtual

Given a path, this function produces a new proposal according to the internally implemented mutation strategy.

Parameters

source	The sampling strategy implemented by the mutator will condition on this path.
proposal	Path data structure to be filled with the proposed mutated path
muRec	Data record that describes the sampled mutation strategy
sourceMuRec	Data record that describes the last successful mutation strategy (for the source path)

Returns: true upon success. When the sampling step is unsuccessful (this could happen due to various reasons), the function returns false.

Implements mitsuba::Mutator.

Float mitsuba::MultiChainPerturbation::suitability ( const Path & path ) const

virtual

Determine the general "suitability" of this mutator for a given kind of path.

Implements mitsuba::Mutator.

Member Data Documentation

Vector2 mitsuba::MultiChainPerturbation::m_filmRes

protected

Float mitsuba::MultiChainPerturbation::m_imagePlaneArea

protected

Float mitsuba::MultiChainPerturbation::m_logRatio

protected

Float mitsuba::MultiChainPerturbation::m_mediumConcentration

protected

MemoryPool& mitsuba::MultiChainPerturbation::m_pool

protected

Float mitsuba::MultiChainPerturbation::m_r1

protected

Float mitsuba::MultiChainPerturbation::m_r2

protected

ref<Sampler> mitsuba::MultiChainPerturbation::m_sampler

protected

ref<const Scene> mitsuba::MultiChainPerturbation::m_scene

protected

Class* mitsuba::MultiChainPerturbation::m_theClass

static

Float mitsuba::MultiChainPerturbation::m_theta1

protected

Float mitsuba::MultiChainPerturbation::m_theta2

protected

Float mitsuba::MultiChainPerturbation::m_thetaLogRatio

protected

The documentation for this class was generated from the following file:

include/mitsuba/bidir/mut_mchain.h

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation