// --------------------------------------------------------------------------
//                   OpenMS -- Open-Source Mass Spectrometry
// --------------------------------------------------------------------------
// Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
// ETH Zurich, and Freie Universitaet Berlin 2002-2017.
//
// This software is released under a three-clause BSD license:
//  * Redistributions of source code must retain the above copyright
//    notice, this list of conditions and the following disclaimer.
//  * Redistributions in binary form must reproduce the above copyright
//    notice, this list of conditions and the following disclaimer in the
//    documentation and/or other materials provided with the distribution.
//  * Neither the name of any author or any participating institution
//    may be used to endorse or promote products derived from this software
//    without specific prior written permission.
// For a full list of authors, refer to the file AUTHORS.
// --------------------------------------------------------------------------
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
// INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
// OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
// WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
// OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
// ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
// --------------------------------------------------------------------------
// $Maintainer: Timo Sachsenberg $
// $Authors: Eva Lange $
// --------------------------------------------------------------------------

#ifndef OPENMS_TRANSFORMATIONS_RAW2PEAK_CONTINUOUSWAVELETTRANSFORM_H
#define OPENMS_TRANSFORMATIONS_RAW2PEAK_CONTINUOUSWAVELETTRANSFORM_H

#include <OpenMS/KERNEL/Peak1D.h>

#include <vector>

namespace OpenMS
{
  /**
       @brief This class is the base class of the continuous wavelet transformation.
  */
  class OPENMS_DLLAPI ContinuousWaveletTransform
  {
public:
    /// Raw data const iterator type
    typedef std::vector<Peak1D>::const_iterator PeakConstIterator;


    /// Constructor
    ContinuousWaveletTransform() :
      scale_(0),
      spacing_(0),
      signal_length_(0),
      end_left_padding_(0),
      begin_right_padding_(0)
    {}

    /// Destructor.
    virtual ~ContinuousWaveletTransform()
    {}

    /// Non-mutable access to the wavelet transform of the signal
    inline const std::vector<Peak1D> & getSignal() const
    {
      return signal_;
    }

    /// Mutable access to the wavelet transform of the signal
    inline std::vector<Peak1D> & getSignal()
    {
      return signal_;
    }

    /// Mutable access to the wavelet transform of the signal
    inline void setSignal(const std::vector<Peak1D> & signal)
    {
      signal_ = signal;
    }

    /// Non-mutable access to the wavelet
    inline const std::vector<double> & getWavelet() const
    {
      return wavelet_;
    }

    /// Mutable access to the wavelet
    inline std::vector<double> & getWavelet()
    {
      return wavelet_;
    }

    /// Mutable access to the signal
    inline void setWavelet(const std::vector<double> & wavelet)
    {
      wavelet_ = wavelet;
    }

    // Non-mutable access to the scale of the wavelet
    inline double getScale() const
    {
      return scale_;
    }

    /// Mutable access to the spacing of raw data
    inline double & getScale()
    {
      return scale_;
    }

    /// Mutable access to the spacing of raw data
    inline void setScale(double scale)
    {
      scale_ = scale;
    }

    // Non-mutable access to the spacing of raw data
    inline double getSpacing() const
    {
      return spacing_;
    }

    /// Mutable access to the spacing of raw data
    inline double & getSpacing()
    {
      return spacing_;
    }

    /// Mutable access to the spacing of raw data
    inline void setSpacing(double spacing)
    {
      spacing_ = spacing;
    }

    /// Non-mutable access to the position where the signal starts (in the interval [0,end_left_padding_) are the padded zeros)
    inline SignedSize getLeftPaddingIndex() const
    {
      return end_left_padding_;
    }

    /// Mutable access to the position where the signal starts
    inline SignedSize & getLeftPaddingIndex()
    {
      return end_left_padding_;
    }

    /// Mutable access to position where the signal starts
    inline void setLeftPaddingIndex(const SignedSize end_left_padding)
    {
      end_left_padding_ = end_left_padding;
    }

    /// Non-mutable access to the position where the signal ends (in the interval (begin_right_padding_,end] are the padded zeros)
    inline SignedSize getRightPaddingIndex() const
    {
      return begin_right_padding_;
    }

    /// Mutable access to the position where the signal starts
    inline SignedSize & getRightPaddingIndex()
    {
      return begin_right_padding_;
    }

    /// Mutable access to position where the signal starts
    inline void setRightPaddingIndex(const SignedSize begin_right_padding)
    {
      begin_right_padding_ = begin_right_padding;
    }

    /// Non-mutable access to signal length [end_left_padding,begin_right_padding]
    inline SignedSize getSignalLength() const
    {
      return signal_length_;
    }

    /// Mutable access to signal length [end_left_padding,begin_right_padding]
    inline SignedSize & getSignalLength()
    {
      return signal_length_;
    }

    /// Mutable access to signal length [end_left_padding,begin_right_padding]
    inline void setSignalLength(const SignedSize signal_length)
    {
      signal_length_ = signal_length;
    }

    /// Non-mutable access to signal length including padded zeros [0,end]
    inline int getSize() const
    {
      return (int) signal_.size();
    }

    /**
             @brief Perform possibly necessary preprocessing steps, like tabulating the Wavelet.
    */
    virtual void init(double scale, double spacing);


    /// Yields the signal (intensity) at position i
    inline double operator[](unsigned int i)
    {
      return signal_[i].getIntensity();
    }

    inline double operator[](unsigned int i) const
    {
      return signal_[i].getIntensity();
    }

protected:
    /// The transformed signal
    std::vector<Peak1D> signal_;

    /// The pre-tabulated wavelet used for the transform
    std::vector<double> wavelet_;

    /// Spacing and scale of the wavelet and length of the signal.
    double scale_;
    double spacing_;
    SignedSize signal_length_;

    /// We often have to pad the transform at the left and right with
    /// zeros. Since we don't want to iterate over those as well, we
    /// have to store their positions.
    SignedSize end_left_padding_;
    SignedSize begin_right_padding_;

    template <typename InputPeakIterator>
    double getInterpolatedValue_(double x, InputPeakIterator it_left)
    {
      // Interpolate between the point to the left and the point to the right.
      double left_position = it_left->getMZ();
      double right_position = (it_left + 1)->getMZ();
      double d = (x - left_position) / (right_position - left_position);

      return (it_left + 1)->getIntensity() * d + it_left->getIntensity() * (1 - d);
    }

  };

} //namespace OpenMS

#endif
