28#ifndef itkMultiThreaderBase_h
29#define itkMultiThreaderBase_h
78 ITK_PROCESS_ABORTED_EXCEPTION,
84extern ITKCommon_EXPORT std::ostream &
86extern ITKCommon_EXPORT std::ostream &
103struct MultiThreaderBaseGlobals;
142 itkGetConstMacro(UpdateProgress,
bool);
160 itkLegacyMacro(
static void SetGlobalDefaultUseThreadPool(
const bool GlobalDefaultUseThreadPool));
165#if !defined(ITK_LEGACY_REMOVE)
167 static constexpr ThreaderEnum Platform = ThreaderEnum::Platform;
168 static constexpr ThreaderEnum First = ThreaderEnum::First;
169 static constexpr ThreaderEnum Pool = ThreaderEnum::Pool;
171 static constexpr ThreaderEnum Last = ThreaderEnum::Last;
172 static constexpr ThreaderEnum Unknown = ThreaderEnum::Unknown;
185 case ThreaderEnum::Platform:
187 case ThreaderEnum::Pool:
189 case ThreaderEnum::TBB:
191 case ThreaderEnum::Unknown:
225#if !defined(ITK_LEGACY_REMOVE)
228 itkLegacyMacro(
virtual void SetNumberOfThreads(
ThreadIdType numberOfThreads))
230 this->SetMaximumNumberOfThreads(numberOfThreads);
231 this->SetNumberOfWorkUnits(this->GetMaximumNumberOfThreads());
233 itkLegacyMacro(
virtual ThreadIdType GetNumberOfThreads()) {
return this->GetNumberOfWorkUnits(); }
245ITK_GCC_PRAGMA_DIAG_PUSH()
246ITK_GCC_PRAGMA_DIAG(ignored "-Wattributes")
247INTEL_PRAGMA_WARN_PUSH
248INTEL_SUPPRESS_warning_1292
250# ifdef ITK_LEGACY_SILENT
251 struct ThreadInfoStruct
253 struct [[deprecated("Use WorkUnitInfo, ThreadInfoStruct is deprecated since ITK 5.0")]] ThreadInfoStruct
267 ITK_PROCESS_ABORTED_EXCEPTION,
273ITK_GCC_PRAGMA_DIAG_POP()
292#if !defined(ITK_LEGACY_REMOVE)
295 static constexpr ThreadExitCodeEnum ITK_EXCEPTION = ThreadExitCodeEnum::ITK_EXCEPTION;
297 ThreadExitCodeEnum::ITK_PROCESS_ABORTED_EXCEPTION;
298 static constexpr ThreadExitCodeEnum STD_EXCEPTION = ThreadExitCodeEnum::STD_EXCEPTION;
322#ifndef ITK_FUTURE_LEGACY_REMOVE
325 template <
unsigned int VDimension>
348 template <
unsigned int VDimension,
typename TFunction>
349 ITK_TEMPLATE_EXPORT
void
352 this->ParallelizeImageRegion(
357 ImageRegion<VDimension> region;
358 for (unsigned int d = 0; d < VDimension; ++d)
360 region.SetIndex(d, index[d]);
361 region.SetSize(d, size[d]);
372 template <
unsigned int VDimension,
typename TFunction>
373 ITK_TEMPLATE_EXPORT
void
379 if constexpr (VDimension <= 1)
383 funcP(requestedRegion);
387 constexpr unsigned int SplitDimension = VDimension - 1;
391 for (
unsigned int splitDimension = 0, dimension = 0; dimension < VDimension; ++dimension)
393 if (dimension != restrictedDirection)
395 splitIndex[splitDimension] = requestedRegion.
GetIndex(dimension);
396 splitSize[splitDimension] = requestedRegion.
GetSize(dimension);
401 this->ParallelizeImageRegion(
403 splitIndex.m_InternalArray,
404 splitSize.m_InternalArray,
406 ImageRegion<VDimension> restrictedRequestedRegion;
407 restrictedRequestedRegion.SetIndex(restrictedDirection, requestedRegion.GetIndex(restrictedDirection));
408 restrictedRequestedRegion.SetSize(restrictedDirection, requestedRegion.GetSize(restrictedDirection));
409 for (unsigned int splitDimension = 0, dimension = 0; dimension < VDimension; ++dimension)
411 if (dimension != restrictedDirection)
413 restrictedRequestedRegion.SetIndex(dimension, index[splitDimension]);
414 restrictedRequestedRegion.SetSize(dimension, size[splitDimension]);
418 funcP(restrictedRequestedRegion);
488 void * m_SingleData{
nullptr };
499 std::atomic<bool> m_UpdateProgress{
true };
SizeValueType GetNumberOfPixels() const
const IndexType & GetIndex() const
const SizeType & GetSize() const
Control indentation during Print() invocation.
Light weight base class for most itk classes.
enums for MultiThreaderBase
A class for performing multithreaded execution.
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION ParallelizeArrayHelper(void *arg)
ITK_TEMPLATE_EXPORT void ParallelizeImageRegion(const ImageRegion< VDimension > &requestedRegion, TFunction funcP, ProcessObject *filter)
ITK_TEMPLATE_EXPORT void ParallelizeImageRegionRestrictDirection(unsigned int restrictedDirection, const ImageRegion< VDimension > &requestedRegion, TFunction funcP, ProcessObject *filter)
virtual void SetMaximumNumberOfThreads(ThreadIdType numberOfThreads)
void SetSingleMethodAndExecute(ThreadFunctionType func, void *data)
static std::string ThreaderTypeToString(ThreaderEnum threader)
static ThreaderEnum GetGlobalDefaultThreaderPrivate()
static void SetGlobalDefaultThreaderPrivate(ThreaderEnum threaderType)
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION SingleMethodProxy(void *arg)
static ThreaderEnum GetGlobalDefaultThreader()
static void SetGlobalDefaultThreader(ThreaderEnum threaderType)
static MultiThreaderBaseGlobals * m_PimplGlobals
static ThreaderEnum ThreaderTypeFromString(std::string threaderString)
static ThreadIdType GetGlobalMaximumNumberOfThreads()
virtual void SetNumberOfWorkUnits(ThreadIdType numberOfWorkUnits)
virtual void SetUpdateProgress(bool updates)
static ThreadIdType GetGlobalDefaultNumberOfThreadsByPlatform()
void PrintSelf(std::ostream &os, Indent indent) const override
virtual void SetSingleMethod(ThreadFunctionType, void *data)=0
itkGetGlobalDeclarationMacro(MultiThreaderBaseGlobals, PimplGlobals)
virtual void ParallelizeImageRegion(unsigned int dimension, const IndexValueType index[], const SizeValueType size[], ThreadingFunctorType funcP, ProcessObject *filter)
static ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION ParallelizeImageRegionHelper(void *arg)
static ThreadIdType GetGlobalDefaultNumberOfThreads()
itkLegacyMacro(static void SetGlobalDefaultUseThreadPool(const bool GlobalDefaultUseThreadPool))
itkLegacyMacro(static bool GetGlobalDefaultUseThreadPool())
virtual void SingleMethodExecute()=0
std::function< void(SizeValueType)> ArrayThreadingFunctorType
~MultiThreaderBase() override
std::function< void(const IndexValueType index[], const SizeValueType size[])> ThreadingFunctorType
static void SetGlobalMaximumNumberOfThreads(ThreadIdType val)
static void SetGlobalDefaultNumberOfThreads(ThreadIdType val)
virtual void ParallelizeArray(SizeValueType firstIndex, SizeValueType lastIndexPlus1, ArrayThreadingFunctorType aFunc, ProcessObject *filter)
Base class for most ITK classes.
The base class for all process objects (source, filters, mappers) in the Insight data processing pipe...
Implements progress tracking for a filter.
The "itk" namespace contains all Insight Segmentation and Registration Toolkit (ITK) classes....
unsigned int ThreadIdType
void(*)(void *) ThreadFunctionType
std::ostream & operator<<(std::ostream &os, const Array< TValue > &arr)
unsigned long SizeValueType
itk::ITK_THREAD_RETURN_TYPE ITK_THREAD_RETURN_FUNCTION_CALL_CONVENTION
Represent a n-dimensional index in a n-dimensional image.
IndexValueType m_InternalArray[VDimension]
const SizeValueType firstIndex
const SizeValueType lastIndexPlus1
ArrayThreadingFunctorType functor
ThreadingFunctorType functor
const IndexValueType * index
const SizeValueType * size
ThreadExitCodeEnum ThreadExitCode
ThreadFunctionType ThreadFunction
ThreadIdType NumberOfWorkUnits
Represent a n-dimensional size (bounds) of a n-dimensional image.
SizeValueType m_InternalArray[VDimension]