2.6.3.3 imgMathfun(Pro)

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 = fact*Func(img); For sine and cosine operators, the factor is multiplied before math function applied, i.e., oimg = Func(fact*img).

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.

MathFunSetting1.png

Examples

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

  1. When the input image is active, select Image: Arithmetic Transform: Math Function. This opens the dialog of the X-Function.
  2. In the X-Function dialog, change the settings as the screenshot below and click OK to close the dialog.
    ImgMathfun help English files image002.jpg
    A new image is created as a result.
ImgMathfun help English files image004.jpg
ImgMathfun help English files image006.jpg
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.

References

LEADTOOLS Main API Help file, Version 14

Related X-Functions

imgPixlog