microscope.simulators._ImageGenerator Class Reference

Public Member Functions
	__init__ (self)
	enable_numbering (self, enab)
	get_data_types (self)
	data_type (self)
	set_data_type (self, index)
	get_methods (self)
	method (self)
	set_method (self, index)
	get_image (self, width, height, dark=0, light=255, index=None)
	black (self, w, h, dark, light)
	white (self, w, h, dark, light)
	gradient (self, w, h, dark, light)
	noise (self, w, h, dark, light)
	one_gaussian (self, w, h, dark, light)
	sawtooth (self, w, h, dark, light)

Public Attributes
bool	numbering = True

Protected Attributes
tuple	_methods
int	_method_index = 0
tuple	_datatypes = (np.uint8, np.uint16, float)
int	_datatype_index = 0
	_theta = _theta_generator()
	_font = ImageFont.load_default()

Detailed Description

Generates test images, with methods for configuration via a Setting.

Definition at line 53 of file __init__.py.

Constructor & Destructor Documentation

__init__()

microscope.simulators._ImageGenerator.__init__

(

self

)

Definition at line 56 of file __init__.py.

    def __init__(self):
        self._methods = (
            self.noise,
            self.gradient,
            self.sawtooth,
            self.one_gaussian,
            self.black,
            self.white,
        )
        self._method_index = 0
        self._datatypes = (np.uint8, np.uint16, float)
        self._datatype_index = 0
        self._theta = _theta_generator()
        self.numbering = True
        # Font for rendering counter in images.
        self._font = ImageFont.load_default()
 

Member Function Documentation

black()

microscope.simulators._ImageGenerator.black	(		self,
			w,
			h,
			dark,
			light )

Ignores dark and light - returns zeros

Definition at line 112 of file __init__.py.

    def black(self, w, h, dark, light):
        """Ignores dark and light - returns zeros"""
        return np.zeros((h, w))
 

data_type()

microscope.simulators._ImageGenerator.data_type

(

self

)

Definition at line 79 of file __init__.py.

    def data_type(self):
        return self._datatype_index
 

enable_numbering()

microscope.simulators._ImageGenerator.enable_numbering	(		self,
			enab )

Definition at line 73 of file __init__.py.

    def enable_numbering(self, enab):
        self.numbering = enab
 

get_data_types()

microscope.simulators._ImageGenerator.get_data_types

(

self

)

Definition at line 76 of file __init__.py.

    def get_data_types(self):
        return (t.__name__ for t in self._datatypes)
 

get_image()

microscope.simulators._ImageGenerator.get_image	(		self,
			width,
			height,
			dark = 0,
			light = 255,
			index = None )

Return an image using the currently selected method.

Definition at line 97 of file __init__.py.

    def get_image(self, width, height, dark=0, light=255, index=None):
        """Return an image using the currently selected method."""
        m = self._methods[self._method_index]
        d = self._datatypes[self._datatype_index]
        # return Image.fromarray(m(width, height, dark, light).astype(d), 'L')
        data = m(width, height, dark, light).astype(d)
        if self.numbering and index is not None:
            text = "%d" % index
            size = tuple(d + 2 for d in self._font.getsize(text))
            img = Image.new("L", size)
            ctx = ImageDraw.Draw(img)
            ctx.text((1, 1), text, fill=light)
            data[0 : size[1], 0 : size[0]] = np.asarray(img)
        return data
 

get_methods()

microscope.simulators._ImageGenerator.get_methods

(

self

)

Return the names of available image generation methods

Definition at line 85 of file __init__.py.

    def get_methods(self):
        """Return the names of available image generation methods"""
        return (m.__name__ for m in self._methods)
 

gradient()

microscope.simulators._ImageGenerator.gradient	(		self,
			w,
			h,
			dark,
			light )

A single gradient across the whole image from top left to bottom right.

Definition at line 125 of file __init__.py.

    def gradient(self, w, h, dark, light):
        """A single gradient across the whole image from top left to bottom right."""
        xx, yy = np.meshgrid(range(w), range(h))
        return dark + light * (xx + yy) / (xx.max() + yy.max())
 

method()

microscope.simulators._ImageGenerator.method

(

self

)

Return the index of the current image generation method.

Definition at line 89 of file __init__.py.

    def method(self):
        """Return the index of the current image generation method."""
        return self._method_index
 

noise()

microscope.simulators._ImageGenerator.noise	(		self,
			w,
			h,
			dark,
			light )

Random noise.

Definition at line 130 of file __init__.py.

    def noise(self, w, h, dark, light):
        """Random noise."""
        return np.random.randint(dark, light, size=(h, w))
 

one_gaussian()

microscope.simulators._ImageGenerator.one_gaussian	(		self,
			w,
			h,
			dark,
			light )

Definition at line 134 of file __init__.py.

    def one_gaussian(self, w, h, dark, light):
        "A single gaussian"
        sigma = 0.01 * max(w, h)
        x0 = np.random.randint(w)
        y0 = np.random.randint(h)
        xx, yy = np.meshgrid(range(w), range(h))
        return dark + light * np.exp(
            -((xx - x0) ** 2 + (yy - y0) ** 2) / (2 * sigma**2)
        )
 

sawtooth()

microscope.simulators._ImageGenerator.sawtooth	(		self,
			w,
			h,
			dark,
			light )

A sawtooth gradient that rotates about 0,0.

Definition at line 144 of file __init__.py.

    def sawtooth(self, w, h, dark, light):
        """A sawtooth gradient that rotates about 0,0."""
        th = next(self._theta)
        xx, yy = np.meshgrid(range(w), range(h))
        wrap = 0.1 * max(xx.max(), yy.max())
        return dark + light * ((np.sin(th) * xx + np.cos(th) * yy) % wrap) / (
            wrap
        )
 
 

set_data_type()

microscope.simulators._ImageGenerator.set_data_type	(		self,
			index )

Definition at line 82 of file __init__.py.

    def set_data_type(self, index):
        self._datatype_index = index
 

set_method()

microscope.simulators._ImageGenerator.set_method	(		self,
			index )

Set the image generation method.

Definition at line 93 of file __init__.py.

    def set_method(self, index):
        """Set the image generation method."""
        self._method_index = index
 

white()

microscope.simulators._ImageGenerator.white	(		self,
			w,
			h,
			dark,
			light )

Ignores dark and light - returns max value for current data type.

Definition at line 116 of file __init__.py.

    def white(self, w, h, dark, light):
        """Ignores dark and light - returns max value for current data type."""
        d = self._datatypes[self._datatype_index]
        if issubclass(d, np.integer):
            value = np.iinfo(d).max
        else:
            value = 1.0
        return value * np.ones((h, w)).astype(d)
 

Member Data Documentation

_datatype_index

int microscope.simulators._ImageGenerator._datatype_index = 0

protected

Definition at line 67 of file __init__.py.

_datatypes

microscope.simulators._ImageGenerator._datatypes = (np.uint8, np.uint16, float)

protected

Definition at line 66 of file __init__.py.

_font

microscope.simulators._ImageGenerator._font = ImageFont.load_default()

protected

Definition at line 71 of file __init__.py.

_method_index

int microscope.simulators._ImageGenerator._method_index = 0

protected

Definition at line 65 of file __init__.py.

_methods

microscope.simulators._ImageGenerator._methods

protected

Initial value:

=  (
            self.noise,
            self.gradient,
            self.sawtooth,
            self.one_gaussian,
            self.black,
            self.white,
        )

Definition at line 57 of file __init__.py.

_theta

microscope.simulators._ImageGenerator._theta = _theta_generator()

protected

Definition at line 68 of file __init__.py.

numbering

bool microscope.simulators._ImageGenerator.numbering = True

Definition at line 69 of file __init__.py.

---

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

• BioImager/PythonMicroscope/microscope/simulators/__init__.py