EMAN2
Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
EMAN::ConvolutionProcessor Class Reference

This processor performs fast convolution in Fourier space. More...

#include <processor.h>

Inheritance diagram for EMAN::ConvolutionProcessor:
Inheritance graph
[legend]
Collaboration diagram for EMAN::ConvolutionProcessor:
Collaboration graph
[legend]

Public Member Functions

 ConvolutionProcessor ()
 
string get_name () const
 Get the processor's name. More...
 
void process_inplace (EMData *image)
 To process an image in-place. More...
 
string get_desc () const
 Get the descrition of this specific processor. More...
 
TypeDict get_param_types () const
 Get processor parameter information in a dictionary. More...
 
- Public Member Functions inherited from EMAN::Processor
virtual ~Processor ()
 
virtual EMDataprocess (const EMData *const image)
 To proccess an image out-of-place. More...
 
virtual void process_list_inplace (vector< EMData * > &images)
 To process multiple images using the same algorithm. More...
 
virtual Dict get_params () const
 Get the processor parameters in a key/value dictionary. More...
 
virtual void set_params (const Dict &new_params)
 Set the processor parameters using a key/value dictionary. More...
 

Static Public Member Functions

static ProcessorNEW ()
 
- Static Public Member Functions inherited from EMAN::Processor
static string get_group_desc ()
 Get the description of this group of processors. More...
 
static void EMFourierFilterInPlace (EMData *fimage, Dict params)
 Compute a Fourier-filter processed image in place. More...
 
static EMDataEMFourierFilter (EMData *fimage, Dict params)
 Compute a Fourier-processor processed image without altering the original image. More...
 

Static Public Attributes

static const string NAME = "math.convolution"
 

Additional Inherited Members

- Public Types inherited from EMAN::Processor
enum  fourier_filter_types {
  TOP_HAT_LOW_PASS , TOP_HAT_HIGH_PASS , TOP_HAT_BAND_PASS , TOP_HOMOMORPHIC ,
  GAUSS_LOW_PASS , GAUSS_HIGH_PASS , GAUSS_BAND_PASS , GAUSS_INVERSE ,
  GAUSS_HOMOMORPHIC , BUTTERWORTH_LOW_PASS , BUTTERWORTH_HIGH_PASS , BUTTERWORTH_HOMOMORPHIC ,
  KAISER_I0 , KAISER_SINH , KAISER_I0_INVERSE , KAISER_SINH_INVERSE ,
  SHIFT , TANH_LOW_PASS , TANH_HIGH_PASS , TANH_HOMOMORPHIC ,
  TANH_BAND_PASS , RADIAL_TABLE , CTF_
}
 Fourier filter Processor type enum. More...
 
- Protected Attributes inherited from EMAN::Processor
Dict params
 

Detailed Description

This processor performs fast convolution in Fourier space.

Author
David Woolford
Date
2007/12/04
Parameters
withThe image that will convolute the other image

Definition at line 639 of file processor.h.

Constructor & Destructor Documentation

◆ ConvolutionProcessor()

EMAN::ConvolutionProcessor::ConvolutionProcessor ( )
inline

Definition at line 642 of file processor.h.

642{}

Referenced by NEW().

Member Function Documentation

◆ get_desc()

string EMAN::ConvolutionProcessor::get_desc ( ) const
inlinevirtual

Get the descrition of this specific processor.

This function must be overwritten by a subclass.

Returns
The description of this processor.

Implements EMAN::Processor.

Definition at line 656 of file processor.h.

657 {
658 return "Performs Fourier space convolution. Maintains the space that the image is in - i.e. if image is real, the result is real and vice versa.";
659 }

◆ get_name()

string EMAN::ConvolutionProcessor::get_name ( ) const
inlinevirtual

Get the processor's name.

Each processor is identified by a unique name.

Returns
The processor's name.

Implements EMAN::Processor.

Definition at line 644 of file processor.h.

645 {
646 return NAME;
647 }
static const string NAME
Definition: processor.h:668

References NAME.

◆ get_param_types()

TypeDict EMAN::ConvolutionProcessor::get_param_types ( ) const
inlinevirtual

Get processor parameter information in a dictionary.

Each parameter has one record in the dictionary. Each record contains its name, data-type, and description.

Returns
A dictionary containing the parameter info.

Reimplemented from EMAN::Processor.

Definition at line 661 of file processor.h.

662 {
663 TypeDict d;
664 d.put("with", EMObject::EMDATA, "The image that will convolute the other image");
665 return d;
666 }
TypeDict is a dictionary to store <string, EMObject::ObjectType> pair.
Definition: emobject.h:305
void put(const string &key, EMObject::ObjectType o, const string &desc="")
Definition: emobject.h:330

References EMAN::EMObject::EMDATA, and EMAN::TypeDict::put().

◆ NEW()

static Processor * EMAN::ConvolutionProcessor::NEW ( )
inlinestatic

Definition at line 651 of file processor.h.

652 {
653 return new ConvolutionProcessor();
654 }

References ConvolutionProcessor().

◆ process_inplace()

void ConvolutionProcessor::process_inplace ( EMData image)
virtual

To process an image in-place.

For those processors which can only be processed out-of-place, override this function to just print out some error message to remind user call the out-of-place version.

Parameters
imageThe image to be processed.

Implements EMAN::Processor.

Definition at line 12676 of file processor.cpp.

12677{
12678 //bool complexflag = false;
12679 EMData* null = 0;
12680 EMData* with = params.set_default("with", null);
12681 if ( with == NULL ) throw InvalidParameterException("Error - the image required for the convolution is null");
12682
12683 EMData* newimage = fourierproduct(image, with, CIRCULANT, CONVOLUTION, false);
12684
12685 float* orig = image->get_data();
12686 float* work = newimage->get_data();
12687 int nx = image->get_xsize();
12688 int ny = image->get_ysize();
12689 int nz = image->get_zsize();
12690 memcpy(orig,work,nx*ny*nz*sizeof(float));
12691 image->update();
12692
12693 delete newimage;
12694}
type set_default(const string &key, type val)
Default setting behavior This can be achieved using a template - d.woolford Jan 2008 (before there wa...
Definition: emobject.h:569
EMData stores an image's data and defines core image processing routines.
Definition: emdata.h:82
#define InvalidParameterException(desc)
Definition: exception.h:361

References InvalidParameterException, EMAN::Processor::params, and EMAN::Dict::set_default().

Member Data Documentation

◆ NAME

const string ConvolutionProcessor::NAME = "math.convolution"
static

Definition at line 668 of file processor.h.

Referenced by get_name().


The documentation for this class was generated from the following files: