DIPlib Documentation - ©1995-2017 Quantitative Imaging Group, Delft University of Technology.

TestObjectCreate

TestObject generation function

SYNOPSIS

#include "dip_generation.h"

dip_Error dip_TestObjectCreate ( object, testObject, objectHeight, objectRadius, scale, scaleRadius, scaleAmplitude, objSigma, position, random )

DATA TYPES

Output: sfloat

FUNCTION

This function can generate an aliasing free object (ellips, box, ellipsoid shell, box shell) or uses an user-supplied object. The generated objects have their origin at the center in the image, but can be generated with a sub-pixel random shift around the center, to average out dicretization effects over several instances of the same generated object. Optinally the generated object can be convolved with an isotropic Gaussian with a width specified by objSigma. Elliptical objects are only supported for images with a dimsnionality equal or less than three. The position boolean variable specifies whether a subpixel random shift should be applied to the object. This can be used to average out digitisation error over a repetition of the generation of the same object.

ARGUMENTS

Data typeNameDescription
dip_ImageobjectOutput Object Image
dipf_TestObjecttestObjectType of Test Object
dip_floatobjectHeightObject Height
dip_floatobjectRadiusObject Radius
dip_FloatArrayscaleRelative Radii for each dimension
dip_floatscaleRadiusScaleRadius
dip_floatscaleAmplitudeScaleAmplitude
dip_floatobjSigmaSigma of Gaussian Object Blur
dip_BooleanpositionRandom Subpixel Position Shift
dip_Random *randomPointer to a random value structure

SEE ALSO

TestObjectModulate, TestObjectBlur, TestObjectAddNoise