#include <itkPlatformMultiThreader.h>
A class for performing multithreaded execution.
Multithreader is a class that provides support for multithreaded execution using Windows or POSIX threads. This class can be used to execute a single method on multiple threads, or to specify a method per thread.
Definition at line 50 of file itkPlatformMultiThreader.h.
Classes | |
struct | WorkUnitInfo |
Public Types | |
using | ConstPointer = SmartPointer<const Self> |
using | Pointer = SmartPointer<Self> |
using | Self = PlatformMultiThreader |
using | Superclass = MultiThreaderBase |
![]() | |
using | ArrayThreadingFunctorType = std::function<void(SizeValueType)> |
using | ConstPointer = SmartPointer<const Self> |
using | Pointer = SmartPointer<Self> |
using | Self = MultiThreaderBase |
using | Superclass = Object |
using | ThreaderEnum = MultiThreaderBaseEnums::Threader |
using | ThreadingFunctorType = std::function<void(const IndexValueType index[], const SizeValueType size[])> |
![]() | |
using | ConstPointer = SmartPointer<const Self> |
using | Pointer = SmartPointer<Self> |
using | Self = Object |
using | Superclass = LightObject |
![]() | |
using | ConstPointer = SmartPointer<const Self> |
using | Pointer = SmartPointer<Self> |
using | Self = LightObject |
Public Member Functions | |
virtual::itk::LightObject::Pointer | CreateAnother () const |
const char * | GetNameOfClass () const override |
void | MultipleMethodExecute () |
void | SetMaximumNumberOfThreads (ThreadIdType numberOfThreads) override |
void | SetMultipleMethod (ThreadIdType index, ThreadFunctionType, void *data) |
void | SetNumberOfWorkUnits (ThreadIdType numberOfWorkUnits) override |
void | SetSingleMethod (ThreadFunctionType, void *data) override |
void | SingleMethodExecute () override |
ThreadIdType | SpawnThread (ThreadFunctionType, void *data) |
void | TerminateThread (ThreadIdType thread_id) |
![]() | |
virtual bool | GetUpdateProgress () const |
virtual void | ParallelizeArray (SizeValueType firstIndex, SizeValueType lastIndexPlus1, ArrayThreadingFunctorType aFunc, ProcessObject *filter) |
template<unsigned int VDimension, typename TFunction> | |
ITK_TEMPLATE_EXPORT void | ParallelizeImageRegion (const ImageRegion< VDimension > &requestedRegion, TFunction funcP, ProcessObject *filter) |
virtual void | ParallelizeImageRegion (unsigned int dimension, const IndexValueType index[], const SizeValueType size[], ThreadingFunctorType funcP, ProcessObject *filter) |
template<unsigned int VDimension, typename TFunction> | |
ITK_TEMPLATE_EXPORT void | ParallelizeImageRegionRestrictDirection (unsigned int restrictedDirection, const ImageRegion< VDimension > &requestedRegion, TFunction funcP, ProcessObject *filter) |
void | SetSingleMethodAndExecute (ThreadFunctionType func, void *data) |
virtual void | SetUpdateProgress (bool updates) |
virtual ThreadIdType | GetMaximumNumberOfThreads () const |
virtual ThreadIdType | GetNumberOfWorkUnits () const |
![]() | |
unsigned long | AddObserver (const EventObject &event, Command *cmd) const |
unsigned long | AddObserver (const EventObject &event, std::function< void(const EventObject &)> function) const |
virtual void | DebugOff () const |
virtual void | DebugOn () const |
Command * | GetCommand (unsigned long tag) |
bool | GetDebug () const |
MetaDataDictionary & | GetMetaDataDictionary () |
const MetaDataDictionary & | GetMetaDataDictionary () const |
virtual ModifiedTimeType | GetMTime () const |
virtual const TimeStamp & | GetTimeStamp () const |
bool | HasObserver (const EventObject &event) const |
void | InvokeEvent (const EventObject &) |
void | InvokeEvent (const EventObject &) const |
virtual void | Modified () const |
void | Register () const override |
void | RemoveAllObservers () |
void | RemoveObserver (unsigned long tag) const |
void | SetDebug (bool debugFlag) const |
void | SetReferenceCount (int) override |
void | UnRegister () const noexcept override |
void | SetMetaDataDictionary (const MetaDataDictionary &rhs) |
void | SetMetaDataDictionary (MetaDataDictionary &&rrhs) |
virtual void | SetObjectName (std::string _arg) |
virtual const std::string & | GetObjectName () const |
![]() | |
Pointer | Clone () const |
virtual void | Delete () |
virtual int | GetReferenceCount () const |
void | Print (std::ostream &os, Indent indent=0) const |
Protected Member Functions | |
PlatformMultiThreader () | |
void | PrintSelf (std::ostream &os, Indent indent) const override |
~PlatformMultiThreader () override | |
![]() | |
MultiThreaderBase () | |
~MultiThreaderBase () override | |
![]() | |
Object () | |
bool | PrintObservers (std::ostream &os, Indent indent) const |
virtual void | SetTimeStamp (const TimeStamp &timeStamp) |
~Object () override | |
![]() | |
virtual LightObject::Pointer | InternalClone () const |
LightObject () | |
virtual void | PrintHeader (std::ostream &os, Indent indent) const |
virtual void | PrintTrailer (std::ostream &os, Indent indent) const |
virtual | ~LightObject () |
Private Member Functions | |
ThreadProcessIdType | SpawnDispatchSingleMethodThread (WorkUnitInfo *) |
void | SpawnWaitForSingleMethodThread (ThreadProcessIdType) |
Private Attributes | |
int | m_SpawnedThreadActiveFlag [ITK_MAX_THREADS] {} |
std::shared_ptr< std::mutex > | m_SpawnedThreadActiveFlagMutex [ITK_MAX_THREADS] {} |
WorkUnitInfo | m_SpawnedThreadInfoArray [ITK_MAX_THREADS] {} |
ThreadProcessIdType | m_SpawnedThreadProcessID [ITK_MAX_THREADS] {} |
WorkUnitInfo | m_ThreadInfoArray [ITK_MAX_THREADS] {} |
Friends | |
class | ProcessObject |
Additional Inherited Members | |
![]() | |
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION | ParallelizeArrayHelper (void *arg) |
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION | ParallelizeImageRegionHelper (void *arg) |
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION | SingleMethodProxy (void *arg) |
![]() | |
ThreadIdType | m_MaximumNumberOfThreads {} |
ThreadIdType | m_NumberOfWorkUnits {} |
void * | m_SingleData { nullptr } |
ThreadFunctionType | m_SingleMethod { nullptr } |
![]() | |
std::atomic< int > | m_ReferenceCount {} |
using itk::PlatformMultiThreader::ConstPointer = SmartPointer<const Self> |
Definition at line 59 of file itkPlatformMultiThreader.h.
Definition at line 58 of file itkPlatformMultiThreader.h.
Standard class type aliases.
Definition at line 56 of file itkPlatformMultiThreader.h.
Definition at line 57 of file itkPlatformMultiThreader.h.
|
protected |
Referenced by GetNameOfClass().
|
overrideprotected |
|
virtual |
Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class.
Reimplemented from itk::Object.
|
overridevirtual |
Reimplemented from itk::MultiThreaderBase.
References PlatformMultiThreader(), and itk::MultiThreaderBase::SetGlobalMaximumNumberOfThreads().
void itk::PlatformMultiThreader::MultipleMethodExecute | ( | ) |
Execute the MultipleMethods (as define by calling SetMultipleMethod for each of the required m_NumberOfWorkUnits methods) using m_NumberOfWorkUnits threads. As a side effect the m_NumberOfWorkUnits will be checked against the current m_GlobalMaximumNumberOfThreads and clamped if necessary.
|
static |
Method for creation through the object factory.
|
overrideprotectedvirtual |
Methods invoked by Print() to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.
Reimplemented from itk::MultiThreaderBase.
|
overridevirtual |
Get/Set the number of threads to use. It will be clamped to the range [ 1, m_GlobalMaximumNumberOfThreads ], so the caller of this method should check that the requested number of threads was accepted.
Reimplemented from itk::MultiThreaderBase.
void itk::PlatformMultiThreader::SetMultipleMethod | ( | ThreadIdType | index, |
ThreadFunctionType | , | ||
void * | data ) |
Set the MultipleMethod at the given index to f() and the UserData field of the WorkUnitInfo that is passed to it will be data.
|
overridevirtual |
Get/Set the number of work units to create. It might be clamped to the range [ 1, SomeMaximumNumber ], so the caller of this method should check that the requested number of work units was accepted.
Reimplemented from itk::MultiThreaderBase.
|
overridevirtual |
Set the SingleMethod to f() and the UserData field of the WorkUnitInfo that is passed to it will be data. This method (and all the methods passed to SetMultipleMethod) must be of type itkThreadFunctionType and must take a single argument of type void *.
Implements itk::MultiThreaderBase.
|
overridevirtual |
Execute the SingleMethod (as define by SetSingleMethod) using m_NumberOfWorkUnits threads. As a side effect the m_NumberOfWorkUnits will be checked against the current m_GlobalMaximumNumberOfThreads and clamped if necessary.
Implements itk::MultiThreaderBase.
|
private |
spawn a new thread for the SingleMethod
ThreadIdType itk::PlatformMultiThreader::SpawnThread | ( | ThreadFunctionType | , |
void * | data ) |
Create a new thread for the given function. Return a thread id which is a number between 0 and ITK_MAX_THREADS - 1. This id should be used to kill the thread at a later time. Deprecated. Use C++11 thread support instead.
|
private |
wait for a thread in the threadpool to finish work
void itk::PlatformMultiThreader::TerminateThread | ( | ThreadIdType | thread_id | ) |
Terminate the thread that was created with a SpawnThreadExecute() Deprecated. Use C++11 thread support instead.
|
friend |
Friends of Multithreader. ProcessObject is a friend so that it can call PrintSelf() on its Multithreader.
Friends of DataObject
Definition at line 191 of file itkPlatformMultiThreader.h.
References ProcessObject.
Referenced by ProcessObject.
|
private |
Storage of MutexFunctions and ints used to control spawned threads and the spawned thread ids.
Definition at line 168 of file itkPlatformMultiThreader.h.
|
private |
Definition at line 169 of file itkPlatformMultiThreader.h.
|
private |
Definition at line 171 of file itkPlatformMultiThreader.h.
|
private |
Definition at line 170 of file itkPlatformMultiThreader.h.
|
private |
An array of thread info containing a thread id (0, 1, 2, .. ITK_MAX_THREADS-1), the thread count, and a pointer to void so that user data can be passed to each thread.
Definition at line 164 of file itkPlatformMultiThreader.h.