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.

Referenced by Mantid::DataHandling::LoadEMUTar::init(), Mantid::DataHandling::LoadEMUHdf::init(), and initialize().

◆ initialize()

void Mantid::API::Algorithm::initialize ( )

overridevirtual

Initialization method invoked by the framework.

This method is responsible for any bookkeeping of initialization required by the framework itself. It will in turn invoke the init() method of the derived algorithm, and of any Child Algorithms which it creates.

Exceptions

runtime_error Thrown if algorithm or Child Algorithm cannot be initialised

Implements Mantid::API::IAlgorithm.

Definition at line 283 of file Algorithm.cpp.

References Mantid::Kernel::Logger::fatal(), g_log, getLogger(), init(), Mantid::API::Initialized, isInitialized(), name(), setExecutionState(), setLoggingOffset(), Mantid::Kernel::Logger::setName(), and setupSkipValidationMasterOnly().

Referenced by Mantid::Crystal::GoniometerAnglesFromPhiRotation::exec(), Mantid::DataHandling::LoadMuonNexus2::exec(), and SANSInstrumentCreationHelper::runLoadInstrument().

◆ interruption_point()

void Mantid::API::Algorithm::interruption_point ( )

protected

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

Definition at line 1687 of file Algorithm.cpp.

References IF_NOT_PARALLEL, and m_cancel.

◆ isChild()

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

overridevirtual

To query whether algorithm is a child.

Returns: true - the algorithm is a child algorithm. False - this is a full managed algorithm.

Implements Mantid::API::IAlgorithm.

Definition at line 160 of file Algorithm.cpp.

References m_isChildAlgorithm.

Referenced by Mantid::DataHandling::SaveNexusProcessed::doExec(), Mantid::Algorithms::Stitch1DMany::doStitch1D(), fillHistory(), Mantid::Algorithms::ConjoinXRuns::fillHistory(), Mantid::CurveFitting::Algorithms::Fit::finalizeMinimizer(), lockWorkspaces(), logAlgorithmInfo(), Mantid::CurveFitting::Algorithms::Fit::readProperties(), registerFeatureUsage(), reportCompleted(), Mantid::DataHandling::SaveNexus::runSaveNexusProcessed(), setChild(), trackingHistory(), and unlockWorkspaces().

◆ isCompoundProperty()

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

private

Definition at line 1752 of file Algorithm.cpp.

References m_reservedList, and name().

◆ isDefault()

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

Parameters

name

Returns: True if the property is its default value.

Definition at line 2084 of file Algorithm.cpp.

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

◆ isEmpty()

template<typename NumT >

static bool Mantid::API::Algorithm::isEmpty ( const NumT toCheck )

staticprotected

checks that the value was not set by users, uses the value in empty double/int.

◆ isExecuted()

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

overridevirtual

Has the Algorithm already been executed successfully.

Implements Mantid::API::IAlgorithm.

Definition at line 151 of file Algorithm.cpp.

References executionState(), Mantid::API::Finished, resultState(), and Mantid::API::Success.

Referenced by doCallProcessGroups(), and executeInternal().

◆ isInitialized()

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

overridevirtual

Has the Algorithm already been initialized.

Implements Mantid::API::IAlgorithm.

Definition at line 148 of file Algorithm.cpp.

References m_executionState, and Mantid::API::Uninitialized.

Referenced by executeInternal(), Mantid::API::MultiPeriodGroupWorker::findMultiPeriodGroups(), and initialize().

◆ isLogging()

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

overridevirtual

returns the status of logging, True = enabled

Implements Mantid::API::IAlgorithm.

Definition at line 1664 of file Algorithm.cpp.

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

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

◆ isReadyForGarbageCollection()

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

overridevirtual

True if the algorithm is ready for garbage collection.

Implements Mantid::API::IAlgorithm.

Definition at line 199 of file Algorithm.cpp.

References executionState(), Mantid::API::Finished, and m_gcTime.

◆ isRecordingHistoryForChild()

bool Mantid::API::Algorithm::isRecordingHistoryForChild ( )

inline

Definition at line 234 of file Algorithm.h.

Referenced by Mantid::DataHandling::SaveNexusProcessed::doExec(), Mantid::Algorithms::ConjoinXRuns::fillHistory(), and Mantid::DataHandling::SaveNexus::runSaveNexusProcessed().

◆ isRunning()

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

overridevirtual

True if the algorithm is running.

Implements Mantid::API::IAlgorithm.

Definition at line 196 of file Algorithm.cpp.

References executionState(), and Mantid::API::Running.

◆ isWorkspaceProperty()

bool Mantid::API::Algorithm::isWorkspaceProperty ( const Kernel::Property *const prop ) const

protected

checks the property is a workspace property

To query the property is a workspace property.

Parameters

prop	:: pointer to input properties

Returns: true if this is a workspace property

Definition at line 1559 of file Algorithm.cpp.

◆ linkHistoryWithLastChild()

void Mantid::API::Algorithm::linkHistoryWithLastChild ( )

private

Link the name of the output workspaces on this parent algorithm.

with the last child algorithm executed to ensure they match in the history.

This solves the case where child algorithms use a temporary name and this name needs to match the output name of the parent algorithm so the history can be re-run.

Definition at line 1010 of file Algorithm.cpp.

References getProperties(), Mantid::Kernel::Direction::InOut, m_history, m_recordHistoryForChild, Mantid::Kernel::Direction::Output, and workspace.

Referenced by executeInternal().

◆ lockWorkspaces()

void Mantid::API::Algorithm::lockWorkspaces ( )

private

Go through the workspace properties of this algorithm and lock the workspaces for reading or writing.

Definition at line 425 of file Algorithm.cpp.

References Mantid::Kernel::Logger::debug(), g_log, isChild(), m_inputWorkspaceProps, m_outputWorkspaceProps, m_readLockedWorkspaces, and m_writeLockedWorkspaces.

Referenced by executeInternal().

◆ logAlgorithmInfo()

void Mantid::API::Algorithm::logAlgorithmInfo ( ) const

private

Sends out algorithm parameter information to the logger.

Definition at line 1108 of file Algorithm.cpp.

References getLogger(), isChild(), m_isAlgStartupLoggingEnabled, name(), and Mantid::API::AlgorithmHistory::printSelf().

Referenced by executeInternal().

◆ name()

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

overridepure virtual

function to return a name of the algorithm, must be overridden in all algorithms

Implements Mantid::API::IAlgorithm.

Referenced by addTimer(), Mantid::CurveFitting::IFittingAlgorithm::addWorkspace(), afterPropertySet(), cacheInputWorkspaceHistories(), createChildAlgorithm(), Mantid::API::NexusFileLoader::createChildAlgorithm(), Mantid::MDAlgorithms::SlicingAlgorithm::createTransform(), Mantid::Algorithms::BinaryOperation::do2D(), Mantid::Algorithms::BinaryOperation::doSingleColumn(), Mantid::Algorithms::BinaryOperation::doSingleSpectrum(), Mantid::Algorithms::BinaryOperation::doSingleValue(), Mantid::Algorithms::BinaryOperation::exec(), Mantid::Algorithms::RebinByTimeBase::exec(), exec(), executeAsChildAlg(), executeInternal(), existsProperty(), Mantid::API::AlgorithmHistory::fillAlgorithmHistory(), Mantid::CurveFitting::IFittingAlgorithm::getCostFunctionNames(), getPointerToProperty(), getProperty(), getPropertyValue(), Mantid::Algorithms::BinaryOperation::handleSpecialDivideMinus(), initialize(), isCompoundProperty(), isDefault(), logAlgorithmInfo(), Mantid::MDAlgorithms::SlicingAlgorithm::makeAlignedDimensionFromString(), Mantid::MDAlgorithms::SlicingAlgorithm::makeBasisVectorFromString(), processGroups(), Mantid::API::MultiPeriodGroupWorker::processGroups(), registerFeatureUsage(), removeProperty(), reportCompleted(), setPropertyValue(), setPropertyValueFromJson(), and toJson().

◆ notificationCenter()

Poco::NotificationCenter & Mantid::API::Algorithm::notificationCenter ( ) const

protected

Return a reference to the algorithm's notification dispatcher.

Returns: A reference to the Poco::NotificationCenter object that dispatches notifications

Definition at line 1614 of file Algorithm.cpp.

References m_notificationCenter.

Referenced by addObserver(), doCallProcessGroups(), executeInternal(), progress(), and removeObserver().

◆ operator=()

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

delete

◆ processGroups()

bool Mantid::API::Algorithm::processGroups ( )

virtual

Process WorkspaceGroup inputs.

This should be called after checkGroups(), which sets up required members. It goes through each member of the group(s), creates and sets an algorithm for each and executes them one by one.

If there are several group input workspaces, then the member of each group is executed pair-wise.

Returns: true - if all the workspace members are executed.

Reimplemented in Mantid::Algorithms::CalculateEfficiency2, Mantid::Algorithms::CheckWorkspacesMatch, Mantid::Algorithms::CompareWorkspaces, Mantid::Algorithms::ConjoinWorkspaces, Mantid::Algorithms::RenameWorkspace, Mantid::Algorithms::SassenaFFT, Mantid::API::MultiPeriodGroupAlgorithm, Mantid::DataHandling::SaveDiffFittingAscii, Mantid::DataHandling::SaveNexus, Mantid::DataHandling::SaveNexusESS, Mantid::DataHandling::SaveNexusProcessed, Mantid::DataHandling::SaveNXTomo, and Mantid::DataHandling::SaveReflectometryAscii.

Definition at line 1365 of file Algorithm.cpp.

References copyNonWorkspaceProperties(), createChildAlgorithm(), execute(), Mantid::Kernel::SingletonHolder< T >::Instance(), isLogging(), m_groupsHaveSimilarNames, m_groupSize, m_inputWorkspaceProps, m_pureOutputWorkspaceProps, m_singleGroup, m_unrolledInputWorkspaces, m_usingBaseProcessGroups, name(), Mantid::Kernel::IPropertyManager::setProperty(), setPropertyValue(), Mantid::Kernel::Strings::toString(), and version().

Referenced by checkGroups(), doCallProcessGroups(), Mantid::Algorithms::ConjoinWorkspaces::processGroups(), and Mantid::API::MultiPeriodGroupAlgorithm::processGroups().

◆ progress()

void Mantid::API::Algorithm::progress	(	double	p,
		const std::string &	msg = `""`,
		double	estimatedTime = `0.0`,
		int	progressPrecision = `0`
	)

protected

Sends ProgressNotification.

Parameters

p	:: Reported progress, must be between 0 (just started) and 1 (finished)
msg	:: Optional message string
estimatedTime	:: Optional estimated time to completion
progressPrecision	:: optional, int number of digits after the decimal point to show.

Definition at line 231 of file Algorithm.cpp.

References notificationCenter().

◆ progressObserver()

const Poco::AbstractObserver & Mantid::API::Algorithm::progressObserver ( ) const

protected

Return a reference to the algorithm's object that is reporting progress.

Returns: A Poco:NObserver object that is responsible for reporting progress

Definition at line 1632 of file Algorithm.cpp.

References handleChildProgressNotification(), and m_progressObserver.

Referenced by Mantid::DataHandling::LoadRawHelper::runLoadInstrument(), Mantid::DataHandling::LoadRawHelper::runLoadLog(), setupAsChildAlgorithm(), and Mantid::DataHandling::Load::setUpLoader().

◆ propertyCount()

size_t Mantid::API::Algorithm::propertyCount ( ) const

overridevirtual

Count the number of properties under management.

Returns: The number of properties being managed

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2019 of file Algorithm.cpp.

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

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

◆ registerFeatureUsage()

void Mantid::API::Algorithm::registerFeatureUsage ( ) const

private

Registers the usage of the algorithm with the UsageService.

Definition at line 1734 of file Algorithm.cpp.

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

Referenced by executeInternal().

◆ removeObserver()

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

overridevirtual

Remove an observer.

Parameters

observer :: Reference to the observer to remove

Implements Mantid::API::IAlgorithm.

Definition at line 218 of file Algorithm.cpp.

References notificationCenter().

◆ removeProperty()

void Mantid::API::Algorithm::removeProperty	(	const std::string &	name,
		const bool	delproperty = `true`
	)

overridevirtual

Removes the property from management.

Removes the property from properties map.

Parameters

name	:: Name of the property to be removed.
delproperty	:: if true, delete the named property

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2109 of file Algorithm.cpp.

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

Referenced by Mantid::DataHandling::Load::declareLoaderProperties(), Mantid::MDAlgorithms::IntegrateEllipsoidsV2::init(), and Mantid::MDAlgorithms::IntegrateEllipsoidsV2::initInstance().

◆ reportCompleted()

void Mantid::API::Algorithm::reportCompleted	(	const double &	duration,
		const bool	groupProcessing = `false`
	)

private

Report that the algorithm has completed.

Parameters

duration	: Algorithm duration
groupProcessing	: We have been processing via processGroups if true.

Definition at line 1704 of file Algorithm.cpp.

References Mantid::Kernel::Logger::debug(), Mantid::API::Finished, getLogger(), isChild(), m_alwaysStoreInADS, m_isAlgStartupLoggingEnabled, m_isChildAlgorithm, name(), Mantid::Kernel::Logger::notice(), and setExecutionState().

Referenced by doCallProcessGroups(), and executeInternal().

◆ resetProperties()

void Mantid::API::Algorithm::resetProperties ( )

overridevirtual

Reset property values back to initial values (blank or default values)

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1927 of file Algorithm.cpp.

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

◆ resultState()

ResultState Mantid::API::Algorithm::resultState ( ) const

overridevirtual

Gets the current result State.

Implements Mantid::API::IAlgorithm.

Definition at line 135 of file Algorithm.cpp.

References m_resultState.

Referenced by isExecuted().

◆ seeAlso()

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

inlineoverridevirtual

Function to return all of the seeAlso (these are not validated) algorithms related to this algorithm.A default implementation is provided.

Implements Mantid::API::IAlgorithm.

Definition at line 177 of file Algorithm.h.

◆ setAlgStartupLogging()

void Mantid::API::Algorithm::setAlgStartupLogging ( const bool enabled )

overridevirtual

disable Logging of start and end messages

Enable or disable Logging of start and end messages.

Parameters

enabled : true to enable logging, false to disable

Implements Mantid::API::IAlgorithm.

Definition at line 1745 of file Algorithm.cpp.

References m_isAlgStartupLoggingEnabled.

◆ setAlwaysStoreInADS()

void Mantid::API::Algorithm::setAlwaysStoreInADS ( const bool doStore )

overridevirtual

Do we ALWAYS store in the AnalysisDataService? This is set to true for python algorithms' child algorithms.

Parameters

doStore :: always store in ADS

Implements Mantid::API::IAlgorithm.

Definition at line 183 of file Algorithm.cpp.

References m_alwaysStoreInADS.

Referenced by setChild().

◆ setChild()

void Mantid::API::Algorithm::setChild ( const bool isChild )

overridevirtual

To set whether algorithm is a child.

Parameters

isChild :: True - the algorithm is a child algorithm. False - this is a full managed algorithm.

Implements Mantid::API::IAlgorithm.

Definition at line 166 of file Algorithm.cpp.

References isChild(), m_isChildAlgorithm, and setAlwaysStoreInADS().

Referenced by Mantid::Algorithms::FindPeaks::callFitPeak().

◆ setChildEndProgress()

void Mantid::API::Algorithm::setChildEndProgress ( const double endProgress ) const

inlineoverridevirtual

setting the child end progress

Implements Mantid::API::IAlgorithm.

Definition at line 265 of file Algorithm.h.

Referenced by Mantid::DataHandling::LoadRawHelper::runLoadInstrument(), Mantid::DataHandling::LoadRawHelper::runLoadLog(), and Mantid::DataHandling::Load::setUpLoader().

◆ setChildStartProgress()

void Mantid::API::Algorithm::setChildStartProgress ( const double startProgress ) const

inlineoverridevirtual

setting the child start progress

Implements Mantid::API::IAlgorithm.

Definition at line 263 of file Algorithm.h.

Referenced by Mantid::DataHandling::LoadRawHelper::runLoadInstrument(), Mantid::DataHandling::LoadRawHelper::runLoadLog(), and Mantid::DataHandling::Load::setUpLoader().

◆ setCommunicator()

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

Sets the (MPI) communicator of the algorithm.

Definition at line 1873 of file Algorithm.cpp.

References communicator(), and m_communicator.

◆ setExecutionState()

void Mantid::API::Algorithm::setExecutionState ( const ExecutionState state )

protected

Sets the current execution state.

Definition at line 132 of file Algorithm.cpp.

References m_executionState.

Referenced by executeInternal(), initialize(), reportCompleted(), and setResultState().

◆ setLogging()

void Mantid::API::Algorithm::setLogging ( const bool value )

overridevirtual

Logging can be disabled by passing a value of false.

Implements Mantid::API::IAlgorithm.

Definition at line 1662 of file Algorithm.cpp.

References g_log, Mantid::Kernel::Logger::setEnabled(), and value.

◆ setLoggingOffset()

void Mantid::API::Algorithm::setLoggingOffset ( const int value )

overridevirtual

gets the logging priority offset

Implements Mantid::API::IAlgorithm.

Definition at line 1671 of file Algorithm.cpp.

References g_log, Mantid::Kernel::SingletonHolder< T >::Instance(), m_communicator, Mantid::Kernel::Logger::setLevelOffset(), and value.

Referenced by initialize().

◆ setOtherProperties()

void Mantid::API::Algorithm::setOtherProperties	(	IAlgorithm *	alg,
		const std::string &	propertyName,
		const std::string &	propertyValue,
		int	periodNum
	)

protectedvirtual

Virtual method to set the non workspace properties for this algorithm.

To be overridden by specific algorithms when needed.

Parameters

alg	:: pointer to the algorithm
propertyName	:: name of the property
propertyValue	:: value of the property
periodNum	:: period number

Reimplemented in Mantid::DataHandling::SaveCanSAS1D, Mantid::DataHandling::SaveGSS, Mantid::DataHandling::SaveFocusedXYE, Mantid::DataHandling::SaveNexus, and Mantid::DataHandling::SaveNexusProcessed.

Definition at line 1547 of file Algorithm.cpp.

References Mantid::Kernel::IPropertyManager::setPropertyValue().

Referenced by copyNonWorkspaceProperties(), Mantid::DataHandling::SaveCanSAS1D::setOtherProperties(), Mantid::DataHandling::SaveGSS::setOtherProperties(), Mantid::DataHandling::SaveFocusedXYE::setOtherProperties(), Mantid::DataHandling::SaveNexus::setOtherProperties(), and Mantid::DataHandling::SaveNexusProcessed::setOtherProperties().

◆ setProperties() [1/2]

void Mantid::API::Algorithm::setProperties	(	const ::Json::Value &	jsonValue,
		const std::unordered_set< std::string > &	ignoreProperties = `std::unordered_set<std::string>()`,
		bool	createMissing = `false`
	)

overridevirtual

Sets all the declared properties from a json object.

Parameters

jsonValue	:: A json name value pair collection
ignoreProperties	:: A set of names of any properties NOT to set from the propertiesArray
createMissing	:: If the property does not exist then create it

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1951 of file Algorithm.cpp.

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

◆ setProperties() [2/2]

void Mantid::API::Algorithm::setProperties	(	const std::string &	propertiesJson,
		const std::unordered_set< std::string > &	ignoreProperties = `std::unordered_set<std::string>()`,
		bool	createMissing = `false`
	)

overridevirtual

Set the ordered list of properties by one string of values, separated by semicolons.

The string should be a json formatted collection of name value pairs

Parameters

propertiesJson	:: The string of property values
ignoreProperties	:: A set of names of any properties NOT to set from the propertiesArray
createMissing	:: If the property does not exist then create it

Exceptions

invalid_argument if error in parameters

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1940 of file Algorithm.cpp.

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

◆ setPropertiesWithString()

void Mantid::API::Algorithm::setPropertiesWithString	(	const std::string &	propertiesString,
		const std::unordered_set< std::string > &	ignoreProperties = `std::unordered_set<std::string>()`
	)

overridevirtual

Sets all the declared properties from a string.

Parameters

propertiesString	:: A list of name = value pairs separated by a semicolon
ignoreProperties	:: A set of names of any properties NOT to set from the propertiesArray

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1962 of file Algorithm.cpp.

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

◆ setPropertyOrdinal()

void Mantid::API::Algorithm::setPropertyOrdinal	(	const int &	index,
		const std::string &	value
	)

overridevirtual

Set the value of a property by an index N.B.

bool properties must be set using 1/0 rather than true/false

Parameters

index	:: The index of the property to assign
value	:: The value to assign to the property

Exceptions

std::runtime_error if the property index is too high

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1998 of file Algorithm.cpp.

References afterPropertySet(), Mantid::Kernel::PropertyManagerOwner::getPointerToPropertyOrdinal(), index, m_properties, Mantid::Kernel::Property::name(), Mantid::Kernel::PropertyManagerOwner::setPropertyOrdinal(), and value.

◆ setPropertyValue()

void Mantid::API::Algorithm::setPropertyValue	(	const std::string &	name,
		const std::string &	value
	)

overridevirtual

Set the value of a property by string N.B.

bool properties must be set using 1/0 rather than true/false

Parameters

name	:: The name of the property (case insensitive)
value	:: The value to assign to the property

Exceptions

Exception::NotFoundError	if the named property is unknown
std::invalid_argument	If the value is not valid for the property given

Implements Mantid::Kernel::IPropertyManager.

Reimplemented in Mantid::DataHandling::Load.

Definition at line 1975 of file Algorithm.cpp.

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

◆ setPropertyValueFromJson()

void Mantid::API::Algorithm::setPropertyValueFromJson	(	const std::string &	name,
		const Json::Value &	value
	)

overridevirtual

Set the value of a property by Json::Value object.

Parameters

name	:: The name of the property (case insensitive)
value	:: The value to assign to the property

Exceptions

Exception::NotFoundError	if the named property is unknown
std::invalid_argument	If the value is not valid for the property given

Implements Mantid::Kernel::IPropertyManager.

Definition at line 1987 of file Algorithm.cpp.

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

◆ setResultState()

void Mantid::API::Algorithm::setResultState ( const ResultState state )

protected

Sets the result execution state.

Sets the result execution state if set to Success or Failed will also set the execution state to finished.

Definition at line 139 of file Algorithm.cpp.

References Mantid::API::Finished, m_resultState, Mantid::API::NotFinished, and setExecutionState().

Referenced by doCallProcessGroups(), and executeInternal().

◆ setRethrows()

void Mantid::API::Algorithm::setRethrows ( const bool rethrow )

overridevirtual

Set whether the algorithm will rethrow exceptions.

Parameters

rethrow :: true if you want to rethrow exception.

Implements Mantid::API::IAlgorithm.

Definition at line 193 of file Algorithm.cpp.

References m_rethrow.

◆ setupAsChildAlgorithm()

void Mantid::API::Algorithm::setupAsChildAlgorithm	(	const Algorithm_sptr &	alg,
		const double	startProgress = `-1.`,
		const double	endProgress = `-1.`,
		const bool	enableLogging = `true`
	)

Setup algorithm as child algorithm.

Used internally by createChildAlgorithm. Arguments are as documented there. Can also be used manually for algorithms created otherwise. This allows running algorithms that are not declared into the factory as child algorithms.

Definition at line 855 of file Algorithm.cpp.

References m_ChildAlgorithms, m_endChildProgress, m_startChildProgress, Mantid::Kernel::Direction::Output, PARALLEL_CRITICAL, and progressObserver().

Referenced by createChildAlgorithm(), and Mantid::Algorithms::ExtractSpectra::exec().

◆ setupSkipValidationMasterOnly()

void Mantid::API::Algorithm::setupSkipValidationMasterOnly ( )

private

Sets up skipping workspace validation on non-master ranks for StorageMode::MasterOnly.

Definition at line 1858 of file Algorithm.cpp.

References communicator(), and getProperties().

Referenced by initialize().

◆ setWorkspaceInputProperties() [1/2]

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 Mantid::API::Algorithm::setWorkspaceInputProperties	(	const std::string &	name,
		const std::shared_ptr< T1 > &	wksp,
		IndexType	type,
		const T2 &	list
	)

◆ setWorkspaceInputProperties() [2/2]

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 Mantid::API::Algorithm::setWorkspaceInputProperties	(	const std::string &	name,
		const std::string &	wsName,
		IndexType	type,
		const T2 &	list
	)

◆ splitByTime()

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

inlineoverridevirtual

Implements Mantid::Kernel::IPropertyManager.

Definition at line 368 of file Algorithm.h.

Referenced by Mantid::Algorithms::FilterEvents::createOutputWorkspacesSplitters().

◆ store()

void Mantid::API::Algorithm::store ( )

protected

Stores any output workspaces into the AnalysisDataService.

Exceptions

std::runtime_error If unable to successfully store an output workspace

Definition at line 787 of file Algorithm.cpp.

References getProperties(), and Mantid::API::IWorkspaceProperty::store().

Referenced by doCallProcessGroups(), and executeInternal().

◆ summary()

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

overridepure virtual

function returns a summary message that will be displayed in the default GUI, and in the help.

Implements Mantid::API::IAlgorithm.

◆ takeProperty()

std::unique_ptr< Kernel::Property > Mantid::API::Algorithm::takeProperty ( const size_t index )

overridevirtual

Removes the property from management and returns a pointer to it.

Removes a property from the properties map by index and return a pointer to it.

Parameters

index :: index of the property to be removed

Returns: :: pointer to the removed property if found, NULL otherwise

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2118 of file Algorithm.cpp.

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

◆ toJson()

Json::Value Mantid::API::Algorithm::toJson ( ) const

overridevirtual

Serialize an object to a json object.

Serialize this object to a json object)

Returns: This object serialized as a json object

Implements Mantid::API::IAlgorithm.

Definition at line 911 of file Algorithm.cpp.

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

Referenced by toString().

◆ toString()

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

overridevirtual

Serialize an object to a string.

Serialize this object to a string.

The format is a json formatted string.

Returns: This object serialized as a string

Implements Mantid::API::IAlgorithm.

Definition at line 905 of file Algorithm.cpp.

References toJson().

◆ trackAlgorithmHistory()

void Mantid::API::Algorithm::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.

Indicates that this algrithms history should be tracked regardless of if it is a child.

Parameters

parentHist :: the parent algorithm history object the history in.

Definition at line 1055 of file Algorithm.cpp.

References enableHistoryRecordingForChild(), and m_parentHistory.

◆ trackingHistory()

bool Mantid::API::Algorithm::trackingHistory ( )

protected

get whether we are tracking the history for this algorithm,

Check if we are tracking history for this algorithm.

Returns: if we are tracking the history of this algorithm

Definition at line 1063 of file Algorithm.cpp.

References isChild(), and m_recordHistoryForChild.

Referenced by cacheInputWorkspaceHistories(), doCallProcessGroups(), Mantid::DataHandling::SaveNexusProcessed::doExec(), executeInternal(), and Mantid::DataHandling::SaveNexus::runSaveNexusProcessed().

◆ unlockWorkspaces()

void Mantid::API::Algorithm::unlockWorkspaces ( )

private

Unlock any previously locked workspaces.

Definition at line 472 of file Algorithm.cpp.

References Mantid::Kernel::Logger::debug(), g_log, isChild(), m_readLockedWorkspaces, and m_writeLockedWorkspaces.

Referenced by executeInternal().

◆ validateInputs()

std::map< std::string, std::string > Mantid::API::Algorithm::validateInputs ( void )

overridevirtual

Perform validation of ALL the input properties of the algorithm.

This is to be overridden by specific algorithms. It will be called in dialogs after parsing all inputs and setting the properties, but BEFORE executing.

Returns: a map where: Key = string name of the the property; Value = string describing the problem with the property.

Implements Mantid::API::IAlgorithm.

Definition at line 324 of file Algorithm.cpp.

Referenced by executeInternal().

◆ validateProperties()

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

overridevirtual

Validates all the properties in the collection.

Returns: True if all properties have a valid value

Implements Mantid::Kernel::IPropertyManager.

Definition at line 2013 of file Algorithm.cpp.

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

Referenced by executeInternal().

◆ version()

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

overridepure virtual

function to return a version of the algorithm, must be overridden in all algorithms

Implements Mantid::API::IAlgorithm.

Referenced by createChildAlgorithm(), Mantid::API::NexusFileLoader::createChildAlgorithm(), Mantid::API::AlgorithmHistory::fillAlgorithmHistory(), fromJson(), processGroups(), Mantid::API::MultiPeriodGroupWorker::processGroups(), registerFeatureUsage(), and toJson().

◆ workspaceMethodInputProperty()

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

overridevirtual

Returns: The name of the property that the calling object will be passed to.

Implements Mantid::API::IAlgorithm.

Reimplemented in Mantid::DataHandling::MaskDetectors.

Definition at line 272 of file Algorithm.cpp.

◆ workspaceMethodName()

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

overridevirtual

Returns: A string giving the method name that should be attached to a workspace

Implements Mantid::API::IAlgorithm.

Reimplemented in Mantid::DataHandling::MaskDetectors.

Definition at line 255 of file Algorithm.cpp.

◆ workspaceMethodOn()

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

overridevirtual

Returns: A list of workspace class names that should have the workspaceMethodName attached

Implements Mantid::API::IAlgorithm.

Definition at line 262 of file Algorithm.cpp.

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

◆ workspaceMethodOnTypes()

virtual const std::string Mantid::API::Algorithm::workspaceMethodOnTypes ( ) const

inlineprotectedvirtual

Returns a semi-colon separated list of workspace types to attach this algorithm.

Reimplemented in Mantid::Algorithms::Rebin.

Definition at line 395 of file Algorithm.h.

Referenced by workspaceMethodOn().

Friends And Related Function Documentation

◆ Progress

friend class Progress

friend

Definition at line 406 of file Algorithm.h.

◆ WorkspaceHistory

friend class WorkspaceHistory

friend

Definition at line 437 of file Algorithm.h.

Member Data Documentation

◆ calledByAlias

bool Mantid::API::Algorithm::calledByAlias = false

Flag to indicate if the algorithm is called by its alias.

Definition at line 181 of file Algorithm.h.

Referenced by executeInternal().

◆ g_execCount

size_t Mantid::API::Algorithm::g_execCount = 0

staticprotected

Counter to keep track of algorithm execution order.

Initialize static algorithm counter.

Definition at line 439 of file Algorithm.h.

Referenced by doCallProcessGroups(), Mantid::DataHandling::SaveNexusProcessed::doExec(), executeInternal(), Mantid::API::WorkspaceHistory::parseAlgorithmHistory(), and Mantid::DataHandling::SaveNexus::runSaveNexusProcessed().

◆ g_log

Kernel::Logger& Mantid::API::Algorithm::g_log

protected

Definition at line 451 of file Algorithm.h.

◆ m_algorithmID

AlgorithmID Mantid::API::Algorithm::m_algorithmID

private

Algorithm ID for managed algorithms.

Definition at line 529 of file Algorithm.h.

◆ m_alwaysStoreInADS

bool Mantid::API::Algorithm::m_alwaysStoreInADS

private

Always store in the ADS, even for child algos.

Definition at line 519 of file Algorithm.h.

Referenced by doCallProcessGroups(), executeInternal(), getAlwaysStoreInADS(), reportCompleted(), and setAlwaysStoreInADS().

◆ m_cancel

std::atomic<bool> Mantid::API::Algorithm::m_cancel

protected

Set to true to stop execution.

Definition at line 433 of file Algorithm.h.

Referenced by Mantid::MDAlgorithms::BinMD::binByIterating(), cancel(), getCancel(), and interruption_point().

◆ m_ChildAlgorithms

std::vector<std::weak_ptr<IAlgorithm> > Mantid::API::Algorithm::m_ChildAlgorithms

private

A list of weak pointers to any child algorithms created.

Definition at line 530 of file Algorithm.h.

Referenced by cancel(), and setupAsChildAlgorithm().

◆ m_communicator

std::unique_ptr<Parallel::Communicator> Mantid::API::Algorithm::m_communicator

private

(MPI) communicator used when executing the algorithm.

Definition at line 560 of file Algorithm.h.

Referenced by communicator(), setCommunicator(), and setLoggingOffset().

◆ m_endChildProgress

double Mantid::API::Algorithm::m_endChildProgress

mutableprivate

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

Definition at line 527 of file Algorithm.h.

Referenced by handleChildProgressNotification(), and setupAsChildAlgorithm().

◆ m_executeAsync

std::unique_ptr<Poco::ActiveMethod<bool, Poco::Void, Algorithm, Poco::ActiveStarter<Algorithm> > > Mantid::API::Algorithm::m_executeAsync

private

Poco::ActiveMethod used to implement asynchronous execution.

Definition at line 505 of file Algorithm.h.

Referenced by executeAsync().

◆ m_executionState

std::atomic<ExecutionState> Mantid::API::Algorithm::m_executionState

private

the current execution state

Definition at line 514 of file Algorithm.h.

Referenced by executionState(), isInitialized(), and setExecutionState().

◆ m_gcTime

Mantid::Types::Core::DateAndTime Mantid::API::Algorithm::m_gcTime

private

The earliest this class should be considered for garbage collection.

Definition at line 563 of file Algorithm.h.

Referenced by executeInternal(), and isReadyForGarbageCollection().

◆ m_groupsHaveSimilarNames

bool Mantid::API::Algorithm::m_groupsHaveSimilarNames

private

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

Definition at line 551 of file Algorithm.h.

Referenced by checkGroups(), and processGroups().

◆ m_groupSize

size_t Mantid::API::Algorithm::m_groupSize

protected

Size of the group(s) being processed.

Definition at line 460 of file Algorithm.h.

Referenced by checkGroups(), and processGroups().

◆ m_groupWorkspaces

std::vector<std::shared_ptr<WorkspaceGroup> > Mantid::API::Algorithm::m_groupWorkspaces

private

Pointer to the WorkspaceGroup (if any) for each input workspace property.

Definition at line 547 of file Algorithm.h.

Referenced by checkGroups(), and clearWorkspaceCaches().

◆ m_history

std::shared_ptr<AlgorithmHistory> Mantid::API::Algorithm::m_history

protected

Pointer to the history for the algorithm being executed.

Definition at line 447 of file Algorithm.h.

Referenced by doCallProcessGroups(), Mantid::DataHandling::SaveNexusProcessed::doExec(), executeInternal(), Mantid::Algorithms::ConjoinXRuns::fillHistory(), fillHistory(), linkHistoryWithLastChild(), and Mantid::DataHandling::SaveNexus::runSaveNexusProcessed().

◆ m_inputWorkspaceHistories

std::vector<Workspace_sptr> Mantid::API::Algorithm::m_inputWorkspaceHistories

private

Store a pointer to the input workspace histories so they can be copied to the outputs to avoid anything being overwritten.

Definition at line 554 of file Algorithm.h.

Referenced by cacheInputWorkspaceHistories(), clearWorkspaceCaches(), and fillHistory().

◆ m_inputWorkspaceProps

std::vector<IWorkspaceProperty *> Mantid::API::Algorithm::m_inputWorkspaceProps

protected

All the WorkspaceProperties that are Input or InOut. Set in execute()

Definition at line 445 of file Algorithm.h.

Referenced by cacheWorkspaceProperties(), checkGroups(), clearWorkspaceCaches(), getInputWorkspaceStorageModes(), lockWorkspaces(), and processGroups().

◆ m_isAlgStartupLoggingEnabled

bool Mantid::API::Algorithm::m_isAlgStartupLoggingEnabled

private

Definition at line 522 of file Algorithm.h.

Referenced by getAlgStartupLogging(), logAlgorithmInfo(), reportCompleted(), and setAlgStartupLogging().

◆ m_isChildAlgorithm

bool Mantid::API::Algorithm::m_isChildAlgorithm

private

Algorithm is a child algorithm.

Definition at line 516 of file Algorithm.h.

Referenced by executeInternal(), isChild(), reportCompleted(), and setChild().

◆ m_log

Kernel::Logger Mantid::API::Algorithm::m_log

protected

Logger for this algorithm.

Definition at line 450 of file Algorithm.h.

Referenced by Mantid::DataHandling::LoadNexusMonitors2::createOutputWorkspace(), Mantid::Algorithms::GetEiMonDet3::exec(), and Mantid::DataHandling::LoadInstrument::exec().

◆ m_notificationCenter

std::unique_ptr<Poco::NotificationCenter> Mantid::API::Algorithm::m_notificationCenter

mutableprivate

Sends notifications to observers.

Observers can subscribe to notificationCenter using Poco::NotificationCenter::addObserver(...);

Definition at line 510 of file Algorithm.h.

Referenced by notificationCenter().

◆ m_outputWorkspaceProps

std::vector<IWorkspaceProperty *> Mantid::API::Algorithm::m_outputWorkspaceProps

private

All the WorkspaceProperties that are Output or InOut. Set in execute()

Definition at line 542 of file Algorithm.h.

Referenced by cacheWorkspaceProperties(), clearWorkspaceCaches(), and lockWorkspaces().

◆ m_parallelException

std::atomic<bool> Mantid::API::Algorithm::m_parallelException

protected

Set if an exception is thrown, and not caught, within a parallel region.

Definition at line 435 of file Algorithm.h.

◆ m_parentHistory

std::shared_ptr<AlgorithmHistory> Mantid::API::Algorithm::m_parentHistory

protected

Pointer to the parent history object (if set)

Definition at line 454 of file Algorithm.h.

Referenced by Mantid::DataHandling::SaveNexusProcessed::doExec(), Mantid::Algorithms::ConjoinXRuns::fillHistory(), fillHistory(), Mantid::DataHandling::SaveNexus::runSaveNexusProcessed(), and trackAlgorithmHistory().

◆ m_progressObserver

std::unique_ptr<Poco::NObserver<Algorithm, ProgressNotification> > Mantid::API::Algorithm::m_progressObserver

mutableprivate

Child algorithm progress observer.

Definition at line 512 of file Algorithm.h.

Referenced by progressObserver().

◆ m_properties

Mantid::Kernel::PropertyManagerOwner Mantid::API::Algorithm::m_properties

private

◆ m_pureOutputWorkspaceProps

std::vector<IWorkspaceProperty *> Mantid::API::Algorithm::m_pureOutputWorkspaceProps

private

All the WorkspaceProperties that are Output (not inOut). Set in execute()

Definition at line 544 of file Algorithm.h.

Referenced by cacheWorkspaceProperties(), clearWorkspaceCaches(), and processGroups().

◆ m_readLockedWorkspaces

WorkspaceVector Mantid::API::Algorithm::m_readLockedWorkspaces

private

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

Definition at line 537 of file Algorithm.h.

Referenced by lockWorkspaces(), and unlockWorkspaces().

◆ m_recordHistoryForChild

bool Mantid::API::Algorithm::m_recordHistoryForChild

private

Flag to indicate whether history should be recorded.

Applicable to child algs only

Definition at line 517 of file Algorithm.h.

Referenced by enableHistoryRecordingForChild(), fillHistory(), linkHistoryWithLastChild(), and trackingHistory().

◆ m_reservedList

std::vector<std::string> Mantid::API::Algorithm::m_reservedList

private

Reserved property names.

Definition at line 557 of file Algorithm.h.

Referenced by isCompoundProperty().

◆ m_resultState

std::atomic<ResultState> Mantid::API::Algorithm::m_resultState

private

the current result State

Definition at line 515 of file Algorithm.h.

Referenced by resultState(), and setResultState().

◆ m_rethrow

bool Mantid::API::Algorithm::m_rethrow

private

Algorithm should rethrow exceptions while executing.

Definition at line 521 of file Algorithm.h.

Referenced by executeInternal(), and setRethrows().

◆ m_runningAsync

bool Mantid::API::Algorithm::m_runningAsync

private

Algorithm is running asynchronously.

Definition at line 520 of file Algorithm.h.

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

◆ m_singleGroup

int Mantid::API::Algorithm::m_singleGroup

private

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

Definition at line 549 of file Algorithm.h.

Referenced by checkGroups(), and processGroups().

◆ m_startChildProgress

double Mantid::API::Algorithm::m_startChildProgress

mutableprivate

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

Keeps value for algorithm's progress at start of an Child Algorithm

Definition at line 525 of file Algorithm.h.

Referenced by handleChildProgressNotification(), and setupAsChildAlgorithm().

◆ m_unrolledInputWorkspaces

std::vector<WorkspaceVector> Mantid::API::Algorithm::m_unrolledInputWorkspaces

protected

One vector of workspaces for each input workspace property.

A group is unrolled to its constituent members

Definition at line 458 of file Algorithm.h.

Referenced by checkGroups(), clearWorkspaceCaches(), processGroups(), and Mantid::DataHandling::SaveNexusProcessed::processGroups().

◆ m_usingBaseProcessGroups

bool Mantid::API::Algorithm::m_usingBaseProcessGroups = false

protected

distinguish between base processGroups() and overriden/algorithm specific versions

Definition at line 463 of file Algorithm.h.

Referenced by doCallProcessGroups(), processGroups(), and Mantid::API::MultiPeriodGroupAlgorithm::processGroups().

◆ m_writeLockedWorkspaces

WorkspaceVector Mantid::API::Algorithm::m_writeLockedWorkspaces

private

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

Definition at line 539 of file Algorithm.h.

Referenced by lockWorkspaces(), and unlockWorkspaces().

The documentation for this class was generated from the following files:

Framework/API/inc/MantidAPI/Algorithm.h
Framework/API/src/Algorithm.cpp
Framework/API/src/AlgorithmExecute.cpp
Framework/API/src/AlgorithmExecuteProfile.cpp

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()