Base class from which all concrete algorithm classes should be derived. More...

#include <Algorithm.h>

Inheritance diagram for Mantid::API::Algorithm:

Classes
class	AlgorithmNotification
	Base class for algorithm notifications. More...

class	CancelException
	CancelException is thrown to cancel execution of the algorithm. More...

class	ErrorNotification
	ErrorNotification is sent when an exception is caught during execution of the algorithm. More...

class	FinishedNotification
	FinishedNotification is sent after the algorithm finishes its execution. More...

class	ProgressNotification
	An algorithm can report its progress by sending ProgressNotification. More...

class	StartedNotification
	StartedNotification is sent when the algorithm begins execution. More...

Public Member Functions
	Algorithm ()
	Constructor. More...

	Algorithm (const Algorithm &)=delete

Algorithm &	operator= (const Algorithm &)=delete

	~Algorithm () override
	Virtual destructor. More...

IAlgorithm methods
void	initialize () override
	Initialization method invoked by the framework. More...

bool	execute () override final
	The actions to be performed by the algorithm on a dataset. More...

void	addTimer (const std::string &name, const Kernel::time_point_ns &begin, const Kernel::time_point_ns &end)

void	executeAsChildAlg () override
	Execute as a Child Algorithm. More...

std::map< std::string, std::string >	validateInputs () override
	Perform validation of ALL the input properties of the algorithm. More...

ExecutionState	executionState () const override
	Gets the current execution state. More...

ResultState	resultState () const override
	Gets the current result State. More...

bool	isInitialized () const override
	Has the Algorithm already been initialized. More...

bool	isExecuted () const override
	Has the Algorithm already been executed successfully. More...

bool	isRunning () const override
	True if the algorithm is running. More...

bool	isReadyForGarbageCollection () const override
	True if the algorithm is ready for garbage collection. More...

bool	isChild () const override
	To query whether algorithm is a child. More...

void	setChild (const bool isChild) override
	To set whether algorithm is a child. More...

void	enableHistoryRecordingForChild (const bool on) override
	Change the state of the history recording flag. More...

bool	isRecordingHistoryForChild ()

void	setAlwaysStoreInADS (const bool doStore) override
	Do we ALWAYS store in the AnalysisDataService? This is set to true for python algorithms' child algorithms. More...

bool	getAlwaysStoreInADS () const override
	Returns true if we always store in the AnalysisDataService. More...

void	setRethrows (const bool rethrow) override
	Set whether the algorithm will rethrow exceptions. More...

Asynchronous Execution
Poco::ActiveResult< bool >	executeAsync () override
	Asynchronous execution. More...

void	addObserver (const Poco::AbstractObserver &observer) const override
	Add an observer for a notification. More...

void	removeObserver (const Poco::AbstractObserver &observer) const override
	Remove an observer. More...

void	cancel () override
	Raises the cancel flag. More...

bool	getCancel () const
	Returns the cancellation state. More...

Kernel::Logger &	getLogger () const
	Returns a reference to the logger. More...

void	setLogging (const bool value) override
	Logging can be disabled by passing a value of false. More...

bool	isLogging () const override
	returns the status of logging, True = enabled More...

void	setLoggingOffset (const int value) override
	gets the logging priority offset More...

int	getLoggingOffset () const override
	returns the logging priority offset More...

void	setAlgStartupLogging (const bool enabled) override
	disable Logging of start and end messages More...

bool	getAlgStartupLogging () const override
	get the state of Logging of start and end messages More...

void	setChildStartProgress (const double startProgress) const override
	setting the child start progress More...

void	setChildEndProgress (const double endProgress) const override
	setting the child end progress More...

virtual void	addObserver (const Poco::AbstractObserver &observer) const =0
	Add an observer for a notification. More...

virtual const std::string	alias () const =0
	function to return any aliases of the algorithm. More...

virtual const std::string	aliasDeprecated () const =0
	Expiration date (in ISO8601 format) for the algorithm aliases. Empty if no expiration date. More...

virtual void	cancel ()=0
	Raises the cancel flag. More...

virtual const std::vector< std::string >	categories () const =0
	Function to return all of the categories that contain this algorithm. More...

virtual const std::string	category () const =0
	function to return a category of the algorithm. More...

virtual const std::string	categorySeparator () const =0
	Function to return the separator token for the category string. More...

virtual void	enableHistoryRecordingForChild (const bool on)=0
	If true history will be recorded for a child. More...

virtual bool	execute ()=0
	System execution. More...

virtual void	executeAsChildAlg ()=0
	Execute as a Child Algorithm, with try/catch. More...

virtual Poco::ActiveResult< bool >	executeAsync ()=0
	Asynchronous execution of the algorithm. More...

virtual ExecutionState	executionState () const =0
	Gets the current execution state. More...

virtual AlgorithmID	getAlgorithmID () const =0
	Algorithm ID. More...

virtual bool	getAlgStartupLogging () const =0
	get the state of Logging of start and end messages More...

virtual bool	getAlwaysStoreInADS () const =0
	To query whether the output is stored in the analysis data service. More...

virtual int	getLoggingOffset () const =0
	returns the logging priority offset More...

virtual const std::string	helpURL () const =0
	function to return an optional URL for documentation. More...

virtual void	initialize ()=0
	Initialization method invoked by the framework. More...

virtual bool	isChild () const =0
	To query whether algorithm is a child. Default to false. More...

virtual bool	isExecuted () const =0
	Check whether the algorithm has been executed sucessfully. More...

virtual bool	isInitialized () const =0
	Check whether the algorithm is initialized properly. More...

virtual bool	isLogging () const =0
	returns the status of logging, True = enabled More...

virtual bool	isReadyForGarbageCollection () const =0
	True if the algorithm is ready for garbage collection. More...

virtual bool	isRunning () const =0
	True if the algorithm is running. More...

virtual const std::string	name () const =0
	function to return a name of the algorithm, must be overridden in all algorithms More...

virtual void	removeObserver (const Poco::AbstractObserver &observer) const =0
	Remove an observer. More...

virtual ResultState	resultState () const =0
	Gets the currnet result State. More...

virtual const std::vector< std::string >	seeAlso () const =0
	Function to return all of the seeAlso algorithms related to this algorithm. More...

virtual void	setAlgStartupLogging (const bool enabled)=0
	disable Logging of start and end messages More...

virtual void	setAlwaysStoreInADS (const bool doStore)=0
	Set whether we always store the output in the analysis data service. More...

virtual void	setChild (const bool isChild)=0
	To set whether algorithm is a child. More...

virtual void	setChildEndProgress (const double endProgress) const =0
	setting the child end progress More...

virtual void	setChildStartProgress (const double startProgress) const =0
	setting the child start progress More...

virtual void	setLogging (const bool value)=0
	Logging can be disabled by passing a value of false. More...

virtual void	setLoggingOffset (const int value)=0
	gets the logging priority offset More...

virtual void	setRethrows (const bool rethrow)=0
	To query whether an algorithm should rethrow exceptions when executing. More...

virtual const std::string	summary () const =0
	function returns a summary message that will be displayed in the default GUI, and in the help. More...

virtual ::Json::Value	toJson () const =0
	Serialize an algorithm as Json. More...

virtual std::string	toString () const =0
	Serialize an algorithm. More...

virtual std::map< std::string, std::string >	validateInputs ()=0
	Method checking errors on ALL the inputs, before execution. More...

virtual int	version () const =0
	function to return a version of the algorithm, must be overridden in all algorithms More...

Algorithms As Methods
Public Member Functions inherited from Mantid::Kernel::IPropertyManager
virtual ::Json::Value	asJson (bool withDefaultValues=false) const =0
	Return the property manager serialized as a json object. More...

virtual std::string	asString (bool withDefaultValues=false) const =0
	Return the property manager serialized as a string. More...

virtual void	declareOrReplaceProperty (std::unique_ptr< Property > p, const std::string &doc="")=0
	Function to declare properties (i.e. store them) More...

void	declareProperty (const std::string &name, const char *value, const std::string &doc, IValidator_sptr validator=std::make_shared< NullValidator >(), const unsigned int direction=Direction::Input)
	Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string). More...

void	declareProperty (const std::string &name, const char *value, const unsigned int direction)
	Add a property of string type to the list of managed properties. More...

void	declareProperty (const std::string &name, const char *value, IValidator_sptr validator=std::make_shared< NullValidator >(), const std::string &doc=std::string(), const unsigned int direction=Direction::Input)
	Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string). More...

template<typename T >
void	declareProperty (const std::string &name, T value, const std::string &doc, const unsigned int direction=Direction::Input)
	Add a property to the list of managed properties with no validator. More...

template<typename T >
void	declareProperty (const std::string &name, T value, const unsigned int direction)
	Add a property of the template type to the list of managed properties. More...

template<typename T >
void	declareProperty (const std::string &name, T value, IValidator_sptr validator=std::make_shared< NullValidator >(), const std::string &doc="", const unsigned int direction=Direction::Input)
	Add a property of the template type to the list of managed properties. More...

virtual void	declareProperty (std::unique_ptr< Property > p, const std::string &doc="")=0
	Function to declare properties (i.e. store them) More...

virtual bool	existsProperty (const std::string &name) const =0
	Checks whether the named property is already in the list of managed property. More...

virtual void	filterByProperty (const TimeSeriesProperty< bool > &, const std::vector< std::string > &)=0

virtual void	filterByTime (const Types::Core::DateAndTime &, const Types::Core::DateAndTime &)=0

virtual std::vector< std::string >	getDeclaredPropertyNames () const noexcept=0
	Get the list of managed property names. More...

virtual Property *	getPointerToProperty (const std::string &name) const =0
	Get a pointer to property by name. More...

virtual const std::vector< Property * > &	getProperties () const =0
	Get the list of managed properties. More...

std::vector< Property * >	getPropertiesInGroup (const std::string &group) const
	Get the list of managed properties in a given group. More...

virtual TypedValue	getProperty (const std::string &name) const =0
	Get the value of a property. More...

virtual std::string	getPropertyValue (const std::string &name) const =0
	Get the value of a property as a string. More...

virtual size_t	propertyCount () const =0
	Returns the number of properties under management. More...

virtual void	removeProperty (const std::string &name, const bool delproperty=true)=0
	Removes the property from management. More...

virtual void	resetProperties ()=0

virtual void	setProperties (const ::Json::Value &jsonValue, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >(), bool createMissing=false)=0
	Sets all the properties from a json object. More...

virtual void	setProperties (const std::string &propertiesJson, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >(), bool createMissing=false)=0
	Sets all properties from a string. More...

virtual void	setPropertiesWithString (const std::string &propertiesString, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >())=0
	Sets all the declared properties from a string. More...

IPropertyManager *	setProperty (const std::string &name, const char *value)
	Specialised version of setProperty template method to handle const char *. More...

IPropertyManager *	setProperty (const std::string &name, const std::string &value)
	Specialised version of setProperty template method to handle std::string. More...

template<typename T >
IPropertyManager *	setProperty (const std::string &name, const T &value)
	Templated method to set the value of a PropertyWithValue. More...

template<typename T >
IPropertyManager *	setProperty (const std::string &name, std::unique_ptr< T > value)
	Templated method to set the value of a PropertyWithValue from a std::unique_ptr. More...

void	setPropertyGroup (const std::string &name, const std::string &group)
	Set the group for a given property. More...

virtual void	setPropertyOrdinal (const int &index, const std::string &value)=0
	Set the value of a property by an index. More...

void	setPropertySettings (const std::string &name, std::unique_ptr< IPropertySettings > settings)

virtual void	setPropertyValue (const std::string &name, const std::string &value)=0
	Sets property value from a string. More...

virtual void	setPropertyValueFromJson (const std::string &name, const Json::Value &value)=0
	Sets property value from a Json::Value. More...

virtual void	splitByTime (std::vector< SplittingInterval > &, std::vector< PropertyManager * >) const =0

virtual std::unique_ptr< Property >	takeProperty (const size_t index)=0
	Removes the property from management and returns a pointer to it. More...

void	updatePropertyValues (const IPropertyManager &other)
	Update values of the existing properties. More...

virtual bool	validateProperties () const =0
	Validates all the properties in the collection. More...

virtual	~IPropertyManager ()=default

Serialization functions
using	WorkspaceVector = std::vector< std::shared_ptr< Workspace > >

std::string	toString () const override
	Serialize an object to a string. More...

::Json::Value	toJson () const override
	Serialize an object to a json object. More...

virtual std::shared_ptr< Algorithm >	createChildAlgorithm (const std::string &name, const double startProgress=-1., const double endProgress=-1., const bool enableLogging=true, const int &version=-1)
	Create a Child Algorithm. More...

void	setupAsChildAlgorithm (const Algorithm_sptr &algorithm, const double startProgress=-1., const double endProgress=-1., const bool enableLogging=true)
	Setup algorithm as child algorithm. More...

void	trackAlgorithmHistory (std::shared_ptr< AlgorithmHistory > parentHist)
	set whether we wish to track the child algorithm's history and pass it the parent object to fill. More...

void	findWorkspaces (WorkspaceVector &workspaces, unsigned int direction, bool checkADS=false) const
	Populate lists of the workspace properties for a given direction (InOut workspaces are included in both input/output) More...

virtual bool	checkGroups ()
	Check the input workspace properties for groups. More...

virtual bool	processGroups ()
	Process WorkspaceGroup inputs. More...

void	copyNonWorkspaceProperties (IAlgorithm *alg, int periodNum)
	Copy all the non-workspace properties from this to alg. More...

const Parallel::Communicator &	communicator () const
	Returns a const reference to the (MPI) communicator of the algorithm. More...

void	setCommunicator (const Parallel::Communicator &communicator)
	Sets the (MPI) communicator of the algorithm. More...

void	declareProperty (std::unique_ptr< Kernel::Property > p, const std::string &doc="") override
	Add a property to the list of managed properties. More...

void	declareOrReplaceProperty (std::unique_ptr< Kernel::Property > p, const std::string &doc="") override
	Add or replace property in the list of managed properties. More...

void	resetProperties () override
	Reset property values back to initial values (blank or default values) More...

void	setProperties (const std::string &propertiesJson, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >(), bool createMissing=false) override
	Set the ordered list of properties by one string of values, separated by semicolons. More...

void	setProperties (const ::Json::Value &jsonValue, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >(), bool createMissing=false) override
	Sets all the declared properties from a json object. More...

void	setPropertiesWithString (const std::string &propertiesString, const std::unordered_set< std::string > &ignoreProperties=std::unordered_set< std::string >()) override
	Sets all the declared properties from a string. More...

void	setPropertyValue (const std::string &name, const std::string &value) override
	Set the value of a property by string N.B. More...

void	setPropertyValueFromJson (const std::string &name, const Json::Value &value) override
	Set the value of a property by Json::Value object. More...

void	setPropertyOrdinal (const int &index, const std::string &value) override
	Set the value of a property by an index N.B. More...

virtual void	copyPropertiesFrom (const Algorithm &alg)
	Make m_properties point to the same PropertyManager as alg.m_properties. More...

bool	existsProperty (const std::string &name) const override
	Checks whether the named property is already in the list of managed property. More...

bool	validateProperties () const override
	Validates all the properties in the collection. More...

size_t	propertyCount () const override
	Count the number of properties under management. More...

std::string	getPropertyValue (const std::string &name) const override
	Get the value of a property as a string. More...

const std::vector< Kernel::Property * > &	getProperties () const override
	Get the list of managed properties. More...

std::vector< std::string >	getDeclaredPropertyNames () const noexcept override
	Return the list of declared property names. More...

TypedValue	getProperty (const std::string &name) const override
	Get the value of a property. More...

std::string	asString (bool withDefaultValues=false) const override
	Return the property manager serialized as a string. More...

::Json::Value	asJson (bool withDefaultValues=false) const override
	Return the property manager serialized as a json object. More...

bool	isDefault (const std::string &name) const

void	removeProperty (const std::string &name, const bool delproperty=true) override
	Removes the property from management. More...

std::unique_ptr< Kernel::Property >	takeProperty (const size_t index) override
	Removes the property from management and returns a pointer to it. More...

void	clear () override
	Clears all properties under management. More...

void	afterPropertySet (const std::string &) override
	Override this method to perform a custom action right after a property was set. More...

void	filterByTime (const Types::Core::DateAndTime &, const Types::Core::DateAndTime &) override

void	splitByTime (std::vector< Kernel::SplittingInterval > &, std::vector< Kernel::PropertyManager * >) const override

void	filterByProperty (const Kernel::TimeSeriesProperty< bool > &, const std::vector< std::string > &) override

Kernel::Property *	getPointerToProperty (const std::string &name) const override
	Get a property by name. More...

Kernel::Property *	getPointerToPropertyOrdinal (const int &index) const override
	Get a property by an index. More...

virtual void	declareProperty (std::unique_ptr< Property > p, const std::string &doc="")=0
	Function to declare properties (i.e. store them) More...

template<typename T >
void	declareProperty (const std::string &name, T value, IValidator_sptr validator=std::make_shared< NullValidator >(), const std::string &doc="", const unsigned int direction=Direction::Input)
	Add a property of the template type to the list of managed properties. More...

template<typename T >
void	declareProperty (const std::string &name, T value, const std::string &doc, const unsigned int direction=Direction::Input)
	Add a property to the list of managed properties with no validator. More...

template<typename T >
void	declareProperty (const std::string &name, T value, const unsigned int direction)
	Add a property of the template type to the list of managed properties. More...

void	declareProperty (const std::string &name, const char *value, IValidator_sptr validator=std::make_shared< NullValidator >(), const std::string &doc=std::string(), const unsigned int direction=Direction::Input)
	Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string). More...

void	declareProperty (const std::string &name, const char *value, const std::string &doc, IValidator_sptr validator=std::make_shared< NullValidator >(), const unsigned int direction=Direction::Input)
	Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string). More...

void	declareProperty (const std::string &name, const char *value, const unsigned int direction)
	Add a property of string type to the list of managed properties. More...

static IAlgorithm_sptr	fromString (const std::string &input)
	De-serialize an object from a string. More...

static IAlgorithm_sptr	fromJson (const Json::Value &input)
	De-serialize an object from a Json. More...

static IAlgorithm_sptr	fromHistory (const AlgorithmHistory &history)
	Construct an object from a history entry. More...

virtual void	init ()=0
	Virtual method - must be overridden by concrete algorithm. More...

virtual void	exec ()=0
	Virtual method - must be overridden by concrete algorithm. More...

void	exec (Parallel::ExecutionMode executionMode)
	Runs the algorithm with the specified execution mode. More...

virtual void	execDistributed ()
	Runs the algorithm in `distributed` execution mode. More...

virtual void	execMasterOnly ()
	Runs the algorithm in `master-only` execution mode. More...

virtual Parallel::ExecutionMode	getParallelExecutionMode (const std::map< std::string, Parallel::StorageMode > &storageModes) const
	Get correct execution mode based on input storage modes for an MPI run. More...

virtual const std::string	workspaceMethodOnTypes () const
	Returns a semi-colon separated list of workspace types to attach this algorithm. More...

void	cacheWorkspaceProperties ()
	Go through the properties and cache the input/output workspace properties for later use. More...

void	cacheInputWorkspaceHistories ()
	Cache the histories of any input workspaces so they can be copied over after algorithm completion. More...

void	setExecutionState (const ExecutionState state)
	Sets the current execution state. More...

void	setResultState (const ResultState state)
	Sets the result execution state. More...

void	store ()
	Stores any output workspaces into the AnalysisDataService. More...

Algorithm Information
bool	calledByAlias = false
	Flag to indicate if the algorithm is called by its alias. More...

const std::string	name () const override=0
	function to return a name of the algorithm, must be overridden in all algorithms More...

int	version () const override=0
	function to return a version of the algorithm, must be overridden in all algorithms More...

const std::string	summary () const override=0
	function returns a summary message that will be displayed in the default GUI, and in the help. More...

const std::string	category () const override
	function to return a category of the algorithm. More...

const std::vector< std::string >	categories () const override
	Function to return all of the categories that contain this algorithm. More...

const std::string	categorySeparator () const override
	Function to return the separator token for the category string. More...

const std::vector< std::string >	seeAlso () const override
	Function to return all of the seeAlso (these are not validated) algorithms related to this algorithm.A default implementation is provided. More...

const std::string	alias () const override
	function to return any aliases to the algorithm; A default implementation is provided More...

const std::string	aliasDeprecated () const override
	Expiration date (in ISO8601 format) for the algorithm aliases; default implementation for no expiration date. More...

const std::string	helpURL () const override
	function to return URL for algorithm documentation; A default implementation is provided. More...

template<typename T , typename = typename std::enable_if<std::is_convertible<T , MatrixWorkspace >::value>::type>
std::tuple< std::shared_ptr< T >, Indexing::SpectrumIndexSet >	getWorkspaceAndIndices (const std::string &name) const

template<typename T1 , typename T2 , typename = typename std::enable_if<std::is_convertible<T1 , MatrixWorkspace >::value>::type, typename = typename std::enable_if<std::is_convertible<T2 , std::string >::value \|\| std::is_convertible<T2 , std::vector<int64_t> >::value>::type>
void	setWorkspaceInputProperties (const std::string &name, const std::shared_ptr< T1 > &wksp, IndexType type, const T2 &list)

template<typename T1 , typename T2 , typename = typename std::enable_if<std::is_convertible<T1 , MatrixWorkspace >::value>::type, typename = typename std::enable_if<std::is_convertible<T2 , std::string >::value \|\| std::is_convertible<T2 , std::vector<int64_t> >::value>::type>
void	setWorkspaceInputProperties (const std::string &name, const std::string &wsName, IndexType type, const T2 &list)

const std::string	workspaceMethodName () const override

const std::vector< std::string >	workspaceMethodOn () const override

const std::string	workspaceMethodInputProperty () const override

AlgorithmID	getAlgorithmID () const override
	Algorithm ID. More...

Progress Reporting functions
class	Progress

class	WorkspaceHistory

std::atomic< bool >	m_cancel
	Set to true to stop execution. More...

std::atomic< bool >	m_parallelException
	Set if an exception is thrown, and not caught, within a parallel region. More...

std::vector< IWorkspaceProperty * >	m_inputWorkspaceProps
	All the WorkspaceProperties that are Input or InOut. Set in execute() More...

std::shared_ptr< AlgorithmHistory >	m_history
	Pointer to the history for the algorithm being executed. More...

Kernel::Logger	m_log
	Logger for this algorithm. More...

Kernel::Logger &	g_log

std::shared_ptr< AlgorithmHistory >	m_parentHistory
	Pointer to the parent history object (if set) More...

std::vector< WorkspaceVector >	m_unrolledInputWorkspaces
	One vector of workspaces for each input workspace property. More...

size_t	m_groupSize
	Size of the group(s) being processed. More...

bool	m_usingBaseProcessGroups = false
	distinguish between base processGroups() and overriden/algorithm specific versions More...

static size_t	g_execCount = 0
	Counter to keep track of algorithm execution order. More...

std::unique_ptr< Poco::ActiveMethod< bool, Poco::Void, Algorithm, Poco::ActiveStarter< Algorithm > > >	m_executeAsync
	Poco::ActiveMethod used to implement asynchronous execution. More...

std::unique_ptr< Poco::NotificationCenter >	m_notificationCenter
	Sends notifications to observers. More...

std::unique_ptr< Poco::NObserver< Algorithm, ProgressNotification > >	m_progressObserver
	Child algorithm progress observer. More...

std::atomic< ExecutionState >	m_executionState
	the current execution state More...

std::atomic< ResultState >	m_resultState
	the current result State More...

bool	m_isChildAlgorithm
	Algorithm is a child algorithm. More...

bool	m_recordHistoryForChild
	Flag to indicate whether history should be recorded. More...

bool	m_alwaysStoreInADS
	Always store in the ADS, even for child algos. More...

bool	m_runningAsync
	Algorithm is running asynchronously. More...

bool	m_rethrow
	Algorithm should rethrow exceptions while executing. More...

bool	m_isAlgStartupLoggingEnabled

double	m_startChildProgress
	Whether to log alg startup and closedown messages from the base class (default = true) More...

double	m_endChildProgress
	Keeps value for algorithm's progress at Child Algorithm's finish. More...

AlgorithmID	m_algorithmID
	Algorithm ID for managed algorithms. More...

std::vector< std::weak_ptr< IAlgorithm > >	m_ChildAlgorithms
	A list of weak pointers to any child algorithms created. More...

WorkspaceVector	m_readLockedWorkspaces
	Vector of all the workspaces that have been read-locked. More...

WorkspaceVector	m_writeLockedWorkspaces
	Vector of all the workspaces that have been write-locked. More...

std::vector< IWorkspaceProperty * >	m_outputWorkspaceProps
	All the WorkspaceProperties that are Output or InOut. Set in execute() More...

std::vector< IWorkspaceProperty * >	m_pureOutputWorkspaceProps
	All the WorkspaceProperties that are Output (not inOut). Set in execute() More...

std::vector< std::shared_ptr< WorkspaceGroup > >	m_groupWorkspaces
	Pointer to the WorkspaceGroup (if any) for each input workspace property. More...

int	m_singleGroup
	If only one input is a group, this is its index. -1 if they are all groups. More...

bool	m_groupsHaveSimilarNames
	All the groups have similar names (group_1, group_2 etc.) More...

std::vector< Workspace_sptr >	m_inputWorkspaceHistories
	Store a pointer to the input workspace histories so they can be copied to the outputs to avoid anything being overwritten. More...

std::vector< std::string >	m_reservedList
	Reserved property names. More...

std::unique_ptr< Parallel::Communicator >	m_communicator
	(MPI) communicator used when executing the algorithm. More...

Mantid::Types::Core::DateAndTime	m_gcTime
	The earliest this class should be considered for garbage collection. More...

Mantid::Kernel::PropertyManagerOwner	m_properties

void	progress (double p, const std::string &msg="", double estimatedTime=0.0, int progressPrecision=0)
	Sends ProgressNotification. More...

void	interruption_point ()
	This is called during long-running operations, and check if the algorithm has requested that it be cancelled. More...

Poco::NotificationCenter &	notificationCenter () const
	Return a reference to the algorithm's notification dispatcher. More...

void	handleChildProgressNotification (const Poco::AutoPtr< ProgressNotification > &pNf)
	Observation slot for child algorithm progress notification messages, these are scaled and then signalled for this algorithm. More...

const Poco::AbstractObserver &	progressObserver () const
	Return a reference to the algorithm's object that is reporting progress. More...

bool	isWorkspaceProperty (const Kernel::Property *const prop) const
	checks the property is a workspace property More...

bool	trackingHistory ()
	get whether we are tracking the history for this algorithm, More...

virtual void	fillHistory ()
	Copy workspace history for input workspaces to output workspaces and record the history for ths algorithm. More...

virtual void	setOtherProperties (IAlgorithm *alg, const std::string &propertyName, const std::string &propertyValue, int periodNum)
	Virtual method to set the non workspace properties for this algorithm. More...

template<typename T , const int AllowedIndexTypes = static_cast<int>(IndexType::WorkspaceIndex), typename... WSPropArgs, typename = typename std::enable_if<std::is_convertible<T , MatrixWorkspace >::value>::type>
void	declareWorkspaceInputProperties (const std::string &propertyName, const std::string &doc, WSPropArgs &&...wsPropArgs)

template<typename NumT >
static bool	isEmpty (const NumT toCheck)
	checks that the value was not set by users, uses the value in empty double/int. More...

template<typename T1 , typename T2 , typename WsType >
void	doSetInputProperties (const std::string &name, const T1 &wksp, IndexType type, const T2 &list)

void	lockWorkspaces ()
	Go through the workspace properties of this algorithm and lock the workspaces for reading or writing. More...

void	unlockWorkspaces ()
	Unlock any previously locked workspaces. More...

void	clearWorkspaceCaches ()
	Clear any internal workspace handles so that workspaces will be deleted promptly after a managed algorithm finishes. More...

void	linkHistoryWithLastChild ()
	Link the name of the output workspaces on this parent algorithm. More...

void	logAlgorithmInfo () const
	Sends out algorithm parameter information to the logger. More...

bool	executeInternal ()
	Invoced internally in execute() More...

bool	executeAsyncImpl (const Poco::Void &i)
	Callback when an algorithm is executed asynchronously. More...

bool	doCallProcessGroups (Mantid::Types::Core::DateAndTime &start_time)
	Calls process groups with the required timing checks and algorithm execution finalization steps. More...

void	fillHistory (const std::vector< Workspace_sptr > &outputWorkspaces)
	If this algorithm is not a child then copy history between the inputs and outputs and add a record for this algorithm. More...

void	reportCompleted (const double &duration, const bool groupProcessing=false)
	Report that the algorithm has completed. More...

void	registerFeatureUsage () const
	Registers the usage of the algorithm with the UsageService. More...

Parallel::ExecutionMode	getExecutionMode () const
	Get a (valid) execution mode for this algorithm. More...

std::map< std::string, Parallel::StorageMode >	getInputWorkspaceStorageModes () const
	Get map of storage modes of all input workspaces. More...

void	setupSkipValidationMasterOnly ()
	Sets up skipping workspace validation on non-master ranks for StorageMode::MasterOnly. More...

bool	isCompoundProperty (const std::string &name) const

Additional Inherited Members
Protected Member Functions inherited from Mantid::Kernel::IPropertyManager
virtual void	afterPropertySet (const std::string &)
	Override this method to perform a custom action right after a property was set. More...

virtual void	clear ()=0
	Clears all properties under management. More...

virtual Property *	getPointerToPropertyOrdinal (const int &index) const =0
	Get a property by an index. More...

template<typename T >
T	getValue (const std::string &name) const
	Templated method to get the value of a property. More...

template<>
MANTID_KERNEL_DLL PropertyManager_sptr	getValue (const std::string &name) const

template<>
MANTID_KERNEL_DLL PropertyManager_const_sptr	getValue (const std::string &name) const

Detailed Description

Base class from which all concrete algorithm classes should be derived.

In order for a concrete algorithm class to do anything useful the methods init() & exec() should be overridden.

Further text from Gaudi file....... The base class provides utility methods for accessing standard services (event data service etc.); for declaring properties which may be configured by the job options service; and for creating Child Algorithms. The only base class functionality which may be used in the constructor of a concrete algorithm is the declaration of member variables as properties. All other functionality, i.e. the use of services and the creation of Child Algorithms, may be used only in initialise() and afterwards (see the Gaudi user guide).

Author: Russell Taylor, Tessella Support Services plc; Based on the Gaudi class of the same name (see http://proj-gaudi.web.cern.ch/proj-gaudi/)

Date: 12/09/2007

Definition at line 85 of file Algorithm.h.

Member Typedef Documentation

◆ WorkspaceVector

using Mantid::API::Algorithm::WorkspaceVector = std::vector<std::shared_ptr<Workspace> >

Definition at line 291 of file Algorithm.h.

Constructor & Destructor Documentation

◆ Algorithm() [1/2]

Mantid::API::Algorithm::Algorithm ( )

Constructor.

Definition at line 111 of file Algorithm.cpp.

◆ Algorithm() [2/2]

Mantid::API::Algorithm::Algorithm ( const Algorithm & )

delete

◆ ~Algorithm()

Mantid::API::Algorithm::~Algorithm ( )

overridedefault

Virtual destructor.

Member Function Documentation

◆ addObserver()

void Mantid::API::Algorithm::addObserver ( const Poco::AbstractObserver & observer ) const

overridevirtual

Add an observer for a notification.

Add an observer to a notification.

Parameters

observer :: Reference to the observer to add

Implements Mantid::API::IAlgorithm.

Definition at line 211 of file Algorithm.cpp.

References notificationCenter().

◆ addTimer()

void Mantid::API::Algorithm::addTimer	(	const std::string &	name,
		const Kernel::time_point_ns &	begin,
		const Kernel::time_point_ns &	end
	)

Definition at line 24 of file AlgorithmExecute.cpp.

References name(), and UNUSED_ARG.

Referenced by Mantid::Algorithms::FilterEvents::createOutputWorkspacesSplitters(), and Mantid::Algorithms::FilterEvents::filterEventsBySplitters().

◆ afterPropertySet()

void Mantid::API::Algorithm::afterPropertySet ( const std::string & name )

overridevirtual

Override this method to perform a custom action right after a property was set.

The argument is the property name. Default - do nothing.

Parameters

name	:: A property name.

Reimplemented from Mantid::Kernel::IPropertyManager.

Reimplemented in Mantid::CurveFitting::IFittingAlgorithm.

Definition at line 2133 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::afterPropertySet(), m_properties, and name().

Referenced by setPropertyOrdinal(), setPropertyValue(), and setPropertyValueFromJson().

◆ alias()

const std::string Mantid::API::Algorithm::alias ( ) const

inlineoverridevirtual

function to return any aliases to the algorithm; A default implementation is provided

Implements Mantid::API::IAlgorithm.

Reimplemented in Mantid::DataHandling::CreateSampleShape, Mantid::DataHandling::FilterEventsByLogValuePreNexus, Mantid::DataHandling::Load, Mantid::DataHandling::LoadEventPreNexus2, Mantid::DataHandling::LoadPreNexusMonitors, Mantid::DataHandling::SaveDaveGrp, Mantid::DataHandling::SNSAppendGeometryToNexus, Mantid::DataHandling::UpdateInstrumentFromFile, and Mantid::MDAlgorithms::TransposeMD.

Definition at line 179 of file Algorithm.h.

◆ aliasDeprecated()

const std::string Mantid::API::Algorithm::aliasDeprecated ( ) const

inlineoverridevirtual

Expiration date (in ISO8601 format) for the algorithm aliases; default implementation for no expiration date.

Implements Mantid::API::IAlgorithm.

Definition at line 184 of file Algorithm.h.

◆ asJson()

Json::Value Mantid::API::Algorithm::asJson ( bool withDefaultValues = false ) const

overridevirtual

Return the property manager serialized as a json object.

Parameters

withDefaultValues :: If true then the value of default parameters will be included

Returns: A jsonValue of the manager

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2102 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::asJson(), and m_properties.

◆ asString()

std::string Mantid::API::Algorithm::asString ( bool withDefaultValues = false ) const

overridevirtual

Return the property manager serialized as a string.

The format is propName=value,propName=value,propName=value

Parameters

withDefaultValues :: If true then the value of default parameters will be included

Returns: A stringized version of the manager

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2095 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::asString(), and m_properties.

◆ cacheInputWorkspaceHistories()

void Mantid::API::Algorithm::cacheInputWorkspaceHistories ( )

protected

Cache the histories of any input workspaces so they can be copied over after algorithm completion.

Definition at line 363 of file Algorithm.cpp.

References getProperties(), Mantid::Kernel::Direction::InOut, Mantid::Kernel::Direction::Input, Mantid::Kernel::SingletonHolder< T >::Instance(), m_inputWorkspaceHistories, name(), and trackingHistory().

Referenced by executeInternal().

◆ cacheWorkspaceProperties()

void Mantid::API::Algorithm::cacheWorkspaceProperties ( )

protected

Go through the properties and cache the input/output workspace properties for later use.

Definition at line 331 of file Algorithm.cpp.

References getProperties(), Mantid::Kernel::Direction::InOut, Mantid::Kernel::Direction::Input, m_inputWorkspaceProps, m_outputWorkspaceProps, m_pureOutputWorkspaceProps, and Mantid::Kernel::Direction::Output.

Referenced by executeInternal().

◆ cancel()

void Mantid::API::Algorithm::cancel ( )

overridevirtual

Raises the cancel flag.

Cancel an algorithm.

Implements Mantid::API::IAlgorithm.

Reimplemented in Mantid::DataHandling::Load.

Definition at line 1644 of file Algorithm.cpp.

References m_cancel, and m_ChildAlgorithms.

Referenced by Mantid::ICat::CatalogDownloadDataFiles::doDownloadandSavetoLocalDrive(), and Mantid::ICat::CatalogPublish::publish().

◆ categories()

const std::vector< std::string > Mantid::API::Algorithm::categories ( ) const

overridevirtual

Function to return all of the categories that contain this algorithm.

Implements Mantid::API::IAlgorithm.

Definition at line 237 of file Algorithm.cpp.

References Mantid::Kernel::StringTokenizer::asVector(), category(), categorySeparator(), Mantid::Kernel::StringTokenizer::TOK_IGNORE_EMPTY, and Mantid::Kernel::StringTokenizer::TOK_TRIM.

◆ category()

const std::string Mantid::API::Algorithm::category ( ) const

inlineoverridevirtual

function to return a category of the algorithm.

A default implementation is provided

Implements Mantid::API::IAlgorithm.

Definition at line 169 of file Algorithm.h.

Referenced by categories().

◆ categorySeparator()

const std::string Mantid::API::Algorithm::categorySeparator ( ) const

inlineoverridevirtual

Function to return the separator token for the category string.

A default implementation ';' is provided

Implements Mantid::API::IAlgorithm.

Definition at line 174 of file Algorithm.h.

Referenced by categories().

◆ checkGroups()

bool Mantid::API::Algorithm::checkGroups ( )

virtual

Check the input workspace properties for groups.

If there are more than one input workspace properties, then:

All inputs should be groups of the same size
- In this case, algorithms are processed in order
OR, only one input should be a group, the others being size of 1

If the property itself is a WorkspaceProperty<WorkspaceGroup> then this returns false

Returns true if processGroups() should be called. It also sets up some other members.

Override if it is needed to customize the group checking.

Exceptions

std::invalid_argument	if the groups sizes are incompatible.
std::invalid_argument	if a member is not found

This method (or an override) must NOT THROW any exception if there are no input workspace groups

Reimplemented in Mantid::Algorithms::DeleteWorkspace, Mantid::Algorithms::DiscusMultipleScatteringCorrection, Mantid::Algorithms::SassenaFFT, Mantid::Algorithms::Stitch1DMany, Mantid::API::MultiPeriodGroupAlgorithm, Mantid::DataHandling::SaveReflectometryAscii, Mantid::ICat::CatalogPublish, and Mantid::PythonInterface::RunPythonScript.

Definition at line 1154 of file Algorithm.cpp.

References Mantid::API::WorkspaceProperty< TYPE >::getWorkspace(), Mantid::Kernel::SingletonHolder< T >::Instance(), m_groupsHaveSimilarNames, m_groupSize, m_groupWorkspaces, m_inputWorkspaceProps, m_singleGroup, m_unrolledInputWorkspaces, and processGroups().

Referenced by Mantid::Algorithms::DeleteWorkspace::checkGroups(), Mantid::API::MultiPeriodGroupAlgorithm::checkGroups(), and executeInternal().

◆ clear()

void Mantid::API::Algorithm::clear ( )

overridevirtual

Clears all properties under management.

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2125 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::clear(), and m_properties.

Referenced by Mantid::Algorithms::BinaryOperation::do2D(), and Mantid::Algorithms::He3TubeEfficiency::He3TubeEfficiency().

◆ clearWorkspaceCaches()

void Mantid::API::Algorithm::clearWorkspaceCaches ( )

private

Clear any internal workspace handles so that workspaces will be deleted promptly after a managed algorithm finishes.

Definition at line 499 of file Algorithm.cpp.

References m_groupWorkspaces, m_inputWorkspaceHistories, m_inputWorkspaceProps, m_outputWorkspaceProps, m_pureOutputWorkspaceProps, and m_unrolledInputWorkspaces.

Referenced by executeInternal().

◆ communicator()

const Parallel::Communicator & Mantid::API::Algorithm::communicator ( ) const

Returns a const reference to the (MPI) communicator of the algorithm.

Definition at line 1870 of file Algorithm.cpp.

References m_communicator.

Referenced by Mantid::Algorithms::GroupWorkspaces::addToGroup(), Mantid::Algorithms::ConvertUnits::alignBins(), Mantid::DataHandling::LoadEventNexus::createSpectraMapping(), Mantid::Algorithms::CreateSingleValuedWorkspace::exec(), Mantid::Algorithms::CreateWorkspace::exec(), Mantid::Algorithms::Q1D2::exec(), execMasterOnly(), Mantid::Algorithms::CompareWorkspaces::execMasterOnly(), executeInternal(), getExecutionMode(), setCommunicator(), Mantid::Algorithms::Q1D2::setUpOutputWorkspace(), and setupSkipValidationMasterOnly().

◆ copyNonWorkspaceProperties()

void Mantid::API::Algorithm::copyNonWorkspaceProperties	(	IAlgorithm *	alg,
		int	periodNum
	)

Copy all the non-workspace properties from this to alg.

Parameters

alg	:: other IAlgorithm
periodNum	:: number of the "period" = the entry in the group + 1

Definition at line 1523 of file Algorithm.cpp.

References getProperties(), Mantid::API::IAlgorithm::name(), and setOtherProperties().

Referenced by processGroups(), and Mantid::API::MultiPeriodGroupWorker::processGroups().

◆ copyPropertiesFrom()

virtual void Mantid::API::Algorithm::copyPropertiesFrom ( const Algorithm & alg )

inlinevirtual

Make m_properties point to the same PropertyManager as alg.m_properties.

Definition at line 332 of file Algorithm.h.

References m_properties.

Referenced by Mantid::DataHandling::LoadMuonNexus2::exec(), and Mantid::DataHandling::LoadMuonNexusV2::runLoadISISNexus().

◆ createChildAlgorithm()

Algorithm_sptr Mantid::API::Algorithm::createChildAlgorithm	(	const std::string &	name,
		const double	startProgress = `-1.`,
		const double	endProgress = `-1.`,
		const bool	enableLogging = `true`,
		const int &	version = `-1`
	)

virtual

Create a Child Algorithm.

A call to this method creates a child algorithm object. Using this mechanism instead of creating daughter algorithms directly via the new operator is prefered since then the framework can take care of all of the necessary book-keeping.

Parameters

name	:: The concrete algorithm class of the Child Algorithm
startProgress	:: The percentage progress value of the overall algorithm where this child algorithm starts
endProgress	:: The percentage progress value of the overall algorithm where this child algorithm ends
enableLogging	:: Set to false to disable logging from the child algorithm
version	:: The version of the child algorithm to create. By default gives the latest version.

Returns: shared pointer to the newly created algorithm object

Reimplemented in Mantid::API::NexusFileLoader.

Definition at line 842 of file Algorithm.cpp.

References Mantid::Kernel::SingletonHolder< T >::Instance(), name(), setupAsChildAlgorithm(), and version().

◆ declareOrReplaceProperty()

void Mantid::API::Algorithm::declareOrReplaceProperty	(	std::unique_ptr< Kernel::Property >	p,
		const std::string &	doc = `""`
	)

overridevirtual

Add or replace property in the list of managed properties.

Parameters

p	:: The property object to add
doc	:: A description of the property that may be displayed to users

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1921 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::declareOrReplaceProperty(), and m_properties.

Referenced by Mantid::DataHandling::Load::setOutputProperties().

◆ declareProperty() [1/8]

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		const char *	value,
		const std::string &	doc,
		IValidator_sptr	validator = `std::make_shared<NullValidator>()`,
		const unsigned int	direction = `Direction::Input`
	)

inline

Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string).

The validator, if provided, needs to be a string validator.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
doc	:: The (optional) documentation string
validator	:: Pointer to the (optional) validator. Ownership will be taken over.
direction	:: The (optional) direction of the property, in, out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty
std::invalid_argument	if value is a nullptr

Definition at line 165 of file IPropertyManager.h.

◆ declareProperty() [2/8]

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		const char *	value,
		const unsigned int	direction
	)

inline

Add a property of string type to the list of managed properties.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
direction	:: The direction of the property, in, out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty

Definition at line 182 of file IPropertyManager.h.

◆ declareProperty() [3/8]

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		const char *	value,
		IValidator_sptr	validator = `std::make_shared<NullValidator>()`,
		const std::string &	doc = `std::string()`,
		const unsigned int	direction = `Direction::Input`
	)

inline

Specialised version of declareProperty template method to prevent the creation of a PropertyWithValue of type const char* if an argument in quotes is passed (it will be converted to a string).

The validator, if provided, needs to be a string validator.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
validator	:: Pointer to the (optional) validator. Ownership will be taken over.
doc	:: The (optional) documentation string
direction	:: The (optional) direction of the property, in, out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty
std::invalid_argument	if value is a nullptr

Definition at line 136 of file IPropertyManager.h.

◆ declareProperty() [4/8]

template<typename T >

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		T	value,
		const std::string &	doc,
		const unsigned int	direction = `Direction::Input`
	)

inline

Add a property to the list of managed properties with no validator.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
doc	:: The documentation string
direction	:: The (optional) direction of the property, in (default), out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty

Definition at line 97 of file IPropertyManager.h.

◆ declareProperty() [5/8]

template<typename T >

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		T	value,
		const unsigned int	direction
	)

inline

Add a property of the template type to the list of managed properties.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
direction	:: The direction of the property, in, out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty

Definition at line 112 of file IPropertyManager.h.

◆ declareProperty() [6/8]

template<typename T >

void Mantid::Kernel::IPropertyManager::declareProperty	(	const std::string &	name,
		T	value,
		IValidator_sptr	validator = `std::make_shared<NullValidator>()`,
		const std::string &	doc = `""`,
		const unsigned int	direction = `Direction::Input`
	)

inline

Add a property of the template type to the list of managed properties.

Parameters

name	:: The name to assign to the property
value	:: The initial value to assign to the property
validator	:: Pointer to the (optional) validator.
doc	:: The (optional) documentation string
direction	:: The (optional) direction of the property, in, out or inout

Exceptions

Exception::ExistsError	if a property with the given name already exists
std::invalid_argument	if the name argument is empty

Definition at line 80 of file IPropertyManager.h.

◆ declareProperty() [7/8]

void Mantid::API::Algorithm::declareProperty	(	std::unique_ptr< Kernel::Property >	p,
		const std::string &	doc = `""`
	)

overridevirtual

Add a property to the list of managed properties.

Parameters

p	:: The property object to add
doc	:: A description of the property that may be displayed to users

Exceptions

Exception::ExistsError if a property with the given name already exists

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1913 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::declareProperty(), and m_properties.

◆ declareProperty() [8/8]

virtual void Mantid::Kernel::IPropertyManager::declareProperty	(	std::unique_ptr< Property >	p,
		const std::string &	doc = `""`
	)

virtual

Function to declare properties (i.e. store them)

Implements Mantid::Kernel::IPropertyManager.

◆ declareWorkspaceInputProperties()

template<typename T , const int AllowedIndexTypes = static_cast<int>(IndexType::WorkspaceIndex), typename... WSPropArgs, typename = typename std::enable_if<std::is_convertible<T *, MatrixWorkspace *>::value>::type>

void Mantid::API::Algorithm::declareWorkspaceInputProperties	(	const std::string &	propertyName,
		const std::string &	doc,
		WSPropArgs &&...	wsPropArgs
	)

protected

◆ doCallProcessGroups()

bool Mantid::API::Algorithm::doCallProcessGroups ( Mantid::Types::Core::DateAndTime & startTime )

private

Calls process groups with the required timing checks and algorithm execution finalization steps.

Parameters

startTime to record the algorithm execution start

Returns: whether processGroups succeeds.

Definition at line 1247 of file Algorithm.cpp.

References Mantid::Kernel::Timer::elapsed(), Mantid::API::Failed, fillHistory(), findWorkspaces(), g_execCount, interruption_point(), isExecuted(), m_alwaysStoreInADS, m_history, m_runningAsync, m_usingBaseProcessGroups, notificationCenter(), Mantid::Kernel::Direction::Output, processGroups(), reportCompleted(), setResultState(), store(), Mantid::API::Success, and trackingHistory().

Referenced by executeInternal().

◆ doSetInputProperties()

template<typename T1 , typename T2 , typename WsType >

void Mantid::API::Algorithm::doSetInputProperties	(	const std::string &	name,
		const T1 &	wksp,
		IndexType	type,
		const T2 &	list
	)

private

◆ enableHistoryRecordingForChild()

void Mantid::API::Algorithm::enableHistoryRecordingForChild ( const bool on )

overridevirtual

Change the state of the history recording flag.

Only applicable for child algorithms.

Parameters

on	:: The new state of the flag

Implements Mantid::API::IAlgorithm.

Definition at line 176 of file Algorithm.cpp.

References m_recordHistoryForChild.

Referenced by export_leaf_classes(), Mantid::Algorithms::Comment::init(), and trackAlgorithmHistory().

◆ exec() [1/2]

virtual void Mantid::API::Algorithm::exec ( )

protectedpure virtual

Virtual method - must be overridden by concrete algorithm.

Referenced by Mantid::DataHandling::LoadEMUTar::exec(), Mantid::DataHandling::LoadEMUHdf::exec(), exec(), execDistributed(), execMasterOnly(), and executeInternal().

◆ exec() [2/2]

void Mantid::API::Algorithm::exec ( Parallel::ExecutionMode executionMode )

protected

Runs the algorithm with the specified execution mode.

Definition at line 1757 of file Algorithm.cpp.

References exec(), execDistributed(), execMasterOnly(), and name().

◆ execDistributed()

void Mantid::API::Algorithm::execDistributed ( )

protectedvirtual

Runs the algorithm in distributed execution mode.

The default implementation runs the normal exec() method on all ranks. Classes inheriting from Algorithm can re-implement this if they support execution with multiple MPI ranks and require a special implementation for distributed execution.

Definition at line 1778 of file Algorithm.cpp.

References exec().

Referenced by exec().

◆ execMasterOnly()

void Mantid::API::Algorithm::execMasterOnly ( )

protectedvirtual

Runs the algorithm in master-only execution mode.

The default implementation runs the normal exec() method on rank 0 and nothing on all other ranks. As a consequence all output properties will have their default values, such as a nullptr for output workspaces. Classes inheriting from Algorithm can re-implement this if they support execution with multiple MPI ranks and require a special implementation for master-only execution.

Reimplemented in Mantid::Algorithms::CompareWorkspaces.

Definition at line 1788 of file Algorithm.cpp.

References communicator(), and exec().

Referenced by exec().

◆ execute()

bool Mantid::API::Algorithm::execute ( )

finaloverridevirtual

The actions to be performed by the algorithm on a dataset.

This method is invoked for top level algorithms by the application manager. This method invokes exec() method. For Child Algorithms either the execute() method or exec() method must be EXPLICITLY invoked by the parent algorithm.

Exceptions

runtime_error Thrown if algorithm or Child Algorithm cannot be executed

Returns: true if executed successfully.

Implements Mantid::API::IAlgorithm.

Definition at line 22 of file AlgorithmExecute.cpp.

References executeInternal().

Referenced by executeAsChildAlg(), executeAsyncImpl(), processGroups(), and SANSInstrumentCreationHelper::runLoadInstrument().

◆ executeAsChildAlg()

void Mantid::API::Algorithm::executeAsChildAlg ( )

overridevirtual

Execute as a Child Algorithm.

This runs execute() but catches errors so as to log the name of the failed Child Algorithm, if it fails.

Implements Mantid::API::IAlgorithm.

Definition at line 769 of file Algorithm.cpp.

References execute(), and name().

Referenced by Mantid::Crystal::GoniometerAnglesFromPhiRotation::exec().

◆ executeAsync()

Poco::ActiveResult< bool > Mantid::API::Algorithm::executeAsync ( )

overridevirtual

Asynchronous execution.

Implements Mantid::API::IAlgorithm.

Definition at line 1595 of file Algorithm.cpp.

References executeAsyncImpl(), and m_executeAsync.

◆ executeAsyncImpl()

bool Mantid::API::Algorithm::executeAsyncImpl ( const Poco::Void & i )

private

Callback when an algorithm is executed asynchronously.

Parameters

i	:: Unused argument

Returns: true if executed successfully.

Definition at line 1605 of file Algorithm.cpp.

References execute(), and m_runningAsync.

Referenced by executeAsync().

◆ executeInternal()

bool Mantid::API::Algorithm::executeInternal ( )

private

Invoced internally in execute()

Definition at line 512 of file Algorithm.cpp.

References cacheInputWorkspaceHistories(), cacheWorkspaceProperties(), calledByAlias, checkGroups(), clearWorkspaceCaches(), communicator(), Mantid::Kernel::Logger::debug(), doCallProcessGroups(), Mantid::Kernel::Timer::elapsed(), error, Mantid::Kernel::Logger::error(), exec(), existsProperty(), Mantid::API::Failed, fillHistory(), g_execCount, getAlgorithmID(), getExecutionMode(), getLogger(), getProperties(), Mantid::Kernel::SingletonHolder< T >::Instance(), interruption_point(), isExecuted(), isInitialized(), linkHistoryWithLastChild(), lockWorkspaces(), logAlgorithmInfo(), m_alwaysStoreInADS, m_gcTime, m_history, m_isChildAlgorithm, m_rethrow, m_runningAsync, name(), notificationCenter(), registerFeatureUsage(), reportCompleted(), Mantid::API::Running, setExecutionState(), setResultState(), store(), Mantid::API::Success, std::to_string(), trackingHistory(), unlockWorkspaces(), validateInputs(), validateProperties(), and Mantid::Kernel::Logger::warning().

Referenced by execute().

◆ executionState()

ExecutionState Mantid::API::Algorithm::executionState ( ) const

overridevirtual

Gets the current execution state.

Implements Mantid::API::IAlgorithm.

Definition at line 129 of file Algorithm.cpp.

References m_executionState.

Referenced by isExecuted(), isReadyForGarbageCollection(), and isRunning().

◆ existsProperty()

bool Mantid::API::Algorithm::existsProperty ( const std::string & name ) const

overridevirtual

Checks whether the named property is already in the list of managed property.

Parameters

name	:: The name of the property (case insensitive)

Returns: True if the property is already stored

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2008 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::existsProperty(), m_properties, and name().

Referenced by Mantid::Algorithms::FilterEvents::createOutputWorkspacesMatrixCase(), Mantid::Algorithms::FilterEvents::createOutputWorkspacesSplitters(), Mantid::Algorithms::FilterEvents::createOutputWorkspacesTableSplitterCase(), Mantid::DataHandling::LoadMuonNexus1::exec(), executeInternal(), Mantid::Algorithms::SpectrumAlgorithm::getWorkspaceIndexSet(), Mantid::Algorithms::FilterEvents::groupOutputWorkspace(), Mantid::CurveFitting::Algorithms::Fit::initializeMinimizer(), Mantid::DataHandling::Load::loadFileToWs(), Mantid::DataHandling::LoadEventNexus::loadInstrument(), Mantid::DataHandling::Load::loadSingleFile(), Mantid::CurveFitting::Functions::UserFunction1D::prepare(), Mantid::CurveFitting::IFittingAlgorithm::setFunction(), Mantid::DataHandling::LoadNexus::setOutputWorkspace(), Mantid::Algorithms::FindCenterOfMassPosition2::storeOutputWorkspace(), and Mantid::Algorithms::Rebin::validateInputs().

◆ fillHistory() [1/2]

void Mantid::API::Algorithm::fillHistory ( )

protectedvirtual

Copy workspace history for input workspaces to output workspaces and record the history for ths algorithm.

Fills History, Algorithm History and Algorithm Parameters.

Reimplemented in Mantid::Algorithms::ConjoinXRuns, and Mantid::Algorithms::MergeRuns.

Definition at line 994 of file Algorithm.cpp.

References fillHistory(), findWorkspaces(), isChild(), and Mantid::Kernel::Direction::Output.

Referenced by doCallProcessGroups(), executeInternal(), and fillHistory().

◆ fillHistory() [2/2]

void Mantid::API::Algorithm::fillHistory ( const std::vector< Workspace_sptr > & outputWorkspaces )

private

If this algorithm is not a child then copy history between the inputs and outputs and add a record for this algorithm.

If the algorithm is a child attach the child history to the parent if requested.

Parameters

outputWorkspaces :: A reference to a vector for the output workspaces. Used in the non-child case.

Definition at line 1315 of file Algorithm.cpp.

References Mantid::API::Workspace::getHistory(), isChild(), m_history, m_inputWorkspaceHistories, m_parentHistory, and m_recordHistoryForChild.

◆ filterByProperty()

void Mantid::API::Algorithm::filterByProperty	(	const Kernel::TimeSeriesProperty< bool > &	,
		const std::vector< std::string > &
	)

inlineoverridevirtual

Implements Mantid::Kernel::IPropertyManager.

Definition at line 373 of file Algorithm.h.

◆ filterByTime()

void Mantid::API::Algorithm::filterByTime	(	const Types::Core::DateAndTime &	,
		const Types::Core::DateAndTime &
	)

inlineoverridevirtual

Implements Mantid::Kernel::IPropertyManager.

Definition at line 365 of file Algorithm.h.

Referenced by Mantid::DataHandling::LoadEventNexus::filterEventsByTime().

◆ findWorkspaces()

void Mantid::API::Algorithm::findWorkspaces	(	WorkspaceVector &	workspaces,
		unsigned int	direction,
		bool	checkADS = `false`
	)		const

Populate lists of the workspace properties for a given direction (InOut workspaces are included in both input/output)

Parameters

workspaces	A reference to a vector for the workspaces
direction	The direction of the property required for the search
checkADS	If true, check the ADS for workspace references if the check on the workspace property value is empty. Most useful for finding group workspaces that are never stored on the property

Definition at line 1073 of file Algorithm.cpp.

References getProperties(), Mantid::API::IWorkspaceProperty::getWorkspace(), Mantid::Kernel::Direction::InOut, Mantid::Kernel::SingletonHolder< T >::Instance(), and workspace.

Referenced by doCallProcessGroups(), fillHistory(), and Mantid::API::MultiPeriodGroupWorker::findMultiPeriodGroups().

◆ fromHistory()

IAlgorithm_sptr Mantid::API::Algorithm::fromHistory ( const AlgorithmHistory & history )

static

Construct an object from a history entry.

This creates the algorithm and sets all of its properties using the history.

Parameters

history :: AlgorithmHistory object

Returns: a shared pointer to the created algorithm.

Definition at line 929 of file Algorithm.cpp.

References fromString(), and history.

Referenced by Mantid::API::AlgorithmHistory::createAlgorithm(), Mantid::API::WorkspaceHistory::getAlgorithm(), and Mantid::API::AlgorithmHistory::getChildAlgorithm().

◆ fromJson()

IAlgorithm_sptr Mantid::API::Algorithm::fromJson ( const Json::Value & serialized )

static

De-serialize an object from a Json.

De-serializes the algorithm from a Json object.

Parameters

serialized A reference to Json::Value that contains a serialized algorithm object

Returns: A new algorithm object

Exceptions

std::runtime_error if the algorithm cannot be created

Definition at line 983 of file Algorithm.cpp.

References Mantid::Kernel::SingletonHolder< T >::Instance(), and version().

Referenced by fromString(), and Mantid::API::AlgorithmProperty::setValueFromJson().

◆ fromString()

IAlgorithm_sptr Mantid::API::Algorithm::fromString ( const std::string & input )

static

De-serialize an object from a string.

De-serializes the algorithm from a string.

Parameters

input :: An input string in the format. The format is AlgorithmName.version(prop1=value1,prop2=value2,...). If .version is not found the highest found is used.

Returns: A pointer to a managed algorithm object

Exceptions

std::runtime_error if the algorithm cannot be created

Definition at line 967 of file Algorithm.cpp.

References fromJson().

Referenced by Mantid::WorkflowAlgorithms::EQSANSDarkCurrentSubtraction::exec(), Mantid::WorkflowAlgorithms::EQSANSDarkCurrentSubtraction2::exec(), Mantid::WorkflowAlgorithms::HFIRDarkCurrentSubtraction::exec(), Mantid::WorkflowAlgorithms::SANSSensitivityCorrection::exec(), export_leaf_classes(), fromHistory(), Mantid::WorkflowAlgorithms::SANSBeamFinder::loadBeamFinderFile(), and Mantid::API::AlgorithmProperty::setValue().

◆ getAlgorithmID()

AlgorithmID Mantid::API::Algorithm::getAlgorithmID ( ) const

inlineoverridevirtual

Algorithm ID.

Unmanaged algorithms return 0 (or NULL?) values. Managed ones have non-zero.

Implements Mantid::API::IAlgorithm.

Definition at line 213 of file Algorithm.h.

Referenced by executeInternal().

◆ getAlgStartupLogging()

bool Mantid::API::Algorithm::getAlgStartupLogging ( ) const

overridevirtual

get the state of Logging of start and end messages

return the state of logging of start and end messages

Returns: : true to logging is enabled

Implements Mantid::API::IAlgorithm.

Definition at line 1750 of file Algorithm.cpp.

References m_isAlgStartupLoggingEnabled.

◆ getAlwaysStoreInADS()

bool Mantid::API::Algorithm::getAlwaysStoreInADS ( ) const

overridevirtual

Returns true if we always store in the AnalysisDataService.

Returns: true if output is saved to the AnalysisDataService.

Implements Mantid::API::IAlgorithm.

Definition at line 188 of file Algorithm.cpp.

References m_alwaysStoreInADS.

Referenced by Mantid::Algorithms::DiscusMultipleScatteringCorrection::exec().

◆ getCancel()

bool Mantid::API::Algorithm::getCancel ( ) const

Returns the cancellation state.

Definition at line 1657 of file Algorithm.cpp.

References m_cancel.

Referenced by Mantid::API::Progress::hasCancellationBeenRequested(), Mantid::DataHandling::LoadBankFromDiskTask::loadEventId(), Mantid::DataHandling::LoadDNSEvent::populate_EventWorkspace(), Mantid::DataHandling::LoadNGEM::reportProgressAndCheckCancel(), and Mantid::DataHandling::LoadBankFromDiskTask::run().

◆ getDeclaredPropertyNames()

std::vector< std::string > Mantid::API::Algorithm::getDeclaredPropertyNames ( ) const

overridevirtualnoexcept

Return the list of declared property names.

Returns: A vector holding strings of property names

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2056 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getDeclaredPropertyNames(), and m_properties.

◆ getExecutionMode()

Parallel::ExecutionMode Mantid::API::Algorithm::getExecutionMode ( ) const

private

Get a (valid) execution mode for this algorithm.

"Valid" implies that this function does check whether or not the Algorithm actually supports the mode. If it cannot return a valid mode it throws an error. As a consequence, the return value of this function can be used without further sanitization of the return value.

Definition at line 1799 of file Algorithm.cpp.

References communicator(), error, Mantid::Kernel::Logger::error(), getInputWorkspaceStorageModes(), getLogger(), getParallelExecutionMode(), and Mantid::Kernel::Logger::information().

Referenced by executeInternal().

◆ getInputWorkspaceStorageModes()

std::map< std::string, Parallel::StorageMode > Mantid::API::Algorithm::getInputWorkspaceStorageModes ( ) const

private

Get map of storage modes of all input workspaces.

The key to the name is the property name of the respective workspace.

Definition at line 1825 of file Algorithm.cpp.

References getLogger(), Mantid::Kernel::Logger::information(), m_inputWorkspaceProps, and Mantid::Kernel::Property::name().

Referenced by getExecutionMode().

◆ getLogger()

Kernel::Logger & Mantid::API::Algorithm::getLogger ( ) const

Returns a reference to the logger.

Definition at line 1660 of file Algorithm.cpp.

References g_log.

◆ getLoggingOffset()

int Mantid::API::Algorithm::getLoggingOffset ( ) const

overridevirtual

returns the logging priority offset

Implements Mantid::API::IAlgorithm.

Definition at line 1681 of file Algorithm.cpp.

References g_log, and Mantid::Kernel::Logger::getLevelOffset().

◆ getParallelExecutionMode()

Parallel::ExecutionMode Mantid::API::Algorithm::getParallelExecutionMode ( const std::map< std::string, Parallel::StorageMode > & storageModes ) const

protectedvirtual

Get correct execution mode based on input storage modes for an MPI run.

The default implementation returns ExecutionMode::Invalid. Classes inheriting from Algorithm can re-implement this if they support execution with multiple MPI ranks. May not return ExecutionMode::Serial, because that is not a "parallel" execution mode.

Reimplemented in Mantid::Algorithms::AlignDetectors, Mantid::Algorithms::BinaryOperation, Mantid::Algorithms::CompareWorkspaces, Mantid::Algorithms::CopyInstrumentParameters, Mantid::Algorithms::CreateSingleValuedWorkspace, Mantid::Algorithms::CreateWorkspace, Mantid::Algorithms::GroupWorkspaces, Mantid::Algorithms::Q1D2, Mantid::Algorithms::RebinToWorkspace, Mantid::API::DistributedAlgorithm, Mantid::API::ParallelAlgorithm, Mantid::API::SerialAlgorithm, Mantid::DataHandling::Load, Mantid::DataHandling::LoadCalFile, Mantid::DataHandling::LoadDiffCal, and Mantid::DataHandling::LoadEventNexus.

Definition at line 1850 of file Algorithm.cpp.

References UNUSED_ARG.

Referenced by getExecutionMode().

◆ getPointerToProperty()

Property * Mantid::API::Algorithm::getPointerToProperty ( const std::string & name ) const

overridevirtual

Get a property by name.

Parameters

name	:: The name of the property (case insensitive)

Returns: A pointer to the named property

Exceptions

Exception::NotFoundError if the named property is unknown

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2033 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getPointerToProperty(), m_properties, and name().

Referenced by Mantid::CurveFitting::IFittingAlgorithm::afterPropertySet(), Mantid::API::checkForMandatoryInstrumentDefault(), Mantid::API::checkForOptionalInstrumentDefault(), Mantid::Algorithms::ExponentialCorrection::defineProperties(), Mantid::Algorithms::CalculateFlatBackground::exec(), Mantid::Algorithms::ExtractSpectra2::exec(), Mantid::Algorithms::NormaliseToMonitor::exec(), Mantid::CurveFitting::Algorithms::PawleyFit::exec(), Mantid::MDAlgorithms::IntegrateEllipsoidsV2::exec(), Mantid::MDAlgorithms::LoadDNSSCD::exec(), Mantid::MDAlgorithms::MergeMDFiles::exec(), Mantid::MDAlgorithms::PreprocessDetectorsToMD::exec(), Mantid::CurveFitting::Algorithms::EstimateFitParameters::execConcrete(), Mantid::DataHandling::SaveAscii::init(), Mantid::DataHandling::SaveAscii2::init(), Mantid::DataHandling::SaveCSV::init(), Mantid::MDAlgorithms::ConvertToMDParent::init(), Mantid::CurveFitting::Algorithms::DoublePulseFit::initConcrete(), Mantid::CurveFitting::Algorithms::Fit::initConcrete(), Mantid::CurveFitting::Algorithms::QENSFitSimultaneous::initConcrete(), Mantid::DataHandling::LoadILLDiffraction::loadDataScan(), Mantid::DataHandling::LoadILLSANS::loadMetaData(), Mantid::Algorithms::Bin2DPowderDiffraction::validateInputs(), Mantid::Crystal::ConvertPeaksWorkspace::validateInputs(), Mantid::Crystal::FindSXPeaks::validateInputs(), Mantid::MDAlgorithms::IntegrateEllipsoidsV2::validateInputs(), and Mantid::Algorithms::MergeLogs::validateTSP().

◆ getPointerToPropertyOrdinal()

Property * Mantid::API::Algorithm::getPointerToPropertyOrdinal ( const int & index ) const

overridevirtual

Get a property by an index.

Parameters

index :: The name of the property (case insensitive)

Returns: A pointer to the named property

Exceptions

std::runtime_error if the property index is too high

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2042 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getPointerToPropertyOrdinal(), index, and m_properties.

◆ getProperties()

const std::vector< Property * > & Mantid::API::Algorithm::getProperties ( ) const

overridevirtual

Get the list of managed properties.

The properties will be stored in the order that they were declared.

Returns: A vector holding pointers to the list of properties

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2050 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getProperties(), and m_properties.

Referenced by Mantid::CurveFitting::IFittingAlgorithm::addWorkspaces(), Mantid::MDAlgorithms::MDNormDirectSC::binInputWS(), Mantid::MDAlgorithms::MDNormSCD::binInputWS(), cacheInputWorkspaceHistories(), cacheWorkspaceProperties(), copyNonWorkspaceProperties(), Mantid::DataHandling::Load::declareLoaderProperties(), Mantid::MDAlgorithms::UnaryOperationMD::exec(), executeInternal(), findWorkspaces(), Mantid::CurveFitting::Algorithms::Fit1D::init(), Mantid::DataHandling::Load::init(), linkHistoryWithLastChild(), Mantid::DataHandling::Load::loadFileToWs(), Mantid::Algorithms::CompareWorkspaces::processGroups(), Mantid::Algorithms::CheckWorkspacesMatch::runCompareWorkspaces(), Mantid::API::AlgorithmHistory::setProperties(), setupSkipValidationMasterOnly(), and store().

◆ getProperty()

IPropertyManager::TypedValue Mantid::API::Algorithm::getProperty ( const std::string & name ) const

overridevirtual

Get the value of a property.

Allows you to assign directly to a variable of the property's type (if a supported type).

*** This method does NOT work for assigning to an existing std::string. In this case you have to use getPropertyValue() instead. Note that you can, though, construct a local string variable by writing, e.g. std::string s = getProperty("myProperty"). ***

Parameters

name	:: The name of the property

Returns: The value of the property. Will be cast to the desired type (if a supported type).

Exceptions

std::runtime_error	If an attempt is made to assign a property to a different type
Exception::NotFoundError	If the property requested does not exist

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2076 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getProperty(), m_properties, and name().

◆ getPropertyValue()

std::string Mantid::API::Algorithm::getPropertyValue ( const std::string & name ) const

overridevirtual

Get the value of a property as a string.

Parameters

name	:: The name of the property (case insensitive)

Returns: The value of the named property

Exceptions

Exception::NotFoundError if the named property is unknown

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2026 of file Algorithm.cpp.

References Mantid::Kernel::PropertyManagerOwner::getPropertyValue(), m_properties, and name().

◆ getWorkspaceAndIndices()

template<typename T , typename = typename std::enable_if<std::is_convertible<T *, MatrixWorkspace *>::value>::type>

std::tuple< std::shared_ptr< T >, Indexing::SpectrumIndexSet > Mantid::API::Algorithm::getWorkspaceAndIndices ( const std::string & name ) const

◆ handleChildProgressNotification()

void Mantid::API::Algorithm::handleChildProgressNotification ( const Poco::AutoPtr< ProgressNotification > & pNf )

protected

Observation slot for child algorithm progress notification messages, these are scaled and then signalled for this algorithm.

Handles and rescales child algorithm progress notifications.

Parameters

pNf	:: The progress notification from the child algorithm.

Definition at line 1623 of file Algorithm.cpp.

References m_endChildProgress, m_startChildProgress, and progress().

Referenced by progressObserver().

◆ helpURL()

const std::string Mantid::API::Algorithm::helpURL ( ) const

inlineoverridevirtual

function to return URL for algorithm documentation; A default implementation is provided.

Override if the algorithm is not part of the Mantid distribution.

Implements Mantid::API::IAlgorithm.

Definition at line 189 of file Algorithm.h.

◆ init()

virtual void Mantid::API::Algorithm::init ( )

protectedpure virtual

Virtual method - must be overridden by concrete algorithm.

Classes

Public Member Functions

Serialization functions

Algorithm Information

Progress Reporting functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ WorkspaceVector

Constructor & Destructor Documentation

◆ Algorithm() [1/2]

◆ Algorithm() [2/2]

◆ ~Algorithm()

Member Function Documentation

◆ addObserver()

◆ addTimer()

◆ afterPropertySet()

◆ alias()

◆ aliasDeprecated()

◆ asJson()

◆ asString()

◆ cacheInputWorkspaceHistories()

◆ cacheWorkspaceProperties()

◆ cancel()

◆ categories()

◆ category()

◆ categorySeparator()

◆ checkGroups()

◆ clear()

◆ clearWorkspaceCaches()

◆ communicator()

◆ copyNonWorkspaceProperties()

◆ copyPropertiesFrom()

◆ createChildAlgorithm()

◆ declareOrReplaceProperty()

◆ declareProperty() [1/8]

◆ declareProperty() [2/8]

◆ declareProperty() [3/8]

◆ declareProperty() [4/8]

◆ declareProperty() [5/8]

◆ declareProperty() [6/8]

◆ declareProperty() [7/8]

◆ declareProperty() [8/8]

◆ declareWorkspaceInputProperties()

◆ doCallProcessGroups()

◆ doSetInputProperties()

◆ enableHistoryRecordingForChild()

◆ exec() [1/2]

◆ exec() [2/2]

◆ execDistributed()

◆ execMasterOnly()

◆ execute()

◆ executeAsChildAlg()

◆ executeAsync()

◆ executeAsyncImpl()

◆ executeInternal()

◆ executionState()

◆ existsProperty()

◆ fillHistory() [1/2]

◆ fillHistory() [2/2]

◆ filterByProperty()

◆ filterByTime()

◆ findWorkspaces()

◆ fromHistory()

◆ fromJson()

◆ fromString()

◆ getAlgorithmID()

◆ getAlgStartupLogging()

◆ getAlwaysStoreInADS()

◆ getCancel()

◆ getDeclaredPropertyNames()

◆ getExecutionMode()

◆ getInputWorkspaceStorageModes()

◆ getLogger()

◆ getLoggingOffset()

◆ getParallelExecutionMode()

◆ getPointerToProperty()

◆ getPointerToPropertyOrdinal()

◆ getProperties()

◆ getProperty()