IFullwave.hpp

#pragma once
 
#include <opals/IModuleBase.hpp>
#include <opals/Path.hpp>
#include <opals/Vector.hpp>
#include <opals/FullwaveAlgorithm.hpp>
#include <opals/Array.hpp>
 
#if defined(_MSC_VER) && !defined(OPALS_NO_AUTOLINK)
  #if defined _DEBUG && !defined OPALS_NO_DEBUG
      #pragma comment(lib, "opalsFullwave_d.lib")
  #else
      #pragma comment(lib, "opalsFullwave.lib")
  #endif
#endif
 
namespace opals {
 
  namespace opts
  {
    /// Options of \ref ModuleFullwave
    namespace Fullwave
    {
      /// Options of \ref ModuleFullwave
      using Options =
        IGroup< Names::_, false,
          ILeaf< Names::inFile, false, Path  >,
          ILeaf< Names::outFile, false, Path  >,
          ILeaf< Names::oFormat, false, String  >,
          ILeaf< Names::fullWaveAlg, false, FullwaveAlgorithm  >,
          ILeaf< Names::detectThrLow, false, int  >,
          ILeaf< Names::mtaZone, false, int  >,
          ILeaf< Names::timeRange, false, Array<double, 2>  >,
          ILeaf< Names::filter, false, String  >
        >;
    }
  }
 
  /// Performs decomposition of the full waveform signal and provides 3D coordinates (scanner system) and additional attributes for each return.
  /** The module provides echo extraction from raw full waveform data.
      Together with the 3D coordinates of these echoes, additional attributes
      such as amplitude and echo width are derived.
      
      As there are scanners allowing for multiple laser pulses in air (multiple-time around, MTA)
      an MTA zone can be provided (parameter mtaZone, 1-..) or detected and adapted automatically (0).
      
      The output is stored in the scanner's own coordinate system (SOCS).
      For proper georeferencing, opalsDirectGeoref is intended to be used after fullwave echo extraction. */
  /// \see \ref ModuleFullwave
  class OPALS_API IFullwave : virtual public IModuleBase
  {
 
  public:
    static IFullwave* New();
    static IFullwave* New( IControlObject &controlObject );
    static IFullwave* New( const IModuleBase &parent );
    static IFullwave* New( const IModuleBase &parent, IControlObject &controlObject );
 
    virtual ~IFullwave() {}
 
    /// \name Access to module-specific options.
    ///@{
    using Options = opts::Fullwave::Options;
    virtual       Options& opts()       = 0;
    virtual const Options& opts() const = 0;
    ///@}
 
  };
 
};