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

Replace a source image with gaussian distributed random noise If you don't provide a seed at all, it should be seeded using the best available source of randomness( time(0) in this implementation). More...

#include <processor.h>

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

Public Member Functions

virtual void process_inplace (EMData *image)
 To process an image in-place. More...
 
virtual string get_name () const
 Get the processor's name. More...
 
virtual string get_desc () const
 Get the descrition of this specific processor. More...
 
virtual 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::TestImageProcessor
static string get_group_desc ()
 
- 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 = "testimage.noise.gauss"
 

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 Member Functions inherited from EMAN::TestImageProcessor
void preprocess (EMData *image)
 
- Protected Attributes inherited from EMAN::TestImageProcessor
int nx
 
int ny
 
int nz
 
- Protected Attributes inherited from EMAN::Processor
Dict params
 

Detailed Description

Replace a source image with gaussian distributed random noise If you don't provide a seed at all, it should be seeded using the best available source of randomness( time(0) in this implementation).

The testimage classes using random numbers should take an int 'seed' parameter. If this parameter is provided, it will be cast into an unsigned int. This will permit initialization to a known state if desired.

Parameters
sigmasigma value of gausian distributed noise, default is 0.5
meanmean value of gausian distributed noise, default is zero
seedmean value of gausian distributed noise, default is zero

Definition at line 8810 of file processor.h.

Member Function Documentation

◆ get_desc()

virtual string EMAN::TestImageNoiseGauss::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 8820 of file processor.h.

8821 {
8822 return "Replace a source image as a random noise, the random value is gaussian distributed";
8823 }

◆ get_name()

virtual string EMAN::TestImageNoiseGauss::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 8815 of file processor.h.

8816 {
8817 return NAME;
8818 }
static const string NAME
Definition: processor.h:8840

References NAME.

◆ get_param_types()

virtual TypeDict EMAN::TestImageNoiseGauss::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 8830 of file processor.h.

8831 {
8832 TypeDict d;
8833 d.put("sigma", EMObject::FLOAT, "sigma value of gausian distributed noise, default is 0.5");
8834 d.put("mean", EMObject::FLOAT, "mean value of gausian distributed noise, default is zero.");
8835 d.put("seed", EMObject::INT, "the seed for random number generator, default is not to reseed.");
8836
8837 return d;
8838 }
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::FLOAT, EMAN::EMObject::INT, and EMAN::TypeDict::put().

◆ NEW()

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

Definition at line 8825 of file processor.h.

8826 {
8827 return new TestImageNoiseGauss();
8828 }
Replace a source image with gaussian distributed random noise If you don't provide a seed at all,...
Definition: processor.h:8811

◆ process_inplace()

void TestImageNoiseGauss::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 10056 of file processor.cpp.

10057{
10058 preprocess(image);
10059
10060 float sigma = params["sigma"];
10061 if (sigma<=0) { sigma = 1.0; }
10062 float mean = params["mean"];
10063
10064 Randnum * r = Randnum::Instance();
10065 if (params.has_key("seed")) {
10066 r->set_seed((int)params["seed"]);
10067 }
10068
10069 float *dat = image->get_data();
10070 size_t size = (size_t)nx*ny*nz;
10071 for (size_t i=0; i<size; ++i) {
10072 dat[i] = r->get_gauss_rand(mean, sigma);
10073 }
10074
10075 image->update();
10076}
bool has_key(const string &key) const
Ask the Dictionary if it as a particular key.
Definition: emobject.h:511
The wrapper class for gsl's random number generater.
Definition: randnum.h:86
void set_seed(unsigned long long seed)
Set the seed for the random number generator.
Definition: randnum.cpp:142
static Randnum * Instance()
Definition: randnum.cpp:104
float get_gauss_rand(float mean, float sigma) const
Return a Gaussian random number.
Definition: randnum.cpp:168
void preprocess(EMData *image)
Definition: processor.cpp:8923

References EMAN::Randnum::get_gauss_rand(), EMAN::Dict::has_key(), EMAN::Randnum::Instance(), EMAN::TestImageProcessor::nx, EMAN::TestImageProcessor::ny, EMAN::TestImageProcessor::nz, EMAN::Processor::params, EMAN::TestImageProcessor::preprocess(), and EMAN::Randnum::set_seed().

Member Data Documentation

◆ NAME

const string TestImageNoiseGauss::NAME = "testimage.noise.gauss"
static

Definition at line 8840 of file processor.h.

Referenced by get_name().


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