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

Determines the partial derivatives in the x direction Does this by constructing edge kernels in real space but convoluting in Fourier space. More...

#include <processor.h>

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

Public Member Functions

 XGradientProcessor ()
 
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.edge.xgradient"
 

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

Determines the partial derivatives in the x direction Does this by constructing edge kernels in real space but convoluting in Fourier space.

Author
David Woolford
Date
2007/12/04

Definition at line 877 of file processor.h.

Constructor & Destructor Documentation

◆ XGradientProcessor()

EMAN::XGradientProcessor::XGradientProcessor ( )
inline

Definition at line 880 of file processor.h.

880{}

Referenced by NEW().

Member Function Documentation

◆ get_desc()

string EMAN::XGradientProcessor::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 894 of file processor.h.

895 {
896 return "Determines the image gradient in the x direction";
897 }

◆ get_name()

string EMAN::XGradientProcessor::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 882 of file processor.h.

883 {
884 return NAME;
885 }
static const string NAME
Definition: processor.h:905

References NAME.

◆ get_param_types()

TypeDict EMAN::XGradientProcessor::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 899 of file processor.h.

900 {
901 TypeDict d;
902 return d;
903 }
TypeDict is a dictionary to store <string, EMObject::ObjectType> pair.
Definition: emobject.h:305

◆ NEW()

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

Definition at line 889 of file processor.h.

890 {
891 return new XGradientProcessor();
892 }

References XGradientProcessor().

◆ process_inplace()

void XGradientProcessor::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 12696 of file processor.cpp.

12697{
12698 if (image->is_complex()) throw ImageFormatException("Cannot edge detect a complex image");
12699
12700 EMData* e = new EMData();
12701 int nx = image->get_xsize();
12702 int ny = image->get_ysize();
12703 int nz = image->get_zsize();
12704
12705 if ( nz == 1 && ny == 1 ) {
12706 if ( nx < 3 ) throw ImageDimensionException("Error - cannot edge detect an image with less than three pixels");
12707
12708 e->set_size(3,1,1);
12709 e->set_value_at(0,-1);
12710 e->set_value_at(2, 1);
12711
12712 Region r = Region(-nx/2+1,nx);
12713 e->clip_inplace(r);
12714 } else if ( nz == 1 ) {
12715 if ( nx < 3 || ny < 3 ) throw ImageDimensionException("Error - cannot edge detect an image with less than three pixels");
12716 e->set_size(3,3,1);
12717 e->set_value_at(0,0,-1);
12718 e->set_value_at(0,1,-2);
12719 e->set_value_at(0,2,-1);
12720
12721 e->set_value_at(2,0,1);
12722 e->set_value_at(2,1,2);
12723 e->set_value_at(2,2,1);
12724 Region r = Region(-nx/2+1,-ny/2+1,nx,ny);
12725 e->clip_inplace(r);
12726 } else {
12727 if ( nx < 3 || ny < 3 || nz < 3) throw ImageDimensionException("Error - cannot edge detect an image with less than three pixels");
12728 e->set_size(3,3,3);
12729 e->set_value_at(0,0,0,-1);
12730 e->set_value_at(0,1,0,-1);
12731 e->set_value_at(0,2,0,-1);
12732 e->set_value_at(0,0,1,-1);
12733 e->set_value_at(0,1,1,-8);
12734 e->set_value_at(0,2,1,-1);
12735 e->set_value_at(0,0,2,-1);
12736 e->set_value_at(0,1,2,-1);
12737 e->set_value_at(0,2,2,-1);
12738
12739 e->set_value_at(2,0,0,1);
12740 e->set_value_at(2,1,0,1);
12741 e->set_value_at(2,2,0,1);
12742 e->set_value_at(2,0,1,1);
12743 e->set_value_at(2,1,1,8);
12744 e->set_value_at(2,2,1,1);
12745 e->set_value_at(2,0,2,1);
12746 e->set_value_at(2,1,2,1);
12747 e->set_value_at(2,2,2,1);
12748
12749 Region r = Region(-nx/2+1,-ny/2+1,-nz/2+1,nx,ny,nz);
12750 e->clip_inplace(r);
12751 }
12752
12753 Dict conv_parms;
12754 conv_parms["with"] = e;
12755 image->process_inplace("math.convolution", conv_parms);
12756 image->process_inplace("xform.phaseorigin.tocenter");
12757
12758 delete e;
12759}
Dict is a dictionary to store <string, EMObject> pair.
Definition: emobject.h:385
EMData stores an image's data and defines core image processing routines.
Definition: emdata.h:82
void clip_inplace(const Region &area, const float &fill_value=0)
Clip the image inplace - clipping region must be smaller than the current region internally memory is...
Definition: emdata.cpp:350
Region defines a 2D or 3D rectangular region specified by its origin coordinates and all edges' sizes...
Definition: geometry.h:497
#define ImageFormatException(desc)
Definition: exception.h:147
#define ImageDimensionException(desc)
Definition: exception.h:166

References EMAN::EMData::clip_inplace(), ImageDimensionException, and ImageFormatException.

Member Data Documentation

◆ NAME

const string XGradientProcessor::NAME = "math.edge.xgradient"
static

Definition at line 905 of file processor.h.

Referenced by get_name().


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