Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::ImageGenerator Class Reference

Generator for synthetic MITK images. More...

#include <mitkImageGenerator.h>

Static Public Member Functions

template<typename TPixelType >
static mitk::Image::Pointer GenerateGradientImage (unsigned int dimX, unsigned int dimY, unsigned int dimZ, float spacingX=1, float spacingY=1, float spacingZ=1)
 Generates a 3D gradient image with the defined size and spacing. More...
 
template<typename TPixelType >
static mitk::Image::Pointer GenerateImageFromReference (mitk::Image::Pointer reference, TPixelType fill_value)
 Generates an image with the same geometry as the given reference image. More...
 
template<typename TPixelType >
static mitk::Image::Pointer GenerateRandomImage (unsigned int dimX, unsigned int dimY, unsigned int dimZ=1, unsigned int dimT=1, mitk::ScalarType spacingX=1, mitk::ScalarType spacingY=1, mitk::ScalarType spacingZ=1, const double randomMax=1000.0f, const double randMin=0.0f)
 Generates a random image with the defined size and spacing. More...
 

Detailed Description

Generator for synthetic MITK images.

This is a helper class to generate synthetic MITK images (random or gradient).

See also
Image

Definition at line 32 of file mitkImageGenerator.h.

Member Function Documentation

◆ GenerateGradientImage()

template<typename TPixelType >
static mitk::Image::Pointer mitk::ImageGenerator::GenerateGradientImage ( unsigned int  dimX,
unsigned int  dimY,
unsigned int  dimZ,
float  spacingX = 1,
float  spacingY = 1,
float  spacingZ = 1 
)
inlinestatic

Generates a 3D gradient image with the defined size and spacing.

Pixel values are filled sequentially starting from 0 and incrementing by 1 for each voxel.

Template Parameters
TPixelTypeThe pixel type of the generated image.
Parameters
dimXImage dimension in X direction (number of columns).
dimYImage dimension in Y direction (number of rows).
dimZImage dimension in Z direction (number of slices).
spacingXVoxel spacing in X direction. Defaults to 1.
spacingYVoxel spacing in Y direction. Defaults to 1.
spacingZVoxel spacing in Z direction. Defaults to 1.
Returns
A newly created MITK image filled with gradient values.

Definition at line 51 of file mitkImageGenerator.h.

References mitk::Image::New().

◆ GenerateImageFromReference()

template<typename TPixelType >
static mitk::Image::Pointer mitk::ImageGenerator::GenerateImageFromReference ( mitk::Image::Pointer  reference,
TPixelType  fill_value 
)
inlinestatic

Generates an image with the same geometry as the given reference image.

The image buffer is filled uniformly with the specified fill value.

Template Parameters
TPixelTypeThe pixel type of the generated image.
Parameters
referenceThe reference image whose geometry is used for the new image.
fill_valueThe value to fill every voxel with.
Returns
A newly created MITK image with the same geometry as the reference.

Definition at line 112 of file mitkImageGenerator.h.

References mitk::ImageWriteAccessor::GetData(), MITK_ERROR, and mitk::Image::New().

◆ GenerateRandomImage()

template<typename TPixelType >
static mitk::Image::Pointer mitk::ImageGenerator::GenerateRandomImage ( unsigned int  dimX,
unsigned int  dimY,
unsigned int  dimZ = 1,
unsigned int  dimT = 1,
mitk::ScalarType  spacingX = 1,
mitk::ScalarType  spacingY = 1,
mitk::ScalarType  spacingZ = 1,
const double  randomMax = 1000.0f,
const double  randMin = 0.0f 
)
inlinestatic

Generates a random image with the defined size and spacing.

Creates a 2D, 3D, or 4D image depending on the dimension parameters. Supported pixel types are int, float, double, unsigned char, and unsigned short.

Template Parameters
TPixelTypeThe pixel type of the generated image.
Parameters
dimXImage dimension in X direction (number of columns).
dimYImage dimension in Y direction (number of rows).
dimZImage dimension in Z direction. If <= 1, a 2D image is created. Defaults to 1.
dimTImage dimension in time. If <= 1, no time dimension is added. Defaults to 1.
spacingXVoxel spacing in X direction. Defaults to 1.
spacingYVoxel spacing in Y direction. Defaults to 1.
spacingZVoxel spacing in Z direction. Defaults to 1.
randomMaxThe upper bound for random values. Defaults to 1000.
randMinThe lower bound for random values (used for float/double types). Defaults to 0.
Returns
A newly created MITK image filled with random values.

Definition at line 161 of file mitkImageGenerator.h.

References mitk::PixelType::GetComponentType(), mitk::ImageWriteAccessor::GetData(), MITK_ERROR, and mitk::Image::New().


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