2.6.3.3 imgMathfun(Pro)

1 Menu Information
2 Brief Information
3 Additional Information
4 Command Line Usage
5 X-Function Execution Options
6 Variables
7 Description
8 Examples
9 Algorithm
10 References
11 Related X-Functions

Menu Information

Image: Arithmetic Transform: Math Function

Brief Information

Perform math on image pixel values

Additional Information

This feature is for OriginPro only.

Command Line Usage

1. imgMathfun mf:=sqrt fact:=1.5;

2. imgMathfun mf:=sin fact:=2 oimg:=mat(2);

3. imgMathfun oimg:=<new>;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
Input Matrix	img	Input Image	<active>	Specifies the input image. The default input is the active image.
Function	mf	Input int	sqr	Specifies the math function to apply. Option list: sqr:Square Square the pixel values. log:Log Take the log of the pixel values sqrt:Squarel Root Take the square root of the pixel values. sin:Sin Take the sine of the pixel values. cos:Cos Take the cosine of the pixel values.
Factor	fact	Input double	0.01	Specifies the factor. For Square, Log and Square Root operators, the output image will be multiplied by the factor after the math function applied, i.e., oimg = factFunc(img); For sine and cosine operators, the factor is multiplied before math function applied, i.e., oimg = Func(factimg).
Output Image	oimg	Output Image	<input>	Specifies the output image. By default, the output image is the same as the input image. See the syntax here.

Description

This function lets you apply a mathematical function to the pixel values of an image, allowing you to remap them so as to enhance or adjust the image. The model for the Math Function tool in OriginPro is as the following equation shows:

$OutputImage = function(InputImage*factor)$

where the factor and function can be specified by the customer. Available functions include:

Square
Log
Square Root
Sine
Cosin

For square, log and square root, a factor is multiplied after the mathematical function is applied while for sine and cosine, the pixel value is multiplied firstly before applying mathematical function.

Examples

Below is an example where the Math Function tool has been used to apply the Cosine function with a factor of 30.

When the input image is active, select Image: Arithmetic Transform: Math Function. This opens the dialog of the X-Function.
In the X-Function dialog, change the settings as the screenshot below and click OK to close the dialog.

A new image is created as a result.


Input image	Output image

Note: OriginPro includes the ability to automatically recalculate the analysis result of the Math Function operation any time you change the parameters or update your source data. In addition, the settings for the analysis routine can be saved to an analysis theme for use later with similar data.

Algorithm

The computation mainly uses L_MathFunctionBitmap() function from LEADTOOLS Main API. Please refer to the LEADTOOLS Main API Help file, Version 14 and read the L_MathFunctionBitmap topic.