DataProcessorAlgorithm.h 5.91 KB
Newer Older
1
2
3
4
5
#ifndef MANTID_API_DATAPROCESSORALGORITHM_H_
#define MANTID_API_DATAPROCESSORALGORITHM_H_

#include "MantidKernel/System.h"
#include "MantidAPI/Algorithm.h"
6
#include "MantidAPI/AlgorithmManager.h"
7
#include "MantidAPI/ITableWorkspace_fwd.h"
8
#include "MantidAPI/IEventWorkspace_fwd.h"
9
#include "MantidKernel/PropertyManager.h"
10
11
#include <vector>

12
13
namespace Mantid {
namespace API {
14
15
/**

16
17
   Data processor algorithm to be used as a parent to workflow algorithms.
   This algorithm provides utility methods to load and process data.
18
19
20

   @date 2012-04-04

21
22
   Copyright &copy; 2012 ISIS Rutherford Appleton Laboratory, NScD Oak Ridge
   National Laboratory & European Spallation Source
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

   This file is part of Mantid.

   Mantid is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   Mantid is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.

39
   File change history is stored at: <https://github.com/mantidproject/mantid>
40
41
   Code Documentation is available at: <http://doxygen.mantidproject.org>
 */
42
class DLLExport DataProcessorAlgorithm : public Algorithm {
43
44
45
public:
  DataProcessorAlgorithm();
  virtual ~DataProcessorAlgorithm();
46
47
  virtual std::string getPropertyValue(const std::string &name) const;
  virtual TypedValue getProperty(const std::string &name) const;
48
49

protected:
50
51
52
53
54
55
56
  virtual boost::shared_ptr<Algorithm> createChildAlgorithm(
      const std::string &name, const double startProgress = -1.,
      const double endProgress = -1., const bool enableLogging = true,
      const int &version = -1);
  void setLoadAlg(const std::string &alg);
  void setLoadAlgFileProp(const std::string &filePropName);
  void setAccumAlg(const std::string &alg);
57
  void setPropManagerPropName(const std::string &propName);
58
  void mapPropertyName(const std::string &nameInProp, const std::string &nameInPropManager);
59
  void copyProperty(API::Algorithm_sptr alg, const std::string& name);
60
61
  ITableWorkspace_sptr determineChunk(const std::string &filename);
  void loadChunk(const size_t rowIndex);
62
63
64
  Workspace_sptr load(const std::string &inputData,
                      const bool loadQuiet = false);
  std::vector<std::string> splitInput(const std::string &input);
65
  void forwardProperties();
66
  boost::shared_ptr<Kernel::PropertyManager>
67
  getProcessProperties(const std::string &propertyManager=std::string()) const;
68
69
  /// MPI option. If false, we will use one job event if MPI is available
  bool m_useMPI;
70
71
72
73
  Workspace_sptr assemble(const std::string &partialWSName,
                          const std::string &outputWSName);
  void saveNexus(const std::string &outputWSName,
                 const std::string &outputFile);
74
75
  bool isMainThread();
  int getNThreads();
76

77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
  /// Divide a matrix workspace by another matrix workspace
  MatrixWorkspace_sptr divide(const MatrixWorkspace_sptr lhs,
                              const MatrixWorkspace_sptr rhs);
  /// Divide a matrix workspace by a single value
  MatrixWorkspace_sptr divide(const MatrixWorkspace_sptr lhs,
                              const double &rhsValue);

  /// Multiply a matrix workspace by another matrix workspace
  MatrixWorkspace_sptr multiply(const MatrixWorkspace_sptr lhs,
                                const MatrixWorkspace_sptr rhs);
  /// Multiply a matrix workspace by a single value
  MatrixWorkspace_sptr multiply(const MatrixWorkspace_sptr lhs,
                                const double &rhsValue);

  /// Add a matrix workspace to another matrix workspace
  MatrixWorkspace_sptr plus(const MatrixWorkspace_sptr lhs,
                            const MatrixWorkspace_sptr rhs);
94
  /// Add a single value to a matrix workspace
95
96
97
98
99
100
101
102
103
  MatrixWorkspace_sptr plus(const MatrixWorkspace_sptr lhs,
                            const double &rhsValue);

  /// Subract a matrix workspace by another matrix workspace
  MatrixWorkspace_sptr minus(const MatrixWorkspace_sptr lhs,
                             const MatrixWorkspace_sptr rhs);
  /// Subract a single value from a matrix workspace
  MatrixWorkspace_sptr minus(const MatrixWorkspace_sptr lhs,
                             const double &rhsValue);
104

105
private:
106
107
108
  template <typename LHSType, typename RHSType, typename ResultType>
  ResultType executeBinaryAlgorithm(const std::string &algorithmName,
                                    const LHSType lhs, const RHSType rhs) {
109
110
111
    auto alg = createChildAlgorithm(algorithmName);
    alg->initialize();

112
113
    alg->setProperty<LHSType>("LHSWorkspace", lhs);
    alg->setProperty<RHSType>("RHSWorkspace", rhs);
114
115
    alg->execute();

116
    if (alg->isExecuted()) {
117
118
      // Get the output workspace property
      return alg->getProperty("OutputWorkspace");
119
    } else {
120
121
122
123
124
125
      std::string message = "Error while executing operation: " + algorithmName;
      throw std::runtime_error(message);
    }
  }

  /// Create a matrix workspace from a single number
126
  MatrixWorkspace_sptr createWorkspaceSingleValue(const double &rhsValue);
127

128
129
130
131
  /// The name of the algorithm to invoke when loading data
  std::string m_loadAlg;
  /// The name of the algorithm to invoke when accumulating data chunks
  std::string m_accumulateAlg;
132
133
  /// An alternate filename property for the load algorithm
  std::string m_loadAlgFileProp;
134
135
136
  /// The name of the parameter that names the property manager. The default
  /// value is "ReductionProperties".
  std::string m_propertyManagerPropertyName;
137
138
  /// Map property names to names in supplied properties manager
  std::map<std::string, std::string> m_nameToPMName;
139
140
141
142
143
};

} // namespace API
} // namespace Mantid

144
#endif /* MANTID_API_DATAPROCESSORALGORITHM_H_ */