CoarseConvolution.h

Go to the documentation of this file.

/**
 *  \file IMP/em/CoarseConvolution.h
 *  \brief Convolutes two grids
 *
 *  Copyright 2007-2022 IMP Inventors. All rights reserved.
 *
 */

#ifndef IMPEM_COARSE_CONVOLUTION_H
#define IMPEM_COARSE_CONVOLUTION_H

#include <IMP/em/em_config.h>
#include "exp.h"
#include "DensityMap.h"
#include "SampledDensityMap.h"
#include "def.h"
#include <vector>

IMPEM_BEGIN_NAMESPACE

//! Convolutes two grids
/** The pixels involved are derived from the positions of N particles.
 */
class IMPEMEXPORT CoarseConvolution {

 public:
#if 0
  //! Evaluates the convolution between two density grids
  /**
      f*g(n)=f(m)g(n-m); m runs between -inf to inf
      \param[in] f A DensityMap. note:
             correct RMSD and mean MUST be in the header!
      \param[in] g a sampled density map of particles
      \param[in] g_ps particles data (location, radii, weight)
      \param[in] dvx vector to contain the x partial derivatives for g_access_p
      \param[in] dvy vector to contain the y partial derivatives for g_access_p
      \param[in] dvz vector to contain the z partial derivatives for g_access_p
      \param[in] scalefactor scale factor to apply to the value of the cross
             correlation term
      \param[in] lderiv if true, the derivatives of the term are computed
      \return the value of the cross correlation term: scalefac*(1-ccc)
   */
  /*
  static float evaluate(DensityMap &f, SampledDensityMap &g,
                        const Particles &g_ps,
                        std::vector<float> &dvx, std::vector<float>&dvy,
                        std::vector<float>&dvz, float scalefac, bool lderiv);
  */
  /*
  static void calc_derivatives(const DensityMap &comp1,
                              SampledDensityMap &comp2,
                              const Particles &ps_comp2,
                              const float &scalefac,
                              std::vector<float> &dvx, std::vector<float>&dvy,
                              std::vector<float>&dvz);
*/
#endif

  /** Cross correlation coefficient between the em density and the density of a
      model. moddens threshold can be specified that is checked in moddens to
      reduce elements of summation
      \note This is not the local CC function
      \param[in] em_map               the target map (experimentally determined)
      \param[in] model_map            the sampled density map of the model
      \param[in] voxel_data_threshold voxels with value lower than threshold
                 in model_map are not summed (avoid calculating correlation on
                 voxels below the threshold)
      \param[in] recalc_ccnormfac Ignored. The purpose is to determines whether
                 the model_map should be
                 normalized prior to the correlation calculation. false is
                 faster, but potentially inaccurate
      \return the convolution value between two density maps

      \note recalc_ccnormfac is ignored.
   */
  static float convolution(const DensityMap *em_map, DensityMap *model_map,
                           float voxel_data_threshold,
                           bool recalc_ccnormfac = true);
};

IMPEM_END_NAMESPACE

#endif /* IMPEM_COARSE_CONVOLUTION_H */