EMAN::BoxStatProcessor Class Reference

BoxStatProcessor files are a kind of neighborhood processors. More...

#include <processor.h>

Inheritance diagram for EMAN::BoxStatProcessor:

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

Collaboration graph
[legend]
List of all members.

Public Member Functions

void process_inplace (EMData *image)
 To process an image in-place.
TypeDict get_param_types () const
 Get processor parameter information in a dictionary.

Static Public Member Functions

static string get_group_desc ()
 Get the description of this group of processors.

Protected Member Functions

virtual void process_pixel (float *pixel, const float *array, int n) const =0

Detailed Description

BoxStatProcessor files are a kind of neighborhood processors.

These processors compute every output pixel using information from a reduced region on the neighborhood of the input pixel. The classical form are the 3x3 processors. BoxStatProcessors could perform diverse tasks ranging from noise reduction, to differential , to mathematical morphology. BoxStatProcessor class is the base class. Specific BoxStatProcessor needs to define process_pixel(float *pixel, const float *array, int n).

Parameters:
radius The radius of the search box, default is 1 which results in a 3x3 box (3 = 2xradius + 1)

Definition at line 2984 of file processor.h.


Member Function Documentation

static string EMAN::BoxStatProcessor::get_group_desc (  )  [inline, static]

Get the description of this group of processors.

This function is defined in a parent class. It gives a introduction to a group of processors.

Returns:
The description of this group of processors.

Reimplemented from EMAN::Processor.

Definition at line 2989 of file processor.h.

02990                 {
02991                         return "BoxStatProcessor files are a kind of neighborhood processors. These processors compute every output pixel using information from a reduced region on the neighborhood of the input pixel. The classical form are the 3x3 processors. BoxStatProcessors could perform diverse tasks ranging from noise reduction, to differential , to mathematical morphology. BoxStatProcessor class is the base class. Specific BoxStatProcessor needs to define process_pixel(float *pixel, const float *array, int n).";
02992                 }

TypeDict EMAN::BoxStatProcessor::get_param_types (  )  const [inline, virtual]

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.

Reimplemented in EMAN::PeakOnlyProcessor.

Definition at line 2994 of file processor.h.

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

02995                 {
02996                         TypeDict d;
02997                         d.put("radius", EMObject::INT, "The radius of the search box, default is 1 which results in a 3x3 box (3 = 2xradius + 1)");
02998                         return d;
02999                 }

void BoxStatProcessor::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:
image The image to be processed.

Implements EMAN::Processor.

Definition at line 1736 of file processor.cpp.

References data, EMAN::EMData::get_data(), EMAN::EMData::get_xsize(), EMAN::EMData::get_ysize(), EMAN::EMData::get_zsize(), LOGWARN, nx, ny, EMAN::Processor::params, process_pixel(), EMAN::Dict::set_default(), and EMAN::EMData::update().

01737 {
01738         if (!image) {
01739                 LOGWARN("NULL Image");
01740                 return;
01741         }
01742 
01743         int nx = image->get_xsize();
01744         int ny = image->get_ysize();
01745         int nz = image->get_zsize();
01746 
01747         int n = params.set_default("radius",1);
01748         int areasize = 2 * n + 1;
01749 
01750         int matrix_size = areasize * areasize;
01751         if (nz > 1) {
01752                 matrix_size *= areasize;
01753         }
01754 
01755         float *array = new float[matrix_size];
01756 //      image->process_inplace("normalize");
01757 
01758         float *data = image->get_data();
01759         size_t total_size = (size_t)nx * (size_t)ny * (size_t)nz;
01760         float *data2 = new float[total_size];
01761         memcpy(data2, data, total_size * sizeof(float));
01762 
01763         int z_begin = 0;
01764         int z_end = 1;
01765         int nzz=0;
01766         if (nz > 1) {
01767                 z_begin = n;
01768                 z_end = nz - n;
01769                 nzz=n;
01770         }
01771 
01772         int nxy = nx * ny;
01773 
01774         for (int k = z_begin; k < z_end; k++) {
01775                 size_t knxy = (size_t)k * nxy;
01776 
01777                 for (int j = n; j < ny - n; j++) {
01778                         int jnx = j * nx;
01779 
01780                         for (int i = n; i < nx - n; i++) {
01781                                 size_t s = 0;
01782 
01783                                 for (int i2 = i - n; i2 <= i + n; i2++) {
01784                                         for (int j2 = j - n; j2 <= j + n; j2++) {
01785                                                 for (int k2 = k - nzz; k2 <= k + nzz; k2++) {
01786                                                         array[s] = data2[i2 + j2 * nx + (size_t)k2 * nxy];
01787                                                         ++s;
01788                                                 }
01789                                         }
01790                                 }
01791 
01792                                 process_pixel(&data[i + jnx + knxy], array, matrix_size);
01793                         }
01794                 }
01795         }
01796 
01797         image->update();
01798 
01799         if( data2 )
01800         {
01801                 delete[]data2;
01802                 data2 = 0;
01803         }
01804 }

virtual void EMAN::BoxStatProcessor::process_pixel ( float *  pixel,
const float *  array,
int  n 
) const [protected, pure virtual]

Implemented in EMAN::BoxMedianProcessor, EMAN::BoxSigmaProcessor, EMAN::BoxMaxProcessor, EMAN::MinusPeakProcessor, and EMAN::PeakOnlyProcessor.

Referenced by process_inplace().


The documentation for this class was generated from the following files:
Generated on Thu May 3 10:10:06 2012 for EMAN2 by  doxygen 1.4.7