OpenWalnut
1.5.0dev
|
Traces a given set of deterministic tracts as given by a dataset of deterministic tracts (optionally only a subset may be processed) in a voxel-wise manner. More...
#include <WMVoxelizer.h>
Public Member Functions | |
WMVoxelizer () | |
Default Constructor. More... | |
virtual | ~WMVoxelizer () |
Default Destructor. More... | |
virtual const std::string | getName () const |
Gives back the name of this module. More... | |
virtual const std::string | getDescription () const |
Gives back a description of this module. More... | |
virtual std::shared_ptr< WModule > | factory () const |
Due to the prototype design pattern used to build modules, this method returns a new instance of this method. More... | |
Public Member Functions inherited from WModule | |
WModule () | |
Constructs a new WModule instance. More... | |
virtual | ~WModule () |
Destructor. More... | |
const InputConnectorList & | getInputConnectors () const |
Gives back input connectors. More... | |
std::shared_ptr< WModuleInputConnector > | getInputConnector (std::string name) |
Finds the named connector for the module. More... | |
std::shared_ptr< WModuleInputConnector > | findInputConnector (std::string name) |
Finds the named connector for the module. More... | |
const OutputConnectorList & | getOutputConnectors () const |
Gives back output connectors. More... | |
std::shared_ptr< WModuleOutputConnector > | getOutputConnector (std::string name) |
Finds the named connector for the module. More... | |
std::shared_ptr< WModuleOutputConnector > | findOutputConnector (std::string name) |
Finds the named connector for the module. More... | |
std::shared_ptr< WModuleConnector > | getConnector (std::string name) |
Finds the named connector for the module. More... | |
std::shared_ptr< WModuleConnector > | findConnector (std::string name) |
Finds the named connector for the module. More... | |
std::shared_ptr< WProperties > | getProperties () const |
Return a pointer to the properties object of the module. More... | |
std::shared_ptr< WProperties > | getInformationProperties () const |
Return a pointer to the information properties object of the module. More... | |
const WBoolFlag & | isInitialized () const |
Determines whether the module instance is properly initialized. More... | |
const WBoolFlag & | isUseable () const |
Checks whether the module instance is ready to be used. More... | |
const WBoolFlag & | isAssociated () const |
Checks whether this module is associated with an container. More... | |
const WBoolFlag & | isReady () const |
Checks whether this module is ready. More... | |
const WBoolFlag & | isReadyOrCrashed () const |
This is the logical or of isReady and isCrashed. More... | |
const WBoolFlag & | isRunning () const |
Returns a flag denoting whether the thread currently is running or nor. More... | |
void | waitRestored () |
This method waits for the module to be restored completely. More... | |
bool | isRestoreNeeded () const |
Check whether this module is in restore mode. More... | |
void | setRestoreNeeded (bool restore=true) |
Change the restore mode. More... | |
void | reportRestoreComplete () |
Called by loaders to tell the module that loading has been completed. More... | |
std::shared_ptr< WModuleContainer > | getAssociatedContainer () const |
The container this module is associated with. More... | |
virtual boost::signals2::connection | subscribeSignal (MODULE_SIGNAL signal, t_ModuleGenericSignalHandlerType notifier) |
Connects a specified notify function with a signal this module instance is offering. More... | |
virtual boost::signals2::connection | subscribeSignal (MODULE_SIGNAL signal, t_ModuleErrorSignalHandlerType notifier) |
Connects a specified notify function with a signal this module instance is offering. More... | |
virtual std::shared_ptr< WProgressCombiner > | getRootProgressCombiner () |
Gets the modules base progress. More... | |
virtual const char ** | getXPMIcon () const |
Get the icon for this module in XPM format. More... | |
virtual MODULE_TYPE | getType () const |
Gets the type of the module. More... | |
void | disconnect () |
Completely disconnects all connected connectors of this module. More... | |
WCombinerTypes::WDisconnectList | getPossibleDisconnections () |
Gives a list of all WDisconnectCombiners possible. More... | |
boost::filesystem::path | getLocalPath () const |
Returns the local path of the module. More... | |
boost::filesystem::path | getLibPath () const |
Returns the absolute path to the library containing this module. More... | |
std::string | getPackageName () const |
Returns the name of the package the module belongs to, The package name basically is the name of the library containing this and maybe other modules. More... | |
bool | isDeprecated () const |
Checks whether the module was marked as deprecated. More... | |
std::string | getDeprecationMessage () const |
Queries the deprecation message of a module if specified. More... | |
virtual WModuleMetaInformation::ConstSPtr | getMetaInformation () const |
The meta information of this module. More... | |
const std::string & | getUUID () const |
Get the UUID of the module instance. More... | |
WPropString | getRuntimeName () const |
Returns the name the user has given this module. More... | |
const WRequirement * | checkRequirements () const |
This method checks whether all the requirements of the module are complied. More... | |
virtual boost::signals2::connection | subscribeSignal (THREAD_SIGNAL signal, t_ThreadErrorSignalHandlerType notifier) |
Connects a specified notify function with a signal this thread instance is offering. More... | |
Public Member Functions inherited from WThreadedRunner | |
WThreadedRunner () | |
Default constructor. More... | |
virtual | ~WThreadedRunner () |
Destructor. More... | |
virtual void | run () |
Run thread. More... | |
void | run (THREADFUNCTION f) |
Run thread. More... | |
void | wait (bool requestFinish=false) |
Wait for the thread to be finished. More... | |
virtual void | requestStop () |
This method's purpose is to request a stop without waiting for it. More... | |
virtual boost::signals2::connection | subscribeSignal (THREAD_SIGNAL signal, t_ThreadErrorSignalHandlerType notifier) |
Connects a specified notify function with a signal this thread instance is offering. More... | |
const WBoolFlag & | isCrashed () const |
Checks whether this thread has been crashed. More... | |
const std::string & | getCrashMessage () const |
Get the message of the exception finally causing the crash. More... | |
void | setThreadName (std::string name) |
Set the name of the thread. More... | |
std::string | getThreadName () const |
Returns the current thread name. More... | |
Public Member Functions inherited from WPrototyped | |
WPrototyped () | |
Default constructor. More... | |
virtual | ~WPrototyped () |
Destructor. More... | |
template<typename T > | |
bool | isA () |
Checks whether the actual prototype has the specified runtime type. More... | |
Protected Member Functions | |
virtual void | moduleMain () |
Entry point after loading the module. More... | |
virtual void | connectors () |
Initialize the connectors this module is using. More... | |
virtual void | properties () |
Initialize the properties for this module. More... | |
boost::array< std::shared_ptr< WDataSetScalar >, 2 > | generateDatasets (std::shared_ptr< const WDataSetFibers > tracts, std::shared_ptr< const WFiberCluster > cluster) const |
Generates a intensity dataset where each tract is rasterized into. More... | |
void | updateCenterLine () |
Removes or inserts geode for the center line of the current cluster into this modules group node. More... | |
osg::ref_ptr< osg::Node > | genDataSetGeode (std::shared_ptr< WDataSetScalar > dataset) const |
Builds an OSG geode where all voxels inside the dataSet which are not zero are drawn as cuboids. More... | |
void | raster (std::shared_ptr< WRasterAlgorithm > algo, std::shared_ptr< const WDataSetFibers > tracts, std::shared_ptr< const WFiberCluster > cluster) const |
Performs rasterization with the given algorithm on either all tracts or only a subset if given. More... | |
WBoundingBox | createBoundingBox (const WFiberCluster &cluster) const |
Creates two vertices describing the bounding box of a cluster. More... | |
std::shared_ptr< WGridRegular3D > | constructGrid (std::shared_ptr< const WDataSetFibers > tracts, std::shared_ptr< const WFiberCluster > cluster) const |
Constructs a grid out of the current tract dataset or out of a subset (selection) of this dataset. More... | |
std::shared_ptr< WFiber > | longestLine (std::shared_ptr< const WDataSetFibers > tracts, std::shared_ptr< const WFiberCluster > cluster=std::shared_ptr< const WFiberCluster >()) const |
Finds and returns a copy of the longest line (in term of #points) in the dataset, or in a subset of it specified by the given cluster. More... | |
std::shared_ptr< WFiber > | centerLine (std::shared_ptr< const WDataSetFibers > tracts, std::shared_ptr< const WFiberCluster > cluster=std::shared_ptr< const WFiberCluster >()) const |
Finds and returns a copy of the center line in the dataset, or in a subset of it specified by the given cluster. More... | |
Protected Member Functions inherited from WModule | |
void | threadMain () |
Thread entry point. More... | |
virtual void | onThreadException (const WException &e) |
This method is called if an exception was caught, which came from the custom thread code. More... | |
void | setAssociatedContainer (std::shared_ptr< WModuleContainer > container) |
Sets the container this module is associated with. More... | |
virtual void | requirements () |
Initialize requirements in this function. More... | |
virtual std::string | deprecated () const |
This function allows module programmers to mark their modules deprecated in a user-friendly way. More... | |
void | initialize () |
Manages initialization. More... | |
virtual void | cleanup () |
Called whenever the module should shutdown. More... | |
void | addConnector (std::shared_ptr< WModuleInputConnector > con) |
Adds the specified connector to the list of inputs. More... | |
void | addConnector (std::shared_ptr< WModuleOutputConnector > con) |
Adds the specified connector to the list of outputs. More... | |
void | removeConnectors () |
Removes all connectors properly. More... | |
virtual void | activate () |
Callback for m_active. More... | |
virtual const t_GenericSignalHandlerType | getSignalHandler (MODULE_CONNECTOR_SIGNAL signal) |
Gives the signal handler function responsible for a given signal. More... | |
virtual void | notifyConnectionEstablished (std::shared_ptr< WModuleConnector > here, std::shared_ptr< WModuleConnector > there) |
Gets called whenever a connector gets connected to the specified input. More... | |
virtual void | notifyConnectionClosed (std::shared_ptr< WModuleConnector > here, std::shared_ptr< WModuleConnector > there) |
Gets called whenever a connection between a remote and local connector gets closed. More... | |
virtual void | notifyDataChange (std::shared_ptr< WModuleConnector > input, std::shared_ptr< WModuleConnector > output) |
Gets called when the data on one input connector changed. More... | |
void | ready () |
Call this whenever your module is ready and can react on property changes. More... | |
wlog::WStreamedLogger | infoLog () const |
Logger instance for comfortable info logging. More... | |
wlog::WStreamedLogger | debugLog () const |
Logger instance for comfortable debug logging. More... | |
wlog::WStreamedLogger | warnLog () const |
Logger instance for comfortable warning- logs. More... | |
wlog::WStreamedLogger | errorLog () const |
Logger instance for comfortable error logging. More... | |
void | setLocalPath (boost::filesystem::path path) |
Sets the local module path. More... | |
void | setLibPath (boost::filesystem::path path) |
Set the path to the library which contains this module. More... | |
void | setPackageName (std::string name) |
Set the package name. More... | |
Protected Member Functions inherited from WThreadedRunner | |
virtual void | notifyStop () |
Gets called when the thread should be stopped. More... | |
void | yield () const |
Give remaining execution timeslice to another thread. More... | |
void | sleep (const int32_t t) const |
Sets thread asleep. More... | |
void | msleep (const int32_t t) const |
Sets thread asleep. More... | |
void | waitForStop () |
Let the thread sleep until a stop request was given. More... | |
void | handleDeadlyException (const WException &e, std::string sender="WThreadedRunner") |
Handle the specified exception which was not caught in the thread, which basically means the thread has crashed. More... | |
Private Attributes | |
std::shared_ptr< WModuleInputData< const WDataSetFibers > > | m_tractIC |
Input connector for a fiber dataset. More... | |
std::shared_ptr< WModuleInputData< const WFiberCluster > > | m_clusterIC |
Input connector for an optional selection of some fibers in the fiber dataset via a cluster. More... | |
std::shared_ptr< WModuleOutputData< WDataSetScalar > > | m_voxelizedOC |
Output connector for a voxelized cluster. More... | |
std::shared_ptr< WModuleOutputData< WDataSetScalar > > | m_paramOC |
Output providing parameterization to other algorithms. More... | |
std::shared_ptr< const WDataSetFibers > | m_tracts |
Reference to the fiber dataset. More... | |
osg::ref_ptr< WGEManagedGroupNode > | m_rootNode |
OSG root node for this module. More... | |
std::shared_ptr< WCondition > | m_fullUpdate |
module is performing an expensive update More... | |
WPropBool | m_antialiased |
Enable/disable anti-aliased rasterization of voxels. More... | |
WPropBool | m_renderingActive |
Enable/disable rendering of voxels. More... | |
WPropSelection | m_rasterAlgo |
List for selecting the rasterization method. More... | |
WPropDouble | m_voxelsPerUnit |
The number of voxels per unit in the coordinate system. More... | |
std::shared_ptr< WItemSelection > | m_paramAlgoSelections |
The available parameterization algorithms. More... | |
WPropSelection | m_parameterAlgo |
The actually selected parameterization algorithm. More... | |
WPropBool | m_colorMapping |
add colormapping More... | |
WPropBool | m_phongShading |
Add lighting to the scene. More... | |
Friends | |
class | WMVoxelizerTest |
Only UnitTests may be friends. More... | |
Additional Inherited Members | |
Public Types inherited from WModule | |
typedef std::vector< std::shared_ptr< WModuleInputConnector > > | InputConnectorList |
The type for the list of input connectors. More... | |
typedef std::vector< std::shared_ptr< WModuleOutputConnector > > | OutputConnectorList |
The type for the list of output connectors. More... | |
typedef std::shared_ptr< WModule > | SPtr |
Shared pointer to a WModule. More... | |
typedef std::shared_ptr< const WModule > | ConstSPtr |
Shared pointer to a const WModule. More... | |
Public Types inherited from WThreadedRunner | |
typedef std::shared_ptr< WThreadedRunner > | SPtr |
Abbreviation to a shared_ptr to this type. More... | |
typedef std::shared_ptr< const WThreadedRunner > | ConstSPtr |
Abbreviation to a const shared_ptr to this type. More... | |
typedef boost::function< void(void) > | THREADFUNCTION |
Type used for simple thread functions. More... | |
Static Public Member Functions inherited from WModule | |
static SPtr | findByUUID (std::string uuid) |
Find a module instance by UUID. More... | |
Static Public Member Functions inherited from WThreadedRunner | |
static void | setThisThreadName (std::string name) |
Static function to set the name of the calling thread. More... | |
Protected Types inherited from WModule | |
typedef std::vector< WRequirement * > | Requirements |
The type of the requirement list. More... | |
Protected Attributes inherited from WModule | |
std::shared_ptr< WProperties > | m_properties |
The property object for the module. More... | |
std::shared_ptr< WProperties > | m_infoProperties |
The property object for the module containing only module whose purpose is "PV_PURPOSE_INFORMNATION". More... | |
std::shared_ptr< WProgressCombiner > | m_progress |
Progress indicator used as parent for all progress' of this module. More... | |
WBoolFlag | m_initialized |
True if everything is initialized and ready to be used. More... | |
WBoolFlag | m_isAssociated |
True if container got associated with this flag. More... | |
WBoolFlag | m_isUsable |
True if associated && initialized. More... | |
WBoolFlag | m_isReady |
True if ready() was called. More... | |
WBoolFlag | m_isReadyOrCrashed |
It is true whenever m_isReady or WThreadedRunner::m_isCrashed is true. More... | |
WBoolFlag | m_isRunning |
True if the module currently is running. More... | |
WBoolFlag | m_isLoadFinished |
Flag to denote whether the module container and the project loader have finished their work. More... | |
bool | m_restoreMode |
Flag denoting the current restore mode. More... | |
std::shared_ptr< WProgress > | m_readyProgress |
Progress indicator for the "ready" state. More... | |
WConditionSet | m_moduleState |
The internal state of the module. More... | |
std::shared_ptr< WModuleContainer > | m_container |
The container this module belongs to. More... | |
InputConnectorList | m_inputConnectors |
Set of input connectors associated with this module. More... | |
OutputConnectorList | m_outputConnectors |
Set of output connectors associated with this module. More... | |
WPropBool | m_active |
True whenever the module should be active. More... | |
WPropString | m_runtimeName |
This property holds a user specified name for the current module instance. More... | |
boost::filesystem::path | m_localPath |
The path where the module binary resides in. More... | |
boost::filesystem::path | m_libPath |
The absolute path to the library containing this module. More... | |
std::string | m_packageName |
The name of the lib/the package containing this module. More... | |
Requirements | m_requirements |
The list of requirements. More... | |
Protected Attributes inherited from WThreadedRunner | |
boost::thread | m_thread |
Thread instance. More... | |
WBoolFlag | m_shutdownFlag |
Condition getting fired whenever the thread should quit. More... | |
WBoolFlag | m_isCrashed |
True whenever an exception is thrown during threadMain. More... | |
std::string | m_crashMessage |
The crash message. More... | |
Traces a given set of deterministic tracts as given by a dataset of deterministic tracts (optionally only a subset may be processed) in a voxel-wise manner.
Every voxel which is hit by one or more tracts or tract-segments is marked with a scalar and stored in a dataset scalar.
Definition at line 50 of file WMVoxelizer.h.
WMVoxelizer::WMVoxelizer | ( | ) |
Default Constructor.
Definition at line 68 of file WMVoxelizer.cpp.
Referenced by factory().
|
virtual |
Default Destructor.
Definition at line 74 of file WMVoxelizer.cpp.
|
protected |
Finds and returns a copy of the center line in the dataset, or in a subset of it specified by the given cluster.
If the cluster is empty all tracts are considered.
tracts | The dataset of tracts. |
cluster | A subset of tracts. |
Definition at line 311 of file WMVoxelizer.cpp.
Referenced by generateDatasets().
|
protectedvirtual |
Initialize the connectors this module is using.
Reimplemented from WModule.
Definition at line 116 of file WMVoxelizer.cpp.
References WModule::connectors(), WModuleInputData< T >::createAndAdd(), WModuleOutputData< T >::createAndAdd(), m_clusterIC, m_paramOC, m_tractIC, and m_voxelizedOC.
|
protected |
Constructs a grid out of the current tract dataset or out of a subset (selection) of this dataset.
tracts | Dataset of deterministic tracts. |
cluster | Optional subselection of tracts. |
Definition at line 203 of file WMVoxelizer.cpp.
References WModule::debugLog(), WBoundingBoxImpl< VT >::getMin(), m_voxelsPerUnit, and WMatrix< T >::makeIdentity().
Referenced by generateDatasets().
|
protected |
Creates two vertices describing the bounding box of a cluster.
cluster | With its fibers |
|
virtual |
Due to the prototype design pattern used to build modules, this method returns a new instance of this method.
NOTE: it should never be initialized or modified in some other way. A simple new instance is required.
Implements WModule.
Definition at line 78 of file WMVoxelizer.cpp.
References WMVoxelizer().
|
protected |
Builds an OSG geode where all voxels inside the dataSet which are not zero are drawn as cuboids.
dataset | The dataset which should be drawn |
Definition at line 348 of file WMVoxelizer.cpp.
References wge::createCube(), and WModule::errorLog().
Referenced by moduleMain().
|
protected |
Generates a intensity dataset where each tract is rasterized into.
If additionally the (optional) cluster is given as subselection only tracts with IDs inside this dataset are considered. If additionally a parameterization was selected also a corresponding dataset will be generated and returned.
tracts | Dataset of deterministic tracts. |
cluster | Optional selection of a subset of tracts. |
Definition at line 242 of file WMVoxelizer.cpp.
References centerLine(), constructGrid(), WModule::debugLog(), WModule::errorLog(), longestLine(), m_antialiased, m_parameterAlgo, m_rasterAlgo, and raster().
Referenced by moduleMain().
|
inlinevirtual |
Gives back a description of this module.
Implements WPrototyped.
Definition at line 274 of file WMVoxelizer.h.
|
inlinevirtual |
Gives back the name of this module.
Implements WPrototyped.
Definition at line 269 of file WMVoxelizer.h.
|
protected |
Finds and returns a copy of the longest line (in term of #points) in the dataset, or in a subset of it specified by the given cluster.
If the cluster is empty all tracts are considered.
tracts | The dataset of tracts. |
cluster | A subset of tracts. |
Definition at line 301 of file WMVoxelizer.cpp.
Referenced by generateDatasets().
|
protectedvirtual |
Entry point after loading the module.
Runs in separate thread.
Implements WModule.
Definition at line 126 of file WMVoxelizer.cpp.
References WConditionSet::add(), WGEColormapping::apply(), genDataSetGeode(), generateDatasets(), WKernel::getGraphicsEngine(), WKernel::getRunningKernel(), WModule::infoLog(), WModule::m_active, m_clusterIC, m_colorMapping, m_fullUpdate, WModule::m_localPath, WModule::m_moduleState, m_paramOC, m_phongShading, WModule::m_properties, m_renderingActive, m_rootNode, WThreadedRunner::m_shutdownFlag, m_tractIC, m_voxelizedOC, WModule::ready(), WConditionSet::setResetable(), and WConditionSet::wait().
|
protectedvirtual |
Initialize the properties for this module.
Reimplemented from WModule.
Definition at line 83 of file WMVoxelizer.cpp.
References WPropertyHelper::PC_SELECTONLYONE::addTo(), WPropertyHelper::PC_NOTEMPTY::addTo(), m_antialiased, m_colorMapping, m_fullUpdate, m_paramAlgoSelections, m_parameterAlgo, m_phongShading, WModule::m_properties, m_rasterAlgo, m_renderingActive, m_voxelsPerUnit, and WModule::properties().
|
protected |
Performs rasterization with the given algorithm on either all tracts or only a subset if given.
algo | The algorithm which actually rasters every fiber. |
tracts | Dataset of tracts. |
cluster | A subset of tracts. |
Definition at line 321 of file WMVoxelizer.cpp.
Referenced by generateDatasets().
|
protected |
Removes or inserts geode for the center line of the current cluster into this modules group node.
|
friend |
Only UnitTests may be friends.
Definition at line 55 of file WMVoxelizer.h.
|
private |
Enable/disable anti-aliased rasterization of voxels.
Definition at line 233 of file WMVoxelizer.h.
Referenced by generateDatasets(), and properties().
|
private |
Input connector for an optional selection of some fibers in the fiber dataset via a cluster.
Definition at line 205 of file WMVoxelizer.h.
Referenced by connectors(), and moduleMain().
|
private |
add colormapping
Definition at line 261 of file WMVoxelizer.h.
Referenced by moduleMain(), and properties().
|
private |
module is performing an expensive update
Definition at line 231 of file WMVoxelizer.h.
Referenced by moduleMain(), and properties().
|
private |
The available parameterization algorithms.
Definition at line 251 of file WMVoxelizer.h.
Referenced by properties().
|
private |
The actually selected parameterization algorithm.
Definition at line 256 of file WMVoxelizer.h.
Referenced by generateDatasets(), and properties().
|
private |
Output providing parameterization to other algorithms.
It provides a scalar field which gets filled with the parameterization of the fibers, i.e. current integrated length.
Definition at line 216 of file WMVoxelizer.h.
Referenced by connectors(), and moduleMain().
|
private |
Add lighting to the scene.
Definition at line 266 of file WMVoxelizer.h.
Referenced by moduleMain(), and properties().
|
private |
List for selecting the rasterization method.
Definition at line 241 of file WMVoxelizer.h.
Referenced by generateDatasets(), and properties().
|
private |
Enable/disable rendering of voxels.
Definition at line 234 of file WMVoxelizer.h.
Referenced by moduleMain(), and properties().
|
private |
OSG root node for this module.
Definition at line 226 of file WMVoxelizer.h.
Referenced by moduleMain().
|
private |
Input connector for a fiber dataset.
Definition at line 200 of file WMVoxelizer.h.
Referenced by connectors(), and moduleMain().
|
private |
Reference to the fiber dataset.
Definition at line 221 of file WMVoxelizer.h.
|
private |
Output connector for a voxelized cluster.
Definition at line 210 of file WMVoxelizer.h.
Referenced by connectors(), and moduleMain().
|
private |
The number of voxels per unit in the coordinate system.
Definition at line 246 of file WMVoxelizer.h.
Referenced by constructGrid(), and properties().