Generalization of a task that can be run in parallel. More...

Inherits Task.

Inherited by Smoother1D< float >, Stats::ParallelCalc< float >, AGC< T >, Array1DStacker< fT, ArrT >, Array2DConverter, Array2DCopier< T >, Array2DInterpol, Array2DReSampler< T, TT >, Array3DCopier< T >, Array3DFloodfill< T >, Array3DUdfTrcRestorer< T >, ArrayMath::ArrOperExec< OperType, ArrType >, ArrayMath::CumArrOperExec< RT, AT >, ArrayMath::CumSumExec< T >, ArrayNDCopier, ArrayNDDataExtracter< T >, ArrayUdfValReplacer< T >, ArrayUdfValRestorer< T >, BendPointFinderBase, BodyVolumeCalculator, ColTab::MapperTask< T >, Convolver2D< T >, Convolver3D< T >, DPSDensityCalcND, DPSFromVolumeFiller, DataDistributionExtracter< vT >, DelaunayTriangulator, Density2RGBArray, DensityCalc, EM::EMObjectPosSelector, EM::EMObjectRowColSelRemoval, EM::Expl2ImplBodyExtracter, EM::HorizonMerger, FaultTraceExtractor, Fourier::CC::CC1D, FourierInterpol1D, FourierInterpol2D, FourierInterpol3D, Geometry::ArrayTesselator, ImageResizer, Implicit2MarchingCubes, Line2DInterSectionFinder, LogCubeCreator, MarchingCubes2Implicit, MarchingCubesSurfaceEditor, MemCopier< T >, MemSetter< T >, MemValReplacer< T >, MuteArrayExtracter< T >, ParallelDTetrahedralator, ParallelSorter< T >, PreStack::AngleMuteComputer, PreStack::Processor, RayTracer1D, RayTracerRunner, ReflectivitySampler, SampledExtremeFinderND< T >, Seis::MultiTraceSynthGenerator, Seis::ParallelReader, Seis::ParallelReader2D, Seis::RaySynthGenerator, SeisDataPackFromDPS, SeisDataPackZAxisTransformer, SeisZAxisStretcher, Smoother1D< T >, Stats::ParallelCalc< T >, VDA2DBitMapGenerator [private], ValueSeriesGetAll< T >, Vel::VolumeConverter, VolProc::StatsCalculatorTask, VolProc::TutOpCalculatorTask, Well::LogSampler, ZAxisTransformPointGenerator, ZAxisTransformer, mxArrayCopier, visBase::HorizonSectionTilePosSetup, visBase::HorizonTileRenderPreparer, and visBase::HorizonTileResolutionTesselator.

Public Member Functions
virtual	~ParallelTask ()

bool	execute ()

virtual bool	executeParallel (bool parallel)

int64_t	nrDone () const
	May be -1, i.e. class does not report nrdone. More...

void	setProgressMeter (ProgressMeter *)
	Must be called before execute() More...

int64_t	totalNr () const

Public Member Functions inherited from Task
virtual	~Task ()

virtual void	controlWork (Control)

virtual void	enableWorkControl (bool=true)
	Must be called before execute() More...

virtual uiRetVal	errorWithDetails () const

virtual Control	getState () const

virtual uiString	uiMessage () const
	will be message() again in 7.x More...

virtual uiString	uiNrDoneText () const
	will be nrDoneText() in 7.x More...

bool	workControlEnabled () const

Public Member Functions inherited from NamedCallBacker
	NamedCallBacker (const char *nm=0)

	NamedCallBacker (const NamedCallBacker &)

virtual Notifier< NamedCallBacker > &	objectToBeDeleted () const

bool	operator== (const NamedCallBacker &oth) const

bool	operator== (const NamedObject &oth) const

Public Member Functions inherited from CallBacker
	CallBacker ()

	CallBacker (const CallBacker &)

virtual	~CallBacker ()

bool	attachCB (const NotifierAccess &, const CallBack &, bool onlyifnew=false) const

bool	attachCB (const NotifierAccess *notif, const CallBack &cb, bool onlyifnew=false) const

void	detachAllNotifiers () const
	Call from the destructor of your inherited object. More...

void	detachCB (const NotifierAccess &, const CallBack &) const

void	detachCB (const NotifierAccess *notif, const CallBack &cb) const

virtual bool	isCapsule () const

bool	isNotifierAttached (const NotifierAccess *) const
	Only for debugging purposes, don't use. More...

void	stopReceivingNotifications () const

Public Member Functions inherited from NamedObject
	NamedObject (const char *nm=nullptr)

	NamedObject (const NamedObject &oth)

virtual	~NamedObject ()

virtual BufferString	getName () const

bool	getNameFromPar (const IOPar &)

virtual const name_type &	name () const

NamedObject &	operator= (const NamedObject &)

bool	operator== (const NamedObject &oth) const

virtual void	setName (const char *nm)

Public Member Functions inherited from ObjectWithName
virtual	~ObjectWithName ()

bool	hasName (const char *nm) const

bool	hasName (const name_type &nm) const

void	putNameInPar (IOPar &) const

Static Public Member Functions
static uiString	sPosFinished ()

static uiString	sTrcFinished ()

Static Public Member Functions inherited from Task
static uiString	stdNrDoneText ()

static uiString	uiStdNrDoneText ()

Static Public Member Functions inherited from CallBacker
static void	createReceiverForCurrentThread ()

static void	removeReceiverForCurrentThread ()

Protected Member Functions
	ParallelTask (const char *nm=0)

	ParallelTask (const ParallelTask &)

void	addToNrDone (int64_t increment)

int64_t	calculateThreadSize (int64_t totalnr, int nrthreads, int thread) const

virtual int	maxNrThreads () const

virtual int	minThreadSize () const

virtual int64_t	nrIterations () const =0

void	quickAddToNrDone (int64_t loopidx)

void	resetNrDone ()

virtual bool	stopAllOnFailure () const

Protected Member Functions inherited from Task
	Task (const char *nm=nullptr)

virtual bool	shouldContinue ()

Protected Member Functions inherited from NamedCallBacker
void	sendDelNotif () const

Private Member Functions
virtual bool	doFinish (bool success)

virtual bool	doPrepare (int nrthreads)

virtual bool	doWork (int64_t start, int64_t stop, int threadidx)=0

Private Attributes
Threads::Atomic< int64_t >	nrdone_

int64_t	nrdonebigchunksz_

ProgressMeter *	progressmeter_

int64_t	totalnrcache_

Friends
class	ParallelTaskRunner

Additional Inherited Members
Public Types inherited from Task
enum	Control { Run , Pause , Stop }

Public Types inherited from ObjectWithName
typedef OD::String	name_type

Protected Attributes inherited from Task
Control	control_

Threads::ConditionVar *	workcontrolcondvar_

Protected Attributes inherited from NamedCallBacker
Threads::Atomic< bool >	delalreadytriggered_

Notifier< NamedCallBacker >	delnotif_

Protected Attributes inherited from NamedObject
BufferString	name_

Detailed Description

Generalization of a task that can be run in parallel.

Any task that has a fixed number of computations that are independent (i.e. they don't need to be done in a certain order) can inherit ParallelTask and be executed in parallel by calling the ParallelTask::execute().

Example of usage:

float result[N];
for ( int idx=0; idx<N; idx++ )
    result[idx] = input1[idx]* function( idx, other, variables );

Could be made parallel by adding the class:

class CalcClass : public ParallelTask
{
public:
      od_int64  nrIterations() const { return N; }
      int               doWork( od_int64 start, od_int64 stop, int threadid )
                {
                for ( int idx=start;idx<=stop &&shouldContinue();idx++ )
                {
                        result[idx] = input1[idx] *
                        function( idx, other, variables );
                        addToNrDone( 1 );
                }
 
                return true;
                }
                };

and in use that instead of the for-loop:

CalcClass myclass( N, my, parameters );

myclass.exectute();

<>

Constructor & Destructor Documentation

◆ ~ParallelTask()

virtual ParallelTask::~ParallelTask ( )

virtual

◆ ParallelTask() [1/2]

ParallelTask::ParallelTask ( const char * nm = 0 )

protected

◆ ParallelTask() [2/2]

ParallelTask::ParallelTask ( const ParallelTask & )

protected

Member Function Documentation

◆ addToNrDone()

void ParallelTask::addToNrDone ( int64_t increment )

protected

Call this from within your thread to say that you have done something. Do NOT call in very fast loops at every idx since it can impact negatively performance

◆ calculateThreadSize()

int64_t ParallelTask::calculateThreadSize	(	int64_t	totalnr,
		int	nrthreads,
		int	thread
	)		const

protected

◆ doFinish()

virtual bool ParallelTask::doFinish ( bool success )

inlineprivatevirtual

Called after all doWork have finished.

Parameters

success indicates whether all doWork returned true.

Reimplemented in GMTArray2DInterpol, LogCubeCreator, visBase::HorizonSectionTilePosSetup, Vel::VolumeConverter, SeisZAxisStretcher, Seis::ParallelReader2D, Seis::ParallelReader, MarchingCubesSurfaceEditor, FaultTraceExtractor2D, FaultTraceExtractor, Stats::ParallelCalc< T >, Stats::ParallelCalc< float >, Stats::ParallelCalc< T >, Stats::ParallelCalc< float >, ParallelSorter< T >, ImageResizer, ReflectivitySampler, FourierInterpol3D, FourierInterpol2D, FourierInterpol1D, BendPointFinderBase, SeisDataPackZAxisTransformer, PreStack::AngleMuteComputer, Line2DInterSectionFinder, ZAxisTransformPointGenerator, EM::Horizon3DMerger, ArrayMath::CumSumExec< T >, and ArrayMath::CumArrOperExec< RT, AT >.

◆ doPrepare()

virtual bool ParallelTask::doPrepare ( int nrthreads )

inlineprivatevirtual

Called once, before any doWork is called.

Reimplemented in Density2RGBArray, GMTArray2DInterpol, LogCubeCreator, Well::LogSampler, visBase::HorizonTileRenderPreparer, visBase::HorizonTileResolutionTesselator, Vel::VolumeConverter, Seis::RaySynthGenerator, Seis::MultiTraceSynthGenerator, SeisZAxisStretcher, PreStack::AngleMuteComputer, MarchingCubesSurfaceEditor, MarchingCubes2Implicit, FaultTraceExtractor2D, FaultTraceExtractor3D, FaultTraceExtractor, EM::EMObjectRowColSelRemoval, EM::EMObjectPosSelector, MemValReplacer< T >, MemCopier< T >, MemSetter< T >, ZAxisTransformer, Stats::ParallelCalc< T >, Stats::ParallelCalc< float >, ParallelSorter< T >, Smoother1D< T >, Smoother1D< float >, ImageResizer, ReflectivitySampler, RayTracer1D, FourierInterpol3D, FourierInterpol2D, FourierInterpol1D, Fourier::CC::CC1D, ParallelDTetrahedralator, DelaunayTriangulator, DataDistributionExtracter< vT >, Convolver2D< T >, ContinuousCurvatureArray2DInterpol, BendPointFinderBase, MuteArrayExtracter< T >, ArrayUdfValReplacer< T >, ArrayMath::ArrOperExec< OperType, ArrType >, Array3DCopier< T >, Array2DCopier< T >, TriangulationArray2DInterpol, InverseDistanceArray2DInterpol, Array2DInterpol, Array2DFromXYConverter, Seis::ParallelReader2D, Seis::ParallelReader, SeisDataPackZAxisTransformer, SeisDataPackFromDPS, PreStack::AngleMute, ZAxisTransformPointGenerator, EM::Expl2ImplBodyExtracter, Array1DStacker< fT, ArrT >, ArrayMath::CumSumExec< T >, ArrayMath::CumArrOperExec< RT, AT >, and AGC< T >.

◆ doWork()

virtual bool ParallelTask::doWork	(	int64_t	start,
		int64_t	stop,
		int	threadidx
	)

privatepure virtual

The functions that does the job. The function will be called with all intervals from 0 to ParallelTask::nrIterations()-1. The function must be designed to be able to run in parallel.

Parameters

start	first index
stop	last index
threadidx	gives an identifier (between 0 and nr of threads -1) that is unique to each call to doWork.

Implemented in MemValReplacer< T >, MemCopier< T >, MemSetter< T >, ValueSeriesGetAll< T >, and ArrayNDDataExtracter< T >.

◆ execute()

bool ParallelTask::execute ( )

inlinevirtual

Runs the process the desired number of times.

Note: that the function has static threads (normally the same number as there are processors on the machine), and these static threads will be shared by all instances of ParallelTask::execute.

Implements Task.

◆ executeParallel()

virtual bool ParallelTask::executeParallel ( bool parallel )

virtual

Runs the process the desired number of times.

Note: that the function has static threads (normally the same number as there are processors on the machine), and these static threads will be shared by all instances of ParallelTask::execute.

Reimplemented in RayTracerRunner, and Convolver3D< T >.

◆ maxNrThreads()

virtual int ParallelTask::maxNrThreads ( ) const

protectedvirtual

Reimplemented in GMTArray2DInterpol, Array2DFromXYConverter, Geometry::ArrayTesselator, ParallelDTetrahedralator, DelaunayTriangulator, ContinuousCurvatureArray2DInterpol, and Array3DFloodfill< T >.

◆ minThreadSize()

virtual int ParallelTask::minThreadSize ( ) const

inlineprotectedvirtual

Returns: the minimum number of computations that effectively can be run in a separate thread. A small number will give a large overhead for when each step is quick and nrIterations is not big.

Reimplemented in MemValReplacer< T >, MemCopier< T >, MemSetter< T >, ParallelSorter< T >, TriangulationArray2DInterpol, and AGC< T >.

◆ nrDone()

int64_t ParallelTask::nrDone ( ) const

virtual

May be -1, i.e. class does not report nrdone.

Reimplemented from Task.

Reimplemented in GMTArray2DInterpol, DensityCalc, DPSDensityCalcND, Seis::RaySynthGenerator, MarchingCubes2Implicit, RayTracerRunner, and ParallelSorter< T >.

◆ nrIterations()

virtual int64_t ParallelTask::nrIterations ( ) const

protectedpure virtual

Returns: the number of times the process should be run.

Implemented in Density2RGBArray, GMTArray2DInterpol, Array2DFromXYConverter, DensityCalc, VolProc::TutOpCalculatorTask, mxArrayCopier, ArrayNDCopier, LogCubeCreator, Well::LogSampler, VolProc::StatsCalculatorTask, visBase::HorizonSectionTilePosSetup, visBase::HorizonTileRenderPreparer, visBase::HorizonTileResolutionTesselator, Vel::VolumeConverter, DPSDensityCalcND, Seis::RaySynthGenerator, Seis::MultiTraceSynthGenerator, SeisZAxisStretcher, Seis::ParallelReader2D, Seis::ParallelReader, SeisDataPackZAxisTransformer, SeisDataPackFromDPS, PreStack::TrimStatics, PreStack::Stack, PreStack::Processor, PreStack::Mute, PreStack::LateralStack, PreStack::AngleMuteComputer, PreStack::AngleMute, MarchingCubesSurfaceEditor, MarchingCubes2Implicit, Implicit2MarchingCubes, Line2DInterSectionFinder, Geometry::ArrayTesselator, ZAxisTransformPointGenerator, RayTracerRunner, DPSFromVolumeFiller, ColTab::MapperTask< T >, Array2DReSampler< T, TT >, VDA2DBitMapGenerator, EM::Horizon3DMerger, FaultTraceExtractor, EM::EMObjectRowColSelRemoval, EM::EMObjectPosSelector, EM::Expl2ImplBodyExtracter, ValueSeriesGetAll< T >, MemValReplacer< T >, MemCopier< T >, MemSetter< T >, ArrayNDDataExtracter< T >, ZAxisTransformer, Stats::ParallelCalc< T >, Stats::ParallelCalc< float >, ParallelSorter< T >, Smoother1D< T >, Smoother1D< float >, SampledExtremeFinderND< T >, ImageResizer, ReflectivitySampler, RayTracer1D, FourierInterpol3D, FourierInterpol2D, FourierInterpol1D, Fourier::CC::CC1D, ParallelDTetrahedralator, DelaunayTriangulator, DataDistributionExtracter< vT >, Convolver3D< T >, Convolver2D< T >, Convolver2D< T >, ContinuousCurvatureArray2DInterpol, BodyVolumeCalculator, BendPointFinderBase, Array1DStacker< fT, ArrT >, MuteArrayExtracter< T >, Array3DUdfTrcRestorer< T >, ArrayUdfValRestorer< T >, ArrayUdfValReplacer< T >, ArrayMath::CumSumExec< T >, ArrayMath::ArrOperExec< OperType, ArrType >, ArrayMath::CumArrOperExec< RT, AT >, Array3DCopier< T >, Array2DCopier< T >, Array3DFloodfill< T >, ExtensionArray2DInterpol, TriangulationArray2DInterpol, InverseDistanceArray2DInterpol, and AGC< T >.

◆ quickAddToNrDone()

void ParallelTask::quickAddToNrDone ( int64_t loopidx )

protected

Call this from within your thread to say that you have done something, but not very often

◆ resetNrDone()

void ParallelTask::resetNrDone ( )

protected

◆ setProgressMeter()

void ParallelTask::setProgressMeter ( ProgressMeter * )

virtual

Must be called before execute()

Reimplemented from Task.

◆ sPosFinished()

static uiString ParallelTask::sPosFinished ( )

inlinestatic

◆ stopAllOnFailure()

virtual bool ParallelTask::stopAllOnFailure ( ) const

inlineprotectedvirtual

If one thread fails, should an attempt be made to stop the others? If true, enableWorkControl will be enabled, and threads should call shouldContinue() regularly.

Reimplemented in LogCubeCreator.

◆ sTrcFinished()

static uiString ParallelTask::sTrcFinished ( )

inlinestatic

◆ totalNr()

int64_t ParallelTask::totalNr ( ) const

inlinevirtual

Reimplemented from Task.

Reimplemented in GMTArray2DInterpol, VolProc::TutOpCalculatorTask, LogCubeCreator, VolProc::StatsCalculatorTask, visBase::HorizonTileRenderPreparer, Seis::RaySynthGenerator, Seis::MultiTraceSynthGenerator, PreStack::AGC, and ContinuousCurvatureArray2DInterpol.

Friends And Related Function Documentation

◆ ParallelTaskRunner

friend class ParallelTaskRunner

friend

Member Data Documentation

◆ nrdone_

Threads::Atomic< int64_t > ParallelTask::nrdone_

private

◆ nrdonebigchunksz_

int64_t ParallelTask::nrdonebigchunksz_

private

◆ progressmeter_

ProgressMeter* ParallelTask::progressmeter_

private

◆ totalnrcache_

int64_t ParallelTask::totalnrcache_

private

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~ParallelTask()

◆ ParallelTask() [1/2]

◆ ParallelTask() [2/2]

Member Function Documentation

◆ addToNrDone()

◆ calculateThreadSize()

◆ doFinish()

◆ doPrepare()

◆ doWork()

◆ execute()

◆ executeParallel()

◆ maxNrThreads()

◆ minThreadSize()

◆ nrDone()

◆ nrIterations()

◆ quickAddToNrDone()

◆ resetNrDone()

◆ setProgressMeter()

◆ sPosFinished()

◆ stopAllOnFailure()

◆ sTrcFinished()

◆ totalNr()

Friends And Related Function Documentation

◆ ParallelTaskRunner

Member Data Documentation

◆ nrdone_

◆ nrdonebigchunksz_

◆ progressmeter_

◆ totalnrcache_