#include <ImFusion/CT/Geometry/GeometryGenerator.h>

Base class for X-ray geometry generators. More...

Inheritance diagram for ImFusion::CT::GeometryGenerator:

Detailed Description

Base class for X-ray geometry generators.

Generators compute and apply geometric parameters to cone-beam projection data.

Generators have two main tasks:

Compute the full geometry representation for each frame in the SharedImageSet from a given representation within the generator. E.g. from a parametric description.
Fit a representation to the geometry of a given SharedImageSet. For this purpose the generator needs to provide a constructor that takes a SharedImageSet as input.

Full geometry includes source/detector positions and world-to-detector transforms.

Note: Implementations must provide constructor accepting SharedImageSet input.

Public Member Functions
	GeometryGenerator (const SharedImageSet &sis)
void	configuration (Properties *p) const override
	Serialize the current object configuration into the given Properties object.
std::vector< GeometryUtils::FullGeometryRepresentation >	computeFullGeometryRepresentation (const SharedImageSet &sis) const
	Compute the full geometry representation for all frames in the SharedImageSet.
GeometryUtils::FullGeometryRepresentation	computeFullGeometryRepresentation (const SharedImageSet &sis, int frame) const
	Compute the full geometry representation for a single frame in the SharedImageSet.
virtual std::unique_ptr< GeometryGenerator >	clone () const =0
	Factory method to create a clone of the generator.
virtual std::string	id () const =0
	Provides a unique identifier for the generator.
std::unique_ptr< ParameterWrapperBase >	createParameterWrapper (SharedImageSet &sis) const
	Generates a ParameterWrapperBase for the generator.
bool	operator== (const GeometryGenerator &other)
	Compares members for equality.
Public Member Functions inherited from ImFusion::Configurable
virtual void	configure (const Properties *p)
	Configure this object instance by de-serializing the given Properties.
virtual void	configureDefaults ()
	Retrieve the properties of this object, replaces values with their defaults and sets it again.
void	registerParameter (ParameterBase *param)
	Register the given Parameter or SubProperty, so that it will be configured during configure()/configuration().
void	unregisterParameter (const ParameterBase *param)
	Remove the given Parameter or SubProperty from the list of registered parameters.
	Configurable (const Configurable &rhs)
	Configurable (Configurable &&rhs) noexcept
Configurable &	operator= (const Configurable &)
Configurable &	operator= (Configurable &&) noexcept

Additional Inherited Members
Public Attributes inherited from ImFusion::Configurable
Signal	signalParametersChanged
	Emitted whenever one of the registered Parameters' or SubPropertys' signalValueChanged signal was emitted.
Protected Attributes inherited from ImFusion::Configurable
std::vector< Param >	m_params
	List of all registered Parameter and SubProperty instances.

Member Function Documentation

◆ configuration()

void ImFusion::CT::GeometryGenerator::configuration ( Properties * p ) const

overridevirtual

Serialize the current object configuration into the given Properties object.

The default implementation will do so automatically for all registered Parameter and SubProperty instances.

See also: configure() for the inverse functionality

Reimplemented from ImFusion::Configurable.

Reimplemented in ImFusion::CT::detail::PerFrameTransformationGeneratorBase, ImFusion::CT::MotionModelGenerator, and ImFusion::CT::SnapshotGenerator.

◆ computeFullGeometryRepresentation() [1/2]

std::vector< GeometryUtils::FullGeometryRepresentation > ImFusion::CT::GeometryGenerator::computeFullGeometryRepresentation ( const SharedImageSet & sis ) const

Compute the full geometry representation for all frames in the SharedImageSet.

Parameters

sis	The SharedImageSet to compute the geometry for.

Returns: A vector of FullGeometryRepresentation for each frame in the SharedImageSet.

Note: Can utilize DetectorDataComponent::p_persistentIndex to keep track of the original index of the frame.; The implementation calls computeFullGeometryRepresentation(const SharedImageSet&, int) for each frame.

◆ computeFullGeometryRepresentation() [2/2]

GeometryUtils::FullGeometryRepresentation ImFusion::CT::GeometryGenerator::computeFullGeometryRepresentation	(	const SharedImageSet &	sis,
		int	frame ) const

Compute the full geometry representation for a single frame in the SharedImageSet.

Parameters

sis	The SharedImageSet to compute the geometry for.
frame	The frame to compute the geometry for.

Returns: The FullGeometryRepresentation for the given frame.

◆ clone()

virtual std::unique_ptr< GeometryGenerator > ImFusion::CT::GeometryGenerator::clone ( ) const

pure virtual

Factory method to create a clone of the generator.

Implemented in ImFusion::CT::MotionModelGenerator, ImFusion::CT::ParametricGeometryGenerator, ImFusion::CT::RelativeGlobalTransformationGenerator, ImFusion::CT::RelativePerFrameTransformationGenerator, and ImFusion::CT::SnapshotGenerator.

◆ id()

virtual std::string ImFusion::CT::GeometryGenerator::id ( ) const

pure virtual

Provides a unique identifier for the generator.

Implemented in ImFusion::CT::MotionModelGenerator, ImFusion::CT::ParametricGeometryGenerator, ImFusion::CT::RelativeGlobalTransformationGenerator, ImFusion::CT::RelativePerFrameTransformationGenerator, and ImFusion::CT::SnapshotGenerator.

◆ createParameterWrapper()

std::unique_ptr< ParameterWrapperBase > ImFusion::CT::GeometryGenerator::createParameterWrapper ( SharedImageSet & sis ) const

Generates a ParameterWrapperBase for the generator.

Note: Considers selection

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

ImFusion/CT/Geometry/GeometryGenerator.h