Band Math
Brief Description
Outputs a monoband image which is the result of a mathematical operation on several multi-band images.
Tags
Miscellaneous
Long Description
This application performs a mathematical operation on several multi-band images and outputs the result into a monoband image. The given expression is computed at each pixel position. Evaluation of the mathematical formula is done by the muParser libraries.
The formula can be written using:
* numerical values ( 2.3, -5, 3.1e4, ...)
* variables containing pixel values (e.g. : 'im2b3' is the pixel value in 2nd image, 3rd band)
* binary operators:
* '+' addition, '-' subtraction, '*' multiplication, '/' division
* '^' raise x to the power of y
* '<' less than, '>' greater than, '<=' less or equal, '>=' greater or equal
* '==' equal, '!=' not equal
* '||' logical or, '&&' logical and
* if-then-else operator: '(condition ? value_true : value_false)'
* functions : exp(), log(), sin(), cos(), min(), max(), ...
The full list of features and operators is available on the muParser website [1].
Parameters
Input image-list (il): Image-list of operands to the mathematical expression.
Output Image (out): Output image which is the result of the mathematical expressions on input image-list operands.
Available RAM (Mb) (ram): Available memory for processing (in MB)
Expression (exp): The muParser mathematical expression to apply on input images.
Load otb application from xml file (inxml): Load otb application from xml file
Save otb application to xml file (outxml): Save otb application to xml file
Limitations
None
Authors
OTB-Team
See also
[1] http://beltoforion.de/article.php?a=muparser
Example of use
il: verySmallFSATSW_r.tif verySmallFSATSW_nir.tif verySmallFSATSW.tif
out: apTvUtBandMathOutput.tif
exp: 'cos( im1b1 ) > cos( im2b1 ) ? im3b1 : im3b2'
otbcli_BandMath -il verySmallFSATSW_r.tif verySmallFSATSW_nir.tif verySmallFSATSW.tif -out apTvUtBandMathOutput.tif -exp 'cos( im1b1 ) > cos( im2b1 ) ? im3b1 : im3b2'