SmtkMatcher.h

Go to the documentation of this file.

#ifndef SmtkMatcher_h
#define SmtkMatcher_h
 
/* SPDX-License-Identifier: CC0-1.0 */
 
#include <memory>
 
 
#include <QSharedPointer>
#include "SmtkStack.h"
#include "Gruen.h"
#include "SmtkPoint.h"
 
#include "GSLUtility.h"
#include <gsl/gsl_rng.h>
 
 
namespace Isis {
 
class SmtkMatcher {
  public:
    SmtkMatcher();
    SmtkMatcher(const QString &regdef);
    SmtkMatcher(const QString &regdef, Cube *lhImage, Cube *rhImage);
    SmtkMatcher(Cube *lhImage, Cube *rhImage);
    ~SmtkMatcher();
 
    void setImages(Cube *lhImage, Cube *rhImage);
    void setGruenDef(const QString &regdef);
 
    bool isValid(const Coordinate &pnt);
    bool isValid(const SmtkPoint &spnt);
 
    Chip *PatternChip() const {
      validate();
      return (m_gruen->PatternChip());
    }
 
    Chip *SearchChip() const {
      validate();
      return (m_gruen->SearchChip());
    }
 
    Chip *FitChip() const {
      validate();
      return (m_gruen->FitChip());
    }
 
    void setWriteSubsearchChipPattern(const QString &fileptrn = "SmtkMatcher");
 
    SmtkQStackIter FindSmallestEV(SmtkQStack &stack);
    SmtkQStackIter FindExpDistEV(SmtkQStack &stack, const double &seedsample,
                                 const double &minEV, const double &maxEV);
 
    SmtkPoint Register(const Coordinate &lpnt,
                       const AffineRadio &affrad = AffineRadio());
    SmtkPoint Register(const PointPair &pnts,
                       const AffineRadio &affrad = AffineRadio());
    SmtkPoint Register(const SmtkPoint &spnt,
                       const AffineRadio &affrad = AffineRadio());
    SmtkPoint Register(const PointGeometry &lpg, const PointGeometry &rpg,
                       const AffineRadio &affrad  = AffineRadio());
 
    SmtkPoint Create(const Coordinate &left, const Coordinate &right);
    SmtkPoint Clone(const SmtkPoint &point, const Coordinate &left);
 
    inline BigInt OffImageErrorCount() const { return (m_offImage);  }
    inline BigInt SpiceErrorCount() const { return (m_spiceErr);  }
 
    PvlGroup RegTemplate() { return (m_gruen->RegTemplate());  }
    Pvl RegistrationStatistics() { return (m_gruen->RegistrationStatistics()); }
 
  private:
    SmtkMatcher &operator=(const SmtkMatcher &matcher); // Assignment disabled
    SmtkMatcher(const SmtkMatcher &matcher);            // Copy const disabled
 
    Cube     *m_lhCube;                // Left image cube (not owned)
    Cube     *m_rhCube;                // Right image cube (not owned)
    QSharedPointer<Gruen> m_gruen;     // Gruen matcher
    BigInt  m_offImage;                // Offimage counter
    BigInt  m_spiceErr;                // SPICE distance error
    bool    m_useAutoReg;              // Select AutoReg features
    const gsl_rng_type * T;            // GSL random number type
    gsl_rng * r;                       // GSL random number generator
 
    void randomNumberSetup();
    bool validate(const bool &throwError = true) const;
 
    inline Camera &lhCamera() { return (*m_lhCube->camera());   }
    inline Camera &rhCamera() { return (*m_rhCube->camera());   }
 
    Coordinate getLineSample(Camera &camera, const Coordinate &geom);
    Coordinate getLatLon(Camera &camera, const Coordinate &pnt);
 
    bool inCube(const Camera &camera, const Coordinate &point) const;
 
    SmtkPoint makeRegisteredPoint(const PointGeometry &left,
                                  const PointGeometry &right, Gruen *gruen);
};
} // namespace Isis
 
#endif