from_numpy

Image [OneBit|GreyScale|Grey16|RGB|Float|Complex] from_numpy (object array)

Instantiates a Gamera image from a Numeric multi-dimensional array array.

The array must be one of the following types and will map to the corresponding Gamera image type:

Requires two copying operations; may fail for very large images.

To use this function, which is not a method on images, do the following:

from gamera.plugins import numpy_io
image = numpy_io.from_numpy(array)

to_numpy

object to_numpy ()

Returns an Numeric array containing a copy of the image's data.

The array will be one of the following types corresponding to each of the Gamera image types:

Requires three copies, and may fail for very large images.

This method can be used for utilizing special functions present in numpy. If you need to compute the discrete fourier transform of an image, you can use numpy, as in the following example:

from gamera.plugins import numpy_io
from numpy import fft
nparr = image.to_numpy()
fourarr = fft.fft2(nparr)
fourimage = numpy_io.from_numpy(fourarr)

Example 1: to_numpy

Example 2: to_numpy

Example 3: to_numpy

Example 4: to_numpy

Example 5: to_numpy

from_pil

Image [GreyScale|RGB|Float] from_pil (object image)

Instantiates a Gamera image from a Python Imaging Library image image.

Only RGB or 8-bit greyscale mode PIL images are supported. Requires a copying operation; may fail for very large images.

This can, e.g., be used to read images from file formats not directly supported by gamera, as JPEG images:

# Beware: name "Image" is already used in Gamera!
import Image as Pil
from pil_io import

# read a JPEG image and convert it to a Gamera image
pilimg = Pil.open("image.jpg")
img = from_pil(pilimg)

to_pil

object to_pil ()

Returns a Python Imaging Library image containing a copy of image's data.

Only RGB and Greyscale images are supported. May fail for very large images.

Example 1: to_pil

Example 2: to_pil

from_cv

Image [GreyScale|RGB|Float] from_cv (object image)

Instantiates a Gamera RGB image from an OpenCV cv.cvmat or cv.iplimage. May fail for very large images.

Usage example:

from gamera.plugins import cv_io

# read a JPEG image and convert it to a Gamera image
cvImg = cv.LoadImage("foo.jpg")
img = cv_io.from_cv(cvImg)

to_cv

object to_cv ()

Returns an OpenCv image (cv.cvmat) containing a copy of image's data.

Only RGB, Greyscale and Onebit images are supported. May fail for very large images.