contrib/rpl/rgrl/rgrl_matcher_pseudo_int_3d.h

Go to the documentation of this file.

#ifndef rgrl_matcher_pseudo_int_3d_h_
#define rgrl_matcher_pseudo_int_3d_h_
//:
// \file
// \author Chuck Stewart & Gehua Yang
// \date   July 2004
// By introducing "int" in the filename, it only means that
// it will resample the mapped points to integer location and also discretize
// the shift vector to integer location.

#include <rgrl/rgrl_matcher.h>
#include <rgrl/rgrl_feature_set.h>
#include <rgrl/rgrl_view.h>
#include <rgrl/rgrl_transformation.h>
#include <rgrl/rgrl_scale.h>
#include <rgrl/rgrl_feature_sptr.h>
#include "rgrl_evaluator.h"
#include <rgrl/rgrl_mask_sptr.h>
#include <rgrl/rgrl_mask.h>
#include <vil3d/vil3d_image_view.h>
#include <vnl/vnl_double_3.h>
#include <vnl/vnl_int_3.h>
#include "rgrl_evaluator_sptr.h"

#if 0 // ITK-specific
template < class PixelType, int Dimension > class itkImage;
#endif

template < class PixelType >
class rgrl_matcher_pseudo_int_3d
  : public rgrl_matcher
{
 public:

  class rgrl_mapped_pixel_type {
   public:
    // the mapped location is to be integer
    vnl_int_3           location;
    double              intensity;
    double              weight;
    rgrl_mapped_pixel_type(): location(), intensity(0.0), weight(1.0)  {}
  };

  typedef vcl_vector< rgrl_mapped_pixel_type > rgrl_mapped_pixel_vector_type;

  //: Initialize the matcher using 3d images.
  //
  rgrl_matcher_pseudo_int_3d( vil3d_image_view<PixelType> const& from_image,
                              vil3d_image_view<PixelType> const& to_image,
                              vnl_vector< double > const& from_spacing_ratio,
                              vnl_vector< double > const& to_spacing_ratio,
                              rgrl_evaluator_sptr evaluator,
                              rgrl_mask_sptr mask = 0 );

  //:  Match the features in the "from" image to the intensity in the "to" image.
  //
  rgrl_match_set_sptr
  compute_matches( rgrl_feature_set const&     from_features,
                   rgrl_feature_set const&     to_features,
                   rgrl_view const&            current_view,
                   rgrl_transformation const&  current_xform,
                   rgrl_scale const&           current_scale ,
                   rgrl_match_set_sptr const& old_matches = 0);

  // Defines type-related functions
  rgrl_type_macro( rgrl_matcher_pseudo_int_3d, rgrl_matcher);

 private:

  // only to be used in the map_region_intensities function
  struct mapped_info {
    vnl_double_3  physical_, pixel_;
    PixelType     in_;
  };

  // only used when generating discrete shift
  struct discrete_shift_node {
    vnl_int_3  shift_;
    //: delta step compared to previous node
    double     step_;

    discrete_shift_node(): shift_(), step_(0.0) {}

    discrete_shift_node(const vnl_int_3& shift, const double& step)
      : shift_(shift), step_(step) {}

    discrete_shift_node operator-() const {
      discrete_shift_node that;
      that.shift_ = -shift_;
      that.step_ = -step_;
      return that;
    }
  };

  //:  Map the intensities of the image region.
  void
  map_region_intensities( rgrl_transformation      const& trans,
                          rgrl_feature_sptr               feature_sptr,
                          rgrl_mapped_pixel_vector_type & mapped_pixels ) const;

  //:  The actual work of mapping the region intensities.
  void
  map_region_intensities( vcl_vector< vnl_vector<int> > const& pixel_locations,
                          rgrl_transformation           const& trans,
                          rgrl_feature_sptr                    feature_sptr,
                          rgrl_mapped_pixel_vector_type      & mapped_pixels) const;

  //: move window around to find the optimum response
  void
  slide_window(rgrl_feature_sptr                    mapped_feature,
               rgrl_mapped_pixel_vector_type const& mapped_pixels,
               rgrl_scale                    const& current_scale,
               vcl_vector< rgrl_feature_sptr >    & matched_to_features,
               vcl_vector< double >               & match_weights ) const;

  //: compute response
  double compute_response( rgrl_mapped_pixel_vector_type const& mapped_pixels,
                           vnl_int_3                     const& shift ) const;

  //: sample pixel locations along a direction vector
  //  The first element is always [0 0 0]
  //  And it make sure all elements are connected
  void sample_pixels_along_direction( vcl_vector<discrete_shift_node>& two_dir_shifts,
                                      vnl_double_3 dir,
                                      double max_length ) const;
 private:

#if 0 // ITK-specific
  typedef itkImage< PixelType, Dimension > ImageType;
#endif // 0

  //  These are currently only for 2d images.  ITK templates across
  //  dimension.  VXL / rgrl does not.  Need to work with ITK images
  vil3d_image_view<PixelType> from_image_;
  vil3d_image_view<PixelType> to_image_;

  // When we try to search for the best match, we have to make sure
  // only the points inside the valid region are considered. The mask_
  // here seems to be duplicate with the mask_ in
  // rgrl_feature_set_location_masked.  But it seems to me that it
  // can't be avoid to put another mask_ here with the current design.
  // Also, this is also temporary for retina images. - Bess.
  rgrl_mask_sptr mask_;
  rgrl_evaluator_sptr evaluator_;

  // The ratio of physical coordinates / pixel coordinates.
  // It represents the physical distance between pixels.
  vnl_double_3 from_spacing_ratio_;
  vnl_double_3 to_spacing_ratio_;
};

#endif // rgrl_matcher_pseudo_int_3d_h_