selectParam

selectParam ( string Param1[,string Param2, string Param3 ], …)

Use this function to add selected parameters to the list of parameters to be measured. To clear the list of measurement parameters, use resetParam.
.
Arguments

Param1, Param2,….

Strings specifying the names of measurement parameters. Must be of the following values:

AngleMajor the angle between the major axis of an object and X-axis AngleMinor the angle between the minor axis of an object and X-axis AngleDMax the angle between the maximum diameter of an object and X-axis AngleDMin the angle between the minimum diameter of an object and X-axis AngleFMax the angle between the longest caliper of an object and X-axis AngleFMin the angle between the shortest caliper of an object and X-axis AngleRMax the angle between the maximum radius of an object and X-axis AngleRMin the angle between the minimum radius of an object and X-axis Anisotropy the spatial anisotropy of a phase Area the area of an object or phase in calibrated units AreaBox the area of the box bounding an object in calibrated units AreaConv the area of object's convex hull in calibrated units AreaEll the area of the equivalent ellipse of an object in calibrated units AreaOut the area of an object measured by integrating its outside boundary AreaRatio the ratio of the area of an object or phase to the reference area AreaRef the reference area of the image or selection in calibrated units Aspect the ratio between the major and minor axes of an object AxisMajor the length of the major axis of object's equivalent ellipse in calibrated units AxisMinor the length of the minor axis of object's equivalent ellipse in calibrated units

BlueAvrg the average value of the scaled blue component of an object or phase BlueSD the standard deviation of the blue component within an object or phase BoxLength the length of object's bounding box along its major axis in calibrated units BoxWidth the width of object's bounding box along its minor axis in calibrated units BoxRatio the ratio between the length and width of object's bounding box

CenterX the X-coordinate of object's binary weighted centroid in calibrated units CenterY the Y-coordinate of object's binary weighted centroid in calibrated units CenterDist the distance between object's centroid and the origin of the image CenterAngle the polar angle of object's centroid CenterConvX the X-coordinate of the binary weighted centroid of object's convex hull CenterConvY the Y-coordinate of the binary weighted centroid of object's convex hull CenterGrayX the X-coordinate of object's intensity weighted center of gravity CenterGrayY the Y-coordinate of object's intensity weighted center of gravity ChordSum the total length of horizontal grid lines crossing a phase ChordRef the total length of horizontal grid lines within the image or selection Circularity the circular form-factor of an object Class the class ID of a object or field ContourX the vector of X-coordinates of the object's contour ContourY the vector of Y-coordinates of the object's contour Convexity the ratio of the outline area and convex area of an object Count the ordinal number of a object or field in the current session

DCircle the diameter of the circle with the same area as object's area Diameters the vector of the diameters of an object passing through its centroid DAvrg the average diameter of an object passing through its centroid DMax the maximum diameter of an object passing through its centroid DMin the minimum diameter of an object passing through its centroid DRatio the ratio between the maximum and minimum diameters of an object

Ellipticity the elliptical form-factor of an object

FeretAvrg the average caliper length of an object in calibrated units FeretMax the maximum caliper length of an object in calibrated units FeretMin the minimum caliper length of an object in calibrated units FeretRatio the ratio between the maximum and minimum calipers of an object FeretX the length of the horizontal projection of an object in calibrated units FeretY the length of the vertical projection of an object in calibrated units

GrayAvrg the average scaled intensity of an object or phase GrayI the integral scaled intensity of an object or phase GrayMax the maximum scaled intensity within an object or phase GrayMin the minimum scaled intensity within an object or phase GraySD the standard deviation of scaled intensity within an object or phase GreenAvrg the average value of the scaled green component of an object or phase GreenSD the standard deviation of the green component within an object or phase

Histogram the vector of pixel intensity distribution within an object Holes the number of holes within an object HoleArea the total area of holes within an object in calibrated units

InterceptX the number of intersections of the horizontal grid with phase boundaries InterceptY the number of intersections of the vertical grid with phase boundaries

MaxX the maximum X coordinate of an object in calibrated units MinX the minimum X coordinate of an object in calibrated units MaxY the maximum Y coordinate of an object in calibrated units MinY the minimum Y coordinate of an object in calibrated units Moments the vector of the object's central binary moments

OptdAvrg the average optical density of an object or phase OptdI the integral optical density of an object or phase OptdSD the standard deviation of the optical density within an object or phase

Perim the length of the boundary of an object or phase in calibrated units PerimCirc the perimeter of a circle with the area equal to the area of an object PerimConv the perimeter of the convex hull of an object in calibrated units PerimEll the perimeter the object's equivalent ellipse in calibrated units PerimOut the length of the outside boundary of an object not including inside PerimX the horizontal component of the length of an object or phase boundary PerimXY the diagonal component of the length of an object or phase boundary PerimY the vertical component of the length of an object or phase boundary Perforation the ratio of the area of holes within an object to its total area PhaseRatio the ratio of the area of a phase to the area of all phases Pixels the number of pixels within an object or phase, not calibrated Profile the vector of intensities along the object's contour

RadiiIn the vector of the inner radii of an object RadiiOut the vector of the outer radii of an object Rectangularity the rectangular form-factor of an object RedAvrg the average value of the scaled red component of an object or phase RedSD the standard deviation of the red component within an object or phase RAvrg the average radius of an object measured from its centroid RMax the maximum radius of an object measured from its centroid RMin the minimum radius of an object measured from its centroid RRatio the ratio between the maximum and minimum radii of an object Roughness the ratio between the outline perimeter and convex perimeter of an object

StartX the X-coordinate of the first found point of an object in pixels StartY the Y-coordinate of the first found point of an object in pixels SkewMajor the binary weighted object's skewness along its major axis SkewMinor the binary weighted object's skewness along its minor axis Skew12 the binary weighted asymmetry factor of an object Skew21 the binary weighted asymmetry factor of an object

TransmAvrg the average value of the scaled optical transmission of an object or phase TransmSD the standard deviation of the optical transmission within an object or phase

YatMaxX the associated Y-value at the maximum X coordinate of an object YatMinX the associated Y-value at the minimum X coordinate of an object XatMaxY the associated X-value at the maximum Y coordinate of an object XatMinY the associated X-value at the minimum Y coordinate of an object User1….User5 the user-defined parameters

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements binarizes a sample image, selects a set of measurements parameters and performs automatic blob measurements:

setCurDir("samples")

loadIm(1,"sample4.IWD")

threshGauss(1,2,0,1,0)

separate(2,2,16)

resetParam()

selectParam ("Area","Circularity", "AxisMajor","Moments")

measObjects (2)

Remarks

Most of ImageWarp's parameters are scalars, i.e. they render one numerical result for each object measured. Unlike the scalar parameters, vector parameters render an array of values for each object measured. The examples of such parameters are Histogram, Moments, Radii. To retrieve the value of a desired parameter for the last measured object, use the getParamValue function. The number of elements in a vector parameter can be determined with getParamSize.

ImageWarp also supports user-defined parameters, that must be supplied to measurement functions