IPeaksWorkspace.h

#ifndef MANTID_API_IPEAKSWORKSPACE_H_
#define MANTID_API_IPEAKSWORKSPACE_H_

//----------------------------------------------------------------------
// Includes
//----------------------------------------------------------------------
#include "MantidAPI/ExperimentInfo.h"
#include "MantidAPI/IPeaksWorkspace_fwd.h"
#include "MantidAPI/ITableWorkspace.h"
#include "MantidKernel/SpecialCoordinateSystem.h"
#include "MantidKernel/ConfigService.h"
#include <boost/optional.hpp>

namespace Mantid {
namespace Geometry {
class IPeak;
}
namespace API {

//==========================================================================================
/** Interface to the class Mantid::DataObjects::PeaksWorkspace

    The class PeaksWorkspace stores information about a set of SCD peaks.

    @author Ruth Mikkelson, SNS ORNL
    @date 3/10/2010

    Copyright &copy; 2011 ISIS Rutherford Appleton Laboratory, NScD Oak Ridge
   National Laboratory & European Spallation Source

    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/>.

    File change history is stored at: <https://github.com/mantidproject/mantid>
 */
class MANTID_API_DLL IPeaksWorkspace : public ITableWorkspace,
                                       public Mantid::API::ExperimentInfo {
public:
  /// Ctor
  IPeaksWorkspace() : ITableWorkspace(), ExperimentInfo() {
    convention = Kernel::ConfigService::Instance().getString("Q.convention");
  }

  /// Returns a clone of the workspace
  IPeaksWorkspace_uptr clone() const { return IPeaksWorkspace_uptr(doClone()); }
  IPeaksWorkspace &operator=(const IPeaksWorkspace &other) = delete;
  //---------------------------------------------------------------------------------------------
  /** @return the number of peaks
   */
  virtual int getNumberPeaks() const = 0;

  //---------------------------------------------------------------------------------------------
  /** @return the number of peaks
   */
  virtual std::string getConvention() const = 0;

  //---------------------------------------------------------------------------------------------
  /** Removes the indicated peak
   * @param peakNum  the peak to remove. peakNum starts at 0
   */
  virtual void removePeak(int peakNum) = 0;

  //---------------------------------------------------------------------------------------------
  /** Add a peak to the list
   * @param ipeak :: Peak object to add (copy) into this.
   */
  virtual void addPeak(const Mantid::Geometry::IPeak &ipeak) = 0;

  //---------------------------------------------------------------------------------------------
  /** Return a reference to the Peak
   * @param peakNum :: index of the peak to get.
   * @return a reference to a Peak object.
   */
  virtual Mantid::Geometry::IPeak &getPeak(int peakNum) = 0;

  //---------------------------------------------------------------------------------------------
  /** Return a reference to the Peak (const version)
   * @param peakNum :: index of the peak to get.
   * @return a reference to a Peak object.
   */
  virtual const Mantid::Geometry::IPeak &getPeak(int peakNum) const = 0;

  //---------------------------------------------------------------------------------------------
  /** Return a pointer to the Peak
   * @param peakNum :: index of the peak to get.
   * @return a pointer to a Peak object.
   */
  Mantid::Geometry::IPeak *getPeakPtr(const int peakNum) {
    return &this->getPeak(peakNum);
  }

  //---------------------------------------------------------------------------------------------
  /** Create an instance of a Peak
   * @param QLabFrame :: Q of the center of the peak in the lab frame, in
   * reciprocal space
   * @param detectorDistance :: Optional distance between the sample and the
   * detector. Calculated if not provided.
   * @return a pointer to a new Peak object.
   */
  virtual Mantid::Geometry::IPeak *
  createPeak(const Mantid::Kernel::V3D &QLabFrame,
             boost::optional<double> detectorDistance) const = 0;

  /**
   * Create an instance of a peak using a V3D
   * @param HKL V3D
   * @return a pointer to a new Peak object.
   */
  virtual Mantid::Geometry::IPeak *
  createPeakHKL(const Mantid::Kernel::V3D &HKL) const = 0;

  //---------------------------------------------------------------------------------------------
  /** Determine if the workspace has been integrated using a peaks integration
   * algorithm.
   * @return TRUE if the workspace has been integrated.
   */
  virtual bool hasIntegratedPeaks() const = 0;

  //---------------------------------------------------------------------------------------------
  /**
   * Creates a new TableWorkspace giving the IDs of the detectors that
   * contribute to the
   * peak.
   * @returns A shared pointer to a TableWorkspace containing the information
   */
  virtual API::ITableWorkspace_sptr createDetectorTable() const = 0;

  //---------------------------------------------------------------------------------------------
  /**
   * Set the special coordinate system.
   * @param coordinateSystem : Special Q3D coordinate system to use.
   */
  virtual void setCoordinateSystem(
      const Kernel::SpecialCoordinateSystem coordinateSystem) = 0;
  //---------------------------------------------------------------------------------------------
  /**
   * Get the special coordinate system.
   * @returns special Q3D coordinate system to use being used by this
   * PeaksWorkspace object. Probably the one the workspace was generated with.
   */
  virtual Kernel::SpecialCoordinateSystem
  getSpecialCoordinateSystem() const = 0;

  virtual std::vector<std::pair<std::string, std::string>>
  peakInfo(const Kernel::V3D &QFrame, bool labCoords) const = 0;
  virtual int peakInfoNumber(const Kernel::V3D &qLabFrame,
                             bool labCoords) const = 0;

  std::string convention;

protected:
  /// Protected copy constructor. May be used by childs for cloning.
  IPeaksWorkspace(const IPeaksWorkspace &) = default;

  const std::string toString() const override;

private:
  IPeaksWorkspace *doClone() const override = 0;
};
}
}
#endif